@tribe-nest/forge 3.53.0 → 3.54.0

package/package.json

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

package/src/contexts/AppAuthContext.tsx

@@ -1,5 +1,6 @@
 "use client";
-import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import { createSharedContext } from "../runtime/registry";
 import { useForge } from "../provider/ForgeProvider";
 import { createForgeClient } from "../client/createForgeClient";
 import {
@@ -105,7 +106,7 @@ interface AppAuthContextType {
   hasPermission: (permission: string) => boolean;
 }
 
-const AppAuthContext = createContext<AppAuthContextType | null>(null);
+const AppAuthContext = createSharedContext<AppAuthContextType | null>("appAuth", null);
 
 export function AppAuthProvider({ children }: { children: ReactNode }) {
   const { apiUrl, appId, publishableKey } = useForge();

package/src/contexts/AudioPlayerContext.tsx

@@ -1,5 +1,6 @@
 "use client";
-import { createContext, useContext, useState, useRef, useEffect, useCallback } from "react";
+import { useContext, useState, useRef, useEffect, useCallback } from "react";
+import { createSharedContext } from "../runtime/registry";
 import type { ReactNode } from "react";
 
 export interface AudioTrack {
@@ -34,7 +35,7 @@ interface AudioPlayerContextType {
   queue: AudioTrack[];
 }
 
-const AudioPlayerContext = createContext<AudioPlayerContextType | undefined>(undefined);
+const AudioPlayerContext = createSharedContext<AudioPlayerContextType | undefined>("audioPlayer", undefined);
 
 export function AudioPlayerProvider({ children }: { children: ReactNode }) {
   const [currentTrack, setCurrentTrack] = useState<AudioTrack | null>(null);

package/src/contexts/CartContext.tsx

@@ -1,6 +1,7 @@
 "use client";
 import type { IBookingFee, ProductDeliveryType } from "../types/models";
-import { createContext, useCallback, useContext, useMemo, useState } from "react";
+import { useCallback, useContext, useMemo, useState } from "react";
+import { createSharedContext } from "../runtime/registry";
 import type { ReactNode } from "react";
 import { useEffect } from "react";
 
@@ -153,7 +154,7 @@ interface CartContextType {
   isReady: boolean;
 }
 
-const CartContext = createContext<CartContextType | undefined>(undefined);
+const CartContext = createSharedContext<CartContextType | undefined>("cart", undefined);
 
 const CART_STORAGE_KEY = "tribenest-cart";
 

package/src/contexts/PublicAuthContext.tsx

@@ -1,5 +1,6 @@
 "use client";
-import { createContext, type ReactNode, useCallback, useContext, useEffect, useReducer, useState } from "react";
+import { type ReactNode, useCallback, useContext, useEffect, useReducer, useState } from "react";
+import { createSharedContext } from "../runtime/registry";
 import {
   type ApiError,
   type PublicAuthUser,
@@ -107,7 +108,7 @@ const AuthReducer = (state: PublicAuthState, action: AuthActions): PublicAuthSta
   }
 };
 
-const PublicAuthContext = createContext<PublicAuthContextType | null>(null);
+const PublicAuthContext = createSharedContext<PublicAuthContextType | null>("publicAuth", null);
 
 // ----------------------------------------------------------------------
 

package/src/data/queries/useEvents.ts

@@ -161,6 +161,20 @@ export type CreateEventOrderResult = {
    * exists — and for a profile with inventory holds switched off.
    */
   holdExpiresAt?: string | null;
+  /**
+   * This order is a ticket REQUEST (curated access, feature 3): the tiers in it
+   * need the organiser's approval, so nothing is sold until they decide.
+   *
+   * With a price on it the payment step runs as today and the charge is
+   * deferred (`settlement: "deferred"` on start-payment). With nothing to pay
+   * the order is already `pending_approval` when this returns, `isFreeCheckout`
+   * is FALSE (no passes were minted), and there is no payment step: the
+   * checkout goes straight to the request-received outcome. See
+   * `nextStepAfterTicketOrder`.
+   */
+  awaitingApproval?: boolean;
+  /** When an undecided request lapses, ISO-8601. `null` on an ordinary sale. */
+  requestExpiresAt?: string | null;
 };
 
 /** Create an event ticket order (the step before start-payment). */

package/src/data/queries/useMyTickets.ts

@@ -108,6 +108,33 @@ export type MyTicketPendingTransfer = {
 /** How the caller comes to be looking at an order. */
 export type MyTicketRole = "purchaser" | "holder";
 
+/**
+ * Where a ticket REQUEST stands (curated access, feature 3), per order.
+ *
+ *   pending         lodged; the organiser has until `expiresAt` to decide
+ *   approved        approved; on a priced request the charge is settled or
+ *                   settling, and the passes are on the order
+ *   declined        the organiser said no; `decisionNote` carries their words
+ *   expired         the window lapsed undecided; the hold was released
+ *   payment_failed  approved, but the deferred charge could not be settled
+ *                   (`failureReason`); the seat was released
+ *
+ * `state: null` means the order was never a request. The whole object is
+ * optional because it is newer than the endpoint: an older API build sends no
+ * `request` at all, and `myTicketRequestState` reads that as "not a request".
+ */
+export type MyTicketRequestState = "pending" | "approved" | "declined" | "expired" | "payment_failed";
+
+export type MyTicketRequest = {
+  state: MyTicketRequestState | null;
+  requestedAt: string | null;
+  /** The "decide by" instant while `pending`. */
+  expiresAt: string | null;
+  decidedAt: string | null;
+  decisionNote: string | null;
+  failureReason: string | null;
+};
+
 export type MyTicketItem = {
   id: string;
   quantity: number;
@@ -150,6 +177,8 @@ export type MyTicket = {
    * `purchaser` reproduces exactly the previous behaviour.
    */
   role?: MyTicketRole;
+  /** The ticket request behind this order, if it was one. See `MyTicketRequest`. */
+  request?: MyTicketRequest | null;
   /**
    * The event's `.ics`, both forms — what lets the portal offer Apple Calendar
    * rather than only the three template providers. Null for a cancelled show.
@@ -163,6 +192,26 @@ export type MyTicket = {
   passes?: MyTicketPass[];
 };
 
+/**
+ * The request state of an order, or `null` when it was never a request (or
+ * the API build predates requests). One place to read it so no surface has to
+ * know the object is optional.
+ */
+export function myTicketRequestState(ticket: Pick<MyTicket, "request">): MyTicketRequestState | null {
+  return ticket.request?.state ?? null;
+}
+
+/**
+ * Does this request still have a live decision ahead of it, or did it end
+ * without a sale? Both mean "no passes, nothing to cancel, nothing to hand
+ * on", which is what the tickets tab reads to draw the row as a request rather
+ * than as a purchase. An `approved` request is a purchase by now.
+ */
+export function isMyTicketRequestOpenOrEnded(ticket: Pick<MyTicket, "request">): boolean {
+  const state = myTicketRequestState(ticket);
+  return state === "pending" || state === "declined" || state === "expired" || state === "payment_failed";
+}
+
 /**
  * Every pass id on an order.
  *

package/src/data/queries/usePaymentFlow.ts

@@ -152,6 +152,14 @@ export function usePaymentFlow(opts: UsePaymentFlowOptions) {
     /** PAYSTACK: the hosted page used only when the modal cannot open. */
     checkoutUrl: result?.checkoutUrl,
     isPaystack,
+    /**
+     * `"deferred"` when the charge is committed now and settled only if the
+     * organiser approves (an event ticket request). Undefined on every
+     * ordinary sale and on an older API build, which renders as before.
+     */
+    settlement: result?.settlement,
+    /** How the provider defers a `settlement: "deferred"` charge. See `PaymentStartResponse`. */
+    deferredStrategy: result?.deferredStrategy ?? null,
     /** True once there is a Paystack session a pay button can open. */
     canOpenPaystack: hasPaystackSession(session),
     openPaystackCheckout: openPaystack,

package/src/i18n/de.json

@@ -68,7 +68,16 @@
   "forge.account_dashboard.profile_update_error": "Profil konnte nicht aktualisiert werden.",
   "forge.account_dashboard.profile_update_success": "Profil aktualisiert.",
   "forge.account_dashboard.rentals_title": "Meine Ausleihen",
+  "forge.account_dashboard.request_approved": "Anfrage freigegeben",
+  "forge.account_dashboard.request_decide_by": "Wir entscheiden bis {date}",
+  "forge.account_dashboard.request_declined": "Nicht freigegeben",
   "forge.account_dashboard.request_deletion": "Kontolöschung beantragen",
+  "forge.account_dashboard.request_expired": "Anfrage abgelaufen",
+  "forge.account_dashboard.request_note": "Unser Hinweis: {note}",
+  "forge.account_dashboard.request_nothing_charged": "Es wird nichts berechnet, bis wir deine Anfrage freigeben.",
+  "forge.account_dashboard.request_payment_failed": "Freigegeben, Zahlung fehlgeschlagen",
+  "forge.account_dashboard.request_pending": "Anfrage offen",
+  "forge.account_dashboard.request_seat_released": "Der Platz wurde freigegeben. Das Event hat möglicherweise noch Tickets.",
   "forge.account_dashboard.reschedule": "Verschieben",
   "forge.account_dashboard.reschedule_empty": "In den nächsten zwei Wochen sind keine anderen Zeiten frei.",
   "forge.account_dashboard.reschedule_error": "Wir konnten diese Session nicht verschieben. Bitte wähle eine andere Zeit.",
@@ -99,6 +108,7 @@
   "forge.account_dashboard.tickets_title": "Meine Tickets",
   "forge.account_dashboard.title": "Mein Konto",
   "forge.account_dashboard.total": "Gesamt",
+  "forge.account_dashboard.total_on_approval": "Gesamt bei Freigabe",
   "forge.account_dashboard.update_password": "Passwort ändern",
   "forge.account_dashboard.update_payment_method": "Zahlungsmethode ändern",
   "forge.account_dashboard.update_profile": "Profil aktualisieren",
@@ -733,10 +743,20 @@
   "forge.ended_broadcast.refresh_instruction": "Du kannst diese Seite immer wieder neu laden, bis die Übertragung wieder läuft. Tritt ihr dann bei und du kannst das Event weiter ansehen. Du bekommst außerdem eine E-Mail, sobald die Übertragung wieder läuft.",
   "forge.ended_broadcast.why_body": "Wenn das mitten im Event passiert ist, lag es sehr wahrscheinlich an einer instabilen Internetverbindung beim Host.",
   "forge.ended_broadcast.why_label": "Warum wurde die Übertragung beendet?",
+  "forge.event_confirmation.awaiting_nothing_charged": "Es wird nichts berechnet, bis wir deine Anfrage freigeben.",
+  "forge.event_confirmation.body_awaiting_no_date": "Wir prüfen deine Anfrage und schicken dir eine E-Mail, sobald wir entschieden haben.",
+  "forge.event_confirmation.body_declined": "Wir konnten diese Anfrage nicht freigeben. Es wurde nichts berechnet, und eine Vormerkung auf deiner Karte wurde aufgehoben.",
+  "forge.event_confirmation.body_expired": "Wir haben deine Anfrage nicht rechtzeitig bearbeitet, daher ist sie abgelaufen. Es wurde nichts berechnet, und eine Vormerkung auf deiner Karte wurde aufgehoben.",
   "forge.event_confirmation.body_incomplete": "Deine Bestellung ist {status}. Falls dir etwas berechnet wurde, melde dich beim Support.",
   "forge.event_confirmation.body_paid": "Wir haben deine Tickets an {email} geschickt.",
+  "forge.event_confirmation.body_request_payment_failed": "Wir haben deine Anfrage freigegeben, aber deine Karte konnte nicht belastet werden. Der Platz wurde freigegeben. Möglicherweise sind noch Plätze verfügbar.",
+  "forge.event_confirmation.buy_again": "Erneut kaufen",
   "forge.event_confirmation.explore": "Mehr Events ansehen",
+  "forge.event_confirmation.eyebrow_awaiting": "Anfrage eingegangen",
+  "forge.event_confirmation.eyebrow_declined": "Nicht freigegeben",
+  "forge.event_confirmation.eyebrow_expired": "Anfrage abgelaufen",
   "forge.event_confirmation.eyebrow_paid": "E-Ticket",
+  "forge.event_confirmation.eyebrow_request_payment_failed": "Zahlung fehlgeschlagen",
   "forge.event_confirmation.eyebrow_status": "Bestellung {status}",
   "forge.event_confirmation.loading": "Deine Bestellung wird abgeschlossen…",
   "forge.event_confirmation.not_found": "Wir konnten deine Bestellung nicht finden.",
@@ -746,10 +766,16 @@
   "forge.event_confirmation.tax": "MwSt.",
   "forge.event_confirmation.tax_included": "Enthält {amount} MwSt.",
   "forge.event_confirmation.tickets_heading": "Tickets",
+  "forge.event_confirmation.title_awaiting": "Deine Anfrage ist eingegangen",
+  "forge.event_confirmation.title_declined": "Deine Anfrage wurde nicht freigegeben",
+  "forge.event_confirmation.title_expired": "Deine Anfrage ist abgelaufen",
   "forge.event_confirmation.title_incomplete": "Bestellung nicht abgeschlossen",
   "forge.event_confirmation.title_paid": "Du bist dabei! 🎟",
+  "forge.event_confirmation.title_request_payment_failed": "Freigegeben, aber die Zahlung ist fehlgeschlagen",
   "forge.event_confirmation.total": "Gesamt",
+  "forge.event_confirmation.total_on_approval": "Gesamt bei Freigabe",
   "forge.event_confirmation.total_paid": "Bezahlt gesamt",
+  "forge.event_confirmation.view_event": "Event ansehen",
   "forge.event_confirmation.virtual_location": "Online-Event",
   "forge.event_countdown.past": "Dieses Event ist vorbei",
   "forge.event_countdown.unit_days": "Tage",
@@ -769,11 +795,20 @@
   "forge.event_series_detail.status_cancelled": "Abgesagt",
   "forge.event_series_detail.status_sold_out": "Ausverkauft",
   "forge.event_tickets.add_to_cart": "In den Warenkorb",
+  "forge.event_tickets.approval_badge": "Freigabe erforderlich",
+  "forge.event_tickets.approval_help_body": "Wir entscheiden, wer dieses Ticket bekommt. Deine Karte wird nur vorgemerkt, nicht belastet, und der Platz bleibt für dich reserviert, bis wir entschieden haben. Bei einer Freigabe wird die Karte belastet und deine Tickets werden verschickt. Bei einer Ablehnung oder nach Ablauf der Anfrage wird die Vormerkung aufgehoben und nichts berechnet.",
+  "forge.event_tickets.approval_help_label": "Was bedeutet Freigabe erforderlich?",
+  "forge.event_tickets.approval_mix_blocked": "Kann nicht zu deiner aktuellen Auswahl hinzugefügt werden",
+  "forge.event_tickets.approval_mix_help_body": "Tickets, die unsere Freigabe brauchen, werden separat angefragt. Eine Bestellung ist entweder eine Anfrage oder ein Kauf, nie beides. Entferne die ausgewählten Tickets, um dieses hinzuzufügen.",
+  "forge.event_tickets.approval_mix_help_label": "Warum können diese Tickets nicht kombiniert werden?",
   "forge.event_tickets.aria_close": "Schließen",
   "forge.event_tickets.attendee_is_you": "(das bist du)",
   "forge.event_tickets.attendee_name_placeholder": "Vollständiger Name",
   "forge.event_tickets.attendees_description": "Bei diesem Event steht auf jedem Ticket der Name des jeweiligen Gastes, damit die Einlassliste zu den Leuten passt, die wirklich kommen.",
   "forge.event_tickets.attendees_title": "Wer kommt mit?",
+  "forge.event_tickets.authorize": "{amount} vormerken",
+  "forge.event_tickets.authorize_subtitle": "Deine Anfrage erreicht uns, sobald deine Karte vorgemerkt ist.",
+  "forge.event_tickets.authorize_title": "Karte vormerken",
   "forge.event_tickets.back": "Zurück",
   "forge.event_tickets.booking_fee": "Buchungsgebühr",
   "forge.event_tickets.checkout_tickets_only": "Nur Tickets kaufen",
@@ -782,6 +817,8 @@
   "forge.event_tickets.continue": "Weiter",
   "forge.event_tickets.continue_addons": "Weiter zu den Extras",
   "forge.event_tickets.continue_payment": "Weiter zur Zahlung",
+  "forge.event_tickets.deferred_charged_on_approval": "Deine Karte wird nur belastet, wenn wir deine Anfrage freigeben.",
+  "forge.event_tickets.deferred_hold_on_statement": "Bis dahin erscheint eine vorübergehende Vormerkung auf deiner Abrechnung.",
   "forge.event_tickets.details_title": "Deine Daten",
   "forge.event_tickets.email_mismatch": "Die E-Mail-Adressen stimmen nicht überein",
   "forge.event_tickets.email_placeholder": "E-Mail",
@@ -824,6 +861,7 @@
   "forge.event_tickets.pwyw_range_min": "(mindestens {min})",
   "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.select_option": "Auswählen…",
   "forge.event_tickets.select_title": "Tickets wählen",
   "forge.event_tickets.subtotal": "Zwischensumme",
@@ -964,6 +1002,9 @@
   "forge.film_watch.unavailable": "Diese Folge kann gerade nicht abgespielt werden.",
   "forge.film_watch.up_next": "Als Nächstes: {title}",
   "forge.film_watch.window_not_started": "Dein Zeitfenster startet jetzt.",
+  "forge.forge_stripe_payment.authorize": "{amount} vormerken",
+  "forge.forge_stripe_payment.deferred_charged_on_approval": "Deine Karte wird nur belastet, wenn wir deine Anfrage freigeben.",
+  "forge.forge_stripe_payment.deferred_hold_on_statement": "Bis dahin erscheint eine vorübergehende Vormerkung auf deiner Abrechnung.",
   "forge.forgot_password_form.back_to_login": "Zurück zur Anmeldung",
   "forge.forgot_password_form.email_label": "E-Mail",
   "forge.forgot_password_form.email_placeholder": "E-Mail",
@@ -1293,4 +1334,4 @@
   "forge.user_menu.create_account": "Konto erstellen",
   "forge.user_menu.log_in": "Anmelden",
   "forge.user_menu.log_out": "Abmelden"
-}
+}

package/src/i18n/en.json

@@ -68,7 +68,16 @@
   "forge.account_dashboard.profile_update_error": "Failed to update profile.",
   "forge.account_dashboard.profile_update_success": "Profile updated.",
   "forge.account_dashboard.rentals_title": "My Rentals",
+  "forge.account_dashboard.request_approved": "Request approved",
+  "forge.account_dashboard.request_decide_by": "We'll decide by {date}",
+  "forge.account_dashboard.request_declined": "Not approved",
   "forge.account_dashboard.request_deletion": "Request Account Deletion",
+  "forge.account_dashboard.request_expired": "Request expired",
+  "forge.account_dashboard.request_note": "Our note: {note}",
+  "forge.account_dashboard.request_nothing_charged": "Nothing is charged until we approve your request.",
+  "forge.account_dashboard.request_payment_failed": "Approved, payment failed",
+  "forge.account_dashboard.request_pending": "Request pending",
+  "forge.account_dashboard.request_seat_released": "The seat was released. The event may still have tickets available.",
   "forge.account_dashboard.reschedule": "Reschedule",
   "forge.account_dashboard.reschedule_empty": "No other times are open in the next two weeks.",
   "forge.account_dashboard.reschedule_error": "We could not move this session. Please try another time.",
@@ -99,6 +108,7 @@
   "forge.account_dashboard.tickets_title": "My Tickets",
   "forge.account_dashboard.title": "My Account",
   "forge.account_dashboard.total": "Total",
+  "forge.account_dashboard.total_on_approval": "Total if approved",
   "forge.account_dashboard.update_password": "Update Password",
   "forge.account_dashboard.update_payment_method": "Update payment method",
   "forge.account_dashboard.update_profile": "Update Profile",
@@ -733,10 +743,20 @@
   "forge.ended_broadcast.refresh_instruction": "You can keep refreshing this page until the broadcast is live again. Join it and you should be able to watch the event again. You will also get an email when the broadcast is live again.",
   "forge.ended_broadcast.why_body": "If this happened in the middle of the event, it was most likely caused by an unstable internet connection at the host's end.",
   "forge.ended_broadcast.why_label": "Why did the broadcast end?",
+  "forge.event_confirmation.awaiting_nothing_charged": "Nothing is charged until we approve your request.",
+  "forge.event_confirmation.body_awaiting_no_date": "We're reviewing your request and will email you as soon as we've decided.",
+  "forge.event_confirmation.body_declined": "We weren't able to approve this request. Nothing has been charged, and any hold on your card has been released.",
+  "forge.event_confirmation.body_expired": "We didn't get to your request in time, so it has expired. Nothing has been charged, and any hold on your card has been released.",
   "forge.event_confirmation.body_incomplete": "Your order is {status}. If you were charged, contact support.",
   "forge.event_confirmation.body_paid": "We’ve sent your tickets to {email}.",
+  "forge.event_confirmation.body_request_payment_failed": "We approved your request but your card could not be charged, so the seat was released. Seats may still be available.",
+  "forge.event_confirmation.buy_again": "Buy again",
   "forge.event_confirmation.explore": "Browse more events",
+  "forge.event_confirmation.eyebrow_awaiting": "Request received",
+  "forge.event_confirmation.eyebrow_declined": "Not approved",
+  "forge.event_confirmation.eyebrow_expired": "Request expired",
   "forge.event_confirmation.eyebrow_paid": "E-Ticket",
+  "forge.event_confirmation.eyebrow_request_payment_failed": "Payment failed",
   "forge.event_confirmation.eyebrow_status": "Order {status}",
   "forge.event_confirmation.loading": "Finalizing your order…",
   "forge.event_confirmation.not_found": "We couldn’t find your order.",
@@ -746,10 +766,16 @@
   "forge.event_confirmation.tax": "Tax",
   "forge.event_confirmation.tax_included": "Includes {amount} tax",
   "forge.event_confirmation.tickets_heading": "Tickets",
+  "forge.event_confirmation.title_awaiting": "Your request is in",
+  "forge.event_confirmation.title_declined": "Your request was not approved",
+  "forge.event_confirmation.title_expired": "Your request has expired",
   "forge.event_confirmation.title_incomplete": "Order not completed",
   "forge.event_confirmation.title_paid": "You’re going! 🎟",
+  "forge.event_confirmation.title_request_payment_failed": "Approved, but the payment did not go through",
   "forge.event_confirmation.total": "Total",
+  "forge.event_confirmation.total_on_approval": "Total if approved",
   "forge.event_confirmation.total_paid": "Total paid",
+  "forge.event_confirmation.view_event": "View event",
   "forge.event_confirmation.virtual_location": "Virtual event",
   "forge.event_countdown.past": "This event has passed",
   "forge.event_countdown.unit_days": "Days",
@@ -769,11 +795,20 @@
   "forge.event_series_detail.status_cancelled": "Cancelled",
   "forge.event_series_detail.status_sold_out": "Sold out",
   "forge.event_tickets.add_to_cart": "Add to cart",
+  "forge.event_tickets.approval_badge": "Approval required",
+  "forge.event_tickets.approval_help_body": "We review who gets this ticket. Your card is held, not charged, and the seat is yours while we decide. If we approve, the card is charged and your tickets are sent. If we decline, or the request expires, the hold is released and nothing is charged.",
+  "forge.event_tickets.approval_help_label": "What does approval required mean?",
+  "forge.event_tickets.approval_mix_blocked": "Can't be added to your current selection",
+  "forge.event_tickets.approval_mix_help_body": "Tickets that need our approval are requested on their own, so one order is either a request or a purchase, never both. Remove the tickets you have selected to add this one.",
+  "forge.event_tickets.approval_mix_help_label": "Why can't these tickets be combined?",
   "forge.event_tickets.aria_close": "Close",
   "forge.event_tickets.attendee_is_you": "(that’s you)",
   "forge.event_tickets.attendee_name_placeholder": "Full name",
   "forge.event_tickets.attendees_description": "This event prints each attendee’s name on their own pass, so the door list matches who actually turns up.",
   "forge.event_tickets.attendees_title": "Who is coming?",
+  "forge.event_tickets.authorize": "Authorize {amount}",
+  "forge.event_tickets.authorize_subtitle": "Your request reaches us once your card is authorized.",
+  "forge.event_tickets.authorize_title": "Authorize your card",
   "forge.event_tickets.back": "Back",
   "forge.event_tickets.booking_fee": "Booking fee",
   "forge.event_tickets.checkout_tickets_only": "Checkout tickets only",
@@ -782,6 +817,8 @@
   "forge.event_tickets.continue": "Continue",
   "forge.event_tickets.continue_addons": "Continue to add-ons",
   "forge.event_tickets.continue_payment": "Continue to payment",
+  "forge.event_tickets.deferred_charged_on_approval": "Your card is only charged if we approve your request.",
+  "forge.event_tickets.deferred_hold_on_statement": "Until then a temporary hold will show on your statement.",
   "forge.event_tickets.details_title": "Your details",
   "forge.event_tickets.email_mismatch": "Email addresses do not match",
   "forge.event_tickets.email_placeholder": "Email",
@@ -824,6 +861,7 @@
   "forge.event_tickets.pwyw_range_min": "(minimum {min})",
   "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.select_option": "Select…",
   "forge.event_tickets.select_title": "Select Tickets",
   "forge.event_tickets.subtotal": "Subtotal",
@@ -964,6 +1002,9 @@
   "forge.film_watch.unavailable": "This episode cannot be played right now.",
   "forge.film_watch.up_next": "Up next: {title}",
   "forge.film_watch.window_not_started": "Your window starts now.",
+  "forge.forge_stripe_payment.authorize": "Authorize {amount}",
+  "forge.forge_stripe_payment.deferred_charged_on_approval": "Your card is only charged if we approve your request.",
+  "forge.forge_stripe_payment.deferred_hold_on_statement": "Until then a temporary hold will show on your statement.",
   "forge.forgot_password_form.back_to_login": "Back to login",
   "forge.forgot_password_form.email_label": "Email",
   "forge.forgot_password_form.email_placeholder": "Email",
@@ -1293,4 +1334,4 @@
   "forge.user_menu.create_account": "Create account",
   "forge.user_menu.log_in": "Log in",
   "forge.user_menu.log_out": "Log out"
-}
+}

package/src/i18n/index.ts

@@ -6,7 +6,8 @@
 // Key naming is fixed by ./CONVENTION.md. Every key starts with "forge." so a
 // tenant's own copy can never collide with the package's.
 
-import { createContext, createElement, useContext, useMemo, type ReactNode } from "react";
+import { createElement, useContext, useMemo, type ReactNode } from "react";
+import { createSharedContext } from "../runtime/registry";
 import enMessages from "./en.json";
 import deMessages from "./de.json";
 
@@ -73,7 +74,7 @@ export function getForgeMessages(locale: ForgeLocale): ForgeMessages {
 }
 
 // `null` means "no provider above me", which is a supported state, not a bug.
-const ForgeI18nContext = createContext<ForgeLocale | null>(null);
+const ForgeI18nContext = createSharedContext<ForgeLocale | null>("i18n", null);
 
 export interface ForgeI18nProviderProps {
   /**

package/src/index.ts

@@ -71,9 +71,11 @@ export { safeRedirectPath } from "./utils/safeRedirect";
 export {
   getTicketOrderOutcome,
   isTicketOrderRefunded,
+  ticketRequestFailureKind,
   TICKET_ORDER_REFUNDED_COPY,
   type TicketOrderOutcome,
   type TicketOrderOutcomeInput,
+  type TicketRequestFailureKind,
 } from "./utils/ticketOrderOutcome";
 // App-user auth (mini-apps) + the /admin guard.
 export {
@@ -180,3 +182,23 @@ export * from "./utils/formatDateTime";
 // The ONE membership access predicate + the messaging that is deliberately
 // separate from it. Every surface that gates on a membership imports from here.
 export * from "./utils/membershipAccess";
+
+// Hosted internal pages. `/i/*` is published once and rendered through the
+// catch-all route on every site, so a fix reaches every fan without a rebuild.
+// `internalLink` / `internalPath` are how anything links into those pages now:
+// a literal `/i/...` path no longer type-checks, because the per-page route
+// files it referred to are gone. See docs/proposals/hosted-internal-pages-initiative.md.
+export * from "./runtime/pages";
+export * from "./runtime/pagesClient";
+export * from "./runtime/RemotePage";
+// The runtime a site shares with the hosted pages bundle. A site never calls
+// these; the chassis catch-all registers the router and TribeNestApp does the
+// rest. Exported because the bundle reads them from the published package.
+export {
+  PAGES_RUNTIME_CONTRACT,
+  createSharedContext,
+  missingRuntimeKeys,
+  readRuntimeValue,
+  shareRuntimeValue,
+} from "./runtime/registry";
+export { RUNTIME_KEYS, REQUIRED_RUNTIME_KEYS, registerRouterRuntime, hostQueryClient } from "./runtime/hostRuntime";

package/src/provider/ForgeAppProvider.tsx

@@ -1,5 +1,6 @@
 import { useState, type ReactNode } from "react";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { registerQueryClient } from "../runtime/hostRuntime";
 import { ForgeClientProvider } from "./ForgeProvider";
 import { SiteConfigProvider } from "./SiteConfigProvider";
 import { ForgeContentProvider } from "../content/ForgeContentProvider";
@@ -127,7 +128,13 @@ export function ForgeProvider({
   children,
 }: ForgeProviderProps) {
   // One client per provider instance (per SSR request), unless the host supplies one.
-  const [client] = useState(() => queryClient ?? new QueryClient());
+  const [client] = useState(() => {
+    const created = queryClient ?? new QueryClient();
+    // So a hosted `/i/*` page shares this cache rather than opening its own.
+    // No-ops on the server, where one global would span requests.
+    registerQueryClient(created);
+    return created;
+  });
 
   return (
     <ForgeClientProvider

package/src/provider/ForgeProvider.tsx

@@ -1,4 +1,5 @@
-import { createContext, useCallback, useContext, useMemo, useRef, useState } from "react";
+import { useCallback, useContext, useMemo, useRef, useState } from "react";
+import { createSharedContext } from "../runtime/registry";
 import type { AxiosInstance } from "axios";
 import { createForgeClient } from "../client/createForgeClient";
 import {
@@ -38,7 +39,7 @@ export interface ForgeContextValue {
   setToken: (token: string | null) => void;
 }
 
-const ForgeContext = createContext<ForgeContextValue | null>(null);
+const ForgeContext = createSharedContext<ForgeContextValue | null>("forgeClient", null);
 
 export interface ForgeClientProviderProps {
   apiUrl: string;

package/src/provider/SiteConfigProvider.tsx

@@ -1,4 +1,5 @@
-import { createContext, useContext, type ReactNode } from "react";
+import { useContext, type ReactNode } from "react";
+import { createSharedContext } from "../runtime/registry";
 import type { SiteConfig } from "../data/queries/useWebsite";
 import { setSiteLocale } from "../client/activeLocale";
 
@@ -9,7 +10,7 @@ import { setSiteLocale } from "../client/activeLocale";
  * wasn't fetched on the server, in which case `useSiteConfig` just fetches on
  * the client as before.
  */
-const SiteConfigContext = createContext<SiteConfig | undefined>(undefined);
+const SiteConfigContext = createSharedContext<SiteConfig | undefined>("siteConfig", undefined);
 
 /** Seed the SSR-fetched site config (see `fetchSiteConfig` in `@tribe-nest/forge/server`). */
 export function SiteConfigProvider({

package/src/runtime/RemotePage.tsx

@@ -0,0 +1,110 @@
+import { useEffect, useState, type ComponentType } from "react";
+import { missingRuntimeKeys } from "./registry";
+import { REQUIRED_RUNTIME_KEYS } from "./hostRuntime";
+import type { RemotePageResult } from "./pagesClient";
+
+/**
+ * A hosted `/i/*` page, inside the creator's own shell.
+ *
+ * Two halves arrive from different places. The markup was rendered by the
+ * central pages Worker and comes down with the document, so a crawler and a
+ * link preview see a complete page. The interactive version comes from the
+ * central browser bundle, which loads after paint and takes over.
+ *
+ * The takeover is a REPLACEMENT, not a hydration. The bundle hands back an
+ * ordinary component and it renders inside this tree, under the host's
+ * providers, so there is one React root and one of everything else. Hydrating
+ * across two independently built bundles would mean matching markup exactly
+ * between two Reacts, which is the brittleness this design exists to avoid.
+ */
+
+type HostedPageProps = { params: Record<string, string>; search: URLSearchParams; data: unknown };
+
+type PagesBundle = {
+  getPage(path: string): ComponentType<HostedPageProps> | null;
+};
+
+/** Bundles already fetched, by URL, so a second page view does not refetch. */
+const loaded = new Map<string, Promise<PagesBundle>>();
+
+function loadBundle(url: string): Promise<PagesBundle> {
+  const existing = loaded.get(url);
+  if (existing) return existing;
+  // The URL is only known at runtime, from the render response, so the bundler
+  // must not try to resolve it.
+  const pending = import(/* @vite-ignore */ url) as Promise<PagesBundle>;
+  loaded.set(url, pending);
+  return pending;
+}
+
+function ensureStylesheet(href: string): void {
+  if (!href || typeof document === "undefined") return;
+  if (document.querySelector(`link[data-forge-pages="${CSS.escape(href)}"]`)) return;
+  const link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = href;
+  link.dataset.forgePages = href;
+  document.head.appendChild(link);
+}
+
+type Status = "server" | "live" | "failed";
+
+export function RemotePage({ result, path, search = "" }: { result: RemotePageResult; path: string; search?: string }) {
+  const [Page, setPage] = useState<ComponentType<HostedPageProps> | null>(null);
+  const [status, setStatus] = useState<Status>("server");
+
+  useEffect(() => {
+    if (!result.bundle.js) {
+      // No server render happened either, so there is nothing on screen and
+      // nothing to load. Say so rather than showing an empty page for ever.
+      setStatus(result.html ? "server" : "failed");
+      return;
+    }
+    // Check the contract BEFORE importing. A site built against an older
+    // runtime cannot satisfy this bundle, and finding that out halfway through
+    // a render produces a thrown hook rather than a message anyone can act on.
+    const missing = missingRuntimeKeys(REQUIRED_RUNTIME_KEYS);
+    if (missing.length > 0) {
+      console.error(`[forge-pages] this site does not publish: ${missing.join(", ")}`);
+      setStatus("failed");
+      return;
+    }
+    let cancelled = false;
+    ensureStylesheet(result.bundle.css);
+    loadBundle(result.bundle.js)
+      .then((bundle) => {
+        if (cancelled) return;
+        const component = bundle.getPage(path);
+        if (!component) {
+          setStatus("failed");
+          return;
+        }
+        setPage(() => component);
+        setStatus("live");
+      })
+      .catch((err: unknown) => {
+        if (cancelled) return;
+        console.error("[forge-pages] bundle failed to load", err);
+        setStatus("failed");
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [result.bundle.js, result.bundle.css, result.html, path]);
+
+  if (Page && status === "live") return <Page params={{}} search={new URLSearchParams(search)} data={result.data} />;
+
+  return (
+    <>
+      <div dangerouslySetInnerHTML={{ __html: result.html }} />
+      {status === "failed" && (
+        <div className="fg:mx-auto fg:my-6 fg:max-w-md fg:rounded-lg fg:border fg:p-4 fg:text-center fg:text-sm">
+          <p>This page could not finish loading.</p>
+          <button type="button" className="fg:mt-2 fg:underline" onClick={() => window.location.reload()}>
+            Reload the page
+          </button>
+        </div>
+      )}
+    </>
+  );
+}