@commercengine/storefront-sdk 0.2.0 → 0.3.0

package/dist/lib/cart.d.ts

@@ -15,19 +15,19 @@ export declare class CartClient extends StorefrontAPIClient {
     /**
      * Get the stored cart ID
      *
-     * @returns The cart ID or null if not found
+     * @returns Promise that resolves to the cart ID or null if not found
      */
-    getCartId(): string | null;
+    getCartId(): Promise<string | null>;
     /**
      * Set the cart ID in storage
      *
      * @param cartId - The cart ID to store
      */
-    setCartId(cartId: string): void;
+    setCartId(cartId: string): Promise<void>;
     /**
      * Clear the stored cart ID
      */
-    clearCartId(): void;
+    clearCartId(): Promise<void>;
     /**
      * Create a new cart
      *

package/dist/lib/cart.js

@@ -21,24 +21,24 @@ class CartClient extends client_1.StorefrontAPIClient {
     /**
      * Get the stored cart ID
      *
-     * @returns The cart ID or null if not found
+     * @returns Promise that resolves to the cart ID or null if not found
      */
-    getCartId() {
-        return this.clientStorage?.getCartId() || null;
+    async getCartId() {
+        return this.clientStorage?.getCartId() ?? null;
     }
     /**
      * Set the cart ID in storage
      *
      * @param cartId - The cart ID to store
      */
-    setCartId(cartId) {
-        this.clientStorage?.setCartId(cartId);
+    async setCartId(cartId) {
+        await this.clientStorage?.setCartId(cartId);
     }
     /**
      * Clear the stored cart ID
      */
-    clearCartId() {
-        this.clientStorage?.clearCartId();
+    async clearCartId() {
+        await this.clientStorage?.clearCartId();
     }
     /**
      * Create a new cart
@@ -56,7 +56,7 @@ class CartClient extends client_1.StorefrontAPIClient {
             }
             // Store the cart ID
             if (data?.content?.cart?.id) {
-                this.setCartId(data.content.cart.id);
+                await this.setCartId(data.content.cart.id);
             }
             return data?.content;
         });
@@ -70,7 +70,7 @@ class CartClient extends client_1.StorefrontAPIClient {
      */
     async getCart(cartId) {
         // Use provided cartId or stored cartId
-        const id = cartId || this.getCartId();
+        const id = cartId || (await this.getCartId());
         if (!id) {
             throw new Error("Cart ID is required but not provided");
         }
@@ -95,23 +95,26 @@ class CartClient extends client_1.StorefrontAPIClient {
      */
     async deleteCart(cartId) {
         // Use provided cartId or stored cartId
-        const id = cartId || this.getCartId();
+        const id = cartId || (await this.getCartId());
         if (!id) {
             throw new Error("Cart ID is required but not provided");
         }
-        const { error } = await this.client.DELETE("/carts/{id}", {
-            params: {
-                path: { id },
-            },
-            body: undefined,
+        return this.executeRequest(async () => {
+            const { error } = await this.client.DELETE("/carts/{id}", {
+                params: {
+                    path: { id },
+                },
+                body: undefined,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            // Clear the stored cart ID if we deleted the current cart
+            const storedCartId = await this.getCartId();
+            if (cartId === undefined || cartId === storedCartId) {
+                await this.clearCartId();
+            }
         });
-        if (error) {
-            this.handleError(error);
-        }
-        // Clear the stored cart ID if we deleted the current cart
-        if (cartId === undefined || cartId === this.getCartId()) {
-            this.clearCartId();
-        }
     }
     /**
      * Add item to cart - either by specified ID or stored cart ID
@@ -123,7 +126,7 @@ class CartClient extends client_1.StorefrontAPIClient {
      */
     async addItem(item, cartId) {
         // Check if we have a cart ID (either provided or stored)
-        const id = cartId || this.getCartId();
+        const id = cartId || (await this.getCartId());
         // If we don't have a cart ID, create a new cart
         if (!id) {
             return this.createCart({ items: [item] });
@@ -141,20 +144,22 @@ class CartClient extends client_1.StorefrontAPIClient {
      */
     async updateCartItem(cartId, item) {
         // Use provided cartId or stored cartId
-        const id = cartId || this.getCartId();
+        const id = cartId || (await this.getCartId());
         if (!id) {
             throw new Error("Cart ID is required but not provided");
         }
-        const { data, error } = await this.client.POST("/carts/{id}/items", {
-            params: {
-                path: { id },
-            },
-            body: item,
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.POST("/carts/{id}/items", {
+                params: {
+                    path: { id },
+                },
+                body: item,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Get cart details by user ID
@@ -163,15 +168,21 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise with cart details
      */
     async getUserCart(userId) {
-        const { data, error } = await this.client.GET("/carts/users/{user_id}", {
-            params: {
-                path: { user_id: userId },
-            },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.GET("/carts/users/{user_id}", {
+                params: {
+                    path: { user_id: userId },
+                },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            // Store the cart ID if present
+            if (data?.content?.cart?.id) {
+                await this.setCartId(data.content.cart.id);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Delete a cart by user ID
@@ -180,15 +191,19 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise that resolves when the cart is deleted
      */
     async deleteUserCart(userId) {
-        const { error } = await this.client.DELETE("/carts/users/{user_id}", {
-            params: {
-                path: { user_id: userId },
-            },
-            body: undefined,
+        return this.executeRequest(async () => {
+            const { error } = await this.client.DELETE("/carts/users/{user_id}", {
+                params: {
+                    path: { user_id: userId },
+                },
+                body: undefined,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            // Clear the stored cart ID since we deleted the user's cart
+            await this.clearCartId();
         });
-        if (error) {
-            this.handleError(error);
-        }
     }
     /**
      * Update cart addresses
@@ -198,16 +213,18 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise with updated cart
      */
     async updateCartAddress(cartId, addressData) {
-        const { data, error } = await this.client.POST("/carts/{id}/address", {
-            params: {
-                path: { id: cartId },
-            },
-            body: addressData,
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.POST("/carts/{id}/address", {
+                params: {
+                    path: { id: cartId },
+                },
+                body: addressData,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Apply a coupon to the cart
@@ -217,16 +234,18 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise with updated cart
      */
     async applyCoupon(cartId, couponCode) {
-        const { data, error } = await this.client.POST("/carts/{id}/coupon", {
-            params: {
-                path: { id: cartId },
-            },
-            body: { coupon_code: couponCode },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.POST("/carts/{id}/coupon", {
+                params: {
+                    path: { id: cartId },
+                },
+                body: { coupon_code: couponCode },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Remove a coupon from the cart
@@ -235,16 +254,18 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise with updated cart
      */
     async removeCoupon(cartId) {
-        const { data, error } = await this.client.DELETE("/carts/{id}/coupon", {
-            params: {
-                path: { id: cartId },
-            },
-            body: undefined,
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.DELETE("/carts/{id}/coupon", {
+                params: {
+                    path: { id: cartId },
+                },
+                body: undefined,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Redeem loyalty points
@@ -254,16 +275,18 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise with updated cart
      */
     async redeemLoyaltyPoints(cartId, points) {
-        const { data, error } = await this.client.POST("/carts/{id}/loyalty-points", {
-            params: {
-                path: { id: cartId },
-            },
-            body: { loyalty_point_redeemed: points },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.POST("/carts/{id}/loyalty-points", {
+                params: {
+                    path: { id: cartId },
+                },
+                body: { loyalty_point_redeemed: points },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Remove loyalty points
@@ -272,16 +295,18 @@ class CartClient extends client_1.StorefrontAPIClient {
      * @returns Promise with updated cart
      */
     async removeLoyaltyPoints(cartId) {
-        const { data, error } = await this.client.DELETE("/carts/{id}/loyalty-points", {
-            params: {
-                path: { id: cartId },
-            },
-            body: undefined,
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.DELETE("/carts/{id}/loyalty-points", {
+                params: {
+                    path: { id: cartId },
+                },
+                body: undefined,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
 }
 exports.CartClient = CartClient;

package/dist/lib/catalog.js

@@ -31,16 +31,18 @@ class CatalogClient extends client_1.StorefrontAPIClient {
      * @returns Promise with product details
      */
     async getProductDetail(productId, options) {
-        const { data, error } = await this.client.GET("/catalog/products/{product_id}", {
-            params: {
-                path: { product_id: productId },
-                query: options,
-            },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.GET("/catalog/products/{product_id}", {
+                params: {
+                    path: { product_id: productId },
+                    query: options,
+                },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * List variants for a specific product
@@ -50,16 +52,18 @@ class CatalogClient extends client_1.StorefrontAPIClient {
      * @returns Promise with variants
      */
     async listProductVariants(productId, options) {
-        const { data, error } = await this.client.GET("/catalog/products/{product_id}/variants", {
-            params: {
-                path: { product_id: productId },
-                query: options,
-            },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.GET("/catalog/products/{product_id}/variants", {
+                params: {
+                    path: { product_id: productId },
+                    query: options,
+                },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Get details for a specific variant
@@ -70,19 +74,21 @@ class CatalogClient extends client_1.StorefrontAPIClient {
      * @returns Promise with variant details
      */
     async getVariantDetail(productId, variantId, options) {
-        const { data, error } = await this.client.GET("/catalog/products/{product_id}/variants/{variant_id}", {
-            params: {
-                path: {
-                    product_id: productId,
-                    variant_id: variantId,
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.GET("/catalog/products/{product_id}/variants/{variant_id}", {
+                params: {
+                    path: {
+                        product_id: productId,
+                        variant_id: variantId,
+                    },
+                    query: options,
                 },
-                query: options,
-            },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * List all categories
@@ -91,13 +97,15 @@ class CatalogClient extends client_1.StorefrontAPIClient {
      * @returns Promise with categories and pagination info
      */
     async listCategories(options) {
-        const { data, error } = await this.client.GET("/catalog/categories", {
-            params: { query: options },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.GET("/catalog/categories", {
+                params: { query: options },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * List reviews for a specific product
@@ -107,16 +115,18 @@ class CatalogClient extends client_1.StorefrontAPIClient {
      * @returns Promise with reviews and pagination info
      */
     async listProductReviews(productId, options) {
-        const { data, error } = await this.client.GET("/catalog/products/{product_id}/reviews", {
-            params: {
-                path: { product_id: productId },
-                query: options,
-            },
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.GET("/catalog/products/{product_id}/reviews", {
+                params: {
+                    path: { product_id: productId },
+                    query: options,
+                },
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Create a review for a specific product
@@ -128,16 +138,18 @@ class CatalogClient extends client_1.StorefrontAPIClient {
     async createProductReview(productId, reviewData) {
         // Note: In a real implementation, you would need to handle multipart/form-data
         // This would require FormData and may need additional handling
-        const { error } = await this.client.POST("/catalog/products/{product_id}/reviews", {
-            params: {
-                path: { product_id: productId },
-            },
-            body: reviewData,
-            // This is simplified as we're not properly handling multipart/form-data
+        return this.executeRequest(async () => {
+            const { error } = await this.client.POST("/catalog/products/{product_id}/reviews", {
+                params: {
+                    path: { product_id: productId },
+                },
+                body: reviewData,
+                // This is simplified as we're not properly handling multipart/form-data
+            });
+            if (error) {
+                this.handleError(error);
+            }
         });
-        if (error) {
-            this.handleError(error);
-        }
     }
     /**
      * Search for products
@@ -146,13 +158,15 @@ class CatalogClient extends client_1.StorefrontAPIClient {
      * @returns Promise with search results
      */
     async searchProducts(searchData) {
-        const { data, error } = await this.client.POST("/catalog/products/search", {
-            body: searchData,
+        return this.executeRequest(async () => {
+            const { data, error } = await this.client.POST("/catalog/products/search", {
+                body: searchData,
+            });
+            if (error) {
+                this.handleError(error);
+            }
+            return data?.content;
         });
-        if (error) {
-            this.handleError(error);
-        }
-        return data?.content;
     }
     /**
      * Get product details by ID (alternative implementation)

package/dist/lib/client.d.ts

@@ -61,6 +61,7 @@ export declare class StorefrontAPIClient {
     private headers;
     private readonly baseUrl;
     private isRefreshing;
+    private static sharedConfigs;
     /**
      * Create a new StorefrontAPIClient
      *

package/dist/lib/client.js

@@ -44,25 +44,51 @@ class StorefrontAPIClient {
      */
     constructor(config) {
         this.isRefreshing = false;
-        this.config = config;
+        // Use shared config reference for the same storeId to ensure all clients use the same config
+        const storeKey = config.storeId + (config.baseUrl || config.environment || "");
+        if (!StorefrontAPIClient.sharedConfigs.has(storeKey)) {
+            StorefrontAPIClient.sharedConfigs.set(storeKey, { ...config });
+        }
+        // Use the shared config reference
+        this.config = StorefrontAPIClient.sharedConfigs.get(storeKey);
+        // Copy non-shared values from the provided config
+        if (config.token && !this.config.token) {
+            this.config.token = config.token;
+        }
+        if (config.apiKey && !this.config.apiKey) {
+            this.config.apiKey = config.apiKey;
+        }
         this.headers = {
             "Content-Type": "application/json",
         };
-        if (config.token) {
-            this.headers["Authorization"] = `Bearer ${config.token}`;
+        if (this.config.token) {
+            this.headers["Authorization"] = `Bearer ${this.config.token}`;
         }
-        if (config.apiKey) {
-            this.headers["X-Api-Key"] = config.apiKey;
+        if (this.config.apiKey) {
+            this.headers["X-Api-Key"] = this.config.apiKey;
         }
         // Determine base URL from environment or use custom URL if provided
-        this.baseUrl = this.getBaseUrlFromConfig(config);
+        this.baseUrl = this.getBaseUrlFromConfig(this.config);
         this.client = (0, openapi_fetch_1.default)({
             baseUrl: this.baseUrl,
             fetch: (input, init) => {
                 // Add timeout if configured
-                const timeoutSignal = config.timeout
-                    ? AbortSignal.timeout(config.timeout)
+                const timeoutSignal = this.config.timeout
+                    ? AbortSignal.timeout(this.config.timeout)
                     : undefined;
+                // Always check for the most current token and API key before each request
+                if (this.config.token) {
+                    this.headers["Authorization"] = `Bearer ${this.config.token}`;
+                }
+                else {
+                    delete this.headers["Authorization"];
+                }
+                if (this.config.apiKey) {
+                    this.headers["X-Api-Key"] = this.config.apiKey;
+                }
+                else {
+                    delete this.headers["X-Api-Key"];
+                }
                 // Merge headers
                 const headers = {
                     ...this.headers,
@@ -237,3 +263,5 @@ class StorefrontAPIClient {
     }
 }
 exports.StorefrontAPIClient = StorefrontAPIClient;
+// Shared static reference for configs by storeId to ensure all clients use the same config
+StorefrontAPIClient.sharedConfigs = new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercengine/storefront-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript SDK for the Storefront API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",