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

package/dist/storefront.js

@@ -0,0 +1,448 @@
+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
+function getConfig(requestConfig) {
+  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 = requestConfig?.storeId || globalStorefrontConfig?.storeId || envStoreId;
+  const apiKey = requestConfig?.apiKey || globalStorefrontConfig?.apiKey || envApiKey;
+  const environment = requestConfig?.environment || globalStorefrontConfig?.environment || (envEnvironment === "production" ? Environment.Production : Environment.Staging);
+  const baseUrl = requestConfig?.baseUrl || globalStorefrontConfig?.baseUrl || envBaseUrl;
+  const timeout = requestConfig?.timeout || globalStorefrontConfig?.timeout || envTimeout;
+  const debug = requestConfig?.debug !== void 0 ? requestConfig.debug : globalStorefrontConfig?.debug !== void 0 ? globalStorefrontConfig.debug : envDebug;
+  const defaultHeaders = {
+    ...envDefaultHeaders,
+    ...globalStorefrontConfig?.defaultHeaders,
+    ...requestConfig?.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.
+Alternatively, you can pass them via the storefront() function config parameter.`
+    );
+  }
+  const config = {
+    storeId,
+    apiKey,
+    environment
+  };
+  if (baseUrl) config.baseUrl = baseUrl;
+  if (timeout) config.timeout = timeout;
+  if (debug) config.debug = debug;
+  const logger = requestConfig?.logger || globalStorefrontConfig?.logger;
+  const accessToken = requestConfig?.accessToken || globalStorefrontConfig?.accessToken;
+  const refreshToken = requestConfig?.refreshToken || globalStorefrontConfig?.refreshToken;
+  const onTokensUpdated = requestConfig?.onTokensUpdated || globalStorefrontConfig?.onTokensUpdated;
+  const onTokensCleared = requestConfig?.onTokensCleared || globalStorefrontConfig?.onTokensCleared;
+  const tokenStorageOptions = requestConfig?.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 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, requestConfig) => {
+  const config = getConfig(requestConfig);
+  return new StorefrontSDK({
+    ...config,
+    tokenStorage: createTokenStorage(
+      cookieStore,
+      config.tokenStorageOptions,
+      config
+    )
+  });
+});
+var buildTimeSDK = null;
+function getBuildTimeSDK(requestConfig) {
+  const config = getConfig(requestConfig);
+  if (requestConfig) {
+    return new StorefrontSDK({
+      ...config,
+      tokenStorage: createTokenStorage(
+        void 0,
+        config.tokenStorageOptions,
+        config
+      )
+    });
+  }
+  if (!buildTimeSDK) {
+    buildTimeSDK = new StorefrontSDK({
+      ...config,
+      tokenStorage: createTokenStorage(
+        void 0,
+        config.tokenStorageOptions,
+        config
+      )
+    });
+  }
+  return buildTimeSDK;
+}
+function getStorefrontSDK(cookieStore, requestConfig) {
+  if (typeof window !== "undefined") {
+    if (cookieStore) {
+      console.warn(
+        "Cookie store passed in client environment - this will be ignored"
+      );
+    }
+    const config = getConfig(requestConfig);
+    if (requestConfig) {
+      return new StorefrontSDK({
+        ...config,
+        tokenStorage: createTokenStorage(
+          void 0,
+          config.tokenStorageOptions,
+          config
+        )
+      });
+    }
+    if (!clientSDK) {
+      clientSDK = new StorefrontSDK({
+        ...config,
+        tokenStorage: createTokenStorage(
+          void 0,
+          config.tokenStorageOptions,
+          config
+        )
+      });
+    }
+    return clientSDK;
+  }
+  if (cookieStore) {
+    return getServerSDKCached(cookieStore, requestConfig);
+  }
+  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(requestConfig);
+}
+
+// src/storefront.ts
+function storefront(cookieStoreOrConfig, config) {
+  let cookieStore;
+  let requestConfig;
+  if (cookieStoreOrConfig && typeof cookieStoreOrConfig === "object" && !("get" in cookieStoreOrConfig)) {
+    requestConfig = cookieStoreOrConfig;
+  } else {
+    cookieStore = cookieStoreOrConfig;
+    requestConfig = config;
+  }
+  return getStorefrontSDK(cookieStore, requestConfig);
+}
+var storefront_default = storefront;
+export {
+  storefront_default as default,
+  storefront
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercengine/storefront-sdk-nextjs",
-  "version": "0.1.0-alpha.0",
+  "version": "1.0.0-alpha.2",
   "description": "Next.js wrapper for the Commerce Engine Storefront SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
     }
   },
   "files": [
@@ -27,19 +37,19 @@
   "author": "Commerce Engine",
   "license": "All rights reserved",
   "peerDependencies": {
-    "next": ">=13.0.0",
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "next": ">=15.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
   },
   "dependencies": {
     "@commercengine/storefront-sdk": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "@types/react": "^18.0.0",
-    "next": ">=13.0.0",
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
+    "@types/react": "^19.0.0",
+    "next": ">=15.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0",
     "rimraf": "^6.0.1",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2"