@odla-ai/chapter 0.61.0 → 0.63.0

package/dist/worker/index.d.cts

@@ -61,11 +61,30 @@ interface ChapterEmailEvent {
     requiresTier?: boolean;
 }
 
-type TextFields$1<Key extends string> = {
+type TextFields$2<Key extends string> = {
     [Field in Key]: string;
 };
 /** User-visible language for sharing, delivery state, and leader rollups. */
-type AdminNetworkCopy = TextFields$1<"title" | "allowlistDescription" | "sharing" | "shareWith" | "shared" | "shareFailed" | "deliveryFailed" | "loadingRollup" | "loadRollupFailed" | "overview" | "configuredFollowers" | "reachableFollowers" | "recordsAcrossFollowers" | "noFollowers" | "followers" | "available" | "unavailable" | "transportReachable" | "transportUnavailable" | "transportNotChecked" | "edgeUnpaired" | "edgeUnpairedHint" | "bindingTransport" | "urlTransport" | "activeConfiguration" | "noActiveConfiguration" | "publicSiteAvailable" | "publicSiteUnavailable" | "publicSiteNotChecked" | "recordTotals" | "noRecordTotals">;
+type AdminNetworkCopy = TextFields$2<"title" | "allowlistDescription" | "sharing" | "shareWith" | "shared" | "shareFailed" | "deliveryFailed" | "loadingRollup" | "loadRollupFailed" | "overview" | "configuredFollowers" | "reachableFollowers" | "recordsAcrossFollowers" | "noFollowers" | "followers" | "available" | "unavailable" | "transportReachable" | "transportUnavailable" | "transportNotChecked" | "edgeUnpaired" | "edgeUnpairedHint" | "bindingTransport" | "urlTransport" | "activeConfiguration" | "noActiveConfiguration" | "publicSiteAvailable" | "publicSiteUnavailable" | "publicSiteNotChecked" | "recordTotals" | "noRecordTotals">;
+
+type TextFields$1<Key extends string> = {
+    [Field in Key]: string;
+};
+/**
+ * Member portal language. Placeholders in braces are filled by
+ * `formatChapterCopy()`. Sites override any field through `copy.portal`.
+ */
+interface PortalCopy {
+    shell: TextFields$1<"navLabel" | "welcomeBack" | "home" | "backHome" | "yourProfile" | "signedInAs" | "signOut" | "adminConsole" | "openMenu" | "closeMenu" | "locked" | "loading" | "loadFailed" | "notFound">;
+    pages: TextFields$1<"comingSoon" | "comingIn" | "includedWith" | "upgrade" | "comingToPortal" | "tagNew" | "tagSoon">;
+    profile: TextFields$1<"eyebrow" | "editProfile" | "saveProfile" | "saving" | "cancel" | "uploadPhoto" | "changePhoto" | "photoUploading" | "photoFailed" | "memberSince" | "promptsTitle" | "promptsNote" | "answerEmpty" | "addPrompt" | "howYouFoundUs" | "referredBy" | "referredByNote" | "introducedBy" | "introducedByPlaceholder" | "namePlaceholder" | "locationPlaceholder" | "saved" | "conflict" | "saveFailed">;
+    /** Invitations and referrals. Templates take {tierName}, {article}, {inviteUrl}, {firstName}, {location}, {credit}. */
+    share: TextFields$1<"eyebrow" | "intro" | "officialTitle" | "officialBody" | "showMeHow" | "stepsEyebrow" | "openLinkedIn" | "copyDescription" | "linkedinDescription" | "postTitle" | "postBody" | "shareOnLinkedIn" | "previewPost" | "linkedinPost" | "linkTitle" | "linkBody" | "linkCredit" | "referralsCredit" | "copyLink" | "copied" | "copyBlocked" | "emailInvite" | "textInvite" | "inviteNote" | "emailSubject" | "emailBody" | "textBody" | "fallbackEmail" | "fallbackText" | "copyMessage" | "close" | "referralsTitle" | "referralsBody" | "inviteFriend" | "joined" | "inProcess" | "offNextYear" | "joinedWith"> & {
+        steps: string[];
+    };
+    /** The cohort course page and Home panel. Templates take {left}, {capacity}, {position}, {count}. */
+    course: TextFields$1<"eyebrow" | "reserve" | "seeDetails" | "courseDetails" | "youreIn" | "invitesOnWay" | "openMeet" | "giveUp" | "confirmGiveUp" | "joinWaitlist" | "onWaitlist" | "leaveWaitlist" | "seatsOpen" | "full" | "closed" | "when" | "dates" | "where" | "seats" | "googleMeet" | "inviteEvery" | "guidesTitle" | "sessionsTitle" | "materialsOpen" | "materialsLocked" | "items" | "outcomesTitle" | "toolkitTitle" | "timeTitle" | "open" | "read" | "do" | "watch" | "extra" | "failed" | "reserveYourSeat">;
+}
 
 /** Copy for the person record panels: lifecycle actions, comms, scheduling, billing and meetings. */
 type AdminRecordsCopy = {
@@ -108,11 +127,13 @@ interface ChapterCopy {
     members: {
         loadFailed: string;
         account: TextFields<"signOut" | "adminConsole">;
-        provisional: TextFields<"cardLabel" | "applicationNeeded" | "applicationNeededBody" | "apply" | "refunded" | "refundedBody" | "active" | "renews" | "introductionCall" | "calendarInvite" | "joinCall" | "bookCall" | "bookCallBody" | "chooseTime">;
+        provisional: TextFields<"cardLabel" | "applicationNeeded" | "applicationNeededBody" | "apply" | "refunded" | "refundedBody" | "declined" | "declinedBody" | "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">;
     };
+    /** Signed-in member portal: shell, pages, profile. */
+    portal: PortalCopy;
     admin: {
         auth: TextFields<"checking" | "notAuthorized" | "accountNotAuthorized" | "thisAccount" | "signOut" | "loading" | "signInNotConfigured" | "missingPublishableKey" | "noWorkspaces" | "signInTagline">;
         shell: TextFields<"adminRole" | "adminConsole" | "adminName" | "navigationLabel">;
@@ -175,6 +196,51 @@ interface ResolvedMemberContent {
     } | null;
 }
 
+/** Invite links and referral credit for a chapter-mode site. */
+interface ChapterMemberReferrals {
+    /** Public path that invite links live under; `<path>/<code>`. Defaults to `/join`. */
+    path?: string;
+    /** Where an invite link sends a visitor (absolute https URL or site path). `?ref=<code>` is appended. */
+    membershipUrl: string;
+    /** Lifetime of the first-party referral cookie, in days. Defaults to 90. */
+    cookieDays?: number;
+    /**
+     * Credit a dues-paying referrer earns when a friend they referred is approved
+     * on a dues-paying tier. Omit or `false` for invite links without credit.
+     */
+    credit?: {
+        valueCents: number;
+    } | false;
+}
+/** The signed-in member portal. Its navigation and access come from the member-content catalog. */
+interface ChapterMemberPortal {
+    /** Prompts a member may answer on their profile, in display order. */
+    profilePrompts?: readonly string[];
+    /** How many prompts a member may answer. Defaults to 3. */
+    maxPrompts?: number;
+    /** Member profile photos in odla-db file storage. Defaults to true. */
+    photos?: boolean;
+    /** Cohort courses on one recurring Google Calendar event. Chapter mode only. */
+    courses?: boolean;
+    /** Personal invite links, Referred by, and optional credit. Chapter mode only. */
+    referrals?: ChapterMemberReferrals;
+}
+/** Resolved invite-link settings. */
+interface ResolvedMemberReferrals {
+    path: string;
+    membershipUrl: string;
+    cookieDays: number;
+    creditCents: number | null;
+}
+/** Resolved member portal settings. */
+interface ResolvedMemberPortal {
+    profilePrompts: readonly string[];
+    maxPrompts: number;
+    photos: boolean;
+    courses: boolean;
+    referrals: ResolvedMemberReferrals | null;
+}
+
 /** Optional private Builder Library shared across Built Not Found and Chapters. */
 interface ChapterBuilderLibrary {
     /** Keep local admin authoring enabled. Defaults to true. */
@@ -391,6 +457,82 @@ interface ResolvedNetwork {
     readers: readonly ResolvedNetworkReader[];
 }
 
+/** Brand identity and build-time tokens from the checked-in Chapter config. */
+/** Typed semantic roles shared by the public site and application surfaces. */
+interface ChapterBrandTokens {
+    background?: string;
+    surface?: string;
+    surface2?: string;
+    text?: string;
+    textMuted?: string;
+    textFaint?: string;
+    border?: string;
+    borderStrong?: string;
+    accent?: string;
+    accentStrong?: string;
+    accentSoft?: string;
+    onAccent?: string;
+    good?: string;
+    warn?: string;
+    danger?: string;
+    chart1?: string;
+    chart2?: string;
+    chart3?: string;
+    chart4?: string;
+    chart5?: string;
+    chart6?: string;
+    chartPositive?: string;
+    chartNegative?: string;
+    /** Admin/application content width, e.g. `"960px"`. */
+    contentWidth?: string;
+    panelRadius?: string;
+    panelShadow?: string;
+    masterDetailColumns?: string;
+    masterDetailMinHeight?: string;
+    /** Chapter-admin page padding shorthand. */
+    pagePadding?: string;
+    /** Chapter-admin workspace-tab padding shorthand. */
+    workspacePadding?: string;
+}
+/** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
+interface ChapterBrand {
+    /** Preloaded @odla-ai/ui theme name used by ThemeScope. */
+    theme?: string;
+    /** Named accent family supplied by the selected @odla-ai/ui theme. */
+    accent?: string;
+    /** Admin/application color mode. Explicit light is the safe default. */
+    colorScheme?: "light" | "dark" | "system";
+    tokens?: ChapterBrandTokens;
+    tokensDark?: ChapterBrandTokens;
+    /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
+     * or `--ui-*` token names). Applies in BOTH light and dark unless overridden
+     * by {@link paletteDark}. */
+    palette?: Record<string, string>;
+    /** Dark-mode palette overrides. Same shape as {@link palette}; emitted under
+     *  `:root[data-theme="dark"]` and `@media (prefers-color-scheme: dark)`, so a
+     *  site brands both modes. */
+    paletteDark?: Record<string, string>;
+    /** Full token map for `.ui-invert` islands. A compiled custom theme normally
+     * uses its dark map here so inverted content never inherits stale composites. */
+    paletteInvert?: Record<string, string>;
+    fonts?: {
+        display?: string;
+        body?: string;
+        numeral?: string;
+    };
+    /** Short glyph used in compact admin chrome. Defaults to the first three
+     * letters of the chapter name. */
+    badge?: string;
+    wordmark?: string;
+    tagline?: string;
+    /** Header/footer nav sections for the web-component chrome: label → entries. */
+    nav?: Record<string, ReadonlyArray<{
+        label: string;
+        href: string;
+    }>>;
+    logos?: string;
+}
+
 /**
  * Membership pricing for the group row (chapter mode).
  *
@@ -477,80 +619,18 @@ interface ChapterDb {
     secrets: {
         get(name: string): Promise<string>;
     };
-}
-/** Typed semantic roles shared by the public site and application surfaces. */
-interface ChapterBrandTokens {
-    background?: string;
-    surface?: string;
-    surface2?: string;
-    text?: string;
-    textMuted?: string;
-    textFaint?: string;
-    border?: string;
-    borderStrong?: string;
-    accent?: string;
-    accentStrong?: string;
-    accentSoft?: string;
-    onAccent?: string;
-    good?: string;
-    warn?: string;
-    danger?: string;
-    chart1?: string;
-    chart2?: string;
-    chart3?: string;
-    chart4?: string;
-    chart5?: string;
-    chart6?: string;
-    chartPositive?: string;
-    chartNegative?: string;
-    /** Admin/application content width, e.g. `"960px"`. */
-    contentWidth?: string;
-    panelRadius?: string;
-    panelShadow?: string;
-    masterDetailColumns?: string;
-    masterDetailMinHeight?: string;
-    /** Chapter-admin page padding shorthand. */
-    pagePadding?: string;
-    /** Chapter-admin workspace-tab padding shorthand. */
-    workspacePadding?: string;
-}
-/** Brand tokens that theme the site: theme, semantic roles, fonts, and logos. */
-interface ChapterBrand {
-    /** Preloaded @odla-ai/ui theme name used by ThemeScope. */
-    theme?: string;
-    /** Named accent family supplied by the selected @odla-ai/ui theme. */
-    accent?: string;
-    /** Admin/application color mode. Explicit light is the safe default. */
-    colorScheme?: "light" | "dark" | "system";
-    tokens?: ChapterBrandTokens;
-    tokensDark?: ChapterBrandTokens;
-    /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
-     * or `--ui-*` token names). Applies in BOTH light and dark unless overridden
-     * by {@link paletteDark}. */
-    palette?: Record<string, string>;
-    /** Dark-mode palette overrides. Same shape as {@link palette}; emitted under
-     *  `:root[data-theme="dark"]` and `@media (prefers-color-scheme: dark)`, so a
-     *  site brands both modes. */
-    paletteDark?: Record<string, string>;
-    /** Full token map for `.ui-invert` islands. A compiled custom theme normally
-     * uses its dark map here so inverted content never inherits stale composites. */
-    paletteInvert?: Record<string, string>;
-    fonts?: {
-        display?: string;
-        body?: string;
-        numeral?: string;
+    /** odla-db file storage (present on the real client). Member photos use it. */
+    storage?: {
+        upload(path: string, data: BodyInit, contentType?: string, opts?: {
+            private?: boolean;
+        }): Promise<{
+            path: string;
+            size: number;
+            contentType: string;
+        }>;
+        sign(path: string, ttlSeconds?: number): Promise<string>;
+        delete(path: string): Promise<void>;
     };
-    /** Short glyph used in compact admin chrome. Defaults to the first three
-     * letters of the chapter name. */
-    badge?: string;
-    wordmark?: string;
-    tagline?: string;
-    /** Header/footer nav sections for the web-component chrome: label → entries. */
-    nav?: Record<string, ReadonlyArray<{
-        label: string;
-        href: string;
-    }>>;
-    logos?: string;
 }
 
 /** One owner-editable transactional email template. Automatic sends require explicit `enabled: true`. */
@@ -612,6 +692,8 @@ interface ChapterAuth {
      * app allowlist; `"odla"` reads protected `$users.role` by exact subject ID.
      * Default `"odla"` for private Clerk mode, `"table"` for legacy modes. */
     superAdminSource?: "table" | "odla";
+    /** Require a second sign-in factor on admin routes: `off` (default), `report` (allow and log), `enforce`. */
+    adminSecondFactor?: "off" | "report" | "enforce";
 }
 /** The fully-resolved auth policy (defaults applied) carried on the {@link Chapter}. */
 interface ResolvedAuth {
@@ -622,6 +704,7 @@ interface ResolvedAuth {
     adminRole: string;
     superAdmins: boolean;
     superAdminSource: "none" | "table" | "odla";
+    adminSecondFactor: "off" | "report" | "enforce";
 }
 /** The application status pipeline. Which statuses exist, and the subsets a site
  *  allows a call to be booked from / an application approved from. Defaults to
@@ -717,6 +800,8 @@ interface ChapterConfig {
     signupControl?: ChapterSignupControl;
     /** Authenticated parent + chapter member pages with server-enforced tier access. */
     memberContent?: ChapterMemberContent;
+    /** Signed-in member portal: profile, photos, courses, invite links and credit. */
+    memberPortal?: ChapterMemberPortal;
     /** Private docs, Brand asset references, and links for authorized site-building agents. */
     builderLibrary?: ChapterBuilderLibrary;
     /** Network-scoped canonical Person registry. Shadow mode is additive only:
@@ -822,6 +907,8 @@ interface Chapter {
     signupControl: ResolvedSignupControl | null;
     /** Null unless the standard authenticated member-content surface is enabled. */
     memberContent: ResolvedMemberContent | null;
+    /** Null unless the member portal is enabled. */
+    memberPortal: ResolvedMemberPortal | null;
     /** Null unless the private scoped Builder Library is enabled. */
     builderLibrary: ResolvedBuilderLibrary | null;
     /** Null unless this hub explicitly enables the shadow Person registry. */
@@ -2130,8 +2217,54 @@ interface SignupControlDeliveryOptions {
 /** Build and send one signed desired-state delivery. Durable retry belongs to the hub outbox. */
 declare function deliverSignupControl(options: SignupControlDeliveryOptions): Promise<SignupControlReceipt>;
 
-/** Versioned contract for authenticated member content. */
-declare const MEMBER_CONTENT_SCHEMA_VERSION: 1;
+/**
+ * Member catalog schema version 2: ordered navigation sections, page kinds,
+ * navigation tags and icons. Version 1 documents remain valid and keep their
+ * alphabetical section order; every field here requires `schemaVersion: 2`.
+ */
+/** Packaged member features a catalog page can stand for. */
+declare const MEMBER_PAGE_FEATURES: readonly ["course", "share"];
+/** A packaged member feature: `course` (cohort course) or `share` (invite kit). */
+type MemberPageFeatureName = typeof MEMBER_PAGE_FEATURES[number];
+/** Fixed icon vocabulary. Content never carries SVG, URLs or markup. */
+declare const MEMBER_PAGE_ICONS: readonly ["home", "course", "library", "deals", "training", "events", "members", "share", "profile", "document", "calendar", "chat", "star"];
+/** One icon from {@link MEMBER_PAGE_ICONS}. */
+type MemberPageIcon = typeof MEMBER_PAGE_ICONS[number];
+/** Authored navigation tags. "Soon" and year tags are derived from placeholder pages. */
+declare const MEMBER_PAGE_TAGS: readonly ["new"];
+/** One tag from {@link MEMBER_PAGE_TAGS}. */
+type MemberPageTag = typeof MEMBER_PAGE_TAGS[number];
+/** How a page renders: authored Markdown, a not-yet-open placeholder, or a packaged feature. */
+type MemberPageKind = "markdown" | "placeholder" | "feature";
+/**
+ * A page that is announced but not open. Without `availableYear` it reads as
+ * "Coming soon"; with one, as "Coming in <year>".
+ */
+interface MemberPagePlaceholder {
+    /** Calendar year the page is expected to open. */
+    availableYear?: number;
+    /** Replaces the derived "Coming soon" / "Coming in <year>" badge text. */
+    badge?: string;
+    /** Label of a disabled call to action, e.g. "Investor form opens in 2027". */
+    actionLabel?: string;
+}
+/** A catalog page backed by a packaged feature, gated by the page's audience. */
+interface MemberPageFeature {
+    name: MemberPageFeatureName;
+    /** Feature-specific identity, e.g. the course id for `course`. */
+    ref?: string;
+}
+/**
+ * One navigation group. A section without a label renders without a heading.
+ * Section order is the order of the document's `sections` array.
+ */
+interface MemberContentSection {
+    id: string;
+    label?: string;
+}
+
+/** Every member-content schema version this release validates. */
+type MemberContentSchemaVersion = 1 | 2;
 /** Authority that authored one independently stored member-content layer. */
 type MemberContentSourceType = "parent" | "chapter";
 /** Stable author identity attached to every member-content document and page. */
@@ -2146,9 +2279,14 @@ interface MemberContentTarget {
 }
 /** Navigation is data, so agents do not have to coordinate route code. */
 interface MemberPageNavigation {
+    /** A section id declared in `sections`, or (without `sections`) the section's display label. */
     section: string;
     order: number;
     parentId?: string;
+    /** Schema version 2. */
+    tag?: MemberPageTag;
+    /** Schema version 2. */
+    icon?: MemberPageIcon;
 }
 /** Explicit sets avoid unsafe assumptions that commercial tiers form a ladder. */
 type MemberPageAudience = {
@@ -2182,9 +2320,15 @@ interface MemberContentPage {
     audience: MemberPageAudience;
     /** Safe Markdown shown while the body is withheld. */
     teaserMarkdown?: string;
-    /** Never serialized to a viewer whose audience does not match. */
-    bodyMarkdown: string;
+    /** Never serialized to a viewer whose audience does not match. Required for Markdown pages. */
+    bodyMarkdown?: string;
     upsell?: MemberPageUpsell;
+    /** Schema version 2; defaults to `markdown`. */
+    kind?: MemberPageKind;
+    /** Schema version 2; present exactly when `kind` is `placeholder`. */
+    placeholder?: MemberPagePlaceholder;
+    /** Schema version 2; present exactly when `kind` is `feature`. */
+    feature?: MemberPageFeature;
 }
 /** Chapter-owned offer attached to a Parent page that delegated offer authority. */
 interface MemberPageUpsellOverride {
@@ -2193,13 +2337,15 @@ interface MemberPageUpsellOverride {
 }
 /** One complete source layer. Parent and Chapter layers are stored independently. */
 interface MemberContentDocument {
-    schemaVersion: typeof MEMBER_CONTENT_SCHEMA_VERSION;
+    schemaVersion: MemberContentSchemaVersion;
     revision: number;
     generatedAt: number;
     source: MemberContentSource;
     target?: MemberContentTarget;
     pages: readonly MemberContentPage[];
     upsellOverrides?: readonly MemberPageUpsellOverride[];
+    /** Schema version 2: navigation groups in display order. */
+    sections?: readonly MemberContentSection[];
 }
 /** Canonical parent document and digest transmitted over the signed control edge. */
 interface MemberContentEnvelope {