@odla-ai/chapter 0.53.0 → 0.54.0

package/dist/index.js

@@ -3286,8 +3286,8 @@ var object = (value) => {
 var id6 = (value) => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9_.:-]{2,159}$/.test(value) ? value : fail2("id");
 var integer2 = (value, min, max) => typeof value === "number" && Number.isSafeInteger(value) && value >= min && value <= max ? value : fail2("integer");
 var time = (value) => {
-  const at = typeof value === "number" ? value : typeof value === "string" ? Date.parse(value) : NaN;
-  return integer2(at, 0, 864e13);
+  const at2 = typeof value === "number" ? value : typeof value === "string" ? Date.parse(value) : NaN;
+  return integer2(at2, 0, 864e13);
 };
 var ids = (value, allowEmpty = false) => {
   if (!Array.isArray(value) || value.length > 100 || !allowEmpty && value.length === 0) return fail2("ids");
@@ -3331,7 +3331,7 @@ function membershipOfferingVersion(value) {
     term: normalizedTerm,
     autoRenew: true,
     paymentGraceDays: integer2(input.paymentGraceDays, 0, 60),
-    seatPriceCents: integer2(input.seatPriceCents, 1, Number.MAX_SAFE_INTEGER),
+    seatPriceCents: integer2(input.seatPriceCents, 0, Number.MAX_SAFE_INTEGER),
     ...input.seatPurchaseWindowCalendarMonths === void 0 || input.seatPurchaseWindowCalendarMonths === null ? {} : { seatPurchaseWindowCalendarMonths: integer2(input.seatPurchaseWindowCalendarMonths, 1, 120) },
     requiredDisclosures: ids(input.requiredDisclosures)
   };
@@ -4103,6 +4103,181 @@ async function refundNetworkMembership(db, input, secretKey, now) {
 // src/membership-provider-lifecycle.ts
 import { stripeRequest as stripeRequest4 } from "@odla-ai/stripe";
 
+// src/membership-seat-reservation.ts
+async function recipientKey(input, email) {
+  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([input.appId, input.chapterId, input.environment, input.runtime, email])));
+  return `seat-recipient:${[...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+}
+async function reserveNamedMembershipSeat(db, input, now) {
+  membershipClock(now);
+  const name = typeof input.recipientName === "string" ? input.recipientName.trim().replace(/\s+/g, " ") : "";
+  const email = normalizeChapterEmail(typeof input.recipientEmail === "string" ? input.recipientEmail : "");
+  const purchaser = normalizeChapterEmail(typeof input.purchaserEmail === "string" ? input.purchaserEmail : "");
+  if (name.length < 2 || name.length > 160 || /[\u0000-\u001f\u007f]/.test(input.recipientName) || email.length > 254 || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email) || !purchaser || email === purchaser || !/^price_[A-Za-z0-9_]+$/.test(input.priceId) || !/^user_[A-Za-z0-9_]+$/.test(input.purchaserUserId)) membershipFail("invalid_named_seat_recipient");
+  const state = await loadMembershipAuthorityState(db, input);
+  const memberId = await networkMembershipId(input), member = await membershipLoad(db, "networkMembership", memberId);
+  requireMembershipScope(member, input);
+  if (!Number.isSafeInteger(member.revision) || !/^price_[A-Za-z0-9_]+$/.test(String(member.providerPriceId)) || member.providerPriceId === input.priceId) membershipFail("named_seat_purchase_unavailable");
+  const id10 = (await membershipOfferIdForRequest({ ...input, requestId: "named_seat" })).replace(/^offer_/, "seat_");
+  let seat = await membershipLoad(db, "networkSeat", id10);
+  if (!seat) {
+    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 attrs = {
+      id: id10,
+      ...membershipScope(input),
+      primaryMembershipId: memberId,
+      recipientName: name,
+      recipientEmailNormalized: email,
+      purchaserUserId: input.purchaserUserId,
+      recipientClaimId: claimId,
+      priceId: input.priceId,
+      primaryPriceId: member.providerPriceId,
+      amountCents: offering.seatPriceCents,
+      currency: offering.currency,
+      interval: offering.interval,
+      providerCustomerId: member.providerCustomerId,
+      providerSubscriptionId: member.providerSubscriptionId,
+      status: "payment_pending",
+      preparedAt: now,
+      termEndsAt: member.termEndsAt,
+      seatPurchaseEndsAt: purchaseEndsAt,
+      offeringSnapshot: offering,
+      revision: 1,
+      createdAt: now,
+      updatedAt: now
+    };
+    try {
+      await db.transact([
+        membershipUpdate("networkSeat", id10, attrs),
+        membershipUpdate("networkSeatRecipient", claimId, {
+          id: claimId,
+          appId: input.appId,
+          chapterId: input.chapterId,
+          environment: input.environment,
+          runtime: input.runtime,
+          seatId: id10,
+          recipientEmailNormalized: email,
+          createdAt: now
+        }),
+        membershipUpdate("networkMembership", memberId, { namedSeatId: id10, revision: Number(member.revision) + 1, updatedAt: now })
+      ], { mutationId: `named-seat-reserve:${id10}`, guards: [
+        { ns: "networkSeat", id: id10, exists: false },
+        { ns: "networkSeatRecipient", id: claimId, exists: false },
+        { ns: "networkMembership", id: memberId, exists: true, equals: { revision: member.revision }, absent: ["namedSeatId"] },
+        { ns: "membershipAuthorityState", id: String(state.id), exists: true, equals: { mode: "authoritative", revision: state.revision } }
+      ] });
+    } catch (error) {
+      if (error.code !== "transact_guard_failed") throw error;
+    }
+    seat = await membershipLoad(db, "networkSeat", id10);
+    if (!seat && await membershipLoad(db, "networkSeatRecipient", claimId)) membershipFail("named_seat_recipient_unavailable");
+  }
+  requireMembershipScope(seat, input);
+  if (seat.primaryMembershipId !== memberId || seat.recipientName !== name || seat.recipientEmailNormalized !== email || seat.priceId !== input.priceId || seat.purchaserUserId !== input.purchaserUserId) membershipFail("named_seat_purchase_conflict");
+  return seat;
+}
+
+// src/membership-seat-included.ts
+var namedSeatIncluded = (seat) => Number(seat.amountCents) === 0;
+var namedSeatSettled = (seat) => namedSeatIncluded(seat) ? seat.purchasedAt !== void 0 : Boolean(seat.providerPaymentIntentId && seat.providerSubscriptionItemId);
+function namedSeatRecipientState(seat) {
+  switch (String(seat.status)) {
+    case "renewal_pending":
+    case "pending_acceptance":
+      return "invited";
+    case "pending_approval":
+    case "pending_primary":
+      return "accepted";
+    case "active":
+      return "joined";
+    case "refund_pending":
+    case "refunded":
+      return seat.refundReason === "declined" ? "declined" : "refunded";
+    case "canceled":
+      return "canceled";
+    default:
+      return "payment_pending";
+  }
+}
+var OPEN = ["pending_acceptance", "pending_approval", "pending_primary", "active"];
+async function grantIncludedNamedSeat(db, input, now) {
+  membershipClock(now);
+  const seat = await reserveNamedMembershipSeat(db, input, now);
+  if (!namedSeatIncluded(seat)) membershipFail("named_seat_not_included");
+  const state = await loadMembershipAuthorityState(db, input);
+  const member = await membershipLoad(db, "networkMembership", seat.primaryMembershipId);
+  requireMembershipScope(member, input);
+  if (!["paid_pending_approval", "active", "cancel_at_term_end"].includes(String(member.status)) || Number(member.refundedCents) !== 0 || member.namedSeatId !== seat.id || now >= Number(member.termEndsAt)) {
+    membershipFail("named_seat_purchase_unavailable");
+  }
+  if (seat.status === "payment_pending") {
+    const entitlementId = `${seat.id}:entitlement`, inviteId = `${seat.id}:invite`, source = `included:${seat.id}`;
+    try {
+      await db.transact([
+        membershipUpdate("networkSeat", seat.id, {
+          status: "pending_acceptance",
+          purchasedAt: now,
+          termStartedAt: now,
+          termEndsAt: member.termEndsAt,
+          acceptanceEndsAt: Number(member.termEndsAt),
+          entitlementId,
+          revision: Number(seat.revision) + 1,
+          updatedAt: now
+        }),
+        membershipUpdate("networkEntitlement", entitlementId, {
+          id: entitlementId,
+          ...membershipScope(input),
+          membershipId: member.id,
+          seatId: seat.id,
+          kind: "named_seat",
+          status: "pending_acceptance",
+          termStartedAt: now,
+          termEndsAt: member.termEndsAt,
+          offeringSnapshot: member.offeringSnapshot,
+          sourceEventId: source,
+          revision: 1,
+          createdAt: now,
+          updatedAt: now
+        }),
+        membershipUpdate("membershipEffect", inviteId, {
+          id: inviteId,
+          chapterId: input.chapterId,
+          environment: input.environment,
+          runtime: input.runtime,
+          membershipId: member.id,
+          seatId: seat.id,
+          kind: "invite_named_recipient",
+          status: "pending",
+          attempts: 0,
+          createdAt: now,
+          updatedAt: now
+        })
+      ], { mutationId: `named-seat-included:${seat.id}`, guards: [
+        {
+          ns: "networkSeat",
+          id: seat.id,
+          exists: true,
+          equals: { status: "payment_pending", revision: seat.revision, amountCents: 0 },
+          absent: ["purchasedAt", "providerPaymentIntentId"]
+        },
+        { ns: "networkEntitlement", id: entitlementId, exists: false },
+        { ns: "networkMembership", id: String(member.id), exists: true, equals: { revision: member.revision, namedSeatId: seat.id } },
+        { ns: "membershipAuthorityState", id: String(state.id), exists: true, equals: { mode: "authoritative", revision: state.revision } }
+      ] });
+    } catch (error) {
+      if (error.code !== "transact_guard_failed") throw error;
+    }
+  }
+  const current = await membershipLoad(db, "networkSeat", seat.id);
+  requireMembershipScope(current, input);
+  if (!namedSeatIncluded(current) || current.purchasedAt === void 0 || !OPEN.includes(String(current.status))) membershipFail("named_seat_purchase_unavailable");
+  return { seatId: seat.id, amountCents: 0, currency: seat.currency, termEndsAt: Number(current.termEndsAt), status: String(current.status), included: true };
+}
+
 // src/membership-renewal-authority.ts
 async function reconcileMembershipRenewal(db, input, now) {
   membershipClock(now);
@@ -4138,7 +4313,9 @@ async function reconcileMembershipRenewal(db, input, now) {
     if (start !== member.termEndsAt || start > now + 3e4) membershipFail("membership_renewal_period_gap");
     const seat = member.namedSeatId ? await membershipLoad(db, "networkSeat", String(member.namedSeatId)) : void 0;
     if (seat) requireMembershipScope(seat, input);
-    const billedSeat = seat && seat.providerSubscriptionId === member.providerSubscriptionId && seat.providerSubscriptionItemId && !["refunded", "refund_pending"].includes(String(seat.status)) ? seat : void 0;
+    const openSeat = seat && !["refunded", "refund_pending", "canceled"].includes(String(seat.status)) ? seat : void 0;
+    const billedSeat = openSeat && openSeat.providerSubscriptionId === member.providerSubscriptionId && openSeat.providerSubscriptionItemId ? openSeat : void 0;
+    const carriedSeat = billedSeat ?? (openSeat && namedSeatIncluded(openSeat) && openSeat.purchasedAt !== void 0 ? openSeat : void 0);
     const prices = [String(member.providerPriceId), ...billedSeat ? [String(billedSeat.priceId)] : []].sort();
     const amount = Number(member.renewalAmountCents) + Number(billedSeat?.amountCents ?? 0);
     if (!Number.isSafeInteger(amount) || amount <= 0 || fact.invoiceTotalCents !== amount || JSON.stringify(lines.map((line) => line.priceId).sort()) !== JSON.stringify(prices)) membershipFail("membership_renewal_amount_mismatch");
@@ -4178,19 +4355,19 @@ async function reconcileMembershipRenewal(db, input, now) {
       evidenceGuard
     ];
     if (seat) guards.push({ ns: "networkSeat", id: String(seat.id), exists: true, equals: { revision: seat.revision } });
-    if (billedSeat?.entitlementId) {
-      const seatEntitlement = await membershipLoad(db, "networkEntitlement", String(billedSeat.entitlementId));
+    if (carriedSeat?.entitlementId) {
+      const seatEntitlement = await membershipLoad(db, "networkEntitlement", String(carriedSeat.entitlementId));
       requireMembershipScope(seatEntitlement, input);
       guards.push({ ns: "networkEntitlement", id: String(seatEntitlement.id), exists: true, equals: { revision: seatEntitlement.revision } });
       ops.push(
-        membershipUpdate("networkSeat", String(billedSeat.id), {
+        membershipUpdate("networkSeat", String(carriedSeat.id), {
           ...paid ? { termStartedAt: start, termEndsAt: end } : {},
-          revision: Number(billedSeat.revision) + 1,
+          revision: Number(carriedSeat.revision) + 1,
           updatedAt: now
         }),
         membershipUpdate("networkEntitlement", String(seatEntitlement.id), {
           ...paid ? { termStartedAt: start, termEndsAt: end } : {},
-          status: billedSeat.journeyApprovedAt ? entitlementStatus : seatEntitlement.status,
+          status: carriedSeat.journeyApprovedAt ? entitlementStatus : seatEntitlement.status,
           revision: Number(seatEntitlement.revision) + 1,
           updatedAt: now
         })
@@ -4442,84 +4619,6 @@ async function verifyMembershipAccessReceipt(value, input, now) {
   return { membershipId: row2.membershipId, allowed: row2.allowed, status: row2.status, accessEndsAt: row2.accessEndsAt, revision: row2.revision, ...row2.restartEligible === true && !row2.allowed ? { restartEligible: true } : {} };
 }
 
-// src/membership-seat-reservation.ts
-async function recipientKey(input, email) {
-  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([input.appId, input.chapterId, input.environment, input.runtime, email])));
-  return `seat-recipient:${[...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("")}`;
-}
-async function reserveNamedMembershipSeat(db, input, now) {
-  membershipClock(now);
-  const name = typeof input.recipientName === "string" ? input.recipientName.trim().replace(/\s+/g, " ") : "";
-  const email = normalizeChapterEmail(typeof input.recipientEmail === "string" ? input.recipientEmail : "");
-  const purchaser = normalizeChapterEmail(typeof input.purchaserEmail === "string" ? input.purchaserEmail : "");
-  if (name.length < 2 || name.length > 160 || /[\u0000-\u001f\u007f]/.test(input.recipientName) || email.length > 254 || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email) || !purchaser || email === purchaser || !/^price_[A-Za-z0-9_]+$/.test(input.priceId) || !/^user_[A-Za-z0-9_]+$/.test(input.purchaserUserId)) membershipFail("invalid_named_seat_recipient");
-  const state = await loadMembershipAuthorityState(db, input);
-  const memberId = await networkMembershipId(input), member = await membershipLoad(db, "networkMembership", memberId);
-  requireMembershipScope(member, input);
-  if (!Number.isSafeInteger(member.revision) || !/^price_[A-Za-z0-9_]+$/.test(String(member.providerPriceId)) || member.providerPriceId === input.priceId) membershipFail("named_seat_purchase_unavailable");
-  const id10 = (await membershipOfferIdForRequest({ ...input, requestId: "named_seat" })).replace(/^offer_/, "seat_");
-  let seat = await membershipLoad(db, "networkSeat", id10);
-  if (!seat) {
-    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 attrs = {
-      id: id10,
-      ...membershipScope(input),
-      primaryMembershipId: memberId,
-      recipientName: name,
-      recipientEmailNormalized: email,
-      purchaserUserId: input.purchaserUserId,
-      recipientClaimId: claimId,
-      priceId: input.priceId,
-      primaryPriceId: member.providerPriceId,
-      amountCents: offering.seatPriceCents,
-      currency: offering.currency,
-      interval: offering.interval,
-      providerCustomerId: member.providerCustomerId,
-      providerSubscriptionId: member.providerSubscriptionId,
-      status: "payment_pending",
-      preparedAt: now,
-      termEndsAt: member.termEndsAt,
-      seatPurchaseEndsAt: purchaseEndsAt,
-      offeringSnapshot: offering,
-      revision: 1,
-      createdAt: now,
-      updatedAt: now
-    };
-    try {
-      await db.transact([
-        membershipUpdate("networkSeat", id10, attrs),
-        membershipUpdate("networkSeatRecipient", claimId, {
-          id: claimId,
-          appId: input.appId,
-          chapterId: input.chapterId,
-          environment: input.environment,
-          runtime: input.runtime,
-          seatId: id10,
-          recipientEmailNormalized: email,
-          createdAt: now
-        }),
-        membershipUpdate("networkMembership", memberId, { namedSeatId: id10, revision: Number(member.revision) + 1, updatedAt: now })
-      ], { mutationId: `named-seat-reserve:${id10}`, guards: [
-        { ns: "networkSeat", id: id10, exists: false },
-        { ns: "networkSeatRecipient", id: claimId, exists: false },
-        { ns: "networkMembership", id: memberId, exists: true, equals: { revision: member.revision }, absent: ["namedSeatId"] },
-        { ns: "membershipAuthorityState", id: String(state.id), exists: true, equals: { mode: "authoritative", revision: state.revision } }
-      ] });
-    } catch (error) {
-      if (error.code !== "transact_guard_failed") throw error;
-    }
-    seat = await membershipLoad(db, "networkSeat", id10);
-    if (!seat && await membershipLoad(db, "networkSeatRecipient", claimId)) membershipFail("named_seat_recipient_unavailable");
-  }
-  requireMembershipScope(seat, input);
-  if (seat.primaryMembershipId !== memberId || seat.recipientName !== name || seat.recipientEmailNormalized !== email || seat.priceId !== input.priceId || seat.purchaserUserId !== input.purchaserUserId) membershipFail("named_seat_purchase_conflict");
-  return seat;
-}
-
 // src/membership-seat-stripe.ts
 import { stripeRequest as stripeRequest7 } from "@odla-ai/stripe";
 
@@ -4622,6 +4721,7 @@ async function attachNamedSeatStripeRenewal(sk, seat) {
 // src/membership-seat-checkout.ts
 async function prepareNamedMembershipSeatPayment(db, input, secretKey, now) {
   let seat = await reserveNamedMembershipSeat(db, input, now);
+  if (namedSeatIncluded(seat)) membershipFail("named_seat_included");
   const state = await loadMembershipAuthorityState(db, input);
   const member = await membershipLoad(db, "networkMembership", seat.primaryMembershipId);
   requireMembershipScope(member, input);
@@ -4828,7 +4928,7 @@ async function recordRecipient(db, input, now, approve) {
     requireMembershipScope(member, input);
     const entitlement = await membershipLoad(db, "networkEntitlement", String(seat.entitlementId));
     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 (!["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) || !namedSeatSettled(seat)) membershipFail("named_seat_acceptance_unavailable");
     if (seat.acceptedAt === void 0) {
       if (approve || normalizeChapterEmail(input.verifiedRecipientEmail) !== seat.recipientEmailNormalized) {
         membershipFail("named_seat_recipient_verification_required");
@@ -4943,7 +5043,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 === "primary_closed" && !["refunded", "declined"].includes(String(member.status))) membershipFail("named_seat_refund_not_eligible");
+  if (!seat.purchasedAt || !seat.providerPaymentIntentId && !namedSeatIncluded(seat) || 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 }),
@@ -4988,7 +5088,7 @@ async function completeNamedSeatRefund(db, seatId, secretKey, now) {
   await loadMembershipAuthorityState(db, seat);
   if (seat.status === "refunded") return;
   if (seat.status !== "refund_pending") membershipFail("named_seat_refund_not_ready");
-  const result = await refundNamedSeatStripePayment(secretKey, seat);
+  const result = namedSeatIncluded(seat) ? { refundedCents: 0, refundIds: [] } : await refundNamedSeatStripePayment(secretKey, seat);
   await db.transact([
     membershipUpdate("networkSeat", seatId, {
       status: "refunded",
@@ -5022,7 +5122,7 @@ async function refundNamedSeatByOperator(db, input, stripeSecretKey, now) {
   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) {
+  if (refunded?.status !== "refunded" || !Number.isSafeInteger(refunded.refundedCents) || Number(refunded.refundedCents) !== Number(seat.amountCents)) {
     throw new Error("named seat refund unconfirmed");
   }
   return { seatId: String(seat.id), status: "refunded", refundedCents: Number(refunded.refundedCents), subscriptionCanceled: false };
@@ -5044,6 +5144,7 @@ async function namedSeatOfferDigest(offer) {
   ])));
   return [...new Uint8Array(bytes)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
 }
+var at = (value) => Number.isSafeInteger(value) ? Number(value) : void 0;
 async function readNamedSeatOffer(db, input, now) {
   membershipClock(now);
   await loadMembershipAuthorityState(db, input);
@@ -5066,10 +5167,19 @@ async function readNamedSeatOffer(db, input, now) {
       seatId: String(seat.id),
       status: String(seat.status),
       recipientName: String(seat.recipientName),
-      recipientEmail: String(seat.recipientEmailNormalized)
+      recipientEmail: String(seat.recipientEmailNormalized),
+      recipientState: namedSeatRecipientState(seat),
+      ...at(seat.purchasedAt) !== void 0 ? { purchasedAt: at(seat.purchasedAt) } : {},
+      ...at(seat.acceptedAt) !== void 0 ? { acceptedAt: at(seat.acceptedAt) } : {},
+      ...seat.status === "active" && at(seat.journeyApprovedAt) !== void 0 ? { joinedAt: at(seat.journeyApprovedAt) } : {}
     } } : {}
   };
-  return { ...offer, digest: await namedSeatOfferDigest(offer), purchaseWindowed: offering.seatPurchaseWindowCalendarMonths !== void 0 };
+  return {
+    ...offer,
+    digest: await namedSeatOfferDigest(offer),
+    included: offering.seatPriceCents === 0,
+    purchaseWindowed: offering.seatPurchaseWindowCalendarMonths !== void 0
+  };
 }
 
 // src/membership-seat-invitation.ts
@@ -5195,6 +5305,15 @@ async function handleMembershipSeatAction(action, db, peer, input, now, stripeSe
   };
   if (action === "seat-accept") return acceptNamedSeatRecipient(db, recipientInput, now);
   if (action === "seat-approve") return approveNamedSeatRecipient(db, recipientInput, now);
+  const checkout = {
+    ...target,
+    priceId: peer.seatPriceId,
+    recipientName: String(input.recipientName),
+    recipientEmail: String(input.recipientEmail),
+    purchaserEmail: String(input.purchaserEmail),
+    purchaserUserId: String(input.purchaserUserId)
+  };
+  if (action === "seat-checkouts" && namedSeatIncluded(await reserveNamedMembershipSeat(db, checkout, now))) return grantIncludedNamedSeat(db, checkout, now);
   const secret = await getVaultSecret(db, stripeSecretName);
   if (!secret) throw new Error("network Stripe provider is unavailable");
   if (action === "seat-decline") {
@@ -5210,14 +5329,7 @@ async function handleMembershipSeatAction(action, db, peer, input, now, stripeSe
     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,
-    recipientName: String(input.recipientName),
-    recipientEmail: String(input.recipientEmail),
-    purchaserEmail: String(input.purchaserEmail),
-    purchaserUserId: String(input.purchaserUserId)
-  }, secret, now);
+  if (action === "seat-checkouts") return prepareNamedMembershipSeatPayment(db, checkout, secret, now);
   const evidence = { ...target, seatId: String(input.seatId), eventId: String(input.eventId) };
   if (action === "seat-payments") {
     const receipt = await confirmNamedMembershipSeatPayment(db, evidence, now);
@@ -5528,13 +5640,13 @@ async function requestNamedSeatDecline(options) {
     verifiedRecipientEmail: options.verifiedRecipientEmail
   });
   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");
+  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");
+  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) {
@@ -5548,13 +5660,13 @@ async function requestNamedSeatReservation(options) {
   });
   const seat = result.seat;
   const expected = (await membershipOfferIdForRequest({ ...options, requestId: "named_seat" })).replace(/^offer_/, "seat_");
-  if (!seat || seat.seatId !== expected || !Number.isSafeInteger(seat.amountCents) || seat.amountCents <= 0 || !/^[a-z]{3}$/.test(seat.currency) || !Number.isSafeInteger(seat.termEndsAt)) throw new Error("invalid seat reservation receipt");
+  if (!seat || seat.seatId !== expected || !Number.isSafeInteger(seat.amountCents) || seat.amountCents < 0 || !/^[a-z]{3}$/.test(seat.currency) || !Number.isSafeInteger(seat.termEndsAt)) throw new Error("invalid seat reservation receipt");
   return { seatId: seat.seatId, amountCents: seat.amountCents, currency: seat.currency, termEndsAt: seat.termEndsAt };
 }
 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.purchaseWindowed !== void 0 && typeof offer.purchaseWindowed !== "boolean" || 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 || offer.included !== (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) {
@@ -5590,7 +5702,8 @@ async function requestNamedSeatCheckout(options) {
   });
   const seat = result.seat;
   const expected = (await membershipOfferIdForRequest({ ...options, requestId: "named_seat" })).replace(/^offer_/, "seat_");
-  if (!seat || seat.seatId !== expected || !/^pi_[A-Za-z0-9_]+$/.test(seat.paymentIntentId) || typeof seat.clientSecret !== "string" || !Number.isSafeInteger(seat.amountCents) || seat.amountCents <= 0 || !/^[a-z]{3}$/.test(seat.currency) || !Number.isSafeInteger(seat.termEndsAt) || !["payment_processing", "renewal_pending", "pending_acceptance", "pending_approval", "active"].includes(seat.status)) {
+  const included = seat?.amountCents === 0;
+  if (!seat || seat.seatId !== expected || !Number.isSafeInteger(seat.amountCents) || seat.amountCents < 0 || !/^[a-z]{3}$/.test(seat.currency) || !Number.isSafeInteger(seat.termEndsAt) || (included ? seat.included !== true || seat.paymentIntentId !== void 0 || seat.clientSecret !== void 0 || !["pending_acceptance", "pending_approval", "pending_primary", "active"].includes(seat.status) : seat.included !== void 0 || !/^pi_[A-Za-z0-9_]+$/.test(String(seat.paymentIntentId)) || typeof seat.clientSecret !== "string" || !["payment_processing", "renewal_pending", "pending_acceptance", "pending_approval", "active"].includes(seat.status))) {
     throw new Error("invalid named seat checkout receipt");
   }
   return seat;