@commercengine/storefront-sdk-nextjs 0.2.10 → 0.3.1

package/dist/client.d.mts

@@ -1,11 +1,11 @@
-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";
+import { a as initializeStorefrontSDK, i as getSessionStorefrontSDK, l as ClientTokenStorage, n as StorefrontRuntimeConfig, r as getPublicStorefrontSDK, t as NextJSSDKConfig, u as NextJSTokenStorageOptions } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, SessionStorefrontSDKOptions, StoreConfigClient, TokenStorage } from "@commercengine/storefront-sdk";
 
 //#region src/initializer.d.ts
 interface StorefrontSDKInitializerProps {
   /**
    * Optional runtime configuration overrides for client-side API calls
-   * These settings will apply to all client-side storefront() calls
+   * These settings will apply to all client-side `storefront.session()` calls
    */
   runtimeConfig?: StorefrontRuntimeConfig;
 }
@@ -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, PaymentsClient, ResponseUtils, 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, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, type SessionStorefrontSDKOptions, StoreConfigClient, StorefrontSDKInitializer, type TokenStorage, getPublicStorefrontSDK, getSessionStorefrontSDK, initializeStorefrontSDK };

package/dist/client.mjs

@@ -1,8 +1,8 @@
 "use client";
 
-import { a as ClientTokenStorage, n as initializeStorefrontSDK, t as getStorefrontSDK } from "./manager.mjs";
+import { i as setGlobalStorefrontConfig, n as getSessionStorefrontSDK, o as ClientTokenStorage, r as initializeStorefrontSDK, t as getPublicStorefrontSDK } from "./manager.mjs";
 import { useEffect } from "react";
-import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient } from "@commercengine/storefront-sdk";
 
 //#region src/initializer.tsx
 /**
@@ -23,19 +23,19 @@ import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieToken
 * No manual token creation needed - just make API calls and everything works!
 */
 /**
-* Bootstrap tokens by checking if access token exists and creating anonymous token if needed
+* Bootstrap the client-side session if no access token exists yet.
 */
-async function bootstrapTokens() {
-	const sdk = getStorefrontSDK();
-	if (!await sdk.getAccessToken()) await sdk.auth.getAnonymousToken();
+async function bootstrapSession() {
+	await getSessionStorefrontSDK().ensureAccessToken();
 }
 function StorefrontSDKInitializer({ runtimeConfig } = {}) {
 	useEffect(() => {
-		initializeStorefrontSDK();
-		bootstrapTokens().catch(console.error);
+		if (runtimeConfig) setGlobalStorefrontConfig(runtimeConfig);
+		else initializeStorefrontSDK();
+		bootstrapSession().catch(console.error);
 	}, [runtimeConfig]);
 	return null;
 }
 
 //#endregion
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient, StorefrontSDKInitializer, getPublicStorefrontSDK, getSessionStorefrontSDK, initializeStorefrontSDK };

package/dist/index.d.mts

@@ -1,18 +1,26 @@
-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";
+import { n as StorefrontRuntimeConfig, o as NextCookieStore } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, PublicStorefrontSDK as PublicStorefrontSDK$1, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, SessionStorefrontSDK as SessionStorefrontSDK$1, StoreConfigClient } from "@commercengine/storefront-sdk";
 export * from "@commercengine/storefront-sdk";
 
 //#region src/storefront.d.ts
-type NextCookieStore = {
-  get: (name: string) => {
-    name: string;
-    value: string;
-  } | undefined;
-  set: (name: string, value: string, opts?: Record<string, unknown>) => void;
-  delete: (name: string) => void;
+
+/**
+ * Next.js storefront factory returned by `createStorefront()`.
+ *
+ * Usage:
+ * - `storefront.public()` for build/prerender-safe public reads
+ * - `storefront.session()` in Client Components
+ * - `storefront.session(cookies())` in server request contexts
+ */
+type NextJSStorefront = {
+  public: () => PublicStorefrontSDK$1;
+  session: {
+    (): SessionStorefrontSDK$1;
+    (cookieStore: NextCookieStore): SessionStorefrontSDK$1;
+  };
 };
 /**
- * Creates a configured storefront function that works universally across all Next.js contexts
+ * Creates a configured storefront factory for Next.js.
  *
  * Usage:
  * ```typescript
@@ -21,22 +29,13 @@ type NextCookieStore = {
  *
  * export const storefront = createStorefront({
  *   debug: true,
- *   logger: (msg, ...args) => console.log('[DEBUG]', msg, ...args)
+ *   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
+ * @param config Optional configuration for advanced options
+ * @returns A storefront factory with explicit public and session accessors
  */
-declare function createStorefront(config?: StorefrontRuntimeConfig): {
-  (): StorefrontSDK$1;
-  (cookieStore: NextCookieStore): StorefrontSDK$1;
-  (options: {
-    isRootLayout: true;
-  }): StorefrontSDK$1;
-  (cookieStore: NextCookieStore, options: {
-    isRootLayout?: boolean;
-  }): StorefrontSDK$1;
-};
+declare function createStorefront(config?: StorefrontRuntimeConfig): NextJSStorefront;
 //#endregion
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, type StorefrontRuntimeConfig, StorefrontSDK, createStorefront };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSStorefront, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient, type StorefrontRuntimeConfig, createStorefront };

package/dist/index.mjs

@@ -1,9 +1,9 @@
-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";
+import { i as setGlobalStorefrontConfig, n as getSessionStorefrontSDK, t as getPublicStorefrontSDK } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient } from "@commercengine/storefront-sdk";
 
 //#region src/storefront.ts
 /**
-* Creates a configured storefront function that works universally across all Next.js contexts
+* Creates a configured storefront factory for Next.js.
 *
 * Usage:
 * ```typescript
@@ -12,45 +12,23 @@ import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieToken
 *
 * export const storefront = createStorefront({
 *   debug: true,
-*   logger: (msg, ...args) => console.log('[DEBUG]', msg, ...args)
+*   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
+* @param config Optional configuration for advanced options
+* @returns A storefront factory with explicit public and session accessors
 */
 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"));
+	function session(cookieStore) {
+		return cookieStore ? getSessionStorefrontSDK(cookieStore) : getSessionStorefrontSDK();
 	}
-	return storefront;
+	return {
+		public: () => getPublicStorefrontSDK(),
+		session
+	};
 }
 
 //#endregion
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, createStorefront };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient, createStorefront };

package/dist/manager.d.mts

@@ -1,4 +1,4 @@
-import { DebugLoggerFn, Environment, StorefrontSDK, StorefrontSDKOptions, SupportedDefaultHeaders, TokenStorage } from "@commercengine/storefront-sdk";
+import { DebugLoggerFn, Environment, PublicStorefrontSDK, SessionStorefrontSDK, SessionStorefrontSDKOptions, SupportedDefaultHeaders, TokenStorage } from "@commercengine/storefront-sdk";
 import { SSRTokenStorageOptions, ServerTokenStorage } from "@commercengine/ssr-utils";
 
 //#region src/client-storage.d.ts
@@ -73,15 +73,15 @@ declare class ServerTokenStorage$1 extends ServerTokenStorage {
 /**
  * Configuration for the NextJS SDK wrapper
  */
-interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
+interface NextJSSDKConfig extends Omit<SessionStorefrontSDKOptions, "tokenStorage"> {
   /**
    * Token storage configuration options
    */
   tokenStorageOptions?: NextJSTokenStorageOptions$1;
 }
 /**
- * Runtime configuration overrides that can be passed to storefront() function
- * These override environment variables for that specific request
+ * Runtime configuration overrides that can be passed to `createStorefront()`
+ * These override environment variables for that specific app instance.
  */
 interface StorefrontRuntimeConfig {
   /**
@@ -108,19 +108,24 @@ interface StorefrontRuntimeConfig {
   tokenStorageOptions?: NextJSTokenStorageOptions$1;
 }
 /**
- * Smart SDK getter that automatically detects environment
+ * Get or create the public SDK singleton.
+ *
+ * This SDK is intended for build/prerender-safe public reads and does not
+ * participate in session bootstrap, refresh, or storage writes.
+ */
+declare function getPublicStorefrontSDK(): PublicStorefrontSDK;
+/**
+ * Get or create a session-aware SDK.
  *
  * Usage:
- * - Client-side: getStorefrontSDK()
- * - Server-side with request context: getStorefrontSDK(await cookies())
- * - SSG/ISR (no request context): getStorefrontSDK() (uses memory storage)
+ * - Client-side: `getSessionStorefrontSDK()`
+ * - Server-side with request context: `getSessionStorefrontSDK(cookies())`
  */
-declare function getStorefrontSDK(): StorefrontSDK;
-declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
+declare function getSessionStorefrontSDK(): SessionStorefrontSDK;
+declare function getSessionStorefrontSDK(cookieStore: NextCookieStore): SessionStorefrontSDK;
 /**
- * Initialize the SDK (internal use)
- * This should be called once in your app via StorefrontSDKInitializer
+ * Reset instantiated SDK singletons so they pick up current configuration.
  */
 declare function initializeStorefrontSDK(): void;
 //#endregion
-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 };
+export { initializeStorefrontSDK as a, ServerTokenStorage$1 as c, getSessionStorefrontSDK as i, ClientTokenStorage as l, StorefrontRuntimeConfig as n, NextCookieStore as o, getPublicStorefrontSDK as r, NextJSTokenStorageOptions as s, NextJSSDKConfig as t, NextJSTokenStorageOptions$1 as u };

package/dist/manager.mjs

@@ -1,6 +1,6 @@
 import { cache } from "react";
-import { Environment, MemoryTokenStorage, StorefrontSDK } from "@commercengine/storefront-sdk";
-import { BuildCachingTokenStorage, ServerTokenStorage, isBuildContext } from "@commercengine/ssr-utils";
+import { Environment, PublicStorefrontSDK, SessionStorefrontSDK } from "@commercengine/storefront-sdk";
+import { ServerTokenStorage } from "@commercengine/ssr-utils";
 
 //#region src/client-storage.ts
 /**
@@ -110,19 +110,19 @@ var ServerTokenStorage$1 = class extends ServerTokenStorage {
 //#region src/manager.ts
 /**
 * Global runtime configuration storage
-* This gets bundled into both client and server bundles
+* This gets bundled into both client and server bundles.
 */
 let globalStorefrontConfig = null;
 /**
-* Client-side SDK singleton (only lives in browser)
+* Client-side session SDK singleton (only lives in browser)
 */
-let clientSDK = null;
+let clientSessionSDK = null;
 /**
-* Memory-based SDK for SSG/build contexts (no request isolation needed)
+* Public SDK singleton shared by non-session reads
 */
-let buildTimeSDK = null;
+let publicSDK = null;
 /**
-* Get configuration from environment variables merged with global config
+* Get configuration from environment variables merged with global config.
 * Precedence order: environment variables < global config
 */
 function getConfig() {
@@ -144,7 +144,7 @@ function getConfig() {
 		...envDefaultHeaders,
 		...globalStorefrontConfig?.defaultHeaders
 	};
-	if (!storeId || !apiKey) throw new Error(`StorefrontSDK configuration missing! Please set the following environment variables:
+	if (!storeId || !apiKey) throw new Error(`Storefront SDK configuration missing! Please set the following environment variables:
 
 NEXT_PUBLIC_STORE_ID=your-store-id
 NEXT_PUBLIC_API_KEY=your-api-key
@@ -174,69 +174,86 @@ These variables are required for both client and server contexts to work.`);
 	if (tokenStorageOptions) config.tokenStorageOptions = tokenStorageOptions;
 	return config;
 }
-/**
-* 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$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
+function buildPublicSDKConfig(config) {
+	const publicConfig = {
+		storeId: config.storeId,
+		apiKey: config.apiKey,
+		environment: config.environment
+	};
+	if (config.baseUrl) publicConfig.baseUrl = config.baseUrl;
+	if (config.timeout) publicConfig.timeout = config.timeout;
+	if (config.debug) publicConfig.debug = config.debug;
+	if (config.logger) publicConfig.logger = config.logger;
+	if (config.defaultHeaders) publicConfig.defaultHeaders = config.defaultHeaders;
+	return publicConfig;
+}
+function createClientSessionSDK(config) {
+	return new SessionStorefrontSDK({
+		...config,
+		tokenStorage: new ClientTokenStorage(config.tokenStorageOptions)
 	});
-	return new MemoryTokenStorage();
 }
-/**
-* Request-scoped server SDK factory using React cache
-*/
-const getServerSDKCached = cache((cookieStore) => {
-	const config = getConfig();
-	return new StorefrontSDK({
+function createServerSessionSDK(cookieStore, config) {
+	return new SessionStorefrontSDK({
 		...config,
-		tokenStorage: createTokenStorage(cookieStore, config.tokenStorageOptions, config)
+		tokenStorage: new ServerTokenStorage$1(cookieStore, config.tokenStorageOptions)
 	});
+}
+/**
+* Request-scoped server session SDK factory using React cache
+*/
+const getServerSessionSDKCached = cache((cookieStore) => {
+	return createServerSessionSDK(cookieStore, getConfig());
 });
 /**
-* Get or create build-time SDK singleton
+* Get or create the public SDK singleton.
+*
+* This SDK is intended for build/prerender-safe public reads and does not
+* participate in session bootstrap, refresh, or storage writes.
 */
-function getBuildTimeSDK() {
+function getPublicStorefrontSDK() {
 	const config = getConfig();
-	if (!buildTimeSDK) buildTimeSDK = new StorefrontSDK({
-		...config,
-		tokenStorage: createTokenStorage(void 0, config.tokenStorageOptions, config)
-	});
-	return buildTimeSDK;
+	if (!publicSDK) publicSDK = new PublicStorefrontSDK(buildPublicSDKConfig(config));
+	return publicSDK;
 }
-function getStorefrontSDK(cookieStore) {
+function getSessionStorefrontSDK(cookieStore) {
 	if (typeof window !== "undefined") {
 		if (cookieStore) console.warn("Cookie store passed in client environment - this will be ignored");
 		const config = getConfig();
-		if (!clientSDK) clientSDK = new StorefrontSDK({
-			...config,
-			tokenStorage: createTokenStorage(void 0, config.tokenStorageOptions, config)
-		});
-		return clientSDK;
+		if (!clientSessionSDK) clientSessionSDK = createClientSessionSDK(config);
+		return clientSessionSDK;
 	}
-	if (cookieStore) return getServerSDKCached(cookieStore);
-	return getBuildTimeSDK();
+	if (cookieStore) return getServerSessionSDKCached(cookieStore);
+	throw new Error([
+		"🚨 Server session access requires cookies!",
+		"",
+		"You're calling the session SDK on the server without cookies.",
+		"",
+		"✅ Correct usage for user/session-aware requests:",
+		"  import { cookies } from 'next/headers'",
+		"  const sdk = storefront.session(cookies())",
+		"",
+		"✅ Correct usage for build/prerender-safe public reads:",
+		"  const sdk = storefront.public()",
+		"",
+		"This keeps public rendering separate from real user session continuity."
+	].join("\n"));
 }
 /**
-* Set global storefront configuration that applies to all SDK instances
-* This gets bundled into both client and server contexts automatically
+* Set global storefront configuration that applies to all SDK instances.
 */
 function setGlobalStorefrontConfig(config) {
 	globalStorefrontConfig = config;
-	clientSDK = null;
-	buildTimeSDK = null;
+	clientSessionSDK = null;
+	publicSDK = null;
 }
 /**
-* Initialize the SDK (internal use)
-* This should be called once in your app via StorefrontSDKInitializer
+* Reset instantiated SDK singletons so they pick up current configuration.
 */
 function initializeStorefrontSDK() {
-	clientSDK = null;
-	buildTimeSDK = null;
+	clientSessionSDK = null;
+	publicSDK = null;
 }
 
 //#endregion
-export { ClientTokenStorage as a, ServerTokenStorage$1 as i, initializeStorefrontSDK as n, setGlobalStorefrontConfig as r, getStorefrontSDK as t };
+export { ServerTokenStorage$1 as a, setGlobalStorefrontConfig as i, getSessionStorefrontSDK as n, ClientTokenStorage as o, initializeStorefrontSDK as r, getPublicStorefrontSDK as t };

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-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";
+import { a as initializeStorefrontSDK, c as ServerTokenStorage, i as getSessionStorefrontSDK, r as getPublicStorefrontSDK, s as NextJSTokenStorageOptions, t as NextJSSDKConfig } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient } from "@commercengine/storefront-sdk";
 export * from "@commercengine/storefront-sdk";
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, PaymentsClient, ResponseUtils, ServerTokenStorage, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, ServerTokenStorage, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient, getPublicStorefrontSDK, getSessionStorefrontSDK, initializeStorefrontSDK };

package/dist/server.mjs

@@ -1,6 +1,6 @@
-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";
+import { a as ServerTokenStorage, n as getSessionStorefrontSDK, r as initializeStorefrontSDK, t as getPublicStorefrontSDK } from "./manager.mjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient } from "@commercengine/storefront-sdk";
 
 export * from "@commercengine/storefront-sdk"
 
-export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, ResponseUtils, ServerTokenStorage, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, PaymentsClient, PublicCatalogClient, PublicHelpersClient, PublicStoreConfigClient, PublicStorefrontAPIClient, PublicStorefrontSDK, ResponseUtils, ServerTokenStorage, SessionStorefrontAPIClient, SessionStorefrontSDK, StoreConfigClient, getPublicStorefrontSDK, getSessionStorefrontSDK, initializeStorefrontSDK };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercengine/storefront-sdk-nextjs",
-  "version": "0.2.10",
+  "version": "0.3.1",
   "description": "Next.js wrapper for the Commerce Engine Storefront SDK",
   "type": "module",
   "main": "dist/index.mjs",
@@ -25,7 +25,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "MIGRATION.md"
   ],
   "keywords": [
     "commerce engine",
@@ -43,8 +44,8 @@
     "react-dom": ">=19.0.0"
   },
   "dependencies": {
-    "@commercengine/storefront-sdk": "0.13.4",
-    "@commercengine/ssr-utils": "0.1.0"
+    "@commercengine/storefront-sdk": "0.14.1",
+    "@commercengine/ssr-utils": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^24.10.4",