@zappie/sdk 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @zappie/sdk
 
+## 0.1.8
+
+### Patch Changes
+
+- 4f3cdc3: Add `quote.feesTotal`, and `startingPrice(item)` and `showsFromPrice(item)` in the new `@zappie/sdk/pricing` entry point. Type the place route's `distance_meters` and new `duration_seconds` as optional, and pass both through.
+
+## 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,8 +56,9 @@ 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/pricing`                        | An item's starting price and whether to show it as "From"              |
 | `@zappie/sdk/server`                         | Server-side reads, storefront URLs and `verifyWebhook()`               |
 | `@zappie/sdk/template` and `/template/react` | Template settings and responsive images for template authors           |
 | `@zappie/sdk/testing`                        | A mock client for your tests                                           |
@@ -79,3 +80,48 @@ The SDK is at `0.x`. Its API can change in a minor release while it settles. Eac
 ## License
 
 MIT
+
+### Quote fees
+
+`quote.feesTotal` is the sum of `quote.fees`, so a template can print one
+"Fees" line without adding money itself. It leaves delivery out (that is
+`quote.delivery`) and is zero when there are no fees. Each quote line has
+`optionsTotal` when the API prices its options.
+
+### Starting price
+
+`startingPrice(item)` from `@zappie/sdk/pricing` returns the price an item starts from: the cheapest
+available variant plus the cheapest choice of each required add-on group. It is
+the rule Zappie uses for a product's starting price. When no variant is
+available, it uses the cheapest variant. `showsFromPrice(item)` says whether to
+show that price as "From": available variants differ in price, or a required
+add-on raises it. `item.price` is the branch price, not the starting price.
+
+The API sends one `available` flag per item and variant, and a free-text
+`stockLabel`. It doesn't say whether an item is sold out or unavailable for
+another reason, so `isAvailable` covers both.
+
+### Place routes
+
+`places.place(placeId, { branchId })` returns `route` with optional
+`distance_meters` and `duration_seconds`, as the API sends them.
+
+### 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-gQXU2gEA.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-DzUauU-b.js';
+import { I as Item } from '../models-D__QbqEd.js';
+import '../types-gQXU2gEA.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-response.js

@@ -103,6 +103,7 @@ function mapQuote(value, branchId) {
     return fail();
   }
   const deliveryCharges = charges.filter((c) => c.code === "delivery");
+  const fees = charges.filter((c) => c.code !== "delivery");
   const integer = (value2) => {
     if (!Number.isSafeInteger(value2) || Number(value2) < 0) {
       return fail();
@@ -151,7 +152,11 @@ function mapQuote(value, branchId) {
     ...v.lines_unpriced === true ? { linesUnpriced: true } : {},
     subtotal,
     total,
-    fees: charges.filter((c) => c.code !== "delivery"),
+    fees,
+    feesTotal: sumMoney(
+      fees.map((c) => c.amount),
+      money(0, subtotal.currency)
+    ),
     discounts,
     ...deliveryCharges.length ? {
       delivery: sumMoney(

package/dist/cart/quote-response.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/cart/quote-response.ts"],
-  "sourcesContent": ["// Quote responses load lazily with the quote client, outside the synchronous core.\nimport { ZappieError } from \"../errors\";\nimport { sumMoney } from \"../internal/money-math\";\nimport { money } from \"../money\";\nimport { mapMoney, record } from \"../transport/mappers\";\nimport type { CartFix, CartFulfilment, CartIssue, Quote } from \"./types\";\nfunction fail(): never {\n  throw new ZappieError(\"server_error\", \"Invalid quote response\");\n}\nfunction text(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return fail();\n  }\n  return value;\n}\nfunction list(value: unknown): unknown[] {\n  if (!Array.isArray(value)) {\n    return fail();\n  }\n  return value;\n}\n/** A fix newer than this SDK is dropped (undefined); a malformed known fix still fails. */\nfunction fix(value: unknown): CartFix | undefined {\n  const v = record(value);\n  switch (v.action) {\n    case \"remove_line\":\n    case \"accept_price\":\n    case \"remove_promo\":\n    case \"change_address\":\n    case \"choose_region\":\n      return { action: v.action };\n    case \"choose_option\":\n    case \"choose_other_option\":\n      return { action: v.action, groupId: text(v.group_id) };\n    case \"set_quantity\": {\n      if (\n        !Number.isInteger(v.quantity) ||\n        Number(v.quantity) < 1 ||\n        Number(v.quantity) > 99\n      ) {\n        return fail();\n      }\n      return { action: v.action, quantity: v.quantity as number };\n    }\n    case \"schedule\":\n      return {\n        action: v.action,\n        ...(v.next_open_at ? { nextOpenAt: text(v.next_open_at) } : {}),\n        ...(v.slots ? { slots: list(v.slots).map(text) } : {}),\n      };\n    case \"switch_fulfilment\": {\n      const types = list(v.types)\n        .map(text)\n        .filter((t) => [\"pickup\", \"delivery\", \"dine_in\"].includes(t));\n      return types.length\n        ? { action: v.action, types: types as CartFulfilment[\"type\"][] }\n        : undefined;\n    }\n    default:\n      return undefined;\n  }\n}\nconst codes = [\n  \"item_unavailable\",\n  \"item_not_found\",\n  \"option_unavailable\",\n  \"option_required\",\n  \"option_limit\",\n  \"quantity_limit\",\n  \"price_changed\",\n  \"branch_closed\",\n  \"fulfilment_unavailable\",\n  \"outside_delivery_zone\",\n  \"delivery_region_required\",\n  \"schedule_invalid\",\n  \"promo_invalid\",\n  \"promo_min_spend\",\n  \"min_order\",\n  \"menu_version_stale\",\n];\nexport function mapQuote(value: unknown, branchId: string): Quote {\n  const v = record(value);\n  if (\n    v.branch_id !== branchId ||\n    !Number.isFinite(Date.parse(text(v.expires_at)))\n  ) {\n    return fail();\n  }\n  const subtotal = mapMoney(v.subtotal);\n  const checkout = record(v.checkout);\n  if (\n    typeof v.can_checkout !== \"boolean\" ||\n    typeof checkout.ready !== \"boolean\" ||\n    (checkout.reason !== undefined &&\n      checkout.reason !== \"issues\" &&\n      checkout.reason !== \"customer_required\")\n  ) {\n    return fail();\n  }\n  const amount = (raw: unknown) => {\n    const result = mapMoney(raw);\n    if (result.currency !== subtotal.currency) {\n      return fail();\n    }\n    return result;\n  };\n  const charge = (raw: unknown) => {\n    const c = record(raw);\n    return {\n      code: text(c.code),\n      label: text(c.label),\n      amount: amount(c.amount),\n    };\n  };\n  const charges = list(v.charges).map(charge);\n  const discounts = list(v.discounts).map(charge);\n  const total = amount(v.total);\n  if (\n    sumMoney(\n      [...charges, ...discounts].map((c) => c.amount),\n      subtotal,\n    ).amountMinor !== total.amountMinor\n  ) {\n    return fail();\n  }\n  const deliveryCharges = charges.filter((c) => c.code === \"delivery\");\n  const integer = (value: unknown) => {\n    if (!Number.isSafeInteger(value) || Number(value) < 0) {\n      return fail();\n    }\n    return value as number;\n  };\n  const fulfilment =\n    v.fulfilment === undefined ? undefined : record(v.fulfilment);\n  if (\n    v.menu_version_stale !== undefined &&\n    typeof v.menu_version_stale !== \"boolean\"\n  ) {\n    return fail();\n  }\n  const lines = list(v.lines).map((raw) => {\n    const l = record(raw);\n    if (\n      (l.unit_price == null || l.line_total == null) &&\n      v.lines_unpriced !== true\n    ) {\n      return fail();\n    }\n    return {\n      ...(l.item_id !== undefined ? { itemId: text(l.item_id) } : {}),\n      ...(l.name !== undefined ? { name: text(l.name) } : {}),\n      ...(l.quantity !== undefined ? { quantity: integer(l.quantity) } : {}),\n      ...(l.status !== undefined ? { status: text(l.status) } : {}),\n      ...(l.options_total !== undefined\n        ? {\n            optionsTotal:\n              l.options_total === null ? null : amount(l.options_total),\n          }\n        : {}),\n      lineId: text(l.line_id),\n      unitPrice: l.unit_price == null ? null : amount(l.unit_price),\n      total: l.line_total == null ? null : amount(l.line_total),\n    };\n  });\n  if (\n    v.lines_unpriced !== true &&\n    sumMoney(\n      lines.map((line) => line.total!),\n      money(0, subtotal.currency),\n    ).amountMinor !== subtotal.amountMinor\n  ) {\n    return fail();\n  }\n  return {\n    ...(v.menu_version_stale !== undefined\n      ? { menuVersionStale: v.menu_version_stale as boolean }\n      : {}),\n    ...(fulfilment\n      ? {\n          fulfilment: {\n            type: text(fulfilment.type),\n            scheduledFor:\n              fulfilment.scheduled_for === null\n                ? null\n                : text(fulfilment.scheduled_for),\n            ...(fulfilment.eta_minutes !== undefined\n              ? { etaMinutes: list(fulfilment.eta_minutes).map(integer) }\n              : {}),\n            ...(fulfilment.delivery_region_id !== undefined\n              ? { deliveryRegionId: text(fulfilment.delivery_region_id) }\n              : {}),\n          },\n        }\n      : {}),\n    lines,\n    ...(v.lines_unpriced === true ? { linesUnpriced: true } : {}),\n    subtotal,\n    total,\n    fees: charges.filter((c) => c.code !== \"delivery\"),\n    discounts,\n    ...(deliveryCharges.length\n      ? {\n          delivery: sumMoney(\n            deliveryCharges.map((c) => c.amount),\n            money(0, subtotal.currency),\n          ),\n        }\n      : {}),\n    menuVersion: text(v.menu_version),\n    expiresAt: text(v.expires_at),\n    issues: list(v.issues).flatMap((raw): CartIssue[] => {\n      const i = record(raw);\n      const code = text(i.code);\n      const severity = text(i.severity);\n      const known =\n        codes.includes(code) &&\n        [\"blocking\", \"warning\", \"info\"].includes(severity);\n      const fixes = list(i.fixes)\n        .map(fix)\n        .filter((f): f is CartFix => f !== undefined);\n      const lineId = i.line_id ? text(i.line_id) : undefined;\n      if (!known && (severity === \"warning\" || severity === \"info\")) {\n        console.warn(\n          `Zappie quote issue \"${code}\" is newer than this SDK and was skipped`,\n        );\n        return [];\n      }\n      // A blocking (or unknown-severity) issue newer than the SDK keeps checkout blocked.\n      return [\n        {\n          code: known ? (code as CartIssue[\"code\"]) : \"item_unavailable\",\n          severity: known ? (severity as CartIssue[\"severity\"]) : \"blocking\",\n          message: text(i.message),\n          source: \"quote\",\n          ...(lineId ? { lineId } : {}),\n          ...(i.group_id ? { groupId: text(i.group_id) } : {}),\n          ...(i.data || !known\n            ? {\n                data: {\n                  ...(i.data ? record(i.data) : {}),\n                  ...(known ? {} : { code }),\n                },\n              }\n            : {}),\n          fixes:\n            !known && !fixes.length && lineId\n              ? [{ action: \"remove_line\" }]\n              : fixes,\n        },\n      ];\n    }),\n    canCheckout: v.can_checkout,\n    checkout: {\n      ready: checkout.ready,\n      ...(checkout.reason !== undefined ? { reason: checkout.reason } : {}),\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["// Quote responses load lazily with the quote client, outside the synchronous core.\nimport { ZappieError } from \"../errors\";\nimport { sumMoney } from \"../internal/money-math\";\nimport { money } from \"../money\";\nimport { mapMoney, record } from \"../transport/mappers\";\nimport type { CartFix, CartFulfilment, CartIssue, Quote } from \"./types\";\nfunction fail(): never {\n  throw new ZappieError(\"server_error\", \"Invalid quote response\");\n}\nfunction text(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return fail();\n  }\n  return value;\n}\nfunction list(value: unknown): unknown[] {\n  if (!Array.isArray(value)) {\n    return fail();\n  }\n  return value;\n}\n/** A fix newer than this SDK is dropped (undefined); a malformed known fix still fails. */\nfunction fix(value: unknown): CartFix | undefined {\n  const v = record(value);\n  switch (v.action) {\n    case \"remove_line\":\n    case \"accept_price\":\n    case \"remove_promo\":\n    case \"change_address\":\n    case \"choose_region\":\n      return { action: v.action };\n    case \"choose_option\":\n    case \"choose_other_option\":\n      return { action: v.action, groupId: text(v.group_id) };\n    case \"set_quantity\": {\n      if (\n        !Number.isInteger(v.quantity) ||\n        Number(v.quantity) < 1 ||\n        Number(v.quantity) > 99\n      ) {\n        return fail();\n      }\n      return { action: v.action, quantity: v.quantity as number };\n    }\n    case \"schedule\":\n      return {\n        action: v.action,\n        ...(v.next_open_at ? { nextOpenAt: text(v.next_open_at) } : {}),\n        ...(v.slots ? { slots: list(v.slots).map(text) } : {}),\n      };\n    case \"switch_fulfilment\": {\n      const types = list(v.types)\n        .map(text)\n        .filter((t) => [\"pickup\", \"delivery\", \"dine_in\"].includes(t));\n      return types.length\n        ? { action: v.action, types: types as CartFulfilment[\"type\"][] }\n        : undefined;\n    }\n    default:\n      return undefined;\n  }\n}\nconst codes = [\n  \"item_unavailable\",\n  \"item_not_found\",\n  \"option_unavailable\",\n  \"option_required\",\n  \"option_limit\",\n  \"quantity_limit\",\n  \"price_changed\",\n  \"branch_closed\",\n  \"fulfilment_unavailable\",\n  \"outside_delivery_zone\",\n  \"delivery_region_required\",\n  \"schedule_invalid\",\n  \"promo_invalid\",\n  \"promo_min_spend\",\n  \"min_order\",\n  \"menu_version_stale\",\n];\nexport function mapQuote(value: unknown, branchId: string): Quote {\n  const v = record(value);\n  if (\n    v.branch_id !== branchId ||\n    !Number.isFinite(Date.parse(text(v.expires_at)))\n  ) {\n    return fail();\n  }\n  const subtotal = mapMoney(v.subtotal);\n  const checkout = record(v.checkout);\n  if (\n    typeof v.can_checkout !== \"boolean\" ||\n    typeof checkout.ready !== \"boolean\" ||\n    (checkout.reason !== undefined &&\n      checkout.reason !== \"issues\" &&\n      checkout.reason !== \"customer_required\")\n  ) {\n    return fail();\n  }\n  const amount = (raw: unknown) => {\n    const result = mapMoney(raw);\n    if (result.currency !== subtotal.currency) {\n      return fail();\n    }\n    return result;\n  };\n  const charge = (raw: unknown) => {\n    const c = record(raw);\n    return {\n      code: text(c.code),\n      label: text(c.label),\n      amount: amount(c.amount),\n    };\n  };\n  const charges = list(v.charges).map(charge);\n  const discounts = list(v.discounts).map(charge);\n  const total = amount(v.total);\n  if (\n    sumMoney(\n      [...charges, ...discounts].map((c) => c.amount),\n      subtotal,\n    ).amountMinor !== total.amountMinor\n  ) {\n    return fail();\n  }\n  const deliveryCharges = charges.filter((c) => c.code === \"delivery\");\n  const fees = charges.filter((c) => c.code !== \"delivery\");\n  const integer = (value: unknown) => {\n    if (!Number.isSafeInteger(value) || Number(value) < 0) {\n      return fail();\n    }\n    return value as number;\n  };\n  const fulfilment =\n    v.fulfilment === undefined ? undefined : record(v.fulfilment);\n  if (\n    v.menu_version_stale !== undefined &&\n    typeof v.menu_version_stale !== \"boolean\"\n  ) {\n    return fail();\n  }\n  const lines = list(v.lines).map((raw) => {\n    const l = record(raw);\n    if (\n      (l.unit_price == null || l.line_total == null) &&\n      v.lines_unpriced !== true\n    ) {\n      return fail();\n    }\n    return {\n      ...(l.item_id !== undefined ? { itemId: text(l.item_id) } : {}),\n      ...(l.name !== undefined ? { name: text(l.name) } : {}),\n      ...(l.quantity !== undefined ? { quantity: integer(l.quantity) } : {}),\n      ...(l.status !== undefined ? { status: text(l.status) } : {}),\n      ...(l.options_total !== undefined\n        ? {\n            optionsTotal:\n              l.options_total === null ? null : amount(l.options_total),\n          }\n        : {}),\n      lineId: text(l.line_id),\n      unitPrice: l.unit_price == null ? null : amount(l.unit_price),\n      total: l.line_total == null ? null : amount(l.line_total),\n    };\n  });\n  if (\n    v.lines_unpriced !== true &&\n    sumMoney(\n      lines.map((line) => line.total!),\n      money(0, subtotal.currency),\n    ).amountMinor !== subtotal.amountMinor\n  ) {\n    return fail();\n  }\n  return {\n    ...(v.menu_version_stale !== undefined\n      ? { menuVersionStale: v.menu_version_stale as boolean }\n      : {}),\n    ...(fulfilment\n      ? {\n          fulfilment: {\n            type: text(fulfilment.type),\n            scheduledFor:\n              fulfilment.scheduled_for === null\n                ? null\n                : text(fulfilment.scheduled_for),\n            ...(fulfilment.eta_minutes !== undefined\n              ? { etaMinutes: list(fulfilment.eta_minutes).map(integer) }\n              : {}),\n            ...(fulfilment.delivery_region_id !== undefined\n              ? { deliveryRegionId: text(fulfilment.delivery_region_id) }\n              : {}),\n          },\n        }\n      : {}),\n    lines,\n    ...(v.lines_unpriced === true ? { linesUnpriced: true } : {}),\n    subtotal,\n    total,\n    fees,\n    feesTotal: sumMoney(\n      fees.map((c) => c.amount),\n      money(0, subtotal.currency),\n    ),\n    discounts,\n    ...(deliveryCharges.length\n      ? {\n          delivery: sumMoney(\n            deliveryCharges.map((c) => c.amount),\n            money(0, subtotal.currency),\n          ),\n        }\n      : {}),\n    menuVersion: text(v.menu_version),\n    expiresAt: text(v.expires_at),\n    issues: list(v.issues).flatMap((raw): CartIssue[] => {\n      const i = record(raw);\n      const code = text(i.code);\n      const severity = text(i.severity);\n      const known =\n        codes.includes(code) &&\n        [\"blocking\", \"warning\", \"info\"].includes(severity);\n      const fixes = list(i.fixes)\n        .map(fix)\n        .filter((f): f is CartFix => f !== undefined);\n      const lineId = i.line_id ? text(i.line_id) : undefined;\n      if (!known && (severity === \"warning\" || severity === \"info\")) {\n        console.warn(\n          `Zappie quote issue \"${code}\" is newer than this SDK and was skipped`,\n        );\n        return [];\n      }\n      // A blocking (or unknown-severity) issue newer than the SDK keeps checkout blocked.\n      return [\n        {\n          code: known ? (code as CartIssue[\"code\"]) : \"item_unavailable\",\n          severity: known ? (severity as CartIssue[\"severity\"]) : \"blocking\",\n          message: text(i.message),\n          source: \"quote\",\n          ...(lineId ? { lineId } : {}),\n          ...(i.group_id ? { groupId: text(i.group_id) } : {}),\n          ...(i.data || !known\n            ? {\n                data: {\n                  ...(i.data ? record(i.data) : {}),\n                  ...(known ? {} : { code }),\n                },\n              }\n            : {}),\n          fixes:\n            !known && !fixes.length && lineId\n              ? [{ action: \"remove_line\" }]\n              : fixes,\n        },\n      ];\n    }),\n    canCheckout: v.can_checkout,\n    checkout: {\n      ready: checkout.ready,\n      ...(checkout.reason !== undefined ? { reason: checkout.reason } : {}),\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": ["value"]
 }

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-DzUauU-b.js';
+import { Q as QuoteRequest, a as Quote } from '../types-gQXU2gEA.js';
+import '../models-D__QbqEd.js';
 
 type QuoteClientOptions = {
     customerBase?: string | undefined;

package/dist/{client-Bm2cCYea.d.ts → client-DzUauU-b.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-gQXU2gEA.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-gQXU2gEA.js';
+import { M as Money, a as Menu, B as Branch } from './models-D__QbqEd.js';
+import { Z as Zappie } from './client-DzUauU-b.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.8" : "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-DzUauU-b.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-DzUauU-b.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-gQXU2gEA.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-gQXU2gEA.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.8" : "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-DzUauU-b.js';
+import '../models-D__QbqEd.js';
+import '../types-gQXU2gEA.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-gQXU2gEA.js';
+export { v as validateConfig } from './client-DzUauU-b.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-DzUauU-b.js';
+import '../models-D__QbqEd.js';
+import '../types-gQXU2gEA.js';

package/dist/places/index.d.ts

@@ -9,7 +9,7 @@ type PlaceSuggestion = {
     secondary?: string;
 };
 /**
- * A resolved place with address text, coordinates and an optional route distance in metres.
+ * A resolved place with address text, coordinates and, when you pass a branch, the route from that branch.
  */
 type Place = {
     place_id: string;
@@ -18,8 +18,12 @@ type Place = {
     country?: string;
     lat: number;
     lng: number;
+    /** The route from the branch. Each field is absent when the API doesn't send it. */
     route?: {
-        distance_meters: number;
+        /** Road distance in metres. */
+        distance_meters?: number;
+        /** Travel time in seconds. */
+        duration_seconds?: number;
     };
 };
 /**

package/dist/pricing/index.d.ts

@@ -0,0 +1,116 @@
+declare const MoneyBrand: unique symbol;
+/** A normalized ISO 4217 currency code. */
+type Currency = string;
+/** A frozen amount in safe integer minor units. Create it with money(). */
+type Money = {
+    readonly amountMinor: number;
+    readonly currency: Currency;
+    readonly [MoneyBrand]: true;
+};
+
+/** An exact variant with its selected attributes, price and availability. */
+type Variant = {
+    /** A low-stock hint for shoppers. This does not give a stock balance. */
+    lowStock?: boolean;
+    id: string;
+    attributeChoices: Record<string, string>;
+    price: Money;
+    isAvailable: boolean;
+};
+/** Item details and choices, with at least one exact variant. */
+type Item = {
+    /** Fulfilment modes returned for this item. */
+    fulfilment?: string[];
+    /** Exact source placements returned by targeted item reads. */
+    placements?: {
+        menuId: string;
+        categoryId: string;
+    }[];
+    /** Stock text for display. Use isAvailable and the server quote to check eligibility. */
+    stockLabel?: string;
+    promo?: {
+        name: string;
+    };
+    id: string;
+    name: string;
+    description?: string;
+    images: string[];
+    price: Money;
+    compareAtPrice?: Money;
+    isAvailable: boolean;
+    quantity: {
+        min: number;
+        max?: number;
+        step: number;
+    };
+    variants: [Variant, ...Variant[]];
+    optionGroups: OptionGroup[];
+    tags: string[];
+};
+/** Conditions that change option rules when selected choices match. */
+type OptionCondition = {
+    groupId: string;
+    choiceIds: string[];
+    match: "any" | "all";
+    count?: {
+        op: "eq" | "gte" | "lte";
+        value: number;
+    };
+    setRequired?: boolean | null;
+    setMin?: number | null;
+    setMax?: number | null;
+};
+/** Addon or exact-variant attribute selection rules. */
+type OptionGroup = {
+    id: string;
+    name: string;
+    helpText?: string;
+    kind: "select" | "text" | "number" | "date" | "time" | "toggle";
+    required: boolean;
+    isAvailable?: boolean;
+    isInformational?: boolean;
+    selection: {
+        min: number;
+        max?: number;
+    };
+    isAttribute: boolean;
+    choices: Choice[];
+    input?: {
+        maxLength?: number;
+        placeholder?: string;
+    };
+    conditions?: OptionCondition[];
+};
+/** A selectable option. Attribute prices are zero to avoid charging twice. */
+type Choice = {
+    /** An attribute price adjustment for display. Cart calculations exclude it. */
+    priceHint?: Money;
+    id: string;
+    name: string;
+    price: Money;
+    isAvailable: boolean;
+    quantity?: {
+        min: number;
+        max?: number;
+    };
+};
+
+/**
+ * The lowest price a shopper can pay for one of this item, by the same rule
+ * Zappie uses for a product's starting price: the cheapest available variant
+ * plus the cheapest choice of each required add-on group. When no variant is
+ * available, the cheapest variant is used.
+ *
+ * @param item - The catalogue item.
+ * @returns A display price. Use a server quote for checkout totals.
+ */
+declare function startingPrice(item: Item): Money;
+/**
+ * Whether to show the starting price as "From": true when available variants
+ * have different prices, or a required add-on raises the starting price.
+ *
+ * @param item - The catalogue item.
+ */
+declare function showsFromPrice(item: Item): boolean;
+
+export { showsFromPrice, startingPrice };

package/dist/pricing/index.js

@@ -0,0 +1,30 @@
+// src/pricing/index.ts
+import { sumMoney } from "../internal/money-math.js";
+var cheapest = (prices) => prices.filter((price) => price.amountMinor >= 0).sort((a, b) => a.amountMinor - b.amountMinor)[0];
+function startingPrice(item) {
+  const available = item.variants.filter((variant) => variant.isAvailable);
+  const base = cheapest(
+    (available.length ? available : item.variants).map(
+      (variant) => variant.price
+    )
+  ) ?? item.price;
+  return sumMoney(
+    item.optionGroups.flatMap(
+      (group) => !group.isAttribute && group.required && group.kind === "select" ? cheapest(group.choices.map((choice) => choice.price)) ?? [] : []
+    ),
+    base
+  );
+}
+function showsFromPrice(item) {
+  const prices = [
+    ...new Set(
+      item.variants.filter((variant) => variant.isAvailable).map((variant) => variant.price.amountMinor)
+    )
+  ];
+  return prices.length > 1 || prices.length === 1 && startingPrice(item).amountMinor > prices[0];
+}
+export {
+  showsFromPrice,
+  startingPrice
+};
+//# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/pricing/index.ts"],
+  "sourcesContent": ["import { sumMoney } from \"../internal/money-math\";\nimport type { Item } from \"../models\";\nimport type { Money } from \"../money\";\n\nconst cheapest = (prices: Money[]): Money | undefined =>\n  prices\n    .filter((price) => price.amountMinor >= 0)\n    .sort((a, b) => a.amountMinor - b.amountMinor)[0];\n\n/**\n * The lowest price a shopper can pay for one of this item, by the same rule\n * Zappie uses for a product's starting price: the cheapest available variant\n * plus the cheapest choice of each required add-on group. When no variant is\n * available, the cheapest variant is used.\n *\n * @param item - The catalogue item.\n * @returns A display price. Use a server quote for checkout totals.\n */\nexport function startingPrice(item: Item): Money {\n  const available = item.variants.filter((variant) => variant.isAvailable);\n  const base =\n    cheapest(\n      (available.length ? available : item.variants).map(\n        (variant) => variant.price,\n      ),\n    ) ?? item.price;\n  return sumMoney(\n    item.optionGroups.flatMap((group) =>\n      !group.isAttribute && group.required && group.kind === \"select\"\n        ? (cheapest(group.choices.map((choice) => choice.price)) ?? [])\n        : [],\n    ),\n    base,\n  );\n}\n\n/**\n * Whether to show the starting price as \"From\": true when available variants\n * have different prices, or a required add-on raises the starting price.\n *\n * @param item - The catalogue item.\n */\nexport function showsFromPrice(item: Item): boolean {\n  const prices = [\n    ...new Set(\n      item.variants\n        .filter((variant) => variant.isAvailable)\n        .map((variant) => variant.price.amountMinor),\n    ),\n  ];\n  return (\n    prices.length > 1 ||\n    (prices.length === 1 && startingPrice(item).amountMinor > prices[0]!)\n  );\n}\n"],
+  "mappings": ";AAAA,SAAS,gBAAgB;AAIzB,IAAM,WAAW,CAAC,WAChB,OACG,OAAO,CAAC,UAAU,MAAM,eAAe,CAAC,EACxC,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAW7C,SAAS,cAAc,MAAmB;AAC/C,QAAM,YAAY,KAAK,SAAS,OAAO,CAAC,YAAY,QAAQ,WAAW;AACvE,QAAM,OACJ;AAAA,KACG,UAAU,SAAS,YAAY,KAAK,UAAU;AAAA,MAC7C,CAAC,YAAY,QAAQ;AAAA,IACvB;AAAA,EACF,KAAK,KAAK;AACZ,SAAO;AAAA,IACL,KAAK,aAAa;AAAA,MAAQ,CAAC,UACzB,CAAC,MAAM,eAAe,MAAM,YAAY,MAAM,SAAS,WAClD,SAAS,MAAM,QAAQ,IAAI,CAAC,WAAW,OAAO,KAAK,CAAC,KAAK,CAAC,IAC3D,CAAC;AAAA,IACP;AAAA,IACA;AAAA,EACF;AACF;AAQO,SAAS,eAAe,MAAqB;AAClD,QAAM,SAAS;AAAA,IACb,GAAG,IAAI;AAAA,MACL,KAAK,SACF,OAAO,CAAC,YAAY,QAAQ,WAAW,EACvC,IAAI,CAAC,YAAY,QAAQ,MAAM,WAAW;AAAA,IAC/C;AAAA,EACF;AACA,SACE,OAAO,SAAS,KACf,OAAO,WAAW,KAAK,cAAc,IAAI,EAAE,cAAc,OAAO,CAAC;AAEtE;",
+  "names": []
+}

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-DzUauU-b.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-gQXU2gEA.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-DzUauU-b.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-gQXU2gEA.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;