@doswiftly/storefront-sdk 4.0.0 → 4.2.0

package/dist/react/stores/currency.store.d.ts

@@ -5,20 +5,17 @@
  * Instance is created in StorefrontProvider via useRef and provided
  * through React Context — eliminates module duplication in Turbopack.
  */
-export interface ShopCurrencyData {
-    currencyCode: string;
-    supportedCurrencies: string[];
-    localeToCurrencyMap?: Array<{
-        locale: string;
-        currency: string;
-    }>;
-}
+import type { ShopConfig } from '../types/shop-config';
+/**
+ * @deprecated Use ShopConfig instead. Kept for backward compatibility of type exports.
+ */
+export type ShopCurrencyData = ShopConfig;
 export interface CurrencyStore {
     baseCurrency: string | null;
     supportedCurrencies: string[];
     currency: string | null;
     isLoaded: boolean;
-    initialize: (shopData: ShopCurrencyData) => void;
+    initialize: (shopData: ShopConfig) => void;
     setCurrency: (currency: string) => void;
 }
 export declare const createCurrencyStore: () => import("zustand").StoreApi<CurrencyStore>;

package/dist/react/stores/currency.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"currency.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/currency.store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAE5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAGlB,UAAU,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAqBD,eAAO,MAAM,mBAAmB,iDAqD3B,CAAC;AAMN,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,kBAAmB,CAAC;AACvE,eAAO,MAAM,kBAAkB,GAAI,OAAO,aAAa,kBAAuB,CAAC;AAC/E,eAAO,MAAM,yBAAyB,GAAI,OAAO,aAAa,aAA8B,CAAC;AAC7F,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,YAAmB,CAAC"}
+{"version":3,"file":"currency.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/currency.store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C,MAAM,WAAW,aAAa;IAE5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAGlB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,eAAO,MAAM,mBAAmB,iDAqD3B,CAAC;AAMN,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,kBAAmB,CAAC;AACvE,eAAO,MAAM,kBAAkB,GAAI,OAAO,aAAa,kBAAuB,CAAC;AAC/E,eAAO,MAAM,yBAAyB,GAAI,OAAO,aAAa,aAA8B,CAAC;AAC7F,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,YAAmB,CAAC"}

package/dist/react/stores/currency.store.js

@@ -6,25 +6,8 @@
  * through React Context — eliminates module duplication in Turbopack.
  */
 import { createStore } from 'zustand/vanilla';
-/**
- * Get currency from cookie (client-side).
- */
-function getCurrencyFromCookie() {
-    if (typeof document === 'undefined')
-        return null;
-    const match = document.cookie.match(/(?:^|;\s*)preferred-currency=([^;]*)/);
-    return match ? decodeURIComponent(match[1]) : null;
-}
-/**
- * Set currency in cookie (client-side).
- */
-function setCurrencyCookie(currency) {
-    if (typeof document === 'undefined')
-        return;
-    const maxAge = 365 * 24 * 60 * 60; // 1 year
-    const secure = typeof location !== 'undefined' && location.protocol === 'https:' ? ';secure' : '';
-    document.cookie = `preferred-currency=${encodeURIComponent(currency)};max-age=${maxAge};path=/;samesite=lax${secure}`;
-}
+import { CURRENCY_COOKIE_NAME, CURRENCY_COOKIE_MAX_AGE } from '../../core/currency/cookie-config';
+import { getCookie, setCookie } from '../cookies';
 export const createCurrencyStore = () => createStore()((set, get) => ({
     baseCurrency: null,
     supportedCurrencies: [],
@@ -32,7 +15,7 @@ export const createCurrencyStore = () => createStore()((set, get) => ({
     isLoaded: false,
     initialize: (shopData) => {
         // 1. Try saved currency from cookie (SSR-safe)
-        const saved = getCurrencyFromCookie();
+        const saved = getCookie(CURRENCY_COOKIE_NAME);
         // 2. Try to detect from browser locale
         let detected;
         if (shopData.localeToCurrencyMap && typeof navigator !== 'undefined') {
@@ -54,7 +37,7 @@ export const createCurrencyStore = () => createStore()((set, get) => ({
         });
         // Ensure cookie is set if we determined a currency
         if (finalCurrency && !saved) {
-            setCurrencyCookie(finalCurrency);
+            setCookie(CURRENCY_COOKIE_NAME, finalCurrency, { maxAge: CURRENCY_COOKIE_MAX_AGE });
         }
     },
     setCurrency: (currency) => {
@@ -64,7 +47,7 @@ export const createCurrencyStore = () => createStore()((set, get) => ({
             return;
         }
         set({ currency });
-        setCurrencyCookie(currency);
+        setCookie(CURRENCY_COOKIE_NAME, currency, { maxAge: CURRENCY_COOKIE_MAX_AGE });
     },
 }));
 // ---------------------------------------------------------------------------

package/dist/react/stores/language.store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Language store factory — tracks active language for SDK middleware.
+ *
+ * Creates a vanilla Zustand store (not a React hook singleton).
+ * Instance is created in StorefrontProvider via useRef and provided
+ * through React Context — eliminates module duplication in Turbopack.
+ *
+ * KEY PRINCIPLE: URL is the single source of truth for language.
+ * - next-intl middleware uses `preferred-language` cookie (custom name via localeCookie.name)
+ * - This store tracks the active language for SDK X-Lang header
+ * - setLanguage() persists to `preferred-language` cookie
+ * - initialize() sets defaultLanguage and supportedLanguages from Shop query
+ * - setLanguage() is called by LanguageSyncProvider when URL locale changes
+ *
+ * Single `preferred-language` cookie serves both:
+ * - next-intl middleware (locale detection/routing, via localeCookie.name override)
+ * - SDK language store (X-Lang header, framework-agnostic)
+ */
+import type { ShopConfig } from '../types/shop-config';
+export interface LanguageStore {
+    defaultLanguage: string | null;
+    supportedLanguages: string[];
+    language: string | null;
+    isLoaded: boolean;
+    initialize: (shopData: ShopConfig) => void;
+    setLanguage: (language: string) => void;
+}
+export declare const createLanguageStore: (initialLanguage?: string | null) => import("zustand").StoreApi<LanguageStore>;
+export declare const selectLanguage: (state: LanguageStore) => string | null;
+export declare const selectDefaultLanguage: (state: LanguageStore) => string | null;
+export declare const selectSupportedLanguages: (state: LanguageStore) => string[];
+export declare const selectLanguageIsLoaded: (state: LanguageStore) => boolean;
+//# sourceMappingURL=language.store.d.ts.map

package/dist/react/stores/language.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/language.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvD,MAAM,WAAW,aAAa;IAE5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAGlB,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,eAAO,MAAM,mBAAmB,GAAI,kBAAkB,MAAM,GAAG,IAAI,8CA4C9D,CAAC;AAMN,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,kBAAmB,CAAC;AACvE,eAAO,MAAM,qBAAqB,GAAI,OAAO,aAAa,kBAA0B,CAAC;AACrF,eAAO,MAAM,wBAAwB,GAAI,OAAO,aAAa,aAA6B,CAAC;AAC3F,eAAO,MAAM,sBAAsB,GAAI,OAAO,aAAa,YAAmB,CAAC"}

package/dist/react/stores/language.store.js

@@ -0,0 +1,67 @@
+/**
+ * Language store factory — tracks active language for SDK middleware.
+ *
+ * Creates a vanilla Zustand store (not a React hook singleton).
+ * Instance is created in StorefrontProvider via useRef and provided
+ * through React Context — eliminates module duplication in Turbopack.
+ *
+ * KEY PRINCIPLE: URL is the single source of truth for language.
+ * - next-intl middleware uses `preferred-language` cookie (custom name via localeCookie.name)
+ * - This store tracks the active language for SDK X-Lang header
+ * - setLanguage() persists to `preferred-language` cookie
+ * - initialize() sets defaultLanguage and supportedLanguages from Shop query
+ * - setLanguage() is called by LanguageSyncProvider when URL locale changes
+ *
+ * Single `preferred-language` cookie serves both:
+ * - next-intl middleware (locale detection/routing, via localeCookie.name override)
+ * - SDK language store (X-Lang header, framework-agnostic)
+ */
+import { createStore } from 'zustand/vanilla';
+import { LANGUAGE_COOKIE_NAME, LANGUAGE_COOKIE_MAX_AGE } from '../../core/language/cookie-config';
+import { getCookie, setCookie } from '../cookies';
+export const createLanguageStore = (initialLanguage) => createStore()((set, get) => ({
+    defaultLanguage: null,
+    supportedLanguages: [],
+    language: initialLanguage ?? null,
+    isLoaded: false,
+    initialize: (shopData) => {
+        const supported = shopData.supportedLanguages ?? [];
+        const current = get().language;
+        const saved = getCookie(LANGUAGE_COOKIE_NAME);
+        // Priority: current (from initialLanguage/URL) > cookie (validated) > default
+        const finalLanguage = current && (supported.length === 0 || supported.includes(current))
+            ? current
+            : saved && (supported.length === 0 || supported.includes(saved))
+                ? saved
+                : shopData.defaultLanguage ?? null;
+        set({
+            defaultLanguage: shopData.defaultLanguage ?? null,
+            supportedLanguages: supported,
+            language: finalLanguage,
+            isLoaded: true,
+        });
+        // Persist cookie if determined from fallback (not already saved)
+        if (finalLanguage && finalLanguage !== saved) {
+            setCookie(LANGUAGE_COOKIE_NAME, finalLanguage, { maxAge: LANGUAGE_COOKIE_MAX_AGE });
+        }
+    },
+    setLanguage: (language) => {
+        const { supportedLanguages } = get();
+        // Validate vs supported (bypass if empty — LanguageSyncProvider may call before initialize)
+        if (supportedLanguages.length > 0 && !supportedLanguages.includes(language)) {
+            console.warn(`[LanguageStore] Language ${language} not supported`);
+            return;
+        }
+        if (get().language === language)
+            return;
+        setCookie(LANGUAGE_COOKIE_NAME, language, { maxAge: LANGUAGE_COOKIE_MAX_AGE });
+        set({ language });
+    },
+}));
+// ---------------------------------------------------------------------------
+// Selectors (for use with useLanguageStore(selector))
+// ---------------------------------------------------------------------------
+export const selectLanguage = (state) => state.language;
+export const selectDefaultLanguage = (state) => state.defaultLanguage;
+export const selectSupportedLanguages = (state) => state.supportedLanguages;
+export const selectLanguageIsLoaded = (state) => state.isLoaded;

package/dist/react/stores/store-context.d.ts

@@ -11,8 +11,10 @@
 import { type StoreApi } from 'zustand';
 import type { AuthStore } from './auth.store';
 import type { CurrencyStore } from './currency.store';
+import type { LanguageStore } from './language.store';
 export declare const AuthStoreContext: import("react").Context<StoreApi<AuthStore> | null>;
 export declare const CurrencyStoreContext: import("react").Context<StoreApi<CurrencyStore> | null>;
+export declare const LanguageStoreContext: import("react").Context<StoreApi<LanguageStore> | null>;
 export declare function useAuthStore(): AuthStore;
 export declare function useAuthStore<T>(selector: (s: AuthStore) => T): T;
 export declare function useAuthStoreApi(): StoreApi<AuthStore>;
@@ -24,4 +26,7 @@ export declare function useAuthHydrated(): boolean;
 export declare function useCurrencyStore(): CurrencyStore;
 export declare function useCurrencyStore<T>(selector: (s: CurrencyStore) => T): T;
 export declare function useCurrencyStoreApi(): StoreApi<CurrencyStore>;
+export declare function useLanguageStore(): LanguageStore;
+export declare function useLanguageStore<T>(selector: (s: LanguageStore) => T): T;
+export declare function useLanguageStoreApi(): StoreApi<LanguageStore>;
 //# sourceMappingURL=store-context.d.ts.map

package/dist/react/stores/store-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-context.d.ts","sourceRoot":"","sources":["../../../src/react/stores/store-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtD,eAAO,MAAM,gBAAgB,qDAAkD,CAAC;AAChF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AAMxF,wBAAgB,YAAY,IAAI,SAAS,CAAC;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAAC;AAQlE,wBAAgB,eAAe,IAAI,QAAQ,CAAC,SAAS,CAAC,CAIrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAczC;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D"}
+{"version":3,"file":"store-context.d.ts","sourceRoot":"","sources":["../../../src/react/stores/store-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtD,eAAO,MAAM,gBAAgB,qDAAkD,CAAC;AAChF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AACxF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AAMxF,wBAAgB,YAAY,IAAI,SAAS,CAAC;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAAC;AAQlE,wBAAgB,eAAe,IAAI,QAAQ,CAAC,SAAS,CAAC,CAIrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAczC;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D"}

package/dist/react/stores/store-context.js

@@ -16,6 +16,7 @@ import { useStore } from 'zustand';
 // ---------------------------------------------------------------------------
 export const AuthStoreContext = createContext(null);
 export const CurrencyStoreContext = createContext(null);
+export const LanguageStoreContext = createContext(null);
 export function useAuthStore(selector) {
     const store = useContext(AuthStoreContext);
     if (!store)
@@ -60,3 +61,16 @@ export function useCurrencyStoreApi() {
         throw new Error('useCurrencyStoreApi must be used within StorefrontProvider');
     return store;
 }
+export function useLanguageStore(selector) {
+    const store = useContext(LanguageStoreContext);
+    if (!store)
+        throw new Error('useLanguageStore must be used within StorefrontProvider');
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return selector ? useStore(store, selector) : useStore(store);
+}
+export function useLanguageStoreApi() {
+    const store = useContext(LanguageStoreContext);
+    if (!store)
+        throw new Error('useLanguageStoreApi must be used within StorefrontProvider');
+    return store;
+}

package/dist/react/types/shop-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ShopConfig — full shop configuration from backend shop query.
+ *
+ * Flat interface — new features added here directly.
+ * Each concern is consumed by its own provider internally.
+ */
+import type { BotProtectionConfig } from '../../core/middleware/bot-protection';
+export interface ShopConfig {
+    currencyCode: string;
+    supportedCurrencies: string[];
+    localeToCurrencyMap?: Array<{
+        locale: string;
+        currency: string;
+    }>;
+    defaultLanguage?: string | null;
+    supportedLanguages?: string[] | null;
+    botProtection?: BotProtectionConfig | null;
+}
+//# sourceMappingURL=shop-config.d.ts.map

package/dist/react/types/shop-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shop-config.d.ts","sourceRoot":"","sources":["../../../src/react/types/shop-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,MAAM,WAAW,UAAU;IAEzB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGlE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAGrC,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC5C"}

package/dist/react/types/shop-config.js

@@ -0,0 +1,7 @@
+/**
+ * ShopConfig — full shop configuration from backend shop query.
+ *
+ * Flat interface — new features added here directly.
+ * Each concern is consumed by its own provider internally.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
   "type": "module",
   "types": "dist/core/index.d.ts",