@wix/agent-skills 1.20.1 → 1.22.0

package/skills/wix-headless-fast/references/events/app/components/events/EventsView.tsx

@@ -1,118 +0,0 @@
-// REFERENCE listing surface: category filter + events grid on the @theme tokens.
-// Correct and complete; per the skill's model you design and build your own on useEvents.
-import type { ComponentType, ReactNode } from "react";
-import { useEvents } from "../../hooks/events/useEvents";
-import { imgAttrs } from "../../wix/media";
-import type { EventSummary } from "../../wix/events/types";
-
-export interface LinkLikeProps {
-  href: string;
-  className?: string;
-  children?: ReactNode;
-}
-
-const PlainLink = ({ href, className, children }: LinkLikeProps) => (
-  <a href={href} className={className}>
-    {children}
-  </a>
-);
-
-export interface EventCardProps {
-  event: EventSummary;
-  eventHref?: (slug: string) => string;
-  LinkComponent?: ComponentType<LinkLikeProps>;
-}
-
-export function EventCard({
-  event,
-  eventHref = (slug) => `/events/${slug}`,
-  LinkComponent = PlainLink,
-}: EventCardProps) {
-  return (
-    <LinkComponent href={eventHref(event.slug)} className="group block no-underline">
-      <div className="relative aspect-[3/2] overflow-hidden rounded-lg bg-secondary">
-        {event.imageUrl && (
-          <img
-            {...imgAttrs(event.imageUrl, "(min-width: 1024px) 33vw, (min-width: 640px) 50vw, 100vw", 2 / 3)}
-            alt={event.title}
-            className="h-full w-full object-cover transition-transform duration-300 group-hover:scale-[1.03]"
-          />
-        )}
-        {event.soldOut && (
-          <span className="absolute left-3 top-3 rounded-full bg-background/90 px-3 py-1 text-xs font-semibold text-foreground backdrop-blur">
-            Sold out
-          </span>
-        )}
-      </div>
-      {event.dateLabel && <p className="eyebrow mt-3">{event.dateLabel}</p>}
-      <p className="mt-1 text-sm font-medium text-foreground">{event.title}</p>
-      <p className="mt-0.5 text-xs text-muted-foreground">
-        {event.locationType === "ONLINE" ? "Online" : event.locationName}
-        {event.priceLabel ? ` · ${event.priceLabel}` : ""}
-      </p>
-    </LinkComponent>
-  );
-}
-
-export interface EventsViewProps {
-  initialEvents?: EventSummary[];
-  emptyMessage?: string;
-  eventHref?: EventCardProps["eventHref"];
-  LinkComponent?: ComponentType<LinkLikeProps>;
-  CardComponent?: ComponentType<EventCardProps>;
-}
-
-const pill = (active: boolean) =>
-  `rounded-full border px-4 py-1.5 text-sm font-medium transition-colors ${
-    active
-      ? "border-primary bg-primary text-primary-foreground"
-      : "border-border text-foreground hover:bg-secondary"
-  }`;
-
-export default function EventsView({
-  initialEvents,
-  emptyMessage = "No upcoming events — check back soon.",
-  eventHref,
-  LinkComponent,
-  CardComponent = EventCard,
-}: EventsViewProps) {
-  const { events, categories, activeCategoryId, setActiveCategoryId, error } = useEvents({
-    initialEvents,
-  });
-
-  return (
-    <div>
-      {categories.length > 1 && (
-        <div className="mb-8 flex flex-wrap gap-2" role="group" aria-label="Categories">
-          <button type="button" className={pill(activeCategoryId === null)} onClick={() => setActiveCategoryId(null)}>
-            All
-          </button>
-          {categories.map((c) => (
-            <button key={c.id} type="button" className={pill(activeCategoryId === c.id)} onClick={() => setActiveCategoryId(c.id)}>
-              {c.name}
-            </button>
-          ))}
-        </div>
-      )}
-      {error && <p className="mb-4 text-sm text-red-600">{error}</p>}
-      {events === null ? (
-        <div className="grid grid-cols-1 gap-8 sm:grid-cols-2 lg:grid-cols-3" aria-busy="true">
-          {Array.from({ length: 6 }, (_, i) => (
-            <div key={i}>
-              <div className="aspect-[3/2] animate-pulse rounded-lg bg-secondary" />
-              <div className="mt-3 h-3.5 w-2/3 animate-pulse rounded bg-secondary" />
-            </div>
-          ))}
-        </div>
-      ) : events.length === 0 ? (
-        <p className="py-16 text-center text-muted-foreground">{emptyMessage}</p>
-      ) : (
-        <div className="grid grid-cols-1 gap-8 sm:grid-cols-2 lg:grid-cols-3">
-          {events.map((e) => (
-            <CardComponent key={e.id} event={e} eventHref={eventHref} LinkComponent={LinkComponent} />
-          ))}
-        </div>
-      )}
-    </div>
-  );
-}

package/skills/wix-headless-fast/references/events/app/hooks/events/useEventRegistration.ts

@@ -1,35 +0,0 @@
-// React binding of the registration store (wix/events/registration-store.ts) — the whole
-// registration state machine for one event lives there, framework-free, branched on
-// event.registrationType: TICKETING loads the tier picker and checkout() reserves → redirects to
-// Wix's hosted checkout; RSVP is the built-in name+email form submitted in place. All correctness
-// (the visitor-public tier read, the reservation payload, the redirect callbacks, rsvpV2) lives
-// in the data layer; you own how it looks. One store per event — a new event id gets a fresh one.
-import { useEffect, useRef, useSyncExternalStore } from "react";
-import {
-  createRegistrationStore,
-  type RegistrationState,
-  type RegistrationStore,
-} from "../../wix/events/registration-store";
-import type { EventDetail } from "../../wix/events/types";
-
-export type UseEventRegistration = RegistrationState &
-  Pick<RegistrationStore, "setQuantity" | "setRsvpValue" | "checkout" | "rsvp">;
-
-export function useEventRegistration(event: EventDetail): UseEventRegistration {
-  const key = `${event.id}:${event.registrationType}`;
-  const ref = useRef<{ key: string; store: RegistrationStore } | null>(null);
-  if (!ref.current || ref.current.key !== key) ref.current = { key, store: createRegistrationStore(event) };
-  const store = ref.current.store;
-  useEffect(() => {
-    store.start();
-    return () => store.stop();
-  }, [store]);
-  const state = useSyncExternalStore(store.subscribe, store.getState, store.getState);
-  return {
-    ...state,
-    setQuantity: store.setQuantity,
-    setRsvpValue: store.setRsvpValue,
-    checkout: store.checkout,
-    rsvp: store.rsvp,
-  };
-}

package/skills/wix-headless-fast/references/events/app/hooks/events/useEvents.ts

@@ -1,24 +0,0 @@
-// React binding of the events store (wix/events/events-store.ts) — the listing state machine
-// lives there, framework-free; this hook subscribes to one instance per mounted listing and
-// exposes its state and actions under one name. SSR-friendly: pass server-fetched data as
-// `initialEvents` (Astro frontmatter / server component) and no client fetch happens; a SPA
-// passes nothing. Astro islands and React SPAs use this; a static page, Vue, or Svelte uses the
-// store directly.
-import { useEffect, useRef, useSyncExternalStore } from "react";
-import { createEventsStore, type EventsState, type EventsStore, type EventsStoreOptions } from "../../wix/events/events-store";
-
-export type UseEventsOptions = EventsStoreOptions;
-
-export type UseEvents = EventsState & Pick<EventsStore, "setActiveCategoryId">;
-
-export function useEvents(options: UseEventsOptions = {}): UseEvents {
-  const ref = useRef<EventsStore | null>(null);
-  if (!ref.current) ref.current = createEventsStore(options);
-  const store = ref.current;
-  useEffect(() => {
-    store.start();
-    return () => store.stop();
-  }, [store]);
-  const state = useSyncExternalStore(store.subscribe, store.getState, store.getState);
-  return { ...state, setActiveCategoryId: store.setActiveCategoryId };
-}

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

@@ -1,130 +0,0 @@
-// Event rules and DTO mapping — transport-agnostic, imported by BOTH transports: ./events.ts (the
-// SDK, managed Astro and React) and the REST twin in references/events/rest/events.ts (fetch, a
-// static site or a port to another language). Every rule about statuses, fieldsets, prices,
-// dates, images and categories lives HERE, once. A raw event may come from the SDK (`_id`,
-// mainImage as a wix:image string) or from REST (`id`, mainImage as { id, url }); the mappers
-// accept both. Imports are type-only so a strip to JS emits no imports.
-import type { EventDetail, EventSummary, RegistrationType } from "./types";
-
-/** A raw Events V3 entity as either transport returns it. */
-export type Raw = Record<string, any>;
-/** Media value + size → https URL. Injected: the SDK transport scales through @wix/sdk, REST through the URL form. */
-export type ImgSrc = (value: any, width: number, height: number) => string;
-
-/** The Wix Events app id (reference only — frontend calls need no app-id constant). */
-export const EVENTS_APP_ID = "140603ad-af8d-84a5-2c80-a0f60cb47351";
-
-export const rawId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-// Fieldsets are opt-in: without REGISTRATION there's no registration type to branch on;
-// without CATEGORIES the category names never arrive; DETAILS carries the formatted date
-// and mainImage; TEXTS carries the long description; URLS the Wix event page url.
-export const LIST_FIELDS = ["DETAILS", "REGISTRATION", "CATEGORIES"] as const;
-export const DETAIL_FIELDS = ["DETAILS", "TEXTS", "REGISTRATION", "URLS", "CATEGORIES"] as const;
-
-/** Only these are listed and linked — a past or canceled event isn't registerable. */
-export const LIVE_STATUSES = ["UPCOMING", "STARTED"] as const;
-export const START_DATE_FIELD = "dateAndTimeSettings.startDate";
-
-/**
- * The Query Events body for the listing: live statuses, soonest first, a positive limit.
- * `paging.limit` defaults to 0 — a bare query answers `total: 2, events: []` with no error — so
- * the limit is always sent. The SDK builder spells the same three parts.
- */
-export function listQuery({ limit = 100 } = {}): Raw {
-  if (!Number.isInteger(limit) || limit < 1 || limit > 1000) throw new Error("limit must be between 1 and 1000.");
-  return {
-    filter: { status: { $in: [...LIVE_STATUSES] } },
-    sort: [{ fieldName: START_DATE_FIELD, order: "ASC" }],
-    paging: { limit },
-  };
-}
-
-/** "From €45" (ticketed), "Free" (RSVP / free tickets), "" when nothing applies. */
-export function lowestPriceLabel(reg: Raw): string {
-  const type = reg.type ?? reg.initialType;
-  if (type === "RSVP") return "Free";
-  if (type !== "TICKETING") return "";
-  const lowest: Raw | undefined = reg.tickets?.lowestPrice;
-  if (!lowest) return "";
-  if (Number(lowest.value ?? 0) === 0) return "Free";
-  if (lowest.formattedValue) return `From ${lowest.formattedValue}`;
-  try {
-    return `From ${new Intl.NumberFormat(undefined, { style: "currency", currency: lowest.currency || "USD" }).format(Number(lowest.value))}`;
-  } catch {
-    return `From ${lowest.value} ${lowest.currency ?? ""}`.trim();
-  }
-}
-
-// event.description is Ricos rich content ({ nodes: [...] }), NOT a string — calling string
-// methods on it crashes the page. Extract plain paragraphs; detailedDescription (legacy plain
-// text) is the fallback.
-export function toParagraphs(rich: Raw | undefined | null, legacy: string | undefined): string[] {
-  const collect = (nodes: Raw[] | undefined): string =>
-    (nodes ?? [])
-      .map((n: Raw) => (typeof n.textData?.text === "string" ? n.textData.text : collect(n.nodes)))
-      .join("");
-  const out: string[] = [];
-  for (const node of rich?.nodes ?? []) {
-    const text = collect([node]).trim();
-    if (text) out.push(text);
-  }
-  if (!out.length && legacy) out.push(legacy);
-  return out;
-}
-
-/**
- * The main image in the form imgSrc scales: the SDK carries it as a `wix:image://` string; REST
- * as `{ id, url, altText }` — rebuilt into the id form so both transports resolve one URL shape.
- */
-export function mainImageOf(raw: Raw): unknown {
-  const m = raw.mainImage;
-  if (m && typeof m === "object" && typeof m.id === "string" && m.id) {
-    return `wix:image://v1/${m.id}/${encodeURIComponent(String(m.altText || "image"))}`;
-  }
-  return m;
-}
-
-export function toSummary(raw: Raw, imgSrc: ImgSrc): EventSummary {
-  const reg: Raw = raw.registration ?? {};
-  const dts: Raw = raw.dateAndTimeSettings ?? {};
-  return {
-    id: rawId(raw), // _id on the SDK, id on REST — never a bare .id on the SDK (undefined there)
-    slug: raw.slug ?? "",
-    title: raw.title ?? "",
-    shortDescription: raw.shortDescription ?? "",
-    dateLabel: dts.formatted?.dateAndTime ?? "",
-    startDateIso: dts.startDate ? new Date(dts.startDate).toISOString() : "",
-    locationName: raw.location?.name ?? "",
-    locationType: raw.location?.locationTbd
-      ? "TBD"
-      : ((raw.location?.type as "VENUE" | "ONLINE") ?? "TBD"),
-    imageUrl: imgSrc(mainImageOf(raw), 1200, 800),
-    // `type` is the current flavor (can become EXTERNAL later); initialType is the immutable
-    // seeded one — read type first.
-    registrationType: (reg.type ?? reg.initialType ?? "NONE") as RegistrationType,
-    priceLabel: lowestPriceLabel(reg),
-    // The API reports tickets.soldOut true on an RSVP event too (it has no tickets at all) — sold
-    // out is a ticketing signal only.
-    soldOut: (reg.type ?? reg.initialType) === "TICKETING" && reg.tickets?.soldOut === true,
-    // `categories` is absent on the typed Event (an SDK type gap) — the Raw boundary reads
-    // the runtime field the CATEGORIES fieldset populates.
-    categories: ((raw.categories?.categories ?? []) as Raw[])
-      .map((c) => ({ id: rawId(c), name: c.name ?? "" }))
-      .filter((c) => c.id),
-  };
-}
-
-export function toDetail(raw: Raw, imgSrc: ImgSrc): EventDetail {
-  const summary = toSummary(raw, imgSrc);
-  const reg: Raw = raw.registration ?? {};
-  return {
-    ...summary,
-    aboutParagraphs: toParagraphs(raw.description, raw.detailedDescription),
-    // Only OPEN_* statuses (OPEN_RSVP, OPEN_TICKETS, OPEN_EXTERNAL, …) accept registrations.
-    registrationOpen: typeof reg.status === "string" && reg.status.startsWith("OPEN_"),
-    rsvpResponseType: reg.rsvp?.responseType === "YES_AND_NO" ? "YES_AND_NO" : "YES_ONLY",
-    externalUrl: reg.external?.url ?? "",
-    addToCalendar: { google: raw.calendarUrls?.google ?? "", ics: raw.calendarUrls?.ics ?? "" },
-  };
-}

package/skills/wix-headless-fast/references/events/app/wix/events/events-store.ts

@@ -1,97 +0,0 @@
-// The events listing as a framework-free store — the logic behind useEvents, usable from React
-// (useEvents wraps it with useSyncExternalStore), from a static page or Vue/Svelte (subscribe and
-// render), or as the specification for a port. State, actions, subscribe/getState, emit after
-// every change.
-//
-// SSR-friendly: seed with `initialEvents` and they render at once with no client fetch; a SPA
-// passes nothing and `start()` fetches. The category menu is DERIVED from the loaded events (the
-// categories management API is admin-scope — visitors can't query it); filtering is client-side
-// over the live list, which is small by definition (only UPCOMING/STARTED events are listed).
-//
-// One store per mounted listing (a page can hold the index and a "next up" rail):
-// createEventsStore(), not a singleton.
-import { fetchEvents } from "./events";
-import type { EventSummary } from "./types";
-
-export interface EventsStoreOptions {
-  initialEvents?: EventSummary[];
-}
-
-/** Everything a listing surface renders from. Read it with getState() or through a subscription. */
-export interface EventsState {
-  /** null while the first load is in flight — render skeletons, not an empty state. */
-  events: EventSummary[] | null;
-  /** Unique assigned categories in listing order — render a filter bar only when > 1. */
-  categories: { id: string; name: string }[];
-  activeCategoryId: string | null;
-  error: string | null;
-}
-
-export interface EventsStore {
-  getState(): EventsState;
-  subscribe(listener: () => void): () => void;
-  /** Fetch when no `initialEvents` were given. Call once when mounted (a browser). */
-  start(): void;
-  /** Stop reacting; drop a late response. */
-  stop(): void;
-  setActiveCategoryId(id: string | null): void;
-}
-
-export function createEventsStore({ initialEvents }: EventsStoreOptions = {}): EventsStore {
-  let all: EventSummary[] | null = initialEvents ?? null;
-  let activeCategoryId: string | null = null;
-  let error: string | null = null;
-  let started = false;
-  const listeners = new Set<() => void>();
-  let snapshot: EventsState | null = null;
-  const emit = () => {
-    snapshot = null;
-    for (const fn of listeners) fn();
-  };
-
-  function getState(): EventsState {
-    if (snapshot) return snapshot;
-    const seen = new Map<string, string>();
-    for (const e of all ?? []) for (const c of e.categories) if (!seen.has(c.id)) seen.set(c.id, c.name);
-    snapshot = {
-      events: all === null ? null : activeCategoryId ? all.filter((e) => e.categories.some((c) => c.id === activeCategoryId)) : all,
-      categories: [...seen.entries()].map(([id, name]) => ({ id, name })),
-      activeCategoryId,
-      error,
-    };
-    return snapshot;
-  }
-
-  return {
-    getState,
-    subscribe(fn) {
-      listeners.add(fn);
-      return () => listeners.delete(fn);
-    },
-    start() {
-      if (started) return;
-      started = true;
-      if (initialEvents) return;
-      fetchEvents()
-        .then((list) => {
-          if (!started) return;
-          all = list;
-          emit();
-        })
-        .catch((e) => {
-          if (!started) return;
-          all = [];
-          error = e instanceof Error ? e.message : String(e);
-          emit();
-        });
-    },
-    stop() {
-      started = false;
-    },
-    setActiveCategoryId(id) {
-      if (id === activeCategoryId) return;
-      activeCategoryId = id;
-      emit();
-    },
-  };
-}

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

@@ -1,55 +0,0 @@
-// Event reads (Wix Events V3, the `wixEventsV2` module) over the SDK — the only file that touches
-// raw event entities on this transport. Everything it returns is a plain DTO from ./types. The
-// rules and mappers live in ./events-core (shared with the REST twin in references/events/rest/);
-// this file is the transport only. Copy as-is; extend by adding functions, not by editing these.
-// 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
-import { wixEventsV2 } from "@wix/events";
-import { wixModule } from "../sdk";
-import { imgSrc } from "../media";
-import { DETAIL_FIELDS, EVENTS_APP_ID, LIST_FIELDS, LIVE_STATUSES, START_DATE_FIELD, rawId, toDetail, toSummary, type Raw } from "./events-core";
-import type { EventDetail, EventSummary } from "./types";
-
-export { EVENTS_APP_ID };
-
-const events = wixModule(wixEventsV2);
-
-/** List live (UPCOMING/STARTED) events, soonest first, mapped to grid-ready DTOs. */
-export async function fetchEvents({ limit = 100 } = {}): Promise<EventSummary[]> {
-  // The query builder, never a flat/REST `{ query: {...} }` body (the SDK silently ignores
-  // the unknown key and returns zero events). Always set a positive limit — it defaults to 0,
-  // which also returns zero events with no error.
-  const res = await events
-    .queryEvents({ fields: LIST_FIELDS as any })
-    .in("status", [...LIVE_STATUSES]) // never list or link a past event — it isn't registerable
-    .ascending(START_DATE_FIELD as any)
-    .limit(limit)
-    .find();
-  return (res.items ?? []).map((e: Raw) => toSummary(e, imgSrc));
-}
-
-/** Fetch one event by its URL slug. Null when not found. */
-export async function fetchEventBySlug(slug: string): Promise<EventDetail | null> {
-  try {
-    // getEventBySlug returns a WRAPPED { event } — unlike getEvent below.
-    const res: Raw = await events.getEventBySlug(slug, { fields: DETAIL_FIELDS as any });
-    const raw = res?.event;
-    return raw ? toDetail(raw as Raw, imgSrc) : null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Fetch one event by id — the post-checkout confirmation read (the thank-you URL carries
- * `?orderNumber=&eventId=`). getEvent returns the Event DIRECTLY (unwrapped) — the one read
- * that isn't `{ event }`; assuming the wrapper crashes the page.
- */
-export async function fetchEventById(eventId: string): Promise<EventDetail | null> {
-  try {
-    const raw: Raw = await events.getEvent(eventId, { fields: DETAIL_FIELDS as any });
-    return rawId(raw) ? toDetail(raw, imgSrc) : null;
-  } catch {
-    return null;
-  }
-}

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

@@ -1,113 +0,0 @@
-// Registration rules and DTO mapping — transport-agnostic, imported by both ./registration.ts
-// (SDK) and the REST twin in references/events/rest/registration.ts (fetch). Tier mapping, the
-// reservation line items, the payment gate, the checkout callbacks, and the RSVP body live HERE,
-// once. Raw ticket definitions carry `_id` (SDK) or `id` (REST). Type-only imports so a strip
-// to JS emits none.
-import type { EventDetail, RegistrationResult, TicketTier } from "./types";
-import type { Raw } from "./events-core";
-
-const tierId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-export function formatTierPrice(price: Raw | undefined): string {
-  const value = price?.amount ?? price?.value;
-  if (value == null || value === "") return "";
-  try {
-    return new Intl.NumberFormat(undefined, { style: "currency", currency: price?.currency || "USD" }).format(Number(value));
-  } catch {
-    return `${value} ${price?.currency ?? ""}`.trim();
-  }
-}
-
-export function toTier(raw: Raw): TicketTier {
-  const free = raw.free === true || Number(raw.price?.amount ?? raw.price?.value ?? 0) === 0;
-  return {
-    id: tierId(raw),
-    name: raw.name ?? "",
-    description: raw.description ?? "",
-    price: free ? "Free" : formatTierPrice(raw.price),
-    free,
-    limitPerCheckout: raw.limitPerCheckout ?? 20,
-    saleStatus: (raw.saleStatus ?? "SALE_STARTED") as TicketTier["saleStatus"],
-  };
-}
-
-/** Tiers in display order (orderIndex), skipping any without an id. */
-export function toTiers(definitions: Raw[] | undefined): TicketTier[] {
-  return (definitions ?? [])
-    .slice()
-    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))
-    .map(toTier)
-    .filter((t) => t.id);
-}
-
-/** The reservation's line items from the picker's selections; throws when nothing is picked. */
-export function reservationTickets(selections: { tierId: string; quantity: number }[]): { ticketDefinitionId: string; quantity: number }[] {
-  const tickets = selections
-    .filter((s) => s.quantity > 0)
-    .map((s) => ({ ticketDefinitionId: s.tierId, quantity: s.quantity }));
-  if (!tickets.length) throw new Error("Pick at least one ticket first.");
-  return tickets;
-}
-
-/**
- * The real gate on paid tickets: until the site has a premium plan AND a configured payment
- * method, reserving fails 403 NO_PAYMENT_METHOD_CONFIGURED. Not a permissions bug — don't
- * elevate (that just creates an unpayable order); surface it softly.
- */
-export function reservationError(e: unknown): Error {
-  const msg = e instanceof Error ? e.message : String(e);
-  if (/payment method|not configured|premium/i.test(msg)) {
-    return new Error("Ticket sales aren't switched on yet — the organizer needs to connect a payment method in the dashboard.");
-  }
-  return e instanceof Error ? e : new Error(msg);
-}
-
-/** The reservation id out of either transport's response; throws when the hold didn't happen. */
-export function reservationId(reservation: Raw | null | undefined): string {
-  const id = tierId(reservation);
-  if (!id) throw new Error("Those tickets couldn't be reserved — they may have just sold out.");
-  return id;
-}
-
-/** Where the hosted checkout returns to. Defaults are the Astro routes; a static site passes its file paths. */
-export interface CheckoutPaths {
-  /** Success landing — Wix appends `?orderNumber=&eventId=`. Default `/event-confirmation`. */
-  confirmation?: string;
-  /** Back here on abandon. Default `/events/<slug>`. */
-  event?: string;
-}
-
-/**
- * The redirect session's callbacks. `origin` is the published https host (window.location.origin
- * in a browser) — an http or server-derived origin isn't on the redirect allowlist and 403s the
- * return; {} when unknown (SSR).
- */
-export function checkoutCallbacks(origin: string, slug: string, paths: CheckoutPaths = {}): Raw {
-  if (!origin) return {};
-  return {
-    thankYouPageUrl: `${origin}${paths.confirmation ?? "/event-confirmation"}`,
-    postFlowUrl: `${origin}${paths.event ?? `/events/${slug}`}`,
-  };
-}
-
-/** The redirect result; throws when Wix returned no URL. */
-export function redirectResult(session: Raw | null | undefined): RegistrationResult {
-  const url = session?.redirectSession?.fullUrl;
-  if (!url) throw new Error("Checkout couldn't start — please try again.");
-  return { kind: "redirect", url };
-}
-
-/**
- * The RSVP body: the built-in form is exactly firstName + lastName + email — never a fetched
- * schema, never extra fields. "NO" only when the event's rsvpResponseType is "YES_AND_NO".
- */
-export function rsvpBody(eventId: string, guest: { firstName: string; lastName: string; email: string }, status: "YES" | "NO"): Raw {
-  return { eventId, firstName: guest.firstName, lastName: guest.lastName, email: guest.email, status };
-}
-
-/** A full event with a waitlist answers status "WAITLIST" — tell the guest they're waitlisted, not confirmed. */
-export function rsvpResult(rsvp: Raw | null | undefined, sent: "YES" | "NO"): RegistrationResult {
-  return { kind: "rsvpConfirmed", status: (rsvp?.status ?? sent) as "YES" | "NO" | "WAITLIST" };
-}
-
-export type CheckoutEvent = Pick<EventDetail, "id" | "slug">;