@commercengine/storefront-sdk-nextjs 0.1.13 → 0.2.0

package/README.md

@@ -2,6 +2,8 @@
 
 **Production-ready Next.js wrapper** for the CommerceEngine Storefront SDK. Provides the perfect developer experience with automatic context detection, universal API, and zero configuration complexity.
 
+Built on [`@commercengine/ssr-utils`](../ssr-utils) for robust server-side token management.
+
 **✨ Perfect DX Pattern:**
 - **🎯 One Config File** - Single `lib/storefront.ts` using `createStorefront()`
 - **🌍 Universal API** - Same `storefront()` import works everywhere
@@ -622,13 +624,18 @@ For complete API documentation of all available endpoints, visit [SDK DOCS REFER
 The Next.js SDK provides access to all the same endpoints as the core SDK:
 
 - `sdk.auth.*` - Authentication and user management
-- `sdk.customer.*` - Customer profiles and preferences  
+- `sdk.customer.*` - Customer profiles and preferences
 - `sdk.catalog.*` - Products, categories, and search
 - `sdk.cart.*` - Shopping cart management
 - `sdk.order.*` - Order creation and tracking
-- `sdk.shipping.*` - Shipping methods and rates
+- `sdk.payments.*` - Payment methods and processing
+- `sdk.store.*` - Store configuration
 - `sdk.helpers.*` - Countries, currencies, utilities
 
+## Related Packages
+
+- [`@commercengine/storefront-sdk`](../storefront-sdk) - Core Storefront SDK
+
 ## License
 
 All Rights Reserved

package/dist/client.d.mts

@@ -1,7 +1,7 @@
-import { a as ClientTokenStorage, i as initializeStorefrontSDK, n as StorefrontRuntimeConfig, o as NextJSTokenStorageOptions, r as getStorefrontSDK, t as NextJSSDKConfig } from "./sdk-manager.mjs";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKOptions, TokenStorage } from "@commercengine/storefront-sdk";
+import { c as NextJSTokenStorageOptions, i as initializeStorefrontSDK, n as StorefrontRuntimeConfig, r as getStorefrontSDK, s as ClientTokenStorage, t as NextJSSDKConfig } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKOptions, TokenStorage } from "@commercengine/storefront-sdk";
 
-//#region src/init-client.d.ts
+//#region src/initializer.d.ts
 interface StorefrontSDKInitializerProps {
   /**
    * Optional runtime configuration overrides for client-side API calls
@@ -13,4 +13,4 @@ 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 };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, type StorefrontSDKOptions, type TokenStorage, getStorefrontSDK, initializeStorefrontSDK };

package/dist/client.mjs

@@ -1,10 +1,10 @@
 "use client";
 
-import { i as ClientTokenStorage, n as initializeStorefrontSDK, t as getStorefrontSDK } from "./sdk-manager.mjs";
+import { a as ClientTokenStorage, n as initializeStorefrontSDK, t as getStorefrontSDK } from "./manager.mjs";
 import { useEffect } from "react";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
 
-//#region src/init-client.ts
+//#region src/initializer.tsx
 /**
 * Client-side initialization component
 * Use this in your root layout to initialize the SDK once
@@ -38,4 +38,4 @@ function StorefrontSDKInitializer({ runtimeConfig } = {}) {
 }
 
 //#endregion
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { n as StorefrontRuntimeConfig } from "./sdk-manager.mjs";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDK as StorefrontSDK$1 } from "@commercengine/storefront-sdk";
+import { n as StorefrontRuntimeConfig } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDK as StorefrontSDK$1 } from "@commercengine/storefront-sdk";
 export * from "@commercengine/storefront-sdk";
 
-//#region src/create-storefront.d.ts
+//#region src/storefront.d.ts
 type NextCookieStore = {
   get: (name: string) => {
     name: string;
@@ -39,4 +39,4 @@ declare function createStorefront(config?: StorefrontRuntimeConfig): {
   }): StorefrontSDK$1;
 };
 //#endregion
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, type StorefrontRuntimeConfig, StorefrontSDK, createStorefront };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, type StorefrontRuntimeConfig, StorefrontSDK, createStorefront };

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { r as setGlobalStorefrontConfig, t as getStorefrontSDK } from "./sdk-manager.mjs";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+import { r as setGlobalStorefrontConfig, t as getStorefrontSDK } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
 
-//#region src/create-storefront.ts
+//#region src/storefront.ts
 /**
 * Creates a configured storefront function that works universally across all Next.js contexts
 *
@@ -53,4 +53,4 @@ function createStorefront(config) {
 }
 
 //#endregion
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, createStorefront };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, createStorefront };

package/dist/{sdk-manager.d.mts → manager.d.mts}

@@ -1,44 +1,31 @@
 import { DebugLoggerFn, Environment, StorefrontSDK, StorefrontSDKOptions, SupportedDefaultHeaders, TokenStorage } from "@commercengine/storefront-sdk";
+import { SSRTokenStorageOptions, ServerTokenStorage } from "@commercengine/ssr-utils";
 
-//#region src/token-storage.d.ts
+//#region src/client-storage.d.ts
 
 /**
- * Configuration options for NextJSTokenStorage
+ * Configuration options for NextJS token storage
+ * Re-exported from ssr-utils for convenience
  */
-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";
-}
+type NextJSTokenStorageOptions$1 = SSRTokenStorageOptions;
 /**
  * Client-side token storage that uses document.cookie
+ *
+ * This is Next.js specific because it needs to work with the same cookie
+ * format as the server-side storage for seamless SSR/client hydration.
+ *
+ * @example
+ * ```typescript
+ * import { ClientTokenStorage } from '@commercengine/storefront-sdk-nextjs/client';
+ *
+ * const storage = new ClientTokenStorage();
+ * ```
  */
 declare class ClientTokenStorage implements TokenStorage {
   private accessTokenKey;
   private refreshTokenKey;
   private options;
-  constructor(options?: NextJSTokenStorageOptions);
+  constructor(options?: NextJSTokenStorageOptions$1);
   getAccessToken(): Promise<string | null>;
   setAccessToken(token: string): Promise<void>;
   getRefreshToken(): Promise<string | null>;
@@ -48,30 +35,41 @@ declare class ClientTokenStorage implements TokenStorage {
   private setCookie;
   private deleteCookie;
 }
-type NextCookieStore$1 = {
+//#endregion
+//#region src/server-storage.d.ts
+/**
+ * Configuration options for NextJS token storage
+ * Re-exported from ssr-utils for convenience
+ */
+type NextJSTokenStorageOptions = SSRTokenStorageOptions;
+/**
+ * Type for Next.js cookies (from next/headers)
+ */
+type NextCookieStore = {
   get: (name: string) => {
     value: string;
   } | undefined;
-  set: (name: string, value: string, options?: any) => void;
+  set: (name: string, value: string, options?: Record<string, unknown>) => void;
   delete: (name: string) => void;
 };
 /**
- * Server-side token storage that uses Next.js cookies API
+ * Server-side token storage for Next.js using the cookies() API
+ *
+ * This wraps the ssr-utils ServerTokenStorage with a Next.js-specific adapter.
+ *
+ * @example
+ * ```typescript
+ * import { cookies } from 'next/headers';
+ * import { ServerTokenStorage } from '@commercengine/storefront-sdk-nextjs/server';
+ *
+ * const storage = new ServerTokenStorage(cookies());
+ * ```
  */
-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>;
+declare class ServerTokenStorage$1 extends ServerTokenStorage {
+  constructor(cookieStore: NextCookieStore, options?: NextJSTokenStorageOptions);
 }
 //#endregion
-//#region src/sdk-manager.d.ts
+//#region src/manager.d.ts
 /**
  * Configuration for the NextJS SDK wrapper
  */
@@ -79,7 +77,7 @@ interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
   /**
    * Token storage configuration options
    */
-  tokenStorageOptions?: NextJSTokenStorageOptions;
+  tokenStorageOptions?: NextJSTokenStorageOptions$1;
 }
 /**
  * Runtime configuration overrides that can be passed to storefront() function
@@ -107,15 +105,8 @@ interface StorefrontRuntimeConfig {
   /**
    * Token storage configuration
    */
-  tokenStorageOptions?: NextJSTokenStorageOptions;
+  tokenStorageOptions?: NextJSTokenStorageOptions$1;
 }
-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
  *
@@ -132,4 +123,4 @@ declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
  */
 declare function initializeStorefrontSDK(): void;
 //#endregion
-export { ClientTokenStorage as a, initializeStorefrontSDK as i, StorefrontRuntimeConfig as n, NextJSTokenStorageOptions as o, getStorefrontSDK as r, ServerTokenStorage as s, NextJSSDKConfig as t };
+export { NextJSTokenStorageOptions as a, NextJSTokenStorageOptions$1 as c, initializeStorefrontSDK as i, StorefrontRuntimeConfig as n, ServerTokenStorage$1 as o, getStorefrontSDK as r, ClientTokenStorage as s, NextJSSDKConfig as t };

package/dist/{sdk-manager.mjs → manager.mjs}

@@ -1,9 +1,20 @@
 import { cache } from "react";
 import { Environment, MemoryTokenStorage, StorefrontSDK } from "@commercengine/storefront-sdk";
+import { BuildCachingTokenStorage, ServerTokenStorage, isBuildContext } from "@commercengine/ssr-utils";
 
-//#region src/token-storage.ts
+//#region src/client-storage.ts
 /**
 * Client-side token storage that uses document.cookie
+*
+* This is Next.js specific because it needs to work with the same cookie
+* format as the server-side storage for seamless SSR/client hydration.
+*
+* @example
+* ```typescript
+* import { ClientTokenStorage } from '@commercengine/storefront-sdk-nextjs/client';
+*
+* const storage = new ClientTokenStorage();
+* ```
 */
 var ClientTokenStorage = class {
 	accessTokenKey;
@@ -13,12 +24,17 @@ var ClientTokenStorage = class {
 		const prefix = options.prefix || "ce_";
 		this.accessTokenKey = `${prefix}access_token`;
 		this.refreshTokenKey = `${prefix}refresh_token`;
+		const normalizedSameSite = options.sameSite ? {
+			strict: "Strict",
+			lax: "Lax",
+			none: "None"
+		}[options.sameSite] : "Lax";
 		this.options = {
 			maxAge: options.maxAge || 720 * 60 * 60,
 			path: options.path || "/",
 			domain: options.domain,
 			secure: options.secure ?? (typeof window !== "undefined" && window.location?.protocol === "https:"),
-			sameSite: options.sameSite || "Lax"
+			sameSite: normalizedSameSite
 		};
 	}
 	async getAccessToken() {
@@ -64,157 +80,47 @@ var ClientTokenStorage = class {
 		document.cookie = cookieString;
 	}
 };
+
+//#endregion
+//#region src/server-storage.ts
 /**
-* Server-side token storage that uses Next.js cookies API
+* Server-side token storage for Next.js using the cookies() API
+*
+* This wraps the ssr-utils ServerTokenStorage with a Next.js-specific adapter.
+*
+* @example
+* ```typescript
+* import { cookies } from 'next/headers';
+* import { ServerTokenStorage } from '@commercengine/storefront-sdk-nextjs/server';
+*
+* const storage = new ServerTokenStorage(cookies());
+* ```
 */
-var ServerTokenStorage = class {
-	accessTokenKey;
-	refreshTokenKey;
-	options;
-	cookieStore;
+var ServerTokenStorage$1 = class extends ServerTokenStorage {
 	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 || 720 * 60 * 60,
-			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
-			});
-		} 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
-			});
-		} 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);
-		}
+		super({
+			get: (name) => cookieStore.get(name)?.value ?? null,
+			set: (name, value, opts) => cookieStore.set(name, value, opts),
+			delete: (name) => cookieStore.delete(name)
+		}, options);
 	}
 };
 
 //#endregion
-//#region src/build-token-cache.ts
-const store = /* @__PURE__ */ new Map();
-function isExpired(token) {
-	if (!token) return true;
-	if (!token.expiresAt) return false;
-	return Date.now() > token.expiresAt - 3e4;
-}
-function getCachedToken(key) {
-	const token = store.get(key);
-	return isExpired(token) ? null : token;
-}
-function setCachedToken(key, token) {
-	const expiresAt = token.ttlSeconds != null ? Date.now() + token.ttlSeconds * 1e3 : void 0;
-	store.set(key, {
-		accessToken: token.accessToken,
-		refreshToken: token.refreshToken ?? null,
-		expiresAt
-	});
-}
-function clearCachedToken(key) {
-	store.delete(key);
-}
-
-//#endregion
-//#region src/build-caching-memory-storage.ts
-const DEFAULT_TTL_SECONDS = 300;
+//#region src/manager.ts
 /**
-* Memory token storage that reuses tokens across the build process
-* via an in-process cache. Only used during SSG/ISR builds.
+* Global runtime configuration storage
+* This gets bundled into both client and server bundles
 */
-var BuildCachingMemoryTokenStorage = class {
-	access = null;
-	refresh = null;
-	constructor(cacheKey, ttlSeconds = DEFAULT_TTL_SECONDS) {
-		this.cacheKey = cacheKey;
-		this.ttlSeconds = ttlSeconds;
-	}
-	async getAccessToken() {
-		if (this.access) return this.access;
-		const cached = getCachedToken(this.cacheKey);
-		if (cached?.accessToken) {
-			this.access = cached.accessToken;
-			this.refresh = cached.refreshToken ?? null;
-			return this.access;
-		}
-		return null;
-	}
-	async setAccessToken(token) {
-		this.access = token;
-		setCachedToken(this.cacheKey, {
-			accessToken: token,
-			refreshToken: this.refresh,
-			ttlSeconds: this.ttlSeconds
-		});
-	}
-	async getRefreshToken() {
-		return this.refresh;
-	}
-	async setRefreshToken(token) {
-		this.refresh = token;
-		setCachedToken(this.cacheKey, {
-			accessToken: this.access ?? "",
-			refreshToken: token,
-			ttlSeconds: this.ttlSeconds
-		});
-	}
-	async clearTokens() {
-		this.access = null;
-		this.refresh = null;
-		clearCachedToken(this.cacheKey);
-	}
-};
-
-//#endregion
-//#region src/sdk-manager.ts
+let globalStorefrontConfig = null;
+/**
+* Client-side SDK singleton (only lives in browser)
+*/
+let clientSDK = null;
+/**
+* Memory-based SDK for SSG/build contexts (no request isolation needed)
+*/
+let buildTimeSDK = null;
 /**
 * Get configuration from environment variables merged with global config
 * Precedence order: environment variables < global config
@@ -269,21 +175,15 @@ These variables are required for both client and server contexts to work.`);
 	return config;
 }
 /**
-* Global runtime configuration storage
-* This gets bundled into both client and server bundles
-*/
-let globalStorefrontConfig = null;
-/**
-* Client-side SDK singleton (only lives in browser)
-*/
-let clientSDK = null;
-/**
 * Create appropriate token storage based on environment
 */
 function createTokenStorage(cookieStore, options, config) {
 	if (typeof window !== "undefined") return new ClientTokenStorage(options);
-	if (cookieStore) return new ServerTokenStorage(cookieStore, options);
-	if (process.env.NEXT_BUILD_CACHE_TOKENS === "true" && config) return new BuildCachingMemoryTokenStorage(`${config.storeId}:${config.environment || "production"}`);
+	if (cookieStore) return new ServerTokenStorage$1(cookieStore, options);
+	if ((process.env.NEXT_BUILD_CACHE_TOKENS === "true" || isBuildContext({ envVars: ["NEXT_IS_BUILD", "NEXT_BUILD_CACHE_TOKENS"] })) && config) return new BuildCachingTokenStorage({
+		cacheKey: `${config.storeId}:${config.environment || "production"}`,
+		ttlSeconds: 300
+	});
 	return new MemoryTokenStorage();
 }
 /**
@@ -297,9 +197,8 @@ const getServerSDKCached = cache((cookieStore) => {
 	});
 });
 /**
-* Memory-based SDK for SSG/build contexts (no request isolation needed)
+* Get or create build-time SDK singleton
 */
-let buildTimeSDK = null;
 function getBuildTimeSDK() {
 	const config = getConfig();
 	if (!buildTimeSDK) buildTimeSDK = new StorefrontSDK({
@@ -340,4 +239,4 @@ function initializeStorefrontSDK() {
 }
 
 //#endregion
-export { ServerTokenStorage as a, ClientTokenStorage as i, initializeStorefrontSDK as n, setGlobalStorefrontConfig as r, getStorefrontSDK as t };
+export { ClientTokenStorage as a, ServerTokenStorage$1 as i, initializeStorefrontSDK as n, setGlobalStorefrontConfig as r, getStorefrontSDK as t };

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-import { i as initializeStorefrontSDK, o as NextJSTokenStorageOptions, r as getStorefrontSDK, s as ServerTokenStorage, t as NextJSSDKConfig } from "./sdk-manager.mjs";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+import { a as NextJSTokenStorageOptions, i as initializeStorefrontSDK, o as ServerTokenStorage, r as getStorefrontSDK, t as NextJSSDKConfig } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
 export * from "@commercengine/storefront-sdk";
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, ResponseUtils, ServerTokenStorage, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, PaymentsClient, ResponseUtils, ServerTokenStorage, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };

package/dist/server.mjs

@@ -1,6 +1,6 @@
-import { a as ServerTokenStorage, n as initializeStorefrontSDK, t as getStorefrontSDK } from "./sdk-manager.mjs";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+import { i as ServerTokenStorage, n as initializeStorefrontSDK, t as getStorefrontSDK } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
 
 export * from "@commercengine/storefront-sdk"
 
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ServerTokenStorage, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, ServerTokenStorage, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercengine/storefront-sdk-nextjs",
-  "version": "0.1.13",
+  "version": "0.2.0",
   "description": "Next.js wrapper for the Commerce Engine Storefront SDK",
   "type": "module",
   "main": "dist/index.mjs",
@@ -43,7 +43,8 @@
     "react-dom": ">=19.0.0"
   },
   "dependencies": {
-    "@commercengine/storefront-sdk": "0.12.1"
+    "@commercengine/storefront-sdk": "0.12.1",
+    "@commercengine/ssr-utils": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "^24.10.4",