@doswiftly/storefront-sdk 18.1.0 → 19.0.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 19.0.0
+
+### Major Changes
+
+- 7ee241f: Move the server-side cookie readers to the server entry and rename them for intent.
+
+  The two async cookie readers now live in `@doswiftly/storefront-sdk/react/server` (next to
+  `getInitialAuth`) and are renamed to describe what they read instead of how:
+
+  | Removed (from `@doswiftly/storefront-sdk/react`) | New (in `@doswiftly/storefront-sdk/react/server`) |
+  | ------------------------------------------------ | ------------------------------------------------- |
+  | `getCurrencyFromCookieAsync()`                   | `readCurrencyCookie()`                            |
+  | `getCartIdFromCookieAsync()`                     | `readCartIdCookie()`                              |
+
+  Both keep the same return type, `Promise<string | null>`, and read the same cookies
+  (`preferred-currency`, `cart-id`). They are still server-first with a `document.cookie` fallback,
+  so they remain safe to call from either side — these cookies are readable (not httpOnly).
+
+  `getCookie`, `setCookie`, `deleteCookie`, and `createBrowserCartCookieStore` are unchanged and
+  still exported from `@doswiftly/storefront-sdk/react`.
+
+  **Why**: the readers depend on `next/headers`, a server-only API, but were exported from the
+  client React entry — so the entry's own description ("client-side; for server use `next/headers`")
+  contradicted two of its functions. Moving them next to `getInitialAuth` keeps `next/headers` out of
+  the client entry and gives both cold-start cookie reads (auth, and now cart-id / currency) one home.
+
+  **Migration** — update the import path and the names:
+
+  ```ts
+  // Before — client React entry
+  import {
+    getCurrencyFromCookieAsync,
+    getCartIdFromCookieAsync,
+  } from "@doswiftly/storefront-sdk/react";
+  const currency = await getCurrencyFromCookieAsync();
+  const cartId = await getCartIdFromCookieAsync();
+
+  // After — server entry (use in a Server Component)
+  import {
+    readCurrencyCookie,
+    readCartIdCookie,
+  } from "@doswiftly/storefront-sdk/react/server";
+  const currency = await readCurrencyCookie();
+  const cartId = await readCartIdCookie();
+  ```
+
+  Reading the cart-id server-side is the supported way to resolve a returning buyer's cart on the
+  first render — including when a separate checkout deployment shares the storefront domain:
+
+  ```ts
+  // app/checkout/page.tsx (Server Component)
+  import { readCartIdCookie } from "@doswiftly/storefront-sdk/react/server";
+
+  const cartId = await readCartIdCookie();
+  const cart = cartId ? await fetchCart(cartId) : null;
+  ```
+
+  **Migration checklist**:
+  - [ ] Replace `getCurrencyFromCookieAsync` / `getCartIdFromCookieAsync` imports from
+        `@doswiftly/storefront-sdk/react` with `readCurrencyCookie` / `readCartIdCookie` from
+        `@doswiftly/storefront-sdk/react/server`.
+  - [ ] For purely client-side reads, use `getCookie('preferred-currency')` /
+        `getCookie('cart-id')` (or `createBrowserCartCookieStore()` for the cart id) from
+        `@doswiftly/storefront-sdk/react` instead.
+
 ## 18.1.0
 
 ### Minor Changes

package/dist/react/cookies.d.ts

@@ -1,8 +1,10 @@
 /**
- * Cookie utilities for SDK consumers.
+ * Client-side cookie utilities for SDK consumers.
  *
- * Simple, framework-agnostic cookie read/write for client-side.
- * For Next.js server-side cookies, use `cookies()` from next/headers.
+ * Synchronous read/write over `document.cookie`, SSR-safe via a `typeof document`
+ * guard (return null / no-op when there is no document). To read these cookies in
+ * a Next.js Server Component use the `@doswiftly/storefront-sdk/react/server`
+ * entry (`readCartIdCookie`, `readCurrencyCookie`).
  */
 /**
  * Get cookie value by name (client-side only).
@@ -44,23 +46,4 @@ import type { CartCookieStore } from '../core/cart/cart-recovery';
  * ```
  */
 export declare function createBrowserCartCookieStore(): CartCookieStore;
-/**
- * Get preferred currency from cookie (async — works with Next.js cookies()).
- * Falls back to document.cookie on client.
- */
-export declare function getCurrencyFromCookieAsync(): Promise<string | null>;
-/**
- * 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 declare function getCartIdFromCookieAsync(): Promise<string | null>;
 //# sourceMappingURL=cookies.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/react/cookies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACpF,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,IAAI,CAG3D;AAID,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,CAQ9D;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYvE"}
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/react/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACpF,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,IAAI,CAG3D;AAGD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,CAQ9D"}

package/dist/react/cookies.js

@@ -1,8 +1,10 @@
 /**
- * Cookie utilities for SDK consumers.
+ * Client-side cookie utilities for SDK consumers.
  *
- * Simple, framework-agnostic cookie read/write for client-side.
- * For Next.js server-side cookies, use `cookies()` from next/headers.
+ * Synchronous read/write over `document.cookie`, SSR-safe via a `typeof document`
+ * guard (return null / no-op when there is no document). To read these cookies in
+ * a Next.js Server Component use the `@doswiftly/storefront-sdk/react/server`
+ * entry (`readCartIdCookie`, `readCurrencyCookie`).
  */
 /**
  * Get cookie value by name (client-side only).
@@ -35,7 +37,6 @@ 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, CART_COOKIE_MAX_AGE } from '../core/cart/cookie-config';
 /**
  * Build a browser-side `CartCookieStore` backed by `document.cookie`.
@@ -65,46 +66,3 @@ export function createBrowserCartCookieStore() {
         clear: () => deleteCookie(CART_COOKIE_NAME),
     };
 }
-/**
- * Get preferred currency from cookie (async — works with Next.js cookies()).
- * Falls back to document.cookie on client.
- */
-export async function getCurrencyFromCookieAsync() {
-    // Server-side: try Next.js cookies()
-    try {
-        const { cookies } = await import('next/headers');
-        const cookieStore = await cookies();
-        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(CART_COOKIE_NAME);
-}

package/dist/react/index.d.ts

@@ -36,7 +36,7 @@ export type { LanguageStore } from './stores/language.store';
 export type { ShopConfig } from './types/shop-config';
 export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
 export { selectLanguage, selectDefaultLanguage, selectSupportedLanguages, selectLanguageIsLoaded } from './stores/language.store';
-export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync, createBrowserCartCookieStore, } from './cookies';
+export { getCookie, setCookie, deleteCookie, createBrowserCartCookieStore, } from './cookies';
 export { useBotProtection } from './hooks/use-bot-protection';
 export { useHydrated } from './hooks/use-hydrated';
 export { useDebouncedValue } from './hooks/use-debounced-value';

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;AAC7F,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,KAAK,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAG9H,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9H,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,KAAK,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACxM,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,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,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC;AAGnB,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,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,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;AAGpE,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,EACL,KAAK,mBAAmB,EACxB,SAAS,EACT,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,oBAAoB,EACzB,YAAY,EACZ,KAAK,iBAAiB,EACtB,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,wBAAwB,EACxB,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,GACpC,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/react/index.js

@@ -35,8 +35,9 @@ 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, getCartIdFromCookieAsync, createBrowserCartCookieStore, } from './cookies';
+// Cookie utilities (client-side). Server-side readers (readCartIdCookie,
+// readCurrencyCookie) live in `@doswiftly/storefront-sdk/react/server`.
+export { getCookie, setCookie, deleteCookie, createBrowserCartCookieStore, } from './cookies';
 // Bot protection
 export { useBotProtection } from './hooks/use-bot-protection';
 // Generic hooks

package/dist/react/server/cookie-readers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Server-first readers for the storefront's readable first-party cookies.
+ *
+ * `readCartIdCookie` / `readCurrencyCookie` return the `cart-id` /
+ * `preferred-currency` cookie value. They run server-first: in a Next.js Server
+ * Component they read the request cookies via `next/headers`; when that is
+ * unavailable (client bundle, build time, non-Next runtime) they fall back to
+ * `document.cookie`. This isomorphic behaviour is deliberate and safe here
+ * because both cookies are readable (NOT httpOnly) — unlike the auth token,
+ * which `getInitialAuth` reads server-only precisely because it is httpOnly.
+ *
+ * They live under `@doswiftly/storefront-sdk/react/server` so the `next/headers`
+ * dependency stays out of the client entry; the dynamic import keeps importing
+ * this module safe in runtimes without `next/headers`.
+ *
+ * @example
+ * ```tsx
+ * // app/checkout/page.tsx (Server Component)
+ * import { readCartIdCookie } from '@doswiftly/storefront-sdk/react/server';
+ *
+ * const cartId = await readCartIdCookie();
+ * const cart = cartId ? await fetchCart(cartId) : null;
+ * ```
+ */
+/** Read the first-party `cart-id` cookie (server-first, client fallback). */
+export declare function readCartIdCookie(): Promise<string | null>;
+/** Read the first-party `preferred-currency` cookie (server-first, client fallback). */
+export declare function readCurrencyCookie(): Promise<string | null>;
+//# sourceMappingURL=cookie-readers.d.ts.map

package/dist/react/server/cookie-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-readers.d.ts","sourceRoot":"","sources":["../../../src/react/server/cookie-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAuBH,6EAA6E;AAC7E,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/D;AAED,wFAAwF;AACxF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEjE"}

package/dist/react/server/cookie-readers.js

@@ -0,0 +1,52 @@
+/**
+ * Server-first readers for the storefront's readable first-party cookies.
+ *
+ * `readCartIdCookie` / `readCurrencyCookie` return the `cart-id` /
+ * `preferred-currency` cookie value. They run server-first: in a Next.js Server
+ * Component they read the request cookies via `next/headers`; when that is
+ * unavailable (client bundle, build time, non-Next runtime) they fall back to
+ * `document.cookie`. This isomorphic behaviour is deliberate and safe here
+ * because both cookies are readable (NOT httpOnly) — unlike the auth token,
+ * which `getInitialAuth` reads server-only precisely because it is httpOnly.
+ *
+ * They live under `@doswiftly/storefront-sdk/react/server` so the `next/headers`
+ * dependency stays out of the client entry; the dynamic import keeps importing
+ * this module safe in runtimes without `next/headers`.
+ *
+ * @example
+ * ```tsx
+ * // app/checkout/page.tsx (Server Component)
+ * import { readCartIdCookie } from '@doswiftly/storefront-sdk/react/server';
+ *
+ * const cartId = await readCartIdCookie();
+ * const cart = cartId ? await fetchCart(cartId) : null;
+ * ```
+ */
+import { CART_COOKIE_NAME } from '../../core/cart/cookie-config';
+import { CURRENCY_COOKIE_NAME } from '../../core/currency/cookie-config';
+import { getCookie } from '../cookies';
+/**
+ * Read a cookie server-first: the request cookies via `next/headers` in a Server
+ * Component, falling back to `document.cookie` on the client / outside a request
+ * scope. Returns null when the cookie is absent on both sides.
+ */
+async function readCookieIsomorphic(name) {
+    try {
+        const { cookies } = await import('next/headers');
+        const store = await cookies();
+        return store.get(name)?.value ?? null;
+    }
+    catch {
+        // No Next.js server request scope (client bundle, build time, non-Next
+        // runtime) — fall back to the client reader (null on the server).
+        return getCookie(name);
+    }
+}
+/** Read the first-party `cart-id` cookie (server-first, client fallback). */
+export async function readCartIdCookie() {
+    return readCookieIsomorphic(CART_COOKIE_NAME);
+}
+/** Read the first-party `preferred-currency` cookie (server-first, client fallback). */
+export async function readCurrencyCookie() {
+    return readCookieIsomorphic(CURRENCY_COOKIE_NAME);
+}

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

@@ -1,5 +1,6 @@
 export { getStorefrontClient, type ServerClientOptions } from './get-storefront-client';
 export { createStorefrontAuthRoute, type StorefrontAuthRouteOptions, type StorefrontAuthRouteHandlers, } from './create-storefront-auth-route';
 export { getInitialAuth, type InitialAuth } from './get-initial-auth';
+export { readCartIdCookie, readCurrencyCookie } from './cookie-readers';
 export { trustedForwardedHostValidator, originAllowlistValidator, type OriginValidator, type OriginValidatorContext, } from '../../core/auth/handlers';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EACL,6BAA6B,EAC7B,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC"}

package/dist/react/server/index.js

@@ -3,5 +3,7 @@ export { getStorefrontClient } from './get-storefront-client';
 export { createStorefrontAuthRoute, } from './create-storefront-auth-route';
 // Server-only cold-start auth seed from the first-party cookies.
 export { getInitialAuth } from './get-initial-auth';
+// Server-first readers for the readable first-party cookies (cart-id, currency).
+export { readCartIdCookie, readCurrencyCookie } from './cookie-readers';
 // Origin validators — wire CSRF defense-in-depth on the route handlers from a single import.
 export { trustedForwardedHostValidator, originAllowlistValidator, } from '../../core/auth/handlers';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "18.1.0",
+  "version": "19.0.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",
   "sideEffects": false,