@commercengine/storefront-sdk 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -57,38 +57,56 @@ export declare class StorefrontSDK {
      * The client storage instance used by this SDK
      */
     private readonly clientStorage;
+    /**
+     * Whether the SDK has been initialized
+     */
+    private isInitialized;
     /**
      * Create a new StorefrontSDK instance
      *
      * @param options - Configuration options for the SDK
      */
     constructor(options: StorefrontSDKOptions);
+    /**
+     * Set up storage with automatic fallback for non-browser environments
+     */
+    private setupStorage;
+    /**
+     * Initialize the SDK
+     * This method should be called before using any SDK features
+     * It ensures tokens are available and valid
+     * @returns Promise that resolves when initialization is complete
+     */
+    init(): Promise<void>;
+    /**
+     * Get the current user ID if available
+     */
+    getUserId(): Promise<string | null>;
     /**
      * Get the current cart ID if one is stored
      *
      * @returns The current cart ID or null if none exists
      */
-    getCartId(): string | null;
+    getCartId(): Promise<string | null>;
     /**
      * Set a specific cart ID to use
      *
      * @param cartId - The cart ID to use
      */
-    setCartId(cartId: string): void;
+    setCartId(cartId: string): Promise<void>;
     /**
      * Clear the current cart ID
      */
-    clearCartId(): void;
+    clearCartId(): Promise<void>;
     /**
      * Set the authentication token for all clients
-     *
-     * @param token - The authentication token
+     * Also stores the token in the configured storage
      */
-    setToken(token: string): void;
+    setToken(token: string): Promise<void>;
     /**
-     * Clear the authentication token from all clients
+     * Clear the authentication token from all clients and storage
      */
-    clearToken(): void;
+    clearToken(): Promise<void>;
     /**
      * Set the API key for all clients
      *

package/dist/index.js

@@ -20,8 +20,12 @@ class StorefrontSDK {
      * @param options - Configuration options for the SDK
      */
     constructor(options) {
-        // Set up client storage
-        this.clientStorage = options.tokenStorage || new auth_1.MemoryTokenStorage();
+        /**
+         * Whether the SDK has been initialized
+         */
+        this.isInitialized = false;
+        // Set up client storage with fallback handling
+        this.clientStorage = this.setupStorage(options.tokenStorage);
         // Convert options to internal config format
         const config = {
             storeId: options.storeId,
@@ -37,45 +41,111 @@ class StorefrontSDK {
         // Set client storage for cart management
         this.cart.setClientStorage(this.clientStorage);
     }
+    /**
+     * Set up storage with automatic fallback for non-browser environments
+     */
+    setupStorage(requestedStorage) {
+        if (!requestedStorage) {
+            return new auth_1.MemoryTokenStorage();
+        }
+        try {
+            // Test if the requested storage is available
+            requestedStorage.getItem("test");
+            // Check if it's a ClientStorage implementation
+            if ("getCartId" in requestedStorage &&
+                "setCartId" in requestedStorage &&
+                "clearCartId" in requestedStorage) {
+                return requestedStorage;
+            }
+            // If it's just a TokenStorage, wrap it in a MemoryTokenStorage for cart functionality
+            console.warn("Provided storage does not implement ClientStorage interface, wrapping with MemoryTokenStorage for cart functionality");
+            return new auth_1.MemoryTokenStorage();
+        }
+        catch (e) {
+            // If storage access fails, fallback to memory storage
+            console.warn("Requested storage is not available in this environment, falling back to memory storage");
+            return new auth_1.MemoryTokenStorage();
+        }
+    }
+    /**
+     * Initialize the SDK
+     * This method should be called before using any SDK features
+     * It ensures tokens are available and valid
+     * @returns Promise that resolves when initialization is complete
+     */
+    async init() {
+        if (this.isInitialized) {
+            return;
+        }
+        try {
+            // Try to get existing tokens from storage
+            const accessToken = await this.clientStorage.getItem("access_token");
+            const userData = await this.clientStorage.getItem("user_data");
+            if (accessToken && userData) {
+                // Set the token for all clients
+                await this.setToken(accessToken);
+            }
+            else {
+                // If no token exists or no user data, get a new anonymous token
+                const authResponse = await this.auth.getAnonymousToken();
+                await this.setToken(authResponse.access_token);
+                // Store user data
+                await this.clientStorage.setItem("user_data", JSON.stringify(authResponse.user));
+            }
+            this.isInitialized = true;
+        }
+        catch (error) {
+            console.error("Failed to initialize SDK:", error);
+            throw error;
+        }
+    }
+    /**
+     * Get the current user ID if available
+     */
+    async getUserId() {
+        return this.clientStorage.getItem("user_id");
+    }
     /**
      * Get the current cart ID if one is stored
      *
      * @returns The current cart ID or null if none exists
      */
-    getCartId() {
-        return this.cart.getCartId();
+    async getCartId() {
+        return this.clientStorage.getCartId();
     }
     /**
      * Set a specific cart ID to use
      *
      * @param cartId - The cart ID to use
      */
-    setCartId(cartId) {
-        this.cart.setCartId(cartId);
+    async setCartId(cartId) {
+        await this.clientStorage.setCartId(cartId);
     }
     /**
      * Clear the current cart ID
      */
-    clearCartId() {
-        this.cart.clearCartId();
+    async clearCartId() {
+        await this.clientStorage.clearCartId();
     }
     /**
      * Set the authentication token for all clients
-     *
-     * @param token - The authentication token
+     * Also stores the token in the configured storage
      */
-    setToken(token) {
+    async setToken(token) {
         this.catalog.setToken(token);
         this.cart.setToken(token);
         this.auth.setToken(token);
+        await this.clientStorage.setItem("access_token", token);
     }
     /**
-     * Clear the authentication token from all clients
+     * Clear the authentication token from all clients and storage
      */
-    clearToken() {
+    async clearToken() {
         this.catalog.clearToken();
         this.cart.clearToken();
         this.auth.clearToken();
+        await this.clientStorage.removeItem("access_token");
+        await this.clientStorage.removeItem("refresh_token");
     }
     /**
      * Set the API key for all clients

package/dist/lib/auth.d.ts

@@ -4,28 +4,34 @@ import type { components } from "../types/storefront";
  * Client for interacting with authentication endpoints
  */
 export declare class AuthClient extends StorefrontAPIClient {
-    private tokenStorage;
+    private readonly tokenStorage;
     private autoRefreshTimer;
-    constructor(config: StorefrontAPIConfig, tokenStorage?: TokenStorage);
-    setToken(token: string): void;
-    protected setRefreshToken(token: string): void;
-    clearToken(): void;
+    constructor(config: StorefrontAPIConfig, tokenStorage: TokenStorage);
+    setToken(token: string): Promise<void>;
+    protected setRefreshToken(token: string): Promise<void>;
+    clearToken(): Promise<void>;
     private setupAutoRefresh;
     private clearAutoRefresh;
     private handleTokenRefresh;
     private getTokenExpiry;
     /**
-     * Get an anonymous user token
-     *
-     * @param options - Options for anonymous authentication
-     * @returns Promise with user info and tokens
+     * Store auth data including tokens and user info
+     */
+    private storeAuthData;
+    /**
+     * Get stored user data
+     * @returns Promise that resolves to the stored user data or null if none exists
+     */
+    getStoredUser(): Promise<components["schemas"]["User"] | components["schemas"]["AnonymousUser"] | null>;
+    /**
+     * Get anonymous token for guest users
      */
     getAnonymousToken(options?: {
         apiKey?: string;
     }): Promise<{
-        user: components["schemas"]["AnonymousUser"];
         access_token: string;
         refresh_token: string;
+        user: components["schemas"]["AnonymousUser"];
     }>;
     /**
      * Login with phone number
@@ -53,18 +59,16 @@ export declare class AuthClient extends StorefrontAPIClient {
     /**
      * Login with password
      *
-     * @param options - Login credentials
+     * @param credentials - Login credentials
      * @returns Promise with user info and tokens
      */
-    loginWithPassword(options: {
-        email?: string;
-        phone?: string;
-        country_code?: string;
+    loginWithPassword(credentials: {
+        email: string;
         password: string;
     }): Promise<{
-        user: components["schemas"]["User"];
         access_token: string;
         refresh_token: string;
+        user: components["schemas"]["User"];
     }>;
     /**
      * Verify OTP
@@ -115,10 +119,7 @@ export declare class AuthClient extends StorefrontAPIClient {
         refresh_token: string;
     }>;
     /**
-     * Refresh token
-     *
-     * @param refreshToken - Refresh token
-     * @returns Promise with new tokens
+     * Refresh the access token using a refresh token
      */
     refreshToken(refreshToken: string): Promise<{
         access_token: string;
@@ -148,19 +149,21 @@ export declare class AuthClient extends StorefrontAPIClient {
     executeWithTokenRefresh<T>(requestFn: () => Promise<T>): Promise<T>;
 }
 /**
- * Interface for client storage implementations (tokens and cart ID)
+ * Interface for token storage implementations
  */
-export interface ClientStorage {
-    getAccessToken(): string | null;
-    setAccessToken(token: string): void;
-    getRefreshToken(): string | null;
-    setRefreshToken(token: string): void;
-    clearTokens(): void;
-    getCartId(): string | null;
-    setCartId(cartId: string): void;
-    clearCartId(): void;
+export interface TokenStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * Interface for client storage implementations
+ */
+export interface ClientStorage extends TokenStorage {
+    getCartId(): Promise<string | null>;
+    setCartId(cartId: string): Promise<void>;
+    clearCartId(): Promise<void>;
 }
-export type TokenStorage = ClientStorage;
 /**
  * Default in-memory implementation of client storage
  */
@@ -168,14 +171,13 @@ export declare class MemoryTokenStorage implements ClientStorage {
     private accessToken;
     private refreshToken;
     private cartId;
-    getAccessToken(): string | null;
-    setAccessToken(token: string): void;
-    getRefreshToken(): string | null;
-    setRefreshToken(token: string): void;
-    clearTokens(): void;
-    getCartId(): string | null;
-    setCartId(cartId: string): void;
-    clearCartId(): void;
+    private userData;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    getCartId(): Promise<string | null>;
+    setCartId(cartId: string): Promise<void>;
+    clearCartId(): Promise<void>;
 }
 /**
  * Browser storage implementation using localStorage
@@ -184,15 +186,14 @@ export declare class BrowserTokenStorage implements ClientStorage {
     private accessTokenKey;
     private refreshTokenKey;
     private cartIdKey;
+    private userDataKey;
     constructor(prefix?: string);
-    getAccessToken(): string | null;
-    setAccessToken(token: string): void;
-    getRefreshToken(): string | null;
-    setRefreshToken(token: string): void;
-    clearTokens(): void;
-    getCartId(): string | null;
-    setCartId(cartId: string): void;
-    clearCartId(): void;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    getCartId(): Promise<string | null>;
+    setCartId(cartId: string): Promise<void>;
+    clearCartId(): Promise<void>;
 }
 /**
  * Cookie-based token storage for browser or server environments
@@ -201,6 +202,7 @@ export declare class CookieTokenStorage implements ClientStorage {
     private accessTokenKey;
     private refreshTokenKey;
     private cartIdKey;
+    private userDataKey;
     private cookieOptions;
     constructor(prefix?: string, cookieOptions?: {
         path: string;
@@ -210,43 +212,31 @@ export declare class CookieTokenStorage implements ClientStorage {
         maxAge: number;
     });
     /**
-     * Get access token from cookies
-     * Works in both browser and Next.js server components
-     */
-    getAccessToken(): string | null;
-    /**
-     * Set access token in cookies
-     * Works in browser environment
-     */
-    setAccessToken(token: string): void;
-    /**
-     * Get refresh token from cookies
+     * Get value from cookies
      * Works in both browser and Next.js server components
      */
-    getRefreshToken(): string | null;
+    getItem(key: string): Promise<string | null>;
     /**
-     * Set refresh token in cookies
+     * Set value in cookies
      * Works in browser environment
      */
-    setRefreshToken(token: string): void;
+    setItem(key: string, value: string): Promise<void>;
     /**
-     * Clear all tokens from cookies
+     * Remove value from cookies
      */
-    clearTokens(): void;
+    removeItem(key: string): Promise<void>;
     /**
      * Get cart ID from cookies
-     * Works in both browser and Next.js server components
      */
-    getCartId(): string | null;
+    getCartId(): Promise<string | null>;
     /**
      * Set cart ID in cookies
-     * Works in browser environment
      */
-    setCartId(cartId: string): void;
+    setCartId(cartId: string): Promise<void>;
     /**
      * Clear cart ID from cookies
      */
-    clearCartId(): void;
+    clearCartId(): Promise<void>;
 }
 /**
  * Next.js specific cookie storage implementation
@@ -256,40 +246,24 @@ export declare class NextCookieTokenStorage implements ClientStorage {
     private accessTokenKey;
     private refreshTokenKey;
     private cartIdKey;
+    private userDataKey;
     private cookieStore;
     constructor(cookieStore: any, prefix?: string);
-    /**
-     * Get access token from Next.js cookies
-     */
-    getAccessToken(): string | null;
-    /**
-     * Set access token in Next.js cookies
-     */
-    setAccessToken(token: string): void;
-    /**
-     * Get refresh token from Next.js cookies
-     */
-    getRefreshToken(): string | null;
-    /**
-     * Set refresh token in Next.js cookies
-     */
-    setRefreshToken(token: string): void;
-    /**
-     * Clear all tokens from Next.js cookies
-     */
-    clearTokens(): void;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
     /**
      * Get cart ID from Next.js cookies
      */
-    getCartId(): string | null;
+    getCartId(): Promise<string | null>;
     /**
      * Set cart ID in Next.js cookies
      */
-    setCartId(cartId: string): void;
+    setCartId(cartId: string): Promise<void>;
     /**
      * Clear cart ID from Next.js cookies
      */
-    clearCartId(): void;
+    clearCartId(): Promise<void>;
 }
 /**
  * Helper to create a token storage instance based on environment