@odla-ai/chapter 0.35.0 → 0.36.0

package/dist/worker/index.d.cts

@@ -43,18 +43,21 @@ interface ChapterCopy {
          */
         payment: TextFields<"setupFailed" | "preparing" | "pending" | "processing" | "payAndContinue" | "incomplete" | "consent">;
         done: TextFields<"label" | "calendarInvite" | "memberArea">;
+        accepted: TextFields<"label" | "body">;
+        gift: TextFields<"chooseSelf" | "optionsLabel" | "label" | "body" | "save" | "rotate" | "rotateFailed">;
     };
     members: {
         loadFailed: string;
         account: TextFields<"signOut" | "adminConsole">;
         provisional: TextFields<"cardLabel" | "applicationNeeded" | "applicationNeededBody" | "apply" | "refunded" | "refundedBody" | "active" | "renews" | "introductionCall" | "calendarInvite" | "joinCall" | "bookCall" | "bookCallBody" | "chooseTime">;
         full: TextFields<"welcome">;
+        gifts: TextFields<"title" | "body" | "noneAvailable" | "paid" | "saveCode" | "purchases" | "noPurchases" | "pending" | "redeemed" | "expired" | "revoked" | "rotate" | "rotated" | "rotateFailed" | "redeemTitle" | "code" | "redeem" | "redeemFailed">;
         reschedule: TextFields<"changeTime" | "unavailable" | "loadFailed" | "slotGone" | "loading" | "noTimes" | "rescheduling" | "keepTime">;
     };
     admin: {
         auth: TextFields<"checking" | "notAuthorized" | "accountNotAuthorized" | "thisAccount" | "signOut" | "loading" | "signInNotConfigured" | "missingPublishableKey" | "noWorkspaces" | "signInTagline">;
         shell: TextFields<"adminRole" | "adminConsole" | "adminName" | "navigationLabel">;
-        workspaces: TextFields<"dashboard" | "overview" | "billing" | "people" | "network" | "portfolio" | "settings" | "calendar" | "email" | "chapters" | "formations" | "dealFlow" | "dashboardViewsLabel" | "settingsViewsLabel" | "collectionsLabel" | "portfolioViewsLabel">;
+        workspaces: TextFields<"dashboard" | "overview" | "billing" | "people" | "admission" | "network" | "portfolio" | "settings" | "calendar" | "email" | "chapters" | "formations" | "dealFlow" | "dashboardViewsLabel" | "settingsViewsLabel" | "collectionsLabel" | "portfolioViewsLabel">;
         dashboard: TextFields<"loading" | "loadFailed" | "upcomingCalls" | "callsNeedAttention" | "noUpcomingCalls" | "drift" | "open" | "meet" | "applications" | "newMembers" | "newMembersUnavailable" | "revenueAdded" | "revenue" | "revenueUnavailable" | "pipeline" | "pipelineLabel" | "thisWeek" | "noChange" | "activeMemberships" | "annualRunRate" | "testMode">;
         billing: TextFields<"loading" | "loadFailed" | "notConfigured" | "active" | "annualized" | "renewingSoon" | "pastDue" | "subscriptions" | "testMode" | "truncated" | "name" | "email" | "application" | "subscription" | "cancelling" | "amount" | "renews">;
         availability: TextFields<"loading" | "loadFailed" | "saved" | "title" | "days" | "startHour" | "endHour" | "slotMinutes" | "minNoticeHours" | "windowDays" | "timezone" | "summaryTemplate" | "save"> & {
@@ -62,6 +65,7 @@ interface ChapterCopy {
         };
         email: TextFields<"loading" | "loadFailed" | "saved" | "sent" | "testFailed" | "delivery" | "notificationAddress" | "replyTo" | "debugInbox" | "debugInboxHint" | "sendTest" | "enabled" | "subject" | "body" | "save" | "sendLog" | "sentColumn" | "templateColumn" | "statusColumn" | "toColumn" | "failed" | "redirected" | "delivered">;
         meetings: TextFields<"loading" | "loadFailed" | "cancelConfirm" | "newStartPrompt" | "parseFailed" | "agenda" | "empty" | "unknown" | "drift" | "meet" | "reschedule" | "cancel">;
+        admission: TextFields<"title" | "description" | "email" | "decision" | "expires" | "note" | "waive" | "require" | "add" | "ledger" | "loading" | "consumed" | "revoked" | "expired" | "active" | "local" | "parent" | "revoke">;
         network: AdminNetworkCopy;
         records: TextFields<"workflowMissing" | "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">;
     };
@@ -251,6 +255,13 @@ interface ChapterDb {
         value: string | number | boolean;
     }>[], opts?: {
         mutationId?: string;
+        guards?: Array<{
+            ns: string;
+            id: string;
+            exists: boolean;
+            equals?: Record<string, unknown>;
+            absent?: string[];
+        }>;
     }): Promise<{
         txId: number;
         duplicate: boolean;
@@ -259,7 +270,7 @@ interface ChapterDb {
         get(name: string): Promise<string>;
     };
 }
-/** The scalar kinds an odla-db attribute can hold. */
+/** Scalar kinds accepted by the Chapter schema adapter. */
 type AttrType = "string" | "number" | "boolean" | "json";
 /** One odla-db attribute: its type and index/uniqueness/optionality flags. */
 interface Attr {
@@ -759,6 +770,37 @@ interface MembershipPageDocument {
     footnoteMarkdown?: string;
 }
 
+/** Current nested gift-catalog version inside signup-control. */
+declare const GIFT_OFFER_CATALOG_VERSION: 1;
+/** Membership tier or standalone entitlement fulfilled by redemption. */
+type GiftOfferTarget = {
+    type: "tier";
+    tierId: string;
+} | {
+    type: "entitlement";
+    entitlementKey: string;
+};
+/** Server-authored gift SKU; provider identifiers never reach public config. */
+interface GiftOffer {
+    id: string;
+    target: GiftOfferTarget;
+    billingMode: "one_time" | "subscription";
+    stripePriceId: string;
+    priceCents: number;
+    currency: string;
+    redemptionLifetimeHours: number;
+    activeFrom?: number;
+    activeUntil?: number;
+    title: string;
+    description: string;
+    ctaLabel: string;
+}
+/** Versioned bounded collection delegated through signed signup control. */
+interface GiftOfferCatalog {
+    schemaVersion: typeof GIFT_OFFER_CATALOG_VERSION;
+    offers: readonly GiftOffer[];
+}
+
 /** Current wire-format version for complete signup-control documents. */
 declare const SIGNUP_CONTROL_SCHEMA_VERSION: 1;
 /** One authoritative membership tier in a signup-control revision. */
@@ -810,6 +852,7 @@ interface SignupControlDocument {
     policy?: SignupControlPolicy;
     scheduling?: ChapterScheduling;
     theme?: SignupControlTheme;
+    giftOffers?: GiftOfferCatalog;
 }
 /** Digest travels beside the document so the exact desired state is attestable. */
 interface SignupControlEnvelope {
@@ -840,6 +883,62 @@ interface SignupControlDeliveryOptions {
 /** Build and send one signed desired-state delivery. Durable retry belongs to the hub outbox. */
 declare function deliverSignupControl(options: SignupControlDeliveryOptions): Promise<SignupControlReceipt>;
 
+/** Current wire version for parent-authored admission decisions. */
+declare const ADMISSION_GRANTS_SCHEMA_VERSION: 1;
+/** Whether an exact email can skip or must retain the Chapter interview. */
+type AdmissionDecision = "waive_interview" | "require_interview";
+/** One bounded admission decision. Email is PII and never enters public config. */
+interface AdmissionGrantInput {
+    id: string;
+    email: string;
+    decision: AdmissionDecision;
+    note?: string;
+    expiresAt?: number;
+}
+/** Complete desired Parent state for one Chapter and environment. */
+interface AdmissionGrantDocument {
+    schemaVersion: typeof ADMISSION_GRANTS_SCHEMA_VERSION;
+    revision: number;
+    generatedAt: number;
+    source: {
+        appId: string;
+        actor: string;
+    };
+    target: {
+        chapterId: string;
+        environment: string;
+    };
+    grants: readonly AdmissionGrantInput[];
+}
+/** Canonical desired-state document paired with its integrity digest. */
+interface AdmissionGrantEnvelope {
+    digest: string;
+    document: AdmissionGrantDocument;
+}
+/** Chapter acknowledgement for an accepted or idempotently replayed revision. */
+interface AdmissionGrantReceipt {
+    ok: true;
+    target: {
+        chapterId: string;
+        environment: string;
+    };
+    revision: number;
+    digest: string;
+    status: "accepted" | "replayed";
+    acknowledgedAt: number;
+}
+
+/** Inputs required to sign and deliver one Parent admission revision. */
+interface AdmissionGrantDeliveryOptions {
+    secret: string;
+    sender: string;
+    targetUrl: string | URL;
+    envelope: AdmissionGrantEnvelope;
+    fetch?: typeof globalThis.fetch;
+}
+/** Deliver one signed Parent admission revision. Durable retry belongs upstream. */
+declare function deliverAdmissionGrants(options: AdmissionGrantDeliveryOptions): Promise<AdmissionGrantReceipt>;
+
 /** Identity shared by initial HTML, response caching, and client hydration. */
 interface SignupControlThemeMetadata {
     source: "active" | "bootstrap";
@@ -910,4 +1009,4 @@ declare function chapterWorker(options: ChapterWorkerOptions): {
     fetch(req: Request, env: ChapterEnv): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type ChapterEnv, type ChapterWorkerOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type AdmissionGrantDeliveryOptions, type ChapterEnv, type ChapterWorkerOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverAdmissionGrants, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };

package/dist/worker/index.d.ts

@@ -43,18 +43,21 @@ interface ChapterCopy {
          */
         payment: TextFields<"setupFailed" | "preparing" | "pending" | "processing" | "payAndContinue" | "incomplete" | "consent">;
         done: TextFields<"label" | "calendarInvite" | "memberArea">;
+        accepted: TextFields<"label" | "body">;
+        gift: TextFields<"chooseSelf" | "optionsLabel" | "label" | "body" | "save" | "rotate" | "rotateFailed">;
     };
     members: {
         loadFailed: string;
         account: TextFields<"signOut" | "adminConsole">;
         provisional: TextFields<"cardLabel" | "applicationNeeded" | "applicationNeededBody" | "apply" | "refunded" | "refundedBody" | "active" | "renews" | "introductionCall" | "calendarInvite" | "joinCall" | "bookCall" | "bookCallBody" | "chooseTime">;
         full: TextFields<"welcome">;
+        gifts: TextFields<"title" | "body" | "noneAvailable" | "paid" | "saveCode" | "purchases" | "noPurchases" | "pending" | "redeemed" | "expired" | "revoked" | "rotate" | "rotated" | "rotateFailed" | "redeemTitle" | "code" | "redeem" | "redeemFailed">;
         reschedule: TextFields<"changeTime" | "unavailable" | "loadFailed" | "slotGone" | "loading" | "noTimes" | "rescheduling" | "keepTime">;
     };
     admin: {
         auth: TextFields<"checking" | "notAuthorized" | "accountNotAuthorized" | "thisAccount" | "signOut" | "loading" | "signInNotConfigured" | "missingPublishableKey" | "noWorkspaces" | "signInTagline">;
         shell: TextFields<"adminRole" | "adminConsole" | "adminName" | "navigationLabel">;
-        workspaces: TextFields<"dashboard" | "overview" | "billing" | "people" | "network" | "portfolio" | "settings" | "calendar" | "email" | "chapters" | "formations" | "dealFlow" | "dashboardViewsLabel" | "settingsViewsLabel" | "collectionsLabel" | "portfolioViewsLabel">;
+        workspaces: TextFields<"dashboard" | "overview" | "billing" | "people" | "admission" | "network" | "portfolio" | "settings" | "calendar" | "email" | "chapters" | "formations" | "dealFlow" | "dashboardViewsLabel" | "settingsViewsLabel" | "collectionsLabel" | "portfolioViewsLabel">;
         dashboard: TextFields<"loading" | "loadFailed" | "upcomingCalls" | "callsNeedAttention" | "noUpcomingCalls" | "drift" | "open" | "meet" | "applications" | "newMembers" | "newMembersUnavailable" | "revenueAdded" | "revenue" | "revenueUnavailable" | "pipeline" | "pipelineLabel" | "thisWeek" | "noChange" | "activeMemberships" | "annualRunRate" | "testMode">;
         billing: TextFields<"loading" | "loadFailed" | "notConfigured" | "active" | "annualized" | "renewingSoon" | "pastDue" | "subscriptions" | "testMode" | "truncated" | "name" | "email" | "application" | "subscription" | "cancelling" | "amount" | "renews">;
         availability: TextFields<"loading" | "loadFailed" | "saved" | "title" | "days" | "startHour" | "endHour" | "slotMinutes" | "minNoticeHours" | "windowDays" | "timezone" | "summaryTemplate" | "save"> & {
@@ -62,6 +65,7 @@ interface ChapterCopy {
         };
         email: TextFields<"loading" | "loadFailed" | "saved" | "sent" | "testFailed" | "delivery" | "notificationAddress" | "replyTo" | "debugInbox" | "debugInboxHint" | "sendTest" | "enabled" | "subject" | "body" | "save" | "sendLog" | "sentColumn" | "templateColumn" | "statusColumn" | "toColumn" | "failed" | "redirected" | "delivered">;
         meetings: TextFields<"loading" | "loadFailed" | "cancelConfirm" | "newStartPrompt" | "parseFailed" | "agenda" | "empty" | "unknown" | "drift" | "meet" | "reschedule" | "cancel">;
+        admission: TextFields<"title" | "description" | "email" | "decision" | "expires" | "note" | "waive" | "require" | "add" | "ledger" | "loading" | "consumed" | "revoked" | "expired" | "active" | "local" | "parent" | "revoke">;
         network: AdminNetworkCopy;
         records: TextFields<"workflowMissing" | "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">;
     };
@@ -251,6 +255,13 @@ interface ChapterDb {
         value: string | number | boolean;
     }>[], opts?: {
         mutationId?: string;
+        guards?: Array<{
+            ns: string;
+            id: string;
+            exists: boolean;
+            equals?: Record<string, unknown>;
+            absent?: string[];
+        }>;
     }): Promise<{
         txId: number;
         duplicate: boolean;
@@ -259,7 +270,7 @@ interface ChapterDb {
         get(name: string): Promise<string>;
     };
 }
-/** The scalar kinds an odla-db attribute can hold. */
+/** Scalar kinds accepted by the Chapter schema adapter. */
 type AttrType = "string" | "number" | "boolean" | "json";
 /** One odla-db attribute: its type and index/uniqueness/optionality flags. */
 interface Attr {
@@ -759,6 +770,37 @@ interface MembershipPageDocument {
     footnoteMarkdown?: string;
 }
 
+/** Current nested gift-catalog version inside signup-control. */
+declare const GIFT_OFFER_CATALOG_VERSION: 1;
+/** Membership tier or standalone entitlement fulfilled by redemption. */
+type GiftOfferTarget = {
+    type: "tier";
+    tierId: string;
+} | {
+    type: "entitlement";
+    entitlementKey: string;
+};
+/** Server-authored gift SKU; provider identifiers never reach public config. */
+interface GiftOffer {
+    id: string;
+    target: GiftOfferTarget;
+    billingMode: "one_time" | "subscription";
+    stripePriceId: string;
+    priceCents: number;
+    currency: string;
+    redemptionLifetimeHours: number;
+    activeFrom?: number;
+    activeUntil?: number;
+    title: string;
+    description: string;
+    ctaLabel: string;
+}
+/** Versioned bounded collection delegated through signed signup control. */
+interface GiftOfferCatalog {
+    schemaVersion: typeof GIFT_OFFER_CATALOG_VERSION;
+    offers: readonly GiftOffer[];
+}
+
 /** Current wire-format version for complete signup-control documents. */
 declare const SIGNUP_CONTROL_SCHEMA_VERSION: 1;
 /** One authoritative membership tier in a signup-control revision. */
@@ -810,6 +852,7 @@ interface SignupControlDocument {
     policy?: SignupControlPolicy;
     scheduling?: ChapterScheduling;
     theme?: SignupControlTheme;
+    giftOffers?: GiftOfferCatalog;
 }
 /** Digest travels beside the document so the exact desired state is attestable. */
 interface SignupControlEnvelope {
@@ -840,6 +883,62 @@ interface SignupControlDeliveryOptions {
 /** Build and send one signed desired-state delivery. Durable retry belongs to the hub outbox. */
 declare function deliverSignupControl(options: SignupControlDeliveryOptions): Promise<SignupControlReceipt>;
 
+/** Current wire version for parent-authored admission decisions. */
+declare const ADMISSION_GRANTS_SCHEMA_VERSION: 1;
+/** Whether an exact email can skip or must retain the Chapter interview. */
+type AdmissionDecision = "waive_interview" | "require_interview";
+/** One bounded admission decision. Email is PII and never enters public config. */
+interface AdmissionGrantInput {
+    id: string;
+    email: string;
+    decision: AdmissionDecision;
+    note?: string;
+    expiresAt?: number;
+}
+/** Complete desired Parent state for one Chapter and environment. */
+interface AdmissionGrantDocument {
+    schemaVersion: typeof ADMISSION_GRANTS_SCHEMA_VERSION;
+    revision: number;
+    generatedAt: number;
+    source: {
+        appId: string;
+        actor: string;
+    };
+    target: {
+        chapterId: string;
+        environment: string;
+    };
+    grants: readonly AdmissionGrantInput[];
+}
+/** Canonical desired-state document paired with its integrity digest. */
+interface AdmissionGrantEnvelope {
+    digest: string;
+    document: AdmissionGrantDocument;
+}
+/** Chapter acknowledgement for an accepted or idempotently replayed revision. */
+interface AdmissionGrantReceipt {
+    ok: true;
+    target: {
+        chapterId: string;
+        environment: string;
+    };
+    revision: number;
+    digest: string;
+    status: "accepted" | "replayed";
+    acknowledgedAt: number;
+}
+
+/** Inputs required to sign and deliver one Parent admission revision. */
+interface AdmissionGrantDeliveryOptions {
+    secret: string;
+    sender: string;
+    targetUrl: string | URL;
+    envelope: AdmissionGrantEnvelope;
+    fetch?: typeof globalThis.fetch;
+}
+/** Deliver one signed Parent admission revision. Durable retry belongs upstream. */
+declare function deliverAdmissionGrants(options: AdmissionGrantDeliveryOptions): Promise<AdmissionGrantReceipt>;
+
 /** Identity shared by initial HTML, response caching, and client hydration. */
 interface SignupControlThemeMetadata {
     source: "active" | "bootstrap";
@@ -910,4 +1009,4 @@ declare function chapterWorker(options: ChapterWorkerOptions): {
     fetch(req: Request, env: ChapterEnv): Promise<Response>;
 };
 
-export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type ChapterEnv, type ChapterWorkerOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };
+export { type ActiveSignupControlHtml, type ActiveSignupControlThemeOptions, type AdmissionGrantDeliveryOptions, type ChapterEnv, type ChapterWorkerOptions, type Route, type SignupControlDeliveryOptions, type WorkerContext, chapterWorker, createWorkerContext, deliverAdmissionGrants, deliverSignupControl, renderActiveSignupControlHtml, withActiveSignupControlTheme };