@commercengine/storefront-sdk-nextjs 0.1.0-alpha.1 → 0.1.0

package/dist/client.d.cts

@@ -1,138 +1,17 @@
-import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-export * from '@commercengine/storefront-sdk';
-export { StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-
-/**
- * Configuration options for NextJSTokenStorage
- */
-interface NextJSTokenStorageOptions {
-    /**
-     * Prefix for cookie names (default: "ce_")
-     */
-    prefix?: string;
-    /**
-     * Maximum age of cookies in seconds (default: 30 days)
-     */
-    maxAge?: number;
-    /**
-     * Cookie path (default: "/")
-     */
-    path?: string;
-    /**
-     * Cookie domain (default: current domain)
-     */
-    domain?: string;
-    /**
-     * Whether cookies should be secure (default: auto-detect based on environment)
-     */
-    secure?: boolean;
-    /**
-     * SameSite cookie attribute (default: "Lax")
-     */
-    sameSite?: "Strict" | "Lax" | "None";
-}
-/**
- * Client-side token storage that uses document.cookie
- */
-declare class ClientTokenStorage implements TokenStorage {
-    private accessTokenKey;
-    private refreshTokenKey;
-    private options;
-    constructor(options?: NextJSTokenStorageOptions);
-    getAccessToken(): Promise<string | null>;
-    setAccessToken(token: string): Promise<void>;
-    getRefreshToken(): Promise<string | null>;
-    setRefreshToken(token: string): Promise<void>;
-    clearTokens(): Promise<void>;
-    private getCookie;
-    private setCookie;
-    private deleteCookie;
-}
-
-/**
- * Configuration for the NextJS SDK wrapper
- */
-interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
-    /**
-     * Token storage configuration options
-     */
-    tokenStorageOptions?: NextJSTokenStorageOptions;
-}
-type NextCookieStore$1 = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Smart SDK getter that automatically detects environment
- *
- * Usage:
- * - Client-side: getStorefrontSDK()
- * - Server-side with request context: getStorefrontSDK(await cookies())
- * - SSG/ISR (no request context): getStorefrontSDK() (uses memory storage)
- */
-declare function getStorefrontSDK(): StorefrontSDK;
-declare function getStorefrontSDK(cookieStore: NextCookieStore$1): StorefrontSDK;
-/**
- * Initialize the SDK with configuration (internal use)
- * This should be called once in your app via StorefrontSDKInitializer
- */
-declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
-
-/**
- * Universal storefront SDK export
- *
- * This provides a simple unified interface that works in all Next.js contexts:
- * - Client components: automatically uses client token storage
- * - Server components: requires cookies() to be passed
- * - SSG/ISR: automatically uses memory storage with optional build caching
- *
- * Usage:
- * ```typescript
- * // Client-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * const products = await storefront().catalog.listProducts()
- *
- * // Server-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * import { cookies } from 'next/headers'
- * const products = await storefront(cookies()).catalog.listProducts()
- * ```
- */
-
-type NextCookieStore = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Universal storefront SDK accessor
- *
- * @param cookieStore - Next.js cookie store (required on server-side)
- * @returns StorefrontSDK instance configured for the current environment
- */
-declare function storefront(): StorefrontSDK;
-declare function storefront(cookieStore: NextCookieStore): StorefrontSDK;
+import { ClientTokenStorage, NextJSSDKConfig, NextJSTokenStorageOptions, StorefrontRuntimeConfig, getStorefrontSDK, initializeStorefrontSDK } from "./sdk-manager-D2ktqPrp.cjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKOptions, TokenStorage } from "@commercengine/storefront-sdk";
 
+//#region src/init-client.d.ts
 interface StorefrontSDKInitializerProps {
-    config: NextJSSDKConfig;
+  /**
+   * Optional runtime configuration overrides for client-side API calls
+   * These settings will apply to all client-side storefront() calls
+   */
+  runtimeConfig?: StorefrontRuntimeConfig;
 }
-/**
- * Client-side initialization component
- * Use this in your root layout to initialize the SDK once
- *
- * The core SDK middleware now automatically handles everything:
- * - Creates anonymous tokens automatically on first API request (if no tokens exist)
- * - Token state assessment and cleanup on first request per page load
- * - Expired token refresh with automatic anonymous fallback
- * - Graceful handling of partial token states
- *
- * No manual token creation needed - just make API calls and everything works!
- */
-declare function StorefrontSDKInitializer({ config, }: StorefrontSDKInitializerProps): null;
-
-export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK, storefront };
+declare function StorefrontSDKInitializer({
+  runtimeConfig
+}?: StorefrontSDKInitializerProps): null;
+//#endregion
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, type StorefrontSDKOptions, type TokenStorage, getStorefrontSDK, initializeStorefrontSDK };
+//# sourceMappingURL=client.d.cts.map

package/dist/client.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.cts","names":[],"sources":["../src/init-client.ts"],"sourcesContent":[],"mappings":";;;;UAuCU,6BAAA;;;AAhCa;AAwCvB;EAAwC,aAAA,CAAA,EAHtB,uBAGsB;;AAAoB,iBAA5C,wBAAA,CAA4C;EAAA;AAAA,CAAA,CAAA,EAAA,6BAAA,CAAA,EAAA,IAAA"}

package/dist/client.d.ts

@@ -1,138 +1,17 @@
-import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-export * from '@commercengine/storefront-sdk';
-export { StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-
-/**
- * Configuration options for NextJSTokenStorage
- */
-interface NextJSTokenStorageOptions {
-    /**
-     * Prefix for cookie names (default: "ce_")
-     */
-    prefix?: string;
-    /**
-     * Maximum age of cookies in seconds (default: 30 days)
-     */
-    maxAge?: number;
-    /**
-     * Cookie path (default: "/")
-     */
-    path?: string;
-    /**
-     * Cookie domain (default: current domain)
-     */
-    domain?: string;
-    /**
-     * Whether cookies should be secure (default: auto-detect based on environment)
-     */
-    secure?: boolean;
-    /**
-     * SameSite cookie attribute (default: "Lax")
-     */
-    sameSite?: "Strict" | "Lax" | "None";
-}
-/**
- * Client-side token storage that uses document.cookie
- */
-declare class ClientTokenStorage implements TokenStorage {
-    private accessTokenKey;
-    private refreshTokenKey;
-    private options;
-    constructor(options?: NextJSTokenStorageOptions);
-    getAccessToken(): Promise<string | null>;
-    setAccessToken(token: string): Promise<void>;
-    getRefreshToken(): Promise<string | null>;
-    setRefreshToken(token: string): Promise<void>;
-    clearTokens(): Promise<void>;
-    private getCookie;
-    private setCookie;
-    private deleteCookie;
-}
-
-/**
- * Configuration for the NextJS SDK wrapper
- */
-interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
-    /**
-     * Token storage configuration options
-     */
-    tokenStorageOptions?: NextJSTokenStorageOptions;
-}
-type NextCookieStore$1 = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Smart SDK getter that automatically detects environment
- *
- * Usage:
- * - Client-side: getStorefrontSDK()
- * - Server-side with request context: getStorefrontSDK(await cookies())
- * - SSG/ISR (no request context): getStorefrontSDK() (uses memory storage)
- */
-declare function getStorefrontSDK(): StorefrontSDK;
-declare function getStorefrontSDK(cookieStore: NextCookieStore$1): StorefrontSDK;
-/**
- * Initialize the SDK with configuration (internal use)
- * This should be called once in your app via StorefrontSDKInitializer
- */
-declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
-
-/**
- * Universal storefront SDK export
- *
- * This provides a simple unified interface that works in all Next.js contexts:
- * - Client components: automatically uses client token storage
- * - Server components: requires cookies() to be passed
- * - SSG/ISR: automatically uses memory storage with optional build caching
- *
- * Usage:
- * ```typescript
- * // Client-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * const products = await storefront().catalog.listProducts()
- *
- * // Server-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * import { cookies } from 'next/headers'
- * const products = await storefront(cookies()).catalog.listProducts()
- * ```
- */
-
-type NextCookieStore = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Universal storefront SDK accessor
- *
- * @param cookieStore - Next.js cookie store (required on server-side)
- * @returns StorefrontSDK instance configured for the current environment
- */
-declare function storefront(): StorefrontSDK;
-declare function storefront(cookieStore: NextCookieStore): StorefrontSDK;
+import { ClientTokenStorage, NextJSSDKConfig, NextJSTokenStorageOptions, StorefrontRuntimeConfig, getStorefrontSDK, initializeStorefrontSDK } from "./sdk-manager-B9xDQQuv.js";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKOptions, TokenStorage } from "@commercengine/storefront-sdk";
 
+//#region src/init-client.d.ts
 interface StorefrontSDKInitializerProps {
-    config: NextJSSDKConfig;
+  /**
+   * Optional runtime configuration overrides for client-side API calls
+   * These settings will apply to all client-side storefront() calls
+   */
+  runtimeConfig?: StorefrontRuntimeConfig;
 }
-/**
- * Client-side initialization component
- * Use this in your root layout to initialize the SDK once
- *
- * The core SDK middleware now automatically handles everything:
- * - Creates anonymous tokens automatically on first API request (if no tokens exist)
- * - Token state assessment and cleanup on first request per page load
- * - Expired token refresh with automatic anonymous fallback
- * - Graceful handling of partial token states
- *
- * No manual token creation needed - just make API calls and everything works!
- */
-declare function StorefrontSDKInitializer({ config, }: StorefrontSDKInitializerProps): null;
-
-export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK, storefront };
+declare function StorefrontSDKInitializer({
+  runtimeConfig
+}?: StorefrontSDKInitializerProps): null;
+//#endregion
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, type StorefrontSDKOptions, type TokenStorage, getStorefrontSDK, initializeStorefrontSDK };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/init-client.ts"],"sourcesContent":[],"mappings":";;;;UAuCU,6BAAA;;;AAhCa;AAwCvB;EAAwC,aAAA,CAAA,EAHtB,uBAGsB;;AAAoB,iBAA5C,wBAAA,CAA4C;EAAA;AAAA,CAAA,CAAA,EAAA,6BAAA,CAAA,EAAA,IAAA"}