@wix/agent-skills 1.6.0 → 1.8.0

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

@@ -0,0 +1,76 @@
+---
+// src/pages/manage-booking.astro — per-booking manage page (view + cancel).
+// Reached from the confirmation page or a shared manage link:
+//   /manage-booking?bookingId=<id>&service=<name>
+//
+// A visitor token can't list/cancel bookings (queryExtendedBookings/cancelBooking
+// are APP/MEMBER identity). The supported visitor path is the ANONYMOUS ACTION
+// TOKEN: the server elevates (app identity) to mint a per-booking token, then the
+// no-auth bookingsGet/CancelBookingAnonymously methods act on it. Minting MUST be
+// server-side; the token is then safe to hand to the browser island.
+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");
+
+let token: string | null = null;
+let booking: any = null;
+let allowed = { cancel: false, reschedule: false };
+let error: string | null = null;
+
+if (!bookingId) {
+  error = "No booking was specified.";
+} else {
+  try {
+    const tokenRes = await auth.elevate(bookings.getAnonymousActionToken)(bookingId); // APP identity → elevate
+    token = tokenRes.token ?? null;
+    if (token) {
+      const res = await bookings.bookingsGetBookingAnonymously(token); // no auth
+      booking = res.booking ?? null;
+      allowed = {
+        cancel: !!res.allowedAnonymousActions?.cancel,
+        reschedule: !!res.allowedAnonymousActions?.reschedule,
+      };
+    }
+  } catch (err) {
+    console.error("[manage-booking] load failed:", err);
+    error = "We couldn't load this booking — the link may have expired.";
+  }
+}
+
+const serviceName =
+  booking?.bookedEntity?.title ?? Astro.url.searchParams.get("service") ?? "your booking";
+const startDate =
+  (booking?.startDate as string | undefined) ??
+  booking?.bookedEntity?.slot?.startDate ??
+  Astro.url.searchParams.get("startDate") ??
+  null;
+const status = (booking?.status as string | undefined) ?? null;
+const revision = (booking?.revision as string | undefined) ?? "";
+---
+
+<Layout title="Manage your booking">
+  <section class="container-reading px-lg py-4xl">
+    <a href="/services" class="inline-block text-sm text-mute hover:text-ink mb-xl">← All services</a>
+    <hr class="editorial-rule w-16 ml-0" />
+    <h1 class="font-display text-4xl md:text-5xl leading-tight mb-xl">Manage your booking</h1>
+
+    {
+      error ? (
+        <p class="booking-error">{error}</p>
+      ) : (
+        <ManageBooking
+          token={token}
+          revision={revision}
+          serviceName={serviceName}
+          startDate={startDate}
+          status={status}
+          canCancel={allowed.cancel}
+          client:only="react"
+        />
+      )
+    }
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/bookings/services/[slug].astro

@@ -0,0 +1,81 @@
+---
+// src/pages/services/[slug].astro — SSR service detail + client-side booking flow.
+// Two dirs deep inside src/ → import with ../../ (not three ../).
+import Layout from "../../layouts/Layout.astro";
+import SeoTags from "../../components/SeoTags.astro";
+import ServiceBookingFlow from "../../components/ServiceBookingFlow";
+import { services } from "@wix/bookings";
+import { auth } from "@wix/essentials";
+
+const { slug } = Astro.params;
+
+let service: any = null;
+try {
+  // Ambient SSR via @wix/essentials; query BUILDER (object form returns 0).
+  // Fetch the small catalog and match the slug in JS (robust without a
+  // nested-field `mainSlug.name` builder filter).
+  const result = await auth.elevate(services.queryServices)().limit(100).find();
+  service =
+    (result.items ?? []).find(
+      (s: any) => (s.mainSlug?.name ?? s.supportedSlugs?.[0]?.name) === slug,
+    ) ?? null;
+} catch (err) {
+  console.error(`[services/${slug}] detail query failed:`, err);
+}
+
+if (!service) return Astro.redirect("/services", 302);
+
+const formatPrice = (p: any): string | undefined => {
+  if (!p || p.rateType === "NO_FEE") return undefined;
+  if (p.rateType === "FIXED" && p.fixed?.price) {
+    const { value, currency } = p.fixed.price;
+    if (!value) return undefined;
+    return new Intl.NumberFormat("en-US", { style: "currency", currency: currency ?? "USD" }).format(Number(value));
+  }
+  return undefined;
+};
+const price = formatPrice(service.payment);
+const duration = service.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? 60;
+const imageUrl = service.media?.mainMedia?.image?.url ?? service.media?.items?.[0]?.image?.url;
+const serviceName = service.name ?? "Service";
+const seoTags = service.seoData?.tags ?? [];
+---
+
+<!--
+  Width: use `container-reading` (max-width: var(--container-prose) + auto margins),
+  NOT a bare `max-w-<size>` — in this Tailwind v4 setup an un-emitted max-w-<size>
+  key falls back to the spacing scale (e.g. max-w-4xl → ~7rem, one word per line).
+-->
+<Layout title={serviceName} description={service.tagLine ?? service.description}>
+  <SeoTags tags={seoTags} slot="head" />
+  <section class="container-reading px-lg py-4xl">
+    <a href="/services" class="inline-block text-sm text-mute hover:text-ink mb-xl">← All services</a>
+
+    <!-- Optional banner image — only when the service has media (image-less is the
+         common seed case; rendering a fixed placeholder collapses the layout). -->
+    {imageUrl && (
+      <img src={imageUrl} alt={serviceName} class="w-full h-64 object-cover rounded-lg mb-xl" />
+    )}
+
+    <div class="flex flex-col gap-md mb-3xl">
+      <hr class="editorial-rule w-16 ml-0" />
+      <h1 class="font-display text-4xl md:text-5xl leading-tight">{serviceName}</h1>
+      {service.tagLine && <p class="text-lg text-mute leading-relaxed max-w-prose">{service.tagLine}</p>}
+      <div class="flex items-center gap-md text-sm text-mute">
+        <span>{duration} min</span>
+        {price && <span class="text-ink font-medium">{price}</span>}
+      </div>
+      {service.description && <p class="text-ink leading-relaxed max-w-prose">{service.description}</p>}
+    </div>
+
+    <section class="border-t border-rule pt-2xl">
+      <h2 class="font-display text-3xl leading-tight mb-xl">Book this service</h2>
+      <ServiceBookingFlow
+        serviceId={service._id}
+        serviceName={serviceName}
+        serviceType={service.type ?? "APPOINTMENT"}
+        client:only="react"
+      />
+    </section>
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/bookings/services/index.astro

@@ -0,0 +1,65 @@
+---
+// src/pages/services/index.astro — SSR services listing grid (APPOINTMENT or CLASS).
+// One dir deep inside src/pages → ../../ reaches src/. Adapt copy/headings to the
+// brand; keep the SSR data wiring.
+import Layout from "../../layouts/Layout.astro";
+import ServiceCard from "../../components/ServiceCard.astro";
+import { services } from "@wix/bookings";
+import { auth } from "@wix/essentials";
+
+let serviceList: any[] = [];
+try {
+  // Ambient @wix/astro SSR client via @wix/essentials (same pattern as CMS pages).
+  // Do NOT build createClient({ auth: OAuthStrategy({ clientId: import.meta.env.* }) }) —
+  // that env var is client-only and undefined at server render → 500.
+  // queryServices uses the query BUILDER; the object form returns 0 items.
+  const result = await auth.elevate(services.queryServices)().limit(100).find();
+  serviceList = (result.items ?? []).filter((s: any) => !s.hidden);
+} catch (err) {
+  console.error("[services] listing query failed:", err);
+}
+
+const getSlug = (s: any): string => s.mainSlug?.name ?? s.supportedSlugs?.[0]?.name ?? s._id;
+const formatPrice = (s: any): string | undefined => {
+  const p = s.payment;
+  if (!p || p.rateType === "NO_FEE") return undefined;
+  if (p.rateType === "FIXED" && p.fixed?.price) {
+    const { value, currency } = p.fixed.price;
+    if (!value) return undefined;
+    return new Intl.NumberFormat("en-US", { style: "currency", currency: currency ?? "USD" }).format(Number(value));
+  }
+  return undefined;
+};
+const getDuration = (s: any): number => s.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? 60;
+---
+
+<Layout title="Services">
+  <section class="max-w-6xl mx-auto px-lg py-4xl">
+    <header class="flex flex-col gap-md max-w-prose mb-3xl">
+      <hr class="editorial-rule w-16 ml-0" />
+      <h1 class="font-display text-4xl md:text-5xl leading-tight">Our Services</h1>
+      <!-- Optional brand tagline -->
+    </header>
+
+    {
+      serviceList.length === 0 ? (
+        <p class="text-mute">Services coming soon — check back shortly.</p>
+      ) : (
+        <div class="service-grid">
+          {serviceList.map((s) => (
+            <ServiceCard
+              id={s._id}
+              slug={getSlug(s)}
+              name={s.name ?? "Untitled"}
+              tagLine={s.tagLine ?? s.description}
+              durationMinutes={getDuration(s)}
+              price={formatPrice(s)}
+              imageUrl={s.media?.mainMedia?.image?.url ?? s.media?.items?.[0]?.image?.url}
+              type={s.type ?? "APPOINTMENT"}
+            />
+          ))}
+        </div>
+      )
+    }
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/ecom/components-ecom.css

@@ -0,0 +1,302 @@
+/* src/styles/components-ecom.css
+ *
+ * Ecom-pack component CSS. Owned by the ecom Phase 3 components agent.
+ *
+ * This file is the SINGLE source of truth for ecom-component classes.
+ * The designer's global.css does NOT publish .cart-summary, .cart-total,
+ * .cart-empty, or .checkout-btn — those all live here. See
+ * references/shared/STYLING.md § "Component-specific CSS is owned by the
+ * component, not the designer".
+ *
+ * Class groups in this file:
+ * - .cart-summary / .cart-total / .cart-empty / .checkout-btn → /cart page summary panel and empty state
+ * - .cart-item / .cart-item-* / .qty-* → CartView.tsx line items
+ * - .cart-discount / .cart-applied-discounts → CartView.tsx discount rows
+ * - .cart-badge / .cart-badge-* → CartBadge.tsx (mounted in Navigation)
+ *
+ * Rules use direct CSS (`var(--token)`) only — no `@apply`. Tailwind v4
+ * `@apply` in a non-entrypoint file only resolves utilities whose theme keys
+ * the designer's `@theme` block declares. Earlier revisions of this template
+ * used `@apply text-bark/70 bg-tobacco …` (stale token vocabulary) and
+ * `@apply size-6` (built-in utility that needs `@reference` to be visible
+ * here), and both classes built-failed against current designer output.
+ * Direct `var(--color-ink)` / `var(--spacing-sm)` calls work against any
+ * designer-published token set as long as the core scales exist (they always
+ * do). Use fallback chains (`var(--color-paper-warm, var(--color-paper, var(--color-cream)))`)
+ * for sometimes-published tokens.
+ */
+
+/* =========================================================================
+   Cart summary panel + total + checkout button + empty state.
+   Owned here, NOT in global.css.
+   ========================================================================= */
+.cart-summary {
+  background: var(--color-paper-warm, var(--color-paper, var(--color-cream)));
+  border: 1px solid var(--color-rule);
+  padding: var(--spacing-xl);
+  border-radius: var(--radius-md);
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+}
+@media (min-width: 768px) {
+  .cart-summary {
+    position: sticky;
+    top: var(--spacing-xl);
+  }
+}
+
+.cart-empty {
+  text-align: center;
+  padding-block: var(--spacing-3xl);
+  color: var(--color-mute);
+}
+.cart-empty .checkout-btn {
+  display: inline-flex;
+  width: auto;
+  max-width: 18rem;
+}
+
+/* .checkout-btn — primary CTA, full-width inside .cart-summary. Self-contained;
+   does NOT @apply the designer's `btn` utility (Tailwind v4 only @applies
+   utilities declared with `@utility`, and the designer may or may not have
+   declared it under that exact name). Composing the same visual shape inline
+   keeps this file portable across designer vocabularies. */
+.checkout-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--spacing-md) var(--spacing-lg);
+  font-family: var(--font-display);
+  font-size: 0.9375rem;
+  font-weight: 500;
+  background: var(--color-ink);
+  color: var(--color-paper);
+  border: 1px solid var(--color-ink);
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  width: 100%;
+  margin-top: var(--spacing-md);
+  transition: background-color 150ms ease, box-shadow 150ms ease;
+}
+.checkout-btn:hover:not(:disabled) {
+  background: var(--color-ink-soft, var(--color-ink));
+}
+.checkout-btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+/* --- Cart badge icon (CartBadge.tsx) --- */
+/* CartBadge.tsx renders an inline SVG bag icon + optional count span. */
+.cart-badge {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+.cart-badge-icon {
+  width: 1.5rem;
+  height: 1.5rem;
+  flex-shrink: 0;
+}
+.cart-badge-count {
+  position: absolute;
+  top: -0.25rem;
+  right: -0.5rem;
+  min-width: 1.25rem;
+  height: 1.25rem;
+  padding: 0 0.25rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 9999px;
+  background: var(--color-ink);
+  color: var(--color-paper);
+  font-family: var(--font-body);
+  font-size: 0.75rem;
+  font-variant-numeric: tabular-nums;
+  line-height: 1;
+}
+
+/* --- Cart line items (CartView.tsx) --- */
+.cart-item {
+  display: flex;
+  flex-direction: row;
+  gap: var(--spacing-md);
+}
+.cart-item-image {
+  flex-shrink: 0;
+}
+.cart-item-image-link {
+  display: block;
+  flex-shrink: 0;
+  cursor: pointer;
+}
+.cart-item-image-link:hover .cart-item-image,
+.cart-item-image-link:focus-visible .cart-item-image {
+  border-color: var(--color-ink);
+}
+.cart-item-name-link {
+  color: inherit;
+  cursor: pointer;
+  text-decoration: none;
+  border-bottom: 1px solid var(--color-mute);
+  padding-bottom: 1px;
+  transition: color 150ms ease, border-color 150ms ease;
+}
+.cart-item-name-link:hover,
+.cart-item-name-link:focus-visible {
+  color: var(--color-accent);
+  outline: none;
+  border-bottom-color: var(--color-accent);
+}
+.cart-item-info {
+  flex: 1;
+  min-width: 0;
+}
+
+/* --- Description lines & modifiers --- */
+.cart-item-option {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  margin: 0.125rem 0;
+}
+.cart-item-modifiers {
+  margin-top: 0.25rem;
+}
+
+/* --- Quantity stepper --- */
+.cart-item-qty {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--spacing-sm);
+  margin-top: var(--spacing-sm);
+  width: fit-content;
+}
+.qty-btn {
+  width: 1.75rem;
+  height: 1.75rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: 1px solid var(--color-ink);
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--color-ink);
+  cursor: pointer;
+  font-family: var(--font-body);
+  font-size: 1rem;
+  line-height: 1;
+}
+.qty-btn:disabled {
+  opacity: 0.3;
+  cursor: not-allowed;
+}
+.qty-value {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  min-width: 1.5rem;
+  text-align: center;
+  font-variant-numeric: tabular-nums;
+}
+
+/* --- Unavailable state --- */
+.cart-item-unavailable {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--color-error, #c0392b);
+}
+
+/* --- Price + remove --- */
+.cart-item-actions {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-end;
+  gap: 0.25rem;
+  flex-shrink: 0;
+}
+.cart-item-prices {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-sm);
+}
+.cart-item-full-price {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  text-decoration: line-through;
+}
+.cart-item-unit-price {
+  font-family: var(--font-body);
+  font-weight: 600;
+  white-space: nowrap;
+}
+.cart-item-line-total {
+  font-family: var(--font-body);
+  font-size: 0.75rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  margin: 0;
+}
+.cart-item-remove {
+  background: transparent;
+  border: none;
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-mute);
+  cursor: pointer;
+  text-decoration: underline;
+}
+
+/* --- Cart summary: discount + total rows ---
+   Subtotal uses the designer's .cart-subtotal contract class in global.css.
+   These rows appear only when priceSummary exposes a discount or a total
+   that differs from subtotal (see CartView.tsx extractSummary). */
+.cart-discount {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: var(--spacing-sm);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  margin-top: var(--spacing-sm);
+}
+.cart-discount-name {
+  font-size: 0.75rem;
+  color: var(--color-ink-soft, var(--color-mute));
+}
+.cart-discount-amount {
+  white-space: nowrap;
+}
+.cart-total {
+  border-top: 1px solid var(--color-rule);
+  padding-top: var(--spacing-md);
+  margin-top: var(--spacing-sm);
+  font-family: var(--font-display);
+  font-size: 1.25rem;
+  font-weight: 500;
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+}
+
+/* Applied-discounts row — name-only (no amount) for cases where the API
+   reports a promo NAME via appliedDiscounts[].discountName but no cart-level
+   amount in priceSummary.discount (common for line-item automatic discounts
+   — the savings already show inline via fullPrice/price strikethrough). */
+.cart-applied-discounts {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: var(--spacing-sm);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  margin-top: var(--spacing-sm);
+}
+.cart-applied-discounts-name {
+  text-align: right;
+  color: var(--color-ink-soft, var(--color-mute));
+  font-style: italic;
+}