@wix/agent-skills 1.20.1 → 1.22.0

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

@@ -1,218 +0,0 @@
-// Booking rules, request builders, and DTO mapping — transport-agnostic, imported by BOTH transports:
-// ./booking.ts (the SDK) and the REST twin in references/bookings/rest/booking.ts (fetch). The
-// availability request bodies, the slot mapper, the form-field rules, the createBooking body, the
-// cart body, and the checkout-or-place decision live HERE, once — these are the payloads that are
-// exact and easy to get subtly wrong. Raw entities may carry `_id` (SDK) or `id` (REST). Imports are
-// type-only so a strip to JS emits no imports.
-import type { BookingFormField, BookingResult, ServiceDetail, Slot } from "./types";
-
-export type Raw = Record<string, any>;
-
-export const rawId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-// Copies of services-core's ids (same values) so this file stands alone when stripped.
-/** The Wix Bookings app id — the cart line's catalogReference.appId. */
-export const BOOKINGS_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
-/** Staff-member resource type id (ANY_RESOURCE fallback + staff filtering). */
-export const STAFF_RESOURCE_TYPE_ID = "1cd44cf8-756f-41c3-bd90-3e2ffcaf1155";
-
-const pad = (n: number) => String(n).padStart(2, "0");
-/** Local wall-clock "YYYY-MM-DDThh:mm:ss" (NO Z) — the format the availability APIs require. */
-export function toLocalDateString(d: Date): string {
-  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
-}
-
-/** The visitor's IANA time zone — availability and the booking are computed in it. */
-export const defaultTimeZone = (): string => Intl.DateTimeFormat().resolvedOptions().timeZone;
-
-// ---- availability ----------------------------------------------------------------------------------
-
-export interface SlotsWindow {
-  from?: Date;
-  days?: number;
-  timeZone?: string;
-  staffId?: string;
-}
-
-/** [from, from + days) as the local strings both time-slot APIs take. */
-export function slotsRange({ from = new Date(), days = 7 }: SlotsWindow): { fromLocalDate: string; toLocalDate: string } {
-  const to = new Date(from.getTime() + days * 24 * 3600 * 1000);
-  return { fromLocalDate: toLocalDateString(from), toLocalDate: toLocalDateString(to) };
-}
-
-/**
- * The List Availability Time Slots body for an APPOINTMENT service: bookable slots only, the staff
- * resources included on each slot, optionally narrowed to one staff member.
- */
-export function appointmentSlotsRequest(serviceId: string, { timeZone = defaultTimeZone(), staffId, ...window }: SlotsWindow): Raw {
-  return {
-    serviceId,
-    ...slotsRange(window),
-    timeZone,
-    bookable: true,
-    cursorPaging: { limit: 100 },
-    includeResourceTypeIds: [STAFF_RESOURCE_TYPE_ID],
-    ...(staffId ? { resourceTypes: [{ resourceTypeId: STAFF_RESOURCE_TYPE_ID, resourceIds: [staffId] }] } : {}),
-  };
-}
-
-/** The List Event Time Slots body for a CLASS service: its sessions, bookable only, optionally one staff member's. */
-export function classSlotsRequest(serviceId: string, { timeZone = defaultTimeZone(), staffId, ...window }: SlotsWindow): Raw {
-  return {
-    serviceIds: [serviceId],
-    ...slotsRange(window),
-    timeZone,
-    includeNonBookable: false,
-    ...(staffId ? { eventFilter: { "resources.id": { $hasSome: [staffId] } } } : {}),
-  };
-}
-
-export function toSlot(raw: Raw): Slot {
-  const start: string = raw.localStartDate ?? "";
-  const staff = ((raw.availableResources ?? []) as Raw[])
-    .flatMap((ar) => (ar.resources ?? []) as Raw[])
-    .map((r) => ({ id: rawId(r), name: r.name ?? "" }))
-    .filter((r) => r.id);
-  let label = start.slice(11, 16);
-  try {
-    label = new Date(start).toLocaleTimeString(undefined, { hour: "numeric", minute: "2-digit" });
-  } catch {
-    /* keep the hh:mm fallback */
-  }
-  return {
-    startLocal: start,
-    endLocal: raw.localEndDate ?? "",
-    dayKey: start.slice(0, 10),
-    label,
-    scheduleId: raw.scheduleId ?? null,
-    eventId: raw.eventInfo?.eventId ?? null,
-    staff,
-  };
-}
-
-export interface BookingDay {
-  dayKey: string;
-  dayLabel: string;
-  slots: Slot[];
-}
-
-export const dayLabel = (dayKey: string): string => {
-  try {
-    return new Date(`${dayKey}T12:00:00`).toLocaleDateString(undefined, { weekday: "short", month: "short", day: "numeric" });
-  } catch {
-    return dayKey;
-  }
-};
-
-/** Slots grouped by day, days in order — what a slot picker renders. */
-export function groupSlotsByDay(slots: Slot[]): BookingDay[] {
-  const byDay = new Map<string, Slot[]>();
-  for (const s of slots) byDay.set(s.dayKey, [...(byDay.get(s.dayKey) ?? []), s]);
-  return [...byDay.entries()]
-    .sort(([a], [b]) => a.localeCompare(b))
-    .map(([dayKey, daySlots]) => ({ dayKey, dayLabel: dayLabel(dayKey), slots: daySlots }));
-}
-
-// ---- the booking form -------------------------------------------------------------------------------
-
-export const FALLBACK_FIELDS: BookingFormField[] = [
-  { target: "first_name", label: "First Name", type: "STRING", required: true },
-  { target: "last_name", label: "Last Name", type: "STRING", required: true },
-  { target: "email", label: "Email", type: "EMAIL", required: true },
-];
-
-const FIELD_TYPES = ["STRING", "EMAIL", "PHONE", "NUMBER", "URL"];
-
-/**
- * Flat, render-ready fields from a form summary — deleted fields and non-text types dropped, values
- * keyed by `target`. `required` comes from the full form schema (`fields[].validation.required`,
- * keyed by target); the summary doesn't carry it. Without the schema every field counts as required.
- * ALWAYS non-empty: contact basics when the schema is missing or unusable.
- */
-export function toFormFields(summary: Raw | null | undefined, form?: Raw | null): BookingFormField[] {
-  const requiredByTarget = new Map<string, boolean>(
-    ((form?.fields ?? []) as Raw[]).filter((f) => f.target).map((f) => [f.target as string, f.validation?.required === true]),
-  );
-  const fields = ((summary?.fields ?? []) as Raw[])
-    .filter((f) => !f.deleted)
-    .filter((f) => f.type && FIELD_TYPES.includes(f.type))
-    .map((f) => ({
-      target: f.target ?? "",
-      label: f.label ?? f.target ?? "",
-      type: f.type as BookingFormField["type"],
-      ...(Array.isArray(f.options) && f.options.length ? { options: f.options as string[] } : {}),
-      required: requiredByTarget.get(f.target ?? "") ?? true,
-    }))
-    .filter((f) => f.target);
-  return fields.length ? fields : FALLBACK_FIELDS;
-}
-
-// ---- createBooking → cart → checkout-or-place --------------------------------------------------------
-
-/**
- * The Create Booking `booking` object. APPOINTMENT: the SLOT's scheduleId (never service.schedule.id)
- * plus start/end as local wall-clock with the time zone; CLASS: the eventId. A chosen staff member
- * is the slot's `resource`; otherwise ANY_RESOURCE of the staff type. `idKey` spells the resource's
- * id the way the transport wants it: `_id` on the SDK, `id` on REST.
- */
-export function bookingRequest(
-  service: Pick<ServiceDetail, "id" | "paymentOption">,
-  slot: Slot,
-  { staffId, timeZone = defaultTimeZone(), idKey = "id" }: { staffId?: string; timeZone?: string; idKey?: "_id" | "id" } = {},
-): Raw {
-  const staff = staffId ? slot.staff.find((s) => s.id === staffId) : undefined;
-  return {
-    selectedPaymentOption: service.paymentOption,
-    totalParticipants: 1,
-    bookedEntity: {
-      slot: {
-        serviceId: service.id,
-        scheduleId: slot.scheduleId ?? undefined,
-        eventId: slot.eventId ?? undefined,
-        startDate: slot.startLocal,
-        endDate: slot.endLocal,
-        timezone: timeZone,
-        ...(staff
-          ? { resource: { [idKey]: staff.id, name: staff.name } }
-          : { resourceSelections: [{ resourceTypeId: STAFF_RESOURCE_TYPE_ID, selectionMethod: "ANY_RESOURCE" }] }),
-        location: { locationType: "OWNER_BUSINESS" },
-      },
-    },
-  };
-}
-
-/** The Create Cart body that holds the booked seat: one line whose catalogItemId is the BOOKING id. */
-export function bookingCartRequest(bookingId: string): Raw {
-  return {
-    catalogItems: [{ quantity: 1, catalogReference: { catalogItemId: bookingId, appId: BOOKINGS_APP_ID } }],
-    cart: { source: { channelType: "WEB" } },
-  };
-}
-
-/** The booking id out of a Create Booking response (wrapped { booking } on both transports). */
-export const bookingIdOf = (res: Raw | null | undefined): string => rawId(res?.booking);
-
-/** The cart id out of a Create Cart response — the SDK may unwrap the cart, REST wraps it. */
-export const cartIdOf = (res: Raw | null | undefined): string => rawId(res) || rawId(res?.cart);
-
-/** The cart's total from a Calculate Cart response (`summary.priceSummary.total`); 0 when absent. */
-export const cartTotal = (calc: Raw | null | undefined): number => Number(calc?.summary?.priceSummary?.total?.amount ?? 0);
-
-/**
- * Hosted checkout is required for anything that costs money paid online, and always when the
- * service carries a cancellation fee (a card must be on file). Otherwise the order is placed
- * directly — free and pay-in-person bookings confirm without a checkout.
- */
-export function checkoutRequired(service: Pick<ServiceDetail, "paymentOption" | "cancellationFeeEnabled">, total: number): boolean {
-  return service.cancellationFeeEnabled || (total > 0 && service.paymentOption !== "OFFLINE");
-}
-
-/** The Create Redirect Session body for a cart's checkout; the cart id IS the checkout id. */
-export function checkoutRedirectRequest(cartId: string, origin: string): Raw {
-  return { ecomCheckout: { checkoutId: cartId }, callbacks: origin ? { postFlowUrl: `${origin}/` } : {} };
-}
-
-/** A placed order → the confirmed result; the order id is wherever the transport put it. */
-export function confirmedResult(bookingId: string, order: Raw | null | undefined): BookingResult {
-  return { kind: "confirmed", bookingId, orderId: order?.orderId ?? (rawId(order?.order) || null) };
-}

package/skills/wix-headless-fast/references/bookings/app/wix/bookings/booking-flow-store.ts

@@ -1,169 +0,0 @@
-// The whole booking state machine for one service as a framework-free store — the logic behind
-// useBookingFlow, usable from React (useBookingFlow wraps it), from a static page's booking surface,
-// from Vue/Svelte, or as the specification for a port: the availability window (day-grouped slots,
-// week paging, optional staff filter), the schema-driven form, and book(). All correctness (slot
-// scheduleId vs eventId, ANY_RESOURCE, formSubmission, payment option, checkout-or-place) lives in
-// the data layer; this store orchestrates. A late response from a superseded window is dropped.
-// One store per booking surface: createBookingFlowStore(service), not a singleton.
-import { bookService, fetchBookingForm, fetchSlots } from "./booking";
-import { groupSlotsByDay, type BookingDay } from "./booking-core";
-import type { BookingFormField, BookingResult, ServiceDetail, Slot } from "./types";
-
-export type { BookingDay };
-
-const WEEK = 7 * 24 * 3600 * 1000;
-
-/** Everything a booking surface renders from. Read it with getState() or through a subscription. */
-export interface BookingFlowState {
-  /** Slots grouped by day, in order — [{ dayKey, dayLabel, slots }]. null while loading. */
-  days: BookingDay[] | null;
-  /** The 7-day window start; page with nextWeek/prevWeek (prev clamps to today). */
-  windowStart: Date;
-  /** Staff filter — render a picker only when service.staff.length > 1. */
-  staffId: string | undefined;
-  selectedSlot: Slot | null;
-  /** Schema-driven form fields (never empty — contact basics fallback). */
-  formFields: BookingFormField[];
-  values: Record<string, string>;
-  /** True when a slot is selected and every field has a value. */
-  canBook: boolean;
-  booking: boolean;
-  /** Set after a free/offline booking completes — the only REAL success signal. */
-  confirmed: BookingResult | null;
-  error: string | null;
-}
-
-export interface BookingFlowStore {
-  getState(): BookingFlowState;
-  subscribe(listener: () => void): () => void;
-  /** Load the first window and the form. Call once when mounted (a browser — availability is timezone-specific). */
-  start(): void;
-  /** Stop reacting; drop late responses. */
-  stop(): void;
-  nextWeek(): void;
-  prevWeek(): void;
-  setStaffId(id: string | undefined): void;
-  setSelectedSlot(slot: Slot | null): void;
-  setValue(target: string, value: string): void;
-  /** Books the selected slot. On "redirect" the browser is already navigating; otherwise `confirmed` is set. Rejects with the refusal (also in .error). */
-  book(): Promise<BookingResult>;
-}
-
-export function createBookingFlowStore(service: ServiceDetail): BookingFlowStore {
-  let windowStart = new Date();
-  let staffId: string | undefined;
-  let slots: Slot[] | null = null;
-  let selectedSlot: Slot | null = null;
-  let formFields: BookingFormField[] = [];
-  let values: Record<string, string> = {};
-  let booking = false;
-  let confirmed: BookingResult | null = null;
-  let error: string | null = null;
-  let started = false;
-  let generation = 0;
-  const listeners = new Set<() => void>();
-  let snapshot: BookingFlowState | null = null;
-  const emit = () => {
-    snapshot = null;
-    for (const fn of listeners) fn();
-  };
-
-  function getState(): BookingFlowState {
-    if (snapshot) return snapshot;
-    snapshot = {
-      days: slots === null ? null : groupSlotsByDay(slots),
-      windowStart,
-      staffId,
-      selectedSlot,
-      formFields,
-      values,
-      canBook: !!selectedSlot && formFields.every((f) => !f.required || (values[f.target] ?? "").trim().length > 0),
-      booking,
-      confirmed,
-      error,
-    };
-    return snapshot;
-  }
-
-  // The window or the staff filter changed: clear the picker and load the slots for the new selection.
-  function loadSlots(): void {
-    if (!started) return;
-    const id = ++generation;
-    slots = null;
-    selectedSlot = null;
-    emit();
-    fetchSlots(service, { from: windowStart, days: 7, staffId })
-      .then((s) => {
-        if (!started || generation !== id) return; // superseded — drop it
-        slots = s;
-        emit();
-      })
-      .catch((e) => {
-        if (!started || generation !== id) return;
-        slots = [];
-        error = e instanceof Error ? e.message : String(e);
-        emit();
-      });
-  }
-
-  return {
-    getState,
-    subscribe(fn) {
-      listeners.add(fn);
-      return () => listeners.delete(fn);
-    },
-    start() {
-      if (started) return;
-      started = true;
-      loadSlots();
-      fetchBookingForm(service.formId).then((f) => { if (started) { formFields = f; emit(); } });
-    },
-    stop() {
-      started = false;
-      generation++;
-    },
-    nextWeek() {
-      windowStart = new Date(windowStart.getTime() + WEEK);
-      loadSlots();
-    },
-    prevWeek() {
-      const prev = new Date(windowStart.getTime() - WEEK);
-      windowStart = prev < new Date() ? new Date() : prev;
-      loadSlots();
-    },
-    setStaffId(id) {
-      if (id === staffId) return;
-      staffId = id;
-      loadSlots();
-    },
-    setSelectedSlot(slot) {
-      selectedSlot = slot;
-      emit();
-    },
-    setValue(target, value) {
-      values = { ...values, [target]: value };
-      emit();
-    },
-    async book() {
-      if (!selectedSlot) throw new Error("Pick a time first.");
-      booking = true;
-      error = null;
-      emit();
-      try {
-        const result = await bookService(service, selectedSlot, values, { staffId });
-        if (result.kind === "redirect") {
-          window.location.href = result.url;
-        } else {
-          confirmed = result;
-        }
-        return result;
-      } catch (e) {
-        error = e instanceof Error ? e.message : String(e);
-        throw e;
-      } finally {
-        booking = false;
-        emit();
-      }
-    },
-  };
-}

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

@@ -1,121 +0,0 @@
-// Availability, the booking form, and the createBooking → Cart V2 → checkout-or-place sequence
-// over the SDK. The payload shapes are exact and easy to get subtly wrong — they are built in
-// ./booking-core (shared with the REST twin in references/bookings/rest/); this file is the
-// transport only. Copy as-is; extend by calling these exports, never by editing them. Failures
-// are loud.
-// 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-solutions/e-commerce/purchase-flow/cart-v2/calculate-cart.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/place-order.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 { availabilityTimeSlots, eventTimeSlots, bookings as bookingsModule } from "@wix/bookings";
-import { createCart, calculateCart, placeOrder } from "@wix/auto_sdk_ecom_cart-v-2";
-import { redirects as redirectsModule } from "@wix/redirects";
-import { wixFetch, wixModule } from "../sdk";
-import {
-  FALLBACK_FIELDS,
-  appointmentSlotsRequest,
-  bookingCartRequest,
-  bookingIdOf,
-  bookingRequest,
-  cartIdOf,
-  cartTotal,
-  checkoutRedirectRequest,
-  checkoutRequired,
-  classSlotsRequest,
-  confirmedResult,
-  defaultTimeZone,
-  toFormFields,
-  toLocalDateString,
-  toSlot,
-  type Raw,
-  type SlotsWindow,
-} from "./booking-core";
-import type { BookingFormField, BookingResult, ServiceDetail, Slot } from "./types";
-
-export { toLocalDateString };
-
-const apptSlots = wixModule(availabilityTimeSlots);
-const classSlots = wixModule(eventTimeSlots);
-const bookings = wixModule(bookingsModule);
-const cart = wixModule({ createCart, calculateCart, placeOrder });
-const redirects = wixModule(redirectsModule);
-
-/**
- * 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.
- */
-export async function fetchSlots(service: Pick<ServiceDetail, "id" | "type">, window: SlotsWindow = {}): Promise<Slot[]> {
-  const res: Raw =
-    service.type === "CLASS"
-      ? await classSlots.listEventTimeSlots(classSlotsRequest(service.id, window) as any)
-      : await apptSlots.listAvailabilityTimeSlots(appointmentSlotsRequest(service.id, window) as any);
-  return ((res.timeSlots ?? []) as Raw[]).map(toSlot);
-}
-
-/**
- * The service's booking-form fields, flat and render-ready (values are keyed by `target`).
- * ALWAYS returns a non-empty list — contact basics when the schema is missing/unusable —
- * so the form can render unconditionally.
- */
-export async function fetchBookingForm(formId: string | null): Promise<BookingFormField[]> {
-  if (!formId) return FALLBACK_FIELDS;
-  try {
-    // Over wixFetch, not the @wix/forms `forms` module: that generated module is 15 MB and would
-    // ride into the booking island's client chunk (11 MB per visitor). The summary has labels and
-    // types; only the full schema says which fields are required.
-    const id = encodeURIComponent(formId);
-    const json = async (path: string): Promise<Raw | null> => {
-      const r = await wixFetch(path);
-      return r.ok ? ((await r.json()) as Raw) : null;
-    };
-    const [res, form] = await Promise.all([
-      json(`/form-schema-service/v4/forms/${id}/summary`),
-      json(`/form-schema-service/v4/forms/${id}`).catch(() => null),
-    ]);
-    if (!res) return FALLBACK_FIELDS;
-    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 a friendly message on refusal (slot taken, invalid
- * form) — surface it, don't swallow it.
- */
-export async function bookService(
-  service: ServiceDetail,
-  slot: Slot,
-  formValues: Record<string, unknown>,
-  { staffId, timeZone = defaultTimeZone() }: { staffId?: string; timeZone?: string } = {},
-): Promise<BookingResult> {
-  const created: Raw = await bookings.createBooking(
-    bookingRequest(service, slot, { staffId, timeZone, idKey: "_id" }) as any,
-    { formSubmission: formValues } as any,
-  );
-  const bookingId = bookingIdOf(created);
-  if (!bookingId) throw new Error("The booking couldn't be created — the slot may have just been taken.");
-
-  const newCart: Raw = await cart.createCart(bookingCartRequest(bookingId) as any);
-  const cartId = cartIdOf(newCart);
-  if (!cartId) throw new Error("The booking couldn't be reserved — please try again.");
-
-  const calc: Raw = await cart.calculateCart(cartId);
-  if (checkoutRequired(service, cartTotal(calc))) {
-    const origin = typeof window !== "undefined" ? window.location.origin : "";
-    const session: Raw = await redirects.createRedirectSession(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: Raw = await cart.placeOrder(cartId);
-  return confirmedResult(bookingId, order);
-}

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

@@ -1,92 +0,0 @@
-// Service rules and DTO mapping — transport-agnostic, imported by BOTH transports: ./services.ts
-// (the SDK, managed Astro and React) and the REST twin in references/bookings/rest/services.ts
-// (fetch, a static site or a port to another language). Every rule about price, "Free", duration,
-// media, staff, and the payment option lives HERE, once. A raw entity may come from the SDK (`_id`,
-// media as a `wix:image://` string) or from REST (`id`, media as an { id, url, width, height }
-// object); the mappers accept both. Imports are type-only so a strip to JS emits no imports.
-import type { BookingCategory, ServiceDetail, ServiceSummary, ServiceType } from "./types";
-
-/** A raw Services V2 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 Bookings app id — the cart's catalogReference.appId and the services filter. */
-export const BOOKINGS_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
-/** Staff-member resource type id (ANY_RESOURCE fallback + staff filtering). */
-export const STAFF_RESOURCE_TYPE_ID = "1cd44cf8-756f-41c3-bd90-3e2ffcaf1155";
-/** Requested on every service read — without it `staffMemberDetails` is absent and the DTO's staff is []. */
-export const SERVICES_CONDITIONAL_FIELDS = ["STAFF_MEMBER_DETAILS"] as const;
-
-export const rawId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-/** The filter every services read shares: this app's services, optionally one slug (`mainSlug.name`). */
-export function servicesFilter(slug?: string): Raw {
-  return { appId: BOOKINGS_APP_ID, ...(slug ? { "mainSlug.name": slug } : {}) };
-}
-
-/** Hidden services never reach a tile — the same rule on both transports. */
-export const isVisible = (raw: Raw): boolean => !raw.hidden;
-
-/**
- * A media value the image helpers can resolve. The SDK hands over a `wix:image://v1/<id>/<name>#…`
- * string (or an https URL); REST hands over the image OBJECT with a bare file id — rebuilt into the
- * same `wix:image://` form the SDK produces, so imgSrc scales both identically.
- */
-export function mediaValue(image: unknown): unknown {
-  if (!image || typeof image === "string") return image;
-  const o = image as Raw;
-  const url: string = o.url ?? "";
-  if (/^(https?:|wix:image:)/.test(url)) return url;
-  if (o.id) return `wix:image://v1/${o.id}/${encodeURIComponent(o.filename ?? "")}#originWidth=${o.width ?? 0}&originHeight=${o.height ?? 0}`;
-  return url;
-}
-
-export function formatPrice(value: string | undefined, currency: string | undefined): string {
-  if (value == null || value === "" || Number(value) === 0) return "Free";
-  try {
-    return new Intl.NumberFormat(undefined, { style: "currency", currency: currency || "USD" }).format(Number(value));
-  } catch {
-    return `${value} ${currency ?? ""}`.trim();
-  }
-}
-
-export function toSummary(raw: Raw, imgSrc: ImgSrc): ServiceSummary {
-  const price = raw.payment?.fixed?.price;
-  const free = raw.payment?.rateType === "NO_FEE" || !price?.value || Number(price.value) === 0;
-  return {
-    id: rawId(raw),
-    slug: raw.mainSlug?.name ?? raw.supportedSlugs?.[0]?.name ?? "",
-    name: raw.name ?? "",
-    tagLine: raw.tagLine ?? "",
-    type: (raw.type ?? "APPOINTMENT") as ServiceType,
-    price: free ? "Free" : formatPrice(price?.value, price?.currency),
-    free,
-    durationMinutes: raw.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? null,
-    imageUrl: imgSrc(mediaValue(raw.media?.mainMedia?.image), 800, 800),
-    categoryId: rawId(raw.category) || null,
-    staff: ((raw.staffMemberDetails?.staffMembers ?? []) as Raw[])
-      .map((m) => ({ id: m.staffMemberId ?? "", name: m.name ?? "" }))
-      .filter((m) => m.id),
-  };
-}
-
-export function toDetail(raw: Raw, imgSrc: ImgSrc): ServiceDetail {
-  const summary = toSummary(raw, imgSrc);
-  const online = raw.payment?.options?.online === true;
-  const inPerson = raw.payment?.options?.inPerson === true;
-  // Derive — never hardcode "ONLINE": a free/pay-in-person service booked ONLINE gets
-  // rejected by the cart with INSUFFICIENT_INVENTORY.
-  const paymentOption: "ONLINE" | "OFFLINE" = !online && inPerson ? "OFFLINE" : "ONLINE";
-  return {
-    ...summary,
-    description: raw.description ?? "",
-    formId: rawId(raw.form) || null,
-    paymentOption,
-    cancellationFeeEnabled: raw.bookingPolicy?.cancellationFeePolicy?.enabled === true,
-  };
-}
-
-export function toCategory(raw: Raw): BookingCategory {
-  return { id: rawId(raw), name: raw.name ?? "" };
-}