@odla-ai/chapter 0.58.0 → 0.59.0

package/dist/index.js

@@ -1560,7 +1560,9 @@ var DEFAULT_JOIN_COPY = {
     failed: "The booking could not be completed.",
     loading: "Loading available times\u2026",
     book: "Book this time",
-    booking: "Booking\u2026"
+    booking: "Booking\u2026",
+    pickDate: "Pick a date",
+    pickTime: "Pick a time"
   },
   payment: {
     setupFailed: "Payment could not be set up. Please try again.",
@@ -1712,8 +1714,8 @@ var APPLICATION_LABELS = {
   state: "State"
 };
 function humanize(id11) {
-  const text6 = id11.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
-  return text6 ? `${text6[0].toUpperCase()}${text6.slice(1)}` : id11;
+  const text7 = id11.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
+  return text7 ? `${text7[0].toUpperCase()}${text7.slice(1)}` : id11;
 }
 function applicationDefs(chapter) {
   try {
@@ -2512,6 +2514,7 @@ function normalizeNetworkCommercialStripeEvent(input, digest) {
   else if (eventType.startsWith("refund.")) objectKind = "refund";
   else if (eventType === "charge.refunded") objectKind = "refund";
   else if (eventType.startsWith("payment_intent.")) objectKind = "payment_intent";
+  else if (eventType.startsWith("charge.dispute.")) objectKind = "dispute";
   const customerId = refId(object2.customer, "cus_");
   const subscriptionId = objectKind === "subscription" ? providerId(objectId, "sub_") : subscriptionRef(object2);
   const invoiceId = objectKind === "invoice" ? providerId(objectId, "in_") : refId(object2.invoice, "in_");
@@ -2521,6 +2524,7 @@ function normalizeNetworkCommercialStripeEvent(input, digest) {
   const amountCents = integer(eventType === "charge.refunded" ? object2.amount_refunded : object2.amount);
   const currency = text(object2.currency)?.toLowerCase();
   const status2 = text(object2.status);
+  const disputeReason = objectKind === "dispute" ? text(object2.reason) : void 0;
   return {
     eventId,
     digest,
@@ -2539,6 +2543,7 @@ function normalizeNetworkCommercialStripeEvent(input, digest) {
     ...invoiceId ? { invoiceId } : {},
     ...chargeId ? { chargeId } : {},
     ...paymentIntentId ? { paymentIntentId } : {},
+    ...disputeReason ? { disputeReason } : {},
     ...price,
     ...objectKind === "subscription" && commercialSeatItems(object2) ? { seatSubscriptionItems: commercialSeatItems(object2) } : {},
     ...status2 ? { status: status2 } : {},
@@ -2581,6 +2586,7 @@ function ownRef(fact) {
   if (fact.objectKind === "subscription") return `subscription:${fact.objectId}`;
   if (fact.objectKind === "invoice") return `invoice:${fact.objectId}`;
   if (fact.objectKind === "payment_intent") return `payment_intent:${fact.objectId}`;
+  if (fact.objectKind === "dispute") return `dispute:${fact.objectId}`;
   if (fact.eventType.startsWith("refund.")) return `refund:${fact.objectId}`;
   return fact.eventType === "charge.refunded" ? `charge:${fact.objectId}` : null;
 }
@@ -2636,6 +2642,7 @@ function projectNetworkCommercialEvents(input, sources) {
       continue;
     }
     const source = assignments.get(fact.eventId);
+    if (!source && fact.objectKind === "dispute") continue;
     if (!source) {
       const direct = directSource(fact, sources);
       const keys2 = new Set(objectRefs(fact).flatMap((ref) => [...refs.get(ref) ?? []]));
@@ -2652,6 +2659,7 @@ function projectNetworkCommercialEvents(input, sources) {
   const subscriptions = rows3.filter((row2) => row2.objectKind === "subscription");
   const invoices = rows3.filter((row2) => row2.objectKind === "invoice");
   const seatPayments = rows3.filter((row2) => row2.objectKind === "payment_intent" && row2.seatId && row2.membershipId && !row2.invoiceId);
+  const disputes = rows3.filter((row2) => row2.objectKind === "dispute");
   const refunds = rows3.filter((row2) => row2.objectKind === "refund" && row2.eventType.startsWith("refund."));
   for (const charge of rows3.filter((row2) => row2.eventType === "charge.refunded")) {
     if (!refunds.some((refund) => refund.chargeId === charge.objectId)) {
@@ -2672,6 +2680,7 @@ function projectNetworkCommercialEvents(input, sources) {
   for (const row2 of refunds) add(row2, "refundedCents", row2.amountCents ?? 0);
   return {
     ...seatPayments.length ? { seatPayments, seats: projectCommercialSeats(seatPayments, subscriptions, refunds) } : {},
+    ...disputes.length ? { disputes } : {},
     customers,
     subscriptions,
     invoices,
@@ -4275,7 +4284,7 @@ async function refundNetworkMembership(db, input, secretKey, now) {
 }
 
 // src/membership-provider-lifecycle.ts
-import { stripeRequest as stripeRequest4 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest5 } from "@odla-ai/stripe";
 
 // src/membership-seat-reservation.ts
 async function namedSeatRecipientClaimId(input, email) {
@@ -4566,12 +4575,113 @@ async function reconcileMembershipRenewal(db, input, now) {
   return membershipFail("membership_renewal_retry_required");
 }
 
+// src/membership-dispute-authority.ts
+import { stripeRequest as stripeRequest4 } from "@odla-ai/stripe";
+var MEMBERSHIP_DISPUTED_STATUS = "payment_disputed";
+var DISPUTE_WON_STATUSES = ["won", "warning_closed"];
+var CLOSED_STATUSES = [...DISPUTE_WON_STATUSES, "lost"];
+var TERMINAL = ["refunded", "refund_pending", "canceled", "declined", "restarting", "superseded"];
+var text3 = (value) => typeof value === "string" && value ? value : void 0;
+var refOf = (value) => typeof value === "string" ? text3(value) : text3(value?.id);
+async function readDisputedCharge(secretKey, chargeId, fetch2) {
+  if (!/^ch_[A-Za-z0-9]+$/.test(chargeId)) membershipFail("invalid_dispute_charge");
+  const config = { secretKey, ...fetch2 ? { fetch: fetch2 } : {} };
+  const charge = await stripeRequest4(config, "GET", `/v1/charges/${chargeId}`);
+  if (!charge.ok || charge.body.id !== chargeId) membershipFail("membership_dispute_provider_unavailable");
+  const customerId = refOf(charge.body.customer), invoiceId = refOf(charge.body.invoice), paymentIntentId = refOf(charge.body.payment_intent);
+  if (!customerId) membershipFail("membership_dispute_provider_unavailable");
+  let subscriptionId;
+  if (invoiceId) {
+    const invoice = await stripeRequest4(config, "GET", `/v1/invoices/${invoiceId}`);
+    if (!invoice.ok || invoice.body.id !== invoiceId) membershipFail("membership_dispute_provider_unavailable");
+    subscriptionId = refOf(invoice.body.subscription) ?? refOf(invoice.body.parent?.subscription_details?.subscription);
+  }
+  const seatId = text3(charge.body.metadata?.seatId);
+  return {
+    chargeId,
+    customerId,
+    ...invoiceId ? { invoiceId } : {},
+    ...subscriptionId ? { subscriptionId } : {},
+    ...paymentIntentId ? { paymentIntentId } : {},
+    ...seatId ? { seatId } : {}
+  };
+}
+function disputedChargeCoversMembership(charge, member) {
+  return charge.customerId === member.providerCustomerId && !charge.seatId && (charge.invoiceId !== void 0 && charge.invoiceId === member.providerInitialInvoiceId || charge.subscriptionId !== void 0 && charge.subscriptionId === member.providerSubscriptionId || charge.paymentIntentId !== void 0 && charge.paymentIntentId === member.rechargePaymentIntentId);
+}
+async function reconcileMembershipDispute(db, input, now, secretKey, resolved) {
+  membershipClock(now);
+  const row2 = await membershipLoad(db, "networkCommercialEvents", `network-commercial-event:${input.eventId}`);
+  const fact = row2?.fact;
+  const evidenceGuard = await commercialEvidenceGuard(db, input.eventId, row2?.digest, "membership_billing_evidence_pending");
+  if (!fact || fact.objectKind !== "dispute" || fact.eventId !== input.eventId || fact.digest !== row2.digest || !fact.chargeId || !fact.objectId || fact.livemode !== (input.environment === "prod")) membershipFail("membership_billing_evidence_pending");
+  const id11 = await networkMembershipId(input);
+  const receipt = (value, applied = value.disputeEventId === input.eventId) => ({
+    membershipId: id11,
+    status: String(value.status),
+    termEndsAt: Number(value.termEndsAt),
+    graceEndsAt: Number(value.graceEndsAt ?? 0),
+    autoRenew: value.autoRenew === true,
+    ...text3(value.disputeStatus) ? { disputeStatus: text3(value.disputeStatus) } : {},
+    applied
+  });
+  const known = await membershipLoad(db, "networkMembership", id11);
+  requireMembershipScope(known, input);
+  if (known.disputeEventId === input.eventId) return receipt(known);
+  const charge = resolved && resolved.chargeId === fact.chargeId ? resolved : await readDisputedCharge(secretKey, fact.chargeId);
+  for (let attempt = 0; attempt < 8; attempt++) {
+    const state = await loadMembershipAuthorityState(db, input), member = await membershipLoad(db, "networkMembership", id11);
+    requireMembershipScope(member, input);
+    if (charge.customerId !== member.providerCustomerId) membershipFail("membership_dispute_scope_mismatch");
+    if (!disputedChargeCoversMembership(charge, member) || member.disputeEventId === input.eventId) return receipt(member);
+    const status2 = String(fact.status ?? "unknown"), closed = CLOSED_STATUSES.includes(status2);
+    const sameDispute = member.disputeId === fact.objectId;
+    if (sameDispute && Number(member.disputeClosedAt ?? 0) > 0 && !closed) return receipt(member, false);
+    const won = DISPUTE_WON_STATUSES.includes(status2);
+    const suspended = member.status === MEMBERSHIP_DISPUTED_STATUS, terminal = TERMINAL.includes(String(member.status));
+    const next = terminal ? String(member.status) : won ? suspended ? String(member.disputePriorStatus ?? (member.journeyApprovedAt ? "active" : "paid_pending_approval")) : String(member.status) : MEMBERSHIP_DISPUTED_STATUS;
+    const attrs = {
+      status: next,
+      disputeId: fact.objectId,
+      disputeStatus: status2,
+      disputeEventId: input.eventId,
+      disputeClosedAt: closed ? now : 0,
+      ...fact.disputeReason ? { disputeReason: fact.disputeReason } : {},
+      ...fact.amountCents !== void 0 ? { disputeAmountCents: fact.amountCents } : {},
+      ...sameDispute ? {} : { disputedAt: now },
+      ...next === MEMBERSHIP_DISPUTED_STATUS && !suspended ? { disputePriorStatus: String(member.status) } : {},
+      revision: Number(member.revision) + 1,
+      updatedAt: now
+    };
+    try {
+      await db.transact([membershipUpdate("networkMembership", id11, attrs)], { mutationId: `membership-dispute:${id11}:${input.eventId}`, guards: [
+        { ns: "networkMembership", id: id11, exists: true, equals: { revision: member.revision } },
+        { ns: "membershipAuthorityState", id: String(state.id), exists: true, equals: { mode: "authoritative", revision: state.revision } },
+        { ns: "networkCommercialEvents", id: String(row2.id), exists: true, equals: { digest: fact.digest } },
+        evidenceGuard
+      ] });
+    } catch (error) {
+      if (error.code !== "transact_guard_failed") throw error;
+      continue;
+    }
+    const saved = await membershipLoad(db, "networkMembership", id11);
+    requireMembershipScope(saved, input);
+    return receipt(saved, true);
+  }
+  return membershipFail("membership_dispute_retry_required");
+}
+
 // src/membership-provider-lifecycle.ts
 async function reconcileMembershipBilling(db, input, now, stripeSecretName = "stripe_secret_key") {
   membershipClock(now);
   const row2 = await membershipLoad(db, "networkCommercialEvents", `network-commercial-event:${input.eventId}`);
   const fact = row2?.fact;
   if (fact?.objectKind === "invoice") return reconcileMembershipRenewal(db, input, now);
+  if (fact?.objectKind === "dispute") {
+    const secret = await getVaultSecret(db, stripeSecretName);
+    if (!secret) membershipFail("membership_billing_provider_unavailable");
+    return reconcileMembershipDispute(db, input, now, secret);
+  }
   const evidenceGuard = await commercialEvidenceGuard(db, input.eventId, row2?.digest, "membership_billing_evidence_pending");
   if (!fact || fact.eventId !== input.eventId || fact.digest !== row2.digest || !/^[a-f0-9]{64}$/.test(fact.digest) || !["customer.subscription.updated", "customer.subscription.deleted", "charge.refunded"].includes(fact.eventType) || fact.livemode !== (input.environment === "prod") || fact.applicationId !== input.applicationId || !fact.identity || Object.entries({
     appId: input.appId,
@@ -4614,7 +4724,7 @@ async function reconcileMembershipBilling(db, input, now, stripeSecretName = "st
     }
     if (fact.subscriptionId !== member.providerSubscriptionId || fact.objectKind !== "subscription") membershipFail("membership_billing_scope_mismatch");
     if (["refund_pending", "refunded", "declined", "canceled", "restarting"].includes(String(member.status))) return receipt();
-    const result = await stripeRequest4({ secretKey: sk }, "GET", `/v1/subscriptions/${encodeURIComponent(String(member.providerSubscriptionId))}`);
+    const result = await stripeRequest5({ secretKey: sk }, "GET", `/v1/subscriptions/${encodeURIComponent(String(member.providerSubscriptionId))}`);
     const sub = result.body;
     if (!result.ok || sub.id !== member.providerSubscriptionId || sub.customer !== member.providerCustomerId || sub.livemode !== (input.environment === "prod") || typeof sub.cancel_at_period_end !== "boolean" || !["active", "trialing", "past_due", "unpaid", "canceled"].includes(sub.status) || !Object.entries({ ...stripePartitionMetadata(input), applicationId: input.applicationId }).every(([key3, value]) => sub.metadata?.[key3] === value)) {
       membershipFail("membership_billing_provider_mismatch");
@@ -4671,7 +4781,7 @@ async function expireRestartedMembershipSeat(db, target, member, now) {
 }
 
 // src/membership-restart-authority.ts
-import { stripeRequest as stripeRequest5 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest6 } from "@odla-ai/stripe";
 
 // src/stripe-event-digest.ts
 async function stripePayloadDigest(value) {
@@ -4686,14 +4796,14 @@ function membershipCanRestart(member, now) {
 }
 async function stopPreviousSubscription(member, target, secret) {
   const path = `/v1/subscriptions/${encodeURIComponent(String(member.providerSubscriptionId))}`;
-  const result = await stripeRequest5({ secretKey: secret }, "GET", path);
+  const result = await stripeRequest6({ secretKey: secret }, "GET", path);
   const sub = result.body;
   if (!result.ok || sub.id !== member.providerSubscriptionId || sub.customer !== member.providerCustomerId || sub.livemode !== (target.environment === "prod") || !Object.entries({
     ...stripePartitionMetadata(target),
     applicationId: target.applicationId
   }).every(([key3, value]) => sub.metadata?.[key3] === value)) membershipFail("membership_restart_provider_mismatch");
   if (sub.status === "canceled") return;
-  const canceled = await stripeRequest5(
+  const canceled = await stripeRequest6(
     { secretKey: secret },
     "DELETE",
     path,
@@ -4794,16 +4904,16 @@ async function verifyMembershipAccessReceipt(value, input, now) {
 }
 
 // src/membership-seat-stripe.ts
-import { stripeRequest as stripeRequest7 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest8 } from "@odla-ai/stripe";
 
 // src/subscription-provider-contract.ts
-import { stripeRequest as stripeRequest6 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest7 } from "@odla-ai/stripe";
 function subscriptionContractMismatch() {
   throw Object.assign(new Error("Stripe subscription does not match the checkout contract"), { code: "stripe_contract_mismatch" });
 }
 async function verifySubscriptionPrice(secretKey, input, resume = false) {
   if (!/^price_[A-Za-z0-9]+$/.test(input.priceId) || !Number.isSafeInteger(input.priceCents) || input.priceCents <= 0 || !/^[a-z]{3}$/.test(input.currency) || !["month", "year"].includes(input.interval)) subscriptionContractMismatch();
-  const result = await stripeRequest6({ secretKey }, "GET", `/v1/prices/${encodeURIComponent(input.priceId)}`);
+  const result = await stripeRequest7({ secretKey }, "GET", `/v1/prices/${encodeURIComponent(input.priceId)}`);
   const price = result.body;
   if (!result.ok || !price || price.id !== input.priceId || !resume && price.active !== true || price.unit_amount !== input.priceCents || price.currency !== input.currency || price.type !== "recurring" || price.billing_scheme !== "per_unit" || price.custom_unit_amount || price.transform_quantity || price.recurring?.interval !== input.interval || price.recurring?.interval_count !== 1 || price.recurring?.usage_type !== "licensed" || price.livemode !== (input.environment === "prod")) subscriptionContractMismatch();
   return typeof price.product === "string" ? price.product : void 0;
@@ -4821,7 +4931,7 @@ var metadataFor = (seat) => ({
 });
 var matches = (value, expected) => value && Object.entries(expected).every(([key3, item]) => value[key3] === item);
 async function read(sk, path, params) {
-  const response = await stripeRequest7({ secretKey: sk }, "GET", path, params);
+  const response = await stripeRequest8({ secretKey: sk }, "GET", path, params);
   if (!response.ok) return reject3();
   return response.body;
 }
@@ -4858,11 +4968,11 @@ async function createNamedSeatStripePayment(sk, seat, now) {
   }
   await subscriptionForSeat(sk, seat);
   const metadata = metadataFor(seat);
-  const result = seat.providerPaymentIntentId ? await stripeRequest7(
+  const result = seat.providerPaymentIntentId ? await stripeRequest8(
     { secretKey: sk },
     "GET",
     `/v1/payment_intents/${encodeURIComponent(seat.providerPaymentIntentId)}`
-  ) : await stripeRequest7({ secretKey: sk }, "POST", "/v1/payment_intents", {
+  ) : await stripeRequest8({ secretKey: sk }, "POST", "/v1/payment_intents", {
     amount: seat.amountCents,
     currency: seat.currency,
     customer: seat.providerCustomerId,
@@ -4884,7 +4994,7 @@ async function attachNamedSeatStripeRenewal(sk, seat) {
     return String(existing.id);
   }
   if (seat.combinedInvoice) reject3();
-  const result = await stripeRequest7({ secretKey: sk }, "POST", "/v1/subscription_items", {
+  const result = await stripeRequest8({ secretKey: sk }, "POST", "/v1/subscription_items", {
     subscription: seat.providerSubscriptionId,
     price: seat.priceId,
     quantity: 1,
@@ -5159,10 +5269,10 @@ async function recordRecipient(db, input, now, approve) {
 }
 
 // src/membership-seat-refund-stripe.ts
-import { stripeRequest as stripeRequest9 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest10 } from "@odla-ai/stripe";
 
 // src/membership-checkout-seat-refund.ts
-import { stripeRequest as stripeRequest8 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest9 } from "@odla-ai/stripe";
 var fail4 = (code = "named_seat_refund_mismatch") => {
   throw Object.assign(new Error(code), { code });
 };
@@ -5171,7 +5281,7 @@ async function refundCheckoutNamedSeat(secretKey, seat) {
   const invoiceRef = seat.combinedInvoice;
   if (!invoiceRef || !/^in_[A-Za-z0-9_]+$/.test(invoiceRef.invoiceId) || !Number.isSafeInteger(invoiceRef.totalCents) || invoiceRef.totalCents <= seat.amountCents || seat.amountCents <= 0 || seat.status !== "refund_pending") fail4();
   const call = async (method, path, params, key3) => {
-    const result = await stripeRequest8({ secretKey }, method, path, params, key3 ? { idempotencyKey: key3 } : {});
+    const result = await stripeRequest9({ secretKey }, method, path, params, key3 ? { idempotencyKey: key3 } : {});
     if (!result.ok || !result.body) return fail4("named_seat_refund_provider_unavailable");
     return result.body;
   };
@@ -5244,7 +5354,7 @@ async function refundNamedSeatStripePayment(secretKey, seat) {
   if (seat.combinedInvoice) return refundCheckoutNamedSeat(secretKey, seat);
   if (!seat.providerPaymentIntentId || seat.status !== "refund_pending") fail5();
   const call = async (method, path, params, idempotencyKey) => {
-    const result = await stripeRequest9({ secretKey }, method, path, params, idempotencyKey ? { idempotencyKey } : {});
+    const result = await stripeRequest10({ secretKey }, method, path, params, idempotencyKey ? { idempotencyKey } : {});
     if (!result.ok || !result.body) return fail5("named_seat_refund_provider_unavailable");
     return result.body;
   };
@@ -5946,7 +6056,7 @@ async function readBoundedJson(response, signal, maxBytes, label) {
   };
   signal.addEventListener("abort", cancel, { once: true });
   let size = 0;
-  let text6 = "";
+  let text7 = "";
   const decoder = new TextDecoder();
   try {
     while (true) {
@@ -5956,10 +6066,10 @@ async function readBoundedJson(response, signal, maxBytes, label) {
       if (done) break;
       size += value.byteLength;
       if (size > maxBytes) throw new TypeError(`${label} exceeds limit`);
-      text6 += decoder.decode(value, { stream: true });
+      text7 += decoder.decode(value, { stream: true });
     }
     try {
-      return JSON.parse(text6 + decoder.decode());
+      return JSON.parse(text7 + decoder.decode());
     } catch {
       throw new TypeError(`invalid ${label}`);
     }
@@ -6173,7 +6283,7 @@ async function requestMembershipRefund(options) {
 async function requestMembershipRenewal(options) {
   const result = await requestAuthority(options, "renewals", { applicationId: options.applicationId, skuId: options.skuId, eventId: options.eventId });
   const row2 = result.renewal;
-  if (!row2 || row2.membershipId !== await networkMembershipId(options) || !Number.isSafeInteger(row2.termEndsAt) || row2.termEndsAt <= 0 || !Number.isSafeInteger(row2.graceEndsAt) || row2.graceEndsAt < 0 || typeof row2.autoRenew !== "boolean" || !["active", "paid_pending_approval", "cancel_at_term_end", "payment_grace", "lapsed", "refund_pending", "refunded", "canceled", "declined", "restarting"].includes(row2.status)) {
+  if (!row2 || row2.membershipId !== await networkMembershipId(options) || !Number.isSafeInteger(row2.termEndsAt) || row2.termEndsAt <= 0 || !Number.isSafeInteger(row2.graceEndsAt) || row2.graceEndsAt < 0 || typeof row2.autoRenew !== "boolean" || !["active", "paid_pending_approval", "cancel_at_term_end", "payment_grace", "lapsed", "refund_pending", "refunded", "canceled", "declined", "restarting", "payment_disputed"].includes(row2.status)) {
     throw new Error("invalid membership renewal receipt");
   }
   return { membershipId: row2.membershipId, status: row2.status, termEndsAt: row2.termEndsAt, graceEndsAt: row2.graceEndsAt, autoRenew: row2.autoRenew };
@@ -6233,7 +6343,7 @@ async function requestMembershipCancellation(options) {
 }
 
 // src/membership-seat-cancel.ts
-import { initStripe, stripeRequest as stripeRequest10 } from "@odla-ai/stripe";
+import { initStripe, stripeRequest as stripeRequest11 } from "@odla-ai/stripe";
 async function cancelUnpaidNamedSeat(db, target, secretKey, now) {
   membershipClock(now);
   const state = await loadMembershipAuthorityState(db, target);
@@ -6261,7 +6371,7 @@ async function cancelUnpaidNamedSeat(db, target, secretKey, now) {
   }
   const metadata = { ...stripePartitionMetadata(target), applicationId: target.applicationId, membershipId: seat.primaryMembershipId, seatId: seat.id };
   const request = async (method, path, params) => {
-    const result = await stripeRequest10(
+    const result = await stripeRequest11(
       { secretKey },
       method,
       path,
@@ -6485,7 +6595,20 @@ var membershipAuthorityEntities = {
     graceEndsAt: attr9("number", true),
     ...times(),
     refundRequestedAt: attr9("number", true),
-    restartId: key2(true)
+    restartId: key2(true),
+    // A card-network dispute on this membership's payment: Stripe's dispute id and status, the reason the cardholder gave,
+    // the status the membership held before it was suspended, and the re-issued charge once an operator collected again.
+    disputeId: key2(true),
+    disputeStatus: attr9("string", true),
+    disputeReason: attr9("string", true),
+    disputeAmountCents: attr9("number", true),
+    disputedAt: attr9("number", true),
+    disputeClosedAt: attr9("number", true),
+    disputePriorStatus: attr9("string", true),
+    disputeEventId: key2(true),
+    rechargePaymentIntentId: key2(true),
+    rechargedAt: attr9("number", true),
+    rechargeAttempt: attr9("json", true)
   } },
   membershipRestart: { attrs: {
     id: id10(),
@@ -6921,7 +7044,7 @@ var record2 = (value) => value !== null && typeof value === "object" && !Array.i
 function unknownKeys2(value, allowed2, path, errors) {
   for (const key3 of Object.keys(value)) if (!allowed2.has(key3)) errors.push(`${path}.${key3} is not supported`);
 }
-function text3(value, path, errors, max = MAX_TEXT2, required = true) {
+function text4(value, path, errors, max = MAX_TEXT2, required = true) {
   if (value === void 0 && !required) return void 0;
   if (typeof value !== "string" || required && !value.trim()) {
     errors.push(`${path} must be a non-empty string`);
@@ -6947,7 +7070,7 @@ function scopeValue(value, path, errors) {
     return { kind: raw2.kind };
   }
   if (raw2.kind === "chapter") {
-    const chapterId = text3(raw2.chapterId, `${path}.chapterId`, errors, 63) ?? "";
+    const chapterId = text4(raw2.chapterId, `${path}.chapterId`, errors, 63) ?? "";
     if (chapterId && !APP_ID.test(chapterId)) errors.push(`${path}.chapterId must be a lowercase app slug`);
     return { kind: "chapter", chapterId };
   }
@@ -6961,22 +7084,22 @@ function resourceValue(value, path, errors) {
     return null;
   }
   unknownKeys2(raw2, RESOURCE_KEYS, path, errors);
-  const id11 = text3(raw2.id, `${path}.id`, errors, 80) ?? "";
+  const id11 = text4(raw2.id, `${path}.id`, errors, 80) ?? "";
   if (id11 && !ID2.test(id11)) errors.push(`${path}.id must be lowercase kebab-case`);
-  const kind = text3(raw2.kind, `${path}.kind`, errors) ?? "";
+  const kind = text4(raw2.kind, `${path}.kind`, errors) ?? "";
   if (!KINDS.has(kind)) errors.push(`${path}.kind is unsupported`);
-  const title = text3(raw2.title, `${path}.title`, errors, 240) ?? "";
-  const summary = text3(raw2.summary, `${path}.summary`, errors, 1e3, false);
-  const status2 = text3(raw2.status, `${path}.status`, errors) ?? "";
+  const title = text4(raw2.title, `${path}.title`, errors, 240) ?? "";
+  const summary = text4(raw2.summary, `${path}.summary`, errors, 1e3, false);
+  const status2 = text4(raw2.status, `${path}.status`, errors) ?? "";
   if (!STATUSES.has(status2)) errors.push(`${path}.status must be draft, published, or archived`);
   const revision = integer3(raw2.revision, `${path}.revision`, errors);
   const scope2 = scopeValue(raw2.scope, `${path}.scope`, errors) ?? { kind: "global" };
-  const tags = Array.isArray(raw2.tags) ? raw2.tags.map((tag, index2) => text3(tag, `${path}.tags[${index2}]`, errors, 80) ?? "") : [];
+  const tags = Array.isArray(raw2.tags) ? raw2.tags.map((tag, index2) => text4(tag, `${path}.tags[${index2}]`, errors, 80) ?? "") : [];
   if (!Array.isArray(raw2.tags)) errors.push(`${path}.tags must be an array`);
   if (tags.length > MAX_TAGS) errors.push(`${path}.tags may contain at most ${MAX_TAGS} items`);
   if (new Set(tags).size !== tags.length) errors.push(`${path}.tags must be unique`);
-  const bodyMarkdown = text3(raw2.bodyMarkdown, `${path}.bodyMarkdown`, errors, MAX_MARKDOWN2, false);
-  const url = text3(raw2.url, `${path}.url`, errors, 2048, false);
+  const bodyMarkdown = text4(raw2.bodyMarkdown, `${path}.bodyMarkdown`, errors, MAX_MARKDOWN2, false);
+  const url = text4(raw2.url, `${path}.url`, errors, 2048, false);
   if (url) {
     try {
       if (new URL(url).protocol !== "https:") errors.push(`${path}.url must use https`);
@@ -6988,9 +7111,9 @@ function resourceValue(value, path, errors) {
   if (raw2.brandAsset !== void 0 && !asset) errors.push(`${path}.brandAsset must be an object`);
   if (asset) unknownKeys2(asset, ASSET_KEYS, `${path}.brandAsset`, errors);
   const brandAsset = asset ? {
-    bookId: text3(asset.bookId, `${path}.brandAsset.bookId`, errors, 160) ?? "",
-    assetId: text3(asset.assetId, `${path}.brandAsset.assetId`, errors, 160) ?? "",
-    ...asset.filename === void 0 ? {} : { filename: text3(asset.filename, `${path}.brandAsset.filename`, errors, 240) ?? "" }
+    bookId: text4(asset.bookId, `${path}.brandAsset.bookId`, errors, 160) ?? "",
+    assetId: text4(asset.assetId, `${path}.brandAsset.assetId`, errors, 160) ?? "",
+    ...asset.filename === void 0 ? {} : { filename: text4(asset.filename, `${path}.brandAsset.filename`, errors, 240) ?? "" }
   } : void 0;
   if ((kind === "document" || kind === "note") && !bodyMarkdown) errors.push(`${path}.bodyMarkdown is required for ${kind}`);
   if ((kind === "link" || kind === "inspiration") && !url) errors.push(`${path}.url is required for ${kind}`);
@@ -7005,17 +7128,17 @@ function resourceValue(value, path, errors) {
   if (provenanceRaw?.promotedFrom !== void 0 && !promotedRaw) errors.push(`${path}.provenance.promotedFrom must be an object`);
   if (promotedRaw) unknownKeys2(promotedRaw, PROMOTION_KEYS, `${path}.provenance.promotedFrom`, errors);
   const promotedFrom = promotedRaw ? {
-    chapterId: text3(promotedRaw.chapterId, `${path}.provenance.promotedFrom.chapterId`, errors, 63) ?? "",
-    resourceId: text3(promotedRaw.resourceId, `${path}.provenance.promotedFrom.resourceId`, errors, 80) ?? "",
+    chapterId: text4(promotedRaw.chapterId, `${path}.provenance.promotedFrom.chapterId`, errors, 63) ?? "",
+    resourceId: text4(promotedRaw.resourceId, `${path}.provenance.promotedFrom.resourceId`, errors, 80) ?? "",
     resourceRevision: integer3(promotedRaw.resourceRevision, `${path}.provenance.promotedFrom.resourceRevision`, errors),
     documentRevision: integer3(promotedRaw.documentRevision, `${path}.provenance.promotedFrom.documentRevision`, errors),
-    promotedBy: text3(promotedRaw.promotedBy, `${path}.provenance.promotedFrom.promotedBy`, errors, 320) ?? "",
+    promotedBy: text4(promotedRaw.promotedBy, `${path}.provenance.promotedFrom.promotedBy`, errors, 320) ?? "",
     promotedAt: integer3(promotedRaw.promotedAt, `${path}.provenance.promotedFrom.promotedAt`, errors, 0)
   } : void 0;
   const provenance = {
-    createdBy: text3(provenanceRaw?.createdBy, `${path}.provenance.createdBy`, errors, 320) ?? "",
+    createdBy: text4(provenanceRaw?.createdBy, `${path}.provenance.createdBy`, errors, 320) ?? "",
     createdAt: integer3(provenanceRaw?.createdAt, `${path}.provenance.createdAt`, errors, 0),
-    updatedBy: text3(provenanceRaw?.updatedBy, `${path}.provenance.updatedBy`, errors, 320) ?? "",
+    updatedBy: text4(provenanceRaw?.updatedBy, `${path}.provenance.updatedBy`, errors, 320) ?? "",
     updatedAt: integer3(provenanceRaw?.updatedAt, `${path}.provenance.updatedAt`, errors, 0),
     ...promotedFrom ? { promotedFrom } : {}
   };
@@ -7034,7 +7157,7 @@ function validateBuilderLibraryDocument(value, options = {}) {
   if (sourceRaw) unknownKeys2(sourceRaw, SOURCE_KEYS2, "document.source", errors);
   const sourceType = sourceRaw?.type;
   if (sourceType !== "chapter" && sourceType !== "built_not_found") errors.push("document.source.type must be chapter or built_not_found");
-  const sourceAppId = text3(sourceRaw?.appId, "document.source.appId", errors, 63) ?? "";
+  const sourceAppId = text4(sourceRaw?.appId, "document.source.appId", errors, 63) ?? "";
   if (sourceAppId && !APP_ID.test(sourceAppId)) errors.push("document.source.appId must be a lowercase app slug");
   if (options.sourceType && sourceType !== options.sourceType) errors.push(`document.source.type must be ${options.sourceType}`);
   if (options.sourceAppId && sourceAppId !== options.sourceAppId) errors.push(`document.source.appId must be ${options.sourceAppId}`);
@@ -7042,8 +7165,8 @@ function validateBuilderLibraryDocument(value, options = {}) {
   if (raw2.target !== void 0 && !targetRaw) errors.push("document.target must be an object");
   if (targetRaw) unknownKeys2(targetRaw, TARGET_KEYS2, "document.target", errors);
   const target = targetRaw ? {
-    appId: text3(targetRaw.appId, "document.target.appId", errors, 63) ?? "",
-    environment: text3(targetRaw.environment, "document.target.environment", errors, 80) ?? ""
+    appId: text4(targetRaw.appId, "document.target.appId", errors, 63) ?? "",
+    environment: text4(targetRaw.environment, "document.target.environment", errors, 80) ?? ""
   } : void 0;
   if (options.targetAppId && target?.appId !== options.targetAppId) errors.push(`document.target.appId must be ${options.targetAppId}`);
   if (!Array.isArray(raw2.resources)) errors.push("document.resources must be an array");
@@ -7138,9 +7261,9 @@ async function createBuilderLibraryEnvelope(document) {
 }
 
 // src/email-retirement.ts
-function isRetiredEmailCopy(subject, text6) {
+function isRetiredEmailCopy(subject, text7) {
   const subjectCopy = subject.trimStart().replace(/^\[dev\]\s*/i, "");
-  const bodyCopy = text6.trimStart().replace(/^\(dev redirect; original recipient: [^\r\n]*\)\r?\n\r?\n/, "");
+  const bodyCopy = text7.trimStart().replace(/^\(dev redirect; original recipient: [^\r\n]*\)\r?\n\r?\n/, "");
   return /^\(\s*unused\s*:/i.test(subjectCopy) || /^Unused\.\s*Switched off\b/i.test(bodyCopy);
 }
 
@@ -7218,10 +7341,10 @@ function planDelivery(input) {
   if (isRetiredEmailCopy(renderedSubject, renderedText)) return { deliver: false, reason: "template-retired" };
   if (validateEmailCopy({ subject: renderedSubject, text: renderedText }, { allowedVariables: [] }).length) return { deliver: false, reason: "template-invalid" };
   const subject = (redirect ? "[dev] " : "") + renderedSubject;
-  const text6 = redirect ? `(dev redirect; original recipient: ${input.to})
+  const text7 = redirect ? `(dev redirect; original recipient: ${input.to})
 
 ` + renderedText : renderedText;
-  return { deliver: true, transport, to, subject, text: text6, redirected: redirect };
+  return { deliver: true, transport, to, subject, text: text7, redirected: redirect };
 }
 
 // src/email-readiness.ts
@@ -7556,6 +7679,17 @@ function findGiftRef(obj) {
 }
 function normalizeWebhookEvent(event2, options = {}) {
   const obj = event2.data?.object ?? {};
+  if (event2.type.startsWith("charge.dispute.")) {
+    const chargeId = typeof obj.charge === "string" ? obj.charge : String(obj.charge?.id ?? "");
+    if (!/^ch_[A-Za-z0-9]+$/.test(chargeId) || typeof obj.id !== "string" || !obj.id) return { kind: "ignored", type: event2.type };
+    return {
+      kind: "disputed",
+      chargeId,
+      disputeId: obj.id,
+      disputeStatus: typeof obj.status === "string" ? obj.status : "unknown",
+      ...typeof obj.payment_intent === "string" ? { paymentIntentId: obj.payment_intent } : {}
+    };
+  }
   if (event2.type === "charge.refunded" && (!Number.isSafeInteger(obj.amount) || Number(obj.amount) <= 0 || obj.amount_refunded !== obj.amount || obj.refunded !== true)) return { kind: "ignored", type: event2.type };
   const gift = findGiftRef(obj);
   if (gift.giftIntentId) {
@@ -7866,7 +8000,7 @@ var ID4 = /^[a-z][a-z0-9-]{1,79}$/;
 var PRICE = /^price_[A-Za-z0-9]{12,}$/;
 var CURRENCY = /^[a-z]{3}$/;
 var record3 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
-var text4 = (value, path, errors, max) => {
+var text5 = (value, path, errors, max) => {
   if (typeof value !== "string" || !value.trim()) {
     errors.push(`${path} is required`);
     return "";
@@ -7894,23 +8028,23 @@ function validateGiftOfferCatalog(input, tierIds) {
     }
     const allowed2 = /* @__PURE__ */ new Set(["id", "target", "billingMode", "stripePriceId", "priceCents", "currency", "redemptionLifetimeHours", "activeFrom", "activeUntil", "title", "description", "ctaLabel"]);
     for (const key3 of Object.keys(item)) if (!allowed2.has(key3)) errors.push(`${path}.${key3} is not supported`);
-    const id11 = text4(item.id, `${path}.id`, errors, 80);
+    const id11 = text5(item.id, `${path}.id`, errors, 80);
     if (id11 && !ID4.test(id11)) errors.push(`${path}.id must be a lowercase kebab-case id`);
     if (ids2.has(id11)) errors.push(`${path}.id duplicates "${id11}"`);
     ids2.add(id11);
     const targetRaw = record3(item.target);
     let target = { type: "entitlement", entitlementKey: "invalid" };
     if (targetRaw?.type === "tier") {
-      const tierId = text4(targetRaw.tierId, `${path}.target.tierId`, errors, 80);
+      const tierId = text5(targetRaw.tierId, `${path}.target.tierId`, errors, 80);
       if (!tierIds.has(tierId)) errors.push(`${path}.target.tierId must reference a declared tier`);
       target = { type: "tier", tierId };
     } else if (targetRaw?.type === "entitlement") {
-      const entitlementKey = text4(targetRaw.entitlementKey, `${path}.target.entitlementKey`, errors, 80);
+      const entitlementKey = text5(targetRaw.entitlementKey, `${path}.target.entitlementKey`, errors, 80);
       if (entitlementKey && !ID4.test(entitlementKey)) errors.push(`${path}.target.entitlementKey must be a lowercase kebab-case id`);
       target = { type: "entitlement", entitlementKey };
     } else errors.push(`${path}.target.type must be tier or entitlement`);
     if (item.billingMode !== "one_time" && item.billingMode !== "subscription") errors.push(`${path}.billingMode must be one_time or subscription`);
-    const stripePriceId = text4(item.stripePriceId, `${path}.stripePriceId`, errors, 128);
+    const stripePriceId = text5(item.stripePriceId, `${path}.stripePriceId`, errors, 128);
     if (stripePriceId && !PRICE.test(stripePriceId)) errors.push(`${path}.stripePriceId must be a real Stripe Price id`);
     if (!Number.isSafeInteger(item.priceCents) || Number(item.priceCents) < 1 || Number(item.priceCents) > 1e8) errors.push(`${path}.priceCents must be an integer from 1 to 100,000,000`);
     const currency = typeof item.currency === "string" ? item.currency.trim().toLowerCase() : "";
@@ -7932,9 +8066,9 @@ function validateGiftOfferCatalog(input, tierIds) {
       redemptionLifetimeHours: lifetime,
       ...activeFrom !== void 0 ? { activeFrom } : {},
       ...activeUntil !== void 0 ? { activeUntil } : {},
-      title: text4(item.title, `${path}.title`, errors, 160),
-      description: text4(item.description, `${path}.description`, errors, 2e3),
-      ctaLabel: text4(item.ctaLabel, `${path}.ctaLabel`, errors, 120)
+      title: text5(item.title, `${path}.title`, errors, 160),
+      description: text5(item.description, `${path}.description`, errors, 2e3),
+      ctaLabel: text5(item.ctaLabel, `${path}.ctaLabel`, errors, 120)
     });
   }
   return errors.length ? { ok: false, errors } : { ok: true, value: { schemaVersion: 1, offers } };
@@ -8398,9 +8532,9 @@ function subAnnualCents(sub) {
 }
 
 // src/payments-stripe.ts
-import { stripeRequest as stripeRequest11, verifyStripeSignature as verifyStripeSignature2 } from "@odla-ai/stripe";
+import { stripeRequest as stripeRequest12, verifyStripeSignature as verifyStripeSignature2 } from "@odla-ai/stripe";
 async function stripeCall(sk, method, path, params, idempotencyKey) {
-  return stripeRequest11(
+  return stripeRequest12(
     { secretKey: sk },
     method,
     path,
@@ -9022,10 +9156,10 @@ function boundedString(value, path, errors, max, required = false) {
     errors.push(`${path} must be a string`);
     return void 0;
   }
-  const text6 = value.trim();
-  if (required && !text6) errors.push(`${path} is required`);
-  if (text6.length > max) errors.push(`${path} must be at most ${max.toLocaleString("en-US")} characters`);
-  return text6;
+  const text7 = value.trim();
+  if (required && !text7) errors.push(`${path} is required`);
+  if (text7.length > max) errors.push(`${path} must be at most ${max.toLocaleString("en-US")} characters`);
+  return text7;
 }
 function validateMembershipPageDocument(input, options = {}) {
   const errors = [];
@@ -9074,8 +9208,8 @@ function validateMembershipPageDocument(input, options = {}) {
       else {
         if (item.benefits.length > MAX_BENEFITS) errors.push(`${path}.benefits supports at most ${MAX_BENEFITS} entries`);
         benefits = item.benefits.slice(0, MAX_BENEFITS).flatMap((benefit, benefitIndex) => {
-          const text6 = boundedString(benefit, `${path}.benefits[${benefitIndex}]`, errors, 2e3, true);
-          return text6 ? [text6] : [];
+          const text7 = boundedString(benefit, `${path}.benefits[${benefitIndex}]`, errors, 2e3, true);
+          return text7 ? [text7] : [];
         });
       }
     }
@@ -9174,7 +9308,7 @@ var recordOf = (value) => value !== null && typeof value === "object" && !Array.
 function unknownKeys3(value, allowed2, path, errors) {
   for (const key3 of Object.keys(value)) if (!allowed2.has(key3)) errors.push(`${path}.${key3} is not supported`);
 }
-function text5(value, path, errors, max = 65536) {
+function text6(value, path, errors, max = 65536) {
   if (typeof value !== "string" || !value.trim()) {
     errors.push(`${path} is required`);
     return "";
@@ -9197,11 +9331,11 @@ function tiersOf(value, errors) {
       return [];
     }
     unknownKeys3(item, TIER_KEYS2, path, errors);
-    const id11 = text5(item.id, `${path}.id`, errors, 80);
+    const id11 = text6(item.id, `${path}.id`, errors, 80);
     if (id11 && !TIER.test(id11)) errors.push(`${path}.id must be a lowercase kebab-case id`);
     if (seen.has(id11)) errors.push(`${path}.id duplicates "${id11}"`);
     seen.add(id11);
-    const name = text5(item.name, `${path}.name`, errors, 160);
+    const name = text6(item.name, `${path}.name`, errors, 160);
     if (typeof item.available !== "boolean") errors.push(`${path}.available must be boolean`);
     if (!Number.isInteger(item.sortOrder) || Number(item.sortOrder) < 0) errors.push(`${path}.sortOrder must be a non-negative integer`);
     if (!Number.isInteger(item.priceCents) || Number(item.priceCents) < 0 || Number(item.priceCents) > 1e8) {
@@ -9219,7 +9353,7 @@ function tiersOf(value, errors) {
     if (item.interval !== void 0 && item.interval !== "year" && item.interval !== "month") {
       errors.push(`${path}.interval must be year or month`);
     }
-    const blurb = item.blurb === void 0 ? void 0 : text5(item.blurb, `${path}.blurb`, errors, 4e3);
+    const blurb = item.blurb === void 0 ? void 0 : text6(item.blurb, `${path}.blurb`, errors, 4e3);
     return [{
       id: id11,
       name,
@@ -9277,7 +9411,7 @@ function policyOf(value, errors, tiers2) {
   const result = {};
   for (const key3 of allowed2) {
     if (input[key3] === void 0 && key3 !== "disclaimerText" && key3 !== "refundPolicyText") continue;
-    result[key3] = text5(input[key3], `document.policy.${key3}`, errors);
+    result[key3] = text6(input[key3], `document.policy.${key3}`, errors);
   }
   const tierPolicies = {};
   if (input.tierPolicies !== void 0) {
@@ -9292,8 +9426,8 @@ function policyOf(value, errors, tiers2) {
       }
       unknownKeys3(policy2, /* @__PURE__ */ new Set(["refundPolicyText", "trustCopy"]), path, errors);
       tierPolicies[id11] = {
-        refundPolicyText: text5(policy2.refundPolicyText, `${path}.refundPolicyText`, errors),
-        ...policy2.trustCopy !== void 0 ? { trustCopy: text5(policy2.trustCopy, `${path}.trustCopy`, errors) } : {}
+        refundPolicyText: text6(policy2.refundPolicyText, `${path}.refundPolicyText`, errors),
+        ...policy2.trustCopy !== void 0 ? { trustCopy: text6(policy2.trustCopy, `${path}.trustCopy`, errors) } : {}
       };
     }
   }
@@ -9333,9 +9467,9 @@ function validateSignupControlDocument(input) {
   if (!Number.isSafeInteger(root.generatedAt) || Number(root.generatedAt) < 1) errors.push("document.generatedAt must be epoch milliseconds");
   const source = recordOf(root.source);
   const target = recordOf(root.target);
-  const appId = text5(source?.appId, "document.source.appId", errors, 63);
-  const chapterId = text5(target?.chapterId, "document.target.chapterId", errors, 63);
-  const environment = text5(target?.environment, "document.target.environment", errors, 63);
+  const appId = text6(source?.appId, "document.source.appId", errors, 63);
+  const chapterId = text6(target?.chapterId, "document.target.chapterId", errors, 63);
+  const environment = text6(target?.environment, "document.target.environment", errors, 63);
   if (appId && !SLUG9.test(appId)) errors.push("document.source.appId must be a lowercase app slug");
   if (chapterId && !SLUG9.test(chapterId)) errors.push("document.target.chapterId must be a lowercase app slug");
   if (environment && !ENVIRONMENT.test(environment)) errors.push("document.target.environment is invalid");
@@ -9512,9 +9646,9 @@ function markdownBenefits(lines, path, errors) {
       errors.push(`${path} line ${index2 + 1} must be a Markdown bullet`);
       continue;
     }
-    const text6 = (match[1] ?? "").trim();
-    if (text6.length > 2e3) errors.push(`${path} line ${index2 + 1} must be at most 2,000 characters`);
-    if (text6) benefits.push(text6);
+    const text7 = (match[1] ?? "").trim();
+    if (text7.length > 2e3) errors.push(`${path} line ${index2 + 1} must be at most 2,000 characters`);
+    if (text7) benefits.push(text7);
   }
   if (benefits.length > MAX_BENEFITS2) errors.push(`${path} supports at most ${MAX_BENEFITS2} entries`);
   return benefits.slice(0, MAX_BENEFITS2);