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

package/dist/server-D-pFrx8J.d.cts

@@ -0,0 +1,105 @@
+import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
+import './storefront.cjs';
+
+/**
+ * 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>;
+}
+
+/**
+ * Configuration for the NextJS SDK wrapper
+ */
+interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
+    /**
+     * Token storage configuration options
+     */
+    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 with configuration (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
+
+export { ClientTokenStorage as C, type NextJSSDKConfig as N, ServerTokenStorage as S, type NextJSTokenStorageOptions as a, getStorefrontSDK as g, initializeStorefrontSDK as i };

package/dist/server-DaDfTjsO.d.cts

@@ -0,0 +1,103 @@
+import { TokenStorage, 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;
+}
+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;
+}
+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: getStorefrontSDK(await cookies())
+ */
+declare function getStorefrontSDK(): StorefrontSDK;
+declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
+/**
+ * Initialize the SDK with configuration (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
+
+export { ClientTokenStorage as C, type NextJSSDKConfig as N, ServerTokenStorage as S, type NextJSTokenStorageOptions as a, getStorefrontSDK as g, initializeStorefrontSDK as i };

package/dist/server-DaDfTjsO.d.ts

@@ -0,0 +1,103 @@
+import { TokenStorage, 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;
+}
+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;
+}
+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: getStorefrontSDK(await cookies())
+ */
+declare function getStorefrontSDK(): StorefrontSDK;
+declare function getStorefrontSDK(cookieStore: NextCookieStore): StorefrontSDK;
+/**
+ * Initialize the SDK with configuration (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
+
+export { ClientTokenStorage as C, type NextJSSDKConfig as N, ServerTokenStorage as S, type NextJSTokenStorageOptions as a, getStorefrontSDK as g, initializeStorefrontSDK as i };

package/dist/server-DjlQVC11.d.ts

@@ -0,0 +1,105 @@
+import { TokenStorage, StorefrontSDK, StorefrontSDKOptions } from '@commercengine/storefront-sdk';
+import './storefront.js';
+
+/**
+ * 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>;
+}
+
+/**
+ * Configuration for the NextJS SDK wrapper
+ */
+interface NextJSSDKConfig extends Omit<StorefrontSDKOptions, "tokenStorage"> {
+    /**
+     * Token storage configuration options
+     */
+    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 with configuration (internal use)
+ * This should be called once in your app via StorefrontSDKInitializer
+ */
+declare function initializeStorefrontSDK(config: NextJSSDKConfig): void;
+
+export { ClientTokenStorage as C, type NextJSSDKConfig as N, ServerTokenStorage as S, type NextJSTokenStorageOptions as a, getStorefrontSDK as g, initializeStorefrontSDK as i };