@odla-ai/chapter 0.49.0 → 0.51.0

package/dist/index.cjs

@@ -176,6 +176,7 @@ __export(src_exports, {
   planMemberSystemEventReplay: () => planMemberSystemEventReplay,
   planMemberSystemMigration: () => planMemberSystemMigration,
   planPrivateRoleMigration: () => planPrivateRoleMigration,
+  previewMembershipCommercialOffer: () => previewMembershipCommercialOffer,
   projectApplicant: () => projectApplicant,
   projectBuilderLibraryDelivery: () => projectBuilderLibraryDelivery,
   projectMemberContent: () => projectMemberContent,
@@ -208,6 +209,7 @@ __export(src_exports, {
   requestMembershipChapterEffect: () => requestMembershipChapterEffect,
   requestMembershipCheckoutBinding: () => requestMembershipCheckoutBinding,
   requestMembershipCommercialOffer: () => requestMembershipCommercialOffer,
+  requestMembershipOfferPreview: () => requestMembershipOfferPreview,
   requestMembershipPayment: () => requestMembershipPayment,
   requestMembershipRefund: () => requestMembershipRefund,
   requestMembershipRenewal: () => requestMembershipRenewal,
@@ -219,6 +221,7 @@ __export(src_exports, {
   requestNamedSeatDecline: () => requestNamedSeatDecline,
   requestNamedSeatInvitation: () => requestNamedSeatInvitation,
   requestNamedSeatOffer: () => requestNamedSeatOffer,
+  requestNamedSeatOperatorRefund: () => requestNamedSeatOperatorRefund,
   requestNamedSeatPayment: () => requestNamedSeatPayment,
   requestNamedSeatRefund: () => requestNamedSeatRefund2,
   requestNamedSeatReservation: () => requestNamedSeatReservation,
@@ -236,6 +239,7 @@ __export(src_exports, {
   resolveSignupControl: () => resolveSignupControl,
   resolveTiers: () => resolveTiers,
   roleFromClaim: () => roleFromClaim,
+  seatPurchaseDeadline: () => seatPurchaseDeadline,
   sendTemplated: () => sendTemplated,
   sharedPersonInput: () => sharedPersonInput,
   sharedRecordFromCrm: () => sharedRecordFromCrm,
@@ -1713,6 +1717,7 @@ var DEFAULT_ADMIN_COPY = {
   },
   records: {
     workflowMissing: "This record is not linked to an application workflow.",
+    invitation: "Invitation",
     comms: "Comms",
     commsHistory: "Comms history",
     scheduling: "Scheduling",
@@ -1797,7 +1802,9 @@ var DEFAULT_JOIN_COPY = {
     processing: "Processing\u2026",
     payAndContinue: "Pay and continue",
     incomplete: "The payment did not complete. Please try again.",
-    consent: "I have read and agree to the pricing and refund policy above."
+    consent: "I have read and agree to the pricing and refund policy above.",
+    foundingMember: "Founding member rate",
+    foundingDiscount: "Founding discount"
   },
   done: {
     label: "You're booked",
@@ -3354,7 +3361,7 @@ function findTier(tiers2, tierId) {
   if (!tierId) return tiers2.length === 1 ? tiers2[0] : null;
   return tiers2.find((tier) => tier.id === tierId) ?? null;
 }
-function joinConfigTiers(tiers2, defaults = {}) {
+function joinConfigTiers(tiers2, defaults = {}, founding = /* @__PURE__ */ new Map()) {
   return tiers2.map((tier) => ({
     id: tier.id,
     name: tier.name,
@@ -3362,7 +3369,8 @@ function joinConfigTiers(tiers2, defaults = {}) {
     currency: tier.currency ?? defaults.currency ?? "usd",
     interval: tier.interval ?? defaults.interval ?? "year",
     blurb: tier.blurb ?? "",
-    free: tierIsFree(tier)
+    free: tierIsFree(tier),
+    ...founding.has(tier.id) ? { founding: founding.get(tier.id) } : {}
   }));
 }
 
@@ -3465,6 +3473,11 @@ function createChapterIntegration(chapter, options = {}) {
 }
 
 // src/membership-policy.ts
+function seatPurchaseDeadline(offering, member) {
+  if (offering.seatPurchaseWindowCalendarMonths === void 0) return Number(member.termEndsAt);
+  if (Number.isSafeInteger(member.seatPurchaseEndsAt)) return Number(member.seatPurchaseEndsAt);
+  return addMembershipCalendarMonths(Number(member.initialTermStartedAt ?? member.termStartedAt), offering.seatPurchaseWindowCalendarMonths);
+}
 var fail2 = (field2) => {
   throw new TypeError(`invalid membership policy: ${field2}`);
 };
@@ -3521,7 +3534,7 @@ function membershipOfferingVersion(value) {
     autoRenew: true,
     paymentGraceDays: integer2(input.paymentGraceDays, 0, 60),
     seatPriceCents: integer2(input.seatPriceCents, 1, Number.MAX_SAFE_INTEGER),
-    seatPurchaseWindowCalendarMonths: integer2(input.seatPurchaseWindowCalendarMonths, 1, 120),
+    ...input.seatPurchaseWindowCalendarMonths === void 0 || input.seatPurchaseWindowCalendarMonths === null ? {} : { seatPurchaseWindowCalendarMonths: integer2(input.seatPurchaseWindowCalendarMonths, 1, 120) },
     requiredDisclosures: ids(input.requiredDisclosures)
   };
 }
@@ -3648,24 +3661,63 @@ async function verifyIssuedMembershipOffer(value, expected) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return reject("invalid_offer_snapshot");
   return restore({ ...value, approvedFoundingCount: 0 }, expected);
 }
-async function issueMembershipCommercialOffer(db, input) {
-  validate(input);
-  const stateId = `${input.chapterId}:${input.environment}`;
-  const state = await load(db, "membershipAuthorityState", stateId);
+async function previewMembershipCommercialOffer(db, input) {
+  for (const key3 of ["appId", "chapterId", "environment", "runtime", "skuId"]) {
+    if (typeof input[key3] !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{1,159}$/.test(input[key3])) reject("invalid_offer_identity");
+  }
+  if (!Number.isSafeInteger(input.now) || input.now < 0) reject("invalid_offer_window");
+  const state = await authoritativeState(db, input);
+  const { offering, policy } = await currentPolicy(db, input, false, state);
+  const approvedFoundingCount = policy ? state.cohortCounts[policy.cohortLabel] ?? 0 : 0;
+  if (!Number.isSafeInteger(approvedFoundingCount) || Number(approvedFoundingCount) < 0) reject("invalid_cohort_count");
+  const contract = createMembershipCommercialOffer({
+    offering,
+    discountPolicy: policy,
+    approvedFoundingCount: Number(approvedFoundingCount),
+    now: input.now,
+    couponId: await couponId(input, policy?.id)
+  });
+  const discount = contract.billingTerms.discount;
+  return {
+    skuId: input.skuId,
+    offeringVersionId: offering.id,
+    basePriceCents: offering.basePriceCents,
+    currency: offering.currency,
+    interval: offering.interval,
+    founding: contract.founding,
+    ...contract.founding && contract.discountPolicy ? { cohortLabel: contract.discountPolicy.cohortLabel } : {},
+    dueTodayCents: contract.dueTodayCents,
+    renewalCents: contract.renewalCents,
+    ...discount ? { discountDuration: discount.duration === "once" ? "first_term" : "while_active" } : {},
+    ...contract.initialTermEndsAt !== void 0 ? { initialTermEndsAt: contract.initialTermEndsAt } : {}
+  };
+}
+async function authoritativeState(db, input) {
+  const state = await load(db, "membershipAuthorityState", `${input.chapterId}:${input.environment}`);
   if (!state || state.mode !== "authoritative" || state.chapterId !== input.chapterId || state.environment !== input.environment || !Number.isSafeInteger(state.revision) || Number(state.revision) < 1 || !state.cohortCounts || typeof state.cohortCounts !== "object" || Array.isArray(state.cohortCounts)) return reject("membership_authority_unavailable");
-  const existing = await load(db, "membershipCheckoutOffer", input.offerId);
-  if (existing) return restore(existing, input);
+  return state;
+}
+async function currentPolicy(db, input, restartAware, state) {
   const rows3 = await db.query({
     membershipOfferingVersion: { $: { where: { chapterId: input.chapterId }, limit: 200 } },
     discountPolicyVersion: { $: { where: { chapterId: input.chapterId }, limit: 200 } }
   });
   if (!Array.isArray(rows3.membershipOfferingVersion) || !Array.isArray(rows3.discountPolicyVersion) || rows3.membershipOfferingVersion.length >= 200 || rows3.discountPolicyVersion.length >= 200) return reject("policy_history_incomplete");
-  const offerings = rows3.membershipOfferingVersion.map((row3) => membershipOfferingVersion(row3.snapshot)).filter((offer) => offer.chapterId === input.chapterId && offer.baseSkuId === input.skuId && offer.status === "published" && input.now >= offer.effectiveFrom && (offer.effectiveUntil === void 0 || input.now < offer.effectiveUntil));
-  const policies = rows3.discountPolicyVersion.map((row3) => membershipDiscountPolicyVersion(row3.snapshot)).filter((policy2) => policy2.chapterId === input.chapterId && policy2.status === "published" && policy2.cohortEligibleSkuIds.includes(input.skuId) && input.now >= policy2.qualifyingStartsAt && input.now < policy2.qualifyingEndsAt);
+  const offerings = rows3.membershipOfferingVersion.map((row2) => membershipOfferingVersion(row2.snapshot)).filter((offer) => offer.chapterId === input.chapterId && offer.baseSkuId === input.skuId && offer.status === "published" && input.now >= offer.effectiveFrom && (offer.effectiveUntil === void 0 || input.now < offer.effectiveUntil));
+  const policies = rows3.discountPolicyVersion.map((row2) => membershipDiscountPolicyVersion(row2.snapshot)).filter((policy2) => policy2.chapterId === input.chapterId && policy2.status === "published" && policy2.cohortEligibleSkuIds.includes(input.skuId) && input.now >= policy2.qualifyingStartsAt && input.now < policy2.qualifyingEndsAt);
   const offering = offerings.sort((a, b) => b.version - a.version)[0];
-  const restart = await load(db, "membershipRestart", (await membershipOfferIdForRequest({ ...input, requestId: "checkout_binding" })).replace(/^offer_/, "membership_"));
+  const restart = restartAware && input.applicationId ? await load(db, "membershipRestart", (await membershipOfferIdForRequest({ ...input, applicationId: input.applicationId, requestId: "checkout_binding" })).replace(/^offer_/, "membership_")) : void 0;
   const policy = restart ? void 0 : policies.sort((a, b) => b.version - a.version)[0];
   if (!offering || offerings.filter((item) => item.version === offering.version).length !== 1 || policy && policies.filter((item) => item.version === policy.version).length !== 1) reject("ambiguous_membership_policy");
+  return { offering, policy };
+}
+async function issueMembershipCommercialOffer(db, input) {
+  validate(input);
+  const stateId = `${input.chapterId}:${input.environment}`;
+  const state = await authoritativeState(db, input);
+  const existing = await load(db, "membershipCheckoutOffer", input.offerId);
+  if (existing) return restore(existing, input);
+  const { offering, policy } = await currentPolicy(db, input, true, state);
   const approvedFoundingCount = policy ? state.cohortCounts[policy.cohortLabel] ?? 0 : 0;
   if (!Number.isSafeInteger(approvedFoundingCount) || Number(approvedFoundingCount) < 0) reject("invalid_cohort_count");
   const contract = createMembershipCommercialOffer({
@@ -3876,7 +3928,7 @@ async function confirmMembershipPayment(db, input, now) {
       initialTermEndsAt: endsAt,
       termStartedAt: paidAt,
       termEndsAt: endsAt,
-      seatPurchaseEndsAt: addMembershipCalendarMonths(Number(paidAt), offering.seatPurchaseWindowCalendarMonths),
+      seatPurchaseEndsAt: seatPurchaseDeadline(offering, { initialTermStartedAt: paidAt, termEndsAt: endsAt }),
       autoRenew: true,
       refundedCents: 0,
       revision: 1,
@@ -4304,7 +4356,11 @@ async function reconcileMembershipRenewal(db, input, now) {
       membershipUpdate("networkMembership", id10, {
         status: status2,
         graceEndsAt,
-        ...paid ? { termStartedAt: start, termEndsAt: end } : {},
+        ...paid ? {
+          termStartedAt: start,
+          termEndsAt: end,
+          ...membershipOfferingVersion(member.offeringSnapshot).seatPurchaseWindowCalendarMonths === void 0 ? { seatPurchaseEndsAt: end } : {}
+        } : {},
         revision: Number(member.revision) + 1,
         updatedAt: now
       }),
@@ -4606,10 +4662,11 @@ async function reserveNamedMembershipSeat(db, input, now) {
   const id10 = (await membershipOfferIdForRequest({ ...input, requestId: "named_seat" })).replace(/^offer_/, "seat_");
   let seat = await membershipLoad(db, "networkSeat", id10);
   if (!seat) {
-    if (!["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) || Number(member.refundedCents) !== 0 || now < Number(member.initialTermStartedAt) || now >= Number(member.termEndsAt) || now > Number(member.seatPurchaseEndsAt) || !Number.isSafeInteger(member.seatPurchaseEndsAt) || member.namedSeatId !== void 0) {
+    const offering = membershipOfferingVersion(member.offeringSnapshot), claimId = await recipientKey(input, email);
+    const purchaseEndsAt = seatPurchaseDeadline(offering, member);
+    if (!["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) || Number(member.refundedCents) !== 0 || now < Number(member.initialTermStartedAt) || now >= Number(member.termEndsAt) || now > purchaseEndsAt || !Number.isSafeInteger(purchaseEndsAt) || member.namedSeatId !== void 0) {
       membershipFail("named_seat_purchase_unavailable");
     }
-    const offering = membershipOfferingVersion(member.offeringSnapshot), claimId = await recipientKey(input, email);
     const attrs = {
       id: id10,
       ...membershipScope(input),
@@ -4628,7 +4685,7 @@ async function reserveNamedMembershipSeat(db, input, now) {
       status: "payment_pending",
       preparedAt: now,
       termEndsAt: member.termEndsAt,
-      seatPurchaseEndsAt: member.seatPurchaseEndsAt,
+      seatPurchaseEndsAt: purchaseEndsAt,
       offeringSnapshot: offering,
       revision: 1,
       createdAt: now,
@@ -4845,14 +4902,14 @@ async function confirmNamedMembershipSeatPayment(db, input, now) {
   }
   if (seat.purchasedAt === void 0) {
     if (!["payment_processing", "payment_canceling"].includes(String(seat.status))) membershipFail("named_seat_payment_not_expected");
-    const eligible = seat.status !== "payment_canceling" && ["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) && Number(member.refundedCents) === 0 && paidAt <= Number(member.seatPurchaseEndsAt) && now < Number(member.termEndsAt);
+    const eligible = seat.status !== "payment_canceling" && ["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) && Number(member.refundedCents) === 0 && paidAt <= seatPurchaseDeadline(membershipOfferingVersion(member.offeringSnapshot), member) && now < Number(member.termEndsAt);
     const status2 = eligible ? "renewal_pending" : "refund_pending", effectId = `${seat.id}:${eligible ? "attach-renewal" : "refund"}`;
     try {
       await db.transact([
         membershipUpdate("networkSeat", input.seatId, {
           status: status2,
           purchasedAt: paidAt,
-          acceptanceEndsAt: Math.min(paidAt + 30 * 864e5, Number(member.termEndsAt)),
+          acceptanceEndsAt: Number(member.termEndsAt),
           termStartedAt: paidAt,
           termEndsAt: member.termEndsAt,
           paymentEventId: input.eventId,
@@ -4900,7 +4957,7 @@ async function completeNamedSeatRenewal(db, seatId, secretKey, now) {
   if (seat.status !== "renewal_pending" || !seat.purchasedAt) membershipFail("named_seat_renewal_not_ready");
   const member = await membershipLoad(db, "networkMembership", target.primaryMembershipId);
   requireMembershipScope(member, target);
-  if (now >= Number(seat.acceptanceEndsAt) || now >= Number(member.termEndsAt) || Number(member.refundedCents) !== 0 || !["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status))) membershipFail("named_seat_refund_required");
+  if (now >= Number(member.termEndsAt) || Number(member.refundedCents) !== 0 || !["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status))) membershipFail("named_seat_refund_required");
   const itemId = await attachNamedSeatStripeRenewal(secretKey, target);
   const entitlementId = `${seatId}:entitlement`, effectId = `${seatId}:attach-renewal`;
   try {
@@ -4975,7 +5032,7 @@ async function recordRecipient(db, input, now, approve) {
     requireMembershipScope(entitlement, input);
     if (!["pending_acceptance", "pending_approval", "pending_primary", "active"].includes(String(seat.status)) || !["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) || Number(member.refundedCents) !== 0 || now >= Number(member.termEndsAt) || !seat.providerPaymentIntentId || !seat.providerSubscriptionItemId) membershipFail("named_seat_acceptance_unavailable");
     if (seat.acceptedAt === void 0) {
-      if (approve || now >= Number(seat.acceptanceEndsAt) || normalizeChapterEmail(input.verifiedRecipientEmail) !== seat.recipientEmailNormalized) {
+      if (approve || normalizeChapterEmail(input.verifiedRecipientEmail) !== seat.recipientEmailNormalized) {
         membershipFail("named_seat_recipient_verification_required");
       }
     } else if (seat.recipientUserId !== input.recipientUserId || seat.recipientApplicationId !== input.recipientApplicationId) {
@@ -5088,7 +5145,7 @@ async function requestNamedSeatRefund(db, input, now) {
   const member = await membershipLoad(db, "networkMembership", String(seat.primaryMembershipId));
   requireMembershipScope(member, input);
   if (seat.status === "refunded" || seat.status === "refund_pending") return;
-  if (!seat.purchasedAt || !seat.providerPaymentIntentId || input.reason === "declined" && seat.journeyApprovedAt !== void 0 || input.reason === "expired" && (seat.acceptedAt !== void 0 || !Number.isSafeInteger(seat.acceptanceEndsAt) || now < Number(seat.acceptanceEndsAt)) || input.reason === "primary_closed" && !["refunded", "declined"].includes(String(member.status))) membershipFail("named_seat_refund_not_eligible");
+  if (!seat.purchasedAt || !seat.providerPaymentIntentId || input.reason === "declined" && seat.journeyApprovedAt !== void 0 || input.reason === "primary_closed" && !["refunded", "declined"].includes(String(member.status))) membershipFail("named_seat_refund_not_eligible");
   const entitlement = seat.entitlementId ? await membershipLoad(db, "networkEntitlement", String(seat.entitlementId)) : void 0;
   await db.transact([
     membershipUpdate("networkSeat", input.seatId, { status: "refund_pending", refundReason: input.reason, revision: Number(seat.revision) + 1, updatedAt: now }),
@@ -5160,6 +5217,19 @@ async function confirmNamedSeatProviderRefund(db, input, now) {
   await requestNamedSeatRefund(db, { ...input, reason: "provider_refund" }, now);
 }
 
+// src/membership-seat-operator-refund.ts
+async function refundNamedSeatByOperator(db, input, stripeSecretKey, now) {
+  const seat = await membershipLoad(db, "networkSeat", input.seatId);
+  requireMembershipScope(seat, input);
+  await requestNamedSeatRefund(db, { ...input, reason: "operator" }, now);
+  await completeNamedSeatRefund(db, input.seatId, stripeSecretKey, now);
+  const refunded = await membershipLoad(db, "networkSeat", input.seatId);
+  if (refunded?.status !== "refunded" || !Number.isSafeInteger(refunded.refundedCents) || Number(refunded.refundedCents) <= 0) {
+    throw new Error("named seat refund unconfirmed");
+  }
+  return { seatId: String(seat.id), status: "refunded", refundedCents: Number(refunded.refundedCents), subscriptionCanceled: false };
+}
+
 // src/membership-seat-offer.ts
 async function namedSeatOfferDigest(offer) {
   const bytes = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([
@@ -5172,7 +5242,7 @@ async function namedSeatOfferDigest(offer) {
     "named-only",
     "full-upfront",
     "auto-renew-coterm",
-    "30-day-unaccepted-full-refund"
+    "no-automatic-refund"
   ])));
   return [...new Uint8Array(bytes)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
 }
@@ -5184,15 +5254,16 @@ async function readNamedSeatOffer(db, input, now) {
   const offering = membershipOfferingVersion(member.offeringSnapshot);
   const seat = member.namedSeatId ? await membershipLoad(db, "networkSeat", String(member.namedSeatId)) : void 0;
   if (seat) requireMembershipScope(seat, input);
+  const purchaseEndsAt = seatPurchaseDeadline(offering, member);
   const offer = {
     membershipId: id10,
     amountCents: offering.seatPriceCents,
     currency: offering.currency,
     interval: offering.interval,
     termEndsAt: Number(member.termEndsAt),
-    purchaseEndsAt: Number(member.seatPurchaseEndsAt),
+    purchaseEndsAt,
     autoRenew: member.autoRenew === true,
-    eligible: ["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) && member.refundedCents === 0 && now >= Number(member.initialTermStartedAt) && now < Number(member.termEndsAt) && now <= Number(member.seatPurchaseEndsAt) && (!seat || ["payment_pending", "payment_processing"].includes(String(seat.status))),
+    eligible: ["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) && member.refundedCents === 0 && now >= Number(member.initialTermStartedAt) && now < Number(member.termEndsAt) && now <= purchaseEndsAt && (!seat || ["payment_pending", "payment_processing"].includes(String(seat.status))),
     ...seat ? { seat: {
       seatId: String(seat.id),
       status: String(seat.status),
@@ -5200,7 +5271,7 @@ async function readNamedSeatOffer(db, input, now) {
       recipientEmail: String(seat.recipientEmailNormalized)
     } } : {}
   };
-  return { ...offer, digest: await namedSeatOfferDigest(offer) };
+  return { ...offer, digest: await namedSeatOfferDigest(offer), purchaseWindowed: offering.seatPurchaseWindowCalendarMonths !== void 0 };
 }
 
 // src/membership-seat-invitation.ts
@@ -5212,7 +5283,7 @@ async function readNamedSeatInvitation(db, input, now) {
   await loadMembershipAuthorityState(db, target);
   const member = await membershipLoad(db, "networkMembership", String(seat.primaryMembershipId));
   requireMembershipScope(member, target);
-  if (!["pending_acceptance", "pending_approval", "pending_primary", "active"].includes(String(seat.status)) || !["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) || now >= Number(member.termEndsAt) || !seat.acceptedAt && now >= Number(seat.acceptanceEndsAt)) membershipFail("named_seat_invitation_unavailable");
+  if (!["pending_acceptance", "pending_approval", "pending_primary", "active"].includes(String(seat.status)) || !["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) || now >= Number(member.termEndsAt)) membershipFail("named_seat_invitation_unavailable");
   return {
     seatId: input.seatId,
     primaryApplicationId: target.applicationId,
@@ -5242,7 +5313,7 @@ async function readMembershipChapterEffect(db, input, now) {
   requireMembershipScope(member, input);
   if (!effect || effect.kind !== input.kind || effect.seatId !== seat.id || effect.membershipId !== member.id || ["chapterId", "environment", "runtime"].some((key3) => effect[key3] !== seat[key3]) || !["invite_named_recipient", "grant_named_recipient_access", "revoke_named_recipient_access"].includes(input.kind)) throw new Error("invalid chapter effect");
   let applicable;
-  if (input.kind === "invite_named_recipient") applicable = seat.status === "pending_acceptance" && seat.acceptedAt === void 0 && now < Number(seat.acceptanceEndsAt) && now < Number(member.termEndsAt) && ["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status));
+  if (input.kind === "invite_named_recipient") applicable = seat.status === "pending_acceptance" && seat.acceptedAt === void 0 && now < Number(member.termEndsAt) && ["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status));
   else if (input.kind === "revoke_named_recipient_access") applicable = ["refund_pending", "refunded"].includes(String(seat.status));
   else applicable = (await readNamedSeatAccess(db, {
     ...input,
@@ -5271,6 +5342,7 @@ var MEMBERSHIP_SEAT_ACTION_FIELDS = {
   "seat-reservations": ["recipientName", "recipientEmail", "purchaserEmail", "purchaserUserId"],
   "seat-payments": ["seatId", "eventId"],
   "seat-refunds": ["seatId", "eventId"],
+  "seat-operator-refund": ["seatId"],
   "seat-accept": recipient,
   "seat-approve": recipient,
   "seat-decline": recipient,
@@ -5339,6 +5411,7 @@ async function handleMembershipSeatAction(action, db, peer, input, now, stripeSe
     if (refunded?.status !== "refunded" || refunded.refundedCents !== seat.amountCents) throw new Error("named seat refund unconfirmed");
     return { seatId: seat.id, status: "refunded", refundedCents: refunded.refundedCents, subscriptionCanceled: false };
   }
+  if (action === "seat-operator-refund") return refundNamedSeatByOperator(db, { ...target, seatId: String(input.seatId) }, secret, now);
   if (action === "seat-checkouts") return prepareNamedMembershipSeatPayment(db, {
     ...target,
     priceId: peer.seatPriceId,
@@ -5427,7 +5500,7 @@ function createMembershipAuthorityHandler(options) {
     if (req.method !== "POST") return respond({ error: "method_not_allowed" }, 405);
     const sender = req.headers.get(import_db.FEDERATION_HEADERS.sender);
     const action = url.pathname.split("/").at(-1);
-    if (!["offers", "checkouts", "payments", "approvals", "refunds", "renewals", "access", "restarts", "cancel-renewal", ...Object.keys(MEMBERSHIP_SEAT_ACTION_FIELDS)].includes(action ?? "")) return respond({ error: "unauthorized" }, 401);
+    if (!["offers", "offer-preview", "checkouts", "payments", "approvals", "refunds", "renewals", "access", "restarts", "cancel-renewal", ...Object.keys(MEMBERSHIP_SEAT_ACTION_FIELDS)].includes(action ?? "")) return respond({ error: "unauthorized" }, 401);
     const peer = peers.find((candidate) => candidate.appId === sender && url.pathname === `${MEMBERSHIP_AUTHORITY_PATH}/${candidate.runtime}/${action}` && !url.search);
     if (!peer) return respond({ error: "unauthorized" }, 401);
     let body;
@@ -5449,13 +5522,23 @@ function createMembershipAuthorityHandler(options) {
       let input;
       try {
         input = JSON.parse(verified.body);
-        const fields = action === "seat-invitation" ? MEMBERSHIP_SEAT_ACTION_FIELDS[action] : ["applicationId", "skuId", ...action === "offers" ? ["requestId"] : action === "checkouts" ? ["offerId", "offerDigest", "quoteDigest", "priceId"] : action === "payments" ? ["eventId", "providerSubscriptionId", "providerCustomerId"] : action === "renewals" ? ["eventId"] : action === "restarts" ? ["previousSubscriptionId"] : MEMBERSHIP_SEAT_ACTION_FIELDS[action] ?? []];
+        const fields = action === "seat-invitation" ? MEMBERSHIP_SEAT_ACTION_FIELDS[action] : action === "offer-preview" ? ["skuId"] : ["applicationId", "skuId", ...action === "offers" ? ["requestId"] : action === "checkouts" ? ["offerId", "offerDigest", "quoteDigest", "priceId"] : action === "payments" ? ["eventId", "providerSubscriptionId", "providerCustomerId"] : action === "renewals" ? ["eventId"] : action === "restarts" ? ["previousSubscriptionId"] : MEMBERSHIP_SEAT_ACTION_FIELDS[action] ?? []];
         if (!input || typeof input !== "object" || Array.isArray(input) || Object.keys(input).some((key3) => !fields.includes(key3)) || !fields.every((key3) => typeof input[key3] === "string" && (["recipientName", "recipientEmail", "purchaserEmail", "verifiedRecipientEmail"].includes(key3) ? input[key3].length > 0 && input[key3].length <= 254 && !/[\u0000-\u001f\u007f]/.test(input[key3]) : SAFE.test(input[key3])))) {
           throw new TypeError("invalid request");
         }
       } catch {
         return respond({ error: "invalid_offer_request" }, 400);
       }
+      if (action === "offer-preview") {
+        return respond({ ok: true, preview: await previewMembershipCommercialOffer(db, {
+          appId: peer.appId,
+          chapterId: peer.chapterId,
+          environment: peer.environment,
+          runtime: peer.runtime,
+          skuId: String(input.skuId),
+          now: options.now?.() ?? Date.now()
+        }) });
+      }
       if (Object.hasOwn(MEMBERSHIP_SEAT_ACTION_FIELDS, action)) {
         return respond({ ok: true, seat: await handleMembershipSeatAction(
           action,
@@ -5606,6 +5689,12 @@ async function requestMembershipCommercialOffer(options) {
     lifetimeMs: 6e4
   });
 }
+async function requestMembershipOfferPreview(options) {
+  const result = await requestAuthority(options, "offer-preview", { skuId: options.skuId });
+  const preview = result.preview;
+  if (!preview || preview.skuId !== options.skuId || typeof preview.founding !== "boolean" || !Number.isSafeInteger(preview.basePriceCents) || !Number.isSafeInteger(preview.dueTodayCents) || preview.dueTodayCents < 0 || preview.dueTodayCents > preview.basePriceCents || !Number.isSafeInteger(preview.renewalCents) || !/^[a-z]{3}$/.test(preview.currency) || !["month", "year"].includes(preview.interval) || preview.cohortLabel !== void 0 && typeof preview.cohortLabel !== "string" || preview.discountDuration !== void 0 && !["first_term", "while_active"].includes(preview.discountDuration)) throw new Error("invalid offer preview");
+  return preview;
+}
 async function requestMembershipCheckoutBinding(options) {
   const result = await requestAuthority(options, "checkouts", {
     applicationId: options.applicationId,
@@ -5644,6 +5733,12 @@ async function requestNamedSeatDecline(options) {
   if (!seat || seat.seatId !== options.seatId || seat.status !== "refunded" || seat.subscriptionCanceled !== false || !Number.isSafeInteger(seat.refundedCents) || seat.refundedCents <= 0) throw new Error("invalid named seat refund receipt");
   return seat;
 }
+async function requestNamedSeatOperatorRefund(options) {
+  const result = await requestAuthority(options, "seat-operator-refund", { applicationId: options.applicationId, skuId: options.skuId, seatId: options.seatId });
+  const seat = result.seat;
+  if (!seat || seat.seatId !== options.seatId || seat.status !== "refunded" || seat.subscriptionCanceled !== false || !Number.isSafeInteger(seat.refundedCents) || seat.refundedCents <= 0) throw new Error("invalid named seat refund receipt");
+  return seat;
+}
 async function requestNamedSeatReservation(options) {
   const result = await requestAuthority(options, "seat-reservations", {
     applicationId: options.applicationId,
@@ -5661,7 +5756,7 @@ async function requestNamedSeatReservation(options) {
 async function requestNamedSeatOffer(options) {
   const result = await requestAuthority(options, "seat-offer", { applicationId: options.applicationId, skuId: options.skuId });
   const offer = result.seat;
-  if (!offer || offer.membershipId !== await networkMembershipId(options) || !Number.isSafeInteger(offer.amountCents) || offer.amountCents <= 0 || !/^[a-z]{3}$/.test(offer.currency) || !["month", "year"].includes(offer.interval) || typeof offer.eligible !== "boolean" || typeof offer.autoRenew !== "boolean" || !Number.isSafeInteger(offer.termEndsAt) || !Number.isSafeInteger(offer.purchaseEndsAt) || offer.digest !== await namedSeatOfferDigest(offer)) throw new Error("invalid named seat offer");
+  if (!offer || offer.membershipId !== await networkMembershipId(options) || !Number.isSafeInteger(offer.amountCents) || offer.amountCents <= 0 || !/^[a-z]{3}$/.test(offer.currency) || !["month", "year"].includes(offer.interval) || typeof offer.eligible !== "boolean" || typeof offer.autoRenew !== "boolean" || !Number.isSafeInteger(offer.termEndsAt) || !Number.isSafeInteger(offer.purchaseEndsAt) || offer.purchaseWindowed !== void 0 && typeof offer.purchaseWindowed !== "boolean" || offer.digest !== await namedSeatOfferDigest(offer)) throw new Error("invalid named seat offer");
   return offer;
 }
 async function requestNamedSeatInvitation(options) {
@@ -5888,7 +5983,7 @@ async function drainMembershipEffects(db, options, now) {
   if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100 || !options.stripeSecretKey) throw new TypeError("invalid membership recovery configuration");
   await loadMembershipAuthorityState(db, scope2);
   const matches2 = (row2) => Object.entries(scope2).every(([key3, value]) => row2[key3] === value);
-  let expired = 0, pending = 0, complete = 0, more = false;
+  let pending = 0, complete = 0, more = false;
   for (const status2 of ["payment_pending", "payment_processing", "payment_canceling"]) {
     const seats = (await db.query({ networkSeat: { $: { where: { ...scope2, status: status2 }, order: { updatedAt: "asc" }, limit: limit + 1 } } })).networkSeat ?? [];
     more ||= seats.length > limit;
@@ -5906,26 +6001,6 @@ async function drainMembershipEffects(db, options, now) {
       }
     }
   }
-  for (const status2 of ["renewal_pending", "pending_acceptance"]) {
-    const seats = (await db.query({ networkSeat: { $: { where: { ...scope2, status: status2 }, order: { acceptanceEndsAt: "asc" }, limit: limit + 1 } } })).networkSeat ?? [];
-    more ||= seats.length > limit;
-    for (const seat of seats.slice(0, limit)) {
-      if (!matches2(seat)) throw new Error("membership recovery scope mismatch");
-      if (seat.acceptedAt !== void 0 || now < Number(seat.acceptanceEndsAt)) continue;
-      try {
-        await requestNamedSeatRefund(db, {
-          ...scope2,
-          applicationId: String(seat.applicationId),
-          skuId: String(seat.skuId),
-          seatId: String(seat.id),
-          reason: "expired"
-        }, now);
-        expired++;
-      } catch {
-        pending++;
-      }
-    }
-  }
   const effects = (await db.query({ membershipEffect: { $: { where: {
     chapterId: scope2.chapterId,
     environment: scope2.environment,
@@ -5987,7 +6062,7 @@ async function drainMembershipEffects(db, options, now) {
       pending++;
     }
   }
-  return { complete, pending, expired, more };
+  return { complete, pending, more };
 }
 
 // src/schema-membership-offers.ts