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

package/dist/storefront.cjs

@@ -0,0 +1,474 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+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/storefront.ts
+var storefront_exports = {};
+__export(storefront_exports, {
+  default: () => storefront_default,
+  storefront: () => storefront
+});
+module.exports = __toCommonJS(storefront_exports);
+
+// src/sdk-manager.ts
+var import_react = require("react");
+var import_storefront_sdk = require("@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" ? import_storefront_sdk.Environment.Production : import_storefront_sdk.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 import_storefront_sdk.MemoryTokenStorage();
+}
+var getServerSDKCached = (0, import_react.cache)((cookieStore, requestConfig) => {
+  const config = getConfig(requestConfig);
+  return new import_storefront_sdk.StorefrontSDK({
+    ...config,
+    tokenStorage: createTokenStorage(
+      cookieStore,
+      config.tokenStorageOptions,
+      config
+    )
+  });
+});
+var buildTimeSDK = null;
+function getBuildTimeSDK(requestConfig) {
+  const config = getConfig(requestConfig);
+  if (requestConfig) {
+    return new import_storefront_sdk.StorefrontSDK({
+      ...config,
+      tokenStorage: createTokenStorage(
+        void 0,
+        config.tokenStorageOptions,
+        config
+      )
+    });
+  }
+  if (!buildTimeSDK) {
+    buildTimeSDK = new import_storefront_sdk.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 import_storefront_sdk.StorefrontSDK({
+        ...config,
+        tokenStorage: createTokenStorage(
+          void 0,
+          config.tokenStorageOptions,
+          config
+        )
+      });
+    }
+    if (!clientSDK) {
+      clientSDK = new import_storefront_sdk.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;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  storefront
+});

package/dist/storefront.d.cts

@@ -0,0 +1,2 @@
+import '@commercengine/storefront-sdk';
+export { S as StorefrontRuntimeConfig, b as default, b as storefront } from './server-ByBPoXJG.cjs';

package/dist/storefront.d.ts

@@ -0,0 +1,2 @@
+import '@commercengine/storefront-sdk';
+export { S as StorefrontRuntimeConfig, b as default, b as storefront } from './server-ByBPoXJG.js';