@wix/agent-skills 1.20.1 → 1.22.0

package/skills/wix-headless-fast/references/restaurants/app/wix/restaurants/reservations-core.ts

@@ -1,94 +0,0 @@
-// Table-reservation rules and DTO mapping — transport-agnostic, imported by both
-// ./reservations.ts (SDK) and the REST twin in references/restaurants/rest/reservations.ts (fetch).
-// The flow is location → AVAILABLE slots → hold (10-minute temporary reservation) → reserve with
-// the visitor's details; a reservation is a hold, not a purchase. Raw entities carry `_id` (SDK)
-// or `id` (REST); slot dates arrive as Date (SDK) or ISO string (REST). Imports are type-only.
-import type {
-  ReservationConfirmation,
-  ReservationHold,
-  ReservationLocationInfo,
-  ReservationReservee,
-  ReservationSlot,
-} from "./types";
-import type { Raw } from "./menu-core";
-
-export const rawId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-export function toLocation(raw: Raw): ReservationLocationInfo {
-  const online = raw.configuration?.onlineReservations ?? {};
-  return {
-    id: rawId(raw),
-    default: raw.default === true,
-    partySizeMin: online.partySize?.min ?? 1,
-    partySizeMax: online.partySize?.max ?? 20,
-    approvalMode: online.approval?.mode ?? "AUTOMATIC",
-    onlineReservationsEnabled: online.onlineReservationsEnabled === true,
-  };
-}
-
-/** Active (non-archived) locations, default first. `onlineReservationsEnabled: false` → the premium-gated toggle is off. */
-export function toLocations(raws: Raw[]): ReservationLocationInfo[] {
-  return raws
-    .filter((l) => l.archived !== true)
-    .map(toLocation)
-    .filter((l) => l.id)
-    .sort((a, b) => Number(b.default) - Number(a.default));
-}
-
-export function toSlot(raw: Raw): ReservationSlot {
-  const start: Date = raw.startDate instanceof Date ? raw.startDate : new Date(raw.startDate);
-  let label = "";
-  let dayKey = "";
-  try {
-    label = start.toLocaleTimeString(undefined, { hour: "numeric", minute: "2-digit" });
-    const pad = (n: number) => String(n).padStart(2, "0");
-    dayKey = `${start.getFullYear()}-${pad(start.getMonth() + 1)}-${pad(start.getDate())}`;
-  } catch {
-    /* label/dayKey stay "" — startIso still books */
-  }
-  return {
-    startIso: start.toISOString(),
-    label,
-    dayKey,
-    durationMinutes: raw.duration ?? 0,
-    manualApproval: raw.manualApproval === true,
-  };
-}
-
-/** AVAILABLE slots only — UNAVAILABLE and NON_WORKING_HOURS are dropped (offering them makes the hold fail). */
-export function availableSlots(raws: Raw[]): ReservationSlot[] {
-  return raws.filter((s) => s.status === "AVAILABLE").map(toSlot);
-}
-
-/** The hold's { reservationId, revision } that completeReservation NEEDS; throws when the slot wasn't held. */
-export function toHold(res: Raw | null | undefined, startIso: string, partySize: number): ReservationHold {
-  const reservationId = rawId(res?.reservation);
-  const revision = res?.reservation?.revision;
-  if (!reservationId || !revision) {
-    throw new Error("That time couldn't be held — it may have just been taken. Pick another slot.");
-  }
-  return { reservationId, revision: String(revision), startIso, partySize };
-}
-
-/** The reservee body of a reserve: firstName + phone (E.164) REQUIRED, trimmed; optional fields only when filled. */
-export function reserveeBody(reservee: ReservationReservee): Raw {
-  if (!reservee.firstName?.trim() || !reservee.phone?.trim()) {
-    throw new Error("First name and phone number are required.");
-  }
-  return {
-    firstName: reservee.firstName.trim(),
-    phone: reservee.phone.trim(),
-    ...(reservee.lastName?.trim() ? { lastName: reservee.lastName.trim() } : {}),
-    ...(reservee.email?.trim() ? { email: reservee.email.trim() } : {}),
-  };
-}
-
-/** RESERVED = confirmed; REQUESTED = pending approval. Throws when the hold expired (no reservation back). */
-export function toConfirmation(res: Raw | null | undefined): ReservationConfirmation {
-  const reservation = res?.reservation;
-  const reservationId = rawId(reservation);
-  if (!reservationId) {
-    throw new Error("The reservation couldn't be completed — the hold may have expired. Start over.");
-  }
-  return { reservationId, status: reservation.status === "REQUESTED" ? "REQUESTED" : "RESERVED" };
-}

package/skills/wix-headless-fast/references/restaurants/app/wix/restaurants/reservations.ts

@@ -1,74 +0,0 @@
-// Table reservations (@wix/table-reservations) over the SDK — the only file that touches raw
-// reservation entities on this transport. Rules and mappers live in ./reservations-core (shared
-// with the REST twin in references/restaurants/rest/); this file is the transport only. Copy
-// as-is; extend by calling these exports, never by editing them.
-//
-// getTimeSlots takes POSITIONAL args and a Date (not an ISO string); reserveReservation takes
-// THREE positional args (id, reservee, revision) and the only exit from HELD is reserve.
-// Failures are loud — surface the message, don't swallow it.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservation-locations/list-reservation-locations.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/time-slots/get-time-slots.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservations/create-held-reservation.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservations/reserve-reservation.md
-import { reservationLocations, timeSlots, reservations as reservationsModule } from "@wix/table-reservations";
-import { wixModule } from "../sdk";
-import { availableSlots, reserveeBody, toConfirmation, toHold, toLocations } from "./reservations-core";
-import type { Raw } from "./menu-core";
-import type { ReservationConfirmation, ReservationHold, ReservationLocationInfo, ReservationReservee, ReservationSlot } from "./types";
-
-const locationsApi = wixModule(reservationLocations);
-const timeSlotsApi = wixModule(timeSlots);
-const reservationsApi = wixModule(reservationsModule);
-
-/**
- * Active (non-archived) reservation locations, default first. [] when Table Reservations
- * isn't set up. `onlineReservationsEnabled: false` means the premium-gated toggle is off —
- * slots and booking won't work; render an honest "reservations aren't open yet" state.
- */
-export async function fetchReservationLocations(): Promise<ReservationLocationInfo[]> {
-  const res: Raw = await locationsApi.listReservationLocations();
-  return toLocations(res.reservationLocations ?? []);
-}
-
-/**
- * AVAILABLE reservation slots around a moment for a party size — UNAVAILABLE and
- * NON_WORKING_HOURS slots are already filtered out (offering them makes the hold fail).
- * `aroundIso` anchors the fan-out: slotsBefore/slotsAfter extra slots on each side.
- */
-export async function fetchReservationSlots(
-  locationId: string,
-  aroundIso: string,
-  partySize: number,
-  { slotsBefore = 6, slotsAfter = 6 }: { slotsBefore?: number; slotsAfter?: number } = {},
-): Promise<ReservationSlot[]> {
-  // The date param is a Date — the SDK types it as Date, not the ISO string the docs show.
-  const res: Raw = await timeSlotsApi.getTimeSlots(locationId, new Date(aroundIso), partySize, { slotsBefore, slotsAfter });
-  return availableSlots(res.timeSlots ?? []);
-}
-
-/**
- * Hold a slot for 10 minutes while the visitor enters their details. The returned hold
- * carries the { reservationId, revision } that completeReservation NEEDS — keep both.
- */
-export async function holdReservation(locationId: string, startIso: string, partySize: number): Promise<ReservationHold> {
-  const res: Raw = await reservationsApi.createHeldReservation({
-    reservationLocationId: locationId,
-    startDate: new Date(startIso),
-    partySize,
-  });
-  return toHold(res, startIso, partySize);
-}
-
-/**
- * Complete a held reservation with the visitor's details. firstName and phone (E.164, e.g.
- * "+15551234567") are REQUIRED. A hold expires after 10 minutes — on failure, start a fresh
- * hold; never try to update a HELD reservation by other means.
- */
-export async function completeReservation(
-  hold: Pick<ReservationHold, "reservationId" | "revision">,
-  reservee: ReservationReservee,
-): Promise<ReservationConfirmation> {
-  const body = reserveeBody(reservee);
-  const res: Raw = await reservationsApi.reserveReservation(hold.reservationId, body, hold.revision);
-  return toConfirmation(res);
-}

package/skills/wix-headless-fast/references/restaurants/app/wix/restaurants/types.ts

@@ -1,168 +0,0 @@
-// Restaurants DTOs — the serializable shapes every hook, component, and page consumes.
-// Plain JSON: safe as Astro island props or across server/client boundaries. Images are
-// resolved https URLs. MENU prices come from the Menus API as decimal strings in the site
-// currency with NO symbol ("12.50") — the DTO carries the platform's formatted string when
-// the response includes one, else the plain decimal (prefix your brand's currency in the UI).
-// Order-cart prices (eCom) ARE fully formatted strings.
-
-/** A dietary/style label on a menu item (e.g. "Vegan", "Spicy"). */
-export interface MenuItemLabel {
-  id: string;
-  name: string;
-  /** Resolved https URL ("" when the label has no icon). */
-  iconUrl: string;
-}
-
-/** One price variant of an item ("Glass" / "Bottle"). An item has price OR variants. */
-export interface MenuItemVariant {
-  variantId: string;
-  name: string;
-  /** Display price — formatted when the API provides it, else the decimal amount. */
-  price: string;
-}
-
-/** One choice inside a modifier group ("Extra cheese"). */
-export interface MenuModifier {
-  id: string;
-  name: string;
-  preSelected: boolean;
-  /** Decimal up-charge amount ("0" = free), site currency, no symbol. */
-  additionalCharge: string;
-  inStock: boolean;
-}
-
-/** A modifier group on an item ("Toppings", choose 0–3). DISPLAY-ONLY: modifier
- * selections are not sent on the cart line (the API doesn't document that shape). */
-export interface MenuModifierGroup {
-  id: string;
-  name: string;
-  required: boolean;
-  minSelections: number;
-  maxSelections: number | null;
-  modifiers: MenuModifier[];
-}
-
-/** A dish/drink as the menu page needs it. */
-export interface MenuItem {
-  id: string;
-  name: string;
-  description: string;
-  /** Display price; null when the item is variant-priced or market-priced. */
-  price: string | null;
-  /** True → show "Market price"; the item can't be ordered online. */
-  marketPrice: boolean;
-  /** Non-empty exactly when price is null and not marketPrice. */
-  variants: MenuItemVariant[];
-  /** Resolved https URL ("" when the item has no image). */
-  imageUrl: string;
-  labels: MenuItemLabel[];
-  modifierGroups: MenuModifierGroup[];
-  /** False → render "Sold out" and disable add-to-order. */
-  inStock: boolean;
-  featured: boolean;
-}
-
-/** A section of a menu ("Appetizers"), items already in display order. */
-export interface MenuSection {
-  id: string;
-  name: string;
-  description: string;
-  /** Resolved https URL ("" when none). */
-  imageUrl: string;
-  items: MenuItem[];
-}
-
-/** A whole menu ("Dinner"), sections already in display order. */
-export interface MenuData {
-  id: string;
-  name: string;
-  description: string;
-  /** URL fragment (urlQueryParam), e.g. "dinner". */
-  slug: string;
-  sections: MenuSection[];
-}
-
-/** A pickup/delivery method to display (the buyer picks one on the hosted checkout). */
-export interface FulfillmentMethodInfo {
-  id: string;
-  type: "PICKUP" | "DELIVERY";
-  name: string;
-  /** Decimal amounts, site currency, no symbol ("0", "5"). */
-  fee: string;
-  minOrderPrice: string;
-}
-
-export interface OrderLine {
-  /** The cart line id — what update/remove take (NOT the menu item id). */
-  lineItemId: string;
-  itemName: string;
-  quantity: number;
-  /** Per-unit price, formatted. */
-  unitPrice: string;
-  /** Line total, formatted. */
-  linePrice: string;
-  /** Resolved https URL ("" when none). */
-  imageUrl: string;
-  /** Human-readable selection labels the platform attached (may be empty). */
-  descriptionLines: string[];
-  /** Not IN_STOCK → the line can't be checked out as-is. */
-  status: string;
-}
-
-export interface OrderCart {
-  lines: OrderLine[];
-  /** Sum of line quantities. */
-  itemCount: number;
-  /** Formatted subtotal (after discounts) — from the cart estimate, not hand-summed. */
-  subtotal: string;
-  currency: string;
-}
-
-/** A reservation location as the booking form needs it. */
-export interface ReservationLocationInfo {
-  id: string;
-  default: boolean;
-  /** Bound the party-size input to [partySizeMin, partySizeMax]. */
-  partySizeMin: number;
-  partySizeMax: number;
-  /** "AUTOMATIC" confirms instantly; "MANUAL"/"MANUAL_FOR_LARGE_PARTIES" may end REQUESTED. */
-  approvalMode: "AUTOMATIC" | "MANUAL" | "MANUAL_FOR_LARGE_PARTIES";
-  /** False (premium-gated toggle off) → slots/booking won't work; show an honest notice. */
-  onlineReservationsEnabled: boolean;
-}
-
-/** One AVAILABLE reservation time slot. */
-export interface ReservationSlot {
-  /** ISO datetime — pass to holdSlot as-is. */
-  startIso: string;
-  /** Display label, e.g. "7:00 PM". */
-  label: string;
-  /** "YYYY-MM-DD" in the visitor's timezone — for grouping/labeling. */
-  dayKey: string;
-  durationMinutes: number;
-  /** This slot needs staff approval → the reservation will end REQUESTED, not RESERVED. */
-  manualApproval: boolean;
-}
-
-/** A 10-minute hold on a slot; completeReservation needs BOTH ids. */
-export interface ReservationHold {
-  reservationId: string;
-  revision: string;
-  startIso: string;
-  partySize: number;
-}
-
-/** The visitor's details. firstName + phone (E.164, e.g. "+15551234567") are REQUIRED. */
-export interface ReservationReservee {
-  firstName: string;
-  phone: string;
-  lastName?: string;
-  email?: string;
-}
-
-/** The outcome of completing a reservation. */
-export interface ReservationConfirmation {
-  reservationId: string;
-  /** RESERVED = confirmed; REQUESTED = pending the restaurant's approval — tell the visitor. */
-  status: "RESERVED" | "REQUESTED";
-}

package/skills/wix-headless-fast/references/restaurants/app-astro/layouts/SiteLayout.astro

@@ -1,47 +0,0 @@
----
-// The site chrome for every restaurant page — THIS file (header/footer/nav) plus the @theme
-// token block in src/styles/global.css are what you brand. Keep the <slot name="seo-tags" />
-// in <head>, the global.css import, and one OrderCartButton in the header + one
-// OrderCartDrawer per page (both client:only — they read browser cart state and must not
-// server-render). (If another vertical is also deployed, its SiteLayout may have won; merge
-// the Menu/Reservations nav links and the order-cart mounts there instead.)
-import OrderCartButton from "../components/restaurants/OrderCartButton";
-import OrderCartDrawer from "../components/restaurants/OrderCartDrawer";
-import "../styles/global.css";
-
-interface Props {
-  title: string;
-  description?: string;
-}
-const { title, description } = Astro.props;
----
-
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>{title}</title>
-    {description && <meta name="description" content={description} />}
-    <slot name="seo-tags" />
-  </head>
-  <body>
-    <header class="sticky top-0 z-40 border-b border-border bg-background/80 backdrop-blur">
-      <div class="mx-auto flex h-16 max-w-6xl items-center justify-between px-6">
-        <a href="/" class="text-base font-bold tracking-tight text-foreground no-underline">Brand Name</a>
-        <nav class="flex items-center gap-6 text-sm">
-          <a href="/menu" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Menu</a>
-          <a href="/reservations" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Reservations</a>
-          <OrderCartButton client:only="react" />
-        </nav>
-      </div>
-    </header>
-    <main class="mx-auto max-w-6xl px-6 pb-24 pt-10">
-      <slot />
-    </main>
-    <footer class="border-t border-border px-6 py-10 text-center text-sm text-muted-foreground">
-      © Brand Name
-    </footer>
-    <OrderCartDrawer client:only="react" />
-  </body>
-</html>

package/skills/wix-headless-fast/references/restaurants/app-astro/pages/menu.astro

@@ -1,22 +0,0 @@
----
-// Menu page — the full menu tree fetched SERVER-SIDE (SEO: dish names in view-source) and
-// handed to the island as DTO props. Keep this frontmatter; swap the island import to YOUR
-// menu component. The island is client:load — add-to-order needs the browser.
-import SiteLayout from "../layouts/SiteLayout.astro";
-import MenuView from "../components/restaurants/MenuView";
-import { fetchMenus } from "../wix/restaurants/menu";
-import type { MenuData } from "../wix/restaurants/types";
-
-let menus: MenuData[] = [];
-try {
-  menus = await fetchMenus();
-} catch {
-  // An unguarded SSR throw truncates the response mid-stream; the island renders the
-  // empty state instead.
-}
----
-
-<SiteLayout title="Menu">
-  <h1 class="mb-8 text-2xl font-semibold tracking-tight">Menu</h1>
-  <MenuView client:load initialMenus={menus} />
-</SiteLayout>

package/skills/wix-headless-fast/references/restaurants/app-astro/pages/reservations.astro

@@ -1,12 +0,0 @@
----
-// Reservations page. The surface is client:only — availability is timezone- and
-// party-specific, so nothing useful can server-render. Swap the island import to YOUR
-// reservation component.
-import SiteLayout from "../layouts/SiteLayout.astro";
-import ReservationView from "../components/restaurants/ReservationView";
----
-
-<SiteLayout title="Reservations" description="Reserve a table">
-  <h1 class="mb-8 text-2xl font-semibold tracking-tight">Reserve a table</h1>
-  <ReservationView client:only="react" />
-</SiteLayout>