@wix/agent-skills 1.20.1 → 1.22.0

package/skills/wix-headless-fast/references/bookings/rest/booking.ts

@@ -1,113 +0,0 @@
-// Availability, the booking form, and the createBooking → Cart V2 → checkout-or-place sequence over
-// REST — the twin of app/wix/bookings/booking.ts. Same exports, same DTOs; every body comes from
-// booking-core (the SAME file the SDK transport uses, deployed flat next to this one), so this file
-// is only the transport: literal paths, one fetch per step. Failures are loud: a taken slot, a
-// refused cart, a checkout that won't start all throw — surface the message to the visitor.
-// All calls run with the visitor token: the booking and its cart are the token's (see ./client).
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/time-slots/time-slots-v2/list-availability-time-slots.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/time-slots/time-slots-v2/list-event-time-slots.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/create-booking.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
-// docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form-summary.md
-import { wixRequest } from "./client.js";
-import {
-  FALLBACK_FIELDS,
-  appointmentSlotsRequest,
-  bookingCartRequest,
-  bookingIdOf,
-  bookingRequest,
-  cartIdOf,
-  cartTotal,
-  checkoutRedirectRequest,
-  checkoutRequired,
-  classSlotsRequest,
-  confirmedResult,
-  defaultTimeZone,
-  toFormFields,
-  toLocalDateString,
-  toSlot,
-  type Raw,
-  type SlotsWindow,
-} from "./booking-core.js";
-import type { BookingFormField, BookingResult, ServiceDetail, Slot } from "./types.js";
-
-export { toLocalDateString };
-
-/**
- * Bookable slots for a service in [from, from + days) — APPOINTMENT and CLASS use different APIs;
- * this branches for you. Dates are local wall-clock; timeZone defaults to the visitor's.
- * APPOINTMENT: POST /service-availability/v2/time-slots  { serviceId, fromLocalDate, toLocalDate, timeZone, bookable, cursorPaging, includeResourceTypeIds, resourceTypes? }
- * CLASS:       POST /service-availability/v2/time-slots/event  { serviceIds, fromLocalDate, toLocalDate, timeZone, includeNonBookable, eventFilter? }
- */
-export async function fetchSlots(service: Pick<ServiceDetail, "id" | "type">, window: SlotsWindow = {}): Promise<Slot[]> {
-  const res =
-    service.type === "CLASS"
-      ? await wixRequest<Raw>("/service-availability/v2/time-slots/event", { body: classSlotsRequest(service.id, window) })
-      : await wixRequest<Raw>("/service-availability/v2/time-slots", { body: appointmentSlotsRequest(service.id, window) });
-  return ((res?.timeSlots ?? []) as Raw[]).map(toSlot);
-}
-
-/**
- * The service's booking-form fields, flat and render-ready (values keyed by `target`). ALWAYS a
- * non-empty list — contact basics when the schema is missing/unusable — so the form renders
- * unconditionally.  GET /form-schema-service/v4/forms/{formId}/summary (labels, types) and
- * GET /form-schema-service/v4/forms/{formId} (which fields are required — the summary doesn't say).
- */
-export async function fetchBookingForm(formId: string | null): Promise<BookingFormField[]> {
-  if (!formId) return FALLBACK_FIELDS;
-  try {
-    const id = encodeURIComponent(formId);
-    const [res, form] = await Promise.all([
-      wixRequest<Raw>(`/form-schema-service/v4/forms/${id}/summary`, { method: "GET" }),
-      wixRequest<Raw>(`/form-schema-service/v4/forms/${id}`, { method: "GET" }).catch(() => null),
-    ]);
-    return toFormFields(res?.formSummary, form?.form);
-  } catch {
-    return FALLBACK_FIELDS;
-  }
-}
-
-/**
- * Book a slot: createBooking → createCart (holds the seat) → calculateCart → hosted checkout (paid)
- * or placeOrder (free / pay-in-person). Call from the browser. `formValues` is the object your
- * inputs wrote, keyed by field `target` — passed as the formSubmission DIRECTLY. Throws with the
- * refusal (slot taken, invalid form) — surface it, don't swallow it. `origin` is the site's real
- * https origin as registered on the OAuth app's allowed domains (browser: window.location.origin).
- *   POST /bookings/v2/bookings            { booking, formSubmission }
- *   POST /ecom/v2/carts                   { catalogItems: [{ quantity: 1, catalogReference: { catalogItemId: <bookingId>, appId } }], cart: { source: { channelType: "WEB" } } }
- *   POST /ecom/v2/carts/{cartId}/calculate {}
- *   POST /headless/v1/redirect-session    { ecomCheckout: { checkoutId: <cartId> }, callbacks: { postFlowUrl } }
- *   POST /ecom/v2/carts/{cartId}/place-order {}
- */
-export async function bookService(
-  service: ServiceDetail,
-  slot: Slot,
-  formValues: Record<string, unknown>,
-  {
-    staffId,
-    timeZone = defaultTimeZone(),
-    origin = typeof window !== "undefined" ? window.location.origin : "",
-  }: { staffId?: string; timeZone?: string; origin?: string } = {},
-): Promise<BookingResult> {
-  const created = await wixRequest<Raw>("/bookings/v2/bookings", {
-    body: { booking: bookingRequest(service, slot, { staffId, timeZone, idKey: "id" }), formSubmission: formValues },
-  });
-  const bookingId = bookingIdOf(created);
-  if (!bookingId) throw new Error("The booking couldn't be created — the slot may have just been taken.");
-
-  const newCart = await wixRequest<Raw>("/ecom/v2/carts", { body: bookingCartRequest(bookingId) });
-  const cartId = cartIdOf(newCart);
-  if (!cartId) throw new Error("The booking couldn't be reserved — please try again.");
-
-  const calc = await wixRequest<Raw>(`/ecom/v2/carts/${cartId}/calculate`, { body: {} });
-  if (checkoutRequired(service, cartTotal(calc))) {
-    const session = await wixRequest<Raw>("/headless/v1/redirect-session", { body: checkoutRedirectRequest(cartId, origin) });
-    const url = session?.redirectSession?.fullUrl;
-    if (!url) throw new Error("Checkout couldn't start — please try again.");
-    return { kind: "redirect", url };
-  }
-
-  const order = await wixRequest<Raw>(`/ecom/v2/carts/${cartId}/place-order`, { body: {} });
-  return confirmedResult(bookingId, order);
-}

package/skills/wix-headless-fast/references/bookings/rest/services.ts

@@ -1,55 +0,0 @@
-// Service reads over REST — the twin of app/wix/bookings/services.ts. Same exports, same DTOs; the
-// rules and mappers come from services-core (the SAME file the SDK transport uses, deployed flat
-// next to this one by deploy.mjs --stack static), so this file is only the transport: one fetch with
-// a literal body per function. Every call here is safe from a browser with a visitor token.
-// Porting: keep the paths, keep the bodies, port the core once.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/query-services.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/query-categories.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import {
-  BOOKINGS_APP_ID,
-  SERVICES_CONDITIONAL_FIELDS,
-  STAFF_RESOURCE_TYPE_ID,
-  isVisible,
-  servicesFilter,
-  toCategory,
-  toDetail,
-  toSummary,
-  type Raw,
-} from "./services-core.js";
-import type { BookingCategory, ServiceDetail, ServiceSummary } from "./types.js";
-
-export { BOOKINGS_APP_ID, STAFF_RESOURCE_TYPE_ID };
-
-// POST /bookings/v2/services/query  { query: { filter, paging: { limit } }, conditionalFields }
-async function queryServices(slug: string | undefined, limit: number): Promise<Raw[]> {
-  const res = await wixRequest<Raw>("/bookings/v2/services/query", {
-    body: { query: { filter: servicesFilter(slug), paging: { limit } }, conditionalFields: SERVICES_CONDITIONAL_FIELDS },
-  });
-  return (res?.services ?? []) as Raw[];
-}
-
-/** List bookable services (hidden ones filtered), mapped to grid-ready DTOs. */
-export async function fetchServices({ limit = 100 } = {}): Promise<ServiceSummary[]> {
-  return (await queryServices(undefined, limit)).filter(isVisible).map((s) => toSummary(s, imgSrc));
-}
-
-/** One service by its URL slug (mainSlug.name) — a query with the slug in the filter. Null when not found. */
-export async function fetchServiceBySlug(slug: string): Promise<ServiceDetail | null> {
-  const raw = (await queryServices(slug, 1))[0];
-  return raw ? toDetail(raw, imgSrc) : null;
-}
-
-/**
- * Service categories for a filter bar — non-fatal (empty array on failure).
- * POST /bookings/v2/categories/query  { query: {} }
- */
-export async function fetchBookingCategories(): Promise<BookingCategory[]> {
-  try {
-    const res = await wixRequest<Raw>("/bookings/v2/categories/query", { body: { query: {} } });
-    return ((res?.categories ?? []) as Raw[]).map(toCategory).filter((c) => c.id);
-  } catch {
-    return [];
-  }
-}

package/skills/wix-headless-fast/references/bookings/seed/SEED.md

@@ -1,71 +0,0 @@
-# Bookings — seeding
-
-Seed by **running `seed-bookings.mjs` with a plan file** — don't hand-write the REST calls.
-The script mints its own site token via the Wix CLI (logged-in session + `wix.config.json`
-required), installs the Bookings app if needed, resolves a staff resource (polling — a fresh
-install provisions the owner asynchronously), and creates everything in the right order.
-
-```bash
-# from the project root (where wix.config.json lives):
-node <SKILL_ROOT>/references/bookings/seed/seed-bookings.mjs plan.json
-```
-
-`plan.json` is plain data — write it from the brief. **Default to 3 services** (the seed
-shows the shape; the owner adds the rest in the dashboard) and make them exercise the UI:
-mix APPOINTMENT and CLASS when it fits the business, include ≥1 free/pay-in-person service,
-and give every service an image — the default is an `imagePrompt` (AI-generated, ~1 Wix AI
-credit per image, account-billed): brand-contextual — subject, aesthetic/mood, palette,
-lighting — always ending "no text, no watermarks". At least one image in the set shows the real subject of the business — the actual product/space/service, not abstract decoration. For an asset the user actually supplied use `imagePath` (a file on this
-machine — uploaded to Wix Media) or `imageUrl` (their own hosted URL; verify it with
-`curl -sI` → 200) — never a stock-photo or guessed URL. Images resolve in parallel and never block the seed; a failed
-image leaves that service text-only.
-
-```json
-{
-  "services": [
-    { "type": "APPOINTMENT", "name": "Deep Tissue Massage", "tagLine": "60 minutes of relief",
-      "description": "…", "price": 85, "duration": 60, "category": "Massage",
-      "imageUrl": "https://…" },
-    { "type": "APPOINTMENT", "name": "Intro Consultation", "description": "…", "free": true,
-      "duration": 30, "category": "Massage", "imageUrl": "https://…" },
-    { "type": "CLASS", "name": "Morning Yoga", "description": "…", "price": 20, "capacity": 12,
-      "category": "Classes", "imageUrl": "https://…",
-      "sessions": [
-        { "start": "2026-09-01T09:00:00", "end": "2026-09-01T10:00:00" },
-        { "start": "2026-09-03T09:00:00", "end": "2026-09-03T10:00:00" }
-      ] }
-  ]
-}
-```
-
-- `type` — `APPOINTMENT` (visitor picks a free slot; needs `duration` in minutes) or `CLASS`
-  (fixed `sessions` you schedule here — **future local wall-clock** `YYYY-MM-DDThh:mm:ss`, no Z;
-  a CLASS without sessions shows no bookable times).
-- `price` — a number; omit or `free: true` → a no-fee, pay-in-person service (books without
-  checkout). The site currency wins over `currency`.
-- `category` — a name; created idempotently. Every service gets one (required for live-site
-  visibility) — uncategorized services fall into a default "Services" category.
-- Staff: appointments are auto-assigned to the site's default staff resource; the flow books
-  with ANY_RESOURCE when the visitor doesn't choose.
-
-**Seeding is additive — never delete or overwrite existing content**; ask first if a cleanup
-seems needed.
-
-## Supplied content
-
-The general rules are in `references/shared/SUPPLIED-CONTENT.md`. For bookings, each service the
-user lists is one entry. Its name becomes `name` and its length in minutes becomes `duration`. Its
-price becomes `price`; a service marked free, or with no price, gets `"free": true`. A group activity
-with a capacity or fixed times becomes a `CLASS` with `capacity` and one `sessions` entry per listed
-time; everything else is an `APPOINTMENT`. A category or group becomes `category`. Their photo
-becomes `imageUrl`. A service with no duration is a question for the user. Staff members and
-opening hours are not seeded — say so; the owner sets them in the dashboard.
-
-## Escape hatch — individual functions
-`setupBookings` composes exported steps — `installBookingsApp`, `queryStaffWithRetry`,
-`createCategories`, `createServices`, `scheduleClassSessions`, `importImage`,
-`attachServiceImage`, plus `makeCtx()` — import them only for a partial re-seed.
-
-## Reference
-Unexpected shape or an uncovered operation → read the live Wix API reference; the
-authoritative source recipe is `wix-headless/references/inline-recipes/setup-bookings.md`.

package/skills/wix-headless-fast/references/bookings/seed/seed-bookings.mjs

@@ -1,302 +0,0 @@
-// Bookings seed — a BUILD-TIME script, never shipped in the app. Run from the project root
-// (where wix.config.json lives) with a plan file:
-//
-//   node <SKILL_ROOT>/references/bookings/seed/seed-bookings.mjs plan.json
-//
-// It mints its own site token via the Wix CLI, installs the Wix Bookings app if needed,
-// resolves a staff resource (polling — a fresh install provisions the owner async), creates
-// categories (idempotent by name) and services (bulk; APPOINTMENT + CLASS mixed), schedules
-// CLASS sessions, and imports+attaches images. Prints a JSON result to stdout.
-//
-// Plan shape (see SEED.md):
-//   { "services": [{ "type": "APPOINTMENT"|"CLASS", "name", "description", "tagLine"?,
-//                    "price"?, "free"?, "duration"? (APPOINTMENT, minutes), "capacity"?,
-//                    "category"? (name), "imageUrl"? | "imagePrompt"?,
-//                    "sessions"?: [{ "start", "end", "capacity"? }] }] }   // CLASS only; local "YYYY-MM-DDThh:mm:ss"
-//
-// Seeding is ADDITIVE — never deletes or overwrites existing content. Unexpected shapes →
-// read the live API reference; authoritative source recipe:
-// wix-headless/references/inline-recipes/setup-bookings.md.
-import { execFileSync } from "node:child_process";
-import { readFileSync } from "node:fs";
-import { resolveItemImages } from "../../shared/seed/images.mjs";
-
-const API = "https://www.wixapis.com";
-const BOOKINGS_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
-
-export function makeCtx({ cwd = process.cwd() } = {}) {
-  const config = JSON.parse(readFileSync(`${cwd}/wix.config.json`, "utf8"));
-  const siteId = config.siteId ?? config.projectId;
-  if (!siteId) throw new Error("wix.config.json has no siteId — is this a Wix CLI project?");
-  const token = execFileSync("npx", ["@wix/cli@latest", "token", "--site", siteId], {
-    encoding: "utf8",
-    cwd,
-  }).trim();
-  if (!token) throw new Error("The Wix CLI returned no token — run `npx @wix/cli@latest login` first.");
-  return { token, siteId };
-}
-
-async function req(ctx, path, { method = "POST", body } = {}) {
-  const res = await fetch(API + path, {
-    method,
-    headers: {
-      Authorization: `Bearer ${ctx.token}`,
-      "wix-site-id": ctx.siteId,
-      "Content-Type": "application/json",
-    },
-    body: body ? JSON.stringify(body) : undefined,
-  });
-  const json = await res.json().catch(() => ({}));
-  if (!res.ok) throw new Error(`${method} ${path} -> ${res.status}: ${JSON.stringify(json).slice(0, 400)}`);
-  return json;
-}
-
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-function slugify(name) {
-  return String(name || "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
-
-// plain service -> flat Services V2 create object. price omitted / free:true -> NO_FEE.
-function buildService(s) {
-  const isAppointment = s.type === "APPOINTMENT";
-  const free = s.free === true || s.price == null;
-  const out = {
-    type: s.type,
-    name: s.name,
-    description: s.description,
-    tagLine: s.tagLine,
-    defaultCapacity: s.capacity ?? (isAppointment ? 1 : undefined),
-    onlineBooking: { enabled: true, requireManualApproval: false, allowMultipleRequests: false },
-    payment: free
-      ? { rateType: "NO_FEE", options: { online: false, inPerson: true } }
-      : {
-          rateType: "FIXED",
-          fixed: { price: { value: String(s.price), currency: s.currency ?? "USD" } },
-          options: { online: true, inPerson: false },
-        },
-    category: { id: s.categoryId }, // mandatory for live-site visibility
-    locations: [{ type: "BUSINESS" }], // never OWNER_BUSINESS on the services endpoint
-  };
-  if (isAppointment) {
-    out.schedule = { availabilityConstraints: { sessionDurations: [s.duration ?? 60] } };
-    out.staffMemberIds = s.staffMemberIds; // resourceId(s) — non-empty or MISSING_APPOINTMENT_RESOURCES
-  }
-  return out;
-}
-
-// ---- operations ----------------------------------------------------------------------------------
-
-// docs: https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix.md
-export async function installBookingsApp(ctx) {
-  try {
-    await req(ctx, "/apps-installer-service/v1/app-instance/install", { body: {
-      tenant: { tenantType: "SITE", id: ctx.siteId },
-      appInstance: { appDefId: BOOKINGS_APP_ID, enabled: true },
-    } });
-  } catch {
-    /* already installed is fine */
-  }
-}
-
-// ⚠️ staffMemberIds takes resourceId, NOT the staff id.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/staff-members/staff-members/query-staff-members.md
-export async function queryStaff(ctx) {
-  const r = await req(ctx, "/bookings/v1/staff-members/query", {
-    body: { query: {}, fields: ["RESOURCE_DETAILS"] },
-  });
-  return (r.staffMembers ?? []).map((m) => ({ resourceId: m.resourceId, id: m.id, name: m.name }));
-}
-
-// A fresh install provisions the default "Business Owner" resource ASYNC — poll until it lands.
-export async function queryStaffWithRetry(ctx, { tries = 15, delayMs = 2000 } = {}) {
-  let lastErr;
-  for (let i = 0; i < tries; i++) {
-    try {
-      const s = await queryStaff(ctx);
-      if (s.length) return s;
-    } catch (e) {
-      lastErr = e;
-    }
-    if (i < tries - 1) await sleep(delayMs);
-  }
-  if (lastErr) throw lastErr;
-  return [];
-}
-
-// Every service needs a category.id or it's invisible on the live site. Idempotent by name.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/query-categories.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/categories-v2/create-category.md
-export async function createCategories(ctx, names) {
-  const existing = await req(ctx, "/bookings/v2/categories/query", { body: { query: {} } });
-  const byName = new Map((existing.categories ?? []).map((c) => [c.name, { id: c.id, name: c.name }]));
-  const out = [];
-  for (const name of names) {
-    let cat = byName.get(name);
-    if (!cat) {
-      const r = await req(ctx, "/bookings/v2/categories", { body: { category: { name } } });
-      cat = { id: r.category?.id, name };
-      byName.set(name, cat);
-    }
-    out.push(cat);
-  }
-  return out;
-}
-
-// Bulk-create services (APPOINTMENT + CLASS mixed). Run AFTER staff + categories.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/bulk-create-services.md
-export async function createServices(ctx, services) {
-  const body = { services: services.map(buildService), returnEntity: true };
-  const r = await req(ctx, "/bookings/v2/bulk/services/create", { body });
-  return (r.results ?? []).map((res, i) => {
-    const item = res.item ?? {};
-    return {
-      id: item.id ?? res.itemMetadata?.id,
-      slug: item.mainSlug?.name ?? slugify(item.name ?? services[i]?.name),
-      revision: item.revision,
-      type: item.type ?? services[i]?.type,
-      scheduleId: item.schedule?.id,
-      success: res.itemMetadata?.success ?? false,
-      error: res.itemMetadata?.error,
-    };
-  });
-}
-
-// CLASS only: schedule sessions (bulk Calendar Events V3). start/end are LOCAL wall-clock
-// "YYYY-MM-DDThh:mm:ss" (no Z), today-or-future.
-// docs: https://dev.wix.com/docs/api-reference/business-management/calendar/events-v3/bulk-create-event.md
-export async function scheduleClassSessions(ctx, sessions) {
-  const body = {
-    events: sessions.map((s) => ({
-      event: {
-        scheduleId: s.scheduleId,
-        type: "CLASS",
-        start: { localDate: s.start },
-        end: { localDate: s.end },
-        resources: [{ id: s.resourceId, permissionRole: "WRITER" }], // non-empty + WRITER, else UNKNOWN_ROLE
-        ...(s.capacity != null ? { totalCapacity: s.capacity } : {}),
-      },
-    })),
-  };
-  const r = await req(ctx, "/calendar/v3/bulk/events/create", { body });
-  return (r.results ?? []).map((res) => ({
-    id: res.itemMetadata?.id,
-    success: res.itemMetadata?.success ?? false,
-    error: res.itemMetadata?.error,
-  }));
-}
-
-// Bookings binds a service image by Wix Media file ID — an external url must be imported
-// first; a plan `imagePrompt` is generated (Wix AI, 1 credit) then imported. Both live in the
-// shared util (parallel, resilient, never blocks the seed).
-export { importImage } from "../../shared/seed/images.mjs";
-
-// Writes under media.mainMedia + media.coverMedia (writing media.image 200s but silently drops).
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/update-service.md
-export async function attachServiceImage(ctx, it) {
-  return req(ctx, `/bookings/v2/services/${it.serviceId}`, {
-    method: "PATCH",
-    body: {
-      service: {
-        id: it.serviceId,
-        revision: it.revision,
-        media: { mainMedia: { image: it.image }, coverMedia: { image: it.image } },
-      },
-    },
-  });
-}
-
-/**
- * ONE-CALL seed: install → resolve staff (poll) → categories → services → CLASS sessions →
- * images, ids threaded in memory. The default path.
- */
-export async function setupBookings(ctx, { services = [], staffResourceId } = {}) {
-  await installBookingsApp(ctx);
-
-  let resourceId = staffResourceId;
-  if (!resourceId) {
-    const staff = await queryStaffWithRetry(ctx);
-    resourceId = staff[0]?.resourceId;
-  }
-  if (!resourceId) throw new Error("No staff resource resolved — Bookings provisioning may still be in progress; re-run the seed.");
-
-  const catNames = [...new Set(services.map((s) => s.category).filter(Boolean))];
-  const cats = catNames.length ? await createCategories(ctx, catNames) : await createCategories(ctx, ["Services"]);
-  const catIdByName = new Map(cats.map((c) => [c.name, c.id]));
-  const defaultCatId = cats[0]?.id;
-
-  const created = await createServices(ctx, services.map((s) => ({
-    type: s.type,
-    name: s.name,
-    description: s.description,
-    tagLine: s.tagLine,
-    price: s.price,
-    currency: s.currency,
-    free: s.free,
-    duration: s.duration,
-    capacity: s.capacity,
-    categoryId: (s.category ? catIdByName.get(s.category) : undefined) ?? defaultCatId,
-    staffMemberIds: s.staffMemberIds ?? (s.type === "APPOINTMENT" ? [resourceId] : undefined),
-  })));
-
-  const sessions = [];
-  created.forEach((c, i) => {
-    const plan = services[i];
-    if (c.type === "CLASS" && c.scheduleId && Array.isArray(plan?.sessions)) {
-      for (const ses of plan.sessions) {
-        sessions.push({ scheduleId: c.scheduleId, resourceId, start: ses.start, end: ses.end, capacity: ses.capacity ?? plan.capacity });
-      }
-    }
-  });
-  const scheduled = sessions.length ? await scheduleClassSessions(ctx, sessions) : [];
-
-  // Pass 2 — images: resolve (import by url / generate by prompt) in one parallel wave, then
-  // attach. Failures leave the service text-only; the seed's exit never depends on images.
-  const files = await resolveItemImages(ctx, created.map((c, i) => ({
-    url: services[i]?.imageUrl,
-    path: services[i]?.imagePath,
-    prompt: services[i]?.imagePrompt,
-    displayName: `${c?.slug || "service"}.png`,
-  })));
-  let imagesAttached = 0;
-  for (let i = 0; i < created.length; i++) {
-    if (!files[i] || !created[i]?.id) continue;
-    try {
-      await attachServiceImage(ctx, {
-        serviceId: created[i].id,
-        revision: created[i].revision,
-        image: { id: files[i].id, url: files[i].url, width: 1024, height: 1024 },
-      });
-      imagesAttached++;
-    } catch {
-      /* never block on image failure — the service stays text-only */
-    }
-  }
-
-  return {
-    services: created,
-    categories: cats,
-    resourceId,
-    sessionsScheduled: scheduled.filter((s) => s.success).length,
-    imagesAttached,
-  };
-}
-
-// ---- CLI entry ----------------------------------------------------------------------------------
-
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
-if (invokedDirectly) {
-  const planPath = process.argv[2];
-  if (!planPath) {
-    console.error("usage: node seed-bookings.mjs <plan.json>   (run from the project root)");
-    process.exit(1);
-  }
-  const plan = JSON.parse(readFileSync(planPath, "utf8"));
-  const ctx = makeCtx();
-  setupBookings(ctx, plan)
-    .then((result) => console.log(JSON.stringify(result, null, 2)))
-    .catch((e) => {
-      console.error(e.message);
-      process.exit(1);
-    });
-}