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

package/dist/index.d.ts

@@ -1,116 +1,43 @@
-import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-export { Environment, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
+import { StorefrontRuntimeConfig } from "./sdk-manager-B9xDQQuv.js";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDK as StorefrontSDK$1 } from "@commercengine/storefront-sdk";
+export * 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;
-}
-type NextCookieStore$1 = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Server-side token storage that uses Next.js cookies API
- */
-declare class ServerTokenStorage implements TokenStorage {
-    private accessTokenKey;
-    private refreshTokenKey;
-    private options;
-    private cookieStore;
-    constructor(cookieStore: NextCookieStore$1, options?: NextJSTokenStorageOptions);
-    getAccessToken(): Promise<string | null>;
-    setAccessToken(token: string): Promise<void>;
-    getRefreshToken(): Promise<string | null>;
-    setRefreshToken(token: string): Promise<void>;
-    clearTokens(): Promise<void>;
-}
-
-/**
- * Configuration for the NextJS SDK wrapper
- */
-interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
-    /**
-     * Token storage configuration options
-     */
-    tokenStorageOptions?: NextJSTokenStorageOptions;
-}
+//#region src/create-storefront.d.ts
 type NextCookieStore = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
+  get: (name: string) => {
+    name: string;
+    value: string;
+  } | undefined;
+  set: (name: string, value: string, opts?: Record<string, unknown>) => void;
+  delete: (name: string) => void;
 };
 /**
- * Smart SDK getter that automatically detects environment
+ * Creates a configured storefront function that works universally across all Next.js contexts
  *
  * Usage:
- * - Client-side: getStorefrontSDK()
- * - Server-side: getStorefrontSDK(await cookies())
- */
-declare function getStorefrontSDK(): StorefrontSDK;
-declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
-
-interface StorefrontSDKInitializerProps {
-    config: NextJSSDKConfig;
-}
-/**
- * Client-side initialization component
- * Use this in your root layout to initialize the SDK once
+ * ```typescript
+ * // lib/storefront.ts
+ * import { createStorefront } from "@commercengine/storefront-sdk-nextjs";
  *
- * 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
+ * export const storefront = createStorefront({
+ *   debug: true,
+ *   logger: (msg, ...args) => console.log('[DEBUG]', msg, ...args)
+ * });
+ * ```
  *
- * No manual token creation needed - just make API calls and everything works!
+ * @param config Optional configuration for advanced options (defaults to empty if not provided)
+ * @returns A storefront function that works in all Next.js contexts
  */
-declare function StorefrontSDKInitializer({ config, }: StorefrontSDKInitializerProps): null;
-
-export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, ServerTokenStorage, StorefrontSDKInitializer, getStorefrontSDK };
+declare function createStorefront(config?: StorefrontRuntimeConfig): {
+  (): StorefrontSDK$1;
+  (cookieStore: NextCookieStore): StorefrontSDK$1;
+  (options: {
+    isRootLayout: true;
+  }): StorefrontSDK$1;
+  (cookieStore: NextCookieStore, options: {
+    isRootLayout?: boolean;
+  }): StorefrontSDK$1;
+};
+//#endregion
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, type StorefrontRuntimeConfig, StorefrontSDK, createStorefront };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/create-storefront.ts"],"sourcesContent":[],"mappings":";;;;;KAQK,eAAA;;;;EAAA,CAAA,GAAA,SAAA;EAwBW,GAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAgB,KAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAtBY,MAsBZ,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAAA,MAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;;;;;;;;;;;;;;;;;;iBAAhB,gBAAA,UAA0B;MAKjB;gBACU,kBAAkB;;;MACG;gBACrB;;MAAuD"}

package/dist/index.js

@@ -1,305 +1,57 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/sdk-manager.ts
-import {
-  StorefrontSDK
-} from "@commercengine/storefront-sdk";
-
-// src/token-storage.ts
-var ClientTokenStorage = class {
-  constructor(options = {}) {
-    const prefix = options.prefix || "ce_";
-    this.accessTokenKey = `${prefix}access_token`;
-    this.refreshTokenKey = `${prefix}refresh_token`;
-    this.options = {
-      maxAge: options.maxAge || 30 * 24 * 60 * 60,
-      // 30 days default
-      path: options.path || "/",
-      domain: options.domain,
-      secure: options.secure ?? (typeof window !== "undefined" && window.location?.protocol === "https:"),
-      sameSite: options.sameSite || "Lax"
-    };
-  }
-  async getAccessToken() {
-    return this.getCookie(this.accessTokenKey);
-  }
-  async setAccessToken(token) {
-    this.setCookie(this.accessTokenKey, token);
-  }
-  async getRefreshToken() {
-    return this.getCookie(this.refreshTokenKey);
-  }
-  async setRefreshToken(token) {
-    this.setCookie(this.refreshTokenKey, token);
-  }
-  async clearTokens() {
-    this.deleteCookie(this.accessTokenKey);
-    this.deleteCookie(this.refreshTokenKey);
-  }
-  getCookie(name) {
-    if (typeof document === "undefined") return null;
-    const value = `; ${document.cookie}`;
-    const parts = value.split(`; ${name}=`);
-    if (parts.length === 2) {
-      const cookieValue = parts.pop()?.split(";").shift();
-      return cookieValue ? decodeURIComponent(cookieValue) : null;
-    }
-    return null;
-  }
-  setCookie(name, value) {
-    if (typeof document === "undefined") return;
-    const encodedValue = encodeURIComponent(value);
-    let cookieString = `${name}=${encodedValue}`;
-    if (this.options.maxAge) {
-      cookieString += `; Max-Age=${this.options.maxAge}`;
-    }
-    if (this.options.path) {
-      cookieString += `; Path=${this.options.path}`;
-    }
-    if (this.options.domain) {
-      cookieString += `; Domain=${this.options.domain}`;
-    }
-    if (this.options.secure) {
-      cookieString += `; Secure`;
-    }
-    if (this.options.sameSite) {
-      cookieString += `; SameSite=${this.options.sameSite}`;
-    }
-    document.cookie = cookieString;
-  }
-  deleteCookie(name) {
-    if (typeof document === "undefined") return;
-    let cookieString = `${name}=; Max-Age=0`;
-    if (this.options.path) {
-      cookieString += `; Path=${this.options.path}`;
-    }
-    if (this.options.domain) {
-      cookieString += `; Domain=${this.options.domain}`;
-    }
-    document.cookie = cookieString;
-  }
-};
-var ServerTokenStorage = class {
-  constructor(cookieStore, options = {}) {
-    const prefix = options.prefix || "ce_";
-    this.accessTokenKey = `${prefix}access_token`;
-    this.refreshTokenKey = `${prefix}refresh_token`;
-    this.cookieStore = cookieStore;
-    this.options = {
-      maxAge: options.maxAge || 30 * 24 * 60 * 60,
-      // 30 days default
-      path: options.path || "/",
-      domain: options.domain,
-      secure: options.secure ?? process.env.NODE_ENV === "production",
-      sameSite: options.sameSite || "Lax"
-    };
-  }
-  async getAccessToken() {
-    try {
-      return this.cookieStore.get(this.accessTokenKey)?.value || null;
-    } catch (error) {
-      console.warn(`Could not get access token from server cookies:`, error);
-      return null;
-    }
-  }
-  async setAccessToken(token) {
-    try {
-      this.cookieStore.set(this.accessTokenKey, token, {
-        maxAge: this.options.maxAge,
-        path: this.options.path,
-        domain: this.options.domain,
-        secure: this.options.secure,
-        sameSite: this.options.sameSite?.toLowerCase(),
-        httpOnly: false
-        // Must be false for client-side access
-      });
-    } catch (error) {
-      console.warn(`Could not set access token on server:`, error);
-    }
-  }
-  async getRefreshToken() {
-    try {
-      return this.cookieStore.get(this.refreshTokenKey)?.value || null;
-    } catch (error) {
-      console.warn(`Could not get refresh token from server cookies:`, error);
-      return null;
-    }
-  }
-  async setRefreshToken(token) {
-    try {
-      this.cookieStore.set(this.refreshTokenKey, token, {
-        maxAge: this.options.maxAge,
-        path: this.options.path,
-        domain: this.options.domain,
-        secure: this.options.secure,
-        sameSite: this.options.sameSite?.toLowerCase(),
-        httpOnly: false
-        // Must be false for client-side access
-      });
-    } catch (error) {
-      console.warn(`Could not set refresh token on server:`, error);
-    }
-  }
-  async clearTokens() {
-    try {
-      this.cookieStore.delete(this.accessTokenKey);
-      this.cookieStore.delete(this.refreshTokenKey);
-    } catch (error) {
-      console.warn(`Could not clear tokens on server:`, error);
-    }
-  }
-};
-
-// src/sdk-manager.ts
-var NextJSSDKManager = class _NextJSSDKManager {
-  constructor() {
-    this.clientSDK = null;
-    this.config = null;
-  }
-  static getInstance() {
-    if (!_NextJSSDKManager.instance) {
-      _NextJSSDKManager.instance = new _NextJSSDKManager();
-    }
-    return _NextJSSDKManager.instance;
-  }
-  /**
-   * Initialize the SDK with configuration (should be called once)
-   */
-  initialize(config) {
-    this.config = config;
-    if (typeof window !== "undefined" && !this.clientSDK) {
-      this.clientSDK = this.createClientSDK();
-    }
-  }
-  /**
-   * Get SDK instance for client-side usage
-   */
-  getClientSDK() {
-    if (!this.config) {
-      throw new Error("SDK not initialized. Call initialize() first.");
-    }
-    if (!this.clientSDK) {
-      this.clientSDK = this.createClientSDK();
-    }
-    return this.clientSDK;
-  }
-  /**
-   * Get SDK instance for server-side usage
-   */
-  getServerSDK(cookieStore) {
-    if (!this.config) {
-      throw new Error("SDK not initialized. Call initialize() first.");
-    }
-    return new StorefrontSDK({
-      ...this.config,
-      tokenStorage: new ServerTokenStorage(
-        cookieStore,
-        this.config.tokenStorageOptions
-      )
-    });
-  }
-  createClientSDK() {
-    if (!this.config) {
-      throw new Error("SDK not initialized. Call initialize() first.");
-    }
-    return new StorefrontSDK({
-      ...this.config,
-      tokenStorage: new ClientTokenStorage(this.config.tokenStorageOptions)
-    });
-  }
-  /**
-   * Check if SDK is initialized
-   */
-  isInitialized() {
-    return this.config !== null;
-  }
-  /**
-   * Reset the SDK (useful for testing)
-   */
-  reset() {
-    this.clientSDK = null;
-    this.config = null;
-  }
-};
-function getStorefrontSDK(cookieStore) {
-  const manager = NextJSSDKManager.getInstance();
-  if (typeof window !== "undefined") {
-    if (cookieStore) {
-      console.warn(
-        "Cookie store passed in client environment - this will be ignored"
-      );
-    }
-    return manager.getClientSDK();
-  }
-  if (!cookieStore) {
-    let autoDetectMessage = "";
-    try {
-      __require.resolve("next/headers");
-      autoDetectMessage = `
-
-\u{1F50D} Auto-detection attempted but failed. You may be in:
-- Server Action (use: const sdk = getStorefrontSDK(await cookies()))
-- API Route (use: const sdk = getStorefrontSDK(cookies()))
-- Middleware (token access limited)
-`;
-    } catch {
-      autoDetectMessage = `
-
-\u{1F4A1} Make sure you have Next.js installed and are in a server context.
-`;
-    }
-    throw new Error(
-      `
-\u{1F6A8} Server Environment Detected!
-
-You're calling getStorefrontSDK() on the server without cookies.
-Please pass the Next.js cookie store:
-
-\u2705 Correct usage:
-import { cookies } from 'next/headers';
-
-// Server Actions & Route Handlers
-const sdk = getStorefrontSDK(await cookies());
-
-// API Routes (Next.js 12)
-const sdk = getStorefrontSDK(cookies());
-
-\u274C Your current usage:
-const sdk = getStorefrontSDK(); // Missing cookies!
-${autoDetectMessage}
-This is required for server-side token access.
-    `.trim()
-    );
-  }
-  return manager.getServerSDK(cookieStore);
-}
-function initializeStorefrontSDK(config) {
-  const manager = NextJSSDKManager.getInstance();
-  manager.initialize(config);
-}
-
-// src/init-client.ts
-import { useEffect } from "react";
-function StorefrontSDKInitializer({
-  config
-}) {
-  useEffect(() => {
-    initializeStorefrontSDK(config);
-  }, [config]);
-  return null;
+import { getStorefrontSDK, setGlobalStorefrontConfig } from "./sdk-manager-CdgrfSVp.js";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+
+//#region src/create-storefront.ts
+/**
+* Creates a configured storefront function that works universally across all Next.js contexts
+*
+* Usage:
+* ```typescript
+* // lib/storefront.ts
+* import { createStorefront } from "@commercengine/storefront-sdk-nextjs";
+*
+* export const storefront = createStorefront({
+*   debug: true,
+*   logger: (msg, ...args) => console.log('[DEBUG]', msg, ...args)
+* });
+* ```
+*
+* @param config Optional configuration for advanced options (defaults to empty if not provided)
+* @returns A storefront function that works in all Next.js contexts
+*/
+function createStorefront(config) {
+	if (config) setGlobalStorefrontConfig(config);
+	function storefront(cookieStoreOrOptions, options) {
+		if (typeof window !== "undefined") return getStorefrontSDK();
+		let cookieStore;
+		let isRootLayout = false;
+		if (cookieStoreOrOptions) if ("isRootLayout" in cookieStoreOrOptions) isRootLayout = cookieStoreOrOptions.isRootLayout;
+		else {
+			cookieStore = cookieStoreOrOptions;
+			isRootLayout = options?.isRootLayout || false;
+		}
+		if (cookieStore) return getStorefrontSDK(cookieStore);
+		if (process.env.NEXT_IS_BUILD === "true" || process.env.NEXT_BUILD_CACHE_TOKENS === "true") return getStorefrontSDK();
+		if (isRootLayout) return getStorefrontSDK();
+		throw new Error([
+			"🚨 Server context requires cookies for user continuity!",
+			"",
+			"You're calling storefront() on the server without cookies.",
+			"This breaks user session continuity and analytics tracking.",
+			"",
+			"✅ Correct usage:",
+			"  import { cookies } from 'next/headers'",
+			"  const sdk = storefront(cookies())",
+			"",
+			"📍 Root Layout exception:",
+			"  const sdk = storefront({ isRootLayout: true })",
+			"",
+			"This is required to maintain consistent user identity across requests."
+		].join("\n"));
+	}
+	return storefront;
 }
 
-// src/index.ts
-import { Environment } from "@commercengine/storefront-sdk";
-export {
-  ClientTokenStorage,
-  Environment,
-  ServerTokenStorage,
-  StorefrontSDKInitializer,
-  getStorefrontSDK
-};
+//#endregion
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, createStorefront };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["cookieStore: NextCookieStore | undefined"],"sources":["../src/create-storefront.ts"],"sourcesContent":["import {\n  getStorefrontSDK,\n  setGlobalStorefrontConfig,\n  type StorefrontRuntimeConfig,\n} from \"./sdk-manager\";\nimport type { StorefrontSDK } from \"@commercengine/storefront-sdk\";\n\n// Structural type so we don't import next/headers at module scope\ntype NextCookieStore = {\n  get: (name: string) => { name: string; value: string } | undefined;\n  set: (name: string, value: string, opts?: Record<string, unknown>) => void;\n  delete: (name: string) => void;\n};\n\n\n/**\n * Creates a configured storefront function that works universally across all Next.js contexts\n *\n * Usage:\n * ```typescript\n * // lib/storefront.ts\n * import { createStorefront } from \"@commercengine/storefront-sdk-nextjs\";\n *\n * export const storefront = createStorefront({\n *   debug: true,\n *   logger: (msg, ...args) => console.log('[DEBUG]', msg, ...args)\n * });\n * ```\n *\n * @param config Optional configuration for advanced options (defaults to empty if not provided)\n * @returns A storefront function that works in all Next.js contexts\n */\nexport function createStorefront(config?: StorefrontRuntimeConfig) {\n  if (config) {\n    setGlobalStorefrontConfig(config);\n  }\n\n  function storefront(): StorefrontSDK;\n  function storefront(cookieStore: NextCookieStore): StorefrontSDK;\n  function storefront(options: { isRootLayout: true }): StorefrontSDK;\n  function storefront(cookieStore: NextCookieStore, options: { isRootLayout?: boolean }): StorefrontSDK;\n  function storefront(\n    cookieStoreOrOptions?: NextCookieStore | { isRootLayout: true }, \n    options?: { isRootLayout?: boolean }\n  ): StorefrontSDK {\n    // Client path\n    if (typeof window !== \"undefined\") {\n      return getStorefrontSDK();\n    }\n\n    // Parse parameters to handle different overloads\n    let cookieStore: NextCookieStore | undefined;\n    let isRootLayout = false;\n\n    if (cookieStoreOrOptions) {\n      if ('isRootLayout' in cookieStoreOrOptions) {\n        // First parameter is options object\n        isRootLayout = cookieStoreOrOptions.isRootLayout;\n      } else {\n        // First parameter is cookie store\n        cookieStore = cookieStoreOrOptions;\n        isRootLayout = options?.isRootLayout || false;\n      }\n    }\n\n    // Server path with explicit cookies\n    if (cookieStore) {\n      return getStorefrontSDK(cookieStore);\n    }\n\n    // Server path without cookies:\n    // 1. Always allow build contexts (no request context available)\n    if (\n      process.env.NEXT_IS_BUILD === \"true\" ||\n      process.env.NEXT_BUILD_CACHE_TOKENS === \"true\"\n    ) {\n      return getStorefrontSDK();\n    }\n\n    // 2. Allow root layout with explicit flag\n    if (isRootLayout) {\n      return getStorefrontSDK();\n    }\n\n    // 3. All other server contexts must pass cookies - throw helpful error\n    throw new Error(\n      [\n        \"🚨 Server context requires cookies for user continuity!\",\n        \"\",\n        \"You're calling storefront() on the server without cookies.\",\n        \"This breaks user session continuity and analytics tracking.\",\n        \"\",\n        \"✅ Correct usage:\",\n        \"  import { cookies } from 'next/headers'\",\n        \"  const sdk = storefront(cookies())\",\n        \"\",\n        \"📍 Root Layout exception:\",\n        \"  const sdk = storefront({ isRootLayout: true })\",\n        \"\",\n        \"This is required to maintain consistent user identity across requests.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return storefront;\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,iBAAiB,QAAkC;AACjE,KAAI,OACF,2BAA0B;CAO5B,SAAS,WACP,sBACA,SACe;AAEf,MAAI,OAAO,WAAW,YACpB,QAAO;EAIT,IAAIA;EACJ,IAAI,eAAe;AAEnB,MAAI,qBACF,KAAI,kBAAkB,qBAEpB,gBAAe,qBAAqB;OAC/B;AAEL,iBAAc;AACd,kBAAe,SAAS,gBAAgB;;AAK5C,MAAI,YACF,QAAO,iBAAiB;AAK1B,MACE,QAAQ,IAAI,kBAAkB,UAC9B,QAAQ,IAAI,4BAA4B,OAExC,QAAO;AAIT,MAAI,aACF,QAAO;AAIT,QAAM,IAAI,MACR;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;IACA,KAAK;;AAIX,QAAO"}

package/dist/sdk-manager-B9xDQQuv.d.ts

@@ -0,0 +1,141 @@
+import { DebugLoggerFn, Environment, StorefrontSDK, StorefrontSDKOptions, SupportedDefaultHeaders, TokenStorage } from "@commercengine/storefront-sdk";
+
+//#region src/token-storage.d.ts
+
+/**
+ * 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;
+}
+type NextCookieStore$1 = {
+  get: (name: string) => {
+    value: string;
+  } | undefined;
+  set: (name: string, value: string, options?: any) => void;
+  delete: (name: string) => void;
+};
+/**
+ * Server-side token storage that uses Next.js cookies API
+ */
+declare class ServerTokenStorage implements TokenStorage {
+  private accessTokenKey;
+  private refreshTokenKey;
+  private options;
+  private cookieStore;
+  constructor(cookieStore: NextCookieStore$1, options?: NextJSTokenStorageOptions);
+  getAccessToken(): Promise<string | null>;
+  setAccessToken(token: string): Promise<void>;
+  getRefreshToken(): Promise<string | null>;
+  setRefreshToken(token: string): Promise<void>;
+  clearTokens(): Promise<void>;
+}
+//#endregion
+//#region src/sdk-manager.d.ts
+/**
+ * Configuration for the NextJS SDK wrapper
+ */
+interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
+  /**
+   * Token storage configuration options
+   */
+  tokenStorageOptions?: NextJSTokenStorageOptions;
+}
+/**
+ * Runtime configuration overrides that can be passed to storefront() function
+ * These override environment variables for that specific request
+ */
+interface StorefrontRuntimeConfig {
+  /**
+   * Override environment variables
+   */
+  storeId?: string;
+  apiKey?: string;
+  environment?: Environment;
+  baseUrl?: string;
+  timeout?: number;
+  debug?: boolean;
+  /**
+   * Advanced options not available via environment variables
+   */
+  accessToken?: string;
+  refreshToken?: string;
+  defaultHeaders?: SupportedDefaultHeaders;
+  logger?: DebugLoggerFn;
+  onTokensUpdated?: (accessToken: string, refreshToken: string) => void;
+  onTokensCleared?: () => void;
+  /**
+   * Token storage configuration
+   */
+  tokenStorageOptions?: NextJSTokenStorageOptions;
+}
+type NextCookieStore = {
+  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): StorefrontSDK;
+/**
+ * Set global storefront configuration that applies to all SDK instances
+ * This gets bundled into both client and server contexts automatically
+ */
+
+/**
+ * Initialize the SDK (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(): void;
+//#endregion
+export { ClientTokenStorage, NextJSSDKConfig, NextJSTokenStorageOptions, ServerTokenStorage, StorefrontRuntimeConfig, getStorefrontSDK, initializeStorefrontSDK };
+//# sourceMappingURL=sdk-manager-B9xDQQuv.d.ts.map

package/dist/sdk-manager-B9xDQQuv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-manager-B9xDQQuv.d.ts","names":[],"sources":["../src/token-storage.ts","../src/sdk-manager.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AA8Ca,UA9CI,yBAAA,CA8Ce;EAAA;;;QAuBO,CAAA,EAAA,MAAA;;;;QAvBI,CAAA,EAAA,MAAA;;AAkG1C;AAYD;EAAgC,IAAA,CAAA,EAAA,MAAA;;;;QA8BO,CAAA,EAAA,MAAA;;;;QA9BI,CAAA,EAAA,OAAA;;;;;AC9I3C;;;;AACU,cD+BG,kBAAA,YAA8B,YC/BjC,CAAA;;EAWO,QAAA,eAAA;EAAuB,QAAA,OAAA;aAMxB,CAAA,OAAA,CAAA,EDmBO,yBCnBP;gBAUG,CAAA,CAAA,EDuBO,OCvBP,CAAA,MAAA,GAAA,IAAA,CAAA;gBACR,CAAA,KAAA,EAAA,MAAA,CAAA,ED0B4B,OC1B5B,CAAA,IAAA,CAAA;iBAOa,CAAA,CAAA,EDuBG,OCvBH,CAAA,MAAA,GAAA,IAAA,CAAA;kCD2BgB;ECuInC,WAAA,CAAA,CAAA,EDnIkB,OCmIH,CAAA,IAAA,CAAA;EAcJ,QAAA,SAAA;EACA,QAAA,SAAA;EAAgB,QAAA,YAAA;;KDhF3B,iBAAA,GCgF2D;;IA+DhD,KAAA,EAAA,MAAA;;;;;;;;cDtIH,kBAAA,YAA8B;;;;;2BAMhB,6BAA0B;oBAe3B;iCASa;qBAeZ;kCASa;iBAejB;;;;;AAjOvB;AA8CA;AAAgC,UChCf,eAAA,SACP,ID+BsB,CC/BjB,oBD+BiB,EAAA,cAAA,CAAA,CAAA;;;;qBA2BL,CAAA,ECtDH,yBDsDG;;;;;AAuE1B;AAYY,UClII,uBAAA,CDkIe;EAAA;;;SAqBN,CAAA,EAAA,MAAA;QASa,CAAA,EAAA,MAAA;aAeZ,CAAA,ECzKX,WDyKW;SASa,CAAA,EAAA,MAAA;SAejB,CAAA,EAAA,MAAA;OArEoB,CAAA,EAAA,OAAA;;;;;EC9I1B,YAAA,CAAA,EAAA,MACf;EAAA,cAAA,CAAA,EA2BiB,uBA3BjB;QAAa,CAAA,EA4BJ,aA5BI;iBAIS,CAAA,EAAA,CAAA,WAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,GAAA,IAAA;iBAJd,CAAA,EAAA,GAAA,GAAA,IAAA;;AAWV;;qBAMgB,CAAA,EAkBQ,yBAlBR;;KAoLX,eAAA,GAzKM;KAOa,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA;;EAkKnB,CAAA,GAAA,SAAA;EAcW,GAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAgB,KAAA,EAAA,MAAI,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,GAAA,IAAA;EACpB,MAAA,EAAA,CAAA,IAAA,EAAA,MAAgB,EAAA,GAAA,IAAA;CAAA;;;;AA+DhC;;;;;iBAhEgB,gBAAA,CAAA,GAAoB;iBACpB,gBAAA,cAA8B,kBAAkB;;;;;;;;;;iBA+DhD,uBAAA,CAAA"}