@kotao/storefront 0.2.2 → 0.2.4

package/dist/{routing-BxRlep_-.d.ts → routing-sEonP93J.d.ts}

@@ -1,60 +1,8 @@
-import { S as StoredThemeSettings } from './fetch-B6TIc6lI.js';
-import { a as StorefrontClient, C as CacheStrategy, K as KotaoCache } from './client-DiPdlvPu.js';
-import { C as CartFormAction, a as Cart, b as CartLineInput, c as CartAttribute, d as CartBuyerIdentityInput, e as CartMutationResult, f as CartLineUpdateInput, g as CartMetafield, h as CartMetafieldIdentifier, i as CartDeliveryAddress, j as CartSelectedDeliveryOption, H as HydrogenSession } from './types-Df3bGbKU.js';
-
-interface CartCreateInput {
-    readonly lines?: readonly CartLineInput[];
-    readonly note?: string | null;
-    readonly attributes?: readonly CartAttribute[];
-    readonly buyerIdentity?: CartBuyerIdentityInput;
-}
-interface CartDispatchAction {
-    readonly action: CartFormAction;
-    readonly inputs: Record<string, unknown>;
-}
-interface CartHandler {
-    get(): Promise<Cart | null>;
-    getCart(): Promise<Cart | null>;
-    create(input?: CartCreateInput): Promise<CartMutationResult>;
-    addLines(lines: readonly CartLineInput[]): Promise<CartMutationResult>;
-    updateLines(lines: readonly CartLineUpdateInput[]): Promise<CartMutationResult>;
-    removeLines(lineIds: readonly string[]): Promise<CartMutationResult>;
-    updateBuyerIdentity(buyerIdentity: CartBuyerIdentityInput): Promise<CartMutationResult>;
-    updateDiscountCodes(discountCodes: readonly string[]): Promise<CartMutationResult>;
-    setCartId(cartId: string): Headers;
-    cartCreate(input?: CartCreateInput): Promise<CartMutationResult>;
-    linesAdd(lines: readonly CartLineInput[]): Promise<CartMutationResult>;
-    linesUpdate(lines: readonly CartLineUpdateInput[]): Promise<CartMutationResult>;
-    linesRemove(lineIds: readonly string[]): Promise<CartMutationResult>;
-    buyerIdentityUpdate(buyerIdentity: CartBuyerIdentityInput): Promise<CartMutationResult>;
-    discountCodesUpdate(discountCodes: readonly string[]): Promise<CartMutationResult>;
-    giftCardCodesAdd(giftCardCodes: readonly string[]): Promise<CartMutationResult>;
-    giftCardCodesRemove(giftCardCodes: readonly string[]): Promise<CartMutationResult>;
-    noteUpdate(note: string | null): Promise<CartMutationResult>;
-    attributesUpdate(attributes: readonly CartAttribute[]): Promise<CartMutationResult>;
-    metafieldsSet(metafields: readonly CartMetafield[]): Promise<CartMutationResult>;
-    metafieldsDelete(metafields: readonly CartMetafieldIdentifier[]): Promise<CartMutationResult>;
-    deliveryAddressesReplace(addresses: readonly CartDeliveryAddress[]): Promise<CartMutationResult>;
-    selectedDeliveryOptionsUpdate(selectedDeliveryOptions: readonly CartSelectedDeliveryOption[]): Promise<CartMutationResult>;
-    dispatch(action: CartDispatchAction): Promise<CartMutationResult>;
-}
-type MaybePromise<T> = T | Promise<T>;
-type CartGetId = () => MaybePromise<string | null | undefined>;
-type CartSetId = (cartId: string) => MaybePromise<string | Headers | null | undefined | void>;
-interface RequestCartHandlerOptions {
-    request: Request;
-    storefront: StorefrontClient;
-}
-interface HydrogenCartHandlerOptions {
-    storefront: StorefrontClient;
-    customerAccount?: unknown;
-    getCartId: CartGetId;
-    setCartId: CartSetId;
-}
-type CreateCartHandlerOptions = RequestCartHandlerOptions | HydrogenCartHandlerOptions;
-declare function cartGetIdDefault(headers: Headers): CartGetId;
-declare function cartSetIdDefault(): CartSetId;
-declare function createCartHandler(opts: CreateCartHandlerOptions): CartHandler;
+import { S as StoredThemeSettings } from './fetch-M3Y-fQrW.js';
+import { C as CacheStrategy, K as KotaoCache, S as StorefrontClient, b as StorefrontCacheInput } from './client-D51WdvYR.js';
+import { C as CartHandler } from './createCartHandler-C4RrPwSG.js';
+import { E as EventsClient } from './client-bsiNPHBi.js';
+import { H as HydrogenSession } from './types-bcbQzx87.js';
 
 /**
  * Typed customer-account shapes for the `@kotao/storefront` SDK surface (#91). The names/signatures
@@ -96,6 +44,8 @@ interface RequestLoginCodeInput {
 }
 interface RequestLoginCodeResult {
     readonly status: 'sent' | 'rate_limited' | 'error';
+    /** Raw proxy response carrying CSRF rotation cookies/headers to the browser action. */
+    readonly response: Response;
 }
 interface VerifyLoginCodeInput {
     readonly email: string;
@@ -247,6 +197,8 @@ interface KotaoEnv {
      * Must match the api proxy's STOREFRONT_SHOP_CONTEXT_KEY.
      */
     STOREFRONT_SHOP_CONTEXT_KEY?: string;
+    /** Explicit local-dev origin; production receives the gateway-overwritten header. */
+    STOREFRONT_SHOP_ORIGIN?: string;
     SESSION_SECRET?: string;
     PUBLIC_STOREFRONT_API_TOKEN?: string;
     PRIVATE_STOREFRONT_API_TOKEN?: string;
@@ -257,11 +209,15 @@ interface KotaoEnv {
     PUBLIC_CHECKOUT_DOMAIN?: string;
     SHOP_ID?: string;
 }
+interface StorefrontExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
 interface KotaoSession extends HydrogenSession {
     readonly isLoggedIn: boolean;
 }
 interface KotaoContext {
     readonly storefront: StorefrontClient;
+    readonly events: EventsClient;
     readonly cart: CartHandler;
     readonly customerAccount: CustomerAccountClient;
     readonly geo: Geo | null;
@@ -282,12 +238,13 @@ interface KotaoContext {
         readonly fetch?: typeof fetch;
     }) => Promise<StoredThemeSettings>;
 }
+declare function trustedShopOriginFromHeaders(headers: Headers): string | undefined;
 /**
  * Framework-agnostic per-request context, mirroring Hydrogen's `createHydrogenContext`:
  * storefront client + verified geo + SWR cache + locale + session seam.
  */
-declare function createKotaoContext(request: Request, env: KotaoEnv, executionCtx: ExecutionContext, deps?: {
-    openCache?: (name: string) => Promise<Cache>;
+declare function createKotaoContext(request: Request, env: KotaoEnv, executionCtx: StorefrontExecutionContext, deps?: {
+    openCache?: (name: string) => Promise<StorefrontCacheInput>;
     session?: HydrogenSession;
 }): Promise<KotaoContext>;
 
@@ -309,4 +266,4 @@ declare function stripLocalePrefixFromPathname(pathname: string): StrippedLocale
 declare function stripLocalePrefixFromRequest(request: Request): Request;
 declare function localizePath(path: string, locale: string | null | undefined, options?: LocalizePathOptions): string;
 
-export { type Address as A, isLocalePathSegment as B, type CartDispatchAction as C, localeFromAcceptLanguage as D, localeFromPathname as E, localeFromRequest as F, GEO_HEADER as G, type HydrogenCartHandlerOptions as H, localizePath as I, originalPathnameFromRequest as J, type KotaoEnv as K, type LocalizePathOptions as L, type Money as M, signGeo as N, type Order as O, stripLocalePrefixFromPathname as P, verifyGeo as Q, ROUTING_LOCALE_HEADER as R, type StrippedLocalePath as S, type VerifyLoginCodeInput as V, type WithCache as W, type KotaoContext as a, type KotaoSession as b, type CustomerAccountClient as c, type AddressConnection as d, type CartGetId as e, type CartHandler as f, type CartSetId as g, type CreateCartHandlerOptions as h, type CustomerAccount as i, CustomerAccountError as j, type CustomerAccountErrorCode as k, GEO_SIGNATURE_HEADER as l, type Geo as m, type OrderConnection as n, type OrderPageInfo as o, type OrdersOptions as p, ROUTING_ORIGINAL_PATHNAME_HEADER as q, type RequestCartHandlerOptions as r, stripLocalePrefixFromRequest as s, type RequestLoginCodeInput as t, type RequestLoginCodeResult as u, cartGetIdDefault as v, cartSetIdDefault as w, createCartHandler as x, createKotaoContext as y, createWithCache as z };
+export { type Address as A, trustedShopOriginFromHeaders as B, type CustomerAccountClient as C, verifyGeo as D, GEO_HEADER as G, type KotaoEnv as K, type LocalizePathOptions as L, type Money as M, type Order as O, ROUTING_LOCALE_HEADER as R, type StorefrontExecutionContext as S, type VerifyLoginCodeInput as V, type WithCache as W, type KotaoContext as a, type KotaoSession as b, type AddressConnection as c, type CustomerAccount as d, CustomerAccountError as e, type CustomerAccountErrorCode as f, GEO_SIGNATURE_HEADER as g, type Geo as h, type OrderConnection as i, type OrderPageInfo as j, type OrdersOptions as k, ROUTING_ORIGINAL_PATHNAME_HEADER as l, type RequestLoginCodeInput as m, type RequestLoginCodeResult as n, type StrippedLocalePath as o, createKotaoContext as p, createWithCache as q, isLocalePathSegment as r, stripLocalePrefixFromRequest as s, localeFromAcceptLanguage as t, localeFromPathname as u, localeFromRequest as v, localizePath as w, originalPathnameFromRequest as x, signGeo as y, stripLocalePrefixFromPathname as z };

package/dist/seo.d.ts

@@ -1,6 +1,7 @@
 import { S as SeoConfig, b as SeoDescriptor, J as JsonLd } from './types-BDhHWZsP.js';
 export { A as Alternate, O as OpenGraph, a as OpenGraphImage, T as TwitterCard } from './types-BDhHWZsP.js';
-import { a as StorefrontClient } from './client-DiPdlvPu.js';
+import { S as StorefrontClient } from './client-D51WdvYR.js';
+import './http-types-CGh8WGHB.js';
 
 /**
  * Merge SEO config across levels and emit a flat, deduplicated descriptor list (RR7 `meta`-compatible):

package/dist/settings.d.ts

@@ -1,8 +1,9 @@
 import { SectionSchema, Preset, ValuesDocument, SettingInput, SectionInstance } from '@kotao/storefront-contracts/theme';
-import { a as ResolvedSection, b as ResolvedSettings, T as ThemeSettingsSnapshot } from './store-DQK1nhob.js';
-export { R as ResolvedBlock, c as ThemeSettingsStore, d as createThemeSettingsStore } from './store-DQK1nhob.js';
-export { F as FetchThemeSettingsOptions, S as StoredThemeSettings, f as fetchThemeSettings } from './fetch-B6TIc6lI.js';
-import './client-DiPdlvPu.js';
+import { c as ResolvedSection, R as ResolvedSettings, a as ThemeSettingsSnapshot } from './store-CtCWHI8H.js';
+export { b as ResolvedBlock, T as ThemeSettingsStore, d as createThemeSettingsStore } from './store-CtCWHI8H.js';
+export { F as FetchThemeSettingsOptions, S as StoredThemeSettings, f as fetchThemeSettings } from './fetch-M3Y-fQrW.js';
+import './client-D51WdvYR.js';
+import './http-types-CGh8WGHB.js';
 
 /**
  * The settings-as-data merge engine (ADR-0003 §"Settings-as-data customizer", #93). Pure: it resolves

package/dist/{shop-DkQmro-Y.d.ts → shop-BJSvtmnV.d.ts}

@@ -1,4 +1,4 @@
-import { C as CartFormAction } from './types-Df3bGbKU.js';
+import { j as CartFormAction } from './types-bcbQzx87.js';
 import { ReactNode } from 'react';
 
 interface CartFormProps {
@@ -199,4 +199,4 @@ interface GetShopAnalyticsOptions {
 }
 declare function getShopAnalytics(options: GetShopAnalyticsOptions): ShopAnalytics;
 
-export { ANALYTICS_EVENTS as A, type BoundNonceProvider as B, type ConsentBucket as C, DENIED_CONSENT as D, type EventHandler as E, getShopAnalytics as F, GRANTED_CONSENT as G, isGranted as H, mergeConsent as I, parseConsent as J, readConsentCookie as K, serializeConsent as L, getCartFormInput as M, useNonce as N, type PageViewedPayload as P, type SearchViewedPayload as S, type ConsentState as a, type AnalyticsBus as b, type AnalyticsBusOptions as c, type AnalyticsContext as d, type AnalyticsEmitter as e, type AnalyticsEventMap as f, type AnalyticsEventName as g, type AnalyticsGeo as h, CONSENT_BUCKETS as i, CONSENT_COOKIE as j, CartForm as k, type CartFormProps as l, type CartViewedPayload as m, type CollectionViewedPayload as n, type GetShopAnalyticsOptions as o, type PixelEvent as p, type PixelSend as q, type PixelTransport as r, type PixelTransportOptions as s, type ProductAddedToCartPayload as t, type ProductViewedPayload as u, type ShopAnalytics as v, buildConsentCookie as w, createAnalyticsBus as x, createAnalyticsEmitter as y, createPixelTransport as z };
+export { type AnalyticsContext as A, type BoundNonceProvider as B, type ConsentState as C, DENIED_CONSENT as D, type EventHandler as E, createAnalyticsEmitter as F, GRANTED_CONSENT as G, createPixelTransport as H, getShopAnalytics as I, isGranted as J, mergeConsent as K, parseConsent as L, readConsentCookie as M, serializeConsent as N, type PageViewedPayload as P, type ShopAnalytics as S, type AnalyticsEmitter as a, type AnalyticsBus as b, type ConsentBucket as c, ANALYTICS_EVENTS as d, type AnalyticsBusOptions as e, type AnalyticsEventMap as f, getCartFormInput as g, type AnalyticsEventName as h, type AnalyticsGeo as i, CONSENT_BUCKETS as j, CONSENT_COOKIE as k, CartForm as l, type CartFormProps as m, type CartViewedPayload as n, type CollectionViewedPayload as o, type GetShopAnalyticsOptions as p, type PixelEvent as q, type PixelSend as r, type PixelTransport as s, type PixelTransportOptions as t, useNonce as u, type ProductAddedToCartPayload as v, type ProductViewedPayload as w, type SearchViewedPayload as x, buildConsentCookie as y, createAnalyticsBus as z };

package/dist/{store-DQK1nhob.d.ts → store-CtCWHI8H.d.ts}

@@ -64,4 +64,4 @@ interface ThemeSettingsStore {
 }
 declare function createThemeSettingsStore(initial: ThemeSettingsSnapshot): ThemeSettingsStore;
 
-export { type ResolvedBlock as R, type ThemeSettingsSnapshot as T, type ResolvedSection as a, type ResolvedSettings as b, type ThemeSettingsStore as c, createThemeSettingsStore as d };
+export { type ResolvedSettings as R, type ThemeSettingsStore as T, type ThemeSettingsSnapshot as a, type ResolvedBlock as b, type ResolvedSection as c, createThemeSettingsStore as d };

package/dist/types-CSNXbGFW.d.ts

@@ -0,0 +1,108 @@
+type FormLocalizedText = Record<string, string>;
+type FormAnswer = string | number | boolean | string[] | Record<string, string>;
+type FormAnswers = Record<string, FormAnswer>;
+interface FormVisibilityRule {
+    fieldKey: string;
+    operator: 'equals' | 'not_equals' | 'includes' | 'is_empty' | 'is_not_empty';
+    value?: string | number | boolean;
+}
+interface FormField {
+    key: string;
+    label: FormLocalizedText;
+    description?: FormLocalizedText;
+    kind: 'text' | 'textarea' | 'email' | 'phone' | 'number' | 'date' | 'address' | 'select' | 'multi_select' | 'radio' | 'checkbox' | 'consent';
+    classification: 'public' | 'internal' | 'sensitive';
+    required: boolean;
+    searchMode: 'none' | 'exact' | 'prefix';
+    reportMode: 'none' | 'aggregate';
+    validation?: {
+        minLength?: number;
+        maxLength?: number;
+        min?: number;
+        max?: number;
+    };
+    choices?: {
+        value: string;
+        label: FormLocalizedText;
+    }[];
+    consentText?: FormLocalizedText;
+    visibleWhen?: {
+        all: FormVisibilityRule[];
+    };
+}
+type FormBlock = {
+    type: 'section';
+    key: string;
+    title: FormLocalizedText;
+    description?: FormLocalizedText;
+} | {
+    type: 'content';
+    key: string;
+    content: FormLocalizedText;
+} | {
+    type: 'field';
+    field: FormField;
+};
+interface FormVersionSchema {
+    schemaVersion: 1;
+    pages: {
+        key: string;
+        title?: FormLocalizedText;
+        description?: FormLocalizedText;
+        blocks: FormBlock[];
+    }[];
+    submitLabel?: FormLocalizedText;
+    successMessage?: FormLocalizedText;
+}
+interface PublicFormDefinition {
+    id: string;
+    ownerNamespace: string;
+    handle: string;
+    title: string;
+    purpose: string;
+    status: 'draft' | 'published' | 'archived';
+    currentPublishedVersionId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PublicFormVersion {
+    id: string;
+    definitionId: string;
+    versionNumber: number;
+    state: 'draft' | 'published' | 'retired';
+    schema: FormVersionSchema;
+    schemaHash: string | null;
+    publishedAt: string | null;
+    retiredAt: string | null;
+    createdAt: string;
+}
+interface PublicForm {
+    definition: PublicFormDefinition;
+    version: PublicFormVersion;
+}
+interface FormFieldErrors {
+    [fieldKey: string]: string[];
+}
+interface FormRenderState {
+    answers?: FormAnswers;
+    errors?: FormFieldErrors;
+    submitted?: boolean;
+}
+interface FormSubmission {
+    id: string;
+    definitionId: string;
+    versionId: string;
+    state: 'draft' | 'submitted' | 'linked' | 'anonymized';
+    locale: string;
+    source: string;
+    ownerType: string | null;
+    ownerId: string | null;
+    hasAnswers: boolean;
+    submittedAt: string | null;
+    expiresAt: string | null;
+    anonymizedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+
+export type { FormVersionSchema as F, PublicForm as P, FormAnswers as a, FormFieldErrors as b, FormAnswer as c, FormBlock as d, FormField as e, FormLocalizedText as f, FormRenderState as g, FormSubmission as h, FormVisibilityRule as i, PublicFormDefinition as j, PublicFormVersion as k };

package/dist/{types-Df3bGbKU.d.ts → types-bcbQzx87.d.ts}

@@ -164,4 +164,4 @@ interface HydrogenSession {
     commit(): string | Promise<string>;
 }
 
-export { type CartFormAction as C, type HydrogenSession as H, type Cart as a, type CartLineInput as b, type CartAttribute as c, type CartBuyerIdentityInput as d, type CartMutationResult as e, type CartLineUpdateInput as f, type CartMetafield as g, type CartMetafieldIdentifier as h, type CartDeliveryAddress as i, type CartSelectedDeliveryOption as j, CART_FORM_ACTIONS as k, type CartBuyerIdentity as l, type CartLine as m, type CartUserError as n, type HydrogenCart as o, type HydrogenCartCreateInput as p, type HydrogenCartMutationResult as q, type HydrogenSessionData as r };
+export { type Cart as C, type HydrogenSession as H, type CartLineInput as a, type CartAttribute as b, type CartBuyerIdentityInput as c, type CartMutationResult as d, type CartLineUpdateInput as e, type CartMetafield as f, type CartMetafieldIdentifier as g, type CartDeliveryAddress as h, type CartSelectedDeliveryOption as i, type CartFormAction as j, CART_FORM_ACTIONS as k, type CartBuyerIdentity as l, type CartLine as m, type CartUserError as n, type HydrogenCart as o, type HydrogenCartCreateInput as p, type HydrogenCartMutationResult as q, type HydrogenSessionData as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kotao/storefront",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
   "license": "MIT",
   "description": "Kotao Storefronts theme SDK — framework-agnostic server runtime (storefront client, SWR isolated cache, signed geo) + React Router 7 binding. Mirrors Hydrogen's API (ADR-0003). Leaf package (ADR-0006).",
@@ -26,6 +26,18 @@
       "types": "./dist/editor.d.ts",
       "import": "./dist/editor.js"
     },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js"
+    },
+    "./events/react": {
+      "types": "./dist/events-react.d.ts",
+      "import": "./dist/events-react.js"
+    },
+    "./forms": {
+      "types": "./dist/forms.d.ts",
+      "import": "./dist/forms.js"
+    },
     "./image": {
       "types": "./dist/image.d.ts",
       "import": "./dist/image.js"
@@ -60,7 +72,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@kotao/storefront-contracts": "^0.2.0"
+    "@kotao/storefront-contracts": "^0.2.2"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",