@wix/agent-skills 1.36.0 → 1.36.1

package/skills/wix-vibe-headless/references/restaurants/app/rest/wix-restaurants-ordering.js

@@ -1,218 +0,0 @@
-import { wixApiRequest } from "./wix-client.js";
-
-// Data model reference: see INSTRUCTIONS.md
-
-/**
- * Operation — online-ordering context (fulfillment + scheduling). Every cart line item must
- * reference an operationId. Pick the default / first enabled one for a simple flow.
- *   id {string}, name {string}, default {boolean},
- *   onlineOrderingStatus {string} — "ENABLED"|"DISABLED"|"PAUSED_UNTIL"|UNDEFINED,
- *   defaultFulfillmentType {string} — "PICKUP"|"DELIVERY",
- *   fulfillmentIds {string[]}, businessLocationId {string}
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/operations/operation-object.md
- *
- * Cart (Wix eCom V2) — restaurant orders use the same visitor cart as the storefront.
- *   id {string} — the cart id IS the checkout id,
- *   lineItems[].id {string} — lineItemId for update/remove (NOT the item id),
- *   lineItems[].quantityInfo.confirmedQuantity {number},
- *   lineItems[].source.catalogReference.catalogItemId {string} — the ordered item's GUID (NOT top-level in V2),
- *   lineItems[].name.original {string},
- *   lineItems[].pricing.unitPrice / lineItems[].pricing.totalPrice {ConvertedMoney} —
- *     { amount, convertedAmount } with NO formatted string; format the number client-side,
- *   lineItems[].status {string} — "IN_STOCK"|"PARTIALLY_IN_STOCK"|"OUT_OF_STOCK"|"REMOVED_FROM_CATALOG"
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/get-current-cart.md
- */
-
-// Wix Restaurants Orders app id — required in catalogReference when adding menu items to the eCom cart.
-const RESTAURANTS_ORDERS_APP_ID = "9a5d83fd-8570-482e-81ab-cfa88942ee60";
-
-/**
- * List the restaurant's online-ordering operations.
- * GET https://www.wixapis.com/restaurants-operations/v1/operations
- * @returns {Promise<object[]>}
- */
-export async function listOperations() {
-  const res = await wixApiRequest("/restaurants-operations/v1/operations", { method: "GET" });
-  return res?.operations ?? [];
-}
-
-/**
- * Pick the operation to order through — the default, else the first ENABLED, else the first.
- * Returns null when no operation is configured (show an "ordering unavailable" state).
- * @returns {Promise<object|null>}
- */
-export async function getDefaultOperation() {
-  const operations = await listOperations();
-  return (
-    operations.find((o) => o.default) ??
-    operations.find((o) => o.onlineOrderingStatus === "ENABLED") ??
-    operations[0] ??
-    null
-  );
-}
-
-/**
- * Add a restaurant menu item to the visitor's current eCom cart.
- *
- * Requires operationId (from listOperations/getDefaultOperation), menuId, and sectionId. The section
- * is sent as options.menuSectionId (what Restaurants' checkout validates the dish against — a line
- * without it is refused at checkout as "no longer available") and as sectionId.
- * Throws if any is missing, or if the added line is not AVAILABLE.
- *
- * Variant selection and modifier up-charges on the cart line are not covered here — the
- * restaurants catalogReference.options shape for those is not documented for client add-to-cart.
- * Confirm the shape before extending:
- * https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/sample-flows.md
- *
- * POST https://www.wixapis.com/ecom/v2/carts/current/add-line-items
- * @param {string} itemId  Menu item GUID (item.id).
- * @param {{ operationId: string, menuId: string, sectionId: string, onlineOrderingPageUrl?: string, quantity?: number }} opts
- * @returns {Promise<object>} Updated cart.
- */
-export async function addItemToCart(itemId, { operationId, menuId, sectionId, onlineOrderingPageUrl, quantity = 1 } = {}) {
-  if (!itemId) throw new Error("addItemToCart: itemId is required.");
-  if (!operationId || !menuId || !sectionId) {
-    throw new Error("addItemToCart: operationId, menuId and sectionId are all required for a restaurant line item.");
-  }
-  const options = { operationId, menuId, menuSectionId: sectionId, sectionId };
-  if (onlineOrderingPageUrl) options.onlineOrderingPageUrl = onlineOrderingPageUrl;
-
-  const res = await wixApiRequest("/ecom/v2/carts/current/add-line-items", {
-    method: "POST",
-    body: {
-      catalogItems: [{ catalogReference: { appId: RESTAURANTS_ORDERS_APP_ID, catalogItemId: itemId, options }, quantity }],
-    },
-  });
-  // V2 nests the reference under `source` — a top-level lineItem.catalogReference no longer exists.
-  const line = (res?.cart?.lineItems ?? []).find((l) => l.source?.catalogReference?.catalogItemId === itemId);
-  if (line?.status && line.status !== "IN_STOCK") {
-    throw new Error(`Item not available to order (status: ${line.status}).`);
-  }
-  return res?.cart;
-}
-
-/** Read the visitor's current cart. Returns null if no cart exists yet. */
-export async function getCurrentCart() {
-  try {
-    const res = await wixApiRequest("/ecom/v2/carts/current", { method: "GET" });
-    return res?.cart ?? null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Update the quantity of a cart line. lineItemId is cart.lineItems[].id, not the item id.
- * POST https://www.wixapis.com/ecom/v2/carts/current/update-line-items
- * @returns {Promise<object>} Updated cart.
- */
-export async function updateCartItemQuantity(lineItemId, quantity) {
-  const res = await wixApiRequest("/ecom/v2/carts/current/update-line-items", {
-    method: "POST",
-    body: { lineItems: [{ lineItemId, quantity: { newQuantity: quantity } }] },
-  });
-  return res?.cart;
-}
-
-/**
- * Remove a line from the current cart by its cart.lineItems[].id.
- * POST https://www.wixapis.com/ecom/v2/carts/current/remove-line-items
- * @returns {Promise<object>} Updated cart.
- */
-export async function removeFromCart(lineItemId) {
-  const res = await wixApiRequest("/ecom/v2/carts/current/remove-line-items", {
-    method: "POST",
-    body: { lineItemIds: [lineItemId] },
-  });
-  return res?.cart;
-}
-
-/**
- * The restaurant's country and subdivision ("US-CA") from its pickup address (or a delivery
- * area's center). The cart needs a country before any delivery method is accepted, pickup
- * included (DELIVERY_METHOD_MISSING_ADDRESS); Wix pre-fills one only from the visitor's location.
- * GET https://www.wixapis.com/fulfillment-methods/v1/fulfillment-methods
- */
-async function restaurantRegion() {
-  const res = await wixApiRequest("/fulfillment-methods/v1/fulfillment-methods", { method: "GET" });
-  for (const m of res?.fulfillmentMethods ?? []) {
-    if (!m.enabled) continue;
-    const a = m.pickupOptions?.address ?? m.deliveryOptions?.deliveryArea?.radiusOptions?.centerPointAddress;
-    if (!a?.country) continue;
-    const sub = a.subdivision ?? "";
-    return { country: a.country, subdivision: sub && !sub.includes("-") ? `${a.country}-${sub}` : sub };
-  }
-  return { country: "", subdivision: "" };
-}
-
-/**
- * Set how and when the order is fulfilled — the cart's delivery method. The hosted checkout has no
- * pickup/delivery or time picker for restaurant orders and refuses the order without one.
- *   code: "PICKUP|ASAP" · "DELIVERY|ASAP" · "<TYPE>|<startEpochMs>|<endEpochMs>" for a scheduled slot
- *         (slots: GET /restaurants-operations/v1/operations/{operationId}/available-time-slots-per-date
- *          ?date.day=&date.month=&date.year= → timeslotsPerFulfillmentType[].timeSlot.startTime/endTime;
- *          only orderable slots come back. For delivery add the address as deliveryAddress.addressLine /
- *          .city / .postalCode / .country / .subdivision: delivery slots are then only those of methods
- *          that deliver there).
- *   address: for delivery, { addressLine, city, postalCode?, country?, subdivision? } — the street goes in
- *          addressLine (addressLine1 is dropped); country/subdivision default to the restaurant's.
- * Throws "We don't deliver to this address…" when a delivery address is outside every delivery area.
- * PATCH https://www.wixapis.com/ecom/v2/carts/current  { cart: { deliveryInfo: { address } } }
- * POST  https://www.wixapis.com/ecom/v2/carts/current/set-delivery-method  { deliveryMethod: { code } }
- * @returns {Promise<object>} Updated cart.
- */
-export async function setOrderFulfillment(code, address) {
-  const region = await restaurantRegion();
-  const isDelivery = code.startsWith("DELIVERY|");
-  if (isDelivery && (!address?.addressLine?.trim() || !address?.city?.trim())) {
-    throw new Error("Enter a delivery address: street and city.");
-  }
-  const country = (isDelivery && address?.country) || region.country;
-  if (!country) throw new Error("The restaurant's country is unknown: set a pickup address in Restaurants settings.");
-  const subdivision = (isDelivery && address?.subdivision) || (country === region.country ? region.subdivision : "");
-  const cartAddress = isDelivery ? { ...address, country, ...(subdivision ? { subdivision } : {}) } : { country, ...(subdivision ? { subdivision } : {}) };
-  await wixApiRequest("/ecom/v2/carts/current", { method: "PATCH", body: { cart: { deliveryInfo: { address: cartAddress } } } });
-  try {
-    const res = await wixApiRequest("/ecom/v2/carts/current/set-delivery-method", { method: "POST", body: { deliveryMethod: { code } } });
-    return res?.cart;
-  } catch (e) {
-    if (e?.body?.details?.applicationError?.code === "DELIVERY_METHOD_NOT_FOUND") {
-      throw new Error(isDelivery ? "We don't deliver to this address. Choose pickup or another address." : "This pickup time isn't available. Choose another time.");
-    }
-    throw e;
-  }
-}
-
-/**
- * Start the hosted checkout for the current cart and return the Wix-hosted checkout URL.
- * In Cart V2 the cart id IS the checkout id — there is no separate checkout-creation call; the
- * redirect session is created straight from the current cart's id. The fulfillment must be on the
- * cart first (setOrderFulfillment); a cart with none gets pickup ASAP.
- * Throws on empty cart, unavailable lines, or a missing redirect URL.
- * Redirect with: window.location.href = await checkout()
- * @returns {Promise<string>}
- */
-export async function checkout() {
-  const cart = await getCurrentCart();
-  const lines = cart?.lineItems ?? [];
-  if (!lines.length) throw new Error("Cannot check out: the cart is empty.");
-  const unavailable = lines.filter((l) => l.status && l.status !== "IN_STOCK");
-  if (unavailable.length) {
-    const names = unavailable.map((l) => l.name?.original ?? l.source?.catalogReference?.catalogItemId).join(", ");
-    throw new Error(`Cannot check out: ${unavailable.length} item(s) not available — ${names}.`);
-  }
-  if (!cart.id) throw new Error("Failed to check out: the current cart has no id.");
-  if (!cart.deliveryInfo?.method?.code) {
-    await setOrderFulfillment("PICKUP|ASAP").catch(() => {
-      throw new Error("Choose pickup or delivery before checkout.");
-    });
-  }
-
-  const redirect = await wixApiRequest("/headless/v1/redirect-session", {
-    method: "POST",
-    body: { ecomCheckout: { checkoutId: cart.id }, callbacks: { postFlowUrl: window.location.href } },
-  });
-  const url = redirect?.redirectSession?.fullUrl;
-  if (!url) throw new Error("Failed to create the checkout redirect session.");
-  return url;
-}

package/skills/wix-vibe-headless/references/restaurants/app/rest/wix-restaurants-reservations.js

@@ -1,107 +0,0 @@
-import { wixApiRequest } from "./wix-client.js";
-
-// Data model reference: see INSTRUCTIONS.md
-
-/**
- * ReservationLocation — a restaurant location that accepts table reservations.
- *   id {string}, default {boolean}, archived {boolean},
- *   location {object} — physical location details,
- *   configuration {object}:
- *     onlineReservations.approval.mode — "AUTOMATIC"|"MANUAL"|"MANUAL_FOR_LARGE_PARTIES"
- *     partySize.min / partySize.max — guest count limits
- *     timeSlotInterval — minutes between slots
- *     reservationForm: { lastNameRequired, emailRequired, customFieldDefinitions }
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservation-locations/reservation-location-object.md
- *
- * TimeSlot (from getTimeSlots):
- *   { startDate, duration, status, manualApproval }
- *   status: "AVAILABLE" | "UNAVAILABLE" | "NON_WORKING_HOURS" — offer only AVAILABLE slots.
- *
- * Reservation (from createHeldReservation / reserveReservation):
- *   { id, revision, status, details: { reservationLocationId, startDate, endDate, partySize }, reservee, paymentStatus }
- *   status: "HELD" → "RESERVED" (auto-approved) or "REQUESTED" (manual approval required) after reserve.
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservations/reservation-object.md
- */
-
-/**
- * List the site's reservation locations (up to 100).
- * GET https://www.wixapis.com/table-reservations/reservation-locations/v1/reservation-locations
- * @returns {Promise<object[]>}
- */
-export async function listReservationLocations() {
-  const res = await wixApiRequest(
-    "/table-reservations/reservation-locations/v1/reservation-locations",
-    { method: "GET" },
-  );
-  return res?.reservationLocations ?? [];
-}
-
-/**
- * Get reservation time slots for a location on a date, filtered to AVAILABLE only.
- * Use slotsBefore / slotsAfter to fan out around the chosen date.
- * POST https://www.wixapis.com/table-reservations/reservations/v1/time-slots
- * https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/time-slots/get-time-slots.md
- * @param {string} reservationLocationId
- * @param {string} date       ISO-8601 datetime e.g. "2026-07-01T19:00:00.000Z"
- * @param {number} partySize
- * @param {{ slotsBefore?: number, slotsAfter?: number, duration?: number }} [options]
- * @returns {Promise<{ timeSlots: object[], availableTimeSlots: object[] }>}
- */
-export async function getTimeSlots(reservationLocationId, date, partySize, { slotsBefore = 4, slotsAfter = 4, duration } = {}) {
-  if (!reservationLocationId || !date || !partySize) {
-    throw new Error("getTimeSlots: reservationLocationId, date and partySize are required.");
-  }
-  const res = await wixApiRequest("/table-reservations/reservations/v1/time-slots", {
-    method: "POST",
-    body: { reservationLocationId, date, partySize, slotsBefore, slotsAfter, ...(duration ? { duration } : {}) },
-  });
-  const timeSlots = res?.timeSlots ?? [];
-  return { timeSlots, availableTimeSlots: timeSlots.filter((s) => s.status === "AVAILABLE") };
-}
-
-/**
- * Hold a reservation for 10 minutes while the visitor fills in their details.
- * Returns a reservation with status "HELD" — keep its id and revision for reserveReservation.
- * POST https://www.wixapis.com/table-reservations/reservations/v1/reservations/hold
- * @param {string} reservationLocationId
- * @param {string} startDate  ISO-8601 datetime of the chosen time slot.
- * @param {number} partySize
- * @returns {Promise<object>} The held reservation ({ id, revision, status: "HELD", ... }).
- */
-export async function createHeldReservation(reservationLocationId, startDate, partySize) {
-  if (!reservationLocationId || !startDate || !partySize) {
-    throw new Error("createHeldReservation: reservationLocationId, startDate and partySize are required.");
-  }
-  const res = await wixApiRequest("/table-reservations/reservations/v1/reservations/hold", {
-    method: "POST",
-    body: { reservationDetails: { reservationLocationId, startDate, partySize } },
-  });
-  const reservation = res?.reservation;
-  if (!reservation?.id) throw new Error("Failed to hold the reservation (the slot may no longer be available).");
-  return reservation;
-}
-
-/**
- * Confirm a held reservation with the visitor's details. Moves status from "HELD" to
- * "RESERVED" (auto-approval) or "REQUESTED" (manual approval required).
- * reservee.firstName and reservee.phone (E.164, e.g. "+15551234567") are REQUIRED.
- * Pass the revision returned by createHeldReservation. Holds expire after 10 minutes.
- * POST https://www.wixapis.com/table-reservations/reservations/v1/reservations/{id}/reserve
- * @param {string} reservationId
- * @param {string} revision
- * @param {{ firstName: string, phone: string, lastName?: string, email?: string, marketingConsent?: boolean }} reservee
- * @returns {Promise<object>} The updated reservation.
- */
-export async function reserveReservation(reservationId, revision, reservee) {
-  if (!reservationId || !revision) throw new Error("reserveReservation: reservationId and revision are required.");
-  if (!reservee?.firstName || !reservee?.phone) {
-    throw new Error("reserveReservation: reservee.firstName and reservee.phone are required.");
-  }
-  const res = await wixApiRequest(
-    `/table-reservations/reservations/v1/reservations/${encodeURIComponent(reservationId)}/reserve`,
-    { method: "POST", body: { revision, reservee } },
-  );
-  const reservation = res?.reservation;
-  if (!reservation?.id) throw new Error("Failed to confirm the reservation (the hold may have expired — start over).");
-  return reservation;
-}

package/skills/wix-vibe-headless/references/restaurants/seed/SEED.md

@@ -1,176 +0,0 @@
-# Restaurants — seeding
-
-Seed a Wix Restaurants site by **calling `seed-restaurants.cjs`** — don't hand-write the REST calls.
-It's a build-time module (run via `exec_tool`, not shipped in the app) that abstracts every seed
-operation across the vertical's four recipes: the **menu** (always) plus three on-demand add-ons —
-**online ordering**, **table reservations**, and **experiences**. `require` it and call the functions
-with plain data.
-
-> **NOT yet live-verified — transcribed from `setup-restaurants.md`, `setup-restaurant-orders.md`,
-> `setup-restaurant-reservations.md`, `setup-restaurant-experiences.md`.**
-
-## Default: one call
-
-`setupRestaurants(ctx, plan)` does the whole seed in one call — installs the Menus app and builds the
-menu **bottom-up (items → sections → menu)** with ids kept in memory, so you never hand-thread ids
-across exec calls. Online ordering and table reservations run only when the plan asks for them.
-
-```js
-// build-time exec_tool
-const { accessToken } = await base44.asServiceRole.connectors.getConnection("wix");
-const seed = require(require("path").resolve(".agents/skills/wix-vibe-headless/references/restaurants/seed/seed-restaurants.cjs"));
-const ctx = { token: accessToken, siteId: WIX_METASITE_ID };
-
-const result = await seed.setupRestaurants(ctx, {
-  menu: {
-    name: "Dinner", description: "Evening menu",
-    sections: [
-      { name: "Antipasti", description: "To start", items: [
-        // imageUrl per item is optional and attached IN this one call. It must be the FINAL
-        // https://media.base44.com/... url from the COMPLETED generate_image (it runs in the background
-        // while you build — wait for it), never a still-generating /__generating__/<id>.png placeholder.
-        { name: "Bruschetta al Pomodoro", description: "Grilled sourdough, San Marzano tomatoes, basil.", price: 9.50, imageUrl: "https://media.base44.com/…" },
-      ] },
-    ],
-  },
-  ordering: { address },                            // omit for menu-only; `true` skips the STEP 0 address (flag it)
-  reservations: { configuration: { onlineReservations: { partySize: { min: 2, max: 10 } } } },
-});
-// → { menuId, sectionIds, itemIds, orderingEnabled, reservationsEnabled, imagesAttached }
-```
-
-**Seeding is additive — never delete or overwrite existing content.** Don't clean up, don't remove
-"sample" data, don't reset. Just add.
-
-## Escape hatch — individual functions
-Reach for the functions below only when the one-call `setupRestaurants` doesn't fit (partial re-seed,
-custom fulfillment methods, experiences). `setupRestaurants` is built from them, in this order
-(items → sections → menu — each child before its parent):
-
-```js
-// ── MENU (always; the seedable core) ────────────────────────────────────────────────────────────
-await seed.installMenusApp(ctx);                    // if the site doesn't have Wix Restaurants Menus yet
-
-const menu = await seed.createMenu(ctx, {           // builds items → sections → menu bottom-up
-  name: "Dinner", description: "Evening menu",
-  sections: [
-    { name: "Antipasti", description: "To start", items: [
-      { name: "Bruschetta al Pomodoro", description: "Grilled sourdough, San Marzano tomatoes, basil.", price: 9.50 },
-    ] },
-  ],
-});                                                 // → { menuId, sectionIds, itemIds }
-
-// optional — import the url to Wix Media (restaurants binds by file id), then attach (full-replace — echo revision + price)
-// const file = await seed.importImage(ctx, imageUrl);   // → { id, url } (Wix Media file id + wixstatic url)
-// await seed.attachItemImages(ctx, [{ id, revision, price, image: { id: file.id, url: file.url, height: 1024, width: 1024 } }]);
-
-// ── ONLINE ORDERING (add-on, on demand; MENU-FIRST) ──────────────────────────────────────────────
-await seed.installOrdersApp(ctx);                   // auto-provisions a working ordering setup
-await seed.setBusinessLocation(ctx, address);       // STEP 0 — REQUIRED (see preconditions)
-const [op] = await seed.listOperations(ctx);        // verify the auto-created operation (never create one)
-// if (op.onlineOrderingStatus !== "ENABLED") await seed.enableOperation(ctx, op.id, op.revision);
-const methods = await seed.listFulfillmentMethods(ctx);      // reshape ONLY what the request names
-// await seed.updateFulfillmentMethod(ctx, methods[0].id, { revision: methods[0].revision, name: "Delivery", fee: "5" });
-const settings = await seed.queryMenuOrderingSettings(ctx);  // confirm each menu is onlineOrderingEnabled
-
-// ── TABLE RESERVATIONS (add-on, on demand; INDEPENDENT of menu/ordering) ─────────────────────────
-await seed.installTableReservationsApp(ctx);        // auto-provisions a default reservation location
-await seed.setBusinessLocation(ctx, address);       // STEP 0 — shared with ordering (do it once if both)
-const [loc] = await seed.listReservationLocations(ctx);      // discover the default (never create one)
-// await seed.updateReservationLocation(ctx, loc.id, loc.revision, { onlineReservations: { partySize: { min: 2, max: 10 } } });
-await seed.enableOnlineReservations(ctx, loc.id, loc.revision);  // PREMIUM-GATED — 428 on a free site (record, don't fail)
-
-// ── EXPERIENCES (add-on WITHIN Table Reservations, on demand) ────────────────────────────────────
-await seed.createExperiences(ctx, loc.id, [{ configuration: { /* per Create-Experience doc */ } }]);
-```
-
-## Functions
-
-**Menu** (`setup-restaurants.md`)
-| fn | does |
-|---|---|
-| `installMenusApp(ctx)` | install the Wix Restaurants Menus app |
-| `createMenu(ctx, {name,description?,sections})` | items → sections → menu bottom-up → `{menuId,sectionIds,itemIds}` |
-| `importImage(ctx, url)` | import an external url into Wix Media → `{id,url}` (file id + wixstatic url); menu items bind by this file id |
-| `attachItemImages(ctx, [{id,revision,price,image}])` | image pass — full-replace PATCH (echo revision + priceInfo); `image.id` = a Wix Media file id from `importImage` |
-
-**Shared** (ordering + reservations STEP 0)
-| fn | does |
-|---|---|
-| `setBusinessLocation(ctx, location)` | full-override Update Location (or create if none) — REQUIRED for ordering |
-
-**Online ordering** (`setup-restaurant-orders.md`) — verify/reshape the auto-provisioned setup
-| fn | does |
-|---|---|
-| `installOrdersApp(ctx)` | install the Orders app (auto-provisions operation + methods + per-menu settings) |
-| `listOperations(ctx)` | the auto-created operation(s) — never create one |
-| `enableOperation(ctx, id, revision)` | PATCH `onlineOrderingStatus:"ENABLED"` (only if not already) |
-| `listFulfillmentMethods(ctx)` | the three auto-created methods |
-| `updateFulfillmentMethod(ctx, id, patch)` | rename / re-fee / disable (partial; `fee`/`minOrderPrice` decimal strings) |
-| `createFulfillmentMethod(ctx, method)` | add one beyond the defaults (NOT auto-attached) |
-| `setOperationFulfillmentIds(ctx, id, revision, ids)` | attach a created method (full array) |
-| `queryMenuOrderingSettings(ctx)` | confirm each menu `onlineOrderingEnabled` + bound to the operation |
-| `updateMenuOrderingSettings(ctx, id, patch)` | flip a menu orderable / display-only |
-
-**Table reservations** (`setup-restaurant-reservations.md`) — configure the auto-provisioned location
-| fn | does |
-|---|---|
-| `installTableReservationsApp(ctx)` | install the app (auto-provisions the default reservation location) |
-| `listReservationLocations(ctx)` | discover the default (never create one — API can't) |
-| `updateReservationLocation(ctx, id, revision, configuration)` | party-size / hours / turnover (config only; `location` immutable) |
-| `enableOnlineReservations(ctx, id, revision)` | turn online reservations on — PREMIUM-GATED (428 on free) |
-
-**Experiences** (`setup-restaurant-experiences.md`) — feature of Table Reservations (no extra install)
-| fn | does |
-|---|---|
-| `createExperiences(ctx, reservationLocationId, experiences)` | one experience per named dining occasion → `[{id,name}]` |
-
-## Ordering rules (do not violate)
-- **Menu is bottom-up: items → sections → menu.** A section is created with its `itemIds`, a menu with
-  its `sectionIds`, so each child must exist before its parent. `createMenu` does this in three phases.
-- **`visible: true` at every level** (item, section, menu) — storefront queries return only visible
-  entities. Baked in by `createMenu`.
-- **Menu before ordering.** Seed the menu first, then the ordering add-on (as one unit) — each menu
-  binds to the operation via a menu-ordering-settings object. Ordering auto-provisions per menu either
-  way, but the verify step needs a menu to confirm against.
-- **`setBusinessLocation` STEP 0 is required for ordering** — without a real address Wix limits ordering
-  to "testing only" and checkout breaks. Shared with reservations (do it once if both add-ons run).
-- **Reservations are independent** — they bind to a location, not a menu; no menu-first rule, nothing to
-  bulk-seed (visitors create reservations at runtime).
-- Operations and reservation locations are **auto-provisioned — never create them**; discover and PATCH.
-
-## Preconditions (record in the handoff, do NOT fail the seed)
-- **Ordering address (STEP 0)** — required; if the brief names none, set a clearly-marked placeholder and
-  flag the owner to set their real business address before ordering works.
-- **Paid checkout** needs a **premium plan + a configured payment method** (dashboard/premium — can't be
-  done headlessly).
-- **`enableOnlineReservations` is premium-only** — throws `428 PREMIUM_ONLY` on a non-premium site;
-  expected and non-fatal, record it and continue (don't retry-spiral).
-- **Booking an experience** is premium-gated the same way (create works on a free site; booking needs
-  premium + online reservations enabled).
-
-## Reference
-If a call returns a shape you didn't expect, or you need an operation this module doesn't cover, use the
-documentation skill available in your environment to search + read the live Wix API reference — never guess. The **Experiences** create
-payload especially lives in the docs (fields evolve). The authoritative source recipes are
-`wix-headless/references/inline-recipes/setup-restaurants.md`, `setup-restaurant-orders.md`,
-`setup-restaurant-reservations.md`, and `setup-restaurant-experiences.md`.
-
-Read a method's page before writing its call: it carries the exact body shape, the required
-permission scope, and the response envelope.
-- Install a Wix app onto the site: https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/install-app.md
-- Import an image into Wix Media: https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/import-file.md
-- Create Menu: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/menus/create-menu.md
-- Create Section: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/sections/create-section.md
-- Bulk Create Sections: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/sections/bulk-create-sections.md
-- Create Item: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/items/create-item.md
-- Bulk Create Items: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/items/bulk-create-items.md
-- List Operations: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/operations/list-operations.md
-- Update Operation: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/operations/update-operation.md
-- Create Fulfillment Method: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/fulfillment-methods/create-fulfillment-method.md
-- Create Location: https://dev.wix.com/docs/api-reference/business-management/locations/create-location.md
-- List Reservation Locations: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservation-locations/list-reservation-locations.md
-- Update Reservation Location: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservation-locations/update-reservation-location.md
-- Query Menu Ordering Settings: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/menu-ordering-settings/query-menu-ordering-settings.md
-- Upsert Menu Ordering Settings By Menu Id: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/menu-ordering-settings/upsert-menu-ordering-settings-by-menu-id.md
-- Create Experience: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/experiences/create-experience.md