@kotao/storefront 0.2.6 → 0.2.8

package/README.md

@@ -27,6 +27,13 @@ The one real migration diff is `request.cf` → `context.geo`.
   boundaries/registry helpers.
 - `@kotao/storefront/react-router` — the React Router 8 binding (`getKotaoLoadContext`).
 
+## Event approval offers
+
+`EventApprovalOffer` from `@kotao/storefront/events/react` accepts an optional `formatDateTime`
+callback for the visible event start and offer expiry. Format these in the event's locale and a
+fixed time zone so server and browser output agree. The original timestamps remain unchanged in
+the `time` elements and the offer lifecycle.
+
 ## Hydrogen editor preview
 
 `createHydrogenEditorPreviewRuntime` projects manifest-authorized operations into an in-memory

package/dist/{bridge-ZKbKqgFd.d.ts → bridge-CfNBWu0H.d.ts}

@@ -1,4 +1,4 @@
-import { T as ThemeSettingsStore, R as ResolvedSettings, a as ResolvedSection, b as ResolvedBlock } from './store-DO08fzJi.js';
+import { T as ThemeSettingsStore, R as ResolvedSettings, a as ResolvedSection, b as ResolvedBlock } from './store-ZzoBbWir.js';
 
 interface StorefrontEditorMessageTarget {
     postMessage(message: unknown, targetOrigin: string): void;
@@ -15,6 +15,12 @@ interface StorefrontEditorMessageSource {
 interface StorefrontEditorPointerEvent {
     readonly target?: unknown;
     readonly relatedTarget?: unknown;
+    readonly button?: number;
+    readonly defaultPrevented?: boolean;
+    readonly metaKey?: boolean;
+    readonly ctrlKey?: boolean;
+    readonly shiftKey?: boolean;
+    readonly altKey?: boolean;
     preventDefault?(): void;
     stopPropagation?(): void;
 }
@@ -56,6 +62,13 @@ interface StorefrontEditorDocument {
     readonly defaultView?: {
         readonly innerWidth: number;
         readonly innerHeight: number;
+        readonly location?: {
+            readonly href: string;
+            readonly origin: string;
+        };
+        requestAnimationFrame?(callback: (now: number) => void): number;
+        cancelAnimationFrame?(requestId: number): void;
+        open?(url: string, target: '_blank', features: 'noopener,noreferrer'): void;
         addEventListener?(type: 'scroll' | 'resize', listener: () => void, capture?: boolean): void;
         removeEventListener?(type: 'scroll' | 'resize', listener: () => void, capture?: boolean): void;
     };
@@ -153,6 +166,7 @@ interface StorefrontEditorValuesDocument {
 }
 interface StorefrontEditorReady {
     readonly sections: readonly ResolvedSection[];
+    readonly visualReadyProtocol?: 1;
     readonly global?: ResolvedSettings;
     readonly schemas?: Readonly<Record<string, StorefrontEditorSectionSchema>>;
     readonly globalInputs?: readonly StorefrontEditorSettingInput[];
@@ -162,6 +176,7 @@ interface StorefrontEditorReady {
 }
 interface StorefrontEditorHostBridge {
     requestReady(): void;
+    requestVisualReady(requestId: string): void;
     hoverSection(sectionId: string | null): void;
     activateSection(sectionId: string | null, blockId?: string): void;
     patchSection(sectionId: string, settings: ResolvedSettings): void;
@@ -176,8 +191,12 @@ interface StorefrontEditorHostBridge {
     replaceTemplate(handle: string, document: StorefrontEditorValuesDocument): void;
     replaceSectionGroup(handle: string, document: StorefrontEditorValuesDocument): void;
     replaceAppExtensions(extensions: readonly StorefrontEditorAppExtensionPreview[]): void;
+    setInspectorEnabled(enabled: boolean): void;
     dispose(): void;
 }
+interface StorefrontEditorNavigationRequest {
+    readonly href: string;
+}
 interface StorefrontEditorAppExtensionPreview {
     readonly instanceId: string;
     readonly kind: 'app_embed' | 'app_section' | 'app_block';
@@ -217,7 +236,9 @@ interface CreateStorefrontEditorHostBridgeArgs {
     readonly onSelectSection: (selection: StorefrontEditorSelection) => void;
     readonly onCanvasAction?: (action: StorefrontEditorCanvasAction) => void;
     readonly onHoverSection?: (sectionId: string | null) => void;
+    readonly onNavigate?: (request: StorefrontEditorNavigationRequest) => void;
     readonly onReady?: (ready: StorefrontEditorReady) => void;
+    readonly onVisualReady?: (requestId: string) => void;
     readonly previewOrigin: string;
     readonly resolveTarget?: () => StorefrontEditorMessageTarget | null;
     readonly shopId: string;
@@ -234,6 +255,6 @@ declare function positionStorefrontEditorCanvasToolbar(anchor: StorefrontEditorR
     readonly height: number;
 }): StorefrontEditorCanvasPosition;
 declare function createStorefrontEditorBridge({ adminOrigin, document: editorDocument, globalInputs, themeStyles, schemas, sectionGroups, shopId, store, target, templates, transport, }: CreateStorefrontEditorBridgeArgs): StorefrontEditorBridge;
-declare function createStorefrontEditorHostBridge({ onCanvasAction, onHoverSection, onReady, onSelectSection, previewOrigin, resolveTarget, shopId, target, transport, }: CreateStorefrontEditorHostBridgeArgs): StorefrontEditorHostBridge;
+declare function createStorefrontEditorHostBridge({ onCanvasAction, onHoverSection, onNavigate, onReady, onSelectSection, onVisualReady, previewOrigin, resolveTarget, shopId, target, transport, }: CreateStorefrontEditorHostBridgeArgs): StorefrontEditorHostBridge;
 
-export { type CreateStorefrontEditorBridgeArgs as C, type StorefrontEditorMessageSource as S, type StorefrontEditorMessageTarget as a, type CreateStorefrontEditorHostBridgeArgs as b, type StorefrontEditorAppExtensionPreview as c, type StorefrontEditorBlockSchema as d, type StorefrontEditorBridge as e, type StorefrontEditorCanvasAction as f, type StorefrontEditorCanvasBlockAction as g, type StorefrontEditorCanvasPosition as h, type StorefrontEditorCanvasSectionAction as i, type StorefrontEditorDocument as j, type StorefrontEditorHostBridge as k, type StorefrontEditorMessageEvent as l, type StorefrontEditorReady as m, type StorefrontEditorRect as n, type StorefrontEditorSectionPreset as o, type StorefrontEditorSectionPresetBlock as p, type StorefrontEditorSectionSchema as q, type StorefrontEditorSelection as r, type StorefrontEditorSelectionScope as s, type StorefrontEditorSettingInput as t, type StorefrontEditorSettingOption as u, type StorefrontEditorThemeStyle as v, type StorefrontEditorValuesDocument as w, createStorefrontEditorBridge as x, createStorefrontEditorHostBridge as y, positionStorefrontEditorCanvasToolbar as z };
+export { positionStorefrontEditorCanvasToolbar as A, type CreateStorefrontEditorBridgeArgs as C, type StorefrontEditorMessageSource as S, type StorefrontEditorMessageTarget as a, type CreateStorefrontEditorHostBridgeArgs as b, type StorefrontEditorAppExtensionPreview as c, type StorefrontEditorBlockSchema as d, type StorefrontEditorBridge as e, type StorefrontEditorCanvasAction as f, type StorefrontEditorCanvasBlockAction as g, type StorefrontEditorCanvasPosition as h, type StorefrontEditorCanvasSectionAction as i, type StorefrontEditorDocument as j, type StorefrontEditorHostBridge as k, type StorefrontEditorMessageEvent as l, type StorefrontEditorNavigationRequest as m, type StorefrontEditorReady as n, type StorefrontEditorRect as o, type StorefrontEditorSectionPreset as p, type StorefrontEditorSectionPresetBlock as q, type StorefrontEditorSectionSchema as r, type StorefrontEditorSelection as s, type StorefrontEditorSelectionScope as t, type StorefrontEditorSettingInput as u, type StorefrontEditorSettingOption as v, type StorefrontEditorThemeStyle as w, type StorefrontEditorValuesDocument as x, createStorefrontEditorBridge as y, createStorefrontEditorHostBridge as z };

package/dist/{chunk-EG34HLSX.js → chunk-DTKLAOKR.js}

@@ -2,7 +2,7 @@ import { CONSENT_BUCKETS, readConsentCookie, CART_FORM_ACTIONS } from './chunk-O
 import { fetchThemeSettings } from './chunk-2MRB6SMP.js';
 import { encodeUtf8Base64Url, toBase64Url, fromBase64Url, decodeBase64UrlUtf8 } from './chunk-CKGI3Y7L.js';
 import { createEventsClient, normalizeStorefrontHeaders } from './chunk-R4N565GX.js';
-import { HOSTED_SURFACE_DESIGN_INPUTS, MARKET_ID_HEADER, MARKET_DEFAULT_LOCALE_HEADER, MARKET_CANONICAL_URL_HEADER, MARKET_ROOT_URLS_HEADER, MARKET_PATH_PREFIX_HEADER, MARKET_THEME_ID_HEADER, MARKET_SETTINGS_ENVIRONMENT_HEADER, MARKET_ALTERNATE_LOCALES_HEADER, SHOP_HEADER, SHOP_SIGNATURE_HEADER, SHOP_ORIGIN_HEADER, autoRedirectEnabled, AUTO_REDIRECT_COUNTRY_HEADER, signShopContext } from '@kotao/storefront-contracts';
+import { HOSTED_SURFACE_DESIGN_INPUTS, MARKET_ID_HEADER, MARKET_DEFAULT_LOCALE_HEADER, MARKET_CANONICAL_URL_HEADER, MARKET_ROOT_URLS_HEADER, MARKET_PATH_PREFIX_HEADER, MARKET_THEME_ID_HEADER, MARKET_SETTINGS_ENVIRONMENT_HEADER, MARKET_ALTERNATE_LOCALES_HEADER, SHOP_HEADER, SHOP_SIGNATURE_HEADER, SHOP_ORIGIN_HEADER, autoRedirectEnabled, AUTO_REDIRECT_COUNTRY_HEADER, rolloutVisitorCookieHeader, signShopContext } from '@kotao/storefront-contracts';
 export { MARKET_ALTERNATE_LOCALES_HEADER, MARKET_CANONICAL_URL_HEADER, MARKET_DEFAULT_LOCALE_HEADER, MARKET_ID_HEADER, MARKET_PATH_PREFIX_HEADER, MARKET_ROOT_URLS_HEADER, MARKET_SETTINGS_ENVIRONMENT_HEADER, MARKET_THEME_ID_HEADER } from '@kotao/storefront-contracts';
 
 // src/cache/cache.ts
@@ -110,12 +110,19 @@ function readCartIdCookie(cookieHeader) {
   if (cookieHeader == null || cookieHeader === "") return null;
   const match = cookieHeader.split(";").map((part) => part.trim()).find((part) => part.startsWith(`${CART_ID_COOKIE}=`));
   if (match === void 0) return null;
-  const value = decodeURIComponent(match.slice(CART_ID_COOKIE.length + 1));
-  return value === "" ? null : value;
+  try {
+    const value = decodeURIComponent(match.slice(CART_ID_COOKIE.length + 1));
+    return value === "" ? null : value;
+  } catch {
+    return null;
+  }
 }
 function buildCartIdCookie(cartId) {
   return `${CART_ID_COOKIE}=${encodeURIComponent(cartId)}; Path=/; Max-Age=${CART_MAX_AGE}; SameSite=Lax; Secure; HttpOnly`;
 }
+function clearCartIdCookie() {
+  return `${CART_ID_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax; Secure; HttpOnly`;
+}
 
 // src/customer-account/session.ts
 var CUSTOMER_SESSION_COOKIE = "kotao_customer_session";
@@ -1195,6 +1202,9 @@ function createCustomerAccountClient(opts) {
       }
     },
     async account() {
+      if (token === null) {
+        throw new CustomerAccountError("unauthenticated", "account read: not logged in");
+      }
       return readJson(await proxyGet("/account"), "account read");
     },
     async orders(options) {
@@ -1920,6 +1930,8 @@ async function createKotaoContext(request, env, executionCtx, deps) {
   const geoCountry = autoCountry ? geo?.country?.trim().toUpperCase() ?? null : null;
   const apiCountry = editorCountry ?? cookieCountry ?? (geoCountry !== null && API_COUNTRY_RE.test(geoCountry) ? geoCountry : null);
   const extraHeaders = {};
+  const rolloutVisitorCookie = rolloutVisitorCookieHeader(request.headers.get("cookie"));
+  if (rolloutVisitorCookie !== null) extraHeaders["cookie"] = rolloutVisitorCookie;
   const requestId = request.headers.get(REQUEST_ID_HEADER)?.trim();
   if (requestId !== void 0 && requestId.length > 0) extraHeaders[REQUEST_ID_HEADER] = requestId;
   const deploymentId = request.headers.get(DEPLOYMENT_ID_HEADER)?.trim();
@@ -1938,6 +1950,7 @@ async function createKotaoContext(request, env, executionCtx, deps) {
     cache
   });
   const eventHeaders = new Headers(signedShopContextHeaders);
+  if (rolloutVisitorCookie !== null) eventHeaders.set("cookie", rolloutVisitorCookie);
   if (apiLocale !== void 0) eventHeaders.set("x-kotao-locale", apiLocale);
   if (apiCountry !== null) eventHeaders.set("x-kotao-country", apiCountry);
   for (const [name, value] of Object.entries(extraHeaders)) eventHeaders.set(name, value);
@@ -1980,7 +1993,13 @@ async function createKotaoContext(request, env, executionCtx, deps) {
     loadThemeSettings: (opts) => fetchThemeSettings({
       endpoint: settingsEndpoint,
       allowCrossOrigin: true,
-      ...signedShopContextHeaders ? { shopContextHeaders: signedShopContextHeaders } : {},
+      ...signedShopContextHeaders || rolloutVisitorCookie !== null || apiCountry !== null ? {
+        shopContextHeaders: {
+          ...signedShopContextHeaders ?? {},
+          ...rolloutVisitorCookie === null ? {} : { cookie: rolloutVisitorCookie },
+          ...apiCountry === null ? {} : { "x-kotao-country": apiCountry }
+        }
+      } : {},
       ...opts?.fetch ? { fetch: opts.fetch } : {},
       ...opts?.templateHandle ? { templateHandle: opts.templateHandle } : {}
     })
@@ -2035,6 +2054,6 @@ function createEphemeralSession(isLoggedIn) {
   };
 }
 
-export { CART_ID_COOKIE, CHECKOUT_CONSENT_CATEGORIES, CHECKOUT_CONSENT_PARAM_PREFIX, CHECKOUT_DESIGN_TOKEN_INPUTS, CUSTOMER_SESSION_COOKIE, CacheCustom, CacheLong, CacheNone, CacheShort, CustomerAccountError, DEFAULT_HOSTED_SESSION_MAX_AGE, DEFAULT_SESSION_MAX_AGE, GEO_HEADER, GEO_SIGNATURE_HEADER, HOSTED_CUSTOMER_CSRF_COOKIE, HOSTED_CUSTOMER_CSRF_HEADER, HOSTED_CUSTOMER_SESSION_COOKIE, LOCALIZATION_COOKIE, MAX_HOSTED_SESSION_MAX_AGE, MAX_LEGACY_CUSTOMER_SESSION_TOKEN_LENGTH, ROUTING_LOCALE_HEADER, ROUTING_ORIGINAL_PATHNAME_HEADER, StorefrontDefaultCache, StorefrontQueryTimeoutError, StorefrontUpstreamError, buildCartIdCookie, buildCustomerSessionCookie, buildHostedCustomerSessionCookie, buildLocalizationCookie, cartGetIdDefault, cartSetIdDefault, clearCustomerSessionCookie, clearHostedCustomerSessionCookie, clearLegacyCustomerSessionCookie, createCache, createCartHandler, createCustomerAccountClient, createKotaoContext, createStorefrontClient, createWithCache, decodeCheckoutConsent, encodeCheckoutConsent, extractCheckoutDesignTokens, generateCacheControlHeader, isLocalePathSegment, localeFromAcceptLanguage, localeFromPathname, localeFromRequest, localizePath, marketContextFromHeaders, originalPathnameFromRequest, readCartIdCookie, readCustomerSessionToken, readHostedCustomerCsrfToken, readHostedCustomerSessionToken, readLegacyCustomerSessionToken, readLocalizationCookie, resolveCheckoutUrl, shopHostname, signGeo, stripLocalePrefixFromPathname, stripLocalePrefixFromRequest, trustedShopOriginFromHeaders, verifyGeo };
-//# sourceMappingURL=chunk-EG34HLSX.js.map
-//# sourceMappingURL=chunk-EG34HLSX.js.map
+export { CART_ID_COOKIE, CHECKOUT_CONSENT_CATEGORIES, CHECKOUT_CONSENT_PARAM_PREFIX, CHECKOUT_DESIGN_TOKEN_INPUTS, CUSTOMER_SESSION_COOKIE, CacheCustom, CacheLong, CacheNone, CacheShort, CustomerAccountError, DEFAULT_HOSTED_SESSION_MAX_AGE, DEFAULT_SESSION_MAX_AGE, GEO_HEADER, GEO_SIGNATURE_HEADER, HOSTED_CUSTOMER_CSRF_COOKIE, HOSTED_CUSTOMER_CSRF_HEADER, HOSTED_CUSTOMER_SESSION_COOKIE, LOCALIZATION_COOKIE, MAX_HOSTED_SESSION_MAX_AGE, MAX_LEGACY_CUSTOMER_SESSION_TOKEN_LENGTH, ROUTING_LOCALE_HEADER, ROUTING_ORIGINAL_PATHNAME_HEADER, StorefrontDefaultCache, StorefrontQueryTimeoutError, StorefrontUpstreamError, buildCartIdCookie, buildCustomerSessionCookie, buildHostedCustomerSessionCookie, buildLocalizationCookie, cartGetIdDefault, cartSetIdDefault, clearCartIdCookie, clearCustomerSessionCookie, clearHostedCustomerSessionCookie, clearLegacyCustomerSessionCookie, createCache, createCartHandler, createCustomerAccountClient, createKotaoContext, createStorefrontClient, createWithCache, decodeCheckoutConsent, encodeCheckoutConsent, extractCheckoutDesignTokens, generateCacheControlHeader, isLocalePathSegment, localeFromAcceptLanguage, localeFromPathname, localeFromRequest, localizePath, marketContextFromHeaders, originalPathnameFromRequest, readCartIdCookie, readCustomerSessionToken, readHostedCustomerCsrfToken, readHostedCustomerSessionToken, readLegacyCustomerSessionToken, readLocalizationCookie, resolveCheckoutUrl, shopHostname, signGeo, stripLocalePrefixFromPathname, stripLocalePrefixFromRequest, trustedShopOriginFromHeaders, verifyGeo };
+//# sourceMappingURL=chunk-DTKLAOKR.js.map
+//# sourceMappingURL=chunk-DTKLAOKR.js.map