@commercengine/storefront-sdk 0.2.1 → 0.3.1

package/dist/index.d.ts

@@ -1,7 +1,13 @@
 import { StorefrontAPIClient, Environment } from "./lib/client";
 import { CatalogClient } from "./lib/catalog";
 import { CartClient } from "./lib/cart";
-import { AuthClient, TokenStorage } from "./lib/auth";
+import { AuthClient } from "./lib/auth";
+import { OrderClient } from "./lib/order";
+import { ShippingClient } from "./lib/shipping";
+import { HelpersClient } from "./lib/helper";
+import { CustomerClient } from "./lib/customer";
+import { TokenStorage, MemoryTokenStorage, BrowserTokenStorage, createDefaultAuthMiddleware, createAuthMiddleware, type AuthMiddlewareConfig } from "./lib/middleware";
+import { type UserInfo } from "./lib/jwt-utils";
 /**
  * SDK initialization options
  */
@@ -19,7 +25,7 @@ export interface StorefrontSDKOptions {
      */
     baseUrl?: string;
     /**
-     * Optional authentication token
+     * Optional authentication token (for manual token management)
      */
     token?: string;
     /**
@@ -32,10 +38,18 @@ export interface StorefrontSDKOptions {
      */
     timeout?: number;
     /**
-     * Optional token storage strategy
-     * Defaults to MemoryTokenStorage if not provided
+     * Optional token storage for automatic token management
+     * If provided, enables automatic token refresh and management
      */
     tokenStorage?: TokenStorage;
+    /**
+     * Callback when tokens are updated (login/refresh)
+     */
+    onTokensUpdated?: (accessToken: string, refreshToken: string) => void;
+    /**
+     * Callback when tokens are cleared (logout/error)
+     */
+    onTokensCleared?: () => void;
 }
 /**
  * Main SDK class for the Storefront API
@@ -54,41 +68,35 @@ export declare class StorefrontSDK {
      */
     readonly auth: AuthClient;
     /**
-     * The client storage instance used by this SDK
+     * Client for customer-related endpoints
      */
-    private readonly clientStorage;
+    readonly customer: CustomerClient;
     /**
-     * Create a new StorefrontSDK instance
-     *
-     * @param options - Configuration options for the SDK
+     * Client for helper-related endpoints
      */
-    constructor(options: StorefrontSDKOptions);
+    readonly helpers: HelpersClient;
     /**
-     * Get the current cart ID if one is stored
-     *
-     * @returns The current cart ID or null if none exists
+     * Client for shipping-related endpoints
      */
-    getCartId(): string | null;
+    readonly shipping: ShippingClient;
     /**
-     * Set a specific cart ID to use
-     *
-     * @param cartId - The cart ID to use
+     * Client for order-related endpoints
      */
-    setCartId(cartId: string): void;
+    readonly order: OrderClient;
     /**
-     * Clear the current cart ID
+     * Create a new StorefrontSDK instance
+     *
+     * @param options - Configuration options for the SDK
      */
-    clearCartId(): void;
+    constructor(options: StorefrontSDKOptions);
     /**
      * Set the authentication token for all clients
-     *
-     * @param token - The authentication token
      */
-    setToken(token: string): void;
+    setToken(token: string): Promise<void>;
     /**
      * Clear the authentication token from all clients
      */
-    clearToken(): void;
+    clearToken(): Promise<void>;
     /**
      * Set the API key for all clients
      *
@@ -99,9 +107,51 @@ export declare class StorefrontSDK {
      * Clear the API key from all clients
      */
     clearApiKey(): void;
+    /**
+     * Get the current access token if using token storage
+     */
+    getAccessToken(): Promise<string | null>;
+    /**
+     * Get user information from the current access token
+     *
+     * @returns User information extracted from JWT token, or null if no token or invalid token
+     */
+    getUserInfo(): Promise<UserInfo | null>;
+    /**
+     * Get the current user ID from the access token
+     *
+     * @returns User ID (ulid) or null if no token or invalid token
+     */
+    getUserId(): Promise<string | null>;
+    /**
+     * Check if the current user is logged in (not anonymous)
+     *
+     * @returns True if user is logged in, false if anonymous or no token
+     */
+    isLoggedIn(): Promise<boolean>;
+    /**
+     * Check if the current user is anonymous
+     *
+     * @returns True if user is anonymous or no token, false if logged in
+     */
+    isAnonymous(): Promise<boolean>;
+    /**
+     * Get the customer ID from the current access token
+     *
+     * @returns Customer ID or null if no token, invalid token, or user has no customer ID
+     */
+    getCustomerId(): Promise<string | null>;
+    /**
+     * Get the customer group ID from the current access token
+     *
+     * @returns Customer group ID or null if no token, invalid token, or user has no customer group
+     */
+    getCustomerGroupId(): Promise<string | null>;
 }
 export default StorefrontSDK;
-export { StorefrontAPIClient, CatalogClient, CartClient, AuthClient };
+export { StorefrontAPIClient, AuthClient, CartClient, CatalogClient, CustomerClient, HelpersClient, ShippingClient, OrderClient };
 export { Environment };
-export { TokenStorage, MemoryTokenStorage, BrowserTokenStorage, CookieTokenStorage, NextCookieTokenStorage, createTokenStorage, } from "./lib/auth";
+export { TokenStorage, MemoryTokenStorage, BrowserTokenStorage, createDefaultAuthMiddleware, createAuthMiddleware, type AuthMiddlewareConfig };
+export { extractUserInfoFromToken, getUserIdFromToken, isUserLoggedIn, isUserAnonymous, isTokenExpired, type UserInfo, type JwtPayload } from "./lib/jwt-utils";
 export type { components, operations, paths } from "./types/storefront";
+export type * from "./types/storefront-api-types";

package/dist/index.js

@@ -1,27 +1,51 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTokenStorage = exports.NextCookieTokenStorage = exports.CookieTokenStorage = exports.BrowserTokenStorage = exports.MemoryTokenStorage = exports.Environment = exports.AuthClient = exports.CartClient = exports.CatalogClient = exports.StorefrontAPIClient = exports.StorefrontSDK = void 0;
-const client_1 = require("./lib/client");
-Object.defineProperty(exports, "StorefrontAPIClient", { enumerable: true, get: function () { return client_1.StorefrontAPIClient; } });
-Object.defineProperty(exports, "Environment", { enumerable: true, get: function () { return client_1.Environment; } });
-const catalog_1 = require("./lib/catalog");
-Object.defineProperty(exports, "CatalogClient", { enumerable: true, get: function () { return catalog_1.CatalogClient; } });
-const cart_1 = require("./lib/cart");
-Object.defineProperty(exports, "CartClient", { enumerable: true, get: function () { return cart_1.CartClient; } });
-const auth_1 = require("./lib/auth");
-Object.defineProperty(exports, "AuthClient", { enumerable: true, get: function () { return auth_1.AuthClient; } });
+import { StorefrontAPIClient, Environment, } from "./lib/client";
+import { CatalogClient } from "./lib/catalog";
+import { CartClient } from "./lib/cart";
+import { AuthClient } from "./lib/auth";
+import { OrderClient } from "./lib/order";
+import { ShippingClient } from "./lib/shipping";
+import { HelpersClient } from "./lib/helper";
+import { CustomerClient } from "./lib/customer";
+import { MemoryTokenStorage, BrowserTokenStorage, createDefaultAuthMiddleware, createAuthMiddleware } from "./lib/middleware";
+import { extractUserInfoFromToken, getUserIdFromToken, isUserLoggedIn, isUserAnonymous } from "./lib/jwt-utils";
 /**
  * Main SDK class for the Storefront API
  */
-class StorefrontSDK {
+export class StorefrontSDK {
+    /**
+     * Client for catalog-related endpoints (products, categories, etc.)
+     */
+    catalog;
+    /**
+     * Client for cart-related endpoints
+     */
+    cart;
+    /**
+     * Client for authentication-related endpoints
+     */
+    auth;
+    /**
+     * Client for customer-related endpoints
+     */
+    customer;
+    /**
+     * Client for helper-related endpoints
+     */
+    helpers;
+    /**
+     * Client for shipping-related endpoints
+     */
+    shipping;
+    /**
+     * Client for order-related endpoints
+     */
+    order;
     /**
      * Create a new StorefrontSDK instance
      *
      * @param options - Configuration options for the SDK
      */
     constructor(options) {
-        // Set up client storage
-        this.clientStorage = options.tokenStorage || new auth_1.MemoryTokenStorage();
         // Convert options to internal config format
         const config = {
             storeId: options.storeId,
@@ -30,52 +54,41 @@ class StorefrontSDK {
             token: options.token,
             apiKey: options.apiKey,
             timeout: options.timeout,
+            tokenStorage: options.tokenStorage,
+            onTokensUpdated: options.onTokensUpdated,
+            onTokensCleared: options.onTokensCleared,
         };
-        this.catalog = new catalog_1.CatalogClient(config);
-        this.cart = new cart_1.CartClient(config);
-        this.auth = new auth_1.AuthClient(config, this.clientStorage);
-        // Set client storage for cart management
-        this.cart.setClientStorage(this.clientStorage);
-    }
-    /**
-     * Get the current cart ID if one is stored
-     *
-     * @returns The current cart ID or null if none exists
-     */
-    getCartId() {
-        return this.cart.getCartId();
-    }
-    /**
-     * Set a specific cart ID to use
-     *
-     * @param cartId - The cart ID to use
-     */
-    setCartId(cartId) {
-        this.cart.setCartId(cartId);
-    }
-    /**
-     * Clear the current cart ID
-     */
-    clearCartId() {
-        this.cart.clearCartId();
+        this.catalog = new CatalogClient(config);
+        this.cart = new CartClient(config);
+        this.auth = new AuthClient(config);
+        this.customer = new CustomerClient(config);
+        this.helpers = new HelpersClient(config);
+        this.shipping = new ShippingClient(config);
+        this.order = new OrderClient(config);
     }
     /**
      * Set the authentication token for all clients
-     *
-     * @param token - The authentication token
      */
-    setToken(token) {
-        this.catalog.setToken(token);
-        this.cart.setToken(token);
-        this.auth.setToken(token);
+    async setToken(token) {
+        await this.catalog.setToken(token);
+        await this.cart.setToken(token);
+        await this.auth.setToken(token);
+        await this.customer.setToken(token);
+        await this.helpers.setToken(token);
+        await this.shipping.setToken(token);
+        await this.order.setToken(token);
     }
     /**
      * Clear the authentication token from all clients
      */
-    clearToken() {
-        this.catalog.clearToken();
-        this.cart.clearToken();
-        this.auth.clearToken();
+    async clearToken() {
+        await this.catalog.clearToken();
+        await this.cart.clearToken();
+        await this.auth.clearToken();
+        await this.customer.clearToken();
+        await this.helpers.clearToken();
+        await this.shipping.clearToken();
+        await this.order.clearToken();
     }
     /**
      * Set the API key for all clients
@@ -86,6 +99,10 @@ class StorefrontSDK {
         this.catalog.setApiKey(apiKey);
         this.cart.setApiKey(apiKey);
         this.auth.setApiKey(apiKey);
+        this.customer.setApiKey(apiKey);
+        this.helpers.setApiKey(apiKey);
+        this.shipping.setApiKey(apiKey);
+        this.order.setApiKey(apiKey);
     }
     /**
      * Clear the API key from all clients
@@ -94,15 +111,87 @@ class StorefrontSDK {
         this.catalog.clearApiKey();
         this.cart.clearApiKey();
         this.auth.clearApiKey();
+        this.customer.clearApiKey();
+        this.helpers.clearApiKey();
+        this.shipping.clearApiKey();
+        this.order.clearApiKey();
+    }
+    /**
+     * Get the current access token if using token storage
+     */
+    async getAccessToken() {
+        return await this.auth.getAuthorizationHeader().then(header => header.startsWith('Bearer ') ? header.substring(7) : null);
+    }
+    /**
+     * Get user information from the current access token
+     *
+     * @returns User information extracted from JWT token, or null if no token or invalid token
+     */
+    async getUserInfo() {
+        const token = await this.getAccessToken();
+        if (!token)
+            return null;
+        return extractUserInfoFromToken(token);
+    }
+    /**
+     * Get the current user ID from the access token
+     *
+     * @returns User ID (ulid) or null if no token or invalid token
+     */
+    async getUserId() {
+        const token = await this.getAccessToken();
+        if (!token)
+            return null;
+        return getUserIdFromToken(token);
+    }
+    /**
+     * Check if the current user is logged in (not anonymous)
+     *
+     * @returns True if user is logged in, false if anonymous or no token
+     */
+    async isLoggedIn() {
+        const token = await this.getAccessToken();
+        if (!token)
+            return false;
+        return isUserLoggedIn(token);
+    }
+    /**
+     * Check if the current user is anonymous
+     *
+     * @returns True if user is anonymous or no token, false if logged in
+     */
+    async isAnonymous() {
+        const token = await this.getAccessToken();
+        if (!token)
+            return true;
+        return isUserAnonymous(token);
+    }
+    /**
+     * Get the customer ID from the current access token
+     *
+     * @returns Customer ID or null if no token, invalid token, or user has no customer ID
+     */
+    async getCustomerId() {
+        const userInfo = await this.getUserInfo();
+        return userInfo?.customerId || null;
+    }
+    /**
+     * Get the customer group ID from the current access token
+     *
+     * @returns Customer group ID or null if no token, invalid token, or user has no customer group
+     */
+    async getCustomerGroupId() {
+        const userInfo = await this.getUserInfo();
+        return userInfo?.customerGroupId || null;
     }
 }
-exports.StorefrontSDK = StorefrontSDK;
 // Export the main SDK class
-exports.default = StorefrontSDK;
-// Export token storage types
-var auth_2 = require("./lib/auth");
-Object.defineProperty(exports, "MemoryTokenStorage", { enumerable: true, get: function () { return auth_2.MemoryTokenStorage; } });
-Object.defineProperty(exports, "BrowserTokenStorage", { enumerable: true, get: function () { return auth_2.BrowserTokenStorage; } });
-Object.defineProperty(exports, "CookieTokenStorage", { enumerable: true, get: function () { return auth_2.CookieTokenStorage; } });
-Object.defineProperty(exports, "NextCookieTokenStorage", { enumerable: true, get: function () { return auth_2.NextCookieTokenStorage; } });
-Object.defineProperty(exports, "createTokenStorage", { enumerable: true, get: function () { return auth_2.createTokenStorage; } });
+export default StorefrontSDK;
+// Export individual clients for advanced usage
+export { StorefrontAPIClient, AuthClient, CartClient, CatalogClient, CustomerClient, HelpersClient, ShippingClient, OrderClient };
+// Export environment enum
+export { Environment };
+// Export token storage types and middleware
+export { MemoryTokenStorage, BrowserTokenStorage, createDefaultAuthMiddleware, createAuthMiddleware };
+// Export JWT utilities
+export { extractUserInfoFromToken, getUserIdFromToken, isUserLoggedIn, isUserAnonymous, isTokenExpired } from "./lib/jwt-utils";