@anker-in/shopify-sdk 0.1.1-beta.9 → 1.0.0

package/dist/client/index.js

@@ -1,5 +1,24 @@
 'use strict';
 
+// src/utils.ts
+function addInContextDirective(query, country, language) {
+  if (!country || !language) {
+    return query;
+  }
+  const operationRegex = /((?:query|mutation)\s+\w+)(\s*\([^)]*\))?\s*(\{)/;
+  const match = query.match(operationRegex);
+  if (!match) {
+    const braceIndex = query.indexOf("{");
+    if (braceIndex === -1) return query;
+    const beforeBrace = query.substring(0, braceIndex).trim();
+    const afterBrace = query.substring(braceIndex);
+    return `${beforeBrace} @inContext(country: ${country}, language: ${language}) ${afterBrace}`;
+  }
+  const beforeDirective = match[1] + (match[2] || "");
+  const afterDirective = query.substring(match.index + match[0].length - 1);
+  return `${beforeDirective} @inContext(country: ${country}, language: ${language}) ${afterDirective}`;
+}
+
 // src/client/client.ts
 var ShopifyClient = class _ShopifyClient {
   config;
@@ -12,8 +31,11 @@ var ShopifyClient = class _ShopifyClient {
    * Execute a GraphQL request
    */
   async request(request, options = {}) {
-    const { query, variables, operationName } = request;
+    let { query, variables, operationName } = request;
     const { tags = [], ...fetchOptions } = options;
+    const country = this.config.getCountryCode(this.locale);
+    const language = this.config.getLanguageCode(this.locale);
+    query = addInContextDirective(query, country, language);
     const apiUrl = this.config.getApiUrl(this.locale);
     const token = this.config.getStorefrontToken(this.locale);
     const headers = {
@@ -35,9 +57,7 @@ var ShopifyClient = class _ShopifyClient {
         ...tags.length > 0 && { next: { tags } }
       });
       if (!response.ok) {
-        throw new Error(
-          `HTTP ${response.status}: ${response.statusText}`
-        );
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
       }
       const json = await response.json();
       if (json.errors && json.errors.length > 0) {
@@ -53,10 +73,7 @@ var ShopifyClient = class _ShopifyClient {
    * Convenience method for simple queries
    */
   async query(query, variables, options) {
-    const response = await this.request(
-      { query, variables },
-      options
-    );
+    const response = await this.request({ query, variables }, options);
     return response.data;
   }
   /**

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ShopifyConfig } from '@anker-in/shopify-core'\nimport type { GraphQLResponse, GraphQLRequest, FetchOptions } from './types'\n\n/**\n * Shopify GraphQL Client\n * Handles all GraphQL communication with Shopify Storefront API\n */\nexport class ShopifyClient {\n  private config: ShopifyConfig\n  private locale: string\n\n  constructor(config: ShopifyConfig, locale: string) {\n    this.config = config\n    this.locale = locale\n  }\n\n  /**\n   * Execute a GraphQL request\n   */\n  async request<T = any>(\n    request: GraphQLRequest,\n    options: FetchOptions = {}\n  ): Promise<GraphQLResponse<T>> {\n    const { query, variables, operationName } = request\n    const { tags = [], ...fetchOptions } = options\n\n    const apiUrl = this.config.getApiUrl(this.locale)\n    const token = this.config.getStorefrontToken(this.locale)\n\n    const headers: HeadersInit = {\n      'Content-Type': 'application/json',\n      'X-Shopify-Storefront-Access-Token': token,\n      ...(fetchOptions.headers || {}),\n    }\n\n    const body = JSON.stringify({\n      query,\n      variables,\n      operationName,\n    })\n\n    try {\n      const response = await fetch(apiUrl, {\n        method: 'POST',\n        headers,\n        body,\n        ...fetchOptions,\n        ...(tags.length > 0 && { next: { tags } }),\n      })\n\n      if (!response.ok) {\n        throw new Error(\n          `HTTP ${response.status}: ${response.statusText}`\n        )\n      }\n\n      const json: GraphQLResponse<T> = await response.json()\n\n      if (json.errors && json.errors.length > 0) {\n        console.error('GraphQL Errors:', json.errors)\n      }\n\n      return json\n    } catch (error) {\n      console.error('Shopify API Request Failed:', error)\n      throw error\n    }\n  }\n\n  /**\n   * Convenience method for simple queries\n   */\n  async query<T = any>(\n    query: string,\n    variables?: Record<string, any>,\n    options?: FetchOptions\n  ): Promise<T | undefined> {\n    const response = await this.request<T>(\n      { query, variables },\n      options\n    )\n    return response.data\n  }\n\n  /**\n   * Get current locale\n   */\n  getLocale(): string {\n    return this.locale\n  }\n\n  /**\n   * Get config\n   */\n  getConfig(): ShopifyConfig {\n    return this.config\n  }\n\n  /**\n   * Get API URL\n   */\n  getApiUrl(): string {\n    return this.config.getApiUrl(this.locale)\n  }\n\n  /**\n   * Create a new client with different locale\n   */\n  withLocale(locale: string): ShopifyClient {\n    return new ShopifyClient(this.config, locale)\n  }\n}\n\n/**\n * Factory function to create a Shopify client\n */\nexport function createShopifyClient(\n  config: ShopifyConfig,\n  locale: string\n): ShopifyClient {\n  return new ShopifyClient(config, locale)\n}\n"]}
+{"version":3,"sources":["../../src/utils.ts","../../src/client/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { HasMetafieldsIdentifier, Maybe, Metafield } from './shopify-types'\n\nexport type PartialRecord<K extends string | number | symbol, T> = Partial<Record<K, T>>\n\nexport type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>\n\nexport type Replace<T, K extends keyof T, V> = Omit<T, K> & { [P in K]: V }\n\nexport enum HasMetafieldQueryRoot {\n  Product = 'product',\n  Variant = 'variant',\n  Page = 'page',\n  Article = 'article',\n  Blog = 'blog',\n  Collection = 'collection',\n  Shop = 'shop',\n  Cart = 'cart',\n  Customer = 'customer',\n  Location = 'location',\n  Market = 'market',\n  Order = 'order',\n}\n\n/**\n * 生成 metafieldIdentifiers 查询参数\n */\nexport function constructMetafieldIdentifiersQueryParams<T extends HasMetafieldQueryRoot>(\n  metafieldIdentifiers: PartialRecord<T, HasMetafieldsIdentifier[]> = {},\n  metafieldNamespacePrefix: string\n): PartialRecord<`${T}MetafieldIdentifiers`, HasMetafieldsIdentifier[]> {\n  const identifiers = Object.entries(metafieldIdentifiers).reduce(\n    (queryInput, [key, value]) => {\n      const metafieldIdentifiers = value as HasMetafieldsIdentifier[]\n      queryInput[`${key}MetafieldIdentifiers` as `${T}MetafieldIdentifiers`] =\n        metafieldIdentifiers.map((item) => ({\n          namespace: item.namespace,\n          key: item.key,\n        })) as HasMetafieldsIdentifier[]\n      return queryInput\n    },\n    {} as PartialRecord<`${T}MetafieldIdentifiers`, HasMetafieldsIdentifier[]>\n  )\n  return identifiers\n}\n\nexport const parseMetafield = (item: Metafield, previewData?: any, resource_type?: string) => {\n  const type = item?.type && item?.type.toLowerCase()\n  if (\n    item &&\n    previewData &&\n    previewData?.__preview_type === resource_type &&\n    previewData[`${item?.namespace}${item?.key}`] !== undefined &&\n    previewData[`${item?.namespace}${item?.key}`] !== null\n  ) {\n    return previewData[`${item.namespace}${item.key}`]\n  }\n  switch (type) {\n    case 'json':\n    case 'json_string':\n    case 'rating':\n    case 'volume':\n    case 'weight':\n    case 'dimension':\n      return JSON.parse(item.value)\n    default:\n      return item?.value || item\n  }\n}\n\nexport const normalizeMetafields = (metafields: Array<Maybe<Metafield>>): Record<string, any> => {\n  return metafields?.reduce(\n    (prev, cur) => {\n      if (cur) {\n        const namespace = cur.key\n        prev[namespace] = prev[namespace] || {}\n        const parsedMetafields: {\n          [key: string]: Metafield\n        } = parseMetafield(cur)\n        if (parsedMetafields) {\n          Object.entries(parsedMetafields).forEach(([key, innerMetafields]) => {\n            prev[namespace][key] =\n              prev[namespace][key] ?? (innerMetafields ? parseMetafield(innerMetafields) : null)\n          })\n        }\n      }\n      return prev\n    },\n    {} as Record<string, any>\n  )\n}\n\n/**\n * Add @inContext directive to GraphQL query for single shop multi-language/currency support\n *\n * @param query - GraphQL query string\n * @param country - Country code (e.g., 'PL', 'CA', 'US')\n * @param language - Language code (e.g., 'PL', 'FR', 'EN')\n * @returns Modified query with @inContext directive, or original query if country/language not provided\n *\n * @example\n * ```typescript\n * const query = `query getCart($cartId: ID!) { cart(id: $cartId) { id } }`\n * const modifiedQuery = addInContextDirective(query, 'PL', 'PL')\n * // Result: query getCart($cartId: ID!) @inContext(country: PL, language: PL) { cart(id: $cartId) { id } }\n * ```\n */\nexport function addInContextDirective(\n  query: string,\n  country?: string,\n  language?: string\n): string {\n  // If no country or language, return original query\n  if (!country || !language) {\n    return query\n  }\n\n  // Match query/mutation declaration with optional parameters\n  // e.g., \"query getCart(...)\" or \"mutation createCart\"\n  const operationRegex = /((?:query|mutation)\\s+\\w+)(\\s*\\([^)]*\\))?\\s*(\\{)/\n  const match = query.match(operationRegex)\n\n  if (!match) {\n    // Fallback: try to find first { if no operation found\n    const braceIndex = query.indexOf('{')\n    if (braceIndex === -1) return query\n\n    const beforeBrace = query.substring(0, braceIndex).trim()\n    const afterBrace = query.substring(braceIndex)\n    return `${beforeBrace} @inContext(country: ${country}, language: ${language}) ${afterBrace}`\n  }\n\n  // Insert @inContext after operation declaration (and parameters if exist), before {\n  const beforeDirective = match[1] + (match[2] || '') // e.g., \"query getCart($id: ID!)\"\n  const afterDirective = query.substring(match.index! + match[0].length - 1) // Everything starting from {\n\n  return `${beforeDirective} @inContext(country: ${country}, language: ${language}) ${afterDirective}`\n}\n","import type { ShopifyConfig } from '@anker-in/shopify-core'\nimport type { GraphQLResponse, GraphQLRequest, FetchOptions } from './types'\nimport { addInContextDirective } from '../utils'\n\n/**\n * Shopify GraphQL Client\n * Handles all GraphQL communication with Shopify Storefront API\n */\nexport class ShopifyClient {\n  private config: ShopifyConfig\n  private locale: string\n\n  constructor(config: ShopifyConfig, locale: string) {\n    this.config = config\n    this.locale = locale\n  }\n\n  /**\n   * Execute a GraphQL request\n   */\n  async request<T = any>(\n    request: GraphQLRequest,\n    options: FetchOptions = {}\n  ): Promise<GraphQLResponse<T>> {\n    let { query, variables, operationName } = request\n    const { tags = [], ...fetchOptions } = options\n\n    // Add @inContext directive if needed for single shop multi-language/currency\n    const country = this.config.getCountryCode(this.locale)\n    const language = this.config.getLanguageCode(this.locale)\n    query = addInContextDirective(query, country, language)\n\n    const apiUrl = this.config.getApiUrl(this.locale)\n    const token = this.config.getStorefrontToken(this.locale)\n\n    const headers: HeadersInit = {\n      'Content-Type': 'application/json',\n      'X-Shopify-Storefront-Access-Token': token,\n      ...(fetchOptions.headers || {}),\n    }\n\n    const body = JSON.stringify({\n      query,\n      variables,\n      operationName,\n    })\n\n    try {\n      const response = await fetch(apiUrl, {\n        method: 'POST',\n        headers,\n        body,\n        ...fetchOptions,\n        ...(tags.length > 0 && { next: { tags } }),\n      })\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n      }\n\n      const json: GraphQLResponse<T> = await response.json()\n\n      if (json.errors && json.errors.length > 0) {\n        console.error('GraphQL Errors:', json.errors)\n      }\n\n      return json\n    } catch (error) {\n      console.error('Shopify API Request Failed:', error)\n      throw error\n    }\n  }\n\n  /**\n   * Convenience method for simple queries\n   */\n  async query<T = any>(\n    query: string,\n    variables?: Record<string, any>,\n    options?: FetchOptions\n  ): Promise<T | undefined> {\n    const response = await this.request<T>({ query, variables }, options)\n    return response.data\n  }\n\n  /**\n   * Get current locale\n   */\n  getLocale(): string {\n    return this.locale\n  }\n\n  /**\n   * Get config\n   */\n  getConfig(): ShopifyConfig {\n    return this.config\n  }\n\n  /**\n   * Get API URL\n   */\n  getApiUrl(): string {\n    return this.config.getApiUrl(this.locale)\n  }\n\n  /**\n   * Create a new client with different locale\n   */\n  withLocale(locale: string): ShopifyClient {\n    return new ShopifyClient(this.config, locale)\n  }\n}\n\n/**\n * Factory function to create a Shopify client\n */\nexport function createShopifyClient(config: ShopifyConfig, locale: string): ShopifyClient {\n  return new ShopifyClient(config, locale)\n}\n"]}

package/dist/client/index.mjs

@@ -1,3 +1,22 @@
+// src/utils.ts
+function addInContextDirective(query, country, language) {
+  if (!country || !language) {
+    return query;
+  }
+  const operationRegex = /((?:query|mutation)\s+\w+)(\s*\([^)]*\))?\s*(\{)/;
+  const match = query.match(operationRegex);
+  if (!match) {
+    const braceIndex = query.indexOf("{");
+    if (braceIndex === -1) return query;
+    const beforeBrace = query.substring(0, braceIndex).trim();
+    const afterBrace = query.substring(braceIndex);
+    return `${beforeBrace} @inContext(country: ${country}, language: ${language}) ${afterBrace}`;
+  }
+  const beforeDirective = match[1] + (match[2] || "");
+  const afterDirective = query.substring(match.index + match[0].length - 1);
+  return `${beforeDirective} @inContext(country: ${country}, language: ${language}) ${afterDirective}`;
+}
+
 // src/client/client.ts
 var ShopifyClient = class _ShopifyClient {
   config;
@@ -10,8 +29,11 @@ var ShopifyClient = class _ShopifyClient {
    * Execute a GraphQL request
    */
   async request(request, options = {}) {
-    const { query, variables, operationName } = request;
+    let { query, variables, operationName } = request;
     const { tags = [], ...fetchOptions } = options;
+    const country = this.config.getCountryCode(this.locale);
+    const language = this.config.getLanguageCode(this.locale);
+    query = addInContextDirective(query, country, language);
     const apiUrl = this.config.getApiUrl(this.locale);
     const token = this.config.getStorefrontToken(this.locale);
     const headers = {
@@ -33,9 +55,7 @@ var ShopifyClient = class _ShopifyClient {
         ...tags.length > 0 && { next: { tags } }
       });
       if (!response.ok) {
-        throw new Error(
-          `HTTP ${response.status}: ${response.statusText}`
-        );
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
       }
       const json = await response.json();
       if (json.errors && json.errors.length > 0) {
@@ -51,10 +71,7 @@ var ShopifyClient = class _ShopifyClient {
    * Convenience method for simple queries
    */
   async query(query, variables, options) {
-    const response = await this.request(
-      { query, variables },
-      options
-    );
+    const response = await this.request({ query, variables }, options);
     return response.data;
   }
   /**

package/dist/client/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { ShopifyConfig } from '@anker-in/shopify-core'\nimport type { GraphQLResponse, GraphQLRequest, FetchOptions } from './types'\n\n/**\n * Shopify GraphQL Client\n * Handles all GraphQL communication with Shopify Storefront API\n */\nexport class ShopifyClient {\n  private config: ShopifyConfig\n  private locale: string\n\n  constructor(config: ShopifyConfig, locale: string) {\n    this.config = config\n    this.locale = locale\n  }\n\n  /**\n   * Execute a GraphQL request\n   */\n  async request<T = any>(\n    request: GraphQLRequest,\n    options: FetchOptions = {}\n  ): Promise<GraphQLResponse<T>> {\n    const { query, variables, operationName } = request\n    const { tags = [], ...fetchOptions } = options\n\n    const apiUrl = this.config.getApiUrl(this.locale)\n    const token = this.config.getStorefrontToken(this.locale)\n\n    const headers: HeadersInit = {\n      'Content-Type': 'application/json',\n      'X-Shopify-Storefront-Access-Token': token,\n      ...(fetchOptions.headers || {}),\n    }\n\n    const body = JSON.stringify({\n      query,\n      variables,\n      operationName,\n    })\n\n    try {\n      const response = await fetch(apiUrl, {\n        method: 'POST',\n        headers,\n        body,\n        ...fetchOptions,\n        ...(tags.length > 0 && { next: { tags } }),\n      })\n\n      if (!response.ok) {\n        throw new Error(\n          `HTTP ${response.status}: ${response.statusText}`\n        )\n      }\n\n      const json: GraphQLResponse<T> = await response.json()\n\n      if (json.errors && json.errors.length > 0) {\n        console.error('GraphQL Errors:', json.errors)\n      }\n\n      return json\n    } catch (error) {\n      console.error('Shopify API Request Failed:', error)\n      throw error\n    }\n  }\n\n  /**\n   * Convenience method for simple queries\n   */\n  async query<T = any>(\n    query: string,\n    variables?: Record<string, any>,\n    options?: FetchOptions\n  ): Promise<T | undefined> {\n    const response = await this.request<T>(\n      { query, variables },\n      options\n    )\n    return response.data\n  }\n\n  /**\n   * Get current locale\n   */\n  getLocale(): string {\n    return this.locale\n  }\n\n  /**\n   * Get config\n   */\n  getConfig(): ShopifyConfig {\n    return this.config\n  }\n\n  /**\n   * Get API URL\n   */\n  getApiUrl(): string {\n    return this.config.getApiUrl(this.locale)\n  }\n\n  /**\n   * Create a new client with different locale\n   */\n  withLocale(locale: string): ShopifyClient {\n    return new ShopifyClient(this.config, locale)\n  }\n}\n\n/**\n * Factory function to create a Shopify client\n */\nexport function createShopifyClient(\n  config: ShopifyConfig,\n  locale: string\n): ShopifyClient {\n  return new ShopifyClient(config, locale)\n}\n"]}
+{"version":3,"sources":["../../src/utils.ts","../../src/client/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { HasMetafieldsIdentifier, Maybe, Metafield } from './shopify-types'\n\nexport type PartialRecord<K extends string | number | symbol, T> = Partial<Record<K, T>>\n\nexport type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>\n\nexport type Replace<T, K extends keyof T, V> = Omit<T, K> & { [P in K]: V }\n\nexport enum HasMetafieldQueryRoot {\n  Product = 'product',\n  Variant = 'variant',\n  Page = 'page',\n  Article = 'article',\n  Blog = 'blog',\n  Collection = 'collection',\n  Shop = 'shop',\n  Cart = 'cart',\n  Customer = 'customer',\n  Location = 'location',\n  Market = 'market',\n  Order = 'order',\n}\n\n/**\n * 生成 metafieldIdentifiers 查询参数\n */\nexport function constructMetafieldIdentifiersQueryParams<T extends HasMetafieldQueryRoot>(\n  metafieldIdentifiers: PartialRecord<T, HasMetafieldsIdentifier[]> = {},\n  metafieldNamespacePrefix: string\n): PartialRecord<`${T}MetafieldIdentifiers`, HasMetafieldsIdentifier[]> {\n  const identifiers = Object.entries(metafieldIdentifiers).reduce(\n    (queryInput, [key, value]) => {\n      const metafieldIdentifiers = value as HasMetafieldsIdentifier[]\n      queryInput[`${key}MetafieldIdentifiers` as `${T}MetafieldIdentifiers`] =\n        metafieldIdentifiers.map((item) => ({\n          namespace: item.namespace,\n          key: item.key,\n        })) as HasMetafieldsIdentifier[]\n      return queryInput\n    },\n    {} as PartialRecord<`${T}MetafieldIdentifiers`, HasMetafieldsIdentifier[]>\n  )\n  return identifiers\n}\n\nexport const parseMetafield = (item: Metafield, previewData?: any, resource_type?: string) => {\n  const type = item?.type && item?.type.toLowerCase()\n  if (\n    item &&\n    previewData &&\n    previewData?.__preview_type === resource_type &&\n    previewData[`${item?.namespace}${item?.key}`] !== undefined &&\n    previewData[`${item?.namespace}${item?.key}`] !== null\n  ) {\n    return previewData[`${item.namespace}${item.key}`]\n  }\n  switch (type) {\n    case 'json':\n    case 'json_string':\n    case 'rating':\n    case 'volume':\n    case 'weight':\n    case 'dimension':\n      return JSON.parse(item.value)\n    default:\n      return item?.value || item\n  }\n}\n\nexport const normalizeMetafields = (metafields: Array<Maybe<Metafield>>): Record<string, any> => {\n  return metafields?.reduce(\n    (prev, cur) => {\n      if (cur) {\n        const namespace = cur.key\n        prev[namespace] = prev[namespace] || {}\n        const parsedMetafields: {\n          [key: string]: Metafield\n        } = parseMetafield(cur)\n        if (parsedMetafields) {\n          Object.entries(parsedMetafields).forEach(([key, innerMetafields]) => {\n            prev[namespace][key] =\n              prev[namespace][key] ?? (innerMetafields ? parseMetafield(innerMetafields) : null)\n          })\n        }\n      }\n      return prev\n    },\n    {} as Record<string, any>\n  )\n}\n\n/**\n * Add @inContext directive to GraphQL query for single shop multi-language/currency support\n *\n * @param query - GraphQL query string\n * @param country - Country code (e.g., 'PL', 'CA', 'US')\n * @param language - Language code (e.g., 'PL', 'FR', 'EN')\n * @returns Modified query with @inContext directive, or original query if country/language not provided\n *\n * @example\n * ```typescript\n * const query = `query getCart($cartId: ID!) { cart(id: $cartId) { id } }`\n * const modifiedQuery = addInContextDirective(query, 'PL', 'PL')\n * // Result: query getCart($cartId: ID!) @inContext(country: PL, language: PL) { cart(id: $cartId) { id } }\n * ```\n */\nexport function addInContextDirective(\n  query: string,\n  country?: string,\n  language?: string\n): string {\n  // If no country or language, return original query\n  if (!country || !language) {\n    return query\n  }\n\n  // Match query/mutation declaration with optional parameters\n  // e.g., \"query getCart(...)\" or \"mutation createCart\"\n  const operationRegex = /((?:query|mutation)\\s+\\w+)(\\s*\\([^)]*\\))?\\s*(\\{)/\n  const match = query.match(operationRegex)\n\n  if (!match) {\n    // Fallback: try to find first { if no operation found\n    const braceIndex = query.indexOf('{')\n    if (braceIndex === -1) return query\n\n    const beforeBrace = query.substring(0, braceIndex).trim()\n    const afterBrace = query.substring(braceIndex)\n    return `${beforeBrace} @inContext(country: ${country}, language: ${language}) ${afterBrace}`\n  }\n\n  // Insert @inContext after operation declaration (and parameters if exist), before {\n  const beforeDirective = match[1] + (match[2] || '') // e.g., \"query getCart($id: ID!)\"\n  const afterDirective = query.substring(match.index! + match[0].length - 1) // Everything starting from {\n\n  return `${beforeDirective} @inContext(country: ${country}, language: ${language}) ${afterDirective}`\n}\n","import type { ShopifyConfig } from '@anker-in/shopify-core'\nimport type { GraphQLResponse, GraphQLRequest, FetchOptions } from './types'\nimport { addInContextDirective } from '../utils'\n\n/**\n * Shopify GraphQL Client\n * Handles all GraphQL communication with Shopify Storefront API\n */\nexport class ShopifyClient {\n  private config: ShopifyConfig\n  private locale: string\n\n  constructor(config: ShopifyConfig, locale: string) {\n    this.config = config\n    this.locale = locale\n  }\n\n  /**\n   * Execute a GraphQL request\n   */\n  async request<T = any>(\n    request: GraphQLRequest,\n    options: FetchOptions = {}\n  ): Promise<GraphQLResponse<T>> {\n    let { query, variables, operationName } = request\n    const { tags = [], ...fetchOptions } = options\n\n    // Add @inContext directive if needed for single shop multi-language/currency\n    const country = this.config.getCountryCode(this.locale)\n    const language = this.config.getLanguageCode(this.locale)\n    query = addInContextDirective(query, country, language)\n\n    const apiUrl = this.config.getApiUrl(this.locale)\n    const token = this.config.getStorefrontToken(this.locale)\n\n    const headers: HeadersInit = {\n      'Content-Type': 'application/json',\n      'X-Shopify-Storefront-Access-Token': token,\n      ...(fetchOptions.headers || {}),\n    }\n\n    const body = JSON.stringify({\n      query,\n      variables,\n      operationName,\n    })\n\n    try {\n      const response = await fetch(apiUrl, {\n        method: 'POST',\n        headers,\n        body,\n        ...fetchOptions,\n        ...(tags.length > 0 && { next: { tags } }),\n      })\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`)\n      }\n\n      const json: GraphQLResponse<T> = await response.json()\n\n      if (json.errors && json.errors.length > 0) {\n        console.error('GraphQL Errors:', json.errors)\n      }\n\n      return json\n    } catch (error) {\n      console.error('Shopify API Request Failed:', error)\n      throw error\n    }\n  }\n\n  /**\n   * Convenience method for simple queries\n   */\n  async query<T = any>(\n    query: string,\n    variables?: Record<string, any>,\n    options?: FetchOptions\n  ): Promise<T | undefined> {\n    const response = await this.request<T>({ query, variables }, options)\n    return response.data\n  }\n\n  /**\n   * Get current locale\n   */\n  getLocale(): string {\n    return this.locale\n  }\n\n  /**\n   * Get config\n   */\n  getConfig(): ShopifyConfig {\n    return this.config\n  }\n\n  /**\n   * Get API URL\n   */\n  getApiUrl(): string {\n    return this.config.getApiUrl(this.locale)\n  }\n\n  /**\n   * Create a new client with different locale\n   */\n  withLocale(locale: string): ShopifyClient {\n    return new ShopifyClient(this.config, locale)\n  }\n}\n\n/**\n * Factory function to create a Shopify client\n */\nexport function createShopifyClient(config: ShopifyConfig, locale: string): ShopifyClient {\n  return new ShopifyClient(config, locale)\n}\n"]}

package/dist/index.d.mts

@@ -10230,6 +10230,7 @@ interface NormalizedLineItem {
     totalAmount: number;
     subtotalAmount: number;
     discountAllocations: Array<{
+        title: string;
         code: string;
         amount: number;
     }>;
@@ -10280,6 +10281,7 @@ interface NormalizedCart {
         code: string;
     }>;
     discountAllocations?: Array<{
+        title: string;
         code: string;
         amount: number;
     }>;
@@ -10400,6 +10402,8 @@ interface CreateCartOptions {
         variant: HasMetafieldsIdentifier[];
         product: HasMetafieldsIdentifier[];
     };
+    /** Whether to update the cookie * 默认不更新cookie/ 仅在需要更新cookie时设置为true */
+    updateCookie?: boolean;
 }
 /**
  * Create a new cart
@@ -10437,25 +10441,12 @@ declare function createCart(client: ShopifyClient, options?: CreateCartOptions):
  */
 
 interface AddCartLinesOptions {
-    /** Cart ID (optional, will create new cart if not provided) */
-    cartId?: string;
+    /** Cart ID (required) */
+    cartId: string;
     /** Lines to add */
     lines: CartLineInput[];
     /** Cookie adapter for managing cart ID */
     cookieAdapter?: CartCookieAdapter;
-    /** Current locale */
-    /** Buyer identity for cart creation */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
-    /** Discount codes (only used when creating new cart) */
-    discountCodes?: string[];
-    /** Custom attributes (only used when creating new cart) */
-    customAttributes?: Array<{
-        key: string;
-        value: string;
-    }>;
     /** Metafield identifiers */
     metafieldIdentifiers?: {
         variant: HasMetafieldsIdentifier[];
@@ -10463,7 +10454,7 @@ interface AddCartLinesOptions {
     };
 }
 /**
- * Add lines to cart (creates new cart if needed)
+ * Add lines to an existing cart
  *
  * @param client - Shopify GraphQL client
  * @param options - Add cart lines options
@@ -10472,7 +10463,7 @@ interface AddCartLinesOptions {
  * @example
  * ```ts
  * const cart = await addCartLines(client, {
- *   locale: 'us',
+ *   cartId: 'gid://shopify/Cart/xxx',
  *   lines: [{
  *     merchandiseId: 'gid://shopify/ProductVariant/123',
  *     quantity: 1

package/dist/index.d.ts

@@ -10230,6 +10230,7 @@ interface NormalizedLineItem {
     totalAmount: number;
     subtotalAmount: number;
     discountAllocations: Array<{
+        title: string;
         code: string;
         amount: number;
     }>;
@@ -10280,6 +10281,7 @@ interface NormalizedCart {
         code: string;
     }>;
     discountAllocations?: Array<{
+        title: string;
         code: string;
         amount: number;
     }>;
@@ -10400,6 +10402,8 @@ interface CreateCartOptions {
         variant: HasMetafieldsIdentifier[];
         product: HasMetafieldsIdentifier[];
     };
+    /** Whether to update the cookie * 默认不更新cookie/ 仅在需要更新cookie时设置为true */
+    updateCookie?: boolean;
 }
 /**
  * Create a new cart
@@ -10437,25 +10441,12 @@ declare function createCart(client: ShopifyClient, options?: CreateCartOptions):
  */
 
 interface AddCartLinesOptions {
-    /** Cart ID (optional, will create new cart if not provided) */
-    cartId?: string;
+    /** Cart ID (required) */
+    cartId: string;
     /** Lines to add */
     lines: CartLineInput[];
     /** Cookie adapter for managing cart ID */
     cookieAdapter?: CartCookieAdapter;
-    /** Current locale */
-    /** Buyer identity for cart creation */
-    buyerIdentity?: {
-        email?: string;
-        countryCode?: string;
-    };
-    /** Discount codes (only used when creating new cart) */
-    discountCodes?: string[];
-    /** Custom attributes (only used when creating new cart) */
-    customAttributes?: Array<{
-        key: string;
-        value: string;
-    }>;
     /** Metafield identifiers */
     metafieldIdentifiers?: {
         variant: HasMetafieldsIdentifier[];
@@ -10463,7 +10454,7 @@ interface AddCartLinesOptions {
     };
 }
 /**
- * Add lines to cart (creates new cart if needed)
+ * Add lines to an existing cart
  *
  * @param client - Shopify GraphQL client
  * @param options - Add cart lines options
@@ -10472,7 +10463,7 @@ interface AddCartLinesOptions {
  * @example
  * ```ts
  * const cart = await addCartLines(client, {
- *   locale: 'us',
+ *   cartId: 'gid://shopify/Cart/xxx',
  *   lines: [{
  *     merchandiseId: 'gid://shopify/ProductVariant/123',
  *     quantity: 1

package/dist/index.js

@@ -2,6 +2,71 @@
 
 var shopifyCore = require('@anker-in/shopify-core');
 
+// src/utils.ts
+function constructMetafieldIdentifiersQueryParams(metafieldIdentifiers = {}, metafieldNamespacePrefix) {
+  const identifiers = Object.entries(metafieldIdentifiers).reduce(
+    (queryInput, [key, value]) => {
+      const metafieldIdentifiers2 = value;
+      queryInput[`${key}MetafieldIdentifiers`] = metafieldIdentifiers2.map((item) => ({
+        namespace: item.namespace,
+        key: item.key
+      }));
+      return queryInput;
+    },
+    {}
+  );
+  return identifiers;
+}
+var parseMetafield = (item, previewData, resource_type) => {
+  const type = item?.type && item?.type.toLowerCase();
+  switch (type) {
+    case "json":
+    case "json_string":
+    case "rating":
+    case "volume":
+    case "weight":
+    case "dimension":
+      return JSON.parse(item.value);
+    default:
+      return item?.value || item;
+  }
+};
+var normalizeMetafields = (metafields) => {
+  return metafields?.reduce(
+    (prev, cur) => {
+      if (cur) {
+        const namespace = cur.key;
+        prev[namespace] = prev[namespace] || {};
+        const parsedMetafields = parseMetafield(cur);
+        if (parsedMetafields) {
+          Object.entries(parsedMetafields).forEach(([key, innerMetafields]) => {
+            prev[namespace][key] = prev[namespace][key] ?? (innerMetafields ? parseMetafield(innerMetafields) : null);
+          });
+        }
+      }
+      return prev;
+    },
+    {}
+  );
+};
+function addInContextDirective(query, country, language) {
+  if (!country || !language) {
+    return query;
+  }
+  const operationRegex = /((?:query|mutation)\s+\w+)(\s*\([^)]*\))?\s*(\{)/;
+  const match = query.match(operationRegex);
+  if (!match) {
+    const braceIndex = query.indexOf("{");
+    if (braceIndex === -1) return query;
+    const beforeBrace = query.substring(0, braceIndex).trim();
+    const afterBrace = query.substring(braceIndex);
+    return `${beforeBrace} @inContext(country: ${country}, language: ${language}) ${afterBrace}`;
+  }
+  const beforeDirective = match[1] + (match[2] || "");
+  const afterDirective = query.substring(match.index + match[0].length - 1);
+  return `${beforeDirective} @inContext(country: ${country}, language: ${language}) ${afterDirective}`;
+}
+
 // src/client/client.ts
 var ShopifyClient = class _ShopifyClient {
   config;
@@ -14,8 +79,11 @@ var ShopifyClient = class _ShopifyClient {
    * Execute a GraphQL request
    */
   async request(request, options = {}) {
-    const { query, variables, operationName } = request;
+    let { query, variables, operationName } = request;
     const { tags = [], ...fetchOptions } = options;
+    const country = this.config.getCountryCode(this.locale);
+    const language = this.config.getLanguageCode(this.locale);
+    query = addInContextDirective(query, country, language);
     const apiUrl = this.config.getApiUrl(this.locale);
     const token = this.config.getStorefrontToken(this.locale);
     const headers = {
@@ -37,9 +105,7 @@ var ShopifyClient = class _ShopifyClient {
         ...tags.length > 0 && { next: { tags } }
       });
       if (!response.ok) {
-        throw new Error(
-          `HTTP ${response.status}: ${response.statusText}`
-        );
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
       }
       const json = await response.json();
       if (json.errors && json.errors.length > 0) {
@@ -55,10 +121,7 @@ var ShopifyClient = class _ShopifyClient {
    * Convenience method for simple queries
    */
   async query(query, variables, options) {
-    const response = await this.request(
-      { query, variables },
-      options
-    );
+    const response = await this.request({ query, variables }, options);
     return response.data;
   }
   /**
@@ -1011,56 +1074,6 @@ var updateCartDeliveryOptionsMutation = (
   ${cartFragment}
 `
 );
-
-// src/utils.ts
-function constructMetafieldIdentifiersQueryParams(metafieldIdentifiers = {}, metafieldNamespacePrefix) {
-  const identifiers = Object.entries(metafieldIdentifiers).reduce(
-    (queryInput, [key, value]) => {
-      const metafieldIdentifiers2 = value;
-      queryInput[`${key}MetafieldIdentifiers`] = metafieldIdentifiers2.map((item) => ({
-        namespace: `${metafieldNamespacePrefix}combo`,
-        key: item.namespace
-      }));
-      return queryInput;
-    },
-    {}
-  );
-  return identifiers;
-}
-var parseMetafield = (item, previewData, resource_type) => {
-  const type = item?.type && item?.type.toLowerCase();
-  switch (type) {
-    case "json":
-    case "json_string":
-    case "rating":
-    case "volume":
-    case "weight":
-    case "dimension":
-      return JSON.parse(item.value);
-    default:
-      return item?.value || item;
-  }
-};
-var normalizeMetafields = (metafields) => {
-  return metafields?.reduce(
-    (prev, cur) => {
-      if (cur) {
-        const namespace = cur.key;
-        prev[namespace] = prev[namespace] || {};
-        const parsedMetafields = parseMetafield(cur);
-        if (parsedMetafields) {
-          Object.entries(parsedMetafields).forEach(([key, innerMetafields]) => {
-            prev[namespace][key] = prev[namespace][key] ?? (innerMetafields ? parseMetafield(innerMetafields) : null);
-          });
-        }
-      }
-      return prev;
-    },
-    {}
-  );
-};
-
-// src/api/product/normalize.ts
 var normalizeSellingPlan = ({ edges }) => {
   return edges?.map(({ node }) => node);
 };
@@ -1088,12 +1101,14 @@ function normalizeVariant(variant) {
     amount: variant.compareAtPriceV2.amount,
     currencyCode: variant.compareAtPriceV2.currencyCode
   } : void 0;
+  const isSoldOut = Number(price.amount) === shopifyCore.SOLD_OUT_PRICE;
   const metafields = normalizeMetafields(variant.metafields || []);
   return {
     id: variant.id,
     title: variant.title,
     sku: variant.sku || "",
-    availableForSale: variant.availableForSale || false,
+    // 如果价格为售罄价格，强制设置 availableForSale 为 false
+    availableForSale: isSoldOut ? false : variant.availableForSale || false,
     quantityAvailable: variant.quantityAvailable,
     selectedOptions: variant.selectedOptions || [],
     price,
@@ -1367,7 +1382,8 @@ function normalizeLineItem(line) {
     totalAmount: cost?.totalAmount?.amount || 0,
     subtotalAmount: cost?.subtotalAmount?.amount || 0,
     discountAllocations: discountAllocations?.map((item) => ({
-      code: item?.code || item?.title || "",
+      title: item?.title || "",
+      code: item?.code || "",
       amount: item?.discountedAmount?.amount || 0
     })) || [],
     customAttributes: attributes?.filter((item) => item.key && item.value).map((item) => ({ key: item.key, value: item.value || "" })) || [],
@@ -1434,7 +1450,8 @@ function normalizeCart(cart) {
     orderDiscounts,
     discountCodes: cart.discountCodes || [],
     discountAllocations: cart?.discountAllocations?.map((item) => ({
-      code: item?.code || item?.title || "",
+      title: item?.title || "",
+      code: item?.code || "",
       amount: Number(item?.discountedAmount?.amount || 0)
     })) || [],
     // Map delivery amount from cart cost
@@ -1496,7 +1513,8 @@ async function createCart(client, options = {}) {
     buyerIdentity,
     discountCodes,
     customAttributes,
-    metafieldIdentifiers
+    metafieldIdentifiers,
+    updateCookie = false
   } = options;
   const locale = client.getLocale();
   try {
@@ -1518,7 +1536,7 @@ async function createCart(client, options = {}) {
       return void 0;
     }
     const normalizedCart = normalizeCart(cart);
-    if (cookieAdapter && normalizedCart.id) {
+    if (cookieAdapter && normalizedCart.id && updateCookie) {
       cookieAdapter.setCartId(locale, normalizedCart.id);
     }
     return normalizedCart;
@@ -1530,46 +1548,22 @@ async function createCart(client, options = {}) {
 
 // src/api/cart/add-cart-lines.ts
 async function addCartLines(client, options) {
-  const {
-    cartId: providedCartId,
-    lines,
-    cookieAdapter,
-    buyerIdentity,
-    discountCodes,
-    customAttributes,
-    metafieldIdentifiers
-  } = options;
+  const { cartId, lines, cookieAdapter, metafieldIdentifiers } = options;
   const locale = client.getLocale();
-  const cartId = providedCartId || cookieAdapter?.getCartId(locale);
   const normalizedMetafieldIdentifiers = constructMetafieldIdentifiersQueryParams(
     metafieldIdentifiers,
     client.getConfig().getMetafieldNamespacePrefix()
   );
   try {
-    let cart;
-    if (cartId) {
-      const data = await client.query(addCartItemsMutation, {
-        cartId,
-        lines,
-        ...normalizedMetafieldIdentifiers
-      });
-      if (data?.cartLinesAdd?.userErrors?.length) {
-        console.error("[addCartLines] User errors:", data.cartLinesAdd.userErrors);
-      }
-      cart = data?.cartLinesAdd?.cart;
-    } else {
-      const data = await client.query(createCartMutation, {
-        lines,
-        buyerIdentity,
-        discountCodes,
-        attributes: customAttributes,
-        ...normalizedMetafieldIdentifiers
-      });
-      if (data?.cartCreate?.userErrors?.length) {
-        console.error("[addCartLines] User errors:", data.cartCreate.userErrors);
-      }
-      cart = data?.cartCreate?.cart;
+    const data = await client.query(addCartItemsMutation, {
+      cartId,
+      lines,
+      ...normalizedMetafieldIdentifiers
+    });
+    if (data?.cartLinesAdd?.userErrors?.length) {
+      console.error("[addCartLines] User errors:", data.cartLinesAdd.userErrors);
     }
+    const cart = data?.cartLinesAdd?.cart;
     if (!cart) {
       return void 0;
     }
@@ -1592,14 +1586,17 @@ async function updateCartLines(client, options) {
   if (!cartId) {
     throw new Error("Invalid input used for this operation: Miss cartId");
   }
+  const metafieldParams = constructMetafieldIdentifiersQueryParams(
+    metafieldIdentifiers,
+    client.getConfig().getMetafieldNamespacePrefix()
+  );
+  console.log("update-cart-lines metafieldIdentifiers:", metafieldIdentifiers);
+  console.log("update-cart-lines metafieldParams:", metafieldParams);
   try {
     const data = await client.query(updateCartItemsMutation, {
       cartId,
       lines,
-      ...constructMetafieldIdentifiersQueryParams(
-        metafieldIdentifiers,
-        client.getConfig().getMetafieldNamespacePrefix()
-      )
+      ...metafieldParams
     });
     let maxNum;
     if (data?.cartLinesUpdate?.userErrors?.length) {