@commercengine/storefront-sdk-nextjs 0.1.0-alpha.1 → 1.0.0-alpha.3

package/dist/client.cjs

@@ -1,10 +1,8 @@
 "use client";
 "use strict";
-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 __export = (target, all) => {
   for (var name in all)
@@ -19,14 +17,6 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/client.ts
@@ -35,8 +25,7 @@ __export(client_exports, {
   ClientTokenStorage: () => ClientTokenStorage,
   StorefrontSDKInitializer: () => StorefrontSDKInitializer,
   getStorefrontSDK: () => getStorefrontSDK,
-  initializeStorefrontSDK: () => initializeStorefrontSDK,
-  storefront: () => storefront
+  initializeStorefrontSDK: () => initializeStorefrontSDK
 });
 module.exports = __toCommonJS(client_exports);
 
@@ -223,21 +212,17 @@ var BuildCachingMemoryTokenStorage = class {
   }
   async getAccessToken() {
     if (this.access) {
-      console.log(`\u{1F535} [BuildCache] Using instance token for key: ${this.cacheKey}`);
       return this.access;
     }
     const cached = getCachedToken(this.cacheKey);
     if (cached?.accessToken) {
-      console.log(`\u{1F7E2} [BuildCache] Using cached token for key: ${this.cacheKey}`);
       this.access = cached.accessToken;
       this.refresh = cached.refreshToken ?? null;
       return this.access;
     }
-    console.log(`\u{1F7E1} [BuildCache] No cached token found for key: ${this.cacheKey}`);
     return null;
   }
   async setAccessToken(token) {
-    console.log(`\u{1F7E0} [BuildCache] Caching new access token for key: ${this.cacheKey}`);
     this.access = token;
     setCachedToken(this.cacheKey, {
       accessToken: token,
@@ -264,30 +249,63 @@ var BuildCachingMemoryTokenStorage = class {
 };
 
 // src/sdk-manager.ts
-var globalConfig = null;
-function getEnvConfig() {
-  return {
-    storeId: process.env.NEXT_PUBLIC_STORE_ID || "",
-    environment: process.env.NEXT_PUBLIC_ENVIRONMENT === "production" ? import_storefront_sdk.Environment.Production : import_storefront_sdk.Environment.Staging,
-    apiKey: process.env.NEXT_PUBLIC_API_KEY
-  };
-}
 function getConfig() {
-  if (globalConfig) {
-    return globalConfig;
+  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;
   }
-  return getEnvConfig();
-}
-var clientSDK = null;
-function hasRequestContext() {
-  try {
-    const { cookies } = require("next/headers");
-    cookies();
-    return true;
-  } catch {
-    return false;
+  const storeId = globalStorefrontConfig?.storeId || envStoreId;
+  const apiKey = globalStorefrontConfig?.apiKey || envApiKey;
+  const environment = globalStorefrontConfig?.environment || (envEnvironment === "production" ? import_storefront_sdk.Environment.Production : import_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;
 }
+var globalStorefrontConfig = null;
+var clientSDK = null;
 function createTokenStorage(cookieStore, options, config) {
   if (typeof window !== "undefined") {
     return new ClientTokenStorage(options);
@@ -298,14 +316,12 @@ function createTokenStorage(cookieStore, options, config) {
   const shouldCache = process.env.NEXT_BUILD_CACHE_TOKENS === "true";
   if (shouldCache && config) {
     const cacheKey = `${config.storeId}:${config.environment || "production"}`;
-    console.log(`\u{1F680} [BuildCache] Using BuildCachingMemoryTokenStorage with key: ${cacheKey}`);
     return new BuildCachingMemoryTokenStorage(cacheKey);
   }
-  console.log(`\u{1F504} [Build] Using standard MemoryTokenStorage (caching disabled)`);
   return new import_storefront_sdk.MemoryTokenStorage();
 }
 var getServerSDKCached = (0, import_react.cache)((cookieStore) => {
-  const config = getEnvConfig();
+  const config = getConfig();
   return new import_storefront_sdk.StorefrontSDK({
     ...config,
     tokenStorage: createTokenStorage(
@@ -317,7 +333,7 @@ var getServerSDKCached = (0, import_react.cache)((cookieStore) => {
 });
 var buildTimeSDK = null;
 function getBuildTimeSDK() {
-  const config = getEnvConfig();
+  const config = getConfig();
   if (!buildTimeSDK) {
     buildTimeSDK = new import_storefront_sdk.StorefrontSDK({
       ...config,
@@ -353,67 +369,27 @@ function getStorefrontSDK(cookieStore) {
   if (cookieStore) {
     return getServerSDKCached(cookieStore);
   }
-  if (hasRequestContext()) {
-    let autoDetectMessage = "";
-    try {
-      require.resolve("next/headers");
-      autoDetectMessage = `
-
-\u{1F50D} Auto-detection attempted but failed. You may be in:
-- Server Action (use: const sdk = getStorefrontSDK(await cookies()))
-- API Route (use: const sdk = getStorefrontSDK(cookies()))
-- Server Component in App Router (use: const sdk = getStorefrontSDK(cookies()))
-`;
-    } catch {
-      autoDetectMessage = `
-
-\u{1F4A1} Make sure you have Next.js installed and are in a server context.
-`;
-    }
-    throw new Error(
-      `
-\u{1F6A8} Server Environment Detected!
-
-You're calling getStorefrontSDK() on the server without cookies.
-Please pass the Next.js cookie store:
-
-\u2705 Correct usage:
-import { cookies } from 'next/headers';
-
-// Server Actions & Route Handlers
-const sdk = getStorefrontSDK(await cookies());
-
-// API Routes & Server Components (App Router)
-const sdk = getStorefrontSDK(cookies());
-
-\u274C Your current usage:
-const sdk = getStorefrontSDK(); // Missing cookies!
-${autoDetectMessage}
-This is required for server-side token access.
-    `.trim()
-    );
-  }
   return getBuildTimeSDK();
 }
-function initializeStorefrontSDK(config) {
-  globalConfig = config;
+function initializeStorefrontSDK() {
   clientSDK = null;
   buildTimeSDK = null;
 }
 
-// src/storefront.ts
-function storefront(cookieStore) {
-  return getStorefrontSDK(cookieStore);
-}
-
 // src/init-client.ts
 var import_react2 = require("react");
-function StorefrontSDKInitializer({
-  config
-}) {
+async function bootstrapTokens() {
+  const sdk = getStorefrontSDK();
+  const accessToken = await sdk.getAccessToken();
+  if (!accessToken) {
+    await sdk.auth.getAnonymousToken();
+  }
+}
+function StorefrontSDKInitializer({ runtimeConfig } = {}) {
   (0, import_react2.useEffect)(() => {
-    initializeStorefrontSDK(config);
-  }, [config]);
+    initializeStorefrontSDK();
+    bootstrapTokens().catch(console.error);
+  }, [runtimeConfig]);
   return null;
 }
 
@@ -425,6 +401,5 @@ __reExport(client_exports, require("@commercengine/storefront-sdk"), module.expo
   StorefrontSDKInitializer,
   getStorefrontSDK,
   initializeStorefrontSDK,
-  storefront,
   ...require("@commercengine/storefront-sdk")
 });

package/dist/client.d.cts

@@ -1,4 +1,4 @@
-import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
+import { TokenStorage, StorefrontSDK, StorefrontSDKOptions, Environment, SupportedDefaultHeaders, DebugLoggerFn } from '@commercengine/storefront-sdk';
 export * from '@commercengine/storefront-sdk';
 export { StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
 
@@ -58,7 +58,35 @@ interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
      */
     tokenStorageOptions?: NextJSTokenStorageOptions;
 }
-type NextCookieStore$1 = {
+/**
+ * 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;
@@ -74,65 +102,20 @@ type NextCookieStore$1 = {
  * - SSG/ISR (no request context): getStorefrontSDK() (uses memory storage)
  */
 declare function getStorefrontSDK(): StorefrontSDK;
-declare function getStorefrontSDK(cookieStore: NextCookieStore$1): StorefrontSDK;
+declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
 /**
- * Initialize the SDK with configuration (internal use)
+ * Initialize the SDK (internal use)
  * This should be called once in your app via StorefrontSDKInitializer
  */
-declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
-
-/**
- * Universal storefront SDK export
- *
- * This provides a simple unified interface that works in all Next.js contexts:
- * - Client components: automatically uses client token storage
- * - Server components: requires cookies() to be passed
- * - SSG/ISR: automatically uses memory storage with optional build caching
- *
- * Usage:
- * ```typescript
- * // Client-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * const products = await storefront().catalog.listProducts()
- *
- * // Server-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * import { cookies } from 'next/headers'
- * const products = await storefront(cookies()).catalog.listProducts()
- * ```
- */
-
-type NextCookieStore = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Universal storefront SDK accessor
- *
- * @param cookieStore - Next.js cookie store (required on server-side)
- * @returns StorefrontSDK instance configured for the current environment
- */
-declare function storefront(): StorefrontSDK;
-declare function storefront(cookieStore: NextCookieStore): StorefrontSDK;
+declare function initializeStorefrontSDK(): void;
 
 interface StorefrontSDKInitializerProps {
-    config: NextJSSDKConfig;
+    /**
+     * Optional runtime configuration overrides for client-side API calls
+     * These settings will apply to all client-side storefront() calls
+     */
+    runtimeConfig?: StorefrontRuntimeConfig;
 }
-/**
- * Client-side initialization component
- * Use this in your root layout to initialize the SDK once
- *
- * The core SDK middleware now automatically handles everything:
- * - Creates anonymous tokens automatically on first API request (if no tokens exist)
- * - Token state assessment and cleanup on first request per page load
- * - Expired token refresh with automatic anonymous fallback
- * - Graceful handling of partial token states
- *
- * No manual token creation needed - just make API calls and everything works!
- */
-declare function StorefrontSDKInitializer({ config, }: StorefrontSDKInitializerProps): null;
+declare function StorefrontSDKInitializer({ runtimeConfig }?: StorefrontSDKInitializerProps): null;
 
-export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK, storefront };
+export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK };

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
+import { TokenStorage, StorefrontSDK, StorefrontSDKOptions, Environment, SupportedDefaultHeaders, DebugLoggerFn } from '@commercengine/storefront-sdk';
 export * from '@commercengine/storefront-sdk';
 export { StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
 
@@ -58,7 +58,35 @@ interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
      */
     tokenStorageOptions?: NextJSTokenStorageOptions;
 }
-type NextCookieStore$1 = {
+/**
+ * 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;
@@ -74,65 +102,20 @@ type NextCookieStore$1 = {
  * - SSG/ISR (no request context): getStorefrontSDK() (uses memory storage)
  */
 declare function getStorefrontSDK(): StorefrontSDK;
-declare function getStorefrontSDK(cookieStore: NextCookieStore$1): StorefrontSDK;
+declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
 /**
- * Initialize the SDK with configuration (internal use)
+ * Initialize the SDK (internal use)
  * This should be called once in your app via StorefrontSDKInitializer
  */
-declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
-
-/**
- * Universal storefront SDK export
- *
- * This provides a simple unified interface that works in all Next.js contexts:
- * - Client components: automatically uses client token storage
- * - Server components: requires cookies() to be passed
- * - SSG/ISR: automatically uses memory storage with optional build caching
- *
- * Usage:
- * ```typescript
- * // Client-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * const products = await storefront().catalog.listProducts()
- *
- * // Server-side
- * import { storefront } from '@commercengine/storefront-sdk-nextjs/storefront'
- * import { cookies } from 'next/headers'
- * const products = await storefront(cookies()).catalog.listProducts()
- * ```
- */
-
-type NextCookieStore = {
-    get: (name: string) => {
-        value: string;
-    } | undefined;
-    set: (name: string, value: string, options?: any) => void;
-    delete: (name: string) => void;
-};
-/**
- * Universal storefront SDK accessor
- *
- * @param cookieStore - Next.js cookie store (required on server-side)
- * @returns StorefrontSDK instance configured for the current environment
- */
-declare function storefront(): StorefrontSDK;
-declare function storefront(cookieStore: NextCookieStore): StorefrontSDK;
+declare function initializeStorefrontSDK(): void;
 
 interface StorefrontSDKInitializerProps {
-    config: NextJSSDKConfig;
+    /**
+     * Optional runtime configuration overrides for client-side API calls
+     * These settings will apply to all client-side storefront() calls
+     */
+    runtimeConfig?: StorefrontRuntimeConfig;
 }
-/**
- * Client-side initialization component
- * Use this in your root layout to initialize the SDK once
- *
- * The core SDK middleware now automatically handles everything:
- * - Creates anonymous tokens automatically on first API request (if no tokens exist)
- * - Token state assessment and cleanup on first request per page load
- * - Expired token refresh with automatic anonymous fallback
- * - Graceful handling of partial token states
- *
- * No manual token creation needed - just make API calls and everything works!
- */
-declare function StorefrontSDKInitializer({ config, }: StorefrontSDKInitializerProps): null;
+declare function StorefrontSDKInitializer({ runtimeConfig }?: StorefrontSDKInitializerProps): null;
 
-export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK, storefront };
+export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK };