@wix/agent-skills 1.21.0 → 1.23.0

package/skills/wix-headless-fast/references/events/rest/events.ts

@@ -1,57 +0,0 @@
-// Event reads over REST — the twin of app/wix/events/events.ts. Same exports, same DTOs; the rules
-// and mappers come from events-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/events/event-management/events-v3/query-events.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/get-event-by-slug.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/get-event.md
-import { WixApiError, wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { DETAIL_FIELDS, EVENTS_APP_ID, LIST_FIELDS, listQuery, rawId, toDetail, toSummary, type Raw } from "./events-core.js";
-import type { EventDetail, EventSummary } from "./types.js";
-
-export { EVENTS_APP_ID };
-
-const notFound = (e: unknown): boolean => e instanceof WixApiError && e.status === 404;
-
-/**
- * Live (UPCOMING/STARTED) events, soonest first. The limit is always sent: `paging.limit`
- * defaults to 0 and a bare query answers `total: N, events: []` with no error.
- * POST /events/v3/events/query  { query: { filter: { status: { $in } }, sort, paging: { limit } }, fields }
- */
-export async function fetchEvents({ limit = 100 } = {}): Promise<EventSummary[]> {
-  const res = await wixRequest<Raw>("/events/v3/events/query", { body: { query: listQuery({ limit }), fields: LIST_FIELDS } });
-  return ((res?.events ?? []) as Raw[]).map((e) => toSummary(e, imgSrc));
-}
-
-/**
- * One event by URL slug; null when the slug doesn't resolve (EVENT_NOT_FOUND, 404) — a real 404,
- * never a fallback to another event. The response is WRAPPED: { event }.
- * GET /events/v3/events/slug/{slug}?fields=DETAILS&fields=TEXTS&fields=REGISTRATION&fields=URLS&fields=CATEGORIES
- */
-export async function fetchEventBySlug(slug: string): Promise<EventDetail | null> {
-  try {
-    const res = await wixRequest<Raw>(`/events/v3/events/slug/${encodeURIComponent(slug)}`, { method: "GET", query: { fields: DETAIL_FIELDS } });
-    return res?.event ? toDetail(res.event, imgSrc) : null;
-  } catch (e) {
-    if (notFound(e)) return null;
-    throw e;
-  }
-}
-
-/**
- * One event by id — the post-checkout confirmation read (the thank-you URL carries
- * `?orderNumber=&eventId=`). On REST this response is WRAPPED too: { event } (the SDK's getEvent
- * is the unwrapped one).  GET /events/v3/events/{eventId}?fields=…
- */
-export async function fetchEventById(eventId: string): Promise<EventDetail | null> {
-  try {
-    const res = await wixRequest<Raw>(`/events/v3/events/${encodeURIComponent(eventId)}`, { method: "GET", query: { fields: DETAIL_FIELDS } });
-    const raw: Raw | undefined = res?.event;
-    return raw && rawId(raw) ? toDetail(raw, imgSrc) : null;
-  } catch (e) {
-    if (notFound(e)) return null;
-    throw e;
-  }
-}

package/skills/wix-headless-fast/references/events/rest/registration.ts

@@ -1,83 +0,0 @@
-// Ticket tiers, the reserve → hosted-checkout redirect, and RSVP over REST — the twin of
-// app/wix/events/registration.ts. Same exports, same DTOs; rules and mappers from
-// registration-core (the SAME file the SDK transport uses, deployed flat next to this one). The
-// request shapes are exact and rewriting them is how registrations break. Failures are loud.
-// All calls run with the visitor token — the reservation and the RSVP are the token's.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/orders/query-available-tickets.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/ticket-reservations/create-ticket-reservation.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/rsvp-v2/create-rsvp.md
-// docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-import { wixRequest } from "./client.js";
-import {
-  checkoutCallbacks,
-  redirectResult,
-  reservationError,
-  reservationId,
-  reservationTickets,
-  rsvpBody,
-  rsvpResult,
-  toTiers,
-  type CheckoutEvent,
-  type CheckoutPaths,
-} from "./registration-core.js";
-import type { Raw } from "./events-core.js";
-import type { RegistrationResult, TicketTier } from "./types.js";
-
-export { type CheckoutPaths };
-
-/**
- * Ticket tiers for a TICKETING event, in display order — the VISITOR-public storefront read, never
- * the ticket-definitions management API (403 for a visitor). `limit` is REQUIRED: it defaults to 0
- * and returns metadata only.  POST /events/v1/checkout/available-tickets/query  { filter: { eventId }, limit }
- */
-export async function fetchTicketTiers(eventId: string): Promise<TicketTier[]> {
-  const res = await wixRequest<Raw>("/events/v1/checkout/available-tickets/query", { body: { filter: { eventId }, limit: 100 } });
-  return toTiers(res?.definitions);
-}
-
-/**
- * RSVP to a free (RSVP-type) event — completes fully client-side: no reservation, no redirect, no
- * payment. The form is BUILT-IN: exactly firstName + lastName + email. "NO" only when the event's
- * rsvpResponseType is "YES_AND_NO". Throws on closed registration, a guest limit, or an invalid
- * email — surface the message (a repeat email is accepted by default). A full event with a waitlist
- * answers "WAITLIST".
- * POST /events/v2/rsvps  { rsvp: { eventId, firstName, lastName, email, status } }  → { rsvp: { id, status } }
- */
-export async function submitRsvp(
-  eventId: string,
-  guest: { firstName: string; lastName: string; email: string },
-  status: "YES" | "NO" = "YES",
-): Promise<RegistrationResult> {
-  const res = await wixRequest<Raw>("/events/v2/rsvps", { body: { rsvp: rsvpBody(eventId, guest, status) } });
-  return rsvpResult(res?.rsvp, status);
-}
-
-/**
- * Ticketed checkout, the exact sequence: reserve the selected tiers (a PENDING hold that
- * auto-expires), then mint the Wix-hosted checkout redirect and return its URL — the caller
- * navigates the FULL document to it; Wix collects guest details + payment and emails the tickets.
- * `origin` must be the site's real https origin as registered on the OAuth app's allowed domains
- * (browser: window.location.origin). Never hand-build the checkout URL. `paths` overrides the
- * return routes — a static site passes `{ confirmation: "/event-confirmation.html", event: "/event.html?slug=…" }`.
- * POST /events/v1/ticket-reservations  { ticketReservation: { tickets: [{ ticketDefinitionId, quantity }] } }  → { ticketReservation: { id, status: "PENDING", expirationDate } }
- * POST /headless/v1/redirect-session   { eventsCheckout: { reservationId, eventSlug }, callbacks: { thankYouPageUrl, postFlowUrl } }
- */
-export async function startTicketCheckout(
-  event: CheckoutEvent,
-  selections: { tierId: string; quantity: number }[],
-  paths: CheckoutPaths = {},
-  origin: string = typeof window !== "undefined" ? window.location.origin : "",
-): Promise<RegistrationResult> {
-  const tickets = reservationTickets(selections);
-  let reservation: Raw | undefined;
-  try {
-    // Until the site has a premium plan AND a payment method this is a 403 NO_PAYMENT_METHOD_CONFIGURED — a business gate, not a bug.
-    reservation = (await wixRequest<Raw>("/events/v1/ticket-reservations", { body: { ticketReservation: { tickets } } }))?.ticketReservation;
-  } catch (e) {
-    throw reservationError(e);
-  }
-  const session = await wixRequest<Raw>("/headless/v1/redirect-session", {
-    body: { eventsCheckout: { reservationId: reservationId(reservation), eventSlug: event.slug }, callbacks: checkoutCallbacks(origin, event.slug, paths) },
-  });
-  return redirectResult(session);
-}

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

@@ -1,95 +0,0 @@
-# Events — seeding
-
-Seed by **running `seed-events.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 Wix Events app if needed, resolves the site currency, and creates
-everything in the one order that works (create DRAFT → tiers → publish — the registration
-type is immutable and publishing is one-way).
-
-```bash
-# from the project root (where wix.config.json lives):
-node <SKILL_ROOT>/references/events/seed/seed-events.mjs plan.json
-```
-
-`plan.json` is plain data — write it from the brief. **Default to 3 events** (the seed shows
-the shape; the owner adds the rest in the dashboard) and make them exercise the UI: mix
-`TICKETING` and `RSVP` (≥1 of each), give a ticketed event 2 tiers, and give every event an
-image (an events page without images looks broken) — 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 event text-only.
-
-```json
-{
-  "events": [
-    { "type": "TICKETING", "title": "Summer Synth Festival",
-      "shortDescription": "One night of analog sound under the stars.",
-      "startDate": "2026-11-07T03:30:00.000Z", "endDate": "2026-11-07T07:00:00.000Z",
-      "timeZoneId": "America/Los_Angeles",
-      "location": { "name": "The Echo Lot", "type": "VENUE",
-        "address": { "addressLine": "120 Harbor St", "city": "Seattle", "subdivision": "US-WA", "postalCode": "98101", "country": "US" } },
-      "ticketTiers": [
-        { "name": "General Admission", "price": "45.00", "initialLimit": 200 },
-        { "name": "Front Row", "price": "85.00", "description": "First two rows.", "initialLimit": 40 }
-      ],
-      "category": "Concerts", "imageUrl": "https://…" },
-    { "type": "TICKETING", "title": "Vinyl Mixing Workshop",
-      "shortDescription": "Hands-on turntable session, decks provided.",
-      "startDate": "2026-11-14T18:00:00.000Z", "endDate": "2026-11-14T20:00:00.000Z",
-      "timeZoneId": "America/Los_Angeles",
-      "location": { "name": "Studio B", "type": "VENUE",
-        "address": { "addressLine": "9 Pine Ave", "city": "Seattle", "subdivision": "US-WA", "postalCode": "98101", "country": "US" } },
-      "ticketTiers": [{ "name": "Workshop Seat", "price": "30.00", "initialLimit": 16 }],
-      "category": "Workshops", "imageUrl": "https://…" },
-    { "type": "RSVP", "title": "Community Listening Night",
-      "shortDescription": "Free open-deck evening — bring a record.",
-      "startDate": "2026-11-20T19:00:00.000Z", "endDate": "2026-11-20T22:00:00.000Z",
-      "timeZoneId": "America/Los_Angeles",
-      "location": { "name": "The Back Room", "type": "VENUE",
-        "address": { "addressLine": "120 Harbor St", "city": "Seattle", "subdivision": "US-WA", "postalCode": "98101", "country": "US" } },
-      "category": "Community", "imageUrl": "https://…" }
-  ]
-}
-```
-
-- `type` — `TICKETING` (paid tiers; buyers pay on Wix's hosted checkout) or `RSVP` (free;
-  the built-in name+email form — seed NO form fields). **Immutable after create** — decide
-  from the brief, never plan to convert.
-- **Dates are future ISO-8601 UTC** (`…Z`), `endDate` after `startDate`, `timeZoneId` an
-  IANA tz. A past event isn't registerable and won't show in the live listing; no date in
-  the brief → default ~60–90 days out and say so.
-- `ticketTiers` — TICKETING only, created before publish. `price` is a **decimal STRING**
-  (`"45.00"`, never a number), `name` ≤ 30 chars, omit `initialLimit` for unlimited. Tier
-  currency is the site currency (resolved automatically).
-- `location` — `{ name, type: "VENUE", address }` (address `subdivision` is ISO-3166-2 like
-  `US-WA`, `country` ISO alpha-2), `{ name, type: "ONLINE" }`, or
-  `{ locationTbd: true, name }`.
-- `category` — a name; created and assigned for you. Skip when the brief has no grouping.
-- `rsvpResponseType` — `"YES_AND_NO"` to let guests decline (default `"YES_ONLY"`).
-
-The result JSON carries a `notes` array — when any event is ticketed it reminds that
-**completing a paid purchase needs a premium plan + a configured payment method** in the
-dashboard. That's an owner step, not a seeding failure; relay it.
-
-**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 events, each event the user
-lists is one entry. Its title becomes `title`; its date and time become `startDate` and `endDate` in
-ISO with the `timeZoneId` the user stated; the venue and address become `location`; named tickets
-with prices become `ticketTiers` on a `TICKETING` event, and an event with no tickets is `RSVP`; a
-category becomes `category`; their image becomes `imageUrl`. A date without a year or without a
-time zone is a question for the user, never a guess.
-
-## Escape hatch — individual functions
-`setupEvents` composes exported steps — `installEventsApp`, `getSiteCurrency`, `createEvent`,
-`createTicketTiers`, `publishEvent`, `createEventCategories`, `assignEventsToCategory`,
-`importImage`, `setEventMainImage`, 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-events.md`.

package/skills/wix-headless-fast/references/events/seed/read-site.mjs

@@ -1,26 +0,0 @@
-// What the events site holds: events and their ticket definitions.
-//   node <SKILL_ROOT>/references/events/seed/read-site.mjs [--site <siteId>] [--limit <n>]
-import { runReader } from "../../shared/seed/read-site.mjs";
-
-const EVENTS_APP_ID = "140603ad-af8d-84a5-2c80-a0f60cb47351";
-const D = "https://dev.wix.com/docs/api-reference/business-solutions/events/event-management";
-
-await runReader({
-  vertical: "events",
-  appId: EVENTS_APP_ID,
-  async read(api, { limit }) {
-    const ev = await api.call({ path: "/events/v3/events/query", body: { query: { filter: { status: { $ne: "CANCELED" } }, paging: { limit } }, fields: ["DETAILS", "REGISTRATION"] }, docs: `${D}/events-v3/query-events` });
-    const td = await api.tryCall({ path: "/events-ticket-definitions/v3/ticket-definitions/query", body: { query: { paging: { limit: 100 } } }, docs: `${D}/ticket-definitions-v3/query-ticket-definitions` });
-    const defs = td?.ticketDefinitions ?? [];
-    return {
-      eventCount: ev.pagingMetadata?.total ?? (ev.events ?? []).length,
-      events: (ev.events ?? []).map((e) => ({
-        title: e.title, slug: e.slug, status: e.status, start: e.dateAndTimeSettings?.startDate ?? null,
-        location: e.location?.name ?? e.location?.type ?? null, registration: e.registration?.type ?? null,
-        tickets: defs.filter((d) => d.eventId === e.id).map((d) => `${d.name}${d.pricingMethod?.fixedPrice?.formattedValue ? " " + d.pricingMethod.fixedPrice.formattedValue : ""}`),
-        image: !!e.mainImage,
-      })),
-      ticketDefinitionCount: defs.length,
-    };
-  },
-});

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

@@ -1,276 +0,0 @@
-// Events 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/events/seed/seed-events.mjs plan.json
-//
-// It mints its own site token via the Wix CLI, installs the Wix Events app if needed,
-// resolves the site currency, then per event: create DRAFT → (TICKETING) add ticket tiers →
-// publish — the order two one-way constraints force (registration.initialType is immutable
-// after create; publishing is one-way). Then it creates + assigns categories and
-// imports+attaches images. Prints a JSON result to stdout.
-//
-// Plan shape (see SEED.md):
-//   { "events": [{ "title", "shortDescription"?, "type": "TICKETING"|"RSVP",
-//                  "startDate", "endDate" (future ISO-8601 UTC), "timeZoneId",
-//                  "location" ({name,type:"VENUE",address} | {name,type:"ONLINE"} | {locationTbd:true,name}),
-//                  "ticketTiers"?: [{ "name" (≤30 chars), "price" (decimal STRING), "description"?, "initialLimit"? }],
-//                  "category"? (name), "imageUrl"? | "imagePrompt"?, "rsvpResponseType"? }] }
-//
-// 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-events.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 EVENTS_APP_ID = "140603ad-af8d-84a5-2c80-a0f60cb47351";
-
-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;
-}
-
-// {type:"TICKETING"|"RSVP", …} -> the registration block. TICKETING carries a tickets{}
-// config; RSVP carries rsvp{responseType} and seeds NO form fields (name+email is built-in).
-// initialType is IMMUTABLE after create — set from the plan, never plan to convert.
-function buildRegistration(ev) {
-  if (ev.type === "TICKETING") {
-    return {
-      initialType: "TICKETING",
-      tickets: {
-        ticketLimitPerOrder: ev.ticketLimitPerOrder ?? 8,
-        currency: ev.currency ?? "USD", // setupEvents threads the site currency; USD is the last resort
-        reservationDurationInMinutes: ev.reservationDurationInMinutes ?? 20,
-      },
-    };
-  }
-  return {
-    initialType: "RSVP",
-    rsvp: { responseType: ev.rsvpResponseType ?? "YES_ONLY" }, // "YES_ONLY" | "YES_AND_NO"
-  };
-}
-
-// ---- operations ----------------------------------------------------------------------------------
-
-// Idempotent: re-installing an already-installed app returns 200.
-// docs: https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix.md
-export async function installEventsApp(ctx) {
-  try {
-    await req(ctx, "/apps-installer-service/v1/app-instance/install", { body: {
-      tenant: { tenantType: "SITE", id: ctx.siteId },
-      appInstance: { appDefId: EVENTS_APP_ID, enabled: true },
-    } });
-  } catch {
-    /* already installed is fine */
-  }
-}
-
-// The ticket-definitions API REQUIRES currency and uses whatever you pass verbatim (it does
-// NOT fall back to the site currency) — resolve it once, or a non-USD site gets mis-priced.
-// docs: https://dev.wix.com/docs/api-reference/business-management/site-properties/properties/get-site-properties.md
-export async function getSiteCurrency(ctx) {
-  try {
-    const r = await req(ctx, "/site-properties/v4/properties", { method: "GET" });
-    return r?.properties?.paymentCurrency || "USD";
-  } catch {
-    return "USD";
-  }
-}
-
-/**
- * STEP 1 — create ONE event as a draft (no bulk endpoint; loop for multiple). Dates MUST be
- * in the future — a past event isn't registerable and won't show in the live listing.
- * Returns { id, slug } — id feeds the tier/publish steps; slug is the URL identifier.
- * docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/create-event.md
- */
-export async function createEvent(ctx, ev) {
-  const body = {
-    draft: true,
-    event: {
-      title: ev.title,
-      shortDescription: ev.shortDescription,
-      location: ev.location,
-      dateAndTimeSettings: {
-        startDate: ev.startDate,
-        endDate: ev.endDate,
-        timeZoneId: ev.timeZoneId,
-        showTimeZone: ev.showTimeZone ?? true,
-      },
-      registration: buildRegistration(ev),
-    },
-    fields: ["DETAILS", "TEXTS", "REGISTRATION", "URLS"],
-  };
-  const r = await req(ctx, "/events/v3/events", { body });
-  return { id: r.event?.id, slug: r.event?.slug };
-}
-
-/**
- * STEP 2 — ticket tiers for a TICKETING event (skip for RSVP). Must run BEFORE publish —
- * publishing a ticketed event with no tiers ships an event with nothing to buy, and there is
- * no un-publish. price is a decimal STRING ("65.00", never a number); name ≤ 30 chars; omit
- * initialLimit for unlimited. Tiers are independent — fired as one parallel batch.
- * docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/ticket-definitions-v3/create-ticket-definition.md
- */
-export async function createTicketTiers(ctx, eventId, tiers) {
-  return Promise.all(tiers.map(async (t) => {
-    const body = {
-      ticketDefinition: {
-        eventId,
-        name: t.name,
-        description: t.description,
-        ...(t.initialLimit != null ? { initialLimit: t.initialLimit } : {}),
-        pricingMethod: { fixedPrice: { value: String(t.price), currency: t.currency ?? "USD" } },
-        feeType: t.feeType ?? "FEE_INCLUDED",
-      },
-      fields: ["SALES_DETAILS"],
-    };
-    const r = await req(ctx, "/events/v3/ticket-definitions", { body });
-    return { id: r.ticketDefinition?.id };
-  }));
-}
-
-// STEP 3 — publish (one-way; for TICKETING only after its tiers exist).
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/publish-draft-event.md
-export async function publishEvent(ctx, eventId) {
-  return req(ctx, `/events/v3/events/${eventId}/publish`, { body: {} });
-}
-
-// STEP 4 (optional) — group events by a format/track. Categories are the v1 API (NOT v3).
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/create-category.md
-export async function createEventCategories(ctx, names) {
-  const out = [];
-  for (const name of names) {
-    const r = await req(ctx, "/events/v1/categories", { body: { category: { name } } });
-    out.push({ id: r.category?.id, name });
-  }
-  return out;
-}
-
-// Assign events to a category. Path is /{categoryId}/events (NOT /assign); body key is
-// `eventId` — an ARRAY despite the singular name.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/assign-events.md
-export async function assignEventsToCategory(ctx, categoryId, eventIds) {
-  return req(ctx, `/events/v1/categories/${categoryId}/events`, { body: { eventId: eventIds } });
-}
-
-// Events binds mainImage by Wix Media file ID — an external url must be imported first
-// (a raw url as the id stores 200 but renders nothing); 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";
-
-// mainImage is an Image OBJECT; height/width are REQUIRED or it won't render. Events V3 uses
-// NO revision — partial PATCH keyed by event.id. Works before OR after publish.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/events-v3/update-event.md
-export async function setEventMainImage(ctx, it) {
-  return req(ctx, `/events/v3/events/${it.eventId}`, {
-    method: "PATCH",
-    body: {
-      event: {
-        id: it.eventId,
-        mainImage: { id: it.id, url: it.url, height: it.height ?? 1024, width: it.width ?? 1024, altText: it.altText },
-      },
-      fields: ["DETAILS"], // mainImage reads back only under DETAILS
-    },
-  });
-}
-
-/**
- * ONE-CALL seed: install → site currency → per event create DRAFT → tiers → publish →
- * categories → images, ids threaded in memory. The default path.
- */
-export async function setupEvents(ctx, { events = [] } = {}) {
-  await installEventsApp(ctx);
-  const siteCurrency = await getSiteCurrency(ctx);
-
-  const created = [];
-  for (const ev of events) {
-    const e = await createEvent(ctx, { ...ev, currency: ev.currency ?? siteCurrency });
-    if (!e.id) throw new Error(`Event "${ev.title}" was not created — no id returned.`);
-    const tiers = ev.type === "TICKETING" && ev.ticketTiers?.length
-      ? await createTicketTiers(ctx, e.id, ev.ticketTiers.map((t) => ({ ...t, currency: t.currency ?? siteCurrency })))
-      : [];
-    await publishEvent(ctx, e.id);
-    created.push({ ...e, category: ev.category, imageUrl: ev.imageUrl, imagePrompt: ev.imagePrompt, ticketCount: tiers.length });
-  }
-
-  const names = [...new Set(created.map((e) => e.category).filter(Boolean))];
-  const categories = names.length ? await createEventCategories(ctx, names) : [];
-  for (const c of categories) {
-    const eventIds = created.filter((e) => e.category === c.name).map((e) => e.id);
-    if (eventIds.length) await assignEventsToCategory(ctx, c.id, eventIds);
-  }
-
-  // Pass 2 — images: resolve (import by url / generate by prompt) in one parallel wave, then
-  // attach. Failures leave the event text-only; the seed's exit never depends on images.
-  const files = await resolveItemImages(ctx, created.map((e) => ({
-    url: e.imageUrl,
-    path: e.imagePath,
-    prompt: e.imagePrompt,
-    displayName: `${e.slug || "event"}.png`,
-  })));
-  let imagesAttached = 0;
-  for (let i = 0; i < created.length; i++) {
-    const e = created[i];
-    if (!files[i]) continue;
-    try {
-      await setEventMainImage(ctx, { eventId: e.id, id: files[i].id, url: files[i].url, height: 1024, width: 1024, altText: e.slug });
-      imagesAttached++;
-    } catch {
-      /* never block on image failure — the event stays text-only */
-    }
-  }
-
-  return {
-    events: created.map((e) => ({ id: e.id, slug: e.slug, ticketCount: e.ticketCount, category: e.category ?? null })),
-    categories,
-    imagesAttached,
-    // Completing a PAID purchase needs a premium plan + a configured payment method in the
-    // dashboard — not a seeding failure; surface it to the owner. Free/RSVP need neither.
-    notes: created.some((e) => e.ticketCount > 0)
-      ? ["Paid tickets require a premium plan + a configured payment method in the dashboard to complete a purchase."]
-      : [],
-  };
-}
-
-// ---- 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-events.mjs <plan.json>   (run from the project root)");
-    process.exit(1);
-  }
-  const plan = JSON.parse(readFileSync(planPath, "utf8"));
-  const ctx = makeCtx();
-  setupEvents(ctx, plan)
-    .then((result) => console.log(JSON.stringify(result, null, 2)))
-    .catch((e) => {
-      console.error(e.message);
-      process.exit(1);
-    });
-}