@tribe-nest/forge 3.63.0 → 3.65.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tribe-nest/forge",
-  "version": "3.63.0",
+  "version": "3.65.0",
   "publishConfig": {
     "access": "public"
   },

package/src/data/queries/useCoachingAvailability.ts

@@ -35,16 +35,25 @@ export type ReserveCoachingBookingResult = {
    * held, and the buyer's rights are governed by this copy, not by that read.
    */
   cancellation?: CancellationTermsView | null;
+  /** How many sessions this booking holds (1 for a single session). */
+  sessionCount?: number;
+  /** Every session held, earliest first. `bookingId` above is the first one's. */
+  sessions?: { bookingId: string; slotId: string; startTime: string; endTime: string }[];
+  /** When the server releases the hold (ISO). */
+  holdExpiresAt?: string;
 };
 
-/** Reserve a coaching booking slot. Returns the created booking + its agreed terms. */
+/**
+ * Reserve a booking: one slot, or every session of a multi-session booking at
+ * once (`slotIds`). All or nothing: if any time was just taken, nothing is held.
+ */
 export function useReserveCoachingBooking(productId?: string) {
   const { client } = useForge();
 
-  return useMutation<ReserveCoachingBookingResult, unknown, { slotId: string }>({
-    mutationFn: async ({ slotId }) => {
+  return useMutation<ReserveCoachingBookingResult, unknown, { slotId?: string; slotIds?: string[] }>({
+    mutationFn: async ({ slotId, slotIds }) => {
       const res = await client.post(`/public/coaching/products/${productId}/booking/reserve`, {
-        slotId,
+        ...(slotIds?.length ? { slotIds } : { slotId }),
         metaSignals: readMetaSignals(),
       });
       return res.data;
@@ -106,10 +115,13 @@ export function useUpdateCoachingBooking(productId?: string) {
 export function useUnreserveCoachingBooking(productId?: string) {
   const { client } = useForge();
 
-  return useMutation<unknown, unknown, { bookingId: string }>({
-    mutationFn: async ({ bookingId }) => {
+  return useMutation<unknown, unknown, { bookingId: string; bookingSecret?: string }>({
+    // The secret is required: without it the backend answers 404 for a guest's
+    // hold and the times stay held until the hold expires.
+    mutationFn: async ({ bookingId, bookingSecret }) => {
       const res = await client.post(`/public/coaching/products/${productId}/booking/unreserve`, {
         bookingId,
+        bookingSecret,
       });
       return res.data;
     },

package/src/data/queries/useMyBookings.ts

@@ -83,6 +83,13 @@ export type MyBooking = {
   lastName: string | null;
   /** Already a number (or null for a free session), not a decimal string. */
   totalAmount: number | null;
+  /**
+   * Set on every session of a multi-session booking except the first, which
+   * carries the payment for all of them. Null on a single session.
+   */
+  packageLeadBookingId?: string | null;
+  /** How many sessions the booking this session belongs to holds (1 = single). */
+  sessionCount?: number;
   totalAmountInChargedCurrency: string | number | null;
   currency: string | null;
   chargedCurrency: string | null;

package/src/i18n/de.json

@@ -20,6 +20,7 @@
   "forge.account_dashboard.booking_duration": "{minutes} Minuten",
   "forge.account_dashboard.booking_join_label": "Teilnehmen:",
   "forge.account_dashboard.booking_join_video": "Videoanruf beitreten",
+  "forge.account_dashboard.booking_part_of": "Teil einer Buchung mit {count} Terminen",
   "forge.account_dashboard.booking_video_call": "Videoanruf auf dieser Website",
   "forge.account_dashboard.booking_video_closed": "Videoanruf: Der Raum dieser Session ist geschlossen",
   "forge.account_dashboard.booking_video_opens_at": "Videoanruf: Der Raum öffnet {datetime}",
@@ -365,7 +366,10 @@
   "forge.broadcast_poll.votes_other": "{count} Stimmen",
   "forge.broadcast_poll.your_vote": "(deine Stimme)",
   "forge.broadcast_ticket_purchase.buy_tickets": "Tickets kaufen",
+  "forge.broadcast_ticket_purchase.free": "Kostenlos",
+  "forge.broadcast_ticket_purchase.free_to_price": "Kostenlos bis {price}",
   "forge.broadcast_ticket_purchase.from_price": "Ab {price}",
+  "forge.broadcast_ticket_purchase.reserve": "Reservieren",
   "forge.broadcast_watch.leave": "Übertragung verlassen",
   "forge.broadcast_watch.load_error": "Übertragung konnte nicht geladen werden",
   "forge.bundle_confirmation.continue_shopping": "Weiter einkaufen",
@@ -693,17 +697,33 @@
   "forge.checkout_confirmation.total_paid": "Bezahlt gesamt",
   "forge.checkout_confirmation.view_orders": "Bestellungen ansehen",
   "forge.coaching_booking.aria_close": "Schließen",
+  "forge.coaching_booking.aria_next_month": "Nächster Monat",
   "forge.coaching_booking.aria_next_week": "Nächste Woche",
+  "forge.coaching_booking.aria_prev_month": "Vorheriger Monat",
   "forge.coaching_booking.aria_prev_week": "Vorherige Woche",
   "forge.coaching_booking.back": "Zurück",
+  "forge.coaching_booking.basket_count_package": "{picked} von {count} gewählt",
+  "forge.coaching_booking.basket_count_range": "{picked} gewählt, bis zu {max}",
+  "forge.coaching_booking.basket_empty": "Noch keine Zeit gewählt",
+  "forge.coaching_booking.basket_full_limit": "Das ist das Limit von {max} Terminen. Entferne einen, um eine andere Zeit zu wählen.",
+  "forge.coaching_booking.basket_full_package": "Alle {count} Termine gewählt. Entferne einen, um eine andere Zeit zu wählen.",
+  "forge.coaching_booking.basket_more": "Noch {count} zu wählen",
+  "forge.coaching_booking.basket_title_many": "Deine Termine",
+  "forge.coaching_booking.basket_title_package": "Deine {count} Termine",
+  "forge.coaching_booking.basket_title_single": "Dein Termin",
   "forge.coaching_booking.confirm_booking": "Buchung bestätigen",
   "forge.coaching_booking.confirm_email_placeholder": "E-Mail bestätigen",
   "forge.coaching_booking.confirm_leave": "Möchtest du die Kasse wirklich verlassen?",
   "forge.coaching_booking.consent": "Mit dem Fortfahren stimmst du zu, Buchungsbestätigungen und wichtige Infos zu deiner Session per E-Mail zu bekommen.",
   "forge.coaching_booking.continue": "Weiter",
   "forge.coaching_booking.continue_to_payment": "Weiter zur Zahlung",
+  "forge.coaching_booking.continue_with_total": "Weiter, {amount}",
+  "forge.coaching_booking.day_has_times": "{date}, Zeiten verfügbar",
+  "forge.coaching_booking.day_no_times": "{date}, keine Zeiten",
   "forge.coaching_booking.details_subtitle": "Bitte gib deine Kontaktdaten für die Buchung an.",
   "forge.coaching_booking.details_title": "Kontaktdaten",
+  "forge.coaching_booking.done": "Fertig",
+  "forge.coaching_booking.duration_short": "{minutes} Min.",
   "forge.coaching_booking.email_invalid_hint": "Bitte gib eine gültige E-Mail-Adresse ein",
   "forge.coaching_booking.email_mismatch_hint": "Die E-Mail-Adressen stimmen nicht überein",
   "forge.coaching_booking.email_placeholder": "E-Mail",
@@ -715,14 +735,29 @@
   "forge.coaching_booking.first_name_placeholder": "Vorname",
   "forge.coaching_booking.last_name_placeholder": "Nachname",
   "forge.coaching_booking.loading_slots": "Freie Termine werden geladen…",
+  "forge.coaching_booking.next_available": "Nächster freier Termin",
   "forge.coaching_booking.no_slots": "Diese Woche sind keine Termine frei.",
+  "forge.coaching_booking.no_times_day": "An diesem Tag sind keine Zeiten frei.",
+  "forge.coaching_booking.no_times_month": "In diesem Monat sind keine Zeiten frei.",
   "forge.coaching_booking.not_found": "Coaching-Session nicht gefunden.",
+  "forge.coaching_booking.not_picked_yet": "Noch nicht gewählt",
+  "forge.coaching_booking.package_help_body": "Du wählst jetzt alle Termine und zahlst einmal. Jeden Termin kannst du später einzeln verschieben, nach den beim Checkout gezeigten Storno- und Verschiebungsbedingungen.",
+  "forge.coaching_booking.package_help_label": "Wie funktioniert ein Paket?",
+  "forge.coaching_booking.package_one_price": "{count} Termine, ein Preis",
+  "forge.coaching_booking.package_total": "{price} für alle {count}",
   "forge.coaching_booking.pay": "{amount} zahlen",
   "forge.coaching_booking.payment_not_configured": "Zahlung ist nicht eingerichtet.",
   "forge.coaching_booking.payment_subtitle": "Schließe den Kauf ab, um deine Buchung zu sichern.",
   "forge.coaching_booking.payment_title": "Zahlung",
+  "forge.coaching_booking.per_session_calc": "{count} × {price}",
+  "forge.coaching_booking.pick_a_time": "Wähle eine Zeit",
+  "forge.coaching_booking.pick_day": "Wähle einen markierten Tag, um seine Zeiten zu sehen.",
+  "forge.coaching_booking.pick_more": "Noch {count} wählen",
   "forge.coaching_booking.preparing_payment": "Zahlung wird vorbereitet…",
+  "forge.coaching_booking.price_per_session": "{price} pro Termin",
   "forge.coaching_booking.processing": "Wird verarbeitet…",
+  "forge.coaching_booking.remove": "Entfernen",
+  "forge.coaching_booking.remove_time": "{time} entfernen",
   "forge.coaching_booking.reserving": "Wird reserviert…",
   "forge.coaching_booking.select_placeholder": "Auswählen…",
   "forge.coaching_booking.slot_title": "Termin wählen",
@@ -756,6 +791,7 @@
   "forge.coaching_confirmation.row_paid": "Bezahlt",
   "forge.coaching_confirmation.row_reference": "Referenz",
   "forge.coaching_confirmation.row_session": "Session",
+  "forge.coaching_confirmation.row_session_n": "Termin {index} von {count}",
   "forge.coaching_confirmation.row_tax": "MwSt.",
   "forge.coaching_confirmation.status_unknown": "ungeklärt",
   "forge.coaching_confirmation.tax_included": "Enthält {amount} MwSt.",
@@ -764,6 +800,10 @@
   "forge.coaching_detail.about_title": "Über diese Session",
   "forge.coaching_detail.duration_minutes": "{minutes} Minuten",
   "forge.coaching_detail.not_found": "Coaching-Session nicht gefunden.",
+  "forge.coaching_detail.price_for_sessions": "für {count} Termine",
+  "forge.coaching_detail.price_per_session_suffix": "pro Termin",
+  "forge.coaching_detail.price_save": "Spare {amount}",
+  "forge.coaching_detail.price_up_to": "Bis zu {max} auf einmal buchen",
   "forge.cohort_checkout.aria_close": "Schließen",
   "forge.cohort_checkout.authorise_future_payments": "Autorisiere die späteren Zahlungen dieses Plans.",
   "forge.cohort_checkout.back": "Zurück",
@@ -1428,7 +1468,10 @@
   "forge.event_detail.location_virtual": "Online",
   "forge.event_detail.not_found": "Event nicht gefunden.",
   "forge.event_detail.presale_only": "Tickets für dieses Event gibt es nur im Vorverkauf.",
+  "forge.event_detail.price_free": "Kostenlos",
+  "forge.event_detail.price_free_to": "Kostenlos bis {max}",
   "forge.event_detail.price_from_label": "Ab",
+  "forge.event_detail.reserve": "Reservieren",
   "forge.event_seat_picker.dismiss": "Schließen",
   "forge.event_seat_picker.empty": "Es gibt noch keine Plätze zur Auswahl.",
   "forge.event_seat_picker.help_body": "Tippe auf einen Platz, um ihn auszuwählen, und noch einmal, um ihn freizugeben. Zoome mit zwei Fingern oder dem Mausrad und ziehe, um den Plan zu verschieben. Graue Plätze sind nicht verfügbar. Beste verfügbare wählt die niedrigsten zusammenhängenden Plätze für dich.",
@@ -1487,6 +1530,7 @@
   "forge.event_tickets.expires_hours_soon_other": "⏰ Läuft in {count} Stunden ab!",
   "forge.event_tickets.field_required": "Dieses Feld ist erforderlich",
   "forge.event_tickets.first_name_placeholder": "Vorname",
+  "forge.event_tickets.free": "Kostenlos",
   "forge.event_tickets.invalid_email": "Bitte gib eine gültige E-Mail-Adresse ein",
   "forge.event_tickets.item_label_event": "Dieses Event",
   "forge.event_tickets.item_label_ticket": "Dieses Ticket",
@@ -1514,6 +1558,7 @@
   "forge.event_tickets.pwyw_range_min_max": "(mindestens {min}, bis {max})",
   "forge.event_tickets.remove_discount": "Rabatt entfernen",
   "forge.event_tickets.request_tickets": "Tickets anfragen",
+  "forge.event_tickets.reserve": "Reservieren",
   "forge.event_tickets.seat_best_available": "Beste verfügbare",
   "forge.event_tickets.seat_remove_aria": "{seat} entfernen",
   "forge.event_tickets.seats_left_one": "{count} Platz frei",
@@ -2228,6 +2273,7 @@
   "forge.review_form.title_placeholder": "Fass es in ein paar Worten zusammen",
   "forge.review_form.update_submit": "Bewertung aktualisieren",
   "forge.seat_legend.aria_label": "Legende",
+  "forge.seat_legend.free": "Kostenlos",
   "forge.seat_legend.left_one": "{count} frei",
   "forge.seat_legend.left_other": "{count} frei",
   "forge.seat_legend.selected": "Ausgewählt",

package/src/i18n/en.json

@@ -20,6 +20,7 @@
   "forge.account_dashboard.booking_duration": "{minutes} minutes",
   "forge.account_dashboard.booking_join_label": "Join:",
   "forge.account_dashboard.booking_join_video": "Join video call",
+  "forge.account_dashboard.booking_part_of": "Part of a {count}-session booking",
   "forge.account_dashboard.booking_video_call": "Video call on this site",
   "forge.account_dashboard.booking_video_closed": "Video call: this session's room has closed",
   "forge.account_dashboard.booking_video_opens_at": "Video call: the room opens {datetime}",
@@ -365,7 +366,10 @@
   "forge.broadcast_poll.votes_other": "{count} votes",
   "forge.broadcast_poll.your_vote": "(your vote)",
   "forge.broadcast_ticket_purchase.buy_tickets": "Buy tickets",
+  "forge.broadcast_ticket_purchase.free": "Free",
+  "forge.broadcast_ticket_purchase.free_to_price": "Free to {price}",
   "forge.broadcast_ticket_purchase.from_price": "From {price}",
+  "forge.broadcast_ticket_purchase.reserve": "Reserve",
   "forge.broadcast_watch.leave": "Leave broadcast",
   "forge.broadcast_watch.load_error": "Unable to load broadcast",
   "forge.bundle_confirmation.continue_shopping": "Continue shopping",
@@ -693,17 +697,33 @@
   "forge.checkout_confirmation.total_paid": "Total paid",
   "forge.checkout_confirmation.view_orders": "View your orders",
   "forge.coaching_booking.aria_close": "Close",
+  "forge.coaching_booking.aria_next_month": "Next month",
   "forge.coaching_booking.aria_next_week": "Next week",
+  "forge.coaching_booking.aria_prev_month": "Previous month",
   "forge.coaching_booking.aria_prev_week": "Previous week",
   "forge.coaching_booking.back": "Back",
+  "forge.coaching_booking.basket_count_package": "{picked} of {count} picked",
+  "forge.coaching_booking.basket_count_range": "{picked} picked, up to {max}",
+  "forge.coaching_booking.basket_empty": "No time picked yet",
+  "forge.coaching_booking.basket_full_limit": "That is the {max} session limit. Remove one to choose a different time.",
+  "forge.coaching_booking.basket_full_package": "All {count} sessions picked. Remove one to choose a different time.",
+  "forge.coaching_booking.basket_more": "{count} more to pick",
+  "forge.coaching_booking.basket_title_many": "Your sessions",
+  "forge.coaching_booking.basket_title_package": "Your {count} sessions",
+  "forge.coaching_booking.basket_title_single": "Your session",
   "forge.coaching_booking.confirm_booking": "Confirm Booking",
   "forge.coaching_booking.confirm_email_placeholder": "Confirm email",
   "forge.coaching_booking.confirm_leave": "Are you sure you want to leave checkout?",
   "forge.coaching_booking.consent": "By continuing, you agree to receive booking confirmations and important updates about your session via email.",
   "forge.coaching_booking.continue": "Continue",
   "forge.coaching_booking.continue_to_payment": "Continue to payment",
+  "forge.coaching_booking.continue_with_total": "Continue, {amount}",
+  "forge.coaching_booking.day_has_times": "{date}, times available",
+  "forge.coaching_booking.day_no_times": "{date}, no times",
   "forge.coaching_booking.details_subtitle": "Please provide your contact information for the booking.",
   "forge.coaching_booking.details_title": "Contact Information",
+  "forge.coaching_booking.done": "Done",
+  "forge.coaching_booking.duration_short": "{minutes} min",
   "forge.coaching_booking.email_invalid_hint": "Please enter a valid email address",
   "forge.coaching_booking.email_mismatch_hint": "Email addresses do not match",
   "forge.coaching_booking.email_placeholder": "Email",
@@ -715,14 +735,29 @@
   "forge.coaching_booking.first_name_placeholder": "First name",
   "forge.coaching_booking.last_name_placeholder": "Last name",
   "forge.coaching_booking.loading_slots": "Loading available slots…",
+  "forge.coaching_booking.next_available": "Next available",
   "forge.coaching_booking.no_slots": "No available slots for this week.",
+  "forge.coaching_booking.no_times_day": "No open times on this day.",
+  "forge.coaching_booking.no_times_month": "No open times this month.",
   "forge.coaching_booking.not_found": "Coaching session not found.",
+  "forge.coaching_booking.not_picked_yet": "Not picked yet",
+  "forge.coaching_booking.package_help_body": "You pick every session now and pay once. Each session can be rescheduled on its own later, under the cancellation and reschedule terms shown at checkout.",
+  "forge.coaching_booking.package_help_label": "How does a package work?",
+  "forge.coaching_booking.package_one_price": "{count} sessions, one price",
+  "forge.coaching_booking.package_total": "{price} for all {count}",
   "forge.coaching_booking.pay": "Pay {amount}",
   "forge.coaching_booking.payment_not_configured": "Payment is not configured.",
   "forge.coaching_booking.payment_subtitle": "Complete your purchase to secure your booking.",
   "forge.coaching_booking.payment_title": "Payment",
+  "forge.coaching_booking.per_session_calc": "{count} × {price}",
+  "forge.coaching_booking.pick_a_time": "Pick a time",
+  "forge.coaching_booking.pick_day": "Pick a highlighted day to see its times.",
+  "forge.coaching_booking.pick_more": "Pick {count} more",
   "forge.coaching_booking.preparing_payment": "Preparing payment…",
+  "forge.coaching_booking.price_per_session": "{price} per session",
   "forge.coaching_booking.processing": "Processing…",
+  "forge.coaching_booking.remove": "Remove",
+  "forge.coaching_booking.remove_time": "Remove {time}",
   "forge.coaching_booking.reserving": "Reserving…",
   "forge.coaching_booking.select_placeholder": "Select…",
   "forge.coaching_booking.slot_title": "Select Availability",
@@ -756,6 +791,7 @@
   "forge.coaching_confirmation.row_paid": "Paid",
   "forge.coaching_confirmation.row_reference": "Reference",
   "forge.coaching_confirmation.row_session": "Session",
+  "forge.coaching_confirmation.row_session_n": "Session {index} of {count}",
   "forge.coaching_confirmation.row_tax": "Tax",
   "forge.coaching_confirmation.status_unknown": "unresolved",
   "forge.coaching_confirmation.tax_included": "Includes {amount} tax",
@@ -764,6 +800,10 @@
   "forge.coaching_detail.about_title": "About this session",
   "forge.coaching_detail.duration_minutes": "{minutes} minutes",
   "forge.coaching_detail.not_found": "Coaching session not found.",
+  "forge.coaching_detail.price_for_sessions": "for {count} sessions",
+  "forge.coaching_detail.price_per_session_suffix": "per session",
+  "forge.coaching_detail.price_save": "Save {amount}",
+  "forge.coaching_detail.price_up_to": "Book up to {max} at once",
   "forge.cohort_checkout.aria_close": "Close",
   "forge.cohort_checkout.authorise_future_payments": "Authorise the later payments on this plan.",
   "forge.cohort_checkout.back": "Back",
@@ -1428,7 +1468,10 @@
   "forge.event_detail.location_virtual": "Virtual",
   "forge.event_detail.not_found": "Event not found.",
   "forge.event_detail.presale_only": "Tickets for this event are presale only.",
+  "forge.event_detail.price_free": "Free",
+  "forge.event_detail.price_free_to": "Free to {max}",
   "forge.event_detail.price_from_label": "From",
+  "forge.event_detail.reserve": "Reserve",
   "forge.event_seat_picker.dismiss": "Dismiss",
   "forge.event_seat_picker.empty": "There are no seats to choose from yet.",
   "forge.event_seat_picker.help_body": "Tap a seat to choose it and tap it again to let it go. Pinch or scroll to zoom, drag to move around the map. Grey seats are not available. Best available picks the lowest seats together for you.",
@@ -1487,6 +1530,7 @@
   "forge.event_tickets.expires_hours_soon_other": "⏰ Expires in {count} hours!",
   "forge.event_tickets.field_required": "This field is required",
   "forge.event_tickets.first_name_placeholder": "First name",
+  "forge.event_tickets.free": "Free",
   "forge.event_tickets.invalid_email": "Please enter a valid email address",
   "forge.event_tickets.item_label_event": "This event",
   "forge.event_tickets.item_label_ticket": "This ticket",
@@ -1514,6 +1558,7 @@
   "forge.event_tickets.pwyw_range_min_max": "(minimum {min}, up to {max})",
   "forge.event_tickets.remove_discount": "Remove discount",
   "forge.event_tickets.request_tickets": "Request tickets",
+  "forge.event_tickets.reserve": "Reserve",
   "forge.event_tickets.seat_best_available": "Best available",
   "forge.event_tickets.seat_remove_aria": "Remove {seat}",
   "forge.event_tickets.seats_left_one": "{count} seat left",
@@ -2228,6 +2273,7 @@
   "forge.review_form.title_placeholder": "Sum it up in a few words",
   "forge.review_form.update_submit": "Update review",
   "forge.seat_legend.aria_label": "Map key",
+  "forge.seat_legend.free": "Free",
   "forge.seat_legend.left_one": "{count} left",
   "forge.seat_legend.left_other": "{count} left",
   "forge.seat_legend.selected": "Selected",

package/src/runtime/pages.ts

@@ -108,6 +108,8 @@ export const INTERNAL_PAGES = [
   "live",
   "live/$broadcastId",
   "login",
+  // SEO step 7, lane S2: a customer connects their assistant to the site MCP.
+  "oauth/authorize",
   "payment-link/$paymentLinkId",
   "payment-link/$paymentLinkId/finalise",
   "podcasts",

package/src/seo/_tests/seo.spec.ts

@@ -1,9 +1,13 @@
-import { describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   applySeoToHead,
   applyTitleTemplate,
   findOverride,
+  isMarkdownPath,
+  isNotFoundContext,
+  markdownAlternateHref,
   normalizePathname,
+  pathnameFromContext,
   resolvePageSeo,
   seoHead,
   siteSeoHead,
@@ -38,6 +42,9 @@ const RECORD: SeoRecord = {
 
 const record = (patch: Partial<SeoRecord> = {}): SeoRecord => ({ ...RECORD, ...patch });
 
+/** The readable-copy link a page states beside its canonical. */
+const md = (url: string) => ({ rel: "alternate", type: "text/markdown", href: `${url}?md` });
+
 /** A head() context shaped like TanStack's: root match first, leaf last. */
 function ctx(pathname: string, seo: SeoRecord | null | undefined, fullPath = pathname): SeoHeadContext {
   const leaf = { pathname, fullPath, routeId: fullPath, loaderData: {} };
@@ -86,6 +93,31 @@ describe("applyTitleTemplate", () => {
   });
 });
 
+describe("a stored title template without {title}", () => {
+  it("is ignored for the default rather than printed", () => {
+    expect(applyTitleTemplate("About", "Clay Studio", "%s | Clay Studio")).toBe("About | Clay Studio");
+    expect(applyTitleTemplate("About", "Clay Studio", "Clay Studio")).toBe("About | Clay Studio");
+    // A usable one still applies, with either site placeholder.
+    expect(applyTitleTemplate("About", "Clay Studio", "{site.name}: {title}")).toBe("Clay Studio: About");
+  });
+
+  it("on the site falls back to the default, and on a page type falls back to the site's", () => {
+    const broken = resolvePageSeo(record({ titleTemplate: "%s | Clay Studio" }), { pathname: "/about", title: "About" });
+    expect(broken.title).toBe("About | Clay Studio");
+
+    const seo = record({ titleTemplate: "{title} - {site}", typeTemplates: { product: { title: "Shop" } } });
+    expect(resolvePageSeo(seo, { pathname: "/i/store/mug", type: "product", title: "Mug" }).title).toBe("Mug - Clay Studio");
+    const good = record({ typeTemplates: { product: { title: "{title} | Shop | {site}" } } });
+    expect(resolvePageSeo(good, { pathname: "/i/store/mug", type: "product", title: "Mug" }).title).toBe("Mug | Shop | Clay Studio");
+  });
+
+  it("never reaches a page's document title through seoHead", () => {
+    const t = tags(seoHead(ctx("/about", record({ titleTemplate: "%s | Clay Studio" })), { title: "About" }).meta);
+    expect(t.title).toBe("About | Clay Studio");
+    expect(t.title).not.toContain("%s");
+  });
+});
+
 describe("findOverride", () => {
   it("prefers the exact pathname and fills gaps from the route pattern", () => {
     const seo = record({
@@ -214,19 +246,25 @@ describe("siteSeoHead", () => {
       "msvalidate.01": "b-token",
     });
     expect(t.robots).toBeUndefined();
-    expect(out.links).toEqual([{ rel: "canonical", href: "https://claystudio.com/about" }]);
+    expect(out.links).toEqual([
+      { rel: "canonical", href: "https://claystudio.com/about" },
+      md("https://claystudio.com/about"),
+    ]);
   });
 
   it("uses an override canonical", () => {
     const seo = record({ pages: { "/about": { canonical: "https://claystudio.com/story" } } });
-    expect(siteSeoHead(ctx("/about", seo)).links).toEqual([{ rel: "canonical", href: "https://claystudio.com/story" }]);
+    expect(siteSeoHead(ctx("/about", seo)).links).toEqual([
+      { rel: "canonical", href: "https://claystudio.com/story" },
+      md("https://claystudio.com/story"),
+    ]);
   });
 
   it("emits no canonical under /i/, where the hosted page emits its own", () => {
     expect(siteSeoHead(ctx("/i/store/mug", RECORD)).links).toEqual([]);
     expect(siteSeoHead(ctx("/i", RECORD)).links).toEqual([]);
     // A creator page that merely starts with "i" is not hosted.
-    expect(siteSeoHead(ctx("/ideas", RECORD)).links).toHaveLength(1);
+    expect(siteSeoHead(ctx("/ideas", RECORD)).links).toHaveLength(2);
   });
 
   it("noindexes when the site is not indexing or the path's override says so", () => {
@@ -266,6 +304,94 @@ describe("siteSeoHead", () => {
   });
 });
 
+/**
+ * A not-found render, shaped as TanStack builds it.
+ *
+ * A URL no route matches leaves ONLY the root match, at "/", marked
+ * `_notFound`. A route whose loader threw `notFound()` keeps its own match with
+ * `status: "notFound"`, and the boundary above it carries `_notFound`.
+ */
+function globalNotFoundCtx(seo: SeoRecord | null | undefined): SeoHeadContext {
+  const root = { pathname: "/", fullPath: "/", routeId: "__root__", loaderData: { seo }, _notFound: true, status: "success" };
+  return { matches: [root], match: root, params: {} };
+}
+function thrownNotFoundCtx(pathname: string, seo: SeoRecord | null | undefined, fullPath = pathname): SeoHeadContext {
+  const leaf = { pathname, fullPath, routeId: fullPath, loaderData: undefined, status: "notFound", _notFound: true };
+  return {
+    matches: [{ pathname: "/", fullPath: "/", routeId: "__root__", loaderData: { seo }, status: "success" }, leaf],
+    match: leaf,
+    params: {},
+  };
+}
+
+describe("a not-found render", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it("is recognised from either TanStack marker, and a normal render is not", () => {
+    expect(isNotFoundContext(globalNotFoundCtx(RECORD))).toBe(true);
+    expect(isNotFoundContext(thrownNotFoundCtx("/blog/gone", RECORD))).toBe(true);
+    expect(isNotFoundContext(ctx("/", RECORD))).toBe(false);
+    expect(isNotFoundContext(ctx("/about", RECORD))).toBe(false);
+    expect(isNotFoundContext(undefined)).toBe(false);
+  });
+
+  it("reads its pathname from the location, not the root match's \"/\"", () => {
+    vi.stubGlobal("location", { pathname: "/no-such-page/" });
+    expect(pathnameFromContext(globalNotFoundCtx(RECORD))).toBe("/no-such-page");
+    // A page that exists keeps its leaf, whatever the location says.
+    expect(pathnameFromContext(ctx("/about", RECORD))).toBe("/about");
+  });
+
+  it("on an unmatched URL states no canonical, no Markdown copy and no site JSON-LD, and is noindex", () => {
+    const out = siteSeoHead(globalNotFoundCtx(RECORD));
+    expect(out.links).toEqual([]);
+    expect(jsonLd(out.meta)).toEqual([]);
+    const t = tags(out.meta);
+    expect(t.robots).toBe("noindex, nofollow");
+    // The site-wide fallbacks still hold, so the page is not bare.
+    expect(t.title).toBe("Clay Studio");
+    expect(t["og:site_name"]).toBe("Clay Studio");
+    expect(t["google-site-verification"]).toBe("g-token");
+  });
+
+  it("does the same in the browser, where the location is known", () => {
+    vi.stubGlobal("location", { pathname: "/no-such-page" });
+    const out = siteSeoHead(globalNotFoundCtx(RECORD));
+    expect(out.links).toEqual([]);
+    expect(jsonLd(out.meta)).toEqual([]);
+    expect(tags(out.meta).robots).toBe("noindex, nofollow");
+  });
+
+  it("ignores an override for \"/\" that would otherwise apply to the root match", () => {
+    const seo = record({ pages: { "/": { canonical: "https://claystudio.com/home" } } });
+    expect(siteSeoHead(globalNotFoundCtx(seo)).links).toEqual([]);
+  });
+
+  it("when a loader threw notFound(), the root and the page both say noindex and state no URL", () => {
+    const root = siteSeoHead(thrownNotFoundCtx("/blog/gone", RECORD, "/blog/$slug"));
+    expect(root.links).toEqual([]);
+    expect(tags(root.meta).robots).toBe("noindex, nofollow");
+
+    const page = seoHead(thrownNotFoundCtx("/blog/gone", RECORD, "/blog/$slug"), {
+      title: "Gone",
+      jsonLd: { "@type": "BlogPosting" },
+    });
+    const t = tags(page.meta);
+    expect(t.robots).toBe("noindex, nofollow");
+    expect(t["og:url"]).toBeUndefined();
+    expect(jsonLd(page.meta)).toEqual([]);
+  });
+
+  it("leaves the home page exactly as it was", () => {
+    const home = siteSeoHead(ctx("/", RECORD));
+    expect(home.links[0]).toEqual({ rel: "canonical", href: "https://claystudio.com/" });
+    expect(jsonLd(home.meta).map((n) => n["@type"])).toEqual(["WebSite", "LocalBusiness"]);
+    expect(tags(home.meta).robots).toBeUndefined();
+  });
+});
+
 describe("applySeoToHead", () => {
   const productHead = () => ({
     ...buildHeadMeta({ title: "Mug", description: "A mug.", image: "https://cdn.example/mug.jpg", ogType: "product" }),
@@ -286,7 +412,10 @@ describe("applySeoToHead", () => {
     expect(t["og:type"]).toBe("product");
     expect(t["og:site_name"]).toBe("Clay Studio");
     expect(t["og:url"]).toBe("https://claystudio.com/i/store/mug");
-    expect(out.links).toEqual([{ rel: "canonical", href: "https://claystudio.com/i/store/mug" }]);
+    expect(out.links).toEqual([
+      { rel: "canonical", href: "https://claystudio.com/i/store/mug" },
+      md("https://claystudio.com/i/store/mug"),
+    ]);
     expect(out.scripts).toEqual([{ type: "application/ld+json", children: "{}" }]);
     // Exactly one of each: the old entries were replaced, not appended to.
     expect(out.meta!.filter((m) => m.name === "description")).toHaveLength(1);
@@ -296,7 +425,7 @@ describe("applySeoToHead", () => {
   it("canonicalizes an index page to its own website", () => {
     const seo = record({ origin: "https://shop.example", defaultWebsiteOrigin: "https://claystudio.com" });
     const out = applySeoToHead(buildHeadMeta({ title: "Store" }), seo, "/i/store", "page");
-    expect(out.links).toEqual([{ rel: "canonical", href: "https://shop.example/i/store" }]);
+    expect(out.links).toEqual([{ rel: "canonical", href: "https://shop.example/i/store" }, md("https://shop.example/i/store")]);
   });
 
   it("applies overrides by pathname and by pattern", () => {
@@ -324,3 +453,70 @@ describe("applySeoToHead", () => {
     expect(out.links).toEqual([]);
   });
 });
+
+describe("Markdown alternate (section 5.4)", () => {
+  /** The same table as apps/dispatch-worker/src/_tests/markdown.spec.ts: the two rules must agree. */
+  it.each([
+    ["/", true],
+    ["/about", true],
+    ["/team/ada/", true],
+    ["/i/store", true],
+    ["/i/store/mug", true],
+    ["/i/events/launch-night", true],
+    ["/i/podcasts/show/episode-1", true],
+    ["/i/communities/potters", true],
+    ["/i/store/mug/extra", false],
+    ["/i/events/launch-night/finalise", false],
+    ["/i/films/library", false],
+    ["/i/films/doc/watch/e1", false],
+    ["/i/account", false],
+    ["/i/account/orders", false],
+    ["/i/checkout", false],
+    ["/i/login", false],
+    ["/i/downloads/tok", false],
+    ["/i/app", false],
+    ["/i", false],
+    ["/api/things", false],
+    ["/__tn/unlock", false],
+    ["/.well-known/mcp", false],
+    ["/logo.png", false],
+    ["/sitemap.xml", false],
+  ])("isMarkdownPath(%s) is %s", (path, expected) => {
+    expect(isMarkdownPath(path)).toBe(expected);
+  });
+
+  it("is left out when readable copies are off, the page is noindex or the site is not indexing", () => {
+    const off = (seo: SeoRecord, path = "/about") =>
+      (siteSeoHead(ctx(path, seo)).links as Array<{ rel: string }>).filter((l) => l.rel === "alternate");
+    expect(off(record({ markdownEnabled: false }))).toEqual([]);
+    expect(off(record({ indexing: false }))).toEqual([]);
+    expect(off(record({ pages: { "/about": { noindex: true } } }))).toEqual([]);
+    // Absent means on: an API older than the field.
+    expect(off(record({ markdownEnabled: undefined }))).toHaveLength(1);
+  });
+
+  it("is left out of a hosted page that is noindex or private", () => {
+    const head = buildHeadMeta({ title: "Orders" });
+    expect(applySeoToHead(head, RECORD, "/i/account/orders").links).toEqual([
+      { rel: "canonical", href: "https://claystudio.com/i/account/orders" },
+    ]);
+    const off = applySeoToHead(buildHeadMeta({ title: "Mug" }), record({ markdownEnabled: false }), "/i/store/mug", "product");
+    expect(off.links).toEqual([{ rel: "canonical", href: "https://claystudio.com/i/store/mug" }]);
+  });
+
+  it("replaces a markdown link the page already had rather than adding a second", () => {
+    const head = { ...buildHeadMeta({ title: "Mug" }), links: [{ rel: "alternate", type: "text/markdown", href: "/old" }] };
+    const out = applySeoToHead(head, RECORD, "/i/store/mug", "product");
+    expect(out.links!.filter((l) => l.rel === "alternate")).toEqual([md("https://claystudio.com/i/store/mug")]);
+  });
+
+  it("points at this site when the canonical is somewhere else, and appends to a canonical with a query", () => {
+    expect(markdownAlternateHref(RECORD, "/about", "https://elsewhere.example/about")).toBe(
+      "https://claystudio.com/about?md",
+    );
+    expect(markdownAlternateHref(RECORD, "/about", "https://claystudio.com/about?lang=en")).toBe(
+      "https://claystudio.com/about?lang=en&md",
+    );
+    expect(markdownAlternateHref(RECORD, "/", null)).toBe("https://claystudio.com/?md");
+  });
+});

package/src/seo/applySeoToHead.ts

@@ -1,3 +1,4 @@
+import { markdownAlternateLink } from "./markdown";
 import { normalizePathname, resolvePageSeo } from "./resolve";
 import type { SeoPageType, SeoRecord } from "./types";
 
@@ -91,8 +92,13 @@ export function applySeoToHead<T extends HeadTags>(
   ];
 
   // A noindex page states no canonical: there is no indexed copy to point at.
-  const links = (head.links ?? []).filter((l) => l.rel !== "canonical");
+  const links = (head.links ?? []).filter(
+    (l) => l.rel !== "canonical" && !(l.rel === "alternate" && l.type === "text/markdown"),
+  );
   if (resolved.canonical && !resolved.noindex) links.push({ rel: "canonical", href: resolved.canonical });
+  // The readable copy for agents, on the same terms as the canonical.
+  const markdown = markdownAlternateLink(seo, path, { canonical: resolved.canonical, noindex: resolved.noindex });
+  if (markdown) links.push({ ...markdown });
 
   return { ...head, meta: nextMeta, links };
 }