@odla-ai/chapter 0.52.0 → 0.53.0

package/dist/worker/index.d.cts

@@ -56,7 +56,7 @@ interface ChapterCopy {
          * agree rather than merely restating the policy. Set it to an empty string
          * to render the checkbox with the policy as its only label.
          */
-        payment: TextFields<"setupFailed" | "preparing" | "pending" | "processing" | "payAndContinue" | "incomplete" | "consent" | "foundingMember" | "foundingDiscount">;
+        payment: TextFields<"setupFailed" | "preparing" | "pending" | "processing" | "payAndContinue" | "incomplete" | "consent" | "foundingMember" | "foundingDiscount" | "standardRate" | "yourRate">;
         done: TextFields<"label" | "calendarInvite" | "memberArea">;
         accepted: TextFields<"label" | "body">;
         gift: TextFields<"chooseSelf" | "optionsLabel" | "label" | "body" | "save" | "rotate" | "rotateFailed" | "claimTitle" | "claimBody" | "code" | "redeem" | "redeemed" | "redeemFailed">;
@@ -1414,6 +1414,38 @@ type NamedSeatOperatorRefundInput = MembershipQuoteTarget & {
  */
 declare function refundNamedSeatByOperator(db: ChapterDb, input: NamedSeatOperatorRefundInput, stripeSecretKey: string, now: number): Promise<NamedSeatRefundReceipt>;
 
+/** 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. */
+interface MembershipRetermReceipt {
+    policyVersionId: string;
+    retermed: {
+        membershipId: string;
+        previousPolicyVersionId?: string;
+        previousRenewalAmountCents: number;
+        renewalAmountCents: number;
+        providerUpdated: boolean;
+    }[];
+    /** Already frozen on this version; nothing was read from or written to the provider. */
+    unchanged: string[];
+    skipped: {
+        membershipId: string;
+        reason: MembershipRetermSkipReason;
+    }[];
+    more: boolean;
+}
+/** Which memberships to move: every member in scope (bounded), or the named ones. */
+interface MembershipRetermInput {
+    policyVersionId: string;
+    membershipIds?: string[];
+    limit?: number;
+}
+/** Move already-paid memberships onto a later discount policy version of the same cohort, so their next renewal carries
+ * its while-active benefit. Only ever widens: a version that would raise a member's renewal is skipped, and a lapsed,
+ * refunded, canceled, declined or restarting purchase is never revived. The provider is written first and the frozen row
+ * second, under the row's revision, so a run that dies between the two is completed by running it again. Bounded. */
+declare function retermMembershipDiscount(db: ChapterDb, stripeSecretKey: string, scope: MembershipEffectScope, input: MembershipRetermInput, now: number): Promise<MembershipRetermReceipt>;
+
 /** Reasons a purchased seat may be refunded. No reason is time-driven: an unaccepted seat waits for a person. */
 type NamedSeatRefundReason = "declined" | "operator" | "primary_closed" | "provider_refund";
 
@@ -2038,4 +2070,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 LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipEffectScope, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatOperatorRefundInput, type NamedSeatRefundReason, type NetworkTargetTransport, NetworkTargetTransportError, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterMembershipAccess, chapterWorker, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, refundNamedSeatByOperator, renderActiveSignupControlHtml, resolveNetworkTargetTransport, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, 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 NamedSeatOperatorRefundInput, type NamedSeatRefundReason, type NetworkTargetTransport, NetworkTargetTransportError, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterMembershipAccess, chapterWorker, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, refundNamedSeatByOperator, renderActiveSignupControlHtml, resolveNetworkTargetTransport, retermMembershipDiscount, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };

package/dist/worker/index.d.ts

@@ -56,7 +56,7 @@ interface ChapterCopy {
          * agree rather than merely restating the policy. Set it to an empty string
          * to render the checkbox with the policy as its only label.
          */
-        payment: TextFields<"setupFailed" | "preparing" | "pending" | "processing" | "payAndContinue" | "incomplete" | "consent" | "foundingMember" | "foundingDiscount">;
+        payment: TextFields<"setupFailed" | "preparing" | "pending" | "processing" | "payAndContinue" | "incomplete" | "consent" | "foundingMember" | "foundingDiscount" | "standardRate" | "yourRate">;
         done: TextFields<"label" | "calendarInvite" | "memberArea">;
         accepted: TextFields<"label" | "body">;
         gift: TextFields<"chooseSelf" | "optionsLabel" | "label" | "body" | "save" | "rotate" | "rotateFailed" | "claimTitle" | "claimBody" | "code" | "redeem" | "redeemed" | "redeemFailed">;
@@ -1414,6 +1414,38 @@ type NamedSeatOperatorRefundInput = MembershipQuoteTarget & {
  */
 declare function refundNamedSeatByOperator(db: ChapterDb, input: NamedSeatOperatorRefundInput, stripeSecretKey: string, now: number): Promise<NamedSeatRefundReceipt>;
 
+/** 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. */
+interface MembershipRetermReceipt {
+    policyVersionId: string;
+    retermed: {
+        membershipId: string;
+        previousPolicyVersionId?: string;
+        previousRenewalAmountCents: number;
+        renewalAmountCents: number;
+        providerUpdated: boolean;
+    }[];
+    /** Already frozen on this version; nothing was read from or written to the provider. */
+    unchanged: string[];
+    skipped: {
+        membershipId: string;
+        reason: MembershipRetermSkipReason;
+    }[];
+    more: boolean;
+}
+/** Which memberships to move: every member in scope (bounded), or the named ones. */
+interface MembershipRetermInput {
+    policyVersionId: string;
+    membershipIds?: string[];
+    limit?: number;
+}
+/** Move already-paid memberships onto a later discount policy version of the same cohort, so their next renewal carries
+ * its while-active benefit. Only ever widens: a version that would raise a member's renewal is skipped, and a lapsed,
+ * refunded, canceled, declined or restarting purchase is never revived. The provider is written first and the frozen row
+ * second, under the row's revision, so a run that dies between the two is completed by running it again. Bounded. */
+declare function retermMembershipDiscount(db: ChapterDb, stripeSecretKey: string, scope: MembershipEffectScope, input: MembershipRetermInput, now: number): Promise<MembershipRetermReceipt>;
+
 /** Reasons a purchased seat may be refunded. No reason is time-driven: an unaccepted seat waits for a person. */
 type NamedSeatRefundReason = "declined" | "operator" | "primary_closed" | "provider_refund";
 
@@ -2038,4 +2070,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 LeaderAdmissionAssignment, type LeaderAdmissionDelivery, type LeaderAdmissionDeliveryStatus, MEMBERSHIP_AUTHORITY_PATH, type MemberContentDeliveryOptions, type MembershipAuthorityHandlerOptions, type MembershipAuthorityPeer, type MembershipChapterEffect, type MembershipEffectScope, type MembershipWorkerAdapter, type MembershipWorkerAdapterOptions, type NamedSeatOperatorRefundInput, type NamedSeatRefundReason, type NetworkTargetTransport, NetworkTargetTransportError, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterMembershipAccess, chapterWorker, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, refundNamedSeatByOperator, renderActiveSignupControlHtml, resolveNetworkTargetTransport, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, AdmissionGrantDeliveryError, type AdmissionGrantDeliveryOptions, type BuilderLibraryDeliveryOptions, type ChapterEnv, type ChapterErrorRecorder, type ChapterErrorReport, type ChapterWorkerOptions, 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 NamedSeatOperatorRefundInput, type NamedSeatRefundReason, type NetworkTargetTransport, NetworkTargetTransportError, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterMembershipAccess, chapterWorker, createMembershipAuthorityHandler, createMembershipAuthorityStorage, createMembershipChapterEffectRoute, createMembershipWorkerAdapter, createWorkerContext, deliverAdmissionGrants, deliverBuilderLibrary, deliverMemberContent, deliverMembershipChapterEffect, deliverSignupControl, drainMembershipEffects, refundNamedSeatByOperator, renderActiveSignupControlHtml, resolveNetworkTargetTransport, retermMembershipDiscount, retryChapterApprovalEffects, retryLeaderAdmissionDeliveries, withActiveSignupControlTheme };