@wix/agent-skills 1.21.0 → 1.22.0

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

@@ -1,90 +0,0 @@
-// The services listing as a framework-free store — the logic behind useServices, usable from React
-// (useServices 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 `initialServices`/`initialCategories` and nothing is fetched;
-// without them `start()` loads both. Category filtering is client-side — bookings catalogs are
-// small and fully fetched. One store per mounted listing: createServicesStore(), not a singleton.
-import { fetchBookingCategories, fetchServices } from "./services";
-import type { BookingCategory, ServiceSummary } from "./types";
-
-export interface ServicesStoreOptions {
-  initialServices?: ServiceSummary[];
-  initialCategories?: BookingCategory[];
-}
-
-/** Everything a listing surface renders from. Read it with getState() or through a subscription. */
-export interface ServicesState {
-  /** null while the first load is in flight — render skeletons, not an empty state. */
-  services: ServiceSummary[] | null;
-  categories: BookingCategory[];
-  activeCategoryId: string | null;
-  error: string | null;
-}
-
-export interface ServicesStore {
-  getState(): ServicesState;
-  subscribe(listener: () => void): () => void;
-  /** Fetch whatever wasn't seeded. Call once when mounted (a browser). */
-  start(): void;
-  /** Stop reacting; drop late responses. */
-  stop(): void;
-  setActiveCategoryId(id: string | null): void;
-}
-
-export function createServicesStore({ initialServices, initialCategories }: ServicesStoreOptions = {}): ServicesStore {
-  let all: ServiceSummary[] | null = initialServices ?? null;
-  let categories: BookingCategory[] = initialCategories ?? [];
-  let activeCategoryId: string | null = null;
-  let error: string | null = null;
-  let started = false;
-  const listeners = new Set<() => void>();
-  let snapshot: ServicesState | null = null;
-  const emit = () => {
-    snapshot = null;
-    for (const fn of listeners) fn();
-  };
-
-  function getState(): ServicesState {
-    if (snapshot) return snapshot;
-    snapshot = {
-      services: all === null ? null : activeCategoryId ? all.filter((s) => s.categoryId === activeCategoryId) : all,
-      categories,
-      activeCategoryId,
-      error,
-    };
-    return snapshot;
-  }
-
-  return {
-    getState,
-    subscribe(fn) {
-      listeners.add(fn);
-      return () => listeners.delete(fn);
-    },
-    start() {
-      if (started) return;
-      started = true;
-      if (!initialServices) {
-        fetchServices()
-          .then((s) => { if (started) { all = s; emit(); } })
-          .catch((e) => {
-            if (!started) return;
-            all = [];
-            error = e instanceof Error ? e.message : String(e);
-            emit();
-          });
-      }
-      if (!initialCategories) {
-        fetchBookingCategories().then((c) => { if (started) { categories = c; emit(); } });
-      }
-    },
-    stop() {
-      started = false;
-    },
-    setActiveCategoryId(id) {
-      if (id === activeCategoryId) return;
-      activeCategoryId = id;
-      emit();
-    },
-  };
-}

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

@@ -1,57 +0,0 @@
-// Service reads (Wix Bookings Services V2) over the SDK — the only file that touches raw service
-// entities on this transport. Everything it returns is a plain DTO from ./types. The rules and
-// mappers live in ./services-core (shared with the REST twin in references/bookings/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/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 { services as servicesModule, categoriesV2 } from "@wix/bookings";
-import { wixModule } from "../sdk";
-import { imgSrc } from "../media";
-import {
-  BOOKINGS_APP_ID,
-  SERVICES_CONDITIONAL_FIELDS,
-  STAFF_RESOURCE_TYPE_ID,
-  isVisible,
-  toCategory,
-  toDetail,
-  toSummary,
-  type Raw,
-} from "./services-core";
-import type { BookingCategory, ServiceDetail, ServiceSummary } from "./types";
-
-export { BOOKINGS_APP_ID, STAFF_RESOURCE_TYPE_ID };
-
-const services = wixModule(servicesModule);
-const categories = wixModule(categoriesV2);
-
-/** List bookable services (hidden ones filtered), mapped to grid-ready DTOs. */
-export async function fetchServices({ limit = 100 } = {}): Promise<ServiceSummary[]> {
-  const res = await services
-    .queryServices({ conditionalFields: SERVICES_CONDITIONAL_FIELDS as any })
-    .eq("appId", BOOKINGS_APP_ID)
-    .limit(limit)
-    .find();
-  return ((res.items ?? []) as Raw[]).filter(isVisible).map((s) => toSummary(s, imgSrc));
-}
-
-/** Fetch one service by its URL slug (mainSlug.name). Null when not found. */
-export async function fetchServiceBySlug(slug: string): Promise<ServiceDetail | null> {
-  const res = await services
-    .queryServices({ conditionalFields: SERVICES_CONDITIONAL_FIELDS as any })
-    .eq("mainSlug.name", slug)
-    .eq("appId", BOOKINGS_APP_ID)
-    .limit(1)
-    .find();
-  const raw = res.items?.[0];
-  return raw ? toDetail(raw as Raw, imgSrc) : null;
-}
-
-/** Service categories for a filter bar — non-fatal (empty array on failure). */
-export async function fetchBookingCategories(): Promise<BookingCategory[]> {
-  try {
-    const res = await categories.queryCategories().find();
-    return ((res.items ?? []) as Raw[]).map(toCategory).filter((c) => c.id);
-  } catch {
-    return [];
-  }
-}

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

@@ -1,72 +0,0 @@
-// Bookings DTOs — the serializable shapes every hook, component, and page consumes.
-// Plain JSON: safe as Astro island props or across server/client boundaries. Images are
-// resolved https URLs; every displayable price is a ready formatted string.
-
-export type ServiceType = "APPOINTMENT" | "CLASS";
-
-/** A service as a listing/grid tile needs it. */
-export interface ServiceSummary {
-  id: string;
-  slug: string;
-  name: string;
-  tagLine: string;
-  type: ServiceType;
-  /** Formatted price (e.g. "€75.00"); "Free" when the service has no fee. */
-  price: string;
-  free: boolean;
-  /** Session length in minutes (appointments; classes may have none). */
-  durationMinutes: number | null;
-  /** Resolved https URL ("" when the service has no image). */
-  imageUrl: string;
-  categoryId: string | null;
-  /** Bookable staff: id is the resource GUID used for filtering and booking. */
-  staff: { id: string; name: string }[];
-}
-
-/** A service as the booking page needs it. */
-export interface ServiceDetail extends ServiceSummary {
-  /** Description HTML/text as stored. */
-  description: string;
-  /** The @wix/forms booking-form id (null → the contact-basics fallback form). */
-  formId: string | null;
-  /** Derived payment option the booking must send ("ONLINE" | "OFFLINE"). */
-  paymentOption: "ONLINE" | "OFFLINE";
-  /** True → checkout is always required regardless of price (cancellation-fee policy). */
-  cancellationFeeEnabled: boolean;
-}
-
-export interface BookingCategory {
-  id: string;
-  name: string;
-}
-
-/** One bookable time slot, appointment or class. */
-export interface Slot {
-  /** Local wall-clock strings "YYYY-MM-DDThh:mm:ss" (no Z). */
-  startLocal: string;
-  endLocal: string;
-  /** "YYYY-MM-DD" — for grouping slots by day. */
-  dayKey: string;
-  /** Display label, e.g. "9:00 AM". */
-  label: string;
-  /** APPOINTMENT slots carry their own scheduleId; CLASS slots carry an eventId instead. */
-  scheduleId: string | null;
-  eventId: string | null;
-  /** Staff able to take this slot (may be empty — ANY_RESOURCE still books). */
-  staff: { id: string; name: string }[];
-}
-
-/** A booking-form field (flat, from the form summary + schema; values are keyed by `target`). */
-export interface BookingFormField {
-  target: string;
-  label: string;
-  type: "STRING" | "EMAIL" | "PHONE" | "NUMBER" | "URL";
-  options?: string[];
-  /** The form marks it required — the only fields that gate `canBook`; the rest may stay empty. */
-  required: boolean;
-}
-
-/** The outcome of book(): either the browser is being redirected, or it's done. */
-export type BookingResult =
-  | { kind: "redirect"; url: string }
-  | { kind: "confirmed"; bookingId: string; orderId: string | null };

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

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

package/skills/wix-headless-fast/references/bookings/app-astro/pages/services/[slug].astro

@@ -1,76 +0,0 @@
----
-// Service detail + booking page.
-//
-// This is a Wix ITEM PAGE: the wixMetadata export + <SEO.Tags> below let the site owner edit
-// this page's title/description/OG in the dashboard and register the route in the sitemap.
-// Keep all three SEO pieces and this frontmatter; swap the island import to YOUR booking
-// component. The booking island is client:only — availability is timezone/session-specific.
-import SiteLayout from "../../layouts/SiteLayout.astro";
-import ServiceBookingView from "../../components/bookings/ServiceBookingView";
-import { fetchServiceBySlug } from "../../wix/bookings/services";
-import { WIX_APPS } from "@wix/essentials";
-import { SEO } from "@wix/seo/components";
-import { loadSEOTagsServiceConfig } from "@wix/seo/services";
-import { seoTags } from "@wix/seo";
-
-export const wixMetadata = {
-  appDefId: WIX_APPS.bookings.id,
-  pageIdentifier: WIX_APPS.bookings.servicePageMetadata.pageIdentifier,
-  identifiers: {
-    slug: WIX_APPS.bookings.servicePageMetadata.identifiers.slug,
-  },
-};
-
-const slug = Astro.params.slug!;
-
-// Behind Wix's proxy the request URL is internal — the real public page URL arrives on
-// x-wix-forwarded-url; the SEO service needs the public one.
-const forwardedUrl = Astro.request.headers.get("x-wix-forwarded-url");
-const pageUrl =
-  forwardedUrl && URL.canParse(forwardedUrl) && /^https?:$/.test(new URL(forwardedUrl).protocol)
-    ? forwardedUrl
-    : Astro.url.href;
-
-let service = null;
-let seoTagsServiceConfig = null;
-try {
-  [service, seoTagsServiceConfig] = await Promise.all([
-    fetchServiceBySlug(slug),
-    loadSEOTagsServiceConfig({
-      pageUrl,
-      itemType: seoTags.ItemType.BOOKINGS_SERVICE,
-      itemData: { slug },
-    }).catch(() => null),
-  ]);
-} catch {
-  // Guarded: an unhandled SSR throw truncates the response mid-stream.
-}
-
-if (!service) {
-  return new Response(null, { status: 404 });
-}
----
-
-<SiteLayout title={service.name}>
-  <SEO.Tags seoTagsServiceConfig={seoTagsServiceConfig} slot="seo-tags" />
-
-  <div class="grid gap-10 md:grid-cols-2">
-    <div>
-      {service.imageUrl && (
-        <div class="aspect-[4/3] overflow-hidden rounded-xl bg-secondary">
-          <img src={service.imageUrl} alt={service.name} class="h-full w-full object-cover" />
-        </div>
-      )}
-      <h1 class="mt-5 text-2xl font-semibold tracking-tight">{service.name}</h1>
-      {service.tagLine && <p class="mt-1 text-muted-foreground">{service.tagLine}</p>}
-      <p class="mt-2 text-sm text-muted-foreground">
-        {service.durationMinutes ? `${service.durationMinutes} min · ` : ""}
-        <span class="text-foreground">{service.price}</span>
-      </p>
-      {service.description && <p class="mt-4 text-sm leading-relaxed text-muted-foreground">{service.description}</p>}
-    </div>
-    <div>
-      <ServiceBookingView client:only="react" service={service} />
-    </div>
-  </div>
-</SiteLayout>

package/skills/wix-headless-fast/references/bookings/app-astro/pages/services.astro

@@ -1,22 +0,0 @@
----
-// Services listing — data fetched SERVER-SIDE (SEO) and handed to the island as DTO props.
-// Keep this frontmatter; swap the island import to YOUR listing component.
-import SiteLayout from "../layouts/SiteLayout.astro";
-import ServicesView from "../components/bookings/ServicesView";
-import { fetchServices, fetchBookingCategories } from "../wix/bookings/services";
-import type { BookingCategory, ServiceSummary } from "../wix/bookings/types";
-
-let services: ServiceSummary[] = [];
-let categories: BookingCategory[] = [];
-try {
-  [services, categories] = await Promise.all([fetchServices(), fetchBookingCategories()]);
-} catch {
-  // An unguarded SSR throw truncates the response mid-stream; the island renders the
-  // empty state instead.
-}
----
-
-<SiteLayout title="Services">
-  <h1 class="mb-8 text-2xl font-semibold tracking-tight">Services</h1>
-  <ServicesView client:load initialServices={services} initialCategories={categories} />
-</SiteLayout>