@doswiftly/storefront-sdk 21.0.0 → 22.0.0

package/dist/react/components/PaymentInstrumentTile.js

@@ -1,21 +1,22 @@
 /**
  * `<PaymentInstrumentTile>` — single payment instrument tile (BLIK code,
- * bank logo, wallet button, card brand). Headless — buyer-facing button
- * z accessibility wbudowanym (`role="radio"`, `aria-checked`, `aria-label`,
- * `data-instrument-code`, `data-display-hint`). Pass className per part
- * (button, icon, label) żeby zintegrować z Tailwind / CSS Modules /
- * styled-components — komponent nie ma własnego stylingu.
+ * bank logo, wallet button, card brand). Headless — a buyer-facing button
+ * with accessibility built in (`role="radio"`, `aria-checked`, `aria-label`,
+ * `data-instrument-code`, `data-display-hint`). Pass a className per part
+ * (button, icon, label) to integrate with Tailwind / CSS Modules /
+ * styled-components — the component has no styling of its own.
  *
- * `displayHint` dispatch — backend hint jak storefront powinien renderować
- * instrument. Komponent emituje hint jako `data-display-hint` attribute na
- * `<button>` żeby caller mógł stylizować przez CSS attribute selektory:
+ * `displayHint` dispatch — a backend hint describing how the storefront should
+ * render the instrument. The component emits the hint as a `data-display-hint`
+ * attribute on the `<button>` so the caller can style it through CSS attribute
+ * selectors:
  *
- *   - `BRANDED_TILE` — bank logo / wallet icon dominuje, label jako caption.
- *   - `PROMINENT_BUTTON` — duże CTA (BLIK code entry), brand image pominięty.
- *   - `RADIO_OPTION` — radio-list look, image (jeśli is) + label inline.
- *   - `DROPDOWN_OPTION` — text-only dla dropdown integration (caller wrap).
+ *   - `BRANDED_TILE` — bank logo / wallet icon dominates, label as a caption.
+ *   - `PROMINENT_BUTTON` — large CTA (BLIK code entry), brand image omitted.
+ *   - `RADIO_OPTION` — radio-list look, image (when present) + label inline.
+ *   - `DROPDOWN_OPTION` — text-only for dropdown integration (caller wraps it).
  *
- * Headless = no opinion. CSS styling decyduje, komponent tylko hint'uje.
+ * Headless = no opinion. CSS styling decides, the component only hints.
  *
  * @example
  * ```tsx
@@ -27,15 +28,13 @@
  *   labelClassName="font-semibold"
  * />
  * ```
- *
- * Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 9.
  */
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 export function PaymentInstrumentTile({ instrument, selected, onSelect, className, iconClassName, labelClassName, }) {
     const { code, displayName, displayHint, brandImage, enabled } = instrument;
     const brandImageUrl = brandImage?.url;
-    // PROMINENT_BUTTON hides brand image — instrument jest text-only CTA (BLIK code entry).
+    // PROMINENT_BUTTON hides the brand image — the instrument is a text-only CTA (BLIK code entry).
     const showImage = displayHint !== 'PROMINENT_BUTTON' && brandImageUrl;
     return (_jsxs("button", { type: "button", role: "radio", "aria-checked": selected, "aria-label": displayName, "data-instrument-code": code, "data-display-hint": displayHint, "data-selected": selected, disabled: !enabled, onClick: onSelect, className: className, children: [showImage && _jsx("img", { src: brandImageUrl, alt: brandImage?.altText ?? '', className: iconClassName }), _jsx("span", { className: labelClassName, children: displayName })] }));
 }

package/dist/react/helpers/browser-data.d.ts

@@ -1,36 +1,36 @@
 /**
  * `getBrowserDataForPayment()` — collects browser context required by PSD2/3DS2
- * authentication flows (card-on-file z 3DS challenge, BLIK confirmation,
- * Apple/Google Pay z risk scoring).
+ * authentication flows (card-on-file with a 3DS challenge, BLIK confirmation,
+ * Apple/Google Pay with risk scoring).
  *
- * **Browser-only** — throws gdy `typeof window === 'undefined'` (server-side
- * rendering). Caller MUSI gate'ować call w useEffect / event handler / browser
- * code path. NEVER call this w Server Component lub Route Handler.
+ * **Browser-only** — throws when `typeof window === 'undefined'` (server-side
+ * rendering). Callers MUST gate the call inside a useEffect / event handler /
+ * browser-only code path. NEVER call this in a Server Component or Route Handler.
  *
- * Wartości pochodzą z standard Web APIs:
+ * Values come from standard Web APIs:
  *   - `userAgent` — `navigator.userAgent`.
  *   - `language` — `navigator.language` (BCP 47, fallback `en-US`).
  *   - `screen{Width,Height}` — `window.screen.{width,height}`.
  *   - `colorDepth` — `window.screen.colorDepth`.
  *   - `timezoneOffset` — `new Date().getTimezoneOffset()` (signed integer, minutes,
- *     reverse signed per ECMA: dodatnie = behind UTC, ujemne = ahead).
- *   - `javaEnabled` — `navigator.javaEnabled?.()` (deprecated ale wymagane PSD2/EMV
- *     specification; fallback `false` gdy browser nie expose'uje).
- *   - `acceptHeader` — NIE dostępne client-side (`navigator` nie expose'uje request
- *     headers). Caller passes z server context lub omits (gateway-dependent
- *     requirement). Helper zwraca undefined.
+ *     reverse signed per ECMA: positive = behind UTC, negative = ahead of UTC).
+ *   - `javaEnabled` — `navigator.javaEnabled?.()` (deprecated but required by the
+ *     PSD2/EMV specification; falls back to `false` when the browser does not
+ *     expose it).
+ *   - `acceptHeader` — NOT available client-side (`navigator` does not expose
+ *     request headers). Callers pass it from server context or omit it
+ *     (gateway-dependent requirement). The helper returns undefined.
  *
- * Shape matches PSD2/3DS2 BrowserData specification (EMVCo) — adapter na backend
- * `IPaymentProvider.createPayment` może merge wprost do gateway-specific body
- * (Adyen `browserInfo`, Stripe `payment_method_data.billing_details.browser_info`,
- * Mollie `cardToken` z 3DS lookup).
+ * The shape matches the PSD2/3DS2 BrowserData specification (EMVCo), so it can
+ * be merged into gateway-specific request bodies (gateway-specific field names
+ * vary).
  *
  * @example
  * ```tsx
- * // W event handler (browser-only):
+ * // In an event handler (browser-only):
  * function handleCheckoutSubmit() {
  *   const browserData = getBrowserDataForPayment();
- *   await cart.createPayment({ ..., browserData });
+ *   // pass to your payment integration where required
  * }
  *
  * // SSR-safe wrap:
@@ -39,21 +39,18 @@
  *   ...
  * }
  * ```
- *
- * Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 9.5
- * (carry-over z Adv-1 plan — moved here as standalone utility, no backend
- * mutation impact yet — Adv-3 będzie consumer'em w `paymentCreate` input).
  */
 /**
- * PSD2/3DS2 browser context shape. All fields optional poza ones backed by
- * standard API — gateway-specific requirements decyzują które pola są mandatory.
+ * PSD2/3DS2 browser context shape. All fields are optional except the ones
+ * backed by a standard API — gateway-specific requirements decide which fields
+ * are mandatory.
  */
 export interface PaymentBrowserData {
     /** Accept HTTP header value — NOT available client-side (caller passes from server context or omits). */
     acceptHeader?: string;
     /** Full user-agent string (`navigator.userAgent`). */
     userAgent: string;
-    /** BCP 47 language tag (`navigator.language`). Fallback `'en-US'` gdy missing. */
+    /** BCP 47 language tag (`navigator.language`). Falls back to `'en-US'` when missing. */
     language: string;
     /** Screen width in pixels (`window.screen.width`). */
     screenWidth: number;
@@ -62,25 +59,25 @@ export interface PaymentBrowserData {
     /** Color depth bits-per-pixel (`window.screen.colorDepth`). Typically `24` or `32`. */
     colorDepth: number;
     /**
-     * Local timezone offset w minutach (ECMA signed convention — dodatnie = behind UTC,
-     * ujemne = ahead UTC). Np. CET zima = `-60`, PST zima = `480`.
+     * Local timezone offset in minutes (ECMA signed convention — positive = behind UTC,
+     * negative = ahead of UTC). For example, CET in winter = `-60`, PST in winter = `480`.
      */
     timezoneOffset: number;
     /**
-     * Java support (`navigator.javaEnabled?.()`). Deprecated API ale wymagane PSD2/EMV
-     * specification; fallback `false` gdy browser nie expose'uje.
+     * Java support (`navigator.javaEnabled?.()`). Deprecated API but required by the
+     * PSD2/EMV specification; falls back to `false` when the browser does not expose it.
      */
     javaEnabled: boolean;
     /**
      * IANA timezone name (`Intl.DateTimeFormat().resolvedOptions().timeZone`).
-     * Optional — niektóre gateways używają zamiast offsetu (Adyen risk scoring).
+     * Optional — some gateways use it instead of the numeric offset for risk scoring.
      */
     timezone?: string;
 }
 /**
- * Throw'd gdy helper wywołany w SSR context (Server Component, Route Handler,
- * Node bez JSDOM). Caller MUSI guard'ować przez `typeof window` check albo
- * wywołać tylko w event handler / `useEffect`.
+ * Thrown when the helper is called in an SSR context (Server Component, Route
+ * Handler, Node without JSDOM). Callers MUST guard with a `typeof window` check
+ * or call it only inside an event handler / `useEffect`.
  */
 export declare class BrowserDataNotAvailableError extends Error {
     constructor();

package/dist/react/helpers/browser-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-data.d.ts","sourceRoot":"","sources":["../../../src/react/helpers/browser-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CA6B7D"}
+{"version":3,"file":"browser-data.d.ts","sourceRoot":"","sources":["../../../src/react/helpers/browser-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CA8B7D"}

package/dist/react/helpers/browser-data.js

@@ -1,36 +1,36 @@
 /**
  * `getBrowserDataForPayment()` — collects browser context required by PSD2/3DS2
- * authentication flows (card-on-file z 3DS challenge, BLIK confirmation,
- * Apple/Google Pay z risk scoring).
+ * authentication flows (card-on-file with a 3DS challenge, BLIK confirmation,
+ * Apple/Google Pay with risk scoring).
  *
- * **Browser-only** — throws gdy `typeof window === 'undefined'` (server-side
- * rendering). Caller MUSI gate'ować call w useEffect / event handler / browser
- * code path. NEVER call this w Server Component lub Route Handler.
+ * **Browser-only** — throws when `typeof window === 'undefined'` (server-side
+ * rendering). Callers MUST gate the call inside a useEffect / event handler /
+ * browser-only code path. NEVER call this in a Server Component or Route Handler.
  *
- * Wartości pochodzą z standard Web APIs:
+ * Values come from standard Web APIs:
  *   - `userAgent` — `navigator.userAgent`.
  *   - `language` — `navigator.language` (BCP 47, fallback `en-US`).
  *   - `screen{Width,Height}` — `window.screen.{width,height}`.
  *   - `colorDepth` — `window.screen.colorDepth`.
  *   - `timezoneOffset` — `new Date().getTimezoneOffset()` (signed integer, minutes,
- *     reverse signed per ECMA: dodatnie = behind UTC, ujemne = ahead).
- *   - `javaEnabled` — `navigator.javaEnabled?.()` (deprecated ale wymagane PSD2/EMV
- *     specification; fallback `false` gdy browser nie expose'uje).
- *   - `acceptHeader` — NIE dostępne client-side (`navigator` nie expose'uje request
- *     headers). Caller passes z server context lub omits (gateway-dependent
- *     requirement). Helper zwraca undefined.
+ *     reverse signed per ECMA: positive = behind UTC, negative = ahead of UTC).
+ *   - `javaEnabled` — `navigator.javaEnabled?.()` (deprecated but required by the
+ *     PSD2/EMV specification; falls back to `false` when the browser does not
+ *     expose it).
+ *   - `acceptHeader` — NOT available client-side (`navigator` does not expose
+ *     request headers). Callers pass it from server context or omit it
+ *     (gateway-dependent requirement). The helper returns undefined.
  *
- * Shape matches PSD2/3DS2 BrowserData specification (EMVCo) — adapter na backend
- * `IPaymentProvider.createPayment` może merge wprost do gateway-specific body
- * (Adyen `browserInfo`, Stripe `payment_method_data.billing_details.browser_info`,
- * Mollie `cardToken` z 3DS lookup).
+ * The shape matches the PSD2/3DS2 BrowserData specification (EMVCo), so it can
+ * be merged into gateway-specific request bodies (gateway-specific field names
+ * vary).
  *
  * @example
  * ```tsx
- * // W event handler (browser-only):
+ * // In an event handler (browser-only):
  * function handleCheckoutSubmit() {
  *   const browserData = getBrowserDataForPayment();
- *   await cart.createPayment({ ..., browserData });
+ *   // pass to your payment integration where required
  * }
  *
  * // SSR-safe wrap:
@@ -39,15 +39,11 @@
  *   ...
  * }
  * ```
- *
- * Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 9.5
- * (carry-over z Adv-1 plan — moved here as standalone utility, no backend
- * mutation impact yet — Adv-3 będzie consumer'em w `paymentCreate` input).
  */
 /**
- * Throw'd gdy helper wywołany w SSR context (Server Component, Route Handler,
- * Node bez JSDOM). Caller MUSI guard'ować przez `typeof window` check albo
- * wywołać tylko w event handler / `useEffect`.
+ * Thrown when the helper is called in an SSR context (Server Component, Route
+ * Handler, Node without JSDOM). Callers MUST guard with a `typeof window` check
+ * or call it only inside an event handler / `useEffect`.
  */
 export class BrowserDataNotAvailableError extends Error {
     constructor() {
@@ -59,11 +55,12 @@ export function getBrowserDataForPayment() {
     if (typeof window === 'undefined' || typeof navigator === 'undefined' || typeof window.screen === 'undefined') {
         throw new BrowserDataNotAvailableError();
     }
-    // `navigator.javaEnabled` jest deprecated ale wciąż obecny w major browsers — guard
-    // dla future removal. Falsy fallback gdy missing (PSD2 spec wymaga boolean, not undefined).
+    // `navigator.javaEnabled` is deprecated but still present in major browsers — guard
+    // against future removal. Falls back to `false` when missing (the PSD2 spec requires
+    // a boolean, not undefined).
     const javaEnabled = typeof navigator.javaEnabled === 'function' ? Boolean(navigator.javaEnabled()) : false;
-    // `Intl.DateTimeFormat` jest dostępny we wszystkich modern browsers — optional capture
-    // dla gateways które wymagają IANA name zamiast offset (np. Adyen).
+    // `Intl.DateTimeFormat` is available in all modern browsers — optional capture for
+    // gateways that require the IANA name instead of the numeric offset.
     let timezone;
     try {
         timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;

package/dist/react/hooks/use-cart-manager.d.ts

@@ -62,7 +62,7 @@
  * function CartUI() {
  *   const { addItem, onExpired } = useCartManager();
  *
- *   useEffect(() => onExpired(() => toast('Koszyk wygasł, dodaj produkty ponownie')), [onExpired]);
+ *   useEffect(() => onExpired(() => toast('Your cart expired — please add the items again')), [onExpired]);
  *
  *   return <button onClick={() => addItem([{ variantId, quantity: 1 }])}>Add</button>;
  * }

package/dist/react/hooks/use-cart-manager.js

@@ -62,7 +62,7 @@
  * function CartUI() {
  *   const { addItem, onExpired } = useCartManager();
  *
- *   useEffect(() => onExpired(() => toast('Koszyk wygasł, dodaj produkty ponownie')), [onExpired]);
+ *   useEffect(() => onExpired(() => toast('Your cart expired — please add the items again')), [onExpired]);
  *
  *   return <button onClick={() => addItem([{ variantId, quantity: 1 }])}>Add</button>;
  * }

package/dist/react/hooks/use-cart.d.ts

@@ -9,8 +9,8 @@
  * UIs need.
  *
  * State management follows the platform's store pattern: a vanilla Zustand
- * store is created per hook mount via `useMemo` (component-scoped, no
- * module-level singleton — Inv-3 of the SDK), and React subscribes through
+ * store is created per hook mount via `useMemo` (stores are component-scoped,
+ * never module-level singletons), and React subscribes through
  * `useStore`. Changing `cartId` recreates the store; refetches are explicit
  * (`refetch()` or any mutation triggers one).
  *

package/dist/react/hooks/use-cart.js

@@ -9,8 +9,8 @@
  * UIs need.
  *
  * State management follows the platform's store pattern: a vanilla Zustand
- * store is created per hook mount via `useMemo` (component-scoped, no
- * module-level singleton — Inv-3 of the SDK), and React subscribes through
+ * store is created per hook mount via `useMemo` (stores are component-scoped,
+ * never module-level singletons), and React subscribes through
  * `useStore`. Changing `cartId` recreates the store; refetches are explicit
  * (`refetch()` or any mutation triggers one).
  *
@@ -84,7 +84,7 @@ export function useCart(cartId, options = {}) {
     const { autoFetch = true, initialCart } = options;
     // Recreate the store when `cartId` or the underlying client changes. The
     // useMemo dependency list captures store identity (component-scoped, not
-    // module-level — Inv-3). Mutations capture the store instance for stable
+    // module-level). Mutations capture the store instance for stable
     // references via the api object.
     const api = useMemo(() => createServerCartStore({ cartClient, cartId, initialCart }), 
     // initialCart deliberately excluded — it only seeds the FIRST mount; we do

package/dist/react/hooks/use-referral-capture.d.ts

@@ -0,0 +1,9 @@
+import { type CaptureReferralCodeOptions } from '../referral';
+export interface UseReferralCaptureOptions extends Pick<CaptureReferralCodeOptions, 'paramName' | 'maxAge'> {
+}
+/**
+ * Capture the referral code from the current URL into the `referral-code`
+ * cookie and return the active code (`null` when none).
+ */
+export declare function useReferralCapture(options?: UseReferralCaptureOptions): string | null;
+//# sourceMappingURL=use-referral-capture.d.ts.map

package/dist/react/hooks/use-referral-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-referral-capture.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-referral-capture.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEnF,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,QAAQ,CAAC;CAAG;AAErE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,CAWrF"}

package/dist/react/hooks/use-referral-capture.js

@@ -0,0 +1,40 @@
+'use client';
+/**
+ * useReferralCapture — capture a referral code from the landing URL.
+ *
+ * Mount the hook once near the top of the app (layout or a dedicated client
+ * component). On mount it inspects the current URL for the referral parameter
+ * (`?ref=CODE` by default), persists it in the `referral-code` cookie and
+ * returns the active code (from the URL, or a previously stored one when the
+ * visitor navigated away from the landing URL before signing up).
+ *
+ * At signup time read the code with `readReferralCodeCookie()` (or use the
+ * value returned here), pass it as `customerSignup(input: { referralCode })`
+ * and call `clearReferralCodeCookie()` after success.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useReferralCapture } from '@doswiftly/storefront-sdk/react';
+ *
+ * export function ReferralCapture() {
+ *   useReferralCapture();
+ *   return null;
+ * }
+ * ```
+ */
+import { useEffect, useState } from 'react';
+import { captureReferralCode } from '../referral';
+/**
+ * Capture the referral code from the current URL into the `referral-code`
+ * cookie and return the active code (`null` when none).
+ */
+export function useReferralCapture(options) {
+    const [code, setCode] = useState(null);
+    const paramName = options?.paramName;
+    const maxAge = options?.maxAge;
+    useEffect(() => {
+        setCode(captureReferralCode({ paramName, maxAge }));
+    }, [paramName, maxAge]);
+    return code;
+}

package/dist/react/hooks/use-session-expired.d.ts

@@ -2,14 +2,15 @@
  * useSessionExpired — subscribe to the global session-expired signal.
  *
  * Fired when the SDK can no longer keep the customer session alive: a proactive
- * refresh failed on tab wake (R6.3), or a reactive refresh after a 401 also
- * failed (R2.4). Use once near the app root to react globally — show a notice
- * and redirect to sign-in (R14.2). No-op outside `StorefrontProvider`.
+ * refresh failed on tab wake, or a reactive refresh after a 401 also failed.
+ * Use once near the app root to react globally — show a notice and redirect
+ * to sign-in. No-op outside `StorefrontProvider`.
  */
 import type { SessionExpiredEmitter, SessionExpiredEvent } from '../../core/auth/session-events';
 /**
- * Context carrying the provider-scoped session-expired emitter. Created in
- * `StorefrontProvider` via `useRef` (Inv-3 — never a module-level singleton).
+ * Context carrying the provider-scoped session-expired emitter. Created per
+ * provider mount in `StorefrontProvider` via `useRef` — never a module-level
+ * singleton.
  */
 export declare const SessionExpiredContext: import("react").Context<SessionExpiredEmitter | null>;
 export declare function useSessionExpired(listener: (event: SessionExpiredEvent) => void): void;

package/dist/react/hooks/use-session-expired.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-session-expired.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-session-expired.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,qBAAqB,uDAAoD,CAAC;AAEvF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,IAAI,CAUtF"}
+{"version":3,"file":"use-session-expired.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-session-expired.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAEjG;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,uDAAoD,CAAC;AAEvF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,IAAI,CAUtF"}

package/dist/react/hooks/use-session-expired.js

@@ -2,15 +2,16 @@
  * useSessionExpired — subscribe to the global session-expired signal.
  *
  * Fired when the SDK can no longer keep the customer session alive: a proactive
- * refresh failed on tab wake (R6.3), or a reactive refresh after a 401 also
- * failed (R2.4). Use once near the app root to react globally — show a notice
- * and redirect to sign-in (R14.2). No-op outside `StorefrontProvider`.
+ * refresh failed on tab wake, or a reactive refresh after a 401 also failed.
+ * Use once near the app root to react globally — show a notice and redirect
+ * to sign-in. No-op outside `StorefrontProvider`.
  */
 'use client';
 import { createContext, useContext, useEffect, useRef } from 'react';
 /**
- * Context carrying the provider-scoped session-expired emitter. Created in
- * `StorefrontProvider` via `useRef` (Inv-3 — never a module-level singleton).
+ * Context carrying the provider-scoped session-expired emitter. Created per
+ * provider mount in `StorefrontProvider` via `useRef` — never a module-level
+ * singleton.
  */
 export const SessionExpiredContext = createContext(null);
 export function useSessionExpired(listener) {

package/dist/react/index.d.ts

@@ -37,6 +37,8 @@ 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, createBrowserCartCookieStore, } from './cookies';
+export { captureReferralCode, getReferralCodeCookie, clearReferralCodeCookie, type CaptureReferralCodeOptions, } from './referral';
+export { useReferralCapture, type UseReferralCaptureOptions } from './hooks/use-referral-capture';
 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/react/index.js

@@ -36,8 +36,12 @@ export { useLanguageStore, useLanguageStoreApi } from './stores/store-context';
 export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
 export { selectLanguage, selectDefaultLanguage, selectSupportedLanguages, selectLanguageIsLoaded } from './stores/language.store';
 // Cookie utilities (client-side). Server-side readers (readCartIdCookie,
-// readCurrencyCookie) live in `@doswiftly/storefront-sdk/react/server`.
+// readCurrencyCookie, readReferralCodeCookie) live in
+// `@doswiftly/storefront-sdk/react/server`.
 export { getCookie, setCookie, deleteCookie, createBrowserCartCookieStore, } from './cookies';
+// Referral capture (loyalty referral program — landing-link `?ref=CODE` → cookie)
+export { captureReferralCode, getReferralCodeCookie, clearReferralCodeCookie, } from './referral';
+export { useReferralCapture } from './hooks/use-referral-capture';
 // Bot protection
 export { useBotProtection } from './hooks/use-bot-protection';
 // Generic hooks

package/dist/react/referral.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Client-side referral capture helpers.
+ *
+ * Flow: a visitor lands through a referral share link (`/register?ref=CODE`),
+ * `captureReferralCode()` persists the code in the readable `referral-code`
+ * cookie, and the signup form reads it back with `getReferralCodeCookie()`
+ * and passes it as `customerSignup(input: { referralCode })`. After a
+ * successful signup call `clearReferralCodeCookie()` so the code is not
+ * re-submitted by other browser tabs or future registrations.
+ *
+ * All helpers are SSR-safe (no-op / `null` without a `document`). For Server
+ * Components use the async `readReferralCodeCookie` from
+ * `@doswiftly/storefront-sdk/react/server` instead — the client helper is
+ * deliberately named differently (`get…`, synchronous) so the two cannot be
+ * confused in auto-imports.
+ */
+export interface CaptureReferralCodeOptions {
+    /**
+     * URL (or search string) to inspect. Defaults to the current
+     * `window.location.href`.
+     */
+    url?: string | URL;
+    /** Query parameter carrying the code. Default `'ref'`. */
+    paramName?: string;
+    /**
+     * Cookie lifetime in seconds. Default {@link REFERRAL_COOKIE_MAX_AGE}
+     * (30 days) — the "landing → signup" window, independent of the shop's
+     * referral validity setting (see the constant's docs).
+     */
+    maxAge?: number;
+}
+/**
+ * Capture a referral code from the current URL (or an explicit one) into the
+ * `referral-code` cookie.
+ *
+ * Returns the captured code, or the previously stored one when the URL carries
+ * no code (so a visitor who navigated away from the landing URL still counts),
+ * or `null` when there is nothing to capture. A code present in the URL always
+ * wins over a previously stored one — the most recent referral link decides.
+ */
+export declare function captureReferralCode(options?: CaptureReferralCodeOptions): string | null;
+/**
+ * Read the stored referral code (client-side, synchronous). Returns `null`
+ * when absent or outside a browser environment. Server Components use the
+ * async `readReferralCodeCookie` from `@doswiftly/storefront-sdk/react/server`.
+ */
+export declare function getReferralCodeCookie(): string | null;
+/**
+ * Remove the stored referral code. Call after a successful signup so the code
+ * is not re-submitted by future registrations from the same browser.
+ */
+export declare function clearReferralCodeCookie(): void;
+//# sourceMappingURL=referral.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"referral.d.ts","sourceRoot":"","sources":["../../src/react/referral.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,MAAM,GAAG,IAAI,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/react/referral.js

@@ -0,0 +1,51 @@
+/**
+ * Client-side referral capture helpers.
+ *
+ * Flow: a visitor lands through a referral share link (`/register?ref=CODE`),
+ * `captureReferralCode()` persists the code in the readable `referral-code`
+ * cookie, and the signup form reads it back with `getReferralCodeCookie()`
+ * and passes it as `customerSignup(input: { referralCode })`. After a
+ * successful signup call `clearReferralCodeCookie()` so the code is not
+ * re-submitted by other browser tabs or future registrations.
+ *
+ * All helpers are SSR-safe (no-op / `null` without a `document`). For Server
+ * Components use the async `readReferralCodeCookie` from
+ * `@doswiftly/storefront-sdk/react/server` instead — the client helper is
+ * deliberately named differently (`get…`, synchronous) so the two cannot be
+ * confused in auto-imports.
+ */
+import { REFERRAL_COOKIE_NAME, REFERRAL_COOKIE_MAX_AGE, extractReferralCodeFromUrl, } from '../core/referral/cookie-config';
+import { getCookie, setCookie, deleteCookie } from './cookies';
+/**
+ * Capture a referral code from the current URL (or an explicit one) into the
+ * `referral-code` cookie.
+ *
+ * Returns the captured code, or the previously stored one when the URL carries
+ * no code (so a visitor who navigated away from the landing URL still counts),
+ * or `null` when there is nothing to capture. A code present in the URL always
+ * wins over a previously stored one — the most recent referral link decides.
+ */
+export function captureReferralCode(options = {}) {
+    const url = options.url ?? (typeof window !== 'undefined' ? window.location.href : null);
+    const fromUrl = url ? extractReferralCodeFromUrl(url, options.paramName) : null;
+    if (fromUrl) {
+        setCookie(REFERRAL_COOKIE_NAME, fromUrl, { maxAge: options.maxAge ?? REFERRAL_COOKIE_MAX_AGE });
+        return fromUrl;
+    }
+    return getReferralCodeCookie();
+}
+/**
+ * Read the stored referral code (client-side, synchronous). Returns `null`
+ * when absent or outside a browser environment. Server Components use the
+ * async `readReferralCodeCookie` from `@doswiftly/storefront-sdk/react/server`.
+ */
+export function getReferralCodeCookie() {
+    return getCookie(REFERRAL_COOKIE_NAME);
+}
+/**
+ * Remove the stored referral code. Call after a successful signup so the code
+ * is not re-submitted by future registrations from the same browser.
+ */
+export function clearReferralCodeCookie() {
+    deleteCookie(REFERRAL_COOKIE_NAME);
+}

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

@@ -46,4 +46,11 @@ export declare function readCartIdCookie(): Promise<string | null>;
 export declare function readCartCredentials(): Promise<CartCredentials | null>;
 /** Read the first-party `preferred-currency` cookie (server-first, client fallback). */
 export declare function readCurrencyCookie(): Promise<string | null>;
+/**
+ * Read the first-party `referral-code` cookie (server-first, client fallback) —
+ * the referral code captured when the visitor landed through a referral share
+ * link. Useful for SSR-rendered signup forms that pre-fill the code field;
+ * pass it as `customerSignup(input: { referralCode })`.
+ */
+export declare function readReferralCodeCookie(): Promise<string | null>;
 //# sourceMappingURL=cookie-readers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cookie-readers.d.ts","sourceRoot":"","sources":["../../../src/react/server/cookie-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAqBvC,6EAA6E;AAC7E,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAE3E;AAED,wFAAwF;AACxF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEjE"}
+{"version":3,"file":"cookie-readers.d.ts","sourceRoot":"","sources":["../../../src/react/server/cookie-readers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAsBvC,6EAA6E;AAC7E,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAE3E;AAED,wFAAwF;AACxF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEjE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAErE"}

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

@@ -24,6 +24,7 @@
  */
 import { CART_COOKIE_NAME, parseCartCookieValue, } from '../../core/cart/cookie-config';
 import { CURRENCY_COOKIE_NAME } from '../../core/currency/cookie-config';
+import { REFERRAL_COOKIE_NAME } from '../../core/referral/cookie-config';
 import { getCookie } from '../cookies';
 /**
  * Read a cookie server-first: the request cookies via `next/headers` in a Server
@@ -71,3 +72,12 @@ export async function readCartCredentials() {
 export async function readCurrencyCookie() {
     return readCookieIsomorphic(CURRENCY_COOKIE_NAME);
 }
+/**
+ * Read the first-party `referral-code` cookie (server-first, client fallback) —
+ * the referral code captured when the visitor landed through a referral share
+ * link. Useful for SSR-rendered signup forms that pre-fill the code field;
+ * pass it as `customerSignup(input: { referralCode })`.
+ */
+export async function readReferralCodeCookie() {
+    return readCookieIsomorphic(REFERRAL_COOKIE_NAME);
+}