@odla-ai/chapter 0.54.0 → 0.54.2

package/dist/worker/index.d.cts

@@ -21,6 +21,18 @@ interface ChapterTierConfig {
     active?: boolean;
 }
 
+/** A code-declared mail event. Copy stays in settings; this describes who receives it and the values the event supplies. */
+interface ChapterEmailEvent {
+    label: string;
+    trigger: string;
+    audience: string;
+    variables: readonly string[];
+    /** Values deliberately allowed to render empty, such as a free tier's amount suffix. */
+    optionalVariables?: readonly string[];
+    /** Require a resolved tier display name even when the copy does not mention it. */
+    requiresTier?: boolean;
+}
+
 type TextFields$1<Key extends string> = {
     [Field in Key]: string;
 };
@@ -509,7 +521,7 @@ interface ChapterBrand {
     logos?: string;
 }
 
-/** One owner-editable transactional email template. */
+/** One owner-editable transactional email template. Automatic sends require explicit `enabled: true`. */
 interface EmailTemplate {
     subject: string;
     text: string;
@@ -524,8 +536,11 @@ interface ChapterEmails {
     fromName?: string;
     debugEmail?: string;
     /** Operational lifecycle templates: adminNotification / submitConfirmation /
-     * paymentConfirmation / prepEmail / onboardingInvite, each `{ subject, text, enabled? }`. */
+     * paymentConfirmation / prepEmail / onboardingInvite / namedSeatInvitation / seatAccepted,
+     * plus declared host events. Missing enabled flags block sending. */
     templates?: Record<string, EmailTemplate>;
+    /** Additional host-owned email events shown and validated in the email editor. Declaring an event never sends it. */
+    events?: Record<string, ChapterEmailEvent>;
 }
 /** Booking rules for the intro-call scheduler (stored as schedulingJson). */
 interface ChapterScheduling {
@@ -1524,6 +1539,14 @@ interface SeatRepriceReceipt {
  * each row is fenced by revision. */
 declare function lowerSeatPrice(db: ChapterDb, scope: SeatRepriceScope, now: number, limit?: number): Promise<SeatRepriceReceipt>;
 
+/** Remove the seat purchase window from memberships already frozen with one, so an existing member may buy a
+ * seat for as long as the membership stays paid. Only widens: the frozen offering keeps every other term, and
+ * a membership already without a window is untouched. Bounded and repeatable; each row is fenced by revision. */
+declare function liftSeatPurchaseWindow(db: ChapterDb, scope: MembershipEffectScope, now: number, limit?: number): Promise<{
+    lifted: number;
+    more: boolean;
+}>;
+
 type Row = Record<string, unknown>;
 /** Host routes may reuse this gate after resolving a verified chapter/runtime account. */
 declare function chapterMembershipAccess(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, app: Row): Promise<boolean>;
@@ -2145,4 +2168,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, 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, 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 };

package/dist/worker/index.d.ts

@@ -21,6 +21,18 @@ interface ChapterTierConfig {
     active?: boolean;
 }
 
+/** A code-declared mail event. Copy stays in settings; this describes who receives it and the values the event supplies. */
+interface ChapterEmailEvent {
+    label: string;
+    trigger: string;
+    audience: string;
+    variables: readonly string[];
+    /** Values deliberately allowed to render empty, such as a free tier's amount suffix. */
+    optionalVariables?: readonly string[];
+    /** Require a resolved tier display name even when the copy does not mention it. */
+    requiresTier?: boolean;
+}
+
 type TextFields$1<Key extends string> = {
     [Field in Key]: string;
 };
@@ -509,7 +521,7 @@ interface ChapterBrand {
     logos?: string;
 }
 
-/** One owner-editable transactional email template. */
+/** One owner-editable transactional email template. Automatic sends require explicit `enabled: true`. */
 interface EmailTemplate {
     subject: string;
     text: string;
@@ -524,8 +536,11 @@ interface ChapterEmails {
     fromName?: string;
     debugEmail?: string;
     /** Operational lifecycle templates: adminNotification / submitConfirmation /
-     * paymentConfirmation / prepEmail / onboardingInvite, each `{ subject, text, enabled? }`. */
+     * paymentConfirmation / prepEmail / onboardingInvite / namedSeatInvitation / seatAccepted,
+     * plus declared host events. Missing enabled flags block sending. */
     templates?: Record<string, EmailTemplate>;
+    /** Additional host-owned email events shown and validated in the email editor. Declaring an event never sends it. */
+    events?: Record<string, ChapterEmailEvent>;
 }
 /** Booking rules for the intro-call scheduler (stored as schedulingJson). */
 interface ChapterScheduling {
@@ -1524,6 +1539,14 @@ interface SeatRepriceReceipt {
  * each row is fenced by revision. */
 declare function lowerSeatPrice(db: ChapterDb, scope: SeatRepriceScope, now: number, limit?: number): Promise<SeatRepriceReceipt>;
 
+/** Remove the seat purchase window from memberships already frozen with one, so an existing member may buy a
+ * seat for as long as the membership stays paid. Only widens: the frozen offering keeps every other term, and
+ * a membership already without a window is untouched. Bounded and repeatable; each row is fenced by revision. */
+declare function liftSeatPurchaseWindow(db: ChapterDb, scope: MembershipEffectScope, now: number, limit?: number): Promise<{
+    lifted: number;
+    more: boolean;
+}>;
+
 type Row = Record<string, unknown>;
 /** Host routes may reuse this gate after resolving a verified chapter/runtime account. */
 declare function chapterMembershipAccess(db: ChapterDb, env: ChapterEnv, ctx: WorkerContext, app: Row): Promise<boolean>;
@@ -2145,4 +2168,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, 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, 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 };