@commercengine/storefront-sdk 0.3.8 → 0.3.10

package/dist/index.d.ts

@@ -8,6 +8,18 @@ import { HelpersClient } from "./lib/helper";
 import { CustomerClient } from "./lib/customer";
 import { TokenStorage, MemoryTokenStorage, BrowserTokenStorage, CookieTokenStorage } from "./lib/middleware";
 import { type UserInfo } from "./lib/jwt-utils";
+import { ResponseUtils, type DebugLoggerFn } from "./lib/logger-utils";
+/**
+ * Supported default headers that can be set at the SDK level
+ * Only includes headers that are actually supported by API endpoints
+ */
+export interface SupportedDefaultHeaders {
+    /**
+     * Customer group ID used for pricing, promotions, and subscription rates
+     * If not provided, the API will use default pricing
+     */
+    customer_group_id?: string;
+}
 /**
  * SDK initialization options
  */
@@ -58,6 +70,23 @@ export interface StorefrontSDKOptions {
      * Callback when tokens are cleared (logout/error)
      */
     onTokensCleared?: () => void;
+    /**
+     * Default headers to include with API requests
+     * These can be overridden at the method level
+     * Only supports headers that are actually available in the API
+     */
+    defaultHeaders?: SupportedDefaultHeaders;
+    /**
+     * Enable debug mode for detailed request/response logging
+     * When enabled, detailed debug information will be logged via the logger
+     * Note: Response objects are always included in ApiResult regardless of debug mode
+     */
+    debug?: boolean;
+    /**
+     * Custom logger function for debug information
+     * If not provided and debug is enabled, will use console.log
+     */
+    logger?: DebugLoggerFn;
 }
 /**
  * Main SDK class for the Storefront API
@@ -166,12 +195,25 @@ export declare class StorefrontSDK {
      * @returns Customer group ID or null if no token, invalid token, or user has no customer group
      */
     getCustomerGroupId(): Promise<string | null>;
+    /**
+     * Set default headers for all clients
+     *
+     * @param headers - Default headers to set (only supported headers allowed)
+     */
+    setDefaultHeaders(headers: SupportedDefaultHeaders): void;
+    /**
+     * Get current default headers
+     *
+     * @returns Current default headers
+     */
+    getDefaultHeaders(): SupportedDefaultHeaders | undefined;
 }
 export default StorefrontSDK;
-export { StorefrontAPIClient, AuthClient, CartClient, CatalogClient, CustomerClient, HelpersClient, ShippingClient, OrderClient, };
+export { StorefrontAPIClient, AuthClient, CartClient, CatalogClient, CustomerClient, HelpersClient, ShippingClient, OrderClient, ResponseUtils, };
 export { Environment };
 export { TokenStorage, MemoryTokenStorage, BrowserTokenStorage, CookieTokenStorage, };
 export type { CookieTokenStorageOptions } from "./lib/middleware";
 export type { UserInfo } from "./lib/jwt-utils";
+export type { DebugLoggerFn } from "./lib/logger-utils";
 export type { components, operations, paths } from "./types/storefront";
 export type * from "./types/storefront-api-types";

package/dist/index.js

@@ -8,6 +8,7 @@ import { HelpersClient } from "./lib/helper";
 import { CustomerClient } from "./lib/customer";
 import { MemoryTokenStorage, BrowserTokenStorage, CookieTokenStorage, } from "./lib/middleware";
 import { extractUserInfoFromToken, getUserIdFromToken, isUserLoggedIn, isUserAnonymous, } from "./lib/jwt-utils";
+import { ResponseUtils, } from "./lib/logger-utils";
 /**
  * Main SDK class for the Storefront API
  */
@@ -58,6 +59,9 @@ export class StorefrontSDK {
             tokenStorage: options.tokenStorage,
             onTokensUpdated: options.onTokensUpdated,
             onTokensCleared: options.onTokensCleared,
+            defaultHeaders: options.defaultHeaders,
+            debug: options.debug,
+            logger: options.logger,
         };
         this.catalog = new CatalogClient(config);
         this.cart = new CartClient(config);
@@ -198,11 +202,35 @@ export class StorefrontSDK {
         const userInfo = await this.getUserInfo();
         return userInfo?.customerGroupId || null;
     }
+    /**
+     * Set default headers for all clients
+     *
+     * @param headers - Default headers to set (only supported headers allowed)
+     */
+    setDefaultHeaders(headers) {
+        // Update config for all clients
+        const newConfig = { ...this.catalog["config"], defaultHeaders: headers };
+        this.catalog["config"] = newConfig;
+        this.cart["config"] = newConfig;
+        this.auth["config"] = newConfig;
+        this.customer["config"] = newConfig;
+        this.helpers["config"] = newConfig;
+        this.shipping["config"] = newConfig;
+        this.order["config"] = newConfig;
+    }
+    /**
+     * Get current default headers
+     *
+     * @returns Current default headers
+     */
+    getDefaultHeaders() {
+        return this.catalog["config"].defaultHeaders;
+    }
 }
 // Export the main SDK class
 export default StorefrontSDK;
 // Export individual clients for advanced usage
-export { StorefrontAPIClient, AuthClient, CartClient, CatalogClient, CustomerClient, HelpersClient, ShippingClient, OrderClient, };
+export { StorefrontAPIClient, AuthClient, CartClient, CatalogClient, CustomerClient, HelpersClient, ShippingClient, OrderClient, ResponseUtils, };
 // Export environment enum
 export { Environment };
 // Export token storage types

package/dist/lib/cart.d.ts

@@ -149,15 +149,15 @@ export declare class CartClient extends StorefrontAPIClient {
     /**
      * Get all available coupons
      *
-     * @param customerGroupId - The ID of the customer group
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with all available coupons
      */
-    getAvailableCoupons(headers: ListCouponsHeaderParams): Promise<ApiResult<ListCouponsContent>>;
+    getAvailableCoupons(headers?: ListCouponsHeaderParams): Promise<ApiResult<ListCouponsContent>>;
     /**
      * Get all available promotions
      *
-     * @param customerGroupId - The ID of the customer group
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with all available promotions
      */
-    getAvailablePromotions(headers: ListPromotionsHeaderParams): Promise<ApiResult<ListPromotionsContent>>;
+    getAvailablePromotions(headers?: ListPromotionsHeaderParams): Promise<ApiResult<ListPromotionsContent>>;
 }

package/dist/lib/cart.js

@@ -274,23 +274,29 @@ export class CartClient extends StorefrontAPIClient {
     /**
      * Get all available coupons
      *
-     * @param customerGroupId - The ID of the customer group
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with all available coupons
      */
     async getAvailableCoupons(headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/carts/available-coupons", {
-            headers: headers,
+            params: {
+                header: mergedHeaders,
+            },
         }));
     }
     /**
      * Get all available promotions
      *
-     * @param customerGroupId - The ID of the customer group
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with all available promotions
      */
     async getAvailablePromotions(headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/carts/available-promotions", {
-            headers: headers,
+            params: {
+                header: mergedHeaders,
+            },
         }));
     }
 }

package/dist/lib/catalog.d.ts

@@ -1,5 +1,5 @@
 import { StorefrontAPIClient } from "./client";
-import type { ApiResult, GetProductDetailContent, GetProductDetailPathParams, GetProductDetailQuery, GetVariantDetailContent, GetVariantDetailQuery, GetVariantDetailPathParams, ListProductsContent, ListProductsQuery, ListProductVariantsContent, ListProductVariantsPathParams, ListProductVariantsQuery, ListCategoriesQuery, ListCategoriesContent, ListProductReviewsQuery, ListProductReviewsPathParams, ListProductReviewsContent, CreateProductReviewPathParams, CreateProductReviewFormData, CreateProductReviewResponse, SearchProductsBody, SearchProductsContent, ListSkusQuery, ListSkusContent, ListCrosssellProductsContent, ListCrosssellProductsQuery, ListUpsellProductsQuery, ListUpsellProductsContent, ListSimilarProductsQuery, ListSimilarProductsContent } from "../types/storefront-api-types";
+import type { ApiResult, GetProductDetailContent, GetProductDetailPathParams, GetProductDetailHeaderParams, GetVariantDetailContent, GetVariantDetailPathParams, GetVariantDetailHeaderParams, ListProductsContent, ListProductsQuery, ListProductsHeaderParams, ListProductVariantsContent, ListProductVariantsPathParams, ListProductVariantsHeaderParams, ListCategoriesQuery, ListCategoriesContent, ListProductReviewsQuery, ListProductReviewsPathParams, ListProductReviewsContent, CreateProductReviewPathParams, CreateProductReviewFormData, CreateProductReviewResponse, SearchProductsBody, SearchProductsContent, ListSkusQuery, ListSkusContent, ListSkusHeaderParams, ListCrosssellProductsContent, ListCrosssellProductsQuery, ListCrosssellProductsHeaderParams, ListUpsellProductsQuery, ListUpsellProductsContent, ListUpsellProductsHeaderParams, ListSimilarProductsQuery, ListSimilarProductsContent, ListSimilarProductsHeaderParams } from "../types/storefront-api-types";
 /**
  * Client for interacting with catalog endpoints
  */
@@ -8,41 +8,42 @@ export declare class CatalogClient extends StorefrontAPIClient {
      * List all products
      *
      * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with products and pagination info
      */
-    listProducts(options?: ListProductsQuery): Promise<ApiResult<ListProductsContent>>;
+    listProducts(options?: ListProductsQuery, headers?: ListProductsHeaderParams): Promise<ApiResult<ListProductsContent>>;
     /**
      * List all skus
      *
      * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with skus and pagination info
      */
-    listSkus(options?: ListSkusQuery): Promise<ApiResult<ListSkusContent>>;
+    listSkus(options?: ListSkusQuery, headers?: ListSkusHeaderParams): Promise<ApiResult<ListSkusContent>>;
     /**
      * Get details for a specific product
      *
-     * @param productId - The ID of the product
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID or slug)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with product details
      */
-    getProductDetail(pathParams: GetProductDetailPathParams, queryParams?: GetProductDetailQuery): Promise<ApiResult<GetProductDetailContent>>;
+    getProductDetail(pathParams: GetProductDetailPathParams, headers?: GetProductDetailHeaderParams): Promise<ApiResult<GetProductDetailContent>>;
     /**
      * List variants for a specific product
      *
-     * @param productId - The ID of the product
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with variants
      */
-    listProductVariants(pathParams: ListProductVariantsPathParams, queryParams?: ListProductVariantsQuery): Promise<ApiResult<ListProductVariantsContent>>;
+    listProductVariants(pathParams: ListProductVariantsPathParams, headers?: ListProductVariantsHeaderParams): Promise<ApiResult<ListProductVariantsContent>>;
     /**
      * Get details for a specific variant
      *
-     * @param productId - The ID of the product
-     * @param variantId - The ID of the variant
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID and variant ID)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with variant details
      */
-    getVariantDetail(pathParams: GetVariantDetailPathParams, queryParams?: GetVariantDetailQuery): Promise<ApiResult<GetVariantDetailContent>>;
+    getVariantDetail(pathParams: GetVariantDetailPathParams, headers?: GetVariantDetailHeaderParams): Promise<ApiResult<GetVariantDetailContent>>;
     /**
      * List all categories
      *
@@ -53,16 +54,16 @@ export declare class CatalogClient extends StorefrontAPIClient {
     /**
      * List reviews for a specific product
      *
-     * @param productId - The ID of the product
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID)
+     * @param queryParams - Optional query parameters
      * @returns Promise with reviews and pagination info
      */
     listProductReviews(pathParams: ListProductReviewsPathParams, queryParams?: ListProductReviewsQuery): Promise<ApiResult<ListProductReviewsContent>>;
     /**
      * Create a review for a specific product
      *
-     * @param productId - The ID of the product
-     * @param reviewData - The review data
+     * @param pathParams - The path parameters (product ID)
+     * @param formData - The review data
      * @returns Promise that resolves when the review is created
      */
     createProductReview(pathParams: CreateProductReviewPathParams, formData: CreateProductReviewFormData): Promise<ApiResult<CreateProductReviewResponse>>;
@@ -74,24 +75,27 @@ export declare class CatalogClient extends StorefrontAPIClient {
      */
     searchProducts(searchData: SearchProductsBody): Promise<ApiResult<SearchProductsContent>>;
     /**
-     * Retrieve cross-sell recommendations for a specific product
+     * List cross-sell products
      *
      * @param options - Optional query parameters
-     * @returns Promise with cross-sell recommendations with pagination
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with cross-sell products
      */
-    listCrossSellProducts(options?: ListCrosssellProductsQuery): Promise<ApiResult<ListCrosssellProductsContent>>;
+    listCrossSellProducts(options?: ListCrosssellProductsQuery, headers?: ListCrosssellProductsHeaderParams): Promise<ApiResult<ListCrosssellProductsContent>>;
     /**
-     * Retrieve up-sell recommendations for a specific product
+     * List up-sell products
      *
      * @param options - Optional query parameters
-     * @returns Promise with up-sell recommendations with pagination
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with up-sell products
      */
-    listUpSellProducts(options?: ListUpsellProductsQuery): Promise<ApiResult<ListUpsellProductsContent>>;
+    listUpSellProducts(options?: ListUpsellProductsQuery, headers?: ListUpsellProductsHeaderParams): Promise<ApiResult<ListUpsellProductsContent>>;
     /**
-     * Retrieve related products for a specific product
+     * List similar products
      *
      * @param options - Optional query parameters
-     * @returns Promise with related products with pagination
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with similar products
      */
-    listSimilarProducts(options?: ListSimilarProductsQuery): Promise<ApiResult<ListSimilarProductsContent>>;
+    listSimilarProducts(options?: ListSimilarProductsQuery, headers?: ListSimilarProductsHeaderParams): Promise<ApiResult<ListSimilarProductsContent>>;
 }

package/dist/lib/catalog.js

@@ -7,67 +7,79 @@ export class CatalogClient extends StorefrontAPIClient {
      * List all products
      *
      * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with products and pagination info
      */
-    async listProducts(options) {
-        return this.executeRequest(() => this.client.GET('/catalog/products', {
-            params: { query: options },
+    async listProducts(options, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
+        return this.executeRequest(() => this.client.GET("/catalog/products", {
+            params: {
+                query: options,
+                header: mergedHeaders,
+            },
         }));
     }
     /**
      * List all skus
      *
      * @param options - Optional query parameters
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with skus and pagination info
      */
-    async listSkus(options) {
-        return this.executeRequest(() => this.client.GET('/catalog/skus', {
-            params: { query: options },
+    async listSkus(options, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
+        return this.executeRequest(() => this.client.GET("/catalog/skus", {
+            params: {
+                query: options,
+                header: mergedHeaders,
+            },
         }));
     }
     /**
      * Get details for a specific product
      *
-     * @param productId - The ID of the product
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID or slug)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with product details
      */
-    async getProductDetail(pathParams, queryParams) {
-        return this.executeRequest(() => this.client.GET('/catalog/products/{product_id}', {
+    async getProductDetail(pathParams, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
+        return this.executeRequest(() => this.client.GET("/catalog/products/{product_id_or_slug}", {
             params: {
                 path: pathParams,
-                query: queryParams,
+                header: mergedHeaders,
             },
         }));
     }
     /**
      * List variants for a specific product
      *
-     * @param productId - The ID of the product
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with variants
      */
-    async listProductVariants(pathParams, queryParams) {
+    async listProductVariants(pathParams, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/catalog/products/{product_id}/variants", {
             params: {
                 path: pathParams,
-                query: queryParams,
+                header: mergedHeaders,
             },
         }));
     }
     /**
      * Get details for a specific variant
      *
-     * @param productId - The ID of the product
-     * @param variantId - The ID of the variant
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID and variant ID)
+     * @param headers - Optional header parameters (customer_group_id, etc.)
      * @returns Promise with variant details
      */
-    async getVariantDetail(pathParams, queryParams) {
+    async getVariantDetail(pathParams, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/catalog/products/{product_id}/variants/{variant_id}", {
             params: {
                 path: pathParams,
-                query: queryParams,
+                header: mergedHeaders,
             },
         }));
     }
@@ -85,8 +97,8 @@ export class CatalogClient extends StorefrontAPIClient {
     /**
      * List reviews for a specific product
      *
-     * @param productId - The ID of the product
-     * @param options - Optional query parameters
+     * @param pathParams - The path parameters (product ID)
+     * @param queryParams - Optional query parameters
      * @returns Promise with reviews and pagination info
      */
     async listProductReviews(pathParams, queryParams) {
@@ -100,8 +112,8 @@ export class CatalogClient extends StorefrontAPIClient {
     /**
      * Create a review for a specific product
      *
-     * @param productId - The ID of the product
-     * @param reviewData - The review data
+     * @param pathParams - The path parameters (product ID)
+     * @param formData - The review data
      * @returns Promise that resolves when the review is created
      */
     async createProductReview(pathParams, formData) {
@@ -125,7 +137,7 @@ export class CatalogClient extends StorefrontAPIClient {
                     }
                 }
                 return fd;
-            }
+            },
         }));
     }
     /**
@@ -140,41 +152,50 @@ export class CatalogClient extends StorefrontAPIClient {
         }));
     }
     /**
-     * Retrieve cross-sell recommendations for a specific product
+     * List cross-sell products
      *
      * @param options - Optional query parameters
-     * @returns Promise with cross-sell recommendations with pagination
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with cross-sell products
      */
-    async listCrossSellProducts(options) {
+    async listCrossSellProducts(options, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/catalog/products/cross-sell", {
             params: {
                 query: options,
+                header: mergedHeaders,
             },
         }));
     }
     /**
-     * Retrieve up-sell recommendations for a specific product
+     * List up-sell products
      *
      * @param options - Optional query parameters
-     * @returns Promise with up-sell recommendations with pagination
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with up-sell products
      */
-    async listUpSellProducts(options) {
+    async listUpSellProducts(options, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/catalog/products/up-sell", {
             params: {
                 query: options,
+                header: mergedHeaders,
             },
         }));
     }
     /**
-     * Retrieve related products for a specific product
+     * List similar products
      *
      * @param options - Optional query parameters
-     * @returns Promise with related products with pagination
+     * @param headers - Optional header parameters (customer_group_id, etc.)
+     * @returns Promise with similar products
      */
-    async listSimilarProducts(options) {
+    async listSimilarProducts(options, headers) {
+        const mergedHeaders = this.mergeHeaders(headers);
         return this.executeRequest(() => this.client.GET("/catalog/products/similar", {
             params: {
                 query: options,
+                header: mergedHeaders,
             },
         }));
     }

package/dist/lib/client.d.ts

@@ -102,4 +102,12 @@ export declare class StorefrontAPIClient {
      * Initialize tokens in storage (private helper method)
      */
     private initializeTokens;
+    /**
+     * Merge default headers with method-level headers
+     * Method-level headers take precedence over default headers
+     *
+     * @param methodHeaders - Headers passed to the specific method call
+     * @returns Merged headers object
+     */
+    protected mergeHeaders<T extends Record<string, any> = Record<string, any>>(methodHeaders?: T): T;
 }

package/dist/lib/client.js

@@ -1,6 +1,7 @@
 import createClient from "openapi-fetch";
 import { createDefaultAuthMiddleware } from "./middleware";
 import { getPathnameFromUrl, isAnonymousAuthEndpoint } from "./auth-utils";
+import { createDebugMiddleware } from "./logger-utils";
 /**
  * Available API environments
  */
@@ -81,6 +82,11 @@ export class StorefrontAPIClient {
         if (this.config.timeout) {
             this.setupTimeoutMiddleware();
         }
+        // Set up debug middleware if enabled
+        if (this.config.debug) {
+            const debugMiddleware = createDebugMiddleware(this.config.logger);
+            this.client.use(debugMiddleware);
+        }
     }
     /**
      * Set up timeout middleware
@@ -215,21 +221,39 @@ export class StorefrontAPIClient {
      */
     async executeRequest(apiCall) {
         try {
-            const { data, error } = await apiCall();
+            const { data, error, response } = await apiCall();
+            // Debug logging is now handled by middleware
             // openapi-fetch returns error for 4xx/5xx, data for 2xx
             if (error) {
-                return { data: null, error };
+                return {
+                    data: null,
+                    error,
+                    response,
+                };
             }
             // If response has content, return it directly
             if (data && data.content !== undefined) {
-                return { data: data.content, error: null };
+                return {
+                    data: data.content,
+                    error: null,
+                    response,
+                };
             }
             // If no content, return the response object (with message, success, etc.)
-            return { data: data, error: null };
+            return {
+                data: data,
+                error: null,
+                response,
+            };
         }
         catch (err) {
             // This handles network errors or other unexpected errors
-            return {
+            // Network errors don't have Response objects, so we create a mock response
+            const mockResponse = new Response(null, {
+                status: 0,
+                statusText: "Network Error",
+            });
+            const errorResult = {
                 data: null,
                 error: {
                     success: false,
@@ -237,7 +261,10 @@ export class StorefrontAPIClient {
                     message: "Network error occurred",
                     error: err,
                 },
+                response: mockResponse,
             };
+            // Network errors are logged by middleware if debug is enabled
+            return errorResult;
         }
     }
     /**
@@ -256,4 +283,37 @@ export class StorefrontAPIClient {
             console.warn("Failed to initialize tokens in storage:", error);
         }
     }
+    /**
+     * Merge default headers with method-level headers
+     * Method-level headers take precedence over default headers
+     *
+     * @param methodHeaders - Headers passed to the specific method call
+     * @returns Merged headers object
+     */
+    mergeHeaders(methodHeaders) {
+        if (!this.config.defaultHeaders && !methodHeaders) {
+            return {};
+        }
+        // Start with default headers, but only include supported ones
+        const merged = {};
+        // Add default headers if they exist
+        if (this.config.defaultHeaders) {
+            if (this.config.defaultHeaders.customer_group_id !== undefined) {
+                merged.customer_group_id =
+                    this.config.defaultHeaders.customer_group_id;
+            }
+            // Future: Add other supported headers here as they become available
+        }
+        if (methodHeaders) {
+            // Method headers override default headers
+            Object.assign(merged, methodHeaders);
+        }
+        // Remove undefined values
+        Object.keys(merged).forEach((key) => {
+            if (merged[key] === undefined) {
+                delete merged[key];
+            }
+        });
+        return merged;
+    }
 }