shopify-sdk-patterns

# Shopify SDK Patterns ## Overview Production-ready patterns for the `@shopify/shopify-api` library: singleton clients, typed GraphQL operations, session management, cursor-based pagination, and error handling wrappers. ## Prerequisites - `@shopify/shopify-api` v9+ installed - Familiarity with Shopify's GraphQL Admin API - Understanding of async/await and TypeScript generics ## Instructions ### Step 1: Typed GraphQL Client Wrapper ```typescript // src/shopify/client.ts import "@shopify/shopify-api/adapters/node"; import { shopifyApi, Session, GraphqlClient } from "@shopify/shopify-api"; const shopify = shopifyApi({ apiKey: process.env.SHOPIFY_API_KEY!, apiSecretKey: process.env.SHOPIFY_API_SECRET!, hostName: process.env.SHOPIFY_HOST_NAME!, apiVersion: "2024-10", isCustomStoreApp: !!process.env.SHOPIFY_ACCESS_TOKEN, adminApiAccessToken: process.env.SHOPIFY_ACCESS_TOKEN, }); // Singleton session cache per shop const sessionCache = new Map<string, Session>(); export function getSession(shop: string): Session { if (!sessionCache.has(shop)) { const session = shopify.session.customAppSession(shop); sessionCache.set(shop, session); } return sessionCache.get(shop)!; } export function getGraphqlClient(shop: string): GraphqlClient { return new shopify.clients.Graphql({ session: getSession(shop), }); } // Typed query helper export async function shopifyQuery<T = any>( shop: string, query: string, variables?: Record<string, unknown> ): ...