@doswiftly/storefront-sdk 4.0.0 → 4.2.0

package/dist/react/cookies.js

@@ -15,12 +15,17 @@ export function getCookie(name) {
 }
 /**
  * Set cookie (client-side only).
+ *
+ * `secure` defaults to auto-detect from `location.protocol` (true on HTTPS).
  */
 export function setCookie(name, value, options = {}) {
     if (typeof document === 'undefined')
         return;
     const { maxAge = 365 * 24 * 60 * 60, path = '/', sameSite = 'lax' } = options;
-    document.cookie = `${name}=${encodeURIComponent(value)};max-age=${maxAge};path=${path};samesite=${sameSite}`;
+    const secure = options.secure ??
+        (typeof location !== 'undefined' && location.protocol === 'https:');
+    const securePart = secure ? ';secure' : '';
+    document.cookie = `${name}=${encodeURIComponent(value)};max-age=${maxAge};path=${path};samesite=${sameSite}${securePart}`;
 }
 /**
  * Delete cookie (client-side only).
@@ -30,6 +35,8 @@ export function deleteCookie(name, path = '/') {
         return;
     document.cookie = `${name}=;max-age=0;path=${path}`;
 }
+import { CURRENCY_COOKIE_NAME } from '../core/currency/cookie-config';
+import { CART_COOKIE_NAME } from '../core/cart/cookie-config';
 /**
  * Get preferred currency from cookie (async — works with Next.js cookies()).
  * Falls back to document.cookie on client.
@@ -39,11 +46,37 @@ export async function getCurrencyFromCookieAsync() {
     try {
         const { cookies } = await import('next/headers');
         const cookieStore = await cookies();
-        return cookieStore.get('preferred-currency')?.value ?? null;
+        return cookieStore.get(CURRENCY_COOKIE_NAME)?.value ?? null;
+    }
+    catch {
+        // Not in a server context or next not available
+    }
+    // Client-side fallback
+    return getCookie(CURRENCY_COOKIE_NAME);
+}
+/**
+ * Get cart ID from cookie (async — works with Next.js cookies()).
+ * Falls back to document.cookie on client.
+ *
+ * Use in Server Components for SSR cart badge:
+ * ```typescript
+ * const cartId = await getCartIdFromCookieAsync();
+ * if (cartId) {
+ *   const cart = await fetchCart(cartId);
+ *   // Render cart badge with real totalQuantity — no skeleton needed
+ * }
+ * ```
+ */
+export async function getCartIdFromCookieAsync() {
+    // Server-side: try Next.js cookies()
+    try {
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        return cookieStore.get(CART_COOKIE_NAME)?.value ?? null;
     }
     catch {
         // Not in a server context or next not available
     }
     // Client-side fallback
-    return getCookie('preferred-currency');
+    return getCookie(CART_COOKIE_NAME);
 }

package/dist/react/hooks/use-bot-protection.d.ts

@@ -0,0 +1,16 @@
+/**
+ * useBotProtection — escape hatch hook for custom bot protection use cases.
+ *
+ * Normally the middleware handles token injection automatically.
+ * Use this hook only when you need manual control (e.g. custom forms).
+ */
+export declare function useBotProtection(): {
+    /** Execute a bot protection challenge and get a token */
+    execute: (options?: {
+        action?: string;
+        timeoutMs?: number;
+    }) => Promise<string | null>;
+    /** Whether bot protection is configured and available */
+    isAvailable: boolean;
+};
+//# sourceMappingURL=use-bot-protection.d.ts.map

package/dist/react/hooks/use-bot-protection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bot-protection.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-bot-protection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,wBAAgB,gBAAgB;IAa5B,yDAAyD;wBAR9C;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAUlD,yDAAyD;;EAG5D"}

package/dist/react/hooks/use-bot-protection.js

@@ -0,0 +1,24 @@
+/**
+ * useBotProtection — escape hatch hook for custom bot protection use cases.
+ *
+ * Normally the middleware handles token injection automatically.
+ * Use this hook only when you need manual control (e.g. custom forms).
+ */
+'use client';
+import { useContext, useCallback } from 'react';
+import { BotProtectionContext } from '../bot-protection/bot-protection-context';
+export function useBotProtection() {
+    const ctx = useContext(BotProtectionContext);
+    const manager = ctx?.manager ?? null;
+    const execute = useCallback((options) => {
+        if (!manager)
+            return Promise.resolve(null);
+        return manager.execute(options);
+    }, [manager]);
+    return {
+        /** Execute a bot protection challenge and get a token */
+        execute,
+        /** Whether bot protection is configured and available */
+        isAvailable: !!manager,
+    };
+}

package/dist/react/index.d.ts

@@ -14,17 +14,26 @@
 export { StorefrontProvider, type StorefrontProviderProps } from './providers/storefront-provider';
 export { StorefrontClientProvider, type StorefrontClientProviderProps } from './providers/storefront-client-provider';
 export { CurrencyProvider, type CurrencyProviderProps } from './providers/currency-provider';
+export { LanguageProvider, type LanguageProviderProps } from './providers/language-provider';
 export { useAuth, type UseAuthOptions, type LoginResult, type LogoutResult, type TokenRenewResult } from './hooks/use-auth';
 export { useCartManager } from './hooks/use-cart-manager';
 export { useStorefrontClient } from './hooks/use-storefront-client';
 export { useCurrency } from './hooks/use-currency';
 export { useAuthStore, useAuthStoreApi, useAuthHydrated } from './stores/store-context';
 export { useCurrencyStore, useCurrencyStoreApi } from './stores/store-context';
+export { useLanguageStore, useLanguageStoreApi } from './stores/store-context';
 export type { AuthStore, CustomerInfo } from './stores/auth.store';
 export type { CurrencyStore, ShopCurrencyData } from './stores/currency.store';
+export type { LanguageStore } from './stores/language.store';
+export type { ShopConfig } from './types/shop-config';
 export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
-export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync } from './cookies';
+export { selectLanguage, selectDefaultLanguage, selectSupportedLanguages, selectLanguageIsLoaded } from './stores/language.store';
+export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync } from './cookies';
+export { useBotProtection } from './hooks/use-bot-protection';
 export { useHydrated } from './hooks/use-hydrated';
 export { useDebouncedValue } from './hooks/use-debounced-value';
+export { createCartStore, selectCartId, selectIsCartOpen, selectCartIsLoading, } from './stores/cart.store';
+export type { CartState, CartStoreConfig, CartActions, CartData, CartMutationAction, CartLineInput, CartLineUpdateInput, } from './stores/cart.store';
+export { CartProvider, useCartStore, useCartStoreApi } from './stores/cart.context';
 export { createStoreContext } from './helpers/create-store-context';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,KAAK,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG7F,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5H,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG/E,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGxH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,KAAK,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG7F,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5H,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG/E,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGlI,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/react/index.js

@@ -15,6 +15,7 @@
 export { StorefrontProvider } from './providers/storefront-provider';
 export { StorefrontClientProvider } from './providers/storefront-client-provider';
 export { CurrencyProvider } from './providers/currency-provider';
+export { LanguageProvider } from './providers/language-provider';
 // Hooks
 export { useAuth } from './hooks/use-auth';
 export { useCartManager } from './hooks/use-cart-manager';
@@ -23,12 +24,19 @@ export { useCurrency } from './hooks/use-currency';
 // Store hooks (Context-based)
 export { useAuthStore, useAuthStoreApi, useAuthHydrated } from './stores/store-context';
 export { useCurrencyStore, useCurrencyStoreApi } from './stores/store-context';
+export { useLanguageStore, useLanguageStoreApi } from './stores/store-context';
 // Selectors
 export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
+export { selectLanguage, selectDefaultLanguage, selectSupportedLanguages, selectLanguageIsLoaded } from './stores/language.store';
 // Cookie utilities
-export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync } from './cookies';
+export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync } from './cookies';
+// Bot protection
+export { useBotProtection } from './hooks/use-bot-protection';
 // Generic hooks
 export { useHydrated } from './hooks/use-hydrated';
 export { useDebouncedValue } from './hooks/use-debounced-value';
+// Cart store (DI-based)
+export { createCartStore, selectCartId, selectIsCartOpen, selectCartIsLoading, } from './stores/cart.store';
+export { CartProvider, useCartStore, useCartStoreApi } from './stores/cart.context';
 // Store context helper
 export { createStoreContext } from './helpers/create-store-context';

package/dist/react/providers/language-provider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LanguageProvider — initializes language store from Shop data.
+ *
+ * Thin wrapper that calls useLanguageStore.initialize() on mount
+ * with the shop's language configuration from the server.
+ *
+ * NOTE: This only sets defaultLanguage and supportedLanguages.
+ * The active `language` is set by the template's LanguageSyncProvider
+ * which reads locale from the URL (via next-intl) and calls setLanguage().
+ */
+import React from 'react';
+import type { ShopConfig } from '../types/shop-config';
+export interface LanguageProviderProps {
+    children: React.ReactNode;
+    shopData: ShopConfig;
+}
+export declare function LanguageProvider({ children, shopData }: LanguageProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=language-provider.d.ts.map

package/dist/react/providers/language-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/language-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CAW7E"}

package/dist/react/providers/language-provider.js

@@ -0,0 +1,24 @@
+/**
+ * LanguageProvider — initializes language store from Shop data.
+ *
+ * Thin wrapper that calls useLanguageStore.initialize() on mount
+ * with the shop's language configuration from the server.
+ *
+ * NOTE: This only sets defaultLanguage and supportedLanguages.
+ * The active `language` is set by the template's LanguageSyncProvider
+ * which reads locale from the URL (via next-intl) and calls setLanguage().
+ */
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { useLanguageStore } from '../stores/store-context';
+export function LanguageProvider({ children, shopData }) {
+    const initialize = useLanguageStore((s) => s.initialize);
+    const isLoaded = useLanguageStore((s) => s.isLoaded);
+    useEffect(() => {
+        if (!isLoaded) {
+            initialize(shopData);
+        }
+    }, [initialize, isLoaded, shopData]);
+    return _jsx(_Fragment, { children: children });
+}

package/dist/react/providers/storefront-client-provider.d.ts

@@ -9,6 +9,7 @@
 import React from 'react';
 import { CartClient } from '../../core/cart/cart-client';
 import { AuthClient } from '../../core/auth/auth-client';
+import { type BotProtectionTokenProvider } from '../../core/middleware/bot-protection';
 import type { StorefrontClient, StorefrontClientConfig, Middleware } from '../../core/client/types';
 export interface StorefrontClientContextValue {
     client: StorefrontClient;
@@ -20,11 +21,15 @@ export interface StorefrontClientProviderProps {
     config: StorefrontClientConfig;
     /**
      * Additional middleware to prepend to the default pipeline.
-     * Default pipeline: auth → currency → [custom] → retry → timeout → errors
+     * Default pipeline: auth → currency → bot-protection → [custom] → retry → timeout → errors
      */
     middleware?: Middleware[];
+    /** Bot protection token provider (created by StorefrontProvider) */
+    botProtection?: BotProtectionTokenProvider | null;
+    /** Operations that require bot protection (from shop query) */
+    botProtectionOperations?: string[];
 }
-export declare function StorefrontClientProvider({ children, config, middleware: customMiddleware, }: StorefrontClientProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function StorefrontClientProvider({ children, config, middleware: customMiddleware, botProtection, botProtectionOperations, }: StorefrontClientProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Get StorefrontClient context value.
  * Must be used within StorefrontClientProvider.

package/dist/react/providers/storefront-client-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-client-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/storefront-client-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAOzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB;AAID,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,UAAU,EAAE,gBAAqB,GAClC,EAAE,6BAA6B,2CAgC/B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,4BAA4B,CAMzE"}
+{"version":3,"file":"storefront-client-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/storefront-client-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAIzD,OAAO,EAA2B,KAAK,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAKhH,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB;AAID,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,oEAAoE;IACpE,aAAa,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAClD,+DAA+D;IAC/D,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,UAAU,EAAE,gBAAqB,EACjC,aAAa,EACb,uBAAuB,GACxB,EAAE,6BAA6B,2CAyC/B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,4BAA4B,CAMzE"}

package/dist/react/providers/storefront-client-provider.js

@@ -14,14 +14,17 @@ import { CartClient } from '../../core/cart/cart-client';
 import { AuthClient } from '../../core/auth/auth-client';
 import { authMiddleware } from '../../core/middleware/auth';
 import { currencyMiddleware } from '../../core/middleware/currency';
+import { languageMiddleware } from '../../core/middleware/language';
+import { botProtectionMiddleware } from '../../core/middleware/bot-protection';
 import { retryMiddleware } from '../../core/middleware/retry';
 import { timeoutMiddleware } from '../../core/middleware/timeout';
 import { errorMiddleware } from '../../core/middleware/errors';
-import { useAuthStoreApi, useCurrencyStoreApi } from '../stores/store-context';
+import { useAuthStoreApi, useCurrencyStoreApi, useLanguageStoreApi } from '../stores/store-context';
 const StorefrontClientContext = createContext(null);
-export function StorefrontClientProvider({ children, config, middleware: customMiddleware = [], }) {
+export function StorefrontClientProvider({ children, config, middleware: customMiddleware = [], botProtection, botProtectionOperations, }) {
     const authStore = useAuthStoreApi();
     const currencyStore = useCurrencyStoreApi();
+    const languageStore = useLanguageStoreApi();
     const value = useMemo(() => {
         const client = createStorefrontClient({
             ...config,
@@ -29,6 +32,14 @@ export function StorefrontClientProvider({ children, config, middleware: customM
                 // Header middleware (runs first)
                 authMiddleware(() => authStore.getState().accessToken),
                 currencyMiddleware(() => currencyStore.getState().currency),
+                languageMiddleware(() => languageStore.getState().language),
+                // Bot protection (if configured)
+                ...(botProtection && botProtectionOperations?.length
+                    ? [botProtectionMiddleware({
+                            tokenProvider: botProtection,
+                            protectedOperations: botProtectionOperations,
+                        })]
+                    : []),
                 // Custom middleware from props
                 ...customMiddleware,
                 // Infrastructure middleware (runs last)
@@ -41,7 +52,7 @@ export function StorefrontClientProvider({ children, config, middleware: customM
         const authClient = new AuthClient(client);
         return { client, cartClient, authClient };
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [config.apiUrl, config.shopSlug, authStore, currencyStore]);
+    }, [config.apiUrl, config.shopSlug, authStore, currencyStore, languageStore]);
     return (_jsx(StorefrontClientContext.Provider, { value: value, children: children }));
 }
 /**

package/dist/react/providers/storefront-provider.d.ts

@@ -37,6 +37,12 @@ export interface StorefrontProviderProps extends StorefrontClientProviderProps {
      * Read from cookies() in a Server Component (layout.tsx) and pass here.
      */
     initialIsAuthenticated?: boolean;
+    /**
+     * Server-side language hint — pass the URL locale from next-intl params.
+     * Eliminates flash of wrong language on first render by initializing the
+     * language store with the correct value from the server.
+     */
+    initialLanguage?: string;
 }
-export declare function StorefrontProvider({ children, config, middleware, shopData, initialIsAuthenticated, }: StorefrontProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function StorefrontProvider({ children, config, middleware, shopData, initialIsAuthenticated, initialLanguage, }: StorefrontProviderProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=storefront-provider.d.ts.map

package/dist/react/providers/storefront-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/storefront-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,EAA4B,KAAK,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC5G,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,MAAM,WAAW,uBAAwB,SAAQ,6BAA6B;IAC5E,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC5C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,sBAAsB,GACvB,EAAE,uBAAuB,2CAezB"}
+{"version":3,"file":"storefront-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/storefront-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASH,OAAO,EAA4B,KAAK,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC5G,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAMnF,MAAM,WAAW,uBAAwB,SAAQ,6BAA6B;IAC5E,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC5C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,sBAAsB,EACtB,eAAe,GAChB,EAAE,uBAAuB,2CA+BzB"}

package/dist/react/providers/storefront-provider.js

@@ -26,15 +26,22 @@
  * ```
  */
 'use client';
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useRef } from 'react';
-import { AuthStoreContext, CurrencyStoreContext } from '../stores/store-context';
+import { AuthStoreContext, CurrencyStoreContext, LanguageStoreContext } from '../stores/store-context';
 import { createAuthStore } from '../stores/auth.store';
 import { createCurrencyStore } from '../stores/currency.store';
+import { createLanguageStore } from '../stores/language.store';
 import { StorefrontClientProvider } from './storefront-client-provider';
 import { CurrencyProvider } from './currency-provider';
-export function StorefrontProvider({ children, config, middleware, shopData, initialIsAuthenticated, }) {
+import { LanguageProvider } from './language-provider';
+import { createBotProtectionManager } from '../../core/bot-protection/create-manager';
+import { BotProtectionContext } from '../bot-protection/bot-protection-context';
+import { BotProtectionWidget } from '../bot-protection/bot-protection-widget';
+export function StorefrontProvider({ children, config, middleware, shopData, initialIsAuthenticated, initialLanguage, }) {
     const authStoreRef = useRef(createAuthStore(initialIsAuthenticated));
     const currencyStoreRef = useRef(createCurrencyStore());
-    return (_jsx(AuthStoreContext.Provider, { value: authStoreRef.current, children: _jsx(CurrencyStoreContext.Provider, { value: currencyStoreRef.current, children: _jsx(StorefrontClientProvider, { config: config, middleware: middleware, children: _jsx(CurrencyProvider, { shopData: shopData, children: children }) }) }) }));
+    const languageStoreRef = useRef(createLanguageStore(initialLanguage));
+    const botProtectionRef = useRef(shopData.botProtection ? createBotProtectionManager(shopData.botProtection) : null);
+    return (_jsx(AuthStoreContext.Provider, { value: authStoreRef.current, children: _jsx(CurrencyStoreContext.Provider, { value: currencyStoreRef.current, children: _jsx(LanguageStoreContext.Provider, { value: languageStoreRef.current, children: _jsx(StorefrontClientProvider, { config: config, middleware: middleware, botProtection: botProtectionRef.current, botProtectionOperations: shopData.botProtection?.protectedOperations, children: _jsx(BotProtectionContext.Provider, { value: { manager: botProtectionRef.current }, children: _jsx(CurrencyProvider, { shopData: shopData, children: _jsxs(LanguageProvider, { shopData: shopData, children: [_jsx(BotProtectionWidget, { manager: botProtectionRef.current }), children] }) }) }) }) }) }) }));
 }

package/dist/react/stores/cart.context.d.ts

@@ -0,0 +1,12 @@
+import type { CartState } from './cart.store';
+export declare const CartProvider: {
+    ({ store, children }: {
+        store: import("zustand").StoreApi<CartState>;
+        children: import("react").ReactNode;
+    }): import("react").FunctionComponentElement<import("react").ProviderProps<import("zustand").StoreApi<CartState> | null>>;
+    displayName: string;
+}, useCartStore: {
+    (): CartState;
+    <U>(selector: (s: CartState) => U): U;
+}, useCartStoreApi: () => import("zustand").StoreApi<CartState>;
+//# sourceMappingURL=cart.context.d.ts.map

package/dist/react/stores/cart.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.context.d.ts","sourceRoot":"","sources":["../../../src/react/stores/cart.context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MACK,YAAY;;;;;;GACZ,YAAY;;;GACd,eAAe,6CACqB,CAAC"}

package/dist/react/stores/cart.context.js

@@ -0,0 +1,3 @@
+'use client';
+import { createStoreContext } from '../helpers/create-store-context';
+export const { Provider: CartProvider, useStore: useCartStore, useApi: useCartStoreApi, } = createStoreContext('CartStore');

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

@@ -0,0 +1,71 @@
+/**
+ * Cart Store — DI-based cart state management with cookie persistence.
+ *
+ * SDK orchestrates cart lifecycle (init, mutations, error handling).
+ * Template provides CartActions implementation via DI (getActions getter).
+ * Cart ID persisted in cookie (SSR/edge visible) — follows currency store pattern.
+ *
+ * @example
+ * ```typescript
+ * import { createCartStore, type CartActions } from '@doswiftly/storefront-sdk/react';
+ *
+ * const actions: CartActions = {
+ *   fetchCart: async (cartId) => api.getCart(cartId),
+ *   createCart: async () => api.createCart().then(c => c.id),
+ *   addLines: async (cartId, lines) => api.addLines(cartId, lines),
+ *   updateLines: async (cartId, lines) => api.updateLines(cartId, lines),
+ *   removeLines: async (cartId, lineIds) => api.removeLines(cartId, lineIds),
+ * };
+ *
+ * const store = createCartStore({ getActions: () => actions });
+ * ```
+ */
+import type { CartLineInput, CartLineUpdateInput } from '../../core/cart/types';
+export type { CartLineInput, CartLineUpdateInput } from '../../core/cart/types';
+/** Minimal cart data returned by DI actions. */
+export interface CartData {
+    id: string;
+    totalQuantity: number;
+}
+/** DI contract — template implements these methods. */
+export interface CartActions {
+    /** Fetch cart by ID. Return null if cart expired/not found. */
+    fetchCart: (cartId: string) => Promise<CartData | null>;
+    /** Create new empty cart. Return new cart ID. */
+    createCart: () => Promise<string>;
+    /** Add line items. Return updated cart or throw. */
+    addLines: (cartId: string, lines: CartLineInput[]) => Promise<CartData>;
+    /** Update line quantities. Return updated cart or throw. */
+    updateLines: (cartId: string, lines: CartLineUpdateInput[]) => Promise<CartData>;
+    /** Remove line items. Return updated cart or throw. */
+    removeLines: (cartId: string, lineIds: string[]) => Promise<CartData>;
+}
+/** Action names passed to mutation callbacks. */
+export type CartMutationAction = 'initCart' | 'addToCart' | 'updateQuantity' | 'removeFromCart';
+export interface CartStoreConfig {
+    /** Getter for DI actions — called on every operation (not captured). */
+    getActions: () => CartActions;
+    /** Called after successful mutation. */
+    onMutationSuccess?: (action: CartMutationAction, cart: CartData) => void;
+    /** Called on mutation error. */
+    onMutationError?: (action: CartMutationAction, error: unknown) => void;
+}
+export interface CartState {
+    cartId: string | null;
+    isOpen: boolean;
+    isLoading: boolean;
+    error: unknown | null;
+    openCart: () => void;
+    closeCart: () => void;
+    toggleCart: () => void;
+    initCart: () => Promise<void>;
+    addToCart: (lines: CartLineInput[]) => Promise<void>;
+    updateQuantity: (lines: CartLineUpdateInput[]) => Promise<void>;
+    removeFromCart: (lineIds: string[]) => Promise<void>;
+    clearCart: () => void;
+}
+export declare const selectCartId: (state: CartState) => string | null;
+export declare const selectIsCartOpen: (state: CartState) => boolean;
+export declare const selectCartIsLoading: (state: CartState) => boolean;
+export declare function createCartStore(config: CartStoreConfig): import("zustand").StoreApi<CartState>;
+//# sourceMappingURL=cart.store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/cart.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAKhF,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMhF,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD,iDAAiD;IACjD,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,oDAAoD;IACpD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE,4DAA4D;IAC5D,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjF,uDAAuD;IACvD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAMD,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,UAAU,EAAE,MAAM,WAAW,CAAC;IAC9B,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACzE,gCAAgC;IAChC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACxE;AAMD,MAAM,WAAW,SAAS;IAExB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAGtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IAGvB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAMD,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,kBAAiB,CAAC;AAC/D,eAAO,MAAM,gBAAgB,GAAI,OAAO,SAAS,YAAiB,CAAC;AACnE,eAAO,MAAM,mBAAmB,GAAI,OAAO,SAAS,YAAoB,CAAC;AAMzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,yCAkJtD"}

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

@@ -0,0 +1,166 @@
+/**
+ * Cart Store — DI-based cart state management with cookie persistence.
+ *
+ * SDK orchestrates cart lifecycle (init, mutations, error handling).
+ * Template provides CartActions implementation via DI (getActions getter).
+ * Cart ID persisted in cookie (SSR/edge visible) — follows currency store pattern.
+ *
+ * @example
+ * ```typescript
+ * import { createCartStore, type CartActions } from '@doswiftly/storefront-sdk/react';
+ *
+ * const actions: CartActions = {
+ *   fetchCart: async (cartId) => api.getCart(cartId),
+ *   createCart: async () => api.createCart().then(c => c.id),
+ *   addLines: async (cartId, lines) => api.addLines(cartId, lines),
+ *   updateLines: async (cartId, lines) => api.updateLines(cartId, lines),
+ *   removeLines: async (cartId, lineIds) => api.removeLines(cartId, lineIds),
+ * };
+ *
+ * const store = createCartStore({ getActions: () => actions });
+ * ```
+ */
+import { createStore } from 'zustand/vanilla';
+import { CART_COOKIE_NAME, CART_COOKIE_MAX_AGE } from '../../core/cart/cookie-config';
+import { getCookie, setCookie, deleteCookie } from '../cookies';
+// ---------------------------------------------------------------------------
+// Selectors
+// ---------------------------------------------------------------------------
+export const selectCartId = (state) => state.cartId;
+export const selectIsCartOpen = (state) => state.isOpen;
+export const selectCartIsLoading = (state) => state.isLoading;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createCartStore(config) {
+    // Deduplication: shared Promise in closure (not in state)
+    let initPromise = null;
+    // Read initial cartId from cookie (client-side only, returns null on server)
+    const initialCartId = getCookie(CART_COOKIE_NAME);
+    // Clean up old localStorage entry from pre-cookie era (v1 persist)
+    if (typeof localStorage !== 'undefined') {
+        try {
+            localStorage.removeItem('cart-storage');
+        }
+        catch { /* ignore */ }
+    }
+    async function performInit(set, get) {
+        const actions = config.getActions();
+        set({ isLoading: true, error: null });
+        try {
+            const currentCartId = get().cartId;
+            if (currentCartId) {
+                const cart = await actions.fetchCart(currentCartId);
+                if (cart) {
+                    // Cart exists — keep current cartId
+                    set({ isLoading: false });
+                    return;
+                }
+                // Cart expired — fall through to create
+            }
+            // No cart or expired — create new
+            const newCartId = await actions.createCart();
+            set({ cartId: newCartId, isLoading: false, error: null });
+        }
+        catch (error) {
+            set({ error, isLoading: false });
+            config.onMutationError?.('initCart', error);
+        }
+    }
+    const store = createStore()((set, get) => ({
+        // State — initialCartId from cookie
+        cartId: initialCartId,
+        isOpen: false,
+        isLoading: false,
+        error: null,
+        // UI Actions
+        openCart: () => set({ isOpen: true }),
+        closeCart: () => set({ isOpen: false }),
+        toggleCart: () => set((state) => ({ isOpen: !state.isOpen })),
+        // Orchestrated: initCart (deduplicated)
+        initCart: async () => {
+            if (initPromise)
+                return initPromise;
+            initPromise = performInit(set, get).finally(() => {
+                initPromise = null;
+            });
+            return initPromise;
+        },
+        // Orchestrated: addToCart (auto-init if no cartId)
+        addToCart: async (lines) => {
+            const actions = config.getActions();
+            set({ isLoading: true, error: null });
+            try {
+                let cartId = get().cartId;
+                if (!cartId) {
+                    await get().initCart();
+                    cartId = get().cartId;
+                }
+                if (!cartId) {
+                    throw new Error('Failed to initialize cart');
+                }
+                const cart = await actions.addLines(cartId, lines);
+                set({ isLoading: false, error: null });
+                config.onMutationSuccess?.('addToCart', cart);
+            }
+            catch (error) {
+                set({ error, isLoading: false });
+                config.onMutationError?.('addToCart', error);
+            }
+        },
+        // Orchestrated: updateQuantity (error if no cartId)
+        updateQuantity: async (lines) => {
+            const actions = config.getActions();
+            const cartId = get().cartId;
+            if (!cartId) {
+                const err = new Error('Cannot update quantity: no cart exists');
+                set({ error: err });
+                config.onMutationError?.('updateQuantity', err);
+                return;
+            }
+            set({ isLoading: true, error: null });
+            try {
+                const cart = await actions.updateLines(cartId, lines);
+                set({ isLoading: false, error: null });
+                config.onMutationSuccess?.('updateQuantity', cart);
+            }
+            catch (error) {
+                set({ error, isLoading: false });
+                config.onMutationError?.('updateQuantity', error);
+            }
+        },
+        // Orchestrated: removeFromCart (silent return if no cartId)
+        removeFromCart: async (lineIds) => {
+            const cartId = get().cartId;
+            if (!cartId)
+                return;
+            const actions = config.getActions();
+            set({ isLoading: true, error: null });
+            try {
+                const cart = await actions.removeLines(cartId, lineIds);
+                set({ isLoading: false, error: null });
+                config.onMutationSuccess?.('removeFromCart', cart);
+            }
+            catch (error) {
+                set({ error, isLoading: false });
+                config.onMutationError?.('removeFromCart', error);
+            }
+        },
+        // clearCart — reset all state
+        clearCart: () => {
+            set({ cartId: null, isOpen: false, isLoading: false, error: null });
+        },
+    }));
+    // Sync cartId changes to cookie (like currency store pattern)
+    store.subscribe((state, prevState) => {
+        if (state.cartId !== prevState.cartId) {
+            if (state.cartId) {
+                setCookie(CART_COOKIE_NAME, state.cartId, { maxAge: CART_COOKIE_MAX_AGE });
+            }
+            else {
+                deleteCookie(CART_COOKIE_NAME);
+            }
+        }
+    });
+    return store;
+}