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

package/dist/sdk-manager-NWADjRFW.cjs

@@ -0,0 +1,400 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const react = __toESM(require("react"));
+const __commercengine_storefront_sdk = __toESM(require("@commercengine/storefront-sdk"));
+
+//#region src/token-storage.ts
+/**
+* Client-side token storage that uses document.cookie
+*/
+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 || 720 * 60 * 60,
+			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;
+	}
+};
+/**
+* Server-side token storage that uses Next.js cookies API
+*/
+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 || 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);
+		}
+	}
+};
+
+//#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;
+/**
+* Memory token storage that reuses tokens across the build process
+* via an in-process cache. Only used during SSG/ISR builds.
+*/
+var BuildCachingMemoryTokenStorage = class {
+	constructor(cacheKey, ttlSeconds = DEFAULT_TTL_SECONDS) {
+		this.cacheKey = cacheKey;
+		this.ttlSeconds = ttlSeconds;
+		this.access = null;
+		this.refresh = null;
+	}
+	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
+/**
+* Get configuration from environment variables merged with global config
+* Precedence order: environment variables < global config
+*/
+function getConfig() {
+	const envStoreId = process.env.NEXT_PUBLIC_STORE_ID;
+	const envApiKey = process.env.NEXT_PUBLIC_API_KEY;
+	const envEnvironment = process.env.NEXT_PUBLIC_ENVIRONMENT;
+	const envBaseUrl = process.env.NEXT_PUBLIC_API_BASE_URL;
+	const envTimeout = process.env.NEXT_PUBLIC_API_TIMEOUT ? parseInt(process.env.NEXT_PUBLIC_API_TIMEOUT, 10) : void 0;
+	const envDebug = process.env.NEXT_PUBLIC_DEBUG_MODE === "true";
+	const envDefaultHeaders = {};
+	if (process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_GROUP_ID) envDefaultHeaders.customer_group_id = process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_GROUP_ID;
+	const storeId = globalStorefrontConfig?.storeId || envStoreId;
+	const apiKey = globalStorefrontConfig?.apiKey || envApiKey;
+	const environment = globalStorefrontConfig?.environment || (envEnvironment === "production" ? __commercengine_storefront_sdk.Environment.Production : __commercengine_storefront_sdk.Environment.Staging);
+	const baseUrl = globalStorefrontConfig?.baseUrl || envBaseUrl;
+	const timeout = globalStorefrontConfig?.timeout || envTimeout;
+	const debug = globalStorefrontConfig?.debug !== void 0 ? globalStorefrontConfig.debug : envDebug;
+	const defaultHeaders = {
+		...envDefaultHeaders,
+		...globalStorefrontConfig?.defaultHeaders
+	};
+	if (!storeId || !apiKey) throw new Error(`StorefrontSDK configuration missing! Please set the following environment variables:
+
+NEXT_PUBLIC_STORE_ID=your-store-id
+NEXT_PUBLIC_API_KEY=your-api-key
+NEXT_PUBLIC_ENVIRONMENT=staging (or production)
+
+These variables are required for both client and server contexts to work.`);
+	const config = {
+		storeId,
+		apiKey,
+		environment
+	};
+	if (baseUrl) config.baseUrl = baseUrl;
+	if (timeout) config.timeout = timeout;
+	if (debug) config.debug = debug;
+	const logger = globalStorefrontConfig?.logger;
+	const accessToken = globalStorefrontConfig?.accessToken;
+	const refreshToken = globalStorefrontConfig?.refreshToken;
+	const onTokensUpdated = globalStorefrontConfig?.onTokensUpdated;
+	const onTokensCleared = globalStorefrontConfig?.onTokensCleared;
+	const tokenStorageOptions = globalStorefrontConfig?.tokenStorageOptions;
+	if (logger) config.logger = logger;
+	if (accessToken) config.accessToken = accessToken;
+	if (refreshToken) config.refreshToken = refreshToken;
+	if (onTokensUpdated) config.onTokensUpdated = onTokensUpdated;
+	if (onTokensCleared) config.onTokensCleared = onTokensCleared;
+	if (Object.keys(defaultHeaders).length > 0) config.defaultHeaders = defaultHeaders;
+	if (tokenStorageOptions) config.tokenStorageOptions = tokenStorageOptions;
+	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);
+	const shouldCache = process.env.NEXT_BUILD_CACHE_TOKENS === "true";
+	if (shouldCache && config) {
+		const cacheKey = `${config.storeId}:${config.environment || "production"}`;
+		return new BuildCachingMemoryTokenStorage(cacheKey);
+	}
+	return new __commercengine_storefront_sdk.MemoryTokenStorage();
+}
+/**
+* Request-scoped server SDK factory using React cache
+*/
+const getServerSDKCached = (0, react.cache)((cookieStore) => {
+	const config = getConfig();
+	return new __commercengine_storefront_sdk.StorefrontSDK({
+		...config,
+		tokenStorage: createTokenStorage(cookieStore, config.tokenStorageOptions, config)
+	});
+});
+/**
+* Memory-based SDK for SSG/build contexts (no request isolation needed)
+*/
+let buildTimeSDK = null;
+function getBuildTimeSDK() {
+	const config = getConfig();
+	if (!buildTimeSDK) buildTimeSDK = new __commercengine_storefront_sdk.StorefrontSDK({
+		...config,
+		tokenStorage: createTokenStorage(void 0, config.tokenStorageOptions, config)
+	});
+	return buildTimeSDK;
+}
+function getStorefrontSDK(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 __commercengine_storefront_sdk.StorefrontSDK({
+			...config,
+			tokenStorage: createTokenStorage(void 0, config.tokenStorageOptions, config)
+		});
+		return clientSDK;
+	}
+	if (cookieStore) return getServerSDKCached(cookieStore);
+	return getBuildTimeSDK();
+}
+/**
+* Set global storefront configuration that applies to all SDK instances
+* This gets bundled into both client and server contexts automatically
+*/
+function setGlobalStorefrontConfig(config) {
+	globalStorefrontConfig = config;
+	clientSDK = null;
+	buildTimeSDK = null;
+}
+/**
+* Initialize the SDK (internal use)
+* This should be called once in your app via StorefrontSDKInitializer
+*/
+function initializeStorefrontSDK() {
+	clientSDK = null;
+	buildTimeSDK = null;
+}
+
+//#endregion
+Object.defineProperty(exports, 'ClientTokenStorage', {
+  enumerable: true,
+  get: function () {
+    return ClientTokenStorage;
+  }
+});
+Object.defineProperty(exports, 'ServerTokenStorage', {
+  enumerable: true,
+  get: function () {
+    return ServerTokenStorage;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
+Object.defineProperty(exports, 'getStorefrontSDK', {
+  enumerable: true,
+  get: function () {
+    return getStorefrontSDK;
+  }
+});
+Object.defineProperty(exports, 'initializeStorefrontSDK', {
+  enumerable: true,
+  get: function () {
+    return initializeStorefrontSDK;
+  }
+});
+Object.defineProperty(exports, 'setGlobalStorefrontConfig', {
+  enumerable: true,
+  get: function () {
+    return setGlobalStorefrontConfig;
+  }
+});

package/dist/server.cjs

@@ -0,0 +1,102 @@
+const require_sdk_manager = require('./sdk-manager-NWADjRFW.cjs');
+const __commercengine_storefront_sdk = require_sdk_manager.__toESM(require("@commercengine/storefront-sdk"));
+
+Object.defineProperty(exports, 'AuthClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.AuthClient;
+  }
+});
+Object.defineProperty(exports, 'BrowserTokenStorage', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.BrowserTokenStorage;
+  }
+});
+Object.defineProperty(exports, 'CartClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.CartClient;
+  }
+});
+Object.defineProperty(exports, 'CatalogClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.CatalogClient;
+  }
+});
+Object.defineProperty(exports, 'CookieTokenStorage', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.CookieTokenStorage;
+  }
+});
+Object.defineProperty(exports, 'CustomerClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.CustomerClient;
+  }
+});
+Object.defineProperty(exports, 'Environment', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.Environment;
+  }
+});
+Object.defineProperty(exports, 'HelpersClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.HelpersClient;
+  }
+});
+Object.defineProperty(exports, 'MemoryTokenStorage', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.MemoryTokenStorage;
+  }
+});
+Object.defineProperty(exports, 'OrderClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.OrderClient;
+  }
+});
+Object.defineProperty(exports, 'ResponseUtils', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.ResponseUtils;
+  }
+});
+exports.ServerTokenStorage = require_sdk_manager.ServerTokenStorage;
+Object.defineProperty(exports, 'ShippingClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.ShippingClient;
+  }
+});
+Object.defineProperty(exports, 'StoreConfigClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.StoreConfigClient;
+  }
+});
+Object.defineProperty(exports, 'StorefrontAPIClient', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.StorefrontAPIClient;
+  }
+});
+Object.defineProperty(exports, 'StorefrontSDK', {
+  enumerable: true,
+  get: function () {
+    return __commercengine_storefront_sdk.StorefrontSDK;
+  }
+});
+exports.getStorefrontSDK = require_sdk_manager.getStorefrontSDK;
+exports.initializeStorefrontSDK = require_sdk_manager.initializeStorefrontSDK;
+Object.keys(__commercengine_storefront_sdk).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return __commercengine_storefront_sdk[k]; }
+  });
+});

package/dist/server.d.cts

@@ -0,0 +1,4 @@
+import { NextJSSDKConfig, NextJSTokenStorageOptions, ServerTokenStorage, getStorefrontSDK, initializeStorefrontSDK } from "./sdk-manager-D2ktqPrp.cjs";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, 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 };

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { NextJSSDKConfig, NextJSTokenStorageOptions, ServerTokenStorage, getStorefrontSDK, initializeStorefrontSDK } from "./sdk-manager-B9xDQQuv.js";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, 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 };

package/dist/server.js

@@ -0,0 +1,6 @@
+import { ServerTokenStorage, getStorefrontSDK, initializeStorefrontSDK } 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";
+
+export * from "@commercengine/storefront-sdk"
+
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ServerTokenStorage, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, getStorefrontSDK, initializeStorefrontSDK };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercengine/storefront-sdk-nextjs",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0",
   "description": "Next.js wrapper for the Commerce Engine Storefront SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
     }
   },
   "files": [
@@ -27,28 +37,28 @@
   "author": "Commerce Engine",
   "license": "All rights reserved",
   "peerDependencies": {
-    "next": ">=13.0.0",
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "next": ">=15.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
   },
   "dependencies": {
-    "@commercengine/storefront-sdk": "0.8.0"
+    "@commercengine/storefront-sdk": "0.8.1"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "@types/react": "^18.0.0",
-    "next": ">=13.0.0",
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
+    "@types/react": "^19.0.0",
+    "next": ">=15.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0",
     "rimraf": "^6.0.1",
-    "tsup": "^8.5.0",
+    "tsdown": "^0.14.2",
     "typescript": "^5.9.2"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsdown",
     "clean": "rimraf dist"
   }
 }