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

package/dist/sdk-manager-CdgrfSVp.js

@@ -0,0 +1,343 @@
+import { cache } from "react";
+import { Environment, MemoryTokenStorage, StorefrontSDK } from "@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" ? Environment.Production : 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 MemoryTokenStorage();
+}
+/**
+* Request-scoped server SDK factory using React cache
+*/
+const getServerSDKCached = cache((cookieStore) => {
+	const config = getConfig();
+	return new 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 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 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
+export { ClientTokenStorage, ServerTokenStorage, getStorefrontSDK, initializeStorefrontSDK, setGlobalStorefrontConfig };
+//# sourceMappingURL=sdk-manager-CdgrfSVp.js.map

package/dist/sdk-manager-CdgrfSVp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-manager-CdgrfSVp.js","names":["cacheKey: string","envDefaultHeaders: SupportedDefaultHeaders","defaultHeaders: SupportedDefaultHeaders","config: NextJSSDKConfig","globalStorefrontConfig: StorefrontRuntimeConfig | null","clientSDK: StorefrontSDK | null","buildTimeSDK: StorefrontSDK | null"],"sources":["../src/token-storage.ts","../src/build-token-cache.ts","../src/build-caching-memory-storage.ts","../src/sdk-manager.ts"],"sourcesContent":["import type { TokenStorage } from '@commercengine/storefront-sdk';\n\n/**\n * Configuration options for NextJSTokenStorage\n */\nexport interface NextJSTokenStorageOptions {\n  /**\n   * Prefix for cookie names (default: \"ce_\")\n   */\n  prefix?: string;\n\n  /**\n   * Maximum age of cookies in seconds (default: 30 days)\n   */\n  maxAge?: number;\n\n  /**\n   * Cookie path (default: \"/\")\n   */\n  path?: string;\n\n  /**\n   * Cookie domain (default: current domain)\n   */\n  domain?: string;\n\n  /**\n   * Whether cookies should be secure (default: auto-detect based on environment)\n   */\n  secure?: boolean;\n\n  /**\n   * SameSite cookie attribute (default: \"Lax\")\n   */\n  sameSite?: \"Strict\" | \"Lax\" | \"None\";\n}\n\n/**\n * Internal cookie options interface\n */\ninterface CookieOptions {\n  maxAge?: number;\n  path?: string;\n  domain?: string;\n  secure?: boolean;\n  sameSite?: \"Strict\" | \"Lax\" | \"None\";\n}\n\n/**\n * Client-side token storage that uses document.cookie\n */\nexport class ClientTokenStorage implements TokenStorage {\n  private accessTokenKey: string;\n  private refreshTokenKey: string;\n  private options: CookieOptions;\n\n  constructor(options: NextJSTokenStorageOptions = {}) {\n    const prefix = options.prefix || \"ce_\";\n    this.accessTokenKey = `${prefix}access_token`;\n    this.refreshTokenKey = `${prefix}refresh_token`;\n\n    this.options = {\n      maxAge: options.maxAge || 30 * 24 * 60 * 60, // 30 days default\n      path: options.path || \"/\",\n      domain: options.domain,\n      secure: options.secure ?? (typeof window !== \"undefined\" && window.location?.protocol === \"https:\"),\n      sameSite: options.sameSite || \"Lax\",\n    };\n  }\n\n  async getAccessToken(): Promise<string | null> {\n    return this.getCookie(this.accessTokenKey);\n  }\n\n  async setAccessToken(token: string): Promise<void> {\n    this.setCookie(this.accessTokenKey, token);\n  }\n\n  async getRefreshToken(): Promise<string | null> {\n    return this.getCookie(this.refreshTokenKey);\n  }\n\n  async setRefreshToken(token: string): Promise<void> {\n    this.setCookie(this.refreshTokenKey, token);\n  }\n\n  async clearTokens(): Promise<void> {\n    this.deleteCookie(this.accessTokenKey);\n    this.deleteCookie(this.refreshTokenKey);\n  }\n\n  private getCookie(name: string): string | null {\n    if (typeof document === \"undefined\") return null;\n\n    const value = `; ${document.cookie}`;\n    const parts = value.split(`; ${name}=`);\n\n    if (parts.length === 2) {\n      const cookieValue = parts.pop()?.split(\";\").shift();\n      return cookieValue ? decodeURIComponent(cookieValue) : null;\n    }\n\n    return null;\n  }\n\n  private setCookie(name: string, value: string): void {\n    if (typeof document === \"undefined\") return;\n\n    const encodedValue = encodeURIComponent(value);\n    let cookieString = `${name}=${encodedValue}`;\n\n    if (this.options.maxAge) {\n      cookieString += `; Max-Age=${this.options.maxAge}`;\n    }\n\n    if (this.options.path) {\n      cookieString += `; Path=${this.options.path}`;\n    }\n\n    if (this.options.domain) {\n      cookieString += `; Domain=${this.options.domain}`;\n    }\n\n    if (this.options.secure) {\n      cookieString += `; Secure`;\n    }\n\n    if (this.options.sameSite) {\n      cookieString += `; SameSite=${this.options.sameSite}`;\n    }\n\n    document.cookie = cookieString;\n  }\n\n  private deleteCookie(name: string): void {\n    if (typeof document === \"undefined\") return;\n\n    let cookieString = `${name}=; Max-Age=0`;\n\n    if (this.options.path) {\n      cookieString += `; Path=${this.options.path}`;\n    }\n\n    if (this.options.domain) {\n      cookieString += `; Domain=${this.options.domain}`;\n    }\n\n    document.cookie = cookieString;\n  }\n}\n\n// Type for Next.js cookies\ntype NextCookieStore = {\n  get: (name: string) => { value: string } | undefined;\n  set: (name: string, value: string, options?: any) => void;\n  delete: (name: string) => void;\n};\n\n/**\n * Server-side token storage that uses Next.js cookies API\n */\nexport class ServerTokenStorage implements TokenStorage {\n  private accessTokenKey: string;\n  private refreshTokenKey: string;\n  private options: CookieOptions;\n  private cookieStore: NextCookieStore;\n\n  constructor(cookieStore: NextCookieStore, options: NextJSTokenStorageOptions = {}) {\n    const prefix = options.prefix || \"ce_\";\n    this.accessTokenKey = `${prefix}access_token`;\n    this.refreshTokenKey = `${prefix}refresh_token`;\n    this.cookieStore = cookieStore;\n\n    this.options = {\n      maxAge: options.maxAge || 30 * 24 * 60 * 60, // 30 days default\n      path: options.path || \"/\",\n      domain: options.domain,\n      secure: options.secure ?? process.env.NODE_ENV === \"production\",\n      sameSite: options.sameSite || \"Lax\",\n    };\n  }\n\n  async getAccessToken(): Promise<string | null> {\n    try {\n      return this.cookieStore.get(this.accessTokenKey)?.value || null;\n    } catch (error) {\n      console.warn(`Could not get access token from server cookies:`, error);\n      return null;\n    }\n  }\n\n  async setAccessToken(token: string): Promise<void> {\n    try {\n      this.cookieStore.set(this.accessTokenKey, token, {\n        maxAge: this.options.maxAge,\n        path: this.options.path,\n        domain: this.options.domain,\n        secure: this.options.secure,\n        sameSite: this.options.sameSite?.toLowerCase() as \"strict\" | \"lax\" | \"none\",\n        httpOnly: false, // Allow client-side access for SDK flexibility\n      });\n    } catch (error) {\n      console.warn(`Could not set access token on server:`, error);\n    }\n  }\n\n  async getRefreshToken(): Promise<string | null> {\n    try {\n      return this.cookieStore.get(this.refreshTokenKey)?.value || null;\n    } catch (error) {\n      console.warn(`Could not get refresh token from server cookies:`, error);\n      return null;\n    }\n  }\n\n  async setRefreshToken(token: string): Promise<void> {\n    try {\n      this.cookieStore.set(this.refreshTokenKey, token, {\n        maxAge: this.options.maxAge,\n        path: this.options.path,\n        domain: this.options.domain,\n        secure: this.options.secure,\n        sameSite: this.options.sameSite?.toLowerCase() as \"strict\" | \"lax\" | \"none\",\n        httpOnly: false, // Allow client-side access for SDK flexibility\n      });\n    } catch (error) {\n      console.warn(`Could not set refresh token on server:`, error);\n    }\n  }\n\n  async clearTokens(): Promise<void> {\n    try {\n      this.cookieStore.delete(this.accessTokenKey);\n      this.cookieStore.delete(this.refreshTokenKey);\n    } catch (error) {\n      console.warn(`Could not clear tokens on server:`, error);\n    }\n  }\n}","/**\n * In-process token cache for build-time optimization\n * Only active during SSG/ISR when no request context exists\n */\n\ntype CachedToken = {\n  accessToken: string;\n  refreshToken?: string | null;\n  expiresAt?: number; // epoch ms\n};\n\nconst store = new Map<string, CachedToken>();\n\nfunction isExpired(token: CachedToken | undefined): boolean {\n  if (!token) return true;\n  if (!token.expiresAt) return false; // No expiration info, assume valid\n  return Date.now() > token.expiresAt - 30_000; // Refresh 30s early\n}\n\nexport function getCachedToken(key: string): CachedToken | null {\n  const token = store.get(key);\n  return isExpired(token) ? null : (token as CachedToken);\n}\n\nexport function setCachedToken(\n  key: string, \n  token: Omit<CachedToken, 'expiresAt'> & { ttlSeconds?: number }\n): void {\n  const expiresAt = token.ttlSeconds != null \n    ? Date.now() + token.ttlSeconds * 1000 \n    : undefined;\n    \n  store.set(key, {\n    accessToken: token.accessToken,\n    refreshToken: token.refreshToken ?? null,\n    expiresAt,\n  });\n}\n\nexport function clearCachedToken(key: string): void {\n  store.delete(key);\n}\n\nexport function getCacheStats() {\n  return {\n    size: store.size,\n    keys: Array.from(store.keys()),\n  };\n}","import type { TokenStorage } from \"@commercengine/storefront-sdk\";\nimport { getCachedToken, setCachedToken, clearCachedToken } from \"./build-token-cache\";\n\n// Fallback TTL if the SDK doesn't expose expires_in; keep it short to avoid staleness\nconst DEFAULT_TTL_SECONDS = 5 * 60; // 5 minutes\n\n/**\n * Memory token storage that reuses tokens across the build process\n * via an in-process cache. Only used during SSG/ISR builds.\n */\nexport class BuildCachingMemoryTokenStorage implements TokenStorage {\n  private access: string | null = null;\n  private refresh: string | null = null;\n\n  constructor(\n    private cacheKey: string, \n    private ttlSeconds = DEFAULT_TTL_SECONDS\n  ) {}\n\n  async getAccessToken(): Promise<string | null> {\n    if (this.access) {\n      return this.access;\n    }\n    \n    const cached = getCachedToken(this.cacheKey);\n    if (cached?.accessToken) {\n      this.access = cached.accessToken;\n      this.refresh = cached.refreshToken ?? null;\n      return this.access;\n    }\n    \n    return null;\n  }\n\n  async setAccessToken(token: string): Promise<void> {\n    this.access = token;\n    setCachedToken(this.cacheKey, {\n      accessToken: token,\n      refreshToken: this.refresh,\n      ttlSeconds: this.ttlSeconds,\n    });\n  }\n\n  async getRefreshToken(): Promise<string | null> {\n    return this.refresh;\n  }\n\n  async setRefreshToken(token: string): Promise<void> {\n    this.refresh = token;\n    setCachedToken(this.cacheKey, {\n      accessToken: this.access ?? \"\",\n      refreshToken: token,\n      ttlSeconds: this.ttlSeconds,\n    });\n  }\n\n  async clearTokens(): Promise<void> {\n    this.access = null;\n    this.refresh = null;\n    clearCachedToken(this.cacheKey);\n  }\n}","import { cache } from \"react\";\nimport {\n  StorefrontSDK,\n  type StorefrontSDKOptions,\n  type SupportedDefaultHeaders,\n  MemoryTokenStorage,\n  Environment,\n  type DebugLoggerFn,\n} from \"@commercengine/storefront-sdk\";\nimport {\n  ClientTokenStorage,\n  ServerTokenStorage,\n  type NextJSTokenStorageOptions,\n} from \"./token-storage\";\nimport { BuildCachingMemoryTokenStorage } from \"./build-caching-memory-storage\";\n\n/**\n * Configuration for the NextJS SDK wrapper\n */\nexport interface NextJSSDKConfig\n  extends Omit<StorefrontSDKOptions, \"tokenStorage\"> {\n  /**\n   * Token storage configuration options\n   */\n  tokenStorageOptions?: NextJSTokenStorageOptions;\n}\n\n/**\n * Runtime configuration overrides that can be passed to storefront() function\n * These override environment variables for that specific request\n */\nexport interface StorefrontRuntimeConfig {\n  /**\n   * Override environment variables\n   */\n  storeId?: string;\n  apiKey?: string;\n  environment?: Environment;\n  baseUrl?: string;\n  timeout?: number;\n  debug?: boolean;\n  \n  /**\n   * Advanced options not available via environment variables\n   */\n  accessToken?: string;\n  refreshToken?: string;\n  defaultHeaders?: SupportedDefaultHeaders;\n  logger?: DebugLoggerFn;\n  onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n  onTokensCleared?: () => void;\n  \n  /**\n   * Token storage configuration\n   */\n  tokenStorageOptions?: NextJSTokenStorageOptions;\n}\n\n\n/**\n * Get configuration from environment variables merged with global config\n * Precedence order: environment variables < global config\n */\nfunction getConfig(): NextJSSDKConfig {\n  // Get environment variables\n  const envStoreId = process.env.NEXT_PUBLIC_STORE_ID;\n  const envApiKey = process.env.NEXT_PUBLIC_API_KEY;\n  const envEnvironment = process.env.NEXT_PUBLIC_ENVIRONMENT;\n  const envBaseUrl = process.env.NEXT_PUBLIC_API_BASE_URL;\n  const envTimeout = process.env.NEXT_PUBLIC_API_TIMEOUT ? parseInt(process.env.NEXT_PUBLIC_API_TIMEOUT, 10) : undefined;\n  const envDebug = process.env.NEXT_PUBLIC_DEBUG_MODE === \"true\";\n  \n  // Environment-based default headers\n  const envDefaultHeaders: SupportedDefaultHeaders = {};\n  if (process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_GROUP_ID) {\n    envDefaultHeaders.customer_group_id = process.env.NEXT_PUBLIC_DEFAULT_CUSTOMER_GROUP_ID;\n  }\n\n  // Merge in order: env vars < global config\n  const storeId = globalStorefrontConfig?.storeId || envStoreId;\n  const apiKey = globalStorefrontConfig?.apiKey || envApiKey;\n  const environment = globalStorefrontConfig?.environment || (envEnvironment === \"production\" ? Environment.Production : Environment.Staging);\n  const baseUrl = globalStorefrontConfig?.baseUrl || envBaseUrl;\n  const timeout = globalStorefrontConfig?.timeout || envTimeout;\n  const debug = globalStorefrontConfig?.debug !== undefined ? globalStorefrontConfig.debug : envDebug;\n  \n  // Merge default headers (global config takes precedence over env vars)\n  const defaultHeaders: SupportedDefaultHeaders = {\n    ...envDefaultHeaders,\n    ...globalStorefrontConfig?.defaultHeaders,\n  };\n\n  // Validate required fields\n  if (!storeId || !apiKey) {\n    throw new Error(\n      `StorefrontSDK configuration missing! Please set the following environment variables:\n\nNEXT_PUBLIC_STORE_ID=your-store-id\nNEXT_PUBLIC_API_KEY=your-api-key\nNEXT_PUBLIC_ENVIRONMENT=staging (or production)\n\nThese variables are required for both client and server contexts to work.`\n    );\n  }\n\n  const config: NextJSSDKConfig = {\n    storeId,\n    apiKey,\n    environment,\n  };\n\n  // Add optional configurations only if they're provided (per-instance takes precedence over global)\n  if (baseUrl) config.baseUrl = baseUrl;\n  if (timeout) config.timeout = timeout;\n  if (debug) config.debug = debug;\n  \n  // Advanced options from global config only\n  const logger = globalStorefrontConfig?.logger;\n  const accessToken = globalStorefrontConfig?.accessToken;\n  const refreshToken = globalStorefrontConfig?.refreshToken;\n  const onTokensUpdated = globalStorefrontConfig?.onTokensUpdated;\n  const onTokensCleared = globalStorefrontConfig?.onTokensCleared;\n  const tokenStorageOptions = globalStorefrontConfig?.tokenStorageOptions;\n  \n  if (logger) config.logger = logger;\n  if (accessToken) config.accessToken = accessToken;\n  if (refreshToken) config.refreshToken = refreshToken;\n  if (onTokensUpdated) config.onTokensUpdated = onTokensUpdated;\n  if (onTokensCleared) config.onTokensCleared = onTokensCleared;\n  if (Object.keys(defaultHeaders).length > 0) config.defaultHeaders = defaultHeaders;\n  if (tokenStorageOptions) config.tokenStorageOptions = tokenStorageOptions;\n\n  return config;\n}\n\n/**\n * Global runtime configuration storage\n * This gets bundled into both client and server bundles\n */\nlet globalStorefrontConfig: StorefrontRuntimeConfig | null = null;\n\n/**\n * Client-side SDK singleton (only lives in browser)\n */\nlet clientSDK: StorefrontSDK | null = null;\n\n\n/**\n * Create appropriate token storage based on environment\n */\nfunction createTokenStorage(\n  cookieStore?: NextCookieStore,\n  options?: NextJSTokenStorageOptions,\n  config?: NextJSSDKConfig\n) {\n  if (typeof window !== \"undefined\") {\n    // Client-side: use document.cookie\n    return new ClientTokenStorage(options);\n  }\n\n  if (cookieStore) {\n    // Server-side with request context: use Next.js cookies\n    return new ServerTokenStorage(cookieStore, options);\n  }\n\n  // Server-side without request context (SSG/ISR): use memory storage with optional caching\n  const shouldCache = process.env.NEXT_BUILD_CACHE_TOKENS === \"true\";\n\n  if (shouldCache && config) {\n    // Create cache key from store ID and environment\n    const cacheKey = `${config.storeId}:${config.environment || \"production\"}`;\n    return new BuildCachingMemoryTokenStorage(cacheKey);\n  }\n\n  return new MemoryTokenStorage();\n}\n\n/**\n * Request-scoped server SDK factory using React cache\n */\nconst getServerSDKCached = cache((cookieStore: NextCookieStore) => {\n  const config = getConfig();\n\n  return new StorefrontSDK({\n    ...config,\n    tokenStorage: createTokenStorage(\n      cookieStore,\n      config.tokenStorageOptions,\n      config\n    ),\n  });\n});\n\n/**\n * Memory-based SDK for SSG/build contexts (no request isolation needed)\n */\nlet buildTimeSDK: StorefrontSDK | null = null;\n\nfunction getBuildTimeSDK(): StorefrontSDK {\n  const config = getConfig();\n\n  // Use the cached instance\n  if (!buildTimeSDK) {\n    buildTimeSDK = new StorefrontSDK({\n      ...config,\n      tokenStorage: createTokenStorage(\n        undefined,\n        config.tokenStorageOptions,\n        config\n      ),\n    });\n  }\n\n  return buildTimeSDK;\n}\n\n// Type for Next.js cookies (more specific than 'any')\ntype NextCookieStore = {\n  get: (name: string) => { value: string } | undefined;\n  set: (name: string, value: string, options?: any) => void;\n  delete: (name: string) => void;\n};\n\n/**\n * Smart SDK getter that automatically detects environment\n *\n * Usage:\n * - Client-side: getStorefrontSDK()\n * - Server-side with request context: getStorefrontSDK(await cookies())\n * - SSG/ISR (no request context): getStorefrontSDK() (uses memory storage)\n */\nexport function getStorefrontSDK(): StorefrontSDK;\nexport function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;\nexport function getStorefrontSDK(cookieStore?: NextCookieStore): StorefrontSDK {\n  // Client-side: return client SDK singleton or per-request instance\n  if (typeof window !== \"undefined\") {\n    if (cookieStore) {\n      console.warn(\n        \"Cookie store passed in client environment - this will be ignored\"\n      );\n    }\n\n    const config = getConfig();\n\n    // Use the singleton\n    if (!clientSDK) {\n      clientSDK = new StorefrontSDK({\n        ...config,\n        tokenStorage: createTokenStorage(\n          undefined,\n          config.tokenStorageOptions,\n          config\n        ),\n      });\n    }\n\n    return clientSDK;\n  }\n\n  // Server-side with explicit cookie store: use request-scoped instance\n  if (cookieStore) {\n    return getServerSDKCached(cookieStore);\n  }\n\n  // Server-side without cookies: Use build-time SDK\n  // Note: We removed auto-detection to prevent Next.js static analysis issues\n\n  // Server-side without request context (SSG/ISR): use build-time SDK\n  return getBuildTimeSDK();\n}\n\n\n/**\n * Set global storefront configuration that applies to all SDK instances\n * This gets bundled into both client and server contexts automatically\n */\nexport function setGlobalStorefrontConfig(config: StorefrontRuntimeConfig | null): void {\n  globalStorefrontConfig = config;\n  \n  // Reset existing instances to pick up new configuration\n  clientSDK = null;\n  buildTimeSDK = null;\n}\n\n/**\n * Get the current global storefront configuration\n */\nexport function getGlobalStorefrontConfig(): StorefrontRuntimeConfig | null {\n  return globalStorefrontConfig;\n}\n\n/**\n * Initialize the SDK (internal use)\n * This should be called once in your app via StorefrontSDKInitializer\n */\nexport function initializeStorefrontSDK(): void {\n  // Reset existing instances when reinitializing\n  clientSDK = null;\n  buildTimeSDK = null;\n}\n"],"mappings":";;;;;;;AAmDA,IAAa,qBAAb,MAAwD;CAKtD,YAAY,UAAqC,IAAI;EACnD,MAAM,SAAS,QAAQ,UAAU;AACjC,OAAK,iBAAiB,GAAG,OAAO;AAChC,OAAK,kBAAkB,GAAG,OAAO;AAEjC,OAAK,UAAU;GACb,QAAQ,QAAQ,UAAU,MAAU,KAAK;GACzC,MAAM,QAAQ,QAAQ;GACtB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ,WAAW,OAAO,WAAW,eAAe,OAAO,UAAU,aAAa;GAC1F,UAAU,QAAQ,YAAY;;;CAIlC,MAAM,iBAAyC;AAC7C,SAAO,KAAK,UAAU,KAAK;;CAG7B,MAAM,eAAe,OAA8B;AACjD,OAAK,UAAU,KAAK,gBAAgB;;CAGtC,MAAM,kBAA0C;AAC9C,SAAO,KAAK,UAAU,KAAK;;CAG7B,MAAM,gBAAgB,OAA8B;AAClD,OAAK,UAAU,KAAK,iBAAiB;;CAGvC,MAAM,cAA6B;AACjC,OAAK,aAAa,KAAK;AACvB,OAAK,aAAa,KAAK;;CAGzB,AAAQ,UAAU,MAA6B;AAC7C,MAAI,OAAO,aAAa,YAAa,QAAO;EAE5C,MAAM,QAAQ,KAAK,SAAS;EAC5B,MAAM,QAAQ,MAAM,MAAM,KAAK,KAAK;AAEpC,MAAI,MAAM,WAAW,GAAG;GACtB,MAAM,cAAc,MAAM,OAAO,MAAM,KAAK;AAC5C,UAAO,cAAc,mBAAmB,eAAe;;AAGzD,SAAO;;CAGT,AAAQ,UAAU,MAAc,OAAqB;AACnD,MAAI,OAAO,aAAa,YAAa;EAErC,MAAM,eAAe,mBAAmB;EACxC,IAAI,eAAe,GAAG,KAAK,GAAG;AAE9B,MAAI,KAAK,QAAQ,OACf,iBAAgB,aAAa,KAAK,QAAQ;AAG5C,MAAI,KAAK,QAAQ,KACf,iBAAgB,UAAU,KAAK,QAAQ;AAGzC,MAAI,KAAK,QAAQ,OACf,iBAAgB,YAAY,KAAK,QAAQ;AAG3C,MAAI,KAAK,QAAQ,OACf,iBAAgB;AAGlB,MAAI,KAAK,QAAQ,SACf,iBAAgB,cAAc,KAAK,QAAQ;AAG7C,WAAS,SAAS;;CAGpB,AAAQ,aAAa,MAAoB;AACvC,MAAI,OAAO,aAAa,YAAa;EAErC,IAAI,eAAe,GAAG,KAAK;AAE3B,MAAI,KAAK,QAAQ,KACf,iBAAgB,UAAU,KAAK,QAAQ;AAGzC,MAAI,KAAK,QAAQ,OACf,iBAAgB,YAAY,KAAK,QAAQ;AAG3C,WAAS,SAAS;;;;;;AActB,IAAa,qBAAb,MAAwD;CAMtD,YAAY,aAA8B,UAAqC,IAAI;EACjF,MAAM,SAAS,QAAQ,UAAU;AACjC,OAAK,iBAAiB,GAAG,OAAO;AAChC,OAAK,kBAAkB,GAAG,OAAO;AACjC,OAAK,cAAc;AAEnB,OAAK,UAAU;GACb,QAAQ,QAAQ,UAAU,MAAU,KAAK;GACzC,MAAM,QAAQ,QAAQ;GACtB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ,UAAU,QAAQ,IAAI,aAAa;GACnD,UAAU,QAAQ,YAAY;;;CAIlC,MAAM,iBAAyC;AAC7C,MAAI;AACF,UAAO,KAAK,YAAY,IAAI,KAAK,iBAAiB,SAAS;WACpD,OAAO;AACd,WAAQ,KAAK,mDAAmD;AAChE,UAAO;;;CAIX,MAAM,eAAe,OAA8B;AACjD,MAAI;AACF,QAAK,YAAY,IAAI,KAAK,gBAAgB,OAAO;IAC/C,QAAQ,KAAK,QAAQ;IACrB,MAAM,KAAK,QAAQ;IACnB,QAAQ,KAAK,QAAQ;IACrB,QAAQ,KAAK,QAAQ;IACrB,UAAU,KAAK,QAAQ,UAAU;IACjC,UAAU;;WAEL,OAAO;AACd,WAAQ,KAAK,yCAAyC;;;CAI1D,MAAM,kBAA0C;AAC9C,MAAI;AACF,UAAO,KAAK,YAAY,IAAI,KAAK,kBAAkB,SAAS;WACrD,OAAO;AACd,WAAQ,KAAK,oDAAoD;AACjE,UAAO;;;CAIX,MAAM,gBAAgB,OAA8B;AAClD,MAAI;AACF,QAAK,YAAY,IAAI,KAAK,iBAAiB,OAAO;IAChD,QAAQ,KAAK,QAAQ;IACrB,MAAM,KAAK,QAAQ;IACnB,QAAQ,KAAK,QAAQ;IACrB,QAAQ,KAAK,QAAQ;IACrB,UAAU,KAAK,QAAQ,UAAU;IACjC,UAAU;;WAEL,OAAO;AACd,WAAQ,KAAK,0CAA0C;;;CAI3D,MAAM,cAA6B;AACjC,MAAI;AACF,QAAK,YAAY,OAAO,KAAK;AAC7B,QAAK,YAAY,OAAO,KAAK;WACtB,OAAO;AACd,WAAQ,KAAK,qCAAqC;;;;;;;AChOxD,MAAM,wBAAQ,IAAI;AAElB,SAAS,UAAU,OAAyC;AAC1D,KAAI,CAAC,MAAO,QAAO;AACnB,KAAI,CAAC,MAAM,UAAW,QAAO;AAC7B,QAAO,KAAK,QAAQ,MAAM,YAAY;;AAGxC,SAAgB,eAAe,KAAiC;CAC9D,MAAM,QAAQ,MAAM,IAAI;AACxB,QAAO,UAAU,SAAS,OAAQ;;AAGpC,SAAgB,eACd,KACA,OACM;CACN,MAAM,YAAY,MAAM,cAAc,OAClC,KAAK,QAAQ,MAAM,aAAa,MAChC;AAEJ,OAAM,IAAI,KAAK;EACb,aAAa,MAAM;EACnB,cAAc,MAAM,gBAAgB;EACpC;;;AAIJ,SAAgB,iBAAiB,KAAmB;AAClD,OAAM,OAAO;;;;;ACpCf,MAAM,sBAAsB;;;;;AAM5B,IAAa,iCAAb,MAAoE;CAIlE,YACE,AAAQA,UACR,AAAQ,aAAa,qBACrB;EAFQ;EACA;gBALsB;iBACC;;CAOjC,MAAM,iBAAyC;AAC7C,MAAI,KAAK,OACP,QAAO,KAAK;EAGd,MAAM,SAAS,eAAe,KAAK;AACnC,MAAI,QAAQ,aAAa;AACvB,QAAK,SAAS,OAAO;AACrB,QAAK,UAAU,OAAO,gBAAgB;AACtC,UAAO,KAAK;;AAGd,SAAO;;CAGT,MAAM,eAAe,OAA8B;AACjD,OAAK,SAAS;AACd,iBAAe,KAAK,UAAU;GAC5B,aAAa;GACb,cAAc,KAAK;GACnB,YAAY,KAAK;;;CAIrB,MAAM,kBAA0C;AAC9C,SAAO,KAAK;;CAGd,MAAM,gBAAgB,OAA8B;AAClD,OAAK,UAAU;AACf,iBAAe,KAAK,UAAU;GAC5B,aAAa,KAAK,UAAU;GAC5B,cAAc;GACd,YAAY,KAAK;;;CAIrB,MAAM,cAA6B;AACjC,OAAK,SAAS;AACd,OAAK,UAAU;AACf,mBAAiB,KAAK;;;;;;;;;;ACI1B,SAAS,YAA6B;CAEpC,MAAM,aAAa,QAAQ,IAAI;CAC/B,MAAM,YAAY,QAAQ,IAAI;CAC9B,MAAM,iBAAiB,QAAQ,IAAI;CACnC,MAAM,aAAa,QAAQ,IAAI;CAC/B,MAAM,aAAa,QAAQ,IAAI,0BAA0B,SAAS,QAAQ,IAAI,yBAAyB,MAAM;CAC7G,MAAM,WAAW,QAAQ,IAAI,2BAA2B;CAGxD,MAAMC,oBAA6C;AACnD,KAAI,QAAQ,IAAI,sCACd,mBAAkB,oBAAoB,QAAQ,IAAI;CAIpD,MAAM,UAAU,wBAAwB,WAAW;CACnD,MAAM,SAAS,wBAAwB,UAAU;CACjD,MAAM,cAAc,wBAAwB,gBAAgB,mBAAmB,eAAe,YAAY,aAAa,YAAY;CACnI,MAAM,UAAU,wBAAwB,WAAW;CACnD,MAAM,UAAU,wBAAwB,WAAW;CACnD,MAAM,QAAQ,wBAAwB,UAAU,SAAY,uBAAuB,QAAQ;CAG3F,MAAMC,iBAA0C;EAC9C,GAAG;EACH,GAAG,wBAAwB;;AAI7B,KAAI,CAAC,WAAW,CAAC,OACf,OAAM,IAAI,MACR;;;;;;;CAUJ,MAAMC,SAA0B;EAC9B;EACA;EACA;;AAIF,KAAI,QAAS,QAAO,UAAU;AAC9B,KAAI,QAAS,QAAO,UAAU;AAC9B,KAAI,MAAO,QAAO,QAAQ;CAG1B,MAAM,SAAS,wBAAwB;CACvC,MAAM,cAAc,wBAAwB;CAC5C,MAAM,eAAe,wBAAwB;CAC7C,MAAM,kBAAkB,wBAAwB;CAChD,MAAM,kBAAkB,wBAAwB;CAChD,MAAM,sBAAsB,wBAAwB;AAEpD,KAAI,OAAQ,QAAO,SAAS;AAC5B,KAAI,YAAa,QAAO,cAAc;AACtC,KAAI,aAAc,QAAO,eAAe;AACxC,KAAI,gBAAiB,QAAO,kBAAkB;AAC9C,KAAI,gBAAiB,QAAO,kBAAkB;AAC9C,KAAI,OAAO,KAAK,gBAAgB,SAAS,EAAG,QAAO,iBAAiB;AACpE,KAAI,oBAAqB,QAAO,sBAAsB;AAEtD,QAAO;;;;;;AAOT,IAAIC,yBAAyD;;;;AAK7D,IAAIC,YAAkC;;;;AAMtC,SAAS,mBACP,aACA,SACA,QACA;AACA,KAAI,OAAO,WAAW,YAEpB,QAAO,IAAI,mBAAmB;AAGhC,KAAI,YAEF,QAAO,IAAI,mBAAmB,aAAa;CAI7C,MAAM,cAAc,QAAQ,IAAI,4BAA4B;AAE5D,KAAI,eAAe,QAAQ;EAEzB,MAAM,WAAW,GAAG,OAAO,QAAQ,GAAG,OAAO,eAAe;AAC5D,SAAO,IAAI,+BAA+B;;AAG5C,QAAO,IAAI;;;;;AAMb,MAAM,qBAAqB,OAAO,gBAAiC;CACjE,MAAM,SAAS;AAEf,QAAO,IAAI,cAAc;EACvB,GAAG;EACH,cAAc,mBACZ,aACA,OAAO,qBACP;;;;;;AAQN,IAAIC,eAAqC;AAEzC,SAAS,kBAAiC;CACxC,MAAM,SAAS;AAGf,KAAI,CAAC,aACH,gBAAe,IAAI,cAAc;EAC/B,GAAG;EACH,cAAc,mBACZ,QACA,OAAO,qBACP;;AAKN,QAAO;;AAoBT,SAAgB,iBAAiB,aAA8C;AAE7E,KAAI,OAAO,WAAW,aAAa;AACjC,MAAI,YACF,SAAQ,KACN;EAIJ,MAAM,SAAS;AAGf,MAAI,CAAC,UACH,aAAY,IAAI,cAAc;GAC5B,GAAG;GACH,cAAc,mBACZ,QACA,OAAO,qBACP;;AAKN,SAAO;;AAIT,KAAI,YACF,QAAO,mBAAmB;AAO5B,QAAO;;;;;;AAQT,SAAgB,0BAA0B,QAA8C;AACtF,0BAAyB;AAGzB,aAAY;AACZ,gBAAe;;;;;;AAcjB,SAAgB,0BAAgC;AAE9C,aAAY;AACZ,gBAAe"}

package/dist/sdk-manager-D2ktqPrp.d.cts

@@ -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-D2ktqPrp.d.cts.map

package/dist/sdk-manager-D2ktqPrp.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-manager-D2ktqPrp.d.cts","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"}