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

package/dist/middleware.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Minimal cookie interface compatible with Next.js middleware cookies API.
+ */
+interface NextCookiesLike {
+    get: (name: string) => {
+        value: string;
+    } | undefined;
+    set: (name: string, value: string, options?: {
+        maxAge?: number;
+        path?: string;
+        domain?: string;
+        secure?: boolean;
+        sameSite?: "strict" | "lax" | "none" | (string & {});
+        httpOnly?: boolean;
+    }) => any;
+}
+interface EnsureTokensOptions {
+    baseUrl: string;
+    apiKey?: string;
+    cookiePrefix?: string;
+    cookieOptions?: {
+        maxAge?: number;
+        path?: string;
+        domain?: string;
+        secure?: boolean;
+        sameSite?: "strict" | "lax" | "none";
+        httpOnly?: boolean;
+    };
+}
+/**
+ * Pre-seed anonymous tokens in Next.js middleware when missing.
+ * Call this early to ensure SSR and client share the same session.
+ *
+ * Returns true if tokens were set on the response, false otherwise.
+ */
+declare function ensureStorefrontTokens(reqCookies: NextCookiesLike, resCookies: NextCookiesLike, opts: EnsureTokensOptions): Promise<boolean>;
+
+export { type EnsureTokensOptions, type NextCookiesLike, ensureStorefrontTokens };

package/dist/middleware.js

@@ -0,0 +1,39 @@
+// src/middleware-helper.ts
+async function ensureStorefrontTokens(reqCookies, resCookies, opts) {
+  const prefix = opts.cookiePrefix ?? "ce_";
+  const ACCESS = `${prefix}access_token`;
+  const existingAccess = reqCookies.get(ACCESS)?.value;
+  if (existingAccess) {
+    return false;
+  }
+  try {
+    const resp = await fetch(`${opts.baseUrl}/auth/anonymous`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...opts.apiKey ? { "X-Api-Key": opts.apiKey } : {}
+      }
+    });
+    if (!resp.ok) return false;
+    const data = await resp.json();
+    const content = data?.content;
+    if (!content?.access_token || !content?.refresh_token) return false;
+    const cookieDefaults = {
+      path: "/",
+      httpOnly: false,
+      sameSite: "lax",
+      secure: opts.cookieOptions?.secure ?? false,
+      maxAge: 30 * 24 * 60 * 60
+      // 30 days
+    };
+    const finalOpts = { ...cookieDefaults, ...opts.cookieOptions || {} };
+    resCookies.set(ACCESS, content.access_token, finalOpts);
+    resCookies.set(`${prefix}refresh_token`, content.refresh_token, finalOpts);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  ensureStorefrontTokens
+};

package/dist/server-ByBPoXJG.d.cts

@@ -0,0 +1,182 @@
+import { TokenStorage, StorefrontSDK, Environment, SupportedDefaultHeaders, DebugLoggerFn, 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;
+}
+type NextCookieStore$2 = {
+    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$2, options?: NextJSTokenStorageOptions);
+    getAccessToken(): Promise<string | null>;
+    setAccessToken(token: string): Promise<void>;
+    getRefreshToken(): Promise<string | null>;
+    setRefreshToken(token: string): Promise<void>;
+    clearTokens(): Promise<void>;
+}
+
+/**
+ * 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$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;
+declare function getStorefrontSDK(cookieStore: NextCookieStore$1, requestConfig?: StorefrontRuntimeConfig): StorefrontSDK;
+/**
+ * Set global storefront configuration that applies to all SDK instances
+ * This gets bundled into both client and server contexts automatically
+ */
+declare function setGlobalStorefrontConfig(config: StorefrontRuntimeConfig | null): void;
+/**
+ * Get the current global storefront configuration
+ */
+declare function getGlobalStorefrontConfig(): StorefrontRuntimeConfig | null;
+/**
+ * Initialize the SDK (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(): 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)
+ * @param config - Optional per-request configuration overrides
+ * @returns StorefrontSDK instance configured for the current environment
+ */
+declare function storefront(): StorefrontSDK;
+declare function storefront(cookieStore: NextCookieStore): StorefrontSDK;
+declare function storefront(config: StorefrontRuntimeConfig): StorefrontSDK;
+declare function storefront(cookieStore: NextCookieStore, config: StorefrontRuntimeConfig): StorefrontSDK;
+
+export { ClientTokenStorage as C, type NextJSSDKConfig as N, type StorefrontRuntimeConfig as S, getGlobalStorefrontConfig as a, storefront as b, ServerTokenStorage as c, type NextJSTokenStorageOptions as d, getStorefrontSDK as g, initializeStorefrontSDK as i, setGlobalStorefrontConfig as s };

package/dist/server-ByBPoXJG.d.ts

@@ -0,0 +1,182 @@
+import { TokenStorage, StorefrontSDK, Environment, SupportedDefaultHeaders, DebugLoggerFn, 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;
+}
+type NextCookieStore$2 = {
+    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$2, options?: NextJSTokenStorageOptions);
+    getAccessToken(): Promise<string | null>;
+    setAccessToken(token: string): Promise<void>;
+    getRefreshToken(): Promise<string | null>;
+    setRefreshToken(token: string): Promise<void>;
+    clearTokens(): Promise<void>;
+}
+
+/**
+ * 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$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;
+declare function getStorefrontSDK(cookieStore: NextCookieStore$1, requestConfig?: StorefrontRuntimeConfig): StorefrontSDK;
+/**
+ * Set global storefront configuration that applies to all SDK instances
+ * This gets bundled into both client and server contexts automatically
+ */
+declare function setGlobalStorefrontConfig(config: StorefrontRuntimeConfig | null): void;
+/**
+ * Get the current global storefront configuration
+ */
+declare function getGlobalStorefrontConfig(): StorefrontRuntimeConfig | null;
+/**
+ * Initialize the SDK (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(): 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)
+ * @param config - Optional per-request configuration overrides
+ * @returns StorefrontSDK instance configured for the current environment
+ */
+declare function storefront(): StorefrontSDK;
+declare function storefront(cookieStore: NextCookieStore): StorefrontSDK;
+declare function storefront(config: StorefrontRuntimeConfig): StorefrontSDK;
+declare function storefront(cookieStore: NextCookieStore, config: StorefrontRuntimeConfig): StorefrontSDK;
+
+export { ClientTokenStorage as C, type NextJSSDKConfig as N, type StorefrontRuntimeConfig as S, getGlobalStorefrontConfig as a, storefront as b, ServerTokenStorage as c, type NextJSTokenStorageOptions as d, getStorefrontSDK as g, initializeStorefrontSDK as i, setGlobalStorefrontConfig as s };

package/dist/server-CwxgXezP.d.cts

@@ -0,0 +1,115 @@
+import { TokenStorage, Environment, SupportedDefaultHeaders, DebugLoggerFn, 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";
+}
+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>;
+}
+
+/**
+ * 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;
+/**
+ * Initialize the SDK (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(): void;
+
+export { type NextJSSDKConfig as N, type StorefrontRuntimeConfig as S, ServerTokenStorage as a, type NextJSTokenStorageOptions as b, getStorefrontSDK as g, initializeStorefrontSDK as i };

package/dist/server-CwxgXezP.d.ts

@@ -0,0 +1,115 @@
+import { TokenStorage, Environment, SupportedDefaultHeaders, DebugLoggerFn, 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";
+}
+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>;
+}
+
+/**
+ * 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;
+/**
+ * Initialize the SDK (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(): void;
+
+export { type NextJSSDKConfig as N, type StorefrontRuntimeConfig as S, ServerTokenStorage as a, type NextJSTokenStorageOptions as b, getStorefrontSDK as g, initializeStorefrontSDK as i };