@odla-ai/chapter 0.54.1 → 0.55.0

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 {
@@ -820,6 +835,21 @@ interface SubscriptionBillingTerms {
     initialTermEndsAt?: number;
 }
 
+/** The optional recipient selected before the applicant consents to payment. */
+interface CheckoutNamedSeatSelection {
+    recipientName: string;
+    recipientEmail: string;
+}
+/** Authority-owned provider allocation for the seat on the initial subscription. */
+interface CheckoutNamedSeat extends CheckoutNamedSeatSelection {
+    purchaserEmail: string;
+    seatId: string;
+    membershipId: string;
+    recipientClaimId: string;
+    priceId: string;
+    amountCents: number;
+}
+
 /** Per-tier policy overrides prevent a chapter-wide price claim leaking into another SKU. */
 interface TierPaymentPolicy {
     refundPolicyText: string;
@@ -951,11 +981,15 @@ interface MembershipCheckoutBindingInput extends MembershipQuoteTarget {
     offerDigest: string;
     quoteDigest: string;
     priceId: string;
+    namedSeat?: CheckoutNamedSeatSelection & {
+        purchaserEmail: string;
+    };
 }
-/** Content-free authority receipt. It does not mean paid, approved, or entitled. */
+/** Frozen authority receipt, including any named recipient. It does not mean paid, approved, or entitled. */
 interface MembershipCheckoutBinding extends MembershipCheckoutBindingInput {
     id: string;
     boundAt: number;
+    namedSeat?: CheckoutNamedSeat;
 }
 
 /** References only. Money facts must already exist in the verified network Stripe event log. */

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 {
@@ -820,6 +835,21 @@ interface SubscriptionBillingTerms {
     initialTermEndsAt?: number;
 }
 
+/** The optional recipient selected before the applicant consents to payment. */
+interface CheckoutNamedSeatSelection {
+    recipientName: string;
+    recipientEmail: string;
+}
+/** Authority-owned provider allocation for the seat on the initial subscription. */
+interface CheckoutNamedSeat extends CheckoutNamedSeatSelection {
+    purchaserEmail: string;
+    seatId: string;
+    membershipId: string;
+    recipientClaimId: string;
+    priceId: string;
+    amountCents: number;
+}
+
 /** Per-tier policy overrides prevent a chapter-wide price claim leaking into another SKU. */
 interface TierPaymentPolicy {
     refundPolicyText: string;
@@ -951,11 +981,15 @@ interface MembershipCheckoutBindingInput extends MembershipQuoteTarget {
     offerDigest: string;
     quoteDigest: string;
     priceId: string;
+    namedSeat?: CheckoutNamedSeatSelection & {
+        purchaserEmail: string;
+    };
 }
-/** Content-free authority receipt. It does not mean paid, approved, or entitled. */
+/** Frozen authority receipt, including any named recipient. It does not mean paid, approved, or entitled. */
 interface MembershipCheckoutBinding extends MembershipCheckoutBindingInput {
     id: string;
     boundAt: number;
+    namedSeat?: CheckoutNamedSeat;
 }
 
 /** References only. Money facts must already exist in the verified network Stripe event log. */