@odla-ai/chapter 0.58.1 → 0.59.1

package/dist/worker/index.d.cts

@@ -1,6 +1,11 @@
 import { CrmConfig, Crm, FieldConditions } from '@odla-ai/crm';
 import { initAdmin } from '@odla-ai/db';
 
+/** The part of a Workers ExecutionContext a chapter route needs: let work outlive the response. */
+interface ExecutionLike {
+    waitUntil(promise: Promise<unknown>): void;
+}
+
 /** One membership tier a chapter offers. `priceCents: 0` means free. */
 interface ChapterTier {
     /** Stable slug, referenced by `applications.tierId`. Never renumbered. */
@@ -83,6 +88,10 @@ interface ChapterCopy {
         booking: TextFields<"unavailable" | "loadFailed" | "slotTaken" | "failed" | "loading" | "book" | "booking"> & {
             title?: string;
             intro?: string;
+            /** Shown under the booking button until a date is chosen. */
+            pickDate?: string;
+            /** Shown under the booking button once a date is chosen, until a time is. */
+            pickTime?: string;
         };
         /**
          * `consent` is the affirmative statement a member agrees to before the card
@@ -1082,7 +1091,7 @@ declare const namedSeatIncluded: (seat: {
     amountCents?: unknown;
 }) => boolean;
 /** Where the named recipient stands, from the purchaser's side, folded from the seat's lifecycle status. */
-type NamedSeatRecipientState = "payment_pending" | "invited" | "accepted" | "joined" | "declined" | "refunded" | "canceled";
+type NamedSeatRecipientState = "payment_pending" | "invited" | "accepted" | "joined" | "declined" | "refunded" | "canceled" | "disputed";
 /** Fold the seat status machine into the words a members page needs: whether the person was invited, accepted, joined or left. */
 declare function namedSeatRecipientState(seat: {
     status?: unknown;
@@ -1278,6 +1287,71 @@ type NamedSeatEvidenceRequest = MembershipQuoteTarget & {
     eventId: string;
 };
 
+/** Stripe metadata fields used to bind one fact to an exact configured source. */
+interface CommercialIdentity {
+    appId?: string;
+    chapterId?: string;
+    environment?: string;
+    dataEnvironment?: string;
+    runtime?: string;
+}
+/** Provider object categories materialized by the network commercial shadow. */
+type CommercialObjectKind = "customer" | "subscription" | "invoice" | "refund" | "seat";
+/** One verified, allowlisted, PII-free Stripe event fact retained for replay. */
+interface NetworkCommercialFact {
+    eventId: string;
+    digest: string;
+    eventType: string;
+    eventCreated: number;
+    livemode: boolean;
+    objectKind: CommercialObjectKind | "payment_intent" | "dispute" | "ignored";
+    objectId: string;
+    identity: CommercialIdentity;
+    applicationId?: string;
+    personId?: string;
+    membershipId?: string;
+    seatId?: string;
+    customerId?: string;
+    subscriptionId?: string;
+    invoiceId?: string;
+    chargeId?: string;
+    paymentIntentId?: string;
+    /** Stripe's dispute reason (`fraudulent`, `product_not_received`, …) on a `charge.dispute.*` fact. */
+    disputeReason?: string;
+    subscriptionItemId?: string;
+    refundedCents?: number;
+    /** Complete recurring seat item references, with no recipient PII. */
+    seatSubscriptionItems?: Array<{
+        seatId: string;
+        membershipId: string;
+        subscriptionItemId: string;
+        priceId: string;
+        currentPeriodEnd?: number;
+    }>;
+    priceId?: string;
+    quantity?: number;
+    status?: string;
+    currency?: string;
+    amountCents?: number;
+    amountPaidCents?: number;
+    amountReceivedCents?: number;
+    invoiceTotalCents?: number;
+    billingReason?: string;
+    invoicePaidAt?: number;
+    invoicePeriodEndsAt?: number;
+    /** Complete, non-prorated recurring invoice lines; absent when ambiguous or truncated. */
+    recurringInvoiceLines?: Array<{
+        priceId: string;
+        quantity: number;
+        startsAt: number;
+        endsAt: number;
+    }>;
+    amountRemainingCents?: number;
+    currentPeriodStart?: number;
+    currentPeriodEnd?: number;
+    cancelAtPeriodEnd?: boolean;
+}
+
 /** Content-free operator alert attached to an error report. Its shape is a subset of
  * the `ErrorReport` that `recordError` from `@odla-ai/o11y` accepts, so a host passes
  * that function straight through as `ChapterWorkerOptions.recordError`. */
@@ -1493,6 +1567,8 @@ declare function createWorkerContext(options: ChapterWorkerOptions): {
         stripeSecretName?: string;
     } | undefined;
     recordError: ChapterErrorRecorder;
+    bindExecution: (req: Request, execution: ExecutionLike | undefined) => void;
+    defer: (req: Request, task: () => Promise<unknown>) => Promise<void>;
     getPublicConfig: (env: ChapterEnv) => Promise<PublicConfig>;
     verifyUser: (req: Request, env: ChapterEnv) => Promise<Verified | null>;
     makeDb: (env: ChapterEnv) => Db;
@@ -1564,6 +1640,98 @@ type NamedSeatOperatorRefundInput = MembershipQuoteTarget & {
  */
 declare function refundNamedSeatByOperator(db: ChapterDb, input: NamedSeatOperatorRefundInput, stripeSecretKey: string, now: number): Promise<NamedSeatRefundReceipt>;
 
+/** Fence both absence of a collision and an audited resolution of this exact retained fact. */
+declare function commercialEvidenceGuard(db: ChapterDb, eventId: string, digest: unknown, code?: string): Promise<{
+    ns: string;
+    id: string;
+    exists: boolean;
+    equals?: undefined;
+} | {
+    ns: string;
+    id: string;
+    exists: boolean;
+    equals: {
+        status: string;
+        resolvedDigest: string;
+        updatedAt: unknown;
+    };
+}>;
+
+type Row$4 = Record<string, unknown>;
+type EvidenceGuard = Awaited<ReturnType<typeof commercialEvidenceGuard>>;
+/** The seat's own standing on a membership dispute receipt, present when the disputed charge paid a named seat. */
+interface NamedSeatDisputeStanding {
+    seatId: string;
+    status: string;
+    disputeStatus?: string;
+    applied: boolean;
+}
+/** True when the disputed charge paid this seat: its own PaymentIntent, or an operator's re-issued one. A seat line on the
+ * primary subscription's invoice is the primary's charge and is handled there. */
+declare function disputedChargeCoversSeat(charge: DisputedCharge, seat: Row$4): boolean;
+/** Apply one verified `charge.dispute.*` fact to the named seat whose payment it names. The primary membership is never
+ * touched: the recipient loses access through the seat's status alone, and a won dispute restores exactly the seat
+ * status the dispute interrupted. Idempotent per event. */
+declare function reconcileNamedSeatDispute(db: ChapterDb, input: MembershipQuoteTarget & {
+    eventId: string;
+}, now: number, charge: DisputedCharge, evidence: {
+    row: Row$4;
+    fact: NetworkCommercialFact;
+    guard: EvidenceGuard;
+}): Promise<MembershipDisputeReceipt>;
+
+/** Status a membership or named seat holds while a card-network dispute has its payment pulled back. */
+declare const MEMBERSHIP_DISPUTED_STATUS = "payment_disputed";
+
+/** The charge a dispute names, read from Stripe so a webhook body never chooses which membership it touches. */
+interface DisputedCharge {
+    chargeId: string;
+    customerId: string;
+    invoiceId?: string;
+    subscriptionId?: string;
+    paymentIntentId?: string;
+    /** Present when the charge paid a named seat's own PaymentIntent; the dispute is then the seat's, not the primary's. */
+    seatId?: string;
+}
+/** Billing receipt plus the dispute's current standing and whether this event changed anything. */
+interface MembershipDisputeReceipt extends MembershipRenewalReceipt {
+    disputeStatus?: string;
+    applied: boolean;
+    /** The seat's standing when the disputed charge paid a named seat; the membership fields are then unchanged. */
+    seat?: NamedSeatDisputeStanding;
+}
+/** Resolve the disputed charge, and the subscription behind its invoice, with the network's own Stripe credential. */
+declare function readDisputedCharge(secretKey: string, chargeId: string, fetch?: typeof globalThis.fetch): Promise<DisputedCharge>;
+/** Apply one verified `charge.dispute.*` fact to the membership it names, or to the named seat when the charge paid a
+ * seat's own PaymentIntent. An open dispute suspends access; a won dispute restores the status it interrupted; a lost
+ * one leaves the record suspended until an operator re-issues the charge. Idempotent per event, a closed dispute
+ * outranks a late opening event, and a charge that is neither this membership's nor its seat's changes nothing. */
+declare function reconcileMembershipDispute(db: ChapterDb, input: MembershipQuoteTarget & {
+    eventId: string;
+}, now: number, secretKey: string, resolved?: DisputedCharge): Promise<MembershipDisputeReceipt>;
+
+/** What an operator sees after asking the network to collect a lost dispute's amount again. */
+interface MembershipRechargeReceipt {
+    membershipId: string;
+    status: string;
+    paymentIntentId: string;
+    amountCents: number;
+    currency: string;
+    replayed?: true;
+    /** Present when the re-issued charge paid a named seat; `membershipId` is then the seat's primary membership. */
+    seatId?: string;
+}
+/** Stripe's final answer to a re-issued charge, with the decline code when the card refused it. */
+interface MembershipRechargeError extends Error {
+    code: string;
+    declineCode?: string;
+    paymentStatus?: string;
+}
+/** Re-issue a membership's lost dispute amount; see {@link rechargeDisputed}. */
+declare const rechargeDisputedMembership: (db: ChapterDb, membershipId: string, secretKey: string, now: number) => Promise<MembershipRechargeReceipt>;
+/** Re-issue a named seat's lost dispute amount on the purchaser's saved card; the primary membership is untouched. */
+declare const rechargeDisputedSeat: (db: ChapterDb, seatId: string, secretKey: string, now: number) => Promise<MembershipRechargeReceipt>;
+
 /** Seat states in which the purchaser may still name someone else: invited or accepted, never active, refunded or unpaid. */
 declare const REGIFTABLE_SEAT_STATUSES: readonly ["pending_acceptance", "pending_approval", "pending_primary"];
 /** Whether a seat may be given to a different recipient (BNF bug 38000934): final once active. */
@@ -2332,7 +2500,9 @@ declare function withActiveSignupControlTheme(response: Response, options: Activ
  * keep those alerts as structured `console.error` lines.
  */
 declare function chapterWorker(options: ChapterWorkerOptions): {
-    fetch(req: Request, env: ChapterEnv): Promise<Response>;
+    fetch(req: Request, env: ChapterEnv, execution?: {
+        waitUntil(promise: Promise<unknown>): void;
+    }): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, DECLINABLE_FROM, type FormerNamedSeatRecipient, type IncludedNamedSeatReceipt, type LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, MEMBERSHIP_CHAPTER_EFFECT_KINDS, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipChapterEffectKind, type MembershipEffectScope, type MembershipRetermInput, type MembershipRetermReceipt, type MembershipRetermSkipReason, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatOffer, type NamedSeatOfferSeat, type NamedSeatOperatorRefundInput, type NamedSeatRecipientState, type NamedSeatRefundReason, type NamedSeatRegiftReceipt, type NamedSeatReleaseInput, type NetworkTargetTransport, NetworkTargetTransportError, REGIFTABLE_SEAT_STATUSES, type RegiftNamedSeatInput, type Route, type SeatRepriceReceipt, type SeatRepriceScope, type SignupControlDeliveryOptions, type SignupEligibility, type SignupPredecessor, type WorkerContext, chapterMembershipAccess, chapterWorker, closedApplication, continueApplicationOnFreeTier, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, declineApplication, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, grantIncludedNamedSeat, liftSeatPurchaseWindow, lowerSeatPrice, namedSeatIncluded, namedSeatInvitationOpen, namedSeatRecipientState, namedSeatRegiftable, readNamedSeatOffer, refundNamedSeatByOperator, regiftNamedSeat, releaseNamedSeatRecipientApplications, renderActiveSignupControlHtml, resolveNetworkTargetTransport, resolveSignupEligibility, retermMembershipDiscount, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, DECLINABLE_FROM, type DisputedCharge, type FormerNamedSeatRecipient, type IncludedNamedSeatReceipt, type LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, MEMBERSHIP_CHAPTER_EFFECT_KINDS, MEMBERSHIP_DISPUTED_STATUS, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipChapterEffectKind, type MembershipDisputeReceipt, type MembershipEffectScope, type MembershipRechargeError, type MembershipRechargeReceipt, type MembershipRetermInput, type MembershipRetermReceipt, type MembershipRetermSkipReason, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatDisputeStanding, type NamedSeatOffer, type NamedSeatOfferSeat, type NamedSeatOperatorRefundInput, type NamedSeatRecipientState, type NamedSeatRefundReason, type NamedSeatRegiftReceipt, type NamedSeatReleaseInput, type NetworkTargetTransport, NetworkTargetTransportError, REGIFTABLE_SEAT_STATUSES, type RegiftNamedSeatInput, type Route, type SeatRepriceReceipt, type SeatRepriceScope, type SignupControlDeliveryOptions, type SignupEligibility, type SignupPredecessor, type WorkerContext, chapterMembershipAccess, chapterWorker, closedApplication, continueApplicationOnFreeTier, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, declineApplication, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, disputedChargeCoversSeat, drainMembershipEffects, grantIncludedNamedSeat, liftSeatPurchaseWindow, lowerSeatPrice, namedSeatIncluded, namedSeatInvitationOpen, namedSeatRecipientState, namedSeatRegiftable, readDisputedCharge, readNamedSeatOffer, rechargeDisputedMembership, rechargeDisputedSeat, reconcileMembershipDispute, reconcileNamedSeatDispute, refundNamedSeatByOperator, regiftNamedSeat, releaseNamedSeatRecipientApplications, renderActiveSignupControlHtml, resolveNetworkTargetTransport, resolveSignupEligibility, retermMembershipDiscount, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };

package/dist/worker/index.d.ts

@@ -1,6 +1,11 @@
 import { CrmConfig, Crm, FieldConditions } from '@odla-ai/crm';
 import { initAdmin } from '@odla-ai/db';
 
+/** The part of a Workers ExecutionContext a chapter route needs: let work outlive the response. */
+interface ExecutionLike {
+    waitUntil(promise: Promise<unknown>): void;
+}
+
 /** One membership tier a chapter offers. `priceCents: 0` means free. */
 interface ChapterTier {
     /** Stable slug, referenced by `applications.tierId`. Never renumbered. */
@@ -83,6 +88,10 @@ interface ChapterCopy {
         booking: TextFields<"unavailable" | "loadFailed" | "slotTaken" | "failed" | "loading" | "book" | "booking"> & {
             title?: string;
             intro?: string;
+            /** Shown under the booking button until a date is chosen. */
+            pickDate?: string;
+            /** Shown under the booking button once a date is chosen, until a time is. */
+            pickTime?: string;
         };
         /**
          * `consent` is the affirmative statement a member agrees to before the card
@@ -1082,7 +1091,7 @@ declare const namedSeatIncluded: (seat: {
     amountCents?: unknown;
 }) => boolean;
 /** Where the named recipient stands, from the purchaser's side, folded from the seat's lifecycle status. */
-type NamedSeatRecipientState = "payment_pending" | "invited" | "accepted" | "joined" | "declined" | "refunded" | "canceled";
+type NamedSeatRecipientState = "payment_pending" | "invited" | "accepted" | "joined" | "declined" | "refunded" | "canceled" | "disputed";
 /** Fold the seat status machine into the words a members page needs: whether the person was invited, accepted, joined or left. */
 declare function namedSeatRecipientState(seat: {
     status?: unknown;
@@ -1278,6 +1287,71 @@ type NamedSeatEvidenceRequest = MembershipQuoteTarget & {
     eventId: string;
 };
 
+/** Stripe metadata fields used to bind one fact to an exact configured source. */
+interface CommercialIdentity {
+    appId?: string;
+    chapterId?: string;
+    environment?: string;
+    dataEnvironment?: string;
+    runtime?: string;
+}
+/** Provider object categories materialized by the network commercial shadow. */
+type CommercialObjectKind = "customer" | "subscription" | "invoice" | "refund" | "seat";
+/** One verified, allowlisted, PII-free Stripe event fact retained for replay. */
+interface NetworkCommercialFact {
+    eventId: string;
+    digest: string;
+    eventType: string;
+    eventCreated: number;
+    livemode: boolean;
+    objectKind: CommercialObjectKind | "payment_intent" | "dispute" | "ignored";
+    objectId: string;
+    identity: CommercialIdentity;
+    applicationId?: string;
+    personId?: string;
+    membershipId?: string;
+    seatId?: string;
+    customerId?: string;
+    subscriptionId?: string;
+    invoiceId?: string;
+    chargeId?: string;
+    paymentIntentId?: string;
+    /** Stripe's dispute reason (`fraudulent`, `product_not_received`, …) on a `charge.dispute.*` fact. */
+    disputeReason?: string;
+    subscriptionItemId?: string;
+    refundedCents?: number;
+    /** Complete recurring seat item references, with no recipient PII. */
+    seatSubscriptionItems?: Array<{
+        seatId: string;
+        membershipId: string;
+        subscriptionItemId: string;
+        priceId: string;
+        currentPeriodEnd?: number;
+    }>;
+    priceId?: string;
+    quantity?: number;
+    status?: string;
+    currency?: string;
+    amountCents?: number;
+    amountPaidCents?: number;
+    amountReceivedCents?: number;
+    invoiceTotalCents?: number;
+    billingReason?: string;
+    invoicePaidAt?: number;
+    invoicePeriodEndsAt?: number;
+    /** Complete, non-prorated recurring invoice lines; absent when ambiguous or truncated. */
+    recurringInvoiceLines?: Array<{
+        priceId: string;
+        quantity: number;
+        startsAt: number;
+        endsAt: number;
+    }>;
+    amountRemainingCents?: number;
+    currentPeriodStart?: number;
+    currentPeriodEnd?: number;
+    cancelAtPeriodEnd?: boolean;
+}
+
 /** Content-free operator alert attached to an error report. Its shape is a subset of
  * the `ErrorReport` that `recordError` from `@odla-ai/o11y` accepts, so a host passes
  * that function straight through as `ChapterWorkerOptions.recordError`. */
@@ -1493,6 +1567,8 @@ declare function createWorkerContext(options: ChapterWorkerOptions): {
         stripeSecretName?: string;
     } | undefined;
     recordError: ChapterErrorRecorder;
+    bindExecution: (req: Request, execution: ExecutionLike | undefined) => void;
+    defer: (req: Request, task: () => Promise<unknown>) => Promise<void>;
     getPublicConfig: (env: ChapterEnv) => Promise<PublicConfig>;
     verifyUser: (req: Request, env: ChapterEnv) => Promise<Verified | null>;
     makeDb: (env: ChapterEnv) => Db;
@@ -1564,6 +1640,98 @@ type NamedSeatOperatorRefundInput = MembershipQuoteTarget & {
  */
 declare function refundNamedSeatByOperator(db: ChapterDb, input: NamedSeatOperatorRefundInput, stripeSecretKey: string, now: number): Promise<NamedSeatRefundReceipt>;
 
+/** Fence both absence of a collision and an audited resolution of this exact retained fact. */
+declare function commercialEvidenceGuard(db: ChapterDb, eventId: string, digest: unknown, code?: string): Promise<{
+    ns: string;
+    id: string;
+    exists: boolean;
+    equals?: undefined;
+} | {
+    ns: string;
+    id: string;
+    exists: boolean;
+    equals: {
+        status: string;
+        resolvedDigest: string;
+        updatedAt: unknown;
+    };
+}>;
+
+type Row$4 = Record<string, unknown>;
+type EvidenceGuard = Awaited<ReturnType<typeof commercialEvidenceGuard>>;
+/** The seat's own standing on a membership dispute receipt, present when the disputed charge paid a named seat. */
+interface NamedSeatDisputeStanding {
+    seatId: string;
+    status: string;
+    disputeStatus?: string;
+    applied: boolean;
+}
+/** True when the disputed charge paid this seat: its own PaymentIntent, or an operator's re-issued one. A seat line on the
+ * primary subscription's invoice is the primary's charge and is handled there. */
+declare function disputedChargeCoversSeat(charge: DisputedCharge, seat: Row$4): boolean;
+/** Apply one verified `charge.dispute.*` fact to the named seat whose payment it names. The primary membership is never
+ * touched: the recipient loses access through the seat's status alone, and a won dispute restores exactly the seat
+ * status the dispute interrupted. Idempotent per event. */
+declare function reconcileNamedSeatDispute(db: ChapterDb, input: MembershipQuoteTarget & {
+    eventId: string;
+}, now: number, charge: DisputedCharge, evidence: {
+    row: Row$4;
+    fact: NetworkCommercialFact;
+    guard: EvidenceGuard;
+}): Promise<MembershipDisputeReceipt>;
+
+/** Status a membership or named seat holds while a card-network dispute has its payment pulled back. */
+declare const MEMBERSHIP_DISPUTED_STATUS = "payment_disputed";
+
+/** The charge a dispute names, read from Stripe so a webhook body never chooses which membership it touches. */
+interface DisputedCharge {
+    chargeId: string;
+    customerId: string;
+    invoiceId?: string;
+    subscriptionId?: string;
+    paymentIntentId?: string;
+    /** Present when the charge paid a named seat's own PaymentIntent; the dispute is then the seat's, not the primary's. */
+    seatId?: string;
+}
+/** Billing receipt plus the dispute's current standing and whether this event changed anything. */
+interface MembershipDisputeReceipt extends MembershipRenewalReceipt {
+    disputeStatus?: string;
+    applied: boolean;
+    /** The seat's standing when the disputed charge paid a named seat; the membership fields are then unchanged. */
+    seat?: NamedSeatDisputeStanding;
+}
+/** Resolve the disputed charge, and the subscription behind its invoice, with the network's own Stripe credential. */
+declare function readDisputedCharge(secretKey: string, chargeId: string, fetch?: typeof globalThis.fetch): Promise<DisputedCharge>;
+/** Apply one verified `charge.dispute.*` fact to the membership it names, or to the named seat when the charge paid a
+ * seat's own PaymentIntent. An open dispute suspends access; a won dispute restores the status it interrupted; a lost
+ * one leaves the record suspended until an operator re-issues the charge. Idempotent per event, a closed dispute
+ * outranks a late opening event, and a charge that is neither this membership's nor its seat's changes nothing. */
+declare function reconcileMembershipDispute(db: ChapterDb, input: MembershipQuoteTarget & {
+    eventId: string;
+}, now: number, secretKey: string, resolved?: DisputedCharge): Promise<MembershipDisputeReceipt>;
+
+/** What an operator sees after asking the network to collect a lost dispute's amount again. */
+interface MembershipRechargeReceipt {
+    membershipId: string;
+    status: string;
+    paymentIntentId: string;
+    amountCents: number;
+    currency: string;
+    replayed?: true;
+    /** Present when the re-issued charge paid a named seat; `membershipId` is then the seat's primary membership. */
+    seatId?: string;
+}
+/** Stripe's final answer to a re-issued charge, with the decline code when the card refused it. */
+interface MembershipRechargeError extends Error {
+    code: string;
+    declineCode?: string;
+    paymentStatus?: string;
+}
+/** Re-issue a membership's lost dispute amount; see {@link rechargeDisputed}. */
+declare const rechargeDisputedMembership: (db: ChapterDb, membershipId: string, secretKey: string, now: number) => Promise<MembershipRechargeReceipt>;
+/** Re-issue a named seat's lost dispute amount on the purchaser's saved card; the primary membership is untouched. */
+declare const rechargeDisputedSeat: (db: ChapterDb, seatId: string, secretKey: string, now: number) => Promise<MembershipRechargeReceipt>;
+
 /** Seat states in which the purchaser may still name someone else: invited or accepted, never active, refunded or unpaid. */
 declare const REGIFTABLE_SEAT_STATUSES: readonly ["pending_acceptance", "pending_approval", "pending_primary"];
 /** Whether a seat may be given to a different recipient (BNF bug 38000934): final once active. */
@@ -2332,7 +2500,9 @@ declare function withActiveSignupControlTheme(response: Response, options: Activ
  * keep those alerts as structured `console.error` lines.
  */
 declare function chapterWorker(options: ChapterWorkerOptions): {
-    fetch(req: Request, env: ChapterEnv): Promise<Response>;
+    fetch(req: Request, env: ChapterEnv, execution?: {
+        waitUntil(promise: Promise<unknown>): void;
+    }): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, DECLINABLE_FROM, type FormerNamedSeatRecipient, type IncludedNamedSeatReceipt, type LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, MEMBERSHIP_CHAPTER_EFFECT_KINDS, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipChapterEffectKind, type MembershipEffectScope, type MembershipRetermInput, type MembershipRetermReceipt, type MembershipRetermSkipReason, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatOffer, type NamedSeatOfferSeat, type NamedSeatOperatorRefundInput, type NamedSeatRecipientState, type NamedSeatRefundReason, type NamedSeatRegiftReceipt, type NamedSeatReleaseInput, type NetworkTargetTransport, NetworkTargetTransportError, REGIFTABLE_SEAT_STATUSES, type RegiftNamedSeatInput, type Route, type SeatRepriceReceipt, type SeatRepriceScope, type SignupControlDeliveryOptions, type SignupEligibility, type SignupPredecessor, type WorkerContext, chapterMembershipAccess, chapterWorker, closedApplication, continueApplicationOnFreeTier, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, declineApplication, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, grantIncludedNamedSeat, liftSeatPurchaseWindow, lowerSeatPrice, namedSeatIncluded, namedSeatInvitationOpen, namedSeatRecipientState, namedSeatRegiftable, readNamedSeatOffer, refundNamedSeatByOperator, regiftNamedSeat, releaseNamedSeatRecipientApplications, renderActiveSignupControlHtml, resolveNetworkTargetTransport, resolveSignupEligibility, retermMembershipDiscount, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, DECLINABLE_FROM, type DisputedCharge, type FormerNamedSeatRecipient, type IncludedNamedSeatReceipt, type LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, MEMBERSHIP_CHAPTER_EFFECT_KINDS, MEMBERSHIP_DISPUTED_STATUS, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipChapterEffectKind, type MembershipDisputeReceipt, type MembershipEffectScope, type MembershipRechargeError, type MembershipRechargeReceipt, type MembershipRetermInput, type MembershipRetermReceipt, type MembershipRetermSkipReason, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatDisputeStanding, type NamedSeatOffer, type NamedSeatOfferSeat, type NamedSeatOperatorRefundInput, type NamedSeatRecipientState, type NamedSeatRefundReason, type NamedSeatRegiftReceipt, type NamedSeatReleaseInput, type NetworkTargetTransport, NetworkTargetTransportError, REGIFTABLE_SEAT_STATUSES, type RegiftNamedSeatInput, type Route, type SeatRepriceReceipt, type SeatRepriceScope, type SignupControlDeliveryOptions, type SignupEligibility, type SignupPredecessor, type WorkerContext, chapterMembershipAccess, chapterWorker, closedApplication, continueApplicationOnFreeTier, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, declineApplication, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, disputedChargeCoversSeat, drainMembershipEffects, grantIncludedNamedSeat, liftSeatPurchaseWindow, lowerSeatPrice, namedSeatIncluded, namedSeatInvitationOpen, namedSeatRecipientState, namedSeatRegiftable, readDisputedCharge, readNamedSeatOffer, rechargeDisputedMembership, rechargeDisputedSeat, reconcileMembershipDispute, reconcileNamedSeatDispute, refundNamedSeatByOperator, regiftNamedSeat, releaseNamedSeatRecipientApplications, renderActiveSignupControlHtml, resolveNetworkTargetTransport, resolveSignupEligibility, retermMembershipDiscount, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };