@tribe-nest/forge 3.26.0 → 3.29.0

package/src/ui/headless/checkout/useCheckout.ts

@@ -20,6 +20,7 @@ import {
 } from "../../../data/queries/useCheckouts";
 import { bundleCouponSummary, bundleReturnUrl } from "./bundleCoupon";
 import { holdExpiredMessage, isHoldExpiredError } from "./inventoryHold";
+import { takeResumedCoupon } from "./resumedCoupon";
 import { useInventoryHold } from "./useInventoryHold";
 import { readAttributionRef } from "../../../utils/attribution";
 import { readLanding } from "../../../utils/landing";
@@ -191,8 +192,14 @@ export function useCheckout(opts: UseCheckoutOptions = {}) {
     [selectedShippingRates],
   );
 
-  const [couponCode, setCouponCode] = useState("");
-  const [showCouponInput, setShowCouponInput] = useState(false);
+  /**
+   * A code the buyer arrived with from a recovery link, prefilled but NOT
+   * applied: they still press Apply and the server re-evaluates it against
+   * today. The lazy initialiser consumes the stash, so a code cannot linger and
+   * prefill an unrelated checkout later in the same tab.
+   */
+  const [couponCode, setCouponCode] = useState(takeResumedCoupon);
+  const [showCouponInput, setShowCouponInput] = useState(() => couponCode.length > 0);
   const [couponError, setCouponError] = useState("");
   const [isApplyingCoupon, setIsApplyingCoupon] = useState(false);
   const [appliedCoupon, setAppliedCoupon] = useState<AppliedCoupon | null>(null);

package/src/ui/headless/index.ts

@@ -29,6 +29,24 @@ export {
   type InventoryHoldState,
   type UseInventoryHoldOptions,
 } from "./checkout/useInventoryHold";
+// Cart recovery: what a resume link does when the buyer clicks it. Shared so
+// `apps/client` and a Forge code site cannot decide differently.
+export {
+  useCartResume,
+  effectiveUnitCents,
+  partitionResumeLines,
+  resumeLineToCartItem,
+  resumeLinesToTicketItems,
+  type ResumePartition,
+  type UseCartResumeOptions,
+  type UseCartResumeResult,
+  type CartResumeStatus,
+  type ResumeLine,
+  type ResumedCheckout,
+  type ResumeLineOption,
+  type ResumeLineUnavailableReason,
+} from "./checkout/useCartResume";
+export { rememberResumedCoupon, takeResumedCoupon } from "./checkout/resumedCoupon";
 export {
   isHoldExpiredError,
   holdExpiredMessage,

package/src/ui/index.ts

@@ -55,6 +55,8 @@ export { PresaleCodeField, type PresaleCodeFieldProps } from "./styled/PresaleCo
 export { MembershipCheckout, type MembershipCheckoutProps } from "./styled/MembershipCheckout";
 export { ForgeStripePayment } from "./payment/ForgeStripePayment";
 export { Cart, type CartProps } from "./styled/Cart";
+/** The page a cart-recovery email lands on. Drop in at `/i/checkout/resume`. */
+export { ResumeCart, type ResumeCartProps } from "./styled/ResumeCart";
 // The resolver is exported alongside the component because the Craft themes
 // are a separate rendering stack (Tailwind, not inline styles) and cannot use
 // the component — but the legacy `color`/`size` fallback must not diverge.

package/src/ui/shell/TribeNestApp.tsx

@@ -8,6 +8,7 @@ import { CookieConsent } from "../styled/CookieConsent";
 import { AiAgentWidget } from "../styled/AiAgentWidget";
 import { useThemeTokens } from "../theme/ForgeThemeProvider";
 import { useInitialSiteConfig } from "../../provider/SiteConfigProvider";
+import { ForgeI18nProvider } from "../../i18n";
 import { PoweredBy } from "./PoweredBy";
 import { PreviewDiagnostics } from "./PreviewDiagnostics";
 import { shellAiAgentEnabled, shellPoweredByEnabled, shellPwaEnabled } from "./shellGating";
@@ -142,33 +143,41 @@ export function TribeNestApp({
     : null;
   return (
     <ForgeProvider editable={editable} {...forgeProps}>
-      {/* First in the tree: it must render even if everything below it doesn't. */}
-      {ssrFailure && <PreviewDiagnostics diagnostics={ssrFailure} />}
-      {children}
-      {/* "Powered by TribeNest" — last in the page flow, so it sits below the
-          tenant's own footer. Released builds only (live + published). */}
-      <PoweredByGate editable={editable} state={state} />
-      {/* Global playback bar — self-pins to the viewport bottom, renders nothing
-          until a track loads. */}
-      <AudioPlayer />
-      {/* Auto page views + clicks (+ Meta Pixel, gated on marketing consent).
-          First-party runs cookieless. Off in the editor so preview isn't counted. */}
-      {analytics && <ForgeAnalytics enabled={!editable} firstPartyMode="cookieless" />}
-      {/* Ad attribution capture (tracked-link ref + first-touch landing + visit
-          beacon). Off in the editor so preview visits aren't credited. */}
-      <AttributionCapture enabled={!editable} apiUrl={forgeProps.apiUrl} profileId={forgeProps.profileId} />
-      {/* PWA — SW registration + install banner + (fallback) manifest link. */}
-      {pwa && <PwaRegistration enabled={pwaEnabled} />}
-      {pwa && <InstallBanner enabled={pwaEnabled} />}
-      {pwa && <PwaHeadClient enabled={pwaEnabled} manifestHref={manifestHref} />}
-      {/* Consent banner — shown on first visit, re-openable from anywhere via
-          useCookieConsent().reopen(). Hidden in the editor. */}
-      {cookieConsent && !editable && <CookieConsent useTribeNestPrivacy />}
-      {/* Website AI agent — floating bubble, self-hiding when the profile has no
-          agent enabled. Lives here rather than in each __root so enabling the
-          agent in admin is enough to make it appear; before this it shipped only
-          on the Craft stack and no code site ever rendered it. */}
-      {shellAiAgentEnabled({ aiAgent, editable, appId: forgeProps.appId }) && <AiAgentWidget />}
+      {/* Forge's own copy, in the site's language. Mounted here rather than in
+          each tenant's __root.tsx, so a Forge upgrade is enough to give an
+          existing site i18n. `locale` is the ForgeProvider prop the site
+          already passes (absent or unsupported resolves to English). When
+          `profile_configurations.locale` lands on SiteConfig, that becomes the
+          source and this prop stays the override. */}
+      <ForgeI18nProvider locale={forgeProps.locale}>
+        {/* First in the tree: it must render even if everything below it doesn't. */}
+        {ssrFailure && <PreviewDiagnostics diagnostics={ssrFailure} />}
+        {children}
+        {/* "Powered by TribeNest" — last in the page flow, so it sits below the
+            tenant's own footer. Released builds only (live + published). */}
+        <PoweredByGate editable={editable} state={state} />
+        {/* Global playback bar — self-pins to the viewport bottom, renders nothing
+            until a track loads. */}
+        <AudioPlayer />
+        {/* Auto page views + clicks (+ Meta Pixel, gated on marketing consent).
+            First-party runs cookieless. Off in the editor so preview isn't counted. */}
+        {analytics && <ForgeAnalytics enabled={!editable} firstPartyMode="cookieless" />}
+        {/* Ad attribution capture (tracked-link ref + first-touch landing + visit
+            beacon). Off in the editor so preview visits aren't credited. */}
+        <AttributionCapture enabled={!editable} apiUrl={forgeProps.apiUrl} profileId={forgeProps.profileId} />
+        {/* PWA — SW registration + install banner + (fallback) manifest link. */}
+        {pwa && <PwaRegistration enabled={pwaEnabled} />}
+        {pwa && <InstallBanner enabled={pwaEnabled} />}
+        {pwa && <PwaHeadClient enabled={pwaEnabled} manifestHref={manifestHref} />}
+        {/* Consent banner — shown on first visit, re-openable from anywhere via
+            useCookieConsent().reopen(). Hidden in the editor. */}
+        {cookieConsent && !editable && <CookieConsent useTribeNestPrivacy />}
+        {/* Website AI agent — floating bubble, self-hiding when the profile has no
+            agent enabled. Lives here rather than in each __root so enabling the
+            agent in admin is enough to make it appear; before this it shipped only
+            on the Craft stack and no code site ever rendered it. */}
+        {shellAiAgentEnabled({ aiAgent, editable, appId: forgeProps.appId }) && <AiAgentWidget />}
+      </ForgeI18nProvider>
     </ForgeProvider>
   );
 }