@zappie/sdk 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @zappie/sdk
 
+## 0.1.7
+
+### Patch Changes
+
+- 4bfb1b2: Read the optional Maps browser key from storefront integrations. Map legacy URLs to public item, menu, category and order IDs, preserve attribution parameters.
+- 666ba1c: Read selected-menu coverage from `menu_ids`. Expose menu layout and availability, separate plain-text and HTML banners, branch promotions, and order-ahead days. Preserve omitted descriptions and phone numbers as absent fields.
+
 ## 0.1.6
 
 ### Patch Changes

package/README.md

@@ -56,7 +56,7 @@ Prices always come from Zappie. The cart shows a local estimate while it waits,
 | `@zappie/sdk/react`                          | `ZappieProvider` and hooks such as `useStore`, `useMenu` and `useCart` |
 | `@zappie/sdk/checkout`                       | Opening Zappie's hosted checkout and checking it completed             |
 | `@zappie/sdk/customer` and `/customer/react` | Signed-in customers, their orders and saved addresses                  |
-| `@zappie/sdk/integrations`                   | Public tracking IDs for your app’s consent flow                        |
+| `@zappie/sdk/integrations`                   | Public integration IDs and browser keys                                |
 | `@zappie/sdk/places`                         | Address search and delivery-zone checks                                |
 | `@zappie/sdk/server`                         | Server-side reads, storefront URLs and `verifyWebhook()`               |
 | `@zappie/sdk/template` and `/template/react` | Template settings and responsive images for template authors           |
@@ -79,3 +79,23 @@ The SDK is at `0.x`. Its API can change in a minor release while it settles. Eac
 ## License
 
 MIT
+
+### Maps browser key
+
+`createIntegrations().get()` from `@zappie/sdk/integrations` returns optional
+`googleMaps: { browserKey: string }`. The REST field is
+`google_maps: { browser_key: string } | null`. An absent or null field returns
+`googleMaps: undefined`, so apps can use this before the API field is deployed.
+The SDK does not load Maps scripts.
+
+### Legacy redirects
+
+`storefrontRedirect(input, { installation })` from `@zappie/sdk/url` returns
+`string | null`. Callers choose the HTTP status when they serve the redirect.
+Zappie's templates use temporary redirects (302) for now.
+
+V2 URLs use `item_` and `ord_` public IDs, `menu=menu_<id>`, and category
+anchors `#c-cat_<id>`. Already-prefixed IDs stay unchanged. Legacy cart,
+checkout and sign-in overlays become routes. Unsupported legacy UI parameters
+are dropped. Ad click IDs, `ref`, and every `utm_*` parameter retain their values.
+Payment-return and printed QR routes retain their existing parameters.

package/dist/cart/branch.d.ts

@@ -1,5 +1,5 @@
-import { M as Money, I as Item, a as Menu } from '../models-Rg5kQUkv.js';
-import { C as CartLine } from '../types-CuDvfW9g.js';
+import { M as Money, I as Item, a as Menu } from '../models-D__QbqEd.js';
+import { C as CartLine } from '../types-B-iTMrVV.js';
 
 /** A line that can move to the destination branch, with its old and new estimates. */
 type BranchSwitchKeptLine = {

package/dist/cart/item.d.ts

@@ -1,6 +1,6 @@
-import { Z as Zappie } from '../client-Bm2cCYea.js';
-import { I as Item } from '../models-Rg5kQUkv.js';
-import '../types-CuDvfW9g.js';
+import { Z as Zappie } from '../client-iVMHfAFn.js';
+import { I as Item } from '../models-D__QbqEd.js';
+import '../types-B-iTMrVV.js';
 
 /** Register an item already read by a partial/selected catalogue, without fetching it again. */
 declare function prepareItem(client: Zappie, item: Item, options: {

package/dist/cart/quote.d.ts

@@ -1,6 +1,6 @@
-import { T as Transport, R as RequestCtx } from '../client-Bm2cCYea.js';
-import { Q as QuoteRequest, a as Quote } from '../types-CuDvfW9g.js';
-import '../models-Rg5kQUkv.js';
+import { T as Transport, R as RequestCtx } from '../client-iVMHfAFn.js';
+import { Q as QuoteRequest, a as Quote } from '../types-B-iTMrVV.js';
+import '../models-D__QbqEd.js';
 
 type QuoteClientOptions = {
     customerBase?: string | undefined;

package/dist/{client-Bm2cCYea.d.ts → client-iVMHfAFn.d.ts}

@@ -1,5 +1,5 @@
-import { a as Menu, C as CategoryPage, S as Store, I as Item, M as Money, F as Formatters } from './models-Rg5kQUkv.js';
-import { Q as QuoteRequest, g as WireQuote, i as CartIssueCode, d as CartModule, b as CartLineInput } from './types-CuDvfW9g.js';
+import { a as Menu, C as CategoryPage, S as Store, I as Item, M as Money, F as Formatters } from './models-D__QbqEd.js';
+import { Q as QuoteRequest, g as WireQuote, i as CartIssueCode, d as CartModule, b as CartLineInput } from './types-B-iTMrVV.js';
 
 /**
  * The store, branch, order context and source menu that identify a saved catalogue.

package/dist/debug.d.ts

@@ -1,6 +1,6 @@
-import { b as CartLineInput, a as Quote } from './types-CuDvfW9g.js';
-import { M as Money, a as Menu, B as Branch } from './models-Rg5kQUkv.js';
-import { Z as Zappie } from './client-Bm2cCYea.js';
+import { b as CartLineInput, a as Quote } from './types-B-iTMrVV.js';
+import { M as Money, a as Menu, B as Branch } from './models-D__QbqEd.js';
+import { Z as Zappie } from './client-iVMHfAFn.js';
 
 type StoredLine = CartLineInput & {
     id: string;

package/dist/debug.js

@@ -1,5 +1,5 @@
 // src/debug.ts
-var VERSION = true ? "0.1.6" : "0.0.0-development";
+var VERSION = true ? "0.1.7" : "0.0.0-development";
 function installDebug(client) {
   if (typeof window === "undefined" || client.mode !== "test") {
     return;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { T as Transport, R as RequestCtx, f as MenuFulfilment, g as MenuResponse, h as SelectedMenuRequest, i as SelectedMenuResponse, j as SearchRequest, k as SearchPage, l as MenuVersion, a as ZappieError } from './client-Bm2cCYea.js';
-export { A as API_VERSION, E as ErrorDetails, m as MenuReadOptions, M as MenuResource, n as ReadOptions, S as StorageLike, c as StoreResource, Z as Zappie, b as ZappieClientOptions, b as ZappieConfig, e as ZappieErrorCode, d as ZappieEvents, o as createZappie, p as isZappieError } from './client-Bm2cCYea.js';
-import { S as Store, C as CategoryPage, I as Item, O as OptionGroup, M as Money, a as Menu, B as Branch } from './models-Rg5kQUkv.js';
-export { b as Category, c as Choice, d as Currency, F as Formatters, e as Fulfilment, f as MenuSchedule, g as MenuSection, h as MoneyFormatOptions, i as OpeningTime, j as OptionCondition, P as PaymentMethodKind, k as SpecialHours, V as Variant, l as format, m as money } from './models-Rg5kQUkv.js';
-import { Q as QuoteRequest, g as WireQuote, f as CartIssue, b as CartLineInput, C as CartLine } from './types-CuDvfW9g.js';
-export { h as CartFix, c as CartFulfilment, i as CartIssueCode, d as CartModule, j as CartSnapshot, e as CartState, k as CartSyncAdapter, l as CartSyncDocument, D as DeliveryAddress, a as Quote, m as WireFix, W as WireFulfilment, n as WireIssue, o as WireLine, p as WireMoney } from './types-CuDvfW9g.js';
+import { T as Transport, R as RequestCtx, f as MenuFulfilment, g as MenuResponse, h as SelectedMenuRequest, i as SelectedMenuResponse, j as SearchRequest, k as SearchPage, l as MenuVersion, a as ZappieError } from './client-iVMHfAFn.js';
+export { A as API_VERSION, E as ErrorDetails, m as MenuReadOptions, M as MenuResource, n as ReadOptions, S as StorageLike, c as StoreResource, Z as Zappie, b as ZappieClientOptions, b as ZappieConfig, e as ZappieErrorCode, d as ZappieEvents, o as createZappie, p as isZappieError } from './client-iVMHfAFn.js';
+import { S as Store, C as CategoryPage, I as Item, O as OptionGroup, M as Money, a as Menu, B as Branch } from './models-D__QbqEd.js';
+export { b as Category, c as Choice, d as Currency, F as Formatters, e as Fulfilment, f as MenuSchedule, g as MenuSection, h as MoneyFormatOptions, i as OpeningTime, j as OptionCondition, P as PaymentMethodKind, k as SpecialHours, V as Variant, l as format, m as money } from './models-D__QbqEd.js';
+import { Q as QuoteRequest, g as WireQuote, f as CartIssue, b as CartLineInput, C as CartLine } from './types-B-iTMrVV.js';
+export { h as CartFix, c as CartFulfilment, i as CartIssueCode, d as CartModule, j as CartSnapshot, e as CartState, k as CartSyncAdapter, l as CartSyncDocument, D as DeliveryAddress, a as Quote, m as WireFix, W as WireFulfilment, n as WireIssue, o as WireLine, p as WireMoney } from './types-B-iTMrVV.js';
 
 /** REST connection options. A custom fetch can provide tracing or mock responses. */
 type RestTransportOptions = {

package/dist/index.js

@@ -10,7 +10,7 @@ import { previewItem } from "./cart/preview.js";
 import { estimateUnitPrice } from "./cart/price.js";
 import { resolveSourceMenu } from "./cart/source-menu.js";
 import { validateLine } from "./cart/validate.js";
-var VERSION = true ? "0.1.6" : "0.0.0-development";
+var VERSION = true ? "0.1.7" : "0.0.0-development";
 export {
   API_VERSION,
   RestTransport,

package/dist/integrations/index.d.ts

@@ -1,9 +1,12 @@
-import { R as RequestCtx } from '../client-Bm2cCYea.js';
-import '../models-Rg5kQUkv.js';
-import '../types-CuDvfW9g.js';
+import { R as RequestCtx } from '../client-iVMHfAFn.js';
+import '../models-D__QbqEd.js';
+import '../types-B-iTMrVV.js';
 
-/** Public tracking IDs. Your app decides when consent allows it to load scripts. */
+/** Public integration IDs and browser keys. Your app decides when to load scripts. */
 type Integrations = {
+    googleMaps?: {
+        browserKey: string;
+    };
     googleAnalytics?: {
         measurementId: string;
     };
@@ -11,7 +14,7 @@ type Integrations = {
         pixelId: string;
     };
 };
-/** A backend that supplies public tracking IDs without loading scripts. */
+/** A backend that supplies public integration IDs and browser keys without loading scripts. */
 type IntegrationsTransport = {
     getIntegrations(ctx: RequestCtx): Promise<Integrations>;
 };
@@ -24,7 +27,7 @@ type IntegrationsOptions = {
     transport?: IntegrationsTransport;
 };
 /**
- * Create a client that reads public tracking IDs. It never loads tracking scripts.
+ * Create a client that reads public integration IDs and browser keys. It never loads tracking scripts.
  * Import this entry when your app needs the IDs, then apply your consent policy.
  */
 declare function createIntegrations(options: IntegrationsOptions): {

package/dist/integrations/index.js

@@ -62,6 +62,7 @@ function createIntegrations(options) {
         return result;
       };
       return {
+        ...raw.google_maps != null ? { googleMaps: { browserKey: id(raw.google_maps, "browser_key") } } : {},
         ...raw.google_analytics != null ? {
           googleAnalytics: {
             measurementId: id(raw.google_analytics, "measurement_id")

package/dist/integrations/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/integrations/index.ts"],
-  "sourcesContent": ["import { requestWithRetry } from \"../internal/customer-http\";\nimport {\n  API_VERSION,\n  RestTransport,\n  validateConfig,\n  ZappieError,\n} from \"../places/sdk\";\nimport type { RequestCtx } from \"../transport/types\";\n\n/** Public tracking IDs. Your app decides when consent allows it to load scripts. */\nexport type Integrations = {\n  googleAnalytics?: { measurementId: string };\n  metaPixel?: { pixelId: string };\n};\n\n/** A backend that supplies public tracking IDs without loading scripts. */\nexport type IntegrationsTransport = {\n  getIntegrations(ctx: RequestCtx): Promise<Integrations>;\n};\n\n/** Credentials and optional connection settings for the integrations read. */\nexport type IntegrationsOptions = {\n  key: string;\n  baseUrl?: string;\n  version?: string;\n  fetch?: typeof fetch;\n  transport?: IntegrationsTransport;\n};\n\n/**\n * Create a client that reads public tracking IDs. It never loads tracking scripts.\n * Import this entry when your app needs the IDs, then apply your consent policy.\n */\nexport function createIntegrations(options: IntegrationsOptions) {\n  validateConfig({ store: \"integrations\", key: options.key });\n  const base = new RestTransport(options).baseUrl;\n  return {\n    /** Read enabled integrations. An absent integration has no public ID to use. */\n    async get(read: { signal?: AbortSignal } = {}): Promise<Integrations> {\n      const ctx = {\n        key: options.key,\n        version: options.version ?? API_VERSION,\n        ...read,\n      };\n      if (options.transport) {\n        return options.transport.getIntegrations(ctx);\n      }\n      const response = await requestWithRetry(\n        options.fetch ?? ((input, init) => globalThis.fetch(input, init)),\n        `${base}/store/integrations`,\n        {\n          redirect: \"manual\",\n          headers: {\n            Authorization: `Bearer ${ctx.key}`,\n            \"Zappie-Version\": ctx.version,\n          },\n          ...read,\n        },\n        \"Could not read storefront integrations\",\n      );\n      if (!response.ok) {\n        throw new ZappieError(\n          \"server_error\",\n          \"Could not read storefront integrations\",\n          { status: response.status },\n        );\n      }\n      const value: unknown = await response.json();\n      const record = (value: unknown): Record<string, unknown> => {\n        if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Invalid storefront integrations\",\n          );\n        }\n        return value as Record<string, unknown>;\n      };\n      const raw = record(value);\n      const id = (value: unknown, key: string): string => {\n        const result = record(value)[key];\n        if (typeof result !== \"string\" || !result) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Invalid storefront integration ID\",\n          );\n        }\n        return result;\n      };\n      return {\n        ...(raw.google_analytics != null\n          ? {\n              googleAnalytics: {\n                measurementId: id(raw.google_analytics, \"measurement_id\"),\n              },\n            }\n          : {}),\n        ...(raw.meta_pixel != null\n          ? { metaPixel: { pixelId: id(raw.meta_pixel, \"pixel_id\") } }\n          : {}),\n      };\n    },\n  };\n}\n\n/** The integrations read returned by createIntegrations. */\nexport type IntegrationsClient = ReturnType<typeof createIntegrations>;\n"],
-  "mappings": ";AAAA,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA2BA,SAAS,mBAAmB,SAA8B;AAC/D,iBAAe,EAAE,OAAO,gBAAgB,KAAK,QAAQ,IAAI,CAAC;AAC1D,QAAM,OAAO,IAAI,cAAc,OAAO,EAAE;AACxC,SAAO;AAAA;AAAA,IAEL,MAAM,IAAI,OAAiC,CAAC,GAA0B;AACpE,YAAM,MAAM;AAAA,QACV,KAAK,QAAQ;AAAA,QACb,SAAS,QAAQ,WAAW;AAAA,QAC5B,GAAG;AAAA,MACL;AACA,UAAI,QAAQ,WAAW;AACrB,eAAO,QAAQ,UAAU,gBAAgB,GAAG;AAAA,MAC9C;AACA,YAAM,WAAW,MAAM;AAAA,QACrB,QAAQ,UAAU,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,QAC/D,GAAG,IAAI;AAAA,QACP;AAAA,UACE,UAAU;AAAA,UACV,SAAS;AAAA,YACP,eAAe,UAAU,IAAI,GAAG;AAAA,YAChC,kBAAkB,IAAI;AAAA,UACxB;AAAA,UACA,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AACA,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA,EAAE,QAAQ,SAAS,OAAO;AAAA,QAC5B;AAAA,MACF;AACA,YAAM,QAAiB,MAAM,SAAS,KAAK;AAC3C,YAAM,SAAS,CAACA,WAA4C;AAC1D,YAAI,CAACA,UAAS,OAAOA,WAAU,YAAY,MAAM,QAAQA,MAAK,GAAG;AAC/D,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAOA;AAAA,MACT;AACA,YAAM,MAAM,OAAO,KAAK;AACxB,YAAM,KAAK,CAACA,QAAgB,QAAwB;AAClD,cAAM,SAAS,OAAOA,MAAK,EAAE,GAAG;AAChC,YAAI,OAAO,WAAW,YAAY,CAAC,QAAQ;AACzC,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAO;AAAA,MACT;AACA,aAAO;AAAA,QACL,GAAI,IAAI,oBAAoB,OACxB;AAAA,UACE,iBAAiB;AAAA,YACf,eAAe,GAAG,IAAI,kBAAkB,gBAAgB;AAAA,UAC1D;AAAA,QACF,IACA,CAAC;AAAA,QACL,GAAI,IAAI,cAAc,OAClB,EAAE,WAAW,EAAE,SAAS,GAAG,IAAI,YAAY,UAAU,EAAE,EAAE,IACzD,CAAC;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { requestWithRetry } from \"../internal/customer-http\";\nimport {\n  API_VERSION,\n  RestTransport,\n  validateConfig,\n  ZappieError,\n} from \"../places/sdk\";\nimport type { RequestCtx } from \"../transport/types\";\n\n/** Public integration IDs and browser keys. Your app decides when to load scripts. */\nexport type Integrations = {\n  googleMaps?: { browserKey: string };\n  googleAnalytics?: { measurementId: string };\n  metaPixel?: { pixelId: string };\n};\n\n/** A backend that supplies public integration IDs and browser keys without loading scripts. */\nexport type IntegrationsTransport = {\n  getIntegrations(ctx: RequestCtx): Promise<Integrations>;\n};\n\n/** Credentials and optional connection settings for the integrations read. */\nexport type IntegrationsOptions = {\n  key: string;\n  baseUrl?: string;\n  version?: string;\n  fetch?: typeof fetch;\n  transport?: IntegrationsTransport;\n};\n\n/**\n * Create a client that reads public integration IDs and browser keys. It never loads tracking scripts.\n * Import this entry when your app needs the IDs, then apply your consent policy.\n */\nexport function createIntegrations(options: IntegrationsOptions) {\n  validateConfig({ store: \"integrations\", key: options.key });\n  const base = new RestTransport(options).baseUrl;\n  return {\n    /** Read enabled integrations. An absent integration has no public ID to use. */\n    async get(read: { signal?: AbortSignal } = {}): Promise<Integrations> {\n      const ctx = {\n        key: options.key,\n        version: options.version ?? API_VERSION,\n        ...read,\n      };\n      if (options.transport) {\n        return options.transport.getIntegrations(ctx);\n      }\n      const response = await requestWithRetry(\n        options.fetch ?? ((input, init) => globalThis.fetch(input, init)),\n        `${base}/store/integrations`,\n        {\n          redirect: \"manual\",\n          headers: {\n            Authorization: `Bearer ${ctx.key}`,\n            \"Zappie-Version\": ctx.version,\n          },\n          ...read,\n        },\n        \"Could not read storefront integrations\",\n      );\n      if (!response.ok) {\n        throw new ZappieError(\n          \"server_error\",\n          \"Could not read storefront integrations\",\n          { status: response.status },\n        );\n      }\n      const value: unknown = await response.json();\n      const record = (value: unknown): Record<string, unknown> => {\n        if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Invalid storefront integrations\",\n          );\n        }\n        return value as Record<string, unknown>;\n      };\n      const raw = record(value);\n      const id = (value: unknown, key: string): string => {\n        const result = record(value)[key];\n        if (typeof result !== \"string\" || !result) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Invalid storefront integration ID\",\n          );\n        }\n        return result;\n      };\n      return {\n        ...(raw.google_maps != null\n          ? { googleMaps: { browserKey: id(raw.google_maps, \"browser_key\") } }\n          : {}),\n        ...(raw.google_analytics != null\n          ? {\n              googleAnalytics: {\n                measurementId: id(raw.google_analytics, \"measurement_id\"),\n              },\n            }\n          : {}),\n        ...(raw.meta_pixel != null\n          ? { metaPixel: { pixelId: id(raw.meta_pixel, \"pixel_id\") } }\n          : {}),\n      };\n    },\n  };\n}\n\n/** The integrations read returned by createIntegrations. */\nexport type IntegrationsClient = ReturnType<typeof createIntegrations>;\n"],
+  "mappings": ";AAAA,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA4BA,SAAS,mBAAmB,SAA8B;AAC/D,iBAAe,EAAE,OAAO,gBAAgB,KAAK,QAAQ,IAAI,CAAC;AAC1D,QAAM,OAAO,IAAI,cAAc,OAAO,EAAE;AACxC,SAAO;AAAA;AAAA,IAEL,MAAM,IAAI,OAAiC,CAAC,GAA0B;AACpE,YAAM,MAAM;AAAA,QACV,KAAK,QAAQ;AAAA,QACb,SAAS,QAAQ,WAAW;AAAA,QAC5B,GAAG;AAAA,MACL;AACA,UAAI,QAAQ,WAAW;AACrB,eAAO,QAAQ,UAAU,gBAAgB,GAAG;AAAA,MAC9C;AACA,YAAM,WAAW,MAAM;AAAA,QACrB,QAAQ,UAAU,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,QAC/D,GAAG,IAAI;AAAA,QACP;AAAA,UACE,UAAU;AAAA,UACV,SAAS;AAAA,YACP,eAAe,UAAU,IAAI,GAAG;AAAA,YAChC,kBAAkB,IAAI;AAAA,UACxB;AAAA,UACA,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AACA,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA,EAAE,QAAQ,SAAS,OAAO;AAAA,QAC5B;AAAA,MACF;AACA,YAAM,QAAiB,MAAM,SAAS,KAAK;AAC3C,YAAM,SAAS,CAACA,WAA4C;AAC1D,YAAI,CAACA,UAAS,OAAOA,WAAU,YAAY,MAAM,QAAQA,MAAK,GAAG;AAC/D,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAOA;AAAA,MACT;AACA,YAAM,MAAM,OAAO,KAAK;AACxB,YAAM,KAAK,CAACA,QAAgB,QAAwB;AAClD,cAAM,SAAS,OAAOA,MAAK,EAAE,GAAG;AAChC,YAAI,OAAO,WAAW,YAAY,CAAC,QAAQ;AACzC,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAO;AAAA,MACT;AACA,aAAO;AAAA,QACL,GAAI,IAAI,eAAe,OACnB,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI,aAAa,aAAa,EAAE,EAAE,IACjE,CAAC;AAAA,QACL,GAAI,IAAI,oBAAoB,OACxB;AAAA,UACE,iBAAiB;AAAA,YACf,eAAe,GAAG,IAAI,kBAAkB,gBAAgB;AAAA,UAC1D;AAAA,QACF,IACA,CAAC;AAAA,QACL,GAAI,IAAI,cAAc,OAClB,EAAE,WAAW,EAAE,SAAS,GAAG,IAAI,YAAY,UAAU,EAAE,EAAE,IACzD,CAAC;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;",
   "names": ["value"]
 }

package/dist/internal.d.ts

@@ -1,6 +1,6 @@
-import { c as CartFulfilment, W as WireFulfilment } from './types-CuDvfW9g.js';
-export { v as validateConfig } from './client-Bm2cCYea.js';
-import './models-Rg5kQUkv.js';
+import { c as CartFulfilment, W as WireFulfilment } from './types-B-iTMrVV.js';
+export { v as validateConfig } from './client-iVMHfAFn.js';
+import './models-D__QbqEd.js';
 
 /**
  * Convert a cart fulfilment selection to the API field names used by quotes and checkout.

package/dist/{models-Rg5kQUkv.d.ts → models-D__QbqEd.d.ts}

@@ -74,6 +74,14 @@ type Branch = {
             lng: number;
         };
     };
+    /** Automatic promotions to display. The quote decides whether an order qualifies. */
+    promos?: {
+        id: string;
+        name: string;
+        description: string;
+    }[];
+    /** How many days ahead this branch accepts scheduled orders. */
+    orderAheadDays?: number;
     socialLinks?: {
         type: string;
         url: string;
@@ -135,8 +143,13 @@ type MenuSection = {
     id: string;
     name: string;
     categoryIds: string[];
-    /** Merchant rich text. Sanitize it before you render it. */
+    layout?: "LIST" | "GRID" | "CARD";
+    /** Whether this menu is available now at the selected branch. */
+    isActive?: boolean;
+    /** Plain-text merchant banner. */
     infoBanner?: string;
+    /** Sanitized rich-text banner supplied by the service. */
+    infoBannerHtml?: string;
     schedule?: MenuSchedule;
 };
 /** A branch catalogue that stores each item once across categories. */

package/dist/persist/catalogue.d.ts

@@ -1,3 +1,3 @@
-export { q as CATALOGUE_MAX_AGE_MS, r as CATALOGUE_MAX_BYTES, s as CatalogueScope, t as SavedCatalogue, u as catalogueDigest, w as catalogueKey, x as createCatalogueStorage, y as createSavedCatalogue } from '../client-Bm2cCYea.js';
-import '../models-Rg5kQUkv.js';
-import '../types-CuDvfW9g.js';
+export { q as CATALOGUE_MAX_AGE_MS, r as CATALOGUE_MAX_BYTES, s as CatalogueScope, t as SavedCatalogue, u as catalogueDigest, w as catalogueKey, x as createCatalogueStorage, y as createSavedCatalogue } from '../client-iVMHfAFn.js';
+import '../models-D__QbqEd.js';
+import '../types-B-iTMrVV.js';

package/dist/react/index.d.ts

@@ -1,9 +1,9 @@
 export { VERSION } from '../index.js';
-import { I as Item, a as Menu, S as Store, M as Money } from '../models-Rg5kQUkv.js';
-import { a as ZappieError, Z as Zappie } from '../client-Bm2cCYea.js';
+import { I as Item, a as Menu, S as Store, M as Money } from '../models-D__QbqEd.js';
+import { a as ZappieError, Z as Zappie } from '../client-iVMHfAFn.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { d as CartModule, C as CartLine, c as CartFulfilment, e as CartState, f as CartIssue } from '../types-CuDvfW9g.js';
+import { d as CartModule, C as CartLine, c as CartFulfilment, e as CartState, f as CartIssue } from '../types-B-iTMrVV.js';
 
 /** Subscribe to storefront identity and branch-directory data. */
 declare function useStore(): {

package/dist/server/index.d.ts

@@ -1,7 +1,7 @@
-import { a as Menu, F as Formatters, S as Store } from '../models-Rg5kQUkv.js';
-import { a as ZappieError, b as ZappieConfig, T as Transport, S as StorageLike, c as StoreResource, M as MenuResource, d as ZappieEvents, C as Cache } from '../client-Bm2cCYea.js';
+import { a as Menu, F as Formatters, S as Store } from '../models-D__QbqEd.js';
+import { a as ZappieError, b as ZappieConfig, T as Transport, S as StorageLike, c as StoreResource, M as MenuResource, d as ZappieEvents, C as Cache } from '../client-iVMHfAFn.js';
 export { VERSION } from '../index.js';
-import { d as CartModule, b as CartLineInput } from '../types-CuDvfW9g.js';
+import { d as CartModule, b as CartLineInput } from '../types-B-iTMrVV.js';
 
 /**
  * A URL string, URL object or Request you can parse as a storefront route.
@@ -28,7 +28,7 @@ declare const STOREFRONT_V1_QUERY_PARAMETERS: readonly ["ref", "utm_source", "pa
 /**
  * Recognized storefront query keys, including the v1 keys and checkout return and session keys.
  */
-declare const STOREFRONT_QUERY_PARAMETERS: readonly ["ref", "utm_source", "payment_id", "context", "prefetch", "business_tag", "pay_point_id", "dine_in_order_id", "no_context", "payment_context_id", "ws", "preview", "device", "auto_scroll", "pickup", "branch_closed", "order_id", "modal_id", "lightbox", "menu_id", "payment_method", "beacon_id", "menu_group_id", "category_id", "menu_layout", "can_schedule", "refresh", "success", "grant", "portal", "can_download_receipt", "auth_modal_id", "experimental_otp", "branch", "business", "env", "switched_branch", "from", "template", "catalog_rendering", "catalogue_search", "catalogue_categories", "return", "session"];
+declare const STOREFRONT_QUERY_PARAMETERS: readonly ["ref", "utm_source", "payment_id", "context", "prefetch", "business_tag", "pay_point_id", "dine_in_order_id", "no_context", "payment_context_id", "ws", "preview", "device", "auto_scroll", "pickup", "branch_closed", "order_id", "modal_id", "lightbox", "menu_id", "payment_method", "beacon_id", "menu_group_id", "category_id", "menu_layout", "can_schedule", "refresh", "success", "grant", "portal", "can_download_receipt", "auth_modal_id", "experimental_otp", "branch", "business", "env", "switched_branch", "from", "template", "catalog_rendering", "catalogue_search", "catalogue_categories", "menu", "return", "session"];
 /**
  * Readonly query parameter names and string values carried by storefront page state.
  */
@@ -155,6 +155,9 @@ declare const parseStorefrontUrl: (input: StorefrontUrlInput, options?: Storefro
  * Find the canonical v2 URL for a recognized storefront route.
  * Compares normalized paths and sorted query parameters to avoid unnecessary redirects.
  *
+ * Callers choose the HTTP status when serving the redirect.
+ * Zappie templates use temporary redirects (302) for now.
+ *
  * @returns A redirect target, or null for v1, an unknown route, a parse/build failure or an equivalent URL.
  */
 declare const storefrontRedirect: (input: StorefrontUrlInput, options?: StorefrontUrlOptions) => string | null;

package/dist/server/storefront-url/build-v1.js

@@ -21,20 +21,12 @@ var routePathV1 = (route, options = {}) => {
       return `/order/${encode(route.business)}${route.branch ? `/${encode(route.branch)}` : ""}/pages/${encode(route.slug)}`;
     case "dine-in":
       return `/dine-in/${encode(route.order)}`;
-    case "dine-in-menus":
-      return "/dine-in/menus";
-    case "self-service-menus":
-      return "/self-service/menus";
     case "pay-point":
       return `/pay-point/${encode(route.payPoint)}`;
     case "beacon":
       return `/beacons/${encode(route.beacon)}`;
     case "link":
       return `/links/${encode(route.link)}`;
-    case "collect-payment":
-      return "/collect-payment";
-    case "reservation":
-      return "/reservation";
     case "pay-session":
       return `/pay/${encode(route.session)}`;
     case "payment-step":
@@ -47,6 +39,13 @@ var routePathV1 = (route, options = {}) => {
       return route.home ? "/" : "/explore";
     case "unknown":
       return route.pathname || "/";
+    case "dine-in-menus":
+      return "/dine-in/menus";
+    case "self-service-menus":
+      return "/self-service/menus";
+    case "collect-payment":
+    case "reservation":
+      return `/${route.type}`;
   }
 };
 var buildV1 = (route, options = {}) => {
@@ -58,15 +57,7 @@ var buildV1 = (route, options = {}) => {
     options.installation
   );
   const query = v1Params(route).toString();
-  const value = `${pathname}${query ? `?${query}` : ""}`;
-  if (!options.origin) {
-    return value;
-  }
-  try {
-    return new URL(value, options.origin).toString();
-  } catch {
-    return value;
-  }
+  return `${pathname}${query ? `?${query}` : ""}`;
 };
 export {
   buildV1,

package/dist/server/storefront-url/build-v1.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/server/storefront-url/build-v1.ts"],
-  "sourcesContent": ["import { menuRoute } from \"./contract\";\nimport { publicInstallationPath } from \"./installation\";\nimport { v1Params } from \"./params\";\nimport { type StorefrontRoute, type StorefrontUrlOptions } from \"./types\";\nimport { encode } from \"./url\";\n\nexport const routePathV1 = (\n  route: StorefrontRoute,\n  options: StorefrontUrlOptions = {},\n): string => {\n  switch (route.type) {\n    case \"order-menu\":\n      return `/order/${encode(route.business)}${route.branch ? `/${encode(route.branch)}` : \"\"}${route.cataloguePath ? \"/products\" : \"\"}`;\n    case \"item\": {\n      const branch = route.branch ?? options.installation?.defaultBranch;\n      return branch\n        ? `/order/${encode(route.business)}/${encode(branch)}/products/${encode(route.item)}`\n        : `/order/${encode(route.business)}`;\n    }\n    case \"cart\":\n    case \"checkout\":\n    case \"checkout-return\":\n    case \"sign-in\":\n      return routePathV1(menuRoute(route), options);\n    case \"content-page\":\n      return `/order/${encode(route.business)}${route.branch ? `/${encode(route.branch)}` : \"\"}/pages/${encode(route.slug)}`;\n    case \"dine-in\":\n      return `/dine-in/${encode(route.order)}`;\n    case \"dine-in-menus\":\n      return \"/dine-in/menus\";\n    case \"self-service-menus\":\n      return \"/self-service/menus\";\n    case \"pay-point\":\n      return `/pay-point/${encode(route.payPoint)}`;\n    case \"beacon\":\n      return `/beacons/${encode(route.beacon)}`;\n    case \"link\":\n      return `/links/${encode(route.link)}`;\n    case \"collect-payment\":\n      return \"/collect-payment\";\n    case \"reservation\":\n      return \"/reservation\";\n    case \"pay-session\":\n      return `/pay/${encode(route.session)}`;\n    case \"payment-step\":\n      return `/payment/${encode(route.payment)}${route.step === \"payment\" ? \"\" : `/${route.step}`}`;\n    case \"payment-card\":\n      return `/payment/card/${encode(route.transaction)}`;\n    case \"profile\":\n      return `/profile/${route.page}${route.order ? `/${encode(route.order)}` : \"\"}`;\n    case \"explore\":\n      return route.home ? \"/\" : \"/explore\";\n    case \"unknown\":\n      return route.pathname || \"/\";\n  }\n};\n\nexport const buildV1 = (\n  route: StorefrontRoute,\n  options: StorefrontUrlOptions = {},\n) => {\n  const internal = routePathV1(route, options);\n  const publicRoute =\n    route.type === \"item\" &&\n    route.branch === undefined &&\n    options.installation?.defaultBranch\n      ? { ...route, branch: options.installation.defaultBranch }\n      : route;\n  const pathname = publicInstallationPath(\n    internal,\n    publicRoute,\n    options.installation,\n  );\n  const query = v1Params(route).toString();\n  const value = `${pathname}${query ? `?${query}` : \"\"}`;\n  if (!options.origin) {\n    return value;\n  }\n  try {\n    return new URL(value, options.origin).toString();\n  } catch {\n    return value;\n  }\n};\n"],
-  "mappings": ";AAAA,SAAS,iBAAiB;AAC1B,SAAS,8BAA8B;AACvC,SAAS,gBAAgB;AACzB,OAAgE;AAChE,SAAS,cAAc;AAEhB,IAAM,cAAc,CACzB,OACA,UAAgC,CAAC,MACtB;AACX,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,QAAQ,CAAC,GAAG,MAAM,SAAS,IAAI,OAAO,MAAM,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,gBAAgB,cAAc,EAAE;AAAA,IACnI,KAAK,QAAQ;AACX,YAAM,SAAS,MAAM,UAAU,QAAQ,cAAc;AACrD,aAAO,SACH,UAAU,OAAO,MAAM,QAAQ,CAAC,IAAI,OAAO,MAAM,CAAC,aAAa,OAAO,MAAM,IAAI,CAAC,KACjF,UAAU,OAAO,MAAM,QAAQ,CAAC;AAAA,IACtC;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,YAAY,UAAU,KAAK,GAAG,OAAO;AAAA,IAC9C,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,QAAQ,CAAC,GAAG,MAAM,SAAS,IAAI,OAAO,MAAM,MAAM,CAAC,KAAK,EAAE,UAAU,OAAO,MAAM,IAAI,CAAC;AAAA,IACtH,KAAK;AACH,aAAO,YAAY,OAAO,MAAM,KAAK,CAAC;AAAA,IACxC,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,cAAc,OAAO,MAAM,QAAQ,CAAC;AAAA,IAC7C,KAAK;AACH,aAAO,YAAY,OAAO,MAAM,MAAM,CAAC;AAAA,IACzC,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,IAAI,CAAC;AAAA,IACrC,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,QAAQ,OAAO,MAAM,OAAO,CAAC;AAAA,IACtC,KAAK;AACH,aAAO,YAAY,OAAO,MAAM,OAAO,CAAC,GAAG,MAAM,SAAS,YAAY,KAAK,IAAI,MAAM,IAAI,EAAE;AAAA,IAC7F,KAAK;AACH,aAAO,iBAAiB,OAAO,MAAM,WAAW,CAAC;AAAA,IACnD,KAAK;AACH,aAAO,YAAY,MAAM,IAAI,GAAG,MAAM,QAAQ,IAAI,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE;AAAA,IAC9E,KAAK;AACH,aAAO,MAAM,OAAO,MAAM;AAAA,IAC5B,KAAK;AACH,aAAO,MAAM,YAAY;AAAA,EAC7B;AACF;AAEO,IAAM,UAAU,CACrB,OACA,UAAgC,CAAC,MAC9B;AACH,QAAM,WAAW,YAAY,OAAO,OAAO;AAC3C,QAAM,cACJ,MAAM,SAAS,UACf,MAAM,WAAW,UACjB,QAAQ,cAAc,gBAClB,EAAE,GAAG,OAAO,QAAQ,QAAQ,aAAa,cAAc,IACvD;AACN,QAAM,WAAW;AAAA,IACf;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,EACV;AACA,QAAM,QAAQ,SAAS,KAAK,EAAE,SAAS;AACvC,QAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAAI,KAAK,KAAK,EAAE;AACpD,MAAI,CAAC,QAAQ,QAAQ;AACnB,WAAO;AAAA,EACT;AACA,MAAI;AACF,WAAO,IAAI,IAAI,OAAO,QAAQ,MAAM,EAAE,SAAS;AAAA,EACjD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
+  "sourcesContent": ["import { menuRoute } from \"./contract\";\nimport { publicInstallationPath } from \"./installation\";\nimport { v1Params } from \"./params\";\nimport { type StorefrontRoute, type StorefrontUrlOptions } from \"./types\";\nimport { encode } from \"./url\";\n\nexport const routePathV1 = (\n  route: StorefrontRoute,\n  options: StorefrontUrlOptions = {},\n): string => {\n  switch (route.type) {\n    case \"order-menu\":\n      return `/order/${encode(route.business)}${route.branch ? `/${encode(route.branch)}` : \"\"}${route.cataloguePath ? \"/products\" : \"\"}`;\n    case \"item\": {\n      const branch = route.branch ?? options.installation?.defaultBranch;\n      return branch\n        ? `/order/${encode(route.business)}/${encode(branch)}/products/${encode(route.item)}`\n        : `/order/${encode(route.business)}`;\n    }\n    case \"cart\":\n    case \"checkout\":\n    case \"checkout-return\":\n    case \"sign-in\":\n      return routePathV1(menuRoute(route), options);\n    case \"content-page\":\n      return `/order/${encode(route.business)}${route.branch ? `/${encode(route.branch)}` : \"\"}/pages/${encode(route.slug)}`;\n    case \"dine-in\":\n      return `/dine-in/${encode(route.order)}`;\n    case \"pay-point\":\n      return `/pay-point/${encode(route.payPoint)}`;\n    case \"beacon\":\n      return `/beacons/${encode(route.beacon)}`;\n    case \"link\":\n      return `/links/${encode(route.link)}`;\n    case \"pay-session\":\n      return `/pay/${encode(route.session)}`;\n    case \"payment-step\":\n      return `/payment/${encode(route.payment)}${route.step === \"payment\" ? \"\" : `/${route.step}`}`;\n    case \"payment-card\":\n      return `/payment/card/${encode(route.transaction)}`;\n    case \"profile\":\n      return `/profile/${route.page}${route.order ? `/${encode(route.order)}` : \"\"}`;\n    case \"explore\":\n      return route.home ? \"/\" : \"/explore\";\n    case \"unknown\":\n      return route.pathname || \"/\";\n    case \"dine-in-menus\":\n      return \"/dine-in/menus\";\n    case \"self-service-menus\":\n      return \"/self-service/menus\";\n    case \"collect-payment\":\n    case \"reservation\":\n      return `/${route.type}`;\n  }\n};\n\nexport const buildV1 = (\n  route: StorefrontRoute,\n  options: StorefrontUrlOptions = {},\n) => {\n  const internal = routePathV1(route, options);\n  const publicRoute =\n    route.type === \"item\" &&\n    route.branch === undefined &&\n    options.installation?.defaultBranch\n      ? { ...route, branch: options.installation.defaultBranch }\n      : route;\n  const pathname = publicInstallationPath(\n    internal,\n    publicRoute,\n    options.installation,\n  );\n  const query = v1Params(route).toString();\n  return `${pathname}${query ? `?${query}` : \"\"}`;\n};\n"],
+  "mappings": ";AAAA,SAAS,iBAAiB;AAC1B,SAAS,8BAA8B;AACvC,SAAS,gBAAgB;AACzB,OAAgE;AAChE,SAAS,cAAc;AAEhB,IAAM,cAAc,CACzB,OACA,UAAgC,CAAC,MACtB;AACX,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,QAAQ,CAAC,GAAG,MAAM,SAAS,IAAI,OAAO,MAAM,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,gBAAgB,cAAc,EAAE;AAAA,IACnI,KAAK,QAAQ;AACX,YAAM,SAAS,MAAM,UAAU,QAAQ,cAAc;AACrD,aAAO,SACH,UAAU,OAAO,MAAM,QAAQ,CAAC,IAAI,OAAO,MAAM,CAAC,aAAa,OAAO,MAAM,IAAI,CAAC,KACjF,UAAU,OAAO,MAAM,QAAQ,CAAC;AAAA,IACtC;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,YAAY,UAAU,KAAK,GAAG,OAAO;AAAA,IAC9C,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,QAAQ,CAAC,GAAG,MAAM,SAAS,IAAI,OAAO,MAAM,MAAM,CAAC,KAAK,EAAE,UAAU,OAAO,MAAM,IAAI,CAAC;AAAA,IACtH,KAAK;AACH,aAAO,YAAY,OAAO,MAAM,KAAK,CAAC;AAAA,IACxC,KAAK;AACH,aAAO,cAAc,OAAO,MAAM,QAAQ,CAAC;AAAA,IAC7C,KAAK;AACH,aAAO,YAAY,OAAO,MAAM,MAAM,CAAC;AAAA,IACzC,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,IAAI,CAAC;AAAA,IACrC,KAAK;AACH,aAAO,QAAQ,OAAO,MAAM,OAAO,CAAC;AAAA,IACtC,KAAK;AACH,aAAO,YAAY,OAAO,MAAM,OAAO,CAAC,GAAG,MAAM,SAAS,YAAY,KAAK,IAAI,MAAM,IAAI,EAAE;AAAA,IAC7F,KAAK;AACH,aAAO,iBAAiB,OAAO,MAAM,WAAW,CAAC;AAAA,IACnD,KAAK;AACH,aAAO,YAAY,MAAM,IAAI,GAAG,MAAM,QAAQ,IAAI,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE;AAAA,IAC9E,KAAK;AACH,aAAO,MAAM,OAAO,MAAM;AAAA,IAC5B,KAAK;AACH,aAAO,MAAM,YAAY;AAAA,IAC3B,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO,IAAI,MAAM,IAAI;AAAA,EACzB;AACF;AAEO,IAAM,UAAU,CACrB,OACA,UAAgC,CAAC,MAC9B;AACH,QAAM,WAAW,YAAY,OAAO,OAAO;AAC3C,QAAM,cACJ,MAAM,SAAS,UACf,MAAM,WAAW,UACjB,QAAQ,cAAc,gBAClB,EAAE,GAAG,OAAO,QAAQ,QAAQ,aAAa,cAAc,IACvD;AACN,QAAM,WAAW;AAAA,IACf;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,EACV;AACA,QAAM,QAAQ,SAAS,KAAK,EAAE,SAAS;AACvC,SAAO,GAAG,QAAQ,GAAG,QAAQ,IAAI,KAAK,KAAK,EAAE;AAC/C;",
   "names": []
 }

package/dist/server/storefront-url/build-v2.js

@@ -1,39 +1,12 @@
 // src/server/storefront-url/build-v2.ts
-import { routePathV1 } from "./build-v1.js";
-import { CART_MODAL, CHECKOUT_MODAL, SIGN_IN_MODALS } from "./contract.js";
+import { buildV1 } from "./build-v1.js";
+import { canonicalRoute } from "./canonical.js";
 import { v2Params } from "./params.js";
-import { signInFromOverlay } from "./sign-in.js";
-import { encode, ITEM_MODAL_PREFIX } from "./url.js";
-var canonicalRoute = (route, installation) => {
-  if (route.type !== "order-menu") {
-    return route;
-  }
-  const common = {
-    business: route.business,
-    ...route.branch !== void 0 ? { branch: route.branch } : {},
-    state: route.state
-  };
-  if (route.state.authModalId && SIGN_IN_MODALS.has(route.state.authModalId)) {
-    return signInFromOverlay(route, installation);
-  }
-  if (route.state.modalId?.startsWith(ITEM_MODAL_PREFIX)) {
-    return {
-      type: "item",
-      ...common,
-      item: route.state.modalId.slice(ITEM_MODAL_PREFIX.length)
-    };
-  }
-  if (route.state.modalId === CART_MODAL) {
-    return { type: "cart", ...common };
-  }
-  if (route.state.modalId === CHECKOUT_MODAL) {
-    return { type: "checkout", ...common };
-  }
-  return route;
-};
+import { categoryHash, publicId } from "./public-id.js";
+import { encode } from "./url.js";
 var profilePath = (route) => {
   if (route.page === "orders") {
-    return `/orders${route.order ? `/${encode(route.order)}` : ""}`;
+    return `/orders${route.order ? `/${encode(publicId(route.order, "ord"))}` : ""}`;
   }
   if (route.page === "edit") {
     return "/account";
@@ -41,12 +14,12 @@ var profilePath = (route) => {
   const page = route.page === "add-store-credit" ? "store-credit" : route.page;
   return `/account/${page}`;
 };
-var routePathV2 = (route, options) => {
+var routePathV2 = (route) => {
   switch (route.type) {
     case "order-menu":
       return "/";
     case "item":
-      return `/item/${encode(route.item)}`;
+      return `/item/${encode(publicId(route.item, "item"))}`;
     case "cart":
       return "/cart";
     case "checkout":
@@ -59,19 +32,18 @@ var routePathV2 = (route, options) => {
       return `/pages/${encode(route.slug)}`;
     case "profile":
       return profilePath(route);
-    default:
-      return routePathV1(route, options);
   }
 };
 var buildV2 = (route, options) => {
   const installation = options.installation;
-  if (!installation) {
-    return "";
-  }
   const canonical = canonicalRoute(route, installation);
-  const pathname = routePathV2(canonical, options);
+  if (!("business" in canonical) && canonical.type !== "profile") {
+    return buildV1(canonical, options);
+  }
+  const pathname = routePathV2(canonical);
   const query = v2Params(canonical, installation).toString();
-  return `${pathname}${query ? `?${query}` : ""}`;
+  const hash = categoryHash(canonical.state.categoryId);
+  return `${pathname}${query ? `?${query}` : ""}${hash}`;
 };
 export {
   buildV2

package/dist/server/storefront-url/build-v2.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/server/storefront-url/build-v2.ts"],
-  "sourcesContent": ["import { routePathV1 } from \"./build-v1\";\nimport { CART_MODAL, CHECKOUT_MODAL, SIGN_IN_MODALS } from \"./contract\";\nimport { v2Params } from \"./params\";\nimport { signInFromOverlay } from \"./sign-in\";\nimport type {\n  StorefrontInstallation,\n  StorefrontRoute,\n  StorefrontUrlOptions,\n} from \"./types\";\nimport { encode, ITEM_MODAL_PREFIX } from \"./url\";\n\nconst canonicalRoute = (\n  route: StorefrontRoute,\n  installation: StorefrontInstallation,\n): StorefrontRoute => {\n  if (route.type !== \"order-menu\") {\n    return route;\n  }\n  const common = {\n    business: route.business,\n    ...(route.branch !== undefined ? { branch: route.branch } : {}),\n    state: route.state,\n  };\n  if (route.state.authModalId && SIGN_IN_MODALS.has(route.state.authModalId)) {\n    return signInFromOverlay(route, installation);\n  }\n  if (route.state.modalId?.startsWith(ITEM_MODAL_PREFIX)) {\n    return {\n      type: \"item\",\n      ...common,\n      item: route.state.modalId.slice(ITEM_MODAL_PREFIX.length),\n    };\n  }\n  if (route.state.modalId === CART_MODAL) {\n    return { type: \"cart\", ...common };\n  }\n  if (route.state.modalId === CHECKOUT_MODAL) {\n    return { type: \"checkout\", ...common };\n  }\n  return route;\n};\n\nconst profilePath = (route: Extract<StorefrontRoute, { type: \"profile\" }>) => {\n  if (route.page === \"orders\") {\n    return `/orders${route.order ? `/${encode(route.order)}` : \"\"}`;\n  }\n  if (route.page === \"edit\") {\n    return \"/account\";\n  }\n  const page = route.page === \"add-store-credit\" ? \"store-credit\" : route.page;\n  return `/account/${page}`;\n};\n\nconst routePathV2 = (route: StorefrontRoute, options: StorefrontUrlOptions) => {\n  switch (route.type) {\n    case \"order-menu\":\n      return \"/\";\n    case \"item\":\n      return `/item/${encode(route.item)}`;\n    case \"cart\":\n      return \"/cart\";\n    case \"checkout\":\n      return \"/checkout\";\n    case \"checkout-return\":\n      return \"/checkout/return\";\n    case \"sign-in\":\n      return \"/sign-in\";\n    case \"content-page\":\n      return `/pages/${encode(route.slug)}`;\n    case \"profile\":\n      return profilePath(route);\n    default:\n      return routePathV1(route, options);\n  }\n};\n\nexport const buildV2 = (\n  route: StorefrontRoute,\n  options: StorefrontUrlOptions,\n) => {\n  const installation = options.installation;\n  if (!installation) {\n    return \"\";\n  }\n  const canonical = canonicalRoute(route, installation);\n  const pathname = routePathV2(canonical, options);\n  const query = v2Params(canonical, installation).toString();\n  return `${pathname}${query ? `?${query}` : \"\"}`;\n};\n"],
-  "mappings": ";AAAA,SAAS,mBAAmB;AAC5B,SAAS,YAAY,gBAAgB,sBAAsB;AAC3D,SAAS,gBAAgB;AACzB,SAAS,yBAAyB;AAMlC,SAAS,QAAQ,yBAAyB;AAE1C,IAAM,iBAAiB,CACrB,OACA,iBACoB;AACpB,MAAI,MAAM,SAAS,cAAc;AAC/B,WAAO;AAAA,EACT;AACA,QAAM,SAAS;AAAA,IACb,UAAU,MAAM;AAAA,IAChB,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,IAC7D,OAAO,MAAM;AAAA,EACf;AACA,MAAI,MAAM,MAAM,eAAe,eAAe,IAAI,MAAM,MAAM,WAAW,GAAG;AAC1E,WAAO,kBAAkB,OAAO,YAAY;AAAA,EAC9C;AACA,MAAI,MAAM,MAAM,SAAS,WAAW,iBAAiB,GAAG;AACtD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,GAAG;AAAA,MACH,MAAM,MAAM,MAAM,QAAQ,MAAM,kBAAkB,MAAM;AAAA,IAC1D;AAAA,EACF;AACA,MAAI,MAAM,MAAM,YAAY,YAAY;AACtC,WAAO,EAAE,MAAM,QAAQ,GAAG,OAAO;AAAA,EACnC;AACA,MAAI,MAAM,MAAM,YAAY,gBAAgB;AAC1C,WAAO,EAAE,MAAM,YAAY,GAAG,OAAO;AAAA,EACvC;AACA,SAAO;AACT;AAEA,IAAM,cAAc,CAAC,UAAyD;AAC5E,MAAI,MAAM,SAAS,UAAU;AAC3B,WAAO,UAAU,MAAM,QAAQ,IAAI,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE;AAAA,EAC/D;AACA,MAAI,MAAM,SAAS,QAAQ;AACzB,WAAO;AAAA,EACT;AACA,QAAM,OAAO,MAAM,SAAS,qBAAqB,iBAAiB,MAAM;AACxE,SAAO,YAAY,IAAI;AACzB;AAEA,IAAM,cAAc,CAAC,OAAwB,YAAkC;AAC7E,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,SAAS,OAAO,MAAM,IAAI,CAAC;AAAA,IACpC,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,IAAI,CAAC;AAAA,IACrC,KAAK;AACH,aAAO,YAAY,KAAK;AAAA,IAC1B;AACE,aAAO,YAAY,OAAO,OAAO;AAAA,EACrC;AACF;AAEO,IAAM,UAAU,CACrB,OACA,YACG;AACH,QAAM,eAAe,QAAQ;AAC7B,MAAI,CAAC,cAAc;AACjB,WAAO;AAAA,EACT;AACA,QAAM,YAAY,eAAe,OAAO,YAAY;AACpD,QAAM,WAAW,YAAY,WAAW,OAAO;AAC/C,QAAM,QAAQ,SAAS,WAAW,YAAY,EAAE,SAAS;AACzD,SAAO,GAAG,QAAQ,GAAG,QAAQ,IAAI,KAAK,KAAK,EAAE;AAC/C;",
+  "sourcesContent": ["import { buildV1 } from \"./build-v1\";\nimport { canonicalRoute } from \"./canonical\";\nimport { v2Params } from \"./params\";\nimport { categoryHash, publicId } from \"./public-id\";\nimport type {\n  StorefrontInstallation,\n  StorefrontRoute,\n  StorefrontUrlOptions,\n} from \"./types\";\nimport { encode } from \"./url\";\n\nconst profilePath = (route: Extract<StorefrontRoute, { type: \"profile\" }>) => {\n  if (route.page === \"orders\") {\n    return `/orders${route.order ? `/${encode(publicId(route.order, \"ord\"))}` : \"\"}`;\n  }\n  if (route.page === \"edit\") {\n    return \"/account\";\n  }\n  const page = route.page === \"add-store-credit\" ? \"store-credit\" : route.page;\n  return `/account/${page}`;\n};\n\nconst routePathV2 = (\n  route: Extract<StorefrontRoute, { business: string } | { type: \"profile\" }>,\n) => {\n  switch (route.type) {\n    case \"order-menu\":\n      return \"/\";\n    case \"item\":\n      return `/item/${encode(publicId(route.item, \"item\"))}`;\n    case \"cart\":\n      return \"/cart\";\n    case \"checkout\":\n      return \"/checkout\";\n    case \"checkout-return\":\n      return \"/checkout/return\";\n    case \"sign-in\":\n      return \"/sign-in\";\n    case \"content-page\":\n      return `/pages/${encode(route.slug)}`;\n    case \"profile\":\n      return profilePath(route);\n  }\n};\n\nexport const buildV2 = (\n  route: StorefrontRoute,\n  options: StorefrontUrlOptions & { installation: StorefrontInstallation },\n) => {\n  const installation = options.installation;\n  const canonical = canonicalRoute(route, installation);\n  if (!(\"business\" in canonical) && canonical.type !== \"profile\") {\n    return buildV1(canonical, options);\n  }\n  const pathname = routePathV2(canonical);\n  const query = v2Params(canonical, installation).toString();\n  const hash = categoryHash(canonical.state.categoryId);\n  return `${pathname}${query ? `?${query}` : \"\"}${hash}`;\n};\n"],
+  "mappings": ";AAAA,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAC/B,SAAS,gBAAgB;AACzB,SAAS,cAAc,gBAAgB;AAMvC,SAAS,cAAc;AAEvB,IAAM,cAAc,CAAC,UAAyD;AAC5E,MAAI,MAAM,SAAS,UAAU;AAC3B,WAAO,UAAU,MAAM,QAAQ,IAAI,OAAO,SAAS,MAAM,OAAO,KAAK,CAAC,CAAC,KAAK,EAAE;AAAA,EAChF;AACA,MAAI,MAAM,SAAS,QAAQ;AACzB,WAAO;AAAA,EACT;AACA,QAAM,OAAO,MAAM,SAAS,qBAAqB,iBAAiB,MAAM;AACxE,SAAO,YAAY,IAAI;AACzB;AAEA,IAAM,cAAc,CAClB,UACG;AACH,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,SAAS,OAAO,SAAS,MAAM,MAAM,MAAM,CAAC,CAAC;AAAA,IACtD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,UAAU,OAAO,MAAM,IAAI,CAAC;AAAA,IACrC,KAAK;AACH,aAAO,YAAY,KAAK;AAAA,EAC5B;AACF;AAEO,IAAM,UAAU,CACrB,OACA,YACG;AACH,QAAM,eAAe,QAAQ;AAC7B,QAAM,YAAY,eAAe,OAAO,YAAY;AACpD,MAAI,EAAE,cAAc,cAAc,UAAU,SAAS,WAAW;AAC9D,WAAO,QAAQ,WAAW,OAAO;AAAA,EACnC;AACA,QAAM,WAAW,YAAY,SAAS;AACtC,QAAM,QAAQ,SAAS,WAAW,YAAY,EAAE,SAAS;AACzD,QAAM,OAAO,aAAa,UAAU,MAAM,UAAU;AACpD,SAAO,GAAG,QAAQ,GAAG,QAAQ,IAAI,KAAK,KAAK,EAAE,GAAG,IAAI;AACtD;",
   "names": []
 }

package/dist/server/storefront-url/canonical.js

@@ -0,0 +1,36 @@
+// src/server/storefront-url/canonical.ts
+import { CART_MODAL, CHECKOUT_MODAL, SIGN_IN_MODALS } from "./contract.js";
+import { signInFromOverlay } from "./sign-in.js";
+import { ITEM_MODAL_PREFIX } from "./url.js";
+var canonicalRoute = (route, installation) => {
+  if (route.type !== "order-menu") {
+    return route;
+  }
+  const { authModalId, modalId } = route.state;
+  if (authModalId && SIGN_IN_MODALS.includes(authModalId)) {
+    return signInFromOverlay(route, installation);
+  }
+  const common = {
+    business: route.business,
+    ...route.branch !== void 0 ? { branch: route.branch } : {},
+    state: route.state
+  };
+  if (modalId?.startsWith(ITEM_MODAL_PREFIX)) {
+    return {
+      type: "item",
+      ...common,
+      item: modalId.slice(ITEM_MODAL_PREFIX.length)
+    };
+  }
+  if (modalId === CART_MODAL || modalId === CHECKOUT_MODAL) {
+    return {
+      type: modalId === CART_MODAL ? "cart" : "checkout",
+      ...common
+    };
+  }
+  return route;
+};
+export {
+  canonicalRoute
+};
+//# sourceMappingURL=canonical.js.map

package/dist/server/storefront-url/canonical.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/server/storefront-url/canonical.ts"],
+  "sourcesContent": ["import { CART_MODAL, CHECKOUT_MODAL, SIGN_IN_MODALS } from \"./contract\";\nimport { signInFromOverlay } from \"./sign-in\";\nimport type { StorefrontRoute, StorefrontUrlOptions } from \"./types\";\nimport { ITEM_MODAL_PREFIX } from \"./url\";\n\nexport const canonicalRoute = (\n  route: StorefrontRoute,\n  installation: NonNullable<StorefrontUrlOptions[\"installation\"]>,\n): StorefrontRoute => {\n  if (route.type !== \"order-menu\") {\n    return route;\n  }\n  const { authModalId, modalId } = route.state;\n  if (authModalId && SIGN_IN_MODALS.includes(authModalId)) {\n    return signInFromOverlay(route, installation);\n  }\n  const common = {\n    business: route.business,\n    ...(route.branch !== undefined ? { branch: route.branch } : {}),\n    state: route.state,\n  };\n  if (modalId?.startsWith(ITEM_MODAL_PREFIX)) {\n    return {\n      type: \"item\",\n      ...common,\n      item: modalId.slice(ITEM_MODAL_PREFIX.length),\n    };\n  }\n  if (modalId === CART_MODAL || modalId === CHECKOUT_MODAL) {\n    return {\n      type: modalId === CART_MODAL ? \"cart\" : \"checkout\",\n      ...common,\n    };\n  }\n  return route;\n};\n"],
+  "mappings": ";AAAA,SAAS,YAAY,gBAAgB,sBAAsB;AAC3D,SAAS,yBAAyB;AAElC,SAAS,yBAAyB;AAE3B,IAAM,iBAAiB,CAC5B,OACA,iBACoB;AACpB,MAAI,MAAM,SAAS,cAAc;AAC/B,WAAO;AAAA,EACT;AACA,QAAM,EAAE,aAAa,QAAQ,IAAI,MAAM;AACvC,MAAI,eAAe,eAAe,SAAS,WAAW,GAAG;AACvD,WAAO,kBAAkB,OAAO,YAAY;AAAA,EAC9C;AACA,QAAM,SAAS;AAAA,IACb,UAAU,MAAM;AAAA,IAChB,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,IAC7D,OAAO,MAAM;AAAA,EACf;AACA,MAAI,SAAS,WAAW,iBAAiB,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,GAAG;AAAA,MACH,MAAM,QAAQ,MAAM,kBAAkB,MAAM;AAAA,IAC9C;AAAA,EACF;AACA,MAAI,YAAY,cAAc,YAAY,gBAAgB;AACxD,WAAO;AAAA,MACL,MAAM,YAAY,aAAa,SAAS;AAAA,MACxC,GAAG;AAAA,IACL;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/server/storefront-url/contract.js

@@ -2,11 +2,11 @@
 var CART_MODAL = "review-menu";
 var CHECKOUT_MODAL = "payment";
 var SIGN_IN_MODAL = "send-otp";
-var SIGN_IN_MODALS = /* @__PURE__ */ new Set([
+var SIGN_IN_MODALS = [
   SIGN_IN_MODAL,
   "verify-otp",
   "update-profile"
-]);
+];
 var usesV2 = (options) => options.contract !== "v1" && options.installation !== void 0;
 var menuRoute = (route) => ({
   type: "order-menu",

package/dist/server/storefront-url/contract.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/server/storefront-url/contract.ts"],
-  "sourcesContent": ["import type { StorefrontRoute, StorefrontUrlOptions } from \"./types\";\n\nexport const CART_MODAL = \"review-menu\";\nexport const CHECKOUT_MODAL = \"payment\";\nexport const SIGN_IN_MODAL = \"send-otp\";\nexport const SIGN_IN_MODALS = new Set([\n  SIGN_IN_MODAL,\n  \"verify-otp\",\n  \"update-profile\",\n]);\n\nexport const usesV2 = (options: StorefrontUrlOptions) =>\n  options.contract !== \"v1\" && options.installation !== undefined;\n\nexport const menuRoute = (\n  route: Extract<\n    StorefrontRoute,\n    { type: \"cart\" | \"checkout\" | \"checkout-return\" | \"sign-in\" }\n  >,\n): Extract<StorefrontRoute, { type: \"order-menu\" }> => ({\n  type: \"order-menu\",\n  business: route.business,\n  ...(route.branch !== undefined ? { branch: route.branch } : {}),\n  state: route.state,\n});\n"],
-  "mappings": ";AAEO,IAAM,aAAa;AACnB,IAAM,iBAAiB;AACvB,IAAM,gBAAgB;AACtB,IAAM,iBAAiB,oBAAI,IAAI;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,SAAS,CAAC,YACrB,QAAQ,aAAa,QAAQ,QAAQ,iBAAiB;AAEjD,IAAM,YAAY,CACvB,WAIsD;AAAA,EACtD,MAAM;AAAA,EACN,UAAU,MAAM;AAAA,EAChB,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,EAC7D,OAAO,MAAM;AACf;",
+  "sourcesContent": ["import type {\n  StorefrontInstallation,\n  StorefrontRoute,\n  StorefrontUrlOptions,\n} from \"./types\";\n\nexport const CART_MODAL = \"review-menu\";\nexport const CHECKOUT_MODAL = \"payment\";\nexport const SIGN_IN_MODAL = \"send-otp\";\nexport const SIGN_IN_MODALS: readonly string[] = [\n  SIGN_IN_MODAL,\n  \"verify-otp\",\n  \"update-profile\",\n];\n\nexport const usesV2 = (\n  options: StorefrontUrlOptions,\n): options is StorefrontUrlOptions & { installation: StorefrontInstallation } =>\n  options.contract !== \"v1\" && options.installation !== undefined;\n\nexport const menuRoute = (\n  route: Extract<\n    StorefrontRoute,\n    { type: \"cart\" | \"checkout\" | \"checkout-return\" | \"sign-in\" }\n  >,\n): Extract<StorefrontRoute, { type: \"order-menu\" }> => ({\n  type: \"order-menu\",\n  business: route.business,\n  ...(route.branch !== undefined ? { branch: route.branch } : {}),\n  state: route.state,\n});\n"],
+  "mappings": ";AAMO,IAAM,aAAa;AACnB,IAAM,iBAAiB;AACvB,IAAM,gBAAgB;AACtB,IAAM,iBAAoC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,SAAS,CACpB,YAEA,QAAQ,aAAa,QAAQ,QAAQ,iBAAiB;AAEjD,IAAM,YAAY,CACvB,WAIsD;AAAA,EACtD,MAAM;AAAA,EACN,UAAU,MAAM;AAAA,EAChB,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,EAC7D,OAAO,MAAM;AACf;",
   "names": []
 }