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

package/dist/client.d.ts

@@ -1,138 +1,17 @@
-import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-export * from '@commercengine/storefront-sdk';
-export { StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
-
-/**
- * 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;
-}
-
-/**
- * Configuration for the NextJS SDK wrapper
- */
-interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
-    /**
-     * Token storage configuration options
-     */
-    tokenStorageOptions?: NextJSTokenStorageOptions;
-}
-type NextCookieStore$1 = {
-    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$1): StorefrontSDK;
-/**
- * Initialize the SDK with configuration (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;
+import { ClientTokenStorage, NextJSSDKConfig, NextJSTokenStorageOptions, StorefrontRuntimeConfig, getStorefrontSDK, initializeStorefrontSDK } from "./sdk-manager-B9xDQQuv.js";
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKOptions, TokenStorage } from "@commercengine/storefront-sdk";
 
+//#region src/init-client.d.ts
 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;
-
-export { ClientTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK, storefront };
+declare function StorefrontSDKInitializer({
+  runtimeConfig
+}?: StorefrontSDKInitializerProps): null;
+//#endregion
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, type NextJSSDKConfig, type NextJSTokenStorageOptions, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, type StorefrontSDKOptions, type TokenStorage, getStorefrontSDK, initializeStorefrontSDK };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/init-client.ts"],"sourcesContent":[],"mappings":";;;;UAuCU,6BAAA;;;AAhCa;AAwCvB;EAAwC,aAAA,CAAA,EAHtB,uBAGsB;;AAAoB,iBAA5C,wBAAA,CAA4C;EAAA;AAAA,CAAA,CAAA,EAAA,6BAAA,CAAA,EAAA,IAAA"}

package/dist/client.js

@@ -1,398 +1,44 @@
 "use client";
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
 
-// src/sdk-manager.ts
-import { cache } from "react";
-import {
-  StorefrontSDK,
-  MemoryTokenStorage,
-  Environment
-} from "@commercengine/storefront-sdk";
 
-// src/token-storage.ts
-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 || 30 * 24 * 60 * 60,
-      // 30 days default
-      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;
-  }
-};
-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 || 30 * 24 * 60 * 60,
-      // 30 days default
-      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
-        // Allow client-side access for SDK flexibility
-      });
-    } 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
-        // Allow client-side access for SDK flexibility
-      });
-    } 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);
-    }
-  }
-};
-
-// src/build-token-cache.ts
-var 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);
-}
-
-// src/build-caching-memory-storage.ts
-var DEFAULT_TTL_SECONDS = 5 * 60;
-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) {
-      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,
-      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);
-  }
-};
-
-// src/sdk-manager.ts
-var globalConfig = null;
-function getEnvConfig() {
-  return {
-    storeId: process.env.NEXT_PUBLIC_STORE_ID || "",
-    environment: process.env.NEXT_PUBLIC_ENVIRONMENT === "production" ? Environment.Production : Environment.Staging,
-    apiKey: process.env.NEXT_PUBLIC_API_KEY
-  };
-}
-function getConfig() {
-  if (globalConfig) {
-    return globalConfig;
-  }
-  return getEnvConfig();
-}
-var clientSDK = null;
-function hasRequestContext() {
-  try {
-    const { cookies } = __require("next/headers");
-    cookies();
-    return true;
-  } catch {
-    return false;
-  }
-}
-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"}`;
-    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 MemoryTokenStorage();
-}
-var getServerSDKCached = cache((cookieStore) => {
-  const config = getEnvConfig();
-  return new StorefrontSDK({
-    ...config,
-    tokenStorage: createTokenStorage(
-      cookieStore,
-      config.tokenStorageOptions,
-      config
-    )
-  });
-});
-var buildTimeSDK = null;
-function getBuildTimeSDK() {
-  const config = getEnvConfig();
-  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);
-  }
-  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;
-  clientSDK = null;
-  buildTimeSDK = null;
-}
-
-// src/storefront.ts
-function storefront(cookieStore) {
-  return getStorefrontSDK(cookieStore);
-}
-
-// src/init-client.ts
+import { ClientTokenStorage, getStorefrontSDK, initializeStorefrontSDK } from "./sdk-manager-CdgrfSVp.js";
 import { useEffect } from "react";
-function StorefrontSDKInitializer({
-  config
-}) {
-  useEffect(() => {
-    initializeStorefrontSDK(config);
-  }, [config]);
-  return null;
-}
-
-// src/client.ts
-export * from "@commercengine/storefront-sdk";
-export {
-  ClientTokenStorage,
-  StorefrontSDKInitializer,
-  getStorefrontSDK,
-  initializeStorefrontSDK,
-  storefront
-};
+import { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK } from "@commercengine/storefront-sdk";
+
+//#region src/init-client.ts
+/**
+* Client-side initialization component
+* Use this in your root layout to initialize the SDK once
+*
+* Configuration is handled via environment variables:
+* - NEXT_PUBLIC_STORE_ID
+* - NEXT_PUBLIC_API_KEY
+* - NEXT_PUBLIC_ENVIRONMENT (optional, defaults to staging)
+*
+* The core SDK middleware 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!
+*/
+/**
+* Bootstrap tokens by checking if access token exists and creating anonymous token if needed
+*/
+async function bootstrapTokens() {
+	const sdk = getStorefrontSDK();
+	const accessToken = await sdk.getAccessToken();
+	if (!accessToken) await sdk.auth.getAnonymousToken();
+}
+function StorefrontSDKInitializer({ runtimeConfig } = {}) {
+	useEffect(() => {
+		initializeStorefrontSDK();
+		bootstrapTokens().catch(console.error);
+	}, [runtimeConfig]);
+	return null;
+}
+
+//#endregion
+export { AuthClient, BrowserTokenStorage, CartClient, CatalogClient, ClientTokenStorage, CookieTokenStorage, CustomerClient, Environment, HelpersClient, MemoryTokenStorage, OrderClient, ResponseUtils, ShippingClient, StoreConfigClient, StorefrontAPIClient, StorefrontSDK, StorefrontSDKInitializer, getStorefrontSDK, initializeStorefrontSDK };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/init-client.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect } from \"react\";\nimport { \n  initializeStorefrontSDK, \n  getStorefrontSDK,\n  type StorefrontRuntimeConfig \n} from \"./sdk-manager\";\n\n/**\n * Client-side initialization component\n * Use this in your root layout to initialize the SDK once\n *\n * Configuration is handled via environment variables:\n * - NEXT_PUBLIC_STORE_ID\n * - NEXT_PUBLIC_API_KEY\n * - NEXT_PUBLIC_ENVIRONMENT (optional, defaults to staging)\n *\n * The core SDK middleware automatically handles everything:\n * - Creates anonymous tokens automatically on first API request (if no tokens exist)\n * - Token state assessment and cleanup on first request per page load\n * - Expired token refresh with automatic anonymous fallback\n * - Graceful handling of partial token states\n *\n * No manual token creation needed - just make API calls and everything works!\n */\n\n/**\n * Bootstrap tokens by checking if access token exists and creating anonymous token if needed\n */\nasync function bootstrapTokens() {\n  const sdk = getStorefrontSDK();\n  const accessToken = await sdk.getAccessToken();\n\n  if (!accessToken) {\n    await sdk.auth.getAnonymousToken();\n  }\n}\n\ninterface StorefrontSDKInitializerProps {\n  /**\n   * Optional runtime configuration overrides for client-side API calls\n   * These settings will apply to all client-side storefront() calls\n   */\n  runtimeConfig?: StorefrontRuntimeConfig;\n}\n\nexport function StorefrontSDKInitializer({ runtimeConfig }: StorefrontSDKInitializerProps = {}) {\n  useEffect(() => {\n    // Initialize SDK - configuration comes from environment variables\n    // Middleware handles all token management automatically\n    initializeStorefrontSDK();\n\n    // Bootstrap tokens if they don't exist\n    // Note: per-request config will be handled through storefront() function calls\n    bootstrapTokens().catch(console.error);\n  }, [runtimeConfig]);\n\n  return null; // No UI needed\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,eAAe,kBAAkB;CAC/B,MAAM,MAAM;CACZ,MAAM,cAAc,MAAM,IAAI;AAE9B,KAAI,CAAC,YACH,OAAM,IAAI,KAAK;;AAYnB,SAAgB,yBAAyB,EAAE,kBAAiD,IAAI;AAC9F,iBAAgB;AAGd;AAIA,oBAAkB,MAAM,QAAQ;IAC/B,CAAC;AAEJ,QAAO"}