@wix/agent-skills 1.7.0 → 1.8.0

package/skills/wix-headless/references/astro/templates/bookings/SeoTags.astro

@@ -0,0 +1,25 @@
+---
+// SeoTags.astro — renders Wix-resolved SEO tags into <head> for service pages.
+// Pass `service.seoData.tags` (Services V2) — title/meta/link/script — so the
+// service detail page ships Wix's sitemap/SEO/social tags. Mirrors the stores
+// SeoTags template. Mount inside the Layout's `head` slot on `/services/[slug]`.
+interface SeoTag {
+  type?: string;
+  props?: Record<string, any> | null;
+  children?: string;
+  disabled?: boolean;
+}
+interface Props { tags?: SeoTag[]; }
+const { tags = [] } = Astro.props;
+const visibleTags = tags.filter((t) => !t.disabled);
+---
+{
+  visibleTags.map((tag) => {
+    const props = tag.props ?? {};
+    if (tag.type === "title") return <title set:html={tag.children ?? ""} />;
+    if (tag.type === "meta") return <meta {...props} />;
+    if (tag.type === "link") return <link {...props} />;
+    if (tag.type === "script") return <script {...props} is:inline set:html={tag.children ?? ""} />;
+    return null;
+  })
+}

package/skills/wix-headless/references/astro/templates/bookings/ServiceBookingFlow.tsx

@@ -0,0 +1,50 @@
+import { useState } from "react";
+import AvailabilityCalendar from "./AvailabilityCalendar";
+import type { SelectedSlot } from "./AvailabilityCalendar";
+import BookingForm from "./BookingForm";
+
+// ServiceBookingFlow.tsx — client:only="react" coordinator island. Holds the
+// selected-slot state shared between AvailabilityCalendar and BookingForm,
+// transitions between them, and redirects to the confirmation page on success.
+// serviceType MUST be threaded through so the calendar picks the right time-slots
+// API and the form builds the right createBooking shape.
+
+interface Props {
+  serviceId: string;
+  serviceName: string;
+  serviceType: "APPOINTMENT" | "CLASS";
+}
+
+export default function ServiceBookingFlow({ serviceId, serviceName, serviceType }: Props) {
+  const [selectedSlot, setSelectedSlot] = useState<SelectedSlot | null>(null);
+
+  const handleSuccess = (bookingId: string, startDate?: string) => {
+    const params = new URLSearchParams();
+    if (bookingId) params.set("bookingId", bookingId);
+    if (startDate) params.set("startDate", startDate);
+    if (serviceName) params.set("service", serviceName);
+    window.location.href = `/booking-confirmation?${params.toString()}`;
+  };
+
+  if (!selectedSlot) {
+    return (
+      <AvailabilityCalendar
+        serviceId={serviceId}
+        serviceName={serviceName}
+        serviceType={serviceType}
+        onSlotSelected={setSelectedSlot}
+      />
+    );
+  }
+
+  return (
+    <BookingForm
+      serviceId={serviceId}
+      serviceName={serviceName}
+      serviceType={serviceType}
+      slot={selectedSlot}
+      onSuccess={handleSuccess}
+      onCancel={() => setSelectedSlot(null)}
+    />
+  );
+}

package/skills/wix-headless/references/astro/templates/bookings/ServiceCard.astro

@@ -0,0 +1,45 @@
+---
+// ServiceCard.astro — static card for the services listing grid.
+// Props in, HTML out; no client-side interactivity. Works for APPOINTMENT and
+// CLASS services. Classes (.service-card, .service-card-image,
+// .service-card-meta, .service-card-price, …) are owned by
+// src/styles/components-bookings.css (pre-copied by the orchestrator).
+interface Props {
+  id: string;
+  slug: string;
+  name: string;
+  tagLine?: string;
+  durationMinutes: number;
+  price?: string; // formatted string, e.g. "$75.00" — already formatted by caller
+  currency?: string;
+  imageUrl?: string;
+  type: "APPOINTMENT" | "CLASS";
+}
+
+const { slug, name, tagLine, durationMinutes, price, imageUrl } = Astro.props;
+---
+
+<a href={`/services/${slug}`} class="service-card">
+  {
+    imageUrl ? (
+      <div class="service-card-image">
+        <img src={imageUrl} alt={name} loading="lazy" />
+      </div>
+    ) : (
+      <div
+        class="service-card-image service-card-image--placeholder"
+        aria-hidden="true"
+        style="background-color: var(--color-surface-secondary, var(--color-paper-warm, var(--color-cream)));"
+      />
+    )
+  }
+
+  <div class="service-card-meta">
+    <h3 class="service-card-name">{name}</h3>
+    {tagLine && <p class="service-card-tagline">{tagLine}</p>}
+    <div class="service-card-price">
+      <span>{durationMinutes} min</span>
+      {price && <span>{price}</span>}
+    </div>
+  </div>
+</a>

package/skills/wix-headless/references/astro/templates/bookings/api/confirm-booking.ts

@@ -0,0 +1,34 @@
+import type { APIRoute } from "astro";
+import { auth } from "@wix/essentials";
+import { bookings } from "@wix/bookings";
+
+// POST /api/confirm-booking { bookingId, revision }
+//
+// createBooking() leaves the booking CREATED — which does NOT occupy a seat, so
+// the class/appointment stays bookable and OVERBOOKS (remainingCapacity never
+// drops). confirmBooking() promotes it to CONFIRMED (holds the seat); with
+// flowControlSettings.checkAvailabilityValidation it REJECTS the confirm if the
+// session filled up since the slot was picked — the real overbooking guard.
+// confirmBooking requires Manage Bookings, so elevate (app identity) here;
+// confirmBooking is a real SDK method, so auth.elevate(...) works directly.
+
+const json = (ok: boolean, status: number, extra: Record<string, unknown> = {}) =>
+  new Response(JSON.stringify({ ok, ...extra }), { status, headers: { "Content-Type": "application/json" } });
+
+export const POST: APIRoute = async ({ request }) => {
+  let body: any;
+  try { body = await request.json(); } catch { return json(false, 400, { error: "Invalid request body." }); }
+  const { bookingId, revision } = body ?? {};
+  if (!bookingId || !revision) return json(false, 400, { error: "Missing bookingId or revision." });
+
+  try {
+    const res = await auth.elevate(bookings.confirmBooking)(bookingId, String(revision), {
+      paymentStatus: "NOT_PAID", // pay-on-site reservation
+      flowControlSettings: { checkAvailabilityValidation: true },
+    });
+    return json(true, 200, { status: res.booking?.status });
+  } catch (err) {
+    console.error("[api/confirm-booking] failed:", err);
+    return json(false, 409, { error: "unavailable" }); // most likely: session just filled up
+  }
+};

package/skills/wix-headless/references/astro/templates/bookings/api/waitlist.ts

@@ -0,0 +1,74 @@
+import type { APIRoute } from "astro";
+import { auth, httpClient } from "@wix/essentials";
+
+// POST /api/waitlist { sessionId, totalParticipants, contactDetails:{firstName,lastName,email,phone} }
+//
+// Native Wix Bookings waitlist. There is NO v2/v3 waitlist API — createBooking
+// can't waitlist; the only join is the legacy v1 Register To Waitlist
+// (POST /bookings/v1/waitlist/register), which needs Manage Bookings + a Wix
+// contactId. So this runs server-side, elevated to app identity. CLASS only.
+//
+// `sessionId` is the v1-encoded session id (the `waitingResource`); the browser
+// gets it from the SESSION_CAPACITY_EXCEEDED error createBooking returns for a
+// full session ("…on session <id>").
+//
+// IMPORTANT: auth.elevate() only grants permissions for a real SDK function. The
+// waitlist + Contacts calls are raw REST (no SDK wrapper), so elevate the
+// authenticated fetch ITSELF — NOT a closure that calls it (a closure runs
+// un-elevated/visitor and 403s).
+
+const json = (ok: boolean, status: number, extra: Record<string, unknown> = {}) =>
+  new Response(JSON.stringify({ ok, ...extra }), { status, headers: { "Content-Type": "application/json" } });
+
+export const POST: APIRoute = async ({ request }) => {
+  let body: any;
+  try { body = await request.json(); } catch { return json(false, 400, { error: "Invalid request body." }); }
+  const { sessionId, totalParticipants = 1, contactDetails } = body ?? {};
+  const email: string | undefined = contactDetails?.email;
+  if (!sessionId || !email) return json(false, 400, { error: "Missing sessionId or email." });
+
+  const ef = auth.elevate(httpClient.fetchWithAuth as typeof fetch) as typeof fetch;
+  const api = (url: string, payload: unknown) =>
+    ef(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(payload) });
+
+  try {
+    // 1. Resolve a contactId (reuse by email; create if absent).
+    let contactId: string | undefined;
+    const q = await api("https://www.wixapis.com/contacts/v4/contacts/query", {
+      query: { filter: { "info.emails.email": email } },
+    });
+    contactId = ((await q.json().catch(() => ({}))) as any).contacts?.[0]?.id;
+    if (!contactId) {
+      const c = await api("https://www.wixapis.com/contacts/v4/contacts", {
+        info: {
+          name: { first: contactDetails.firstName, last: contactDetails.lastName || undefined },
+          emails: { items: [{ email, primary: true }] },
+          ...(contactDetails.phone ? { phones: { items: [{ phone: contactDetails.phone, primary: true }] } } : {}),
+        },
+      });
+      contactId = ((await c.json().catch(() => ({}))) as any).contact?.id;
+    }
+    if (!contactId) throw new Error("could not resolve contactId");
+
+    // 2. Register on the native waitlist.
+    const reg = await api("https://www.wixapis.com/bookings/v1/waitlist/register", {
+      waitingResource: sessionId,
+      formInfo: {
+        paymentSelection: [{ rateLabel: "general", numberOfParticipants: totalParticipants }],
+        contactDetails: {
+          contactId,
+          firstName: contactDetails.firstName,
+          lastName: contactDetails.lastName || undefined,
+          email,
+          phone: contactDetails.phone || undefined,
+        },
+      },
+    });
+    const rj: any = await reg.json().catch(() => ({}));
+    if (!reg.ok || !rj.registrationId) throw new Error(`register ${reg.status}: ${JSON.stringify(rj).slice(0, 200)}`);
+    return json(true, 200, { registrationId: rj.registrationId });
+  } catch (err) {
+    console.error("[api/waitlist] failed:", err);
+    return json(false, 502, { error: "Waitlist registration failed." });
+  }
+};

package/skills/wix-headless/references/astro/templates/bookings/booking-confirmation.astro

@@ -0,0 +1,111 @@
+---
+// src/pages/booking-confirmation.astro — post-booking confirmation.
+//
+// Shows the actual booking status (so the user can see it was actually
+// confirmed/approved — not just an optimistic "you're booked") and lets them
+// cancel inline. It re-fetches the booking with the anonymous action token: the
+// server elevates (app identity) to mint a per-booking token, then reads it with
+// the no-auth `bookingsGetBookingAnonymously`. Falls back to the redirect params
+// if the lookup fails. Cancel is handled by the same <ManageBooking> island used
+// on /manage-booking.
+import Layout from "../layouts/Layout.astro";
+import ManageBooking from "../components/ManageBooking";
+import { auth } from "@wix/essentials";
+import { bookings } from "@wix/bookings";
+
+const bookingId = Astro.url.searchParams.get("bookingId");
+const startDateParam = Astro.url.searchParams.get("startDate");
+const serviceParam = Astro.url.searchParams.get("service") ?? "your service";
+
+let token: string | null = null;
+let booking: any = null;
+let canCancel = false;
+if (bookingId) {
+  try {
+    const tokenRes = await auth.elevate(bookings.getAnonymousActionToken)(bookingId);
+    token = tokenRes.token ?? null;
+    if (token) {
+      const res = await bookings.bookingsGetBookingAnonymously(token);
+      booking = res.booking ?? null;
+      canCancel = !!res.allowedAnonymousActions?.cancel;
+    }
+  } catch (err) {
+    console.error("[booking-confirmation] status lookup failed:", err);
+  }
+}
+
+const status = (booking?.status as string | undefined) ?? null; // CONFIRMED | PENDING | …
+const isPending = status === "PENDING" || status === "PENDING_APPROVAL";
+const serviceName = booking?.bookedEntity?.title ?? serviceParam;
+const startDate =
+  (booking?.startDate as string | undefined) ??
+  booking?.bookedEntity?.slot?.startDate ??
+  startDateParam ??
+  null;
+const revision = (booking?.revision as string | undefined) ?? "";
+const formattedDate = startDate
+  ? new Date(startDate).toLocaleString("en-US", {
+      weekday: "long", month: "long", day: "numeric", hour: "2-digit", minute: "2-digit",
+    })
+  : null;
+---
+
+<!-- `max-w-prose` (built-in literal = 65ch), not a bare max-w-<size> that could
+     collapse to the spacing scale. -->
+<Layout title={isPending ? "Booking received" : "Booking confirmed"}>
+  <section class="max-w-prose mx-auto px-lg py-4xl text-center">
+    <div class="w-16 h-16 rounded-full flex items-center justify-center mx-auto mb-xl"
+         style="background-color: var(--color-ink);" aria-hidden="true">
+      <span class="text-2xl" style="color: var(--color-paper);">{isPending ? "⏳" : "✓"}</span>
+    </div>
+    <hr class="editorial-rule w-16 mx-auto mb-lg" />
+    <h1 class="font-display text-4xl md:text-5xl leading-tight mb-md">
+      {isPending ? "Booking received" : "Thank you for booking"}
+    </h1>
+
+    {
+      isPending ? (
+        <p class="text-lg text-mute leading-relaxed mb-md">
+          Your request for <strong class="text-ink">{serviceName}</strong>
+          {formattedDate ? <> on <strong class="text-ink">{formattedDate}</strong></> : null} is
+          <strong class="text-ink"> awaiting confirmation</strong>. Return here anytime to check status or cancel below.
+        </p>
+      ) : formattedDate ? (
+        <p class="text-lg text-mute leading-relaxed mb-md">
+          Your spot in <strong class="text-ink">{serviceName}</strong> is <strong class="text-ink">confirmed</strong> for{" "}
+          <strong class="text-ink">{formattedDate}</strong>.
+        </p>
+      ) : bookingId ? (
+        <p class="text-lg text-mute leading-relaxed mb-md">
+          Your spot in <strong class="text-ink">{serviceName}</strong> is <strong class="text-ink">confirmed</strong>.
+        </p>
+      ) : (
+        <p class="text-lg text-mute leading-relaxed mb-md">Looking to book? Browse our services.</p>
+      )
+    }
+
+    {/* Inline cancel via ManageBooking (same anonymous-token flow as /manage-booking). */}
+    {
+      token && bookingId && (
+        <div class="mb-xl flex flex-col items-center gap-md">
+          <ManageBooking
+            token={token}
+            revision={revision}
+            serviceName={serviceName}
+            startDate={startDate}
+            status={status}
+            canCancel={canCancel}
+            showSummary={false}
+            client:only="react"
+          />
+        </div>
+      )
+    }
+
+    <div class="flex flex-col gap-md items-center">
+      <a href="/services" class="inline-block font-display text-base px-xl py-md rounded-sm"
+         style="background-color: var(--color-ink); color: var(--color-paper);">Browse more services</a>
+      <a href="/" class="text-sm text-mute hover:text-ink">Return home</a>
+    </div>
+  </section>
+</Layout>