@odla-ai/chapter 0.52.1 → 0.54.0

package/README.md

@@ -1735,12 +1735,39 @@ These bite silently — a smoke test won't catch them:
   Neither helper installs a cron or provisions infrastructure by itself.
 
   The member area exposes the authenticated purchaser's named-seat checkout
-  only when configured. Recipient hosts pass `initialNamedSeatId` from the
+  only when configured, and as soon as the membership is paid: `/api/me`
+  reports `namedSeatsEnabled` for a paid application whose interview is still
+  ahead, so a member who skipped the seat at checkout finds it on her members
+  page rather than after approval. The authority still decides eligibility on
+  every read. Recipient hosts pass `initialNamedSeatId` from the
   invitation's `seat` query parameter and an authenticated `namedSeatClaimApi`
   to `JoinIsland`; the recipient completes their own application and acceptance
   without a second subscription checkout. A primary cancellation also governs
   seat renewal; buying a seat does not restore canceled auto-renewal.
 
+  An offering may price the seat at zero (`seatPriceCents: 0`): the membership
+  then **includes** the seat. `GET /api/named-seat` reports `included: true`
+  with `amountCents: 0`, and `POST /api/named-seat/checkout` grants the seat in
+  the same request, with no PaymentIntent, no publishable key and no renewal
+  line: the seat lands in `pending_acceptance` with its entitlement and the
+  invitation effect, exactly where a paid seat lands after payment, and its
+  term follows the primary's renewal. The receipt carries `included: true` and
+  no `clientSecret`, so a host skips the card form (`NamedSeatPurchase` asks
+  for the same consent and then sends the invitation). Refunding an included
+  seat closes it with `refundedCents: 0` and revokes an active recipient; the
+  provider is never asked for anything. `lowerSeatPrice` and
+  `POST /api/admin/membership-seats/reprice` (`{ chapterId, runtime, skuId }`,
+  super admin, network owner) move a SKU's existing memberships down to the
+  current published offering's seat price, so a member who paid before the
+  change gets the included seat too; it only ever lowers, skips a seat already
+  paid for, and names every membership it left alone.
+
+  The offer's `seat` also carries `recipientState` (`payment_pending`,
+  `invited`, `accepted`, `joined`, `declined`, `refunded`, `canceled`) with
+  `purchasedAt`, `acceptedAt` and `joinedAt`, so a members page can say who was
+  named and whether that person joined without folding the seat status machine
+  itself; `NamedSeatRecipientLine` renders it.
+
   Delivery logs distinguish sent, logged-only, in-flight, uncertain and
   retry-approved outcomes. The authenticated operator resolution route
   `/api/admin/email/log/:id/resolve` records evidence against the exact attempt;
@@ -1782,6 +1809,23 @@ These bite silently — a smoke test won't catch them:
   and a payable price without reading the database; nothing on it edits a
   version.
 
+  A promise is frozen at checkout, so publishing a later discount policy version
+  changes nothing for members who already paid. When the later version widens
+  the benefit to `while_active`, the network owner moves the cohort's existing
+  members onto it with `POST /api/admin/membership-discount/reterm`
+  ({ chapterId, policyVersionId, runtime?, appId?, membershipIds?, limit? }; super
+  admin; `runtime` defaults to the deployment's own) or the "Move members to this
+  benefit" action the panel shows on that version. Each member's Stripe
+  subscription receives the version's forever coupon first, then the frozen row
+  takes the version and its lower renewal amount under the row's revision, so a
+  run that stops between the two is completed by running it again. It only ever
+  widens: a version that would raise a member's renewal, a lapsed, refunded,
+  canceled, declined or restarting purchase, another cohort, and a subscription
+  the provider no longer matches are all left alone and named in the receipt
+  with the reason. A chapter's own billing forecast reports a provider discount
+  its frozen checkout terms do not explain as unknown, never as a full-price
+  renewal.
+
   On a chapter, a person record with no linked application — someone invited or
   a candidate — is managed by the chapter's own admins the way the network
   owner manages it: the record's Invitation tab sets or revokes the local

package/dist/{chunk-WWF2TO3H.js → chunk-NDZCR3OW.js}

@@ -780,11 +780,11 @@ function SeatPanel(props) {
         " \xB7 ",
         seat.recipientEmail,
         " \xB7 ",
-        seat.status.replaceAll("_", " ")
+        (seat.recipientState ?? seat.status).replaceAll("_", " ")
       ] }),
       /* @__PURE__ */ jsxs7("p", { className: "muted", style: { margin: 0 }, children: [
-        money5,
-        " paid in full. The seat waits for its recipient and is never refunded automatically."
+        data.amountCents === 0 ? "Included with the membership; nothing was charged." : `${money5} paid in full.`,
+        " The seat waits for its recipient and is never refunded automatically."
       ] }),
       data.refundable ? /* @__PURE__ */ jsx7("div", { children: /* @__PURE__ */ jsx7(Button3, { variant: "danger", mini: true, disabled: busy, onClick: () => void refund(), children: busy ? "Refunding\u2026" : "Refund seat" }) }) : null
     ] }),
@@ -3506,9 +3506,11 @@ function NetworkSeatBilling(props) {
 }
 
 // src/ui/membership-policy-versions.tsx
-import { DataTable as DataTable5 } from "@odla-ai/ui/components";
+import { Button as Button20, DataTable as DataTable5 } from "@odla-ai/ui/components";
+import { useState as useState31 } from "preact/hooks";
 import { Fragment as Fragment14, jsx as jsx38, jsxs as jsxs34 } from "preact/jsx-runtime";
 var PATH = "/api/admin/membership-policy-versions";
+var RETERM = "/api/admin/membership-discount/reterm";
 var day = (ms) => new Date(ms).toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric", timeZone: "UTC" });
 var money4 = (cents, currency) => new Intl.NumberFormat("en-US", { style: "currency", currency }).format(cents / 100);
 var STATE = { active: "Active", scheduled: "Scheduled", superseded: "Superseded", draft: "Draft", retired: "Retired" };
@@ -3543,13 +3545,13 @@ var offeringColumns = [
   { key: "sku", header: "SKU", cell: (row) => /* @__PURE__ */ jsx38("code", { children: row.baseSkuId }) },
   { key: "list", header: "List price", cell: (row) => `${money4(row.basePriceCents, row.currency)} / ${row.interval}` },
   { key: "term", header: "Term", cell: (row) => row.term.kind === "fixed_end" ? `Ends ${day(row.term.endsAt)}` : `Rolling ${row.term.months} months` },
-  { key: "seat", header: "Seat", cell: (row) => `${money4(row.seatPriceCents, row.currency)} \xB7 ${row.seatPurchaseWindowCalendarMonths === void 0 ? "no window" : `${row.seatPurchaseWindowCalendarMonths}-month window`}` },
+  { key: "seat", header: "Seat", cell: (row) => `${row.seatPriceCents === 0 ? "Included" : money4(row.seatPriceCents, row.currency)} \xB7 ${row.seatPurchaseWindowCalendarMonths === void 0 ? "no window" : `${row.seatPurchaseWindowCalendarMonths}-month window`}` },
   { key: "effectiveFrom", header: "Effective from", cell: (row) => day(row.effectiveFrom), sortAs: "number", sortValue: (row) => row.effectiveFrom },
   { key: "effectiveUntil", header: "Effective until", cell: (row) => row.effectiveUntil === void 0 ? "Open" : day(row.effectiveUntil) },
   { key: "supersededAt", header: "Superseded", cell: superseded },
   { key: "source", header: "Source", cell: (row) => /* @__PURE__ */ jsx38(Source, { row }) }
 ];
-var policyColumns = [
+var policyColumns = (getToken) => [
   { key: "version", header: "Version", cell: (row) => /* @__PURE__ */ jsxs34(Fragment14, { children: [
     /* @__PURE__ */ jsxs34("code", { children: [
       "v",
@@ -3572,8 +3574,40 @@ var policyColumns = [
   { key: "benefit", header: "Benefit duration", cell: (row) => row.benefitDuration.kind === "fixed_end" ? `Until ${day(row.benefitDuration.endsAt)}` : row.benefitDuration.kind === "first_term" ? "First term" : "While active" },
   { key: "mechanism", header: "Provider mechanism", cell: (row) => MECHANISM[row.mechanism] },
   { key: "supersededAt", header: "Superseded", cell: superseded },
-  { key: "source", header: "Source", cell: (row) => /* @__PURE__ */ jsx38(Source, { row }) }
+  { key: "source", header: "Source", cell: (row) => /* @__PURE__ */ jsx38(Source, { row }) },
+  { key: "members", header: "Existing members", cell: (row) => /* @__PURE__ */ jsx38(RetermAction, { row, getToken }) }
 ];
+var summary = (receipt) => {
+  const skipped = receipt.skipped.reduce((acc, item) => ({ ...acc, [item.reason]: (acc[item.reason] ?? 0) + 1 }), {});
+  const parts = [
+    `moved ${receipt.retermed.length}`,
+    `already on it ${receipt.unchanged.length}`,
+    ...Object.entries(skipped).map(([reason, count]) => `skipped ${count} (${reason.replaceAll("_", " ")})`)
+  ];
+  return `${parts.join(" \xB7 ")}${receipt.more ? " \xB7 more remain, run again" : ""}`;
+};
+function RetermAction({ row, getToken }) {
+  const [busy, setBusy] = useState31(false);
+  const [result, setResult] = useState31(null);
+  if (row.state !== "active" || row.mechanism !== "stripe_coupon_forever") return /* @__PURE__ */ jsx38("span", { className: "muted", children: row.state !== "active" ? "Not the active version" : "Benefit is not while-active" });
+  const run = async () => {
+    if (!globalThis.confirm?.(`Move every paid ${row.cohortLabel} member of ${row.chapterId} onto v${row.version}? Their next renewal invoice carries ${row.percentOffBps / 100}% off while they stay active. A member whose renewal this would raise is left alone.`)) return;
+    setBusy(true);
+    setResult(null);
+    try {
+      const receipt = await adminFetch(getToken, RETERM, { method: "POST", body: JSON.stringify({ chapterId: row.chapterId, policyVersionId: row.id }) });
+      setResult({ tone: "good", text: summary(receipt) });
+    } catch (error) {
+      setResult({ tone: "danger", text: error instanceof Error ? error.message : String(error) });
+    } finally {
+      setBusy(false);
+    }
+  };
+  return /* @__PURE__ */ jsxs34("span", { style: { display: "inline-flex", flexDirection: "column", gap: 4 }, children: [
+    /* @__PURE__ */ jsx38(Button20, { mini: true, disabled: busy, onClick: run, children: busy ? "Moving\u2026" : "Move members to this benefit" }),
+    result ? /* @__PURE__ */ jsx38("span", { role: result.tone === "good" ? "status" : "alert", className: result.tone === "danger" ? "danger" : "muted", children: result.text }) : null
+  ] });
+}
 function MembershipPolicyVersions(props) {
   const path = props.chapterId ? `${PATH}?chapterId=${encodeURIComponent(props.chapterId)}` : PATH;
   const { data, loading, error } = useAdminResource(props.getToken, path);
@@ -3606,7 +3640,7 @@ function MembershipPolicyVersions(props) {
         DataTable5,
         {
           rows: data.discountPolicies,
-          columns: policyColumns,
+          columns: policyColumns(props.getToken),
           rowKey: (row) => row.id,
           ariaLabel: "Discount policy versions",
           emptyState: `No discount policy versions are recorded for ${scope}.`
@@ -3670,4 +3704,4 @@ export {
   NetworkSeatBilling,
   MembershipPolicyVersions
 };
-//# sourceMappingURL=chunk-WWF2TO3H.js.map
+//# sourceMappingURL=chunk-NDZCR3OW.js.map