@odla-ai/chapter 0.56.2 → 0.57.0

package/dist/worker/index.d.cts

@@ -1,6 +1,29 @@
 import { CrmConfig, Crm, FieldConditions } from '@odla-ai/crm';
 import { initAdmin } from '@odla-ai/db';
 
+/** One membership tier a chapter offers. `priceCents: 0` means free. */
+interface ChapterTier {
+    /** Stable slug, referenced by `applications.tierId`. Never renumbered. */
+    id: string;
+    /** The group this tier belongs to. */
+    groupId: string;
+    /** Display name, e.g. "Founding". */
+    name: string;
+    /** Price in minor units. `0` is free and needs no Stripe price. */
+    priceCents: number;
+    /** ISO currency inherited from the group for legacy rows. */
+    currency?: string;
+    /** Recurring interval inherited from the group for legacy rows. */
+    interval?: "year" | "month";
+    /** Stripe price to subscribe. Required only when `priceCents > 0`. */
+    stripePriceId?: string | null;
+    /** Short description shown beside the tier on the join page. */
+    blurb?: string;
+    /** Ascending display order; ties fall back to `id` for a stable sort. */
+    sortOrder: number;
+    /** An inactive tier is retained for existing members but never offered. */
+    active: boolean;
+}
 /**
  * A tier as declared in `defineChapter`, before it becomes a row.
  *
@@ -44,7 +67,7 @@ type AdminRecordsCopy = {
     [Field in AdminRecordsCopyKey]: string;
 };
 /** Every key a host may override under `admin.records`. */
-type AdminRecordsCopyKey = "workflowMissing" | "invitation" | "comms" | "commsHistory" | "scheduling" | "billing" | "notes" | "access" | "sharing" | "lifecycle" | "role" | "superAdminHint" | "noAccount" | "approve" | "refund" | "approved" | "refunded" | "roleSet" | "messageSent" | "messageNotSent" | "loadingTemplates" | "template" | "chooseTemplate" | "sending" | "send" | "noMessages" | "message" | "newStartPrompt" | "parseFailed" | "cancelConfirm" | "callCancelled" | "callRescheduled" | "noApplication" | "loadingMeetings" | "noMeetings" | "joinMeeting" | "openCalendar" | "reschedule" | "cancel";
+type AdminRecordsCopyKey = "workflowMissing" | "invitation" | "comms" | "commsHistory" | "scheduling" | "billing" | "notes" | "access" | "sharing" | "lifecycle" | "role" | "superAdminHint" | "noAccount" | "approve" | "decline" | "refund" | "approved" | "declined" | "refunded" | "roleSet" | "messageSent" | "messageNotSent" | "loadingTemplates" | "template" | "chooseTemplate" | "sending" | "send" | "noMessages" | "message" | "newStartPrompt" | "parseFailed" | "cancelConfirm" | "callCancelled" | "callRescheduled" | "noApplication" | "loadingMeetings" | "noMeetings" | "joinMeeting" | "openCalendar" | "reschedule" | "cancel";
 
 type TextFields<Key extends string> = {
     [Field in Key]: string;
@@ -1093,6 +1116,12 @@ interface NamedSeatOfferSeat {
     acceptedAt?: number;
     /** When the recipient's own application was approved; the seat is active from then, once the primary is. */
     joinedAt?: number;
+    /** True while the invitation waits for the buying member's own approval; nothing has been sent to the recipient yet. */
+    invitationHeld?: true;
+    /** True while the purchaser may still name someone else: the seat is invited or accepted but not yet active. */
+    regiftable?: true;
+    /** When the purchaser last replaced the recipient. */
+    regiftedAt?: number;
 }
 /** Named-seat offer for the authenticated purchaser, not a transferable gift or arbitrary quantity. */
 interface NamedSeatOffer {
@@ -1135,13 +1164,23 @@ interface NamedSeatInvitation {
     termEndsAt: number;
 }
 
+/** Effects a chapter receives over the signed edge; `release_named_recipient` ends a replaced recipient's claim without a refund. */
+declare const MEMBERSHIP_CHAPTER_EFFECT_KINDS: readonly ["invite_named_recipient", "grant_named_recipient_access", "revoke_named_recipient_access", "release_named_recipient"];
+/** One of {@link MEMBERSHIP_CHAPTER_EFFECT_KINDS}. */
+type MembershipChapterEffectKind = (typeof MEMBERSHIP_CHAPTER_EFFECT_KINDS)[number];
+/** The buying member's invitation may go out: their own Journey approval is durable, not merely paid (BNF bug c3c1d338). */
+declare const namedSeatInvitationOpen: (member: {
+    status?: unknown;
+    journeyApprovedAt?: unknown;
+}) => boolean;
+
 /** Exact configured chapter/runtime serviced by one scheduled network worker. */
 type MembershipEffectScope = Pick<MembershipQuoteTarget, "appId" | "chapterId" | "environment" | "runtime">;
 /** Downstream requests carry only identifiers; the signed chapter receiver reads current state and deduplicates by effectId. */
 interface MembershipChapterEffect extends MembershipQuoteTarget {
     effectId: string;
     seatId: string;
-    kind: "invite_named_recipient" | "grant_named_recipient_access" | "revoke_named_recipient_access";
+    kind: MembershipChapterEffectKind;
 }
 /** Recover provider effects from durable state, independently of browser/webhook retries.
  * The optional chapter adapter must return a durable, idempotent receipt. An absent adapter leaves work visibly pending.
@@ -1160,6 +1199,7 @@ declare function drainMembershipEffects(db: ChapterDb, options: {
 }, now: number): Promise<{
     complete: number;
     pending: number;
+    held: number;
     more: boolean;
 }>;
 
@@ -1216,6 +1256,15 @@ interface NamedSeatRefundReceipt {
     refundedCents: number;
     subscriptionCanceled: false;
 }
+/** Receipt for naming a different recipient: the seat is invited again, nothing is charged or refunded. */
+interface NamedSeatRegiftReceipt {
+    seatId: string;
+    status: "pending_acceptance";
+    recipientName: string;
+    recipientEmail: string;
+    regiftedAt: number;
+    releasedRecipientApplicationId: string | null;
+}
 /** Verified purchaser identity and their named recipient, with no caller-selected pricing. */
 type NamedSeatCheckoutRequest = MembershipQuoteTarget & {
     recipientName: string;
@@ -1339,6 +1388,12 @@ interface ChapterWorkerOptions {
             operatorRefund: (input: MembershipQuoteTarget & {
                 seatId: string;
             }, env: ChapterEnv) => Promise<NamedSeatRefundReceipt>;
+            /** The purchaser (or a super admin) names a different recipient before the seat is active; absent on older adapters. */
+            regift?: (input: MembershipQuoteTarget & {
+                seatId: string;
+                recipientName: string;
+                recipientEmail: string;
+            }, env: ChapterEnv) => Promise<NamedSeatRegiftReceipt>;
         };
     };
     /** Network owner only: operate the membership authority this Worker hosts (seat refunds by a super admin).
@@ -1425,6 +1480,12 @@ declare function createWorkerContext(options: ChapterWorkerOptions): {
             operatorRefund: (input: MembershipQuoteTarget & {
                 seatId: string;
             }, env: ChapterEnv) => Promise<NamedSeatRefundReceipt>;
+            /** The purchaser (or a super admin) names a different recipient before the seat is active; absent on older adapters. */
+            regift?: (input: MembershipQuoteTarget & {
+                seatId: string;
+                recipientName: string;
+                recipientEmail: string;
+            }, env: ChapterEnv) => Promise<NamedSeatRegiftReceipt>;
         };
     } | undefined;
     membershipAuthorityOperator: {
@@ -1503,6 +1564,91 @@ type NamedSeatOperatorRefundInput = MembershipQuoteTarget & {
  */
 declare function refundNamedSeatByOperator(db: ChapterDb, input: NamedSeatOperatorRefundInput, stripeSecretKey: string, now: number): Promise<NamedSeatRefundReceipt>;
 
+/** 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. */
+declare const namedSeatRegiftable: (seat: {
+    status?: unknown;
+}) => boolean;
+/** The purchaser's exact seat and the person who should hold it from now on. */
+type RegiftNamedSeatInput = MembershipQuoteTarget & {
+    seatId: string;
+    recipientName: string;
+    recipientEmail: string;
+};
+/** One prior holder of a seat, kept on the seat as history after the purchaser named someone else. */
+interface FormerNamedSeatRecipient {
+    recipientName: string;
+    recipientEmail: string;
+    recipientClaimId: string;
+    releasedAt: number;
+    recipientUserId?: string;
+    recipientApplicationId?: string;
+    acceptedAt?: number;
+    journeyApprovedAt?: number;
+}
+/** Give an invited or accepted seat to a different named person, before it is active.
+ * The old invitation link stops resolving (the seat no longer names that email), the entitlement goes back to
+ * pending acceptance, a new invitation effect is queued, and a former recipient who had accepted gets a
+ * `release_named_recipient` effect so the chapter closes their application. Money is untouched: the seat's
+ * payment and renewal line stay exactly as they were, which is what makes this work for an included seat too.
+ * The former recipient is kept on the seat's `formerRecipients` history. Replays with the same person converge.
+ */
+declare function regiftNamedSeat(db: ChapterDb, input: RegiftNamedSeatInput, now: number): Promise<NamedSeatRegiftReceipt>;
+
+/** Who may keep the seat: the exact application the authority still names, or whoever holds the new recipient email. */
+interface NamedSeatReleaseInput {
+    seatId: string;
+    recipientApplicationId?: string | null;
+    recipientUserId?: string | null;
+    keepRecipientEmail?: string;
+}
+/** Close the applications of recipients a seat no longer names (BNF bug 38000934).
+ * The replaced person keeps their application and history: it moves to `declined`, is marked closed, and loses
+ * its seat binding so the new recipient can claim the same seat. Nothing is refunded, because the seat itself
+ * was not returned; a role that approval promoted is taken back. Idempotent: an application already released
+ * is left alone, and a bound recipient the effect names is released even if the chapter already did it.
+ */
+declare function releaseNamedSeatRecipientApplications(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, input: NamedSeatReleaseInput): Promise<{
+    released: string[];
+}>;
+
+type Row$3 = Record<string, unknown>;
+/** Whether an application's status can still be refused outright: payment held means a refund, not a decline. */
+declare const DECLINABLE_FROM: (status: string) => boolean;
+/** Refuse an applicant who holds no payment (BNF bug fa96b11c): a free-tier applicant, or a paid-tier applicant who never paid.
+ * The application closes as `declined`, the CRM stage follows, and no email is sent; the operator says it in person.
+ * A paid applicant is never declined here: the refund operation is the only way to end a paid membership. A gifted
+ * seat's recipient is released by the purchaser naming someone else, or refunded. Replays converge on the declined row. */
+declare function declineApplication(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, app: Row$3): Promise<Response>;
+
+type Row$2 = Record<string, unknown>;
+/** "Not a paid fit" (BNF bug f7bc92ee): after a full refund, keep the person on a free tier of the same chapter with member access.
+ * The refunded purchase is archived as checkout history and its billing fields leave the row; the application moves to the
+ * last approvable stage on the free tier and is approved at once through the ordinary approval, which promotes the account
+ * and sends the welcome notice. Safe to repeat: a conversion that already happened is only re-approved. */
+declare function continueApplicationOnFreeTier(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, app: Row$2, tier: ChapterTier, origin: string): Promise<Response>;
+
+type Row$1 = Record<string, unknown>;
+/** An application that ended without approval still holding: declined, refunded, canceled, or closed by a refund flag.
+ * Such a person may apply again (BNF bug 79590edc); the closed row stays as history. */
+declare const closedApplication: (row: Row$1) => boolean;
+/** The closed application a new attempt continues from: its account binding carries over, its unique signup key is released. */
+interface SignupPredecessor {
+    id: string;
+    clerkUserId?: string;
+}
+/** Either a conflict response, or permission to write, with the predecessor a returning applicant adopts. */
+interface SignupEligibility {
+    conflict: Response | null;
+    predecessor: SignupPredecessor | null;
+}
+/** Refuse known accounts before persisting any application, consent or CRM data.
+ * Provider failures are unavailable, never evidence that an address is free. A person whose every earlier application
+ * in this chapter is closed may apply again: the newest closed row (and the account bound to it) becomes the predecessor.
+ */
+declare function resolveSignupEligibility(db: ChapterDb, chapter: Chapter, fields: Record<string, unknown>, submissionId?: string): Promise<SignupEligibility>;
+
 /** Why one membership was left as it was. `would_not_widen` is the only-widens rule: the version would raise the renewal. */
 type MembershipRetermSkipReason = "not_found" | "scope_mismatch" | "status" | "not_founding" | "cohort_mismatch" | "sku_not_discounted" | "would_not_widen" | "provider_mismatch";
 /** What a re-term run did, member by member. Everything a super admin needs to read back is here; nothing is inferred later. */
@@ -2189,4 +2335,4 @@ declare function chapterWorker(options: ChapterWorkerOptions): {
     fetch(req: Request, env: ChapterEnv): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, type IncludedNamedSeatReceipt, type LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipEffectScope, type MembershipRetermInput, type MembershipRetermReceipt, type MembershipRetermSkipReason, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatOffer, type NamedSeatOfferSeat, type NamedSeatOperatorRefundInput, type NamedSeatRecipientState, type NamedSeatRefundReason, type NetworkTargetTransport, NetworkTargetTransportError, type Route, type SeatRepriceReceipt, type SeatRepriceScope, type SignupControlDeliveryOptions, type WorkerContext, chapterMembershipAccess, chapterWorker, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, grantIncludedNamedSeat, liftSeatPurchaseWindow, lowerSeatPrice, namedSeatIncluded, namedSeatRecipientState, readNamedSeatOffer, refundNamedSeatByOperator, renderActiveSignupControlHtml, resolveNetworkTargetTransport, 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 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 };

package/dist/worker/index.d.ts

@@ -1,6 +1,29 @@
 import { CrmConfig, Crm, FieldConditions } from '@odla-ai/crm';
 import { initAdmin } from '@odla-ai/db';
 
+/** One membership tier a chapter offers. `priceCents: 0` means free. */
+interface ChapterTier {
+    /** Stable slug, referenced by `applications.tierId`. Never renumbered. */
+    id: string;
+    /** The group this tier belongs to. */
+    groupId: string;
+    /** Display name, e.g. "Founding". */
+    name: string;
+    /** Price in minor units. `0` is free and needs no Stripe price. */
+    priceCents: number;
+    /** ISO currency inherited from the group for legacy rows. */
+    currency?: string;
+    /** Recurring interval inherited from the group for legacy rows. */
+    interval?: "year" | "month";
+    /** Stripe price to subscribe. Required only when `priceCents > 0`. */
+    stripePriceId?: string | null;
+    /** Short description shown beside the tier on the join page. */
+    blurb?: string;
+    /** Ascending display order; ties fall back to `id` for a stable sort. */
+    sortOrder: number;
+    /** An inactive tier is retained for existing members but never offered. */
+    active: boolean;
+}
 /**
  * A tier as declared in `defineChapter`, before it becomes a row.
  *
@@ -44,7 +67,7 @@ type AdminRecordsCopy = {
     [Field in AdminRecordsCopyKey]: string;
 };
 /** Every key a host may override under `admin.records`. */
-type AdminRecordsCopyKey = "workflowMissing" | "invitation" | "comms" | "commsHistory" | "scheduling" | "billing" | "notes" | "access" | "sharing" | "lifecycle" | "role" | "superAdminHint" | "noAccount" | "approve" | "refund" | "approved" | "refunded" | "roleSet" | "messageSent" | "messageNotSent" | "loadingTemplates" | "template" | "chooseTemplate" | "sending" | "send" | "noMessages" | "message" | "newStartPrompt" | "parseFailed" | "cancelConfirm" | "callCancelled" | "callRescheduled" | "noApplication" | "loadingMeetings" | "noMeetings" | "joinMeeting" | "openCalendar" | "reschedule" | "cancel";
+type AdminRecordsCopyKey = "workflowMissing" | "invitation" | "comms" | "commsHistory" | "scheduling" | "billing" | "notes" | "access" | "sharing" | "lifecycle" | "role" | "superAdminHint" | "noAccount" | "approve" | "decline" | "refund" | "approved" | "declined" | "refunded" | "roleSet" | "messageSent" | "messageNotSent" | "loadingTemplates" | "template" | "chooseTemplate" | "sending" | "send" | "noMessages" | "message" | "newStartPrompt" | "parseFailed" | "cancelConfirm" | "callCancelled" | "callRescheduled" | "noApplication" | "loadingMeetings" | "noMeetings" | "joinMeeting" | "openCalendar" | "reschedule" | "cancel";
 
 type TextFields<Key extends string> = {
     [Field in Key]: string;
@@ -1093,6 +1116,12 @@ interface NamedSeatOfferSeat {
     acceptedAt?: number;
     /** When the recipient's own application was approved; the seat is active from then, once the primary is. */
     joinedAt?: number;
+    /** True while the invitation waits for the buying member's own approval; nothing has been sent to the recipient yet. */
+    invitationHeld?: true;
+    /** True while the purchaser may still name someone else: the seat is invited or accepted but not yet active. */
+    regiftable?: true;
+    /** When the purchaser last replaced the recipient. */
+    regiftedAt?: number;
 }
 /** Named-seat offer for the authenticated purchaser, not a transferable gift or arbitrary quantity. */
 interface NamedSeatOffer {
@@ -1135,13 +1164,23 @@ interface NamedSeatInvitation {
     termEndsAt: number;
 }
 
+/** Effects a chapter receives over the signed edge; `release_named_recipient` ends a replaced recipient's claim without a refund. */
+declare const MEMBERSHIP_CHAPTER_EFFECT_KINDS: readonly ["invite_named_recipient", "grant_named_recipient_access", "revoke_named_recipient_access", "release_named_recipient"];
+/** One of {@link MEMBERSHIP_CHAPTER_EFFECT_KINDS}. */
+type MembershipChapterEffectKind = (typeof MEMBERSHIP_CHAPTER_EFFECT_KINDS)[number];
+/** The buying member's invitation may go out: their own Journey approval is durable, not merely paid (BNF bug c3c1d338). */
+declare const namedSeatInvitationOpen: (member: {
+    status?: unknown;
+    journeyApprovedAt?: unknown;
+}) => boolean;
+
 /** Exact configured chapter/runtime serviced by one scheduled network worker. */
 type MembershipEffectScope = Pick<MembershipQuoteTarget, "appId" | "chapterId" | "environment" | "runtime">;
 /** Downstream requests carry only identifiers; the signed chapter receiver reads current state and deduplicates by effectId. */
 interface MembershipChapterEffect extends MembershipQuoteTarget {
     effectId: string;
     seatId: string;
-    kind: "invite_named_recipient" | "grant_named_recipient_access" | "revoke_named_recipient_access";
+    kind: MembershipChapterEffectKind;
 }
 /** Recover provider effects from durable state, independently of browser/webhook retries.
  * The optional chapter adapter must return a durable, idempotent receipt. An absent adapter leaves work visibly pending.
@@ -1160,6 +1199,7 @@ declare function drainMembershipEffects(db: ChapterDb, options: {
 }, now: number): Promise<{
     complete: number;
     pending: number;
+    held: number;
     more: boolean;
 }>;
 
@@ -1216,6 +1256,15 @@ interface NamedSeatRefundReceipt {
     refundedCents: number;
     subscriptionCanceled: false;
 }
+/** Receipt for naming a different recipient: the seat is invited again, nothing is charged or refunded. */
+interface NamedSeatRegiftReceipt {
+    seatId: string;
+    status: "pending_acceptance";
+    recipientName: string;
+    recipientEmail: string;
+    regiftedAt: number;
+    releasedRecipientApplicationId: string | null;
+}
 /** Verified purchaser identity and their named recipient, with no caller-selected pricing. */
 type NamedSeatCheckoutRequest = MembershipQuoteTarget & {
     recipientName: string;
@@ -1339,6 +1388,12 @@ interface ChapterWorkerOptions {
             operatorRefund: (input: MembershipQuoteTarget & {
                 seatId: string;
             }, env: ChapterEnv) => Promise<NamedSeatRefundReceipt>;
+            /** The purchaser (or a super admin) names a different recipient before the seat is active; absent on older adapters. */
+            regift?: (input: MembershipQuoteTarget & {
+                seatId: string;
+                recipientName: string;
+                recipientEmail: string;
+            }, env: ChapterEnv) => Promise<NamedSeatRegiftReceipt>;
         };
     };
     /** Network owner only: operate the membership authority this Worker hosts (seat refunds by a super admin).
@@ -1425,6 +1480,12 @@ declare function createWorkerContext(options: ChapterWorkerOptions): {
             operatorRefund: (input: MembershipQuoteTarget & {
                 seatId: string;
             }, env: ChapterEnv) => Promise<NamedSeatRefundReceipt>;
+            /** The purchaser (or a super admin) names a different recipient before the seat is active; absent on older adapters. */
+            regift?: (input: MembershipQuoteTarget & {
+                seatId: string;
+                recipientName: string;
+                recipientEmail: string;
+            }, env: ChapterEnv) => Promise<NamedSeatRegiftReceipt>;
         };
     } | undefined;
     membershipAuthorityOperator: {
@@ -1503,6 +1564,91 @@ type NamedSeatOperatorRefundInput = MembershipQuoteTarget & {
  */
 declare function refundNamedSeatByOperator(db: ChapterDb, input: NamedSeatOperatorRefundInput, stripeSecretKey: string, now: number): Promise<NamedSeatRefundReceipt>;
 
+/** 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. */
+declare const namedSeatRegiftable: (seat: {
+    status?: unknown;
+}) => boolean;
+/** The purchaser's exact seat and the person who should hold it from now on. */
+type RegiftNamedSeatInput = MembershipQuoteTarget & {
+    seatId: string;
+    recipientName: string;
+    recipientEmail: string;
+};
+/** One prior holder of a seat, kept on the seat as history after the purchaser named someone else. */
+interface FormerNamedSeatRecipient {
+    recipientName: string;
+    recipientEmail: string;
+    recipientClaimId: string;
+    releasedAt: number;
+    recipientUserId?: string;
+    recipientApplicationId?: string;
+    acceptedAt?: number;
+    journeyApprovedAt?: number;
+}
+/** Give an invited or accepted seat to a different named person, before it is active.
+ * The old invitation link stops resolving (the seat no longer names that email), the entitlement goes back to
+ * pending acceptance, a new invitation effect is queued, and a former recipient who had accepted gets a
+ * `release_named_recipient` effect so the chapter closes their application. Money is untouched: the seat's
+ * payment and renewal line stay exactly as they were, which is what makes this work for an included seat too.
+ * The former recipient is kept on the seat's `formerRecipients` history. Replays with the same person converge.
+ */
+declare function regiftNamedSeat(db: ChapterDb, input: RegiftNamedSeatInput, now: number): Promise<NamedSeatRegiftReceipt>;
+
+/** Who may keep the seat: the exact application the authority still names, or whoever holds the new recipient email. */
+interface NamedSeatReleaseInput {
+    seatId: string;
+    recipientApplicationId?: string | null;
+    recipientUserId?: string | null;
+    keepRecipientEmail?: string;
+}
+/** Close the applications of recipients a seat no longer names (BNF bug 38000934).
+ * The replaced person keeps their application and history: it moves to `declined`, is marked closed, and loses
+ * its seat binding so the new recipient can claim the same seat. Nothing is refunded, because the seat itself
+ * was not returned; a role that approval promoted is taken back. Idempotent: an application already released
+ * is left alone, and a bound recipient the effect names is released even if the chapter already did it.
+ */
+declare function releaseNamedSeatRecipientApplications(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, input: NamedSeatReleaseInput): Promise<{
+    released: string[];
+}>;
+
+type Row$3 = Record<string, unknown>;
+/** Whether an application's status can still be refused outright: payment held means a refund, not a decline. */
+declare const DECLINABLE_FROM: (status: string) => boolean;
+/** Refuse an applicant who holds no payment (BNF bug fa96b11c): a free-tier applicant, or a paid-tier applicant who never paid.
+ * The application closes as `declined`, the CRM stage follows, and no email is sent; the operator says it in person.
+ * A paid applicant is never declined here: the refund operation is the only way to end a paid membership. A gifted
+ * seat's recipient is released by the purchaser naming someone else, or refunded. Replays converge on the declined row. */
+declare function declineApplication(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, app: Row$3): Promise<Response>;
+
+type Row$2 = Record<string, unknown>;
+/** "Not a paid fit" (BNF bug f7bc92ee): after a full refund, keep the person on a free tier of the same chapter with member access.
+ * The refunded purchase is archived as checkout history and its billing fields leave the row; the application moves to the
+ * last approvable stage on the free tier and is approved at once through the ordinary approval, which promotes the account
+ * and sends the welcome notice. Safe to repeat: a conversion that already happened is only re-approved. */
+declare function continueApplicationOnFreeTier(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, app: Row$2, tier: ChapterTier, origin: string): Promise<Response>;
+
+type Row$1 = Record<string, unknown>;
+/** An application that ended without approval still holding: declined, refunded, canceled, or closed by a refund flag.
+ * Such a person may apply again (BNF bug 79590edc); the closed row stays as history. */
+declare const closedApplication: (row: Row$1) => boolean;
+/** The closed application a new attempt continues from: its account binding carries over, its unique signup key is released. */
+interface SignupPredecessor {
+    id: string;
+    clerkUserId?: string;
+}
+/** Either a conflict response, or permission to write, with the predecessor a returning applicant adopts. */
+interface SignupEligibility {
+    conflict: Response | null;
+    predecessor: SignupPredecessor | null;
+}
+/** Refuse known accounts before persisting any application, consent or CRM data.
+ * Provider failures are unavailable, never evidence that an address is free. A person whose every earlier application
+ * in this chapter is closed may apply again: the newest closed row (and the account bound to it) becomes the predecessor.
+ */
+declare function resolveSignupEligibility(db: ChapterDb, chapter: Chapter, fields: Record<string, unknown>, submissionId?: string): Promise<SignupEligibility>;
+
 /** Why one membership was left as it was. `would_not_widen` is the only-widens rule: the version would raise the renewal. */
 type MembershipRetermSkipReason = "not_found" | "scope_mismatch" | "status" | "not_founding" | "cohort_mismatch" | "sku_not_discounted" | "would_not_widen" | "provider_mismatch";
 /** What a re-term run did, member by member. Everything a super admin needs to read back is here; nothing is inferred later. */
@@ -2189,4 +2335,4 @@ declare function chapterWorker(options: ChapterWorkerOptions): {
     fetch(req: Request, env: ChapterEnv): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, type IncludedNamedSeatReceipt, type LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipEffectScope, type MembershipRetermInput, type MembershipRetermReceipt, type MembershipRetermSkipReason, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatOffer, type NamedSeatOfferSeat, type NamedSeatOperatorRefundInput, type NamedSeatRecipientState, type NamedSeatRefundReason, type NetworkTargetTransport, NetworkTargetTransportError, type Route, type SeatRepriceReceipt, type SeatRepriceScope, type SignupControlDeliveryOptions, type WorkerContext, chapterMembershipAccess, chapterWorker, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, grantIncludedNamedSeat, liftSeatPurchaseWindow, lowerSeatPrice, namedSeatIncluded, namedSeatRecipientState, readNamedSeatOffer, refundNamedSeatByOperator, renderActiveSignupControlHtml, resolveNetworkTargetTransport, 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 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 };