@odla-ai/chapter 0.34.0 → 0.36.0

package/dist/ui/admin/index.d.ts

@@ -1,8 +1,8 @@
 import * as preact from 'preact';
 import { ComponentChildren, JSX } from 'preact';
 import { CrmClient, Crm, CrmRecord } from '@odla-ai/crm';
-import { a as Chapter, b as ChapterCopy } from '../../copy-context-c1tqPXOR.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-c1tqPXOR.js';
+import { a as Chapter, b as ChapterCopy } from '../../copy-context-0k0-yWHL.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-0k0-yWHL.js';
 import { CrmLifecycleAdapter, CrmWorkspaceMasterContext, CrmWorkspaceRecordContext, RecordPanelTab } from '@odla-ai/crm/ui';
 
 /** Normalized public auth configuration consumed by the Clerk gate. */
@@ -286,6 +286,13 @@ declare function LeaderNetworkOverview({ ctx }: {
     ctx: AdminSectionContext;
 }): preact.JSX.Element;
 
+/** Audited Chapter-admin surface for local decisions and effective Parent rows. */
+declare function AdmissionGrantsWorkspace(props: {
+    getToken: () => Promise<string | null>;
+}): JSX.Element;
+/** Create the standard Chapter admission workspace definition. */
+declare function admissionGrantsWorkspace(label?: string): AdminWorkspace;
+
 /** Fetch a JSON `/api/admin/*` route with the admin bearer token. Throws on a
  *  non-2xx (the body's `error`, else the status). */
 declare function adminFetch<T = unknown>(getToken: () => Promise<string | null>, path: string, init?: RequestInit): Promise<T>;
@@ -318,4 +325,4 @@ declare function AdminNote({ children }: {
     children: ComponentChildren;
 }): JSX.Element;
 
-export { type AdminAccountMenuProps, type AdminChrome, AdminNote, AdminPage, type AdminResource, type AdminRouteState, type AdminRouteTarget, type AdminRouting, type AdminSection, type AdminSectionContext, type AdminWorkspace, type AdminWorkspaceNavProps, type AvailabilitySectionOptions, type BillingSectionOptions, ChapterAdmin, type ChapterAdminAuthAdapter, type ChapterAdminAuthConfig, type ChapterAdminAuthLoadContext, type ChapterAdminProps, type ChapterAdminUser, type CollectionSectionOptions, type DashboardSectionOptions, type EmailSectionOptions, LeaderNetworkOverview, type MeetingsSectionOptions, NetworkRecordsWorkspace, NetworkShareActions, type NetworkShareActionsProps, Panel, type PeopleSectionOptions, RecordActions, type RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, networkRecordsWorkspace, peopleSection, useAdminResource };
+export { type AdminAccountMenuProps, type AdminChrome, AdminNote, AdminPage, type AdminResource, type AdminRouteState, type AdminRouteTarget, type AdminRouting, type AdminSection, type AdminSectionContext, type AdminWorkspace, type AdminWorkspaceNavProps, AdmissionGrantsWorkspace, type AvailabilitySectionOptions, type BillingSectionOptions, ChapterAdmin, type ChapterAdminAuthAdapter, type ChapterAdminAuthConfig, type ChapterAdminAuthLoadContext, type ChapterAdminProps, type ChapterAdminUser, type CollectionSectionOptions, type DashboardSectionOptions, type EmailSectionOptions, LeaderNetworkOverview, type MeetingsSectionOptions, NetworkRecordsWorkspace, NetworkShareActions, type NetworkShareActionsProps, Panel, type PeopleSectionOptions, RecordActions, type RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, admissionGrantsWorkspace, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, networkRecordsWorkspace, peopleSection, useAdminResource };

package/dist/ui/admin/index.js

@@ -1,6 +1,7 @@
 import {
   AdminNote,
   AdminPage,
+  AdmissionGrantsWorkspace,
   ChapterAdmin,
   LeaderNetworkOverview,
   NetworkRecordsWorkspace,
@@ -13,6 +14,7 @@ import {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  admissionGrantsWorkspace,
   applicationLifecycleAdapter,
   availabilitySection,
   billingSection,
@@ -27,14 +29,15 @@ import {
   networkRecordsWorkspace,
   peopleSection,
   useAdminResource
-} from "../../chunk-TXE5ZDI4.js";
+} from "../../chunk-LWM32REV.js";
 import {
   ChapterCopyProvider,
   useChapterCopy
-} from "../../chunk-JAWTIROV.js";
+} from "../../chunk-IAWBE5PX.js";
 export {
   AdminNote,
   AdminPage,
+  AdmissionGrantsWorkspace,
   ChapterAdmin,
   ChapterCopyProvider,
   LeaderNetworkOverview,
@@ -48,6 +51,7 @@ export {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  admissionGrantsWorkspace,
   applicationLifecycleAdapter,
   availabilitySection,
   billingSection,

package/dist/ui/index.d.ts

@@ -1,6 +1,6 @@
-export { AdminAccountMenuProps, AdminChrome, AdminNote, AdminPage, AdminResource, AdminRouteState, AdminRouteTarget, AdminRouting, AdminSection, AdminSectionContext, AdminWorkspace, AdminWorkspaceNavProps, AvailabilitySectionOptions, BillingSectionOptions, ChapterAdmin, ChapterAdminAuthAdapter, ChapterAdminAuthConfig, ChapterAdminAuthLoadContext, ChapterAdminProps, ChapterAdminUser, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, LeaderNetworkOverview, MeetingsSectionOptions, NetworkRecordsWorkspace, NetworkShareActions, NetworkShareActionsProps, Panel, PeopleSectionOptions, RecordActions, RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, networkRecordsWorkspace, peopleSection, useAdminResource } from './admin/index.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../copy-context-c1tqPXOR.js';
-export { ApiFn, BrandStyle, BrandStyleProps, JoinBookingSimulation, JoinConfig, JoinFlowState, JoinIsland, JoinIslandProps, JoinSimulation, JoinStepRenderContext, JoinSubmitRenderContext, JoinTier, JoinTierRenderContext, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberProvisionalRenderContext, MembersArea, MembersAreaProps, MembershipCardTokenName, MembershipCards, MembershipCardsMode, MembershipCardsProps, PaymentPriceLines, PaymentStep, PaymentStepProps, PaymentStepSimulation, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection } from './member/index.js';
+export { AdminAccountMenuProps, AdminChrome, AdminNote, AdminPage, AdminResource, AdminRouteState, AdminRouteTarget, AdminRouting, AdminSection, AdminSectionContext, AdminWorkspace, AdminWorkspaceNavProps, AdmissionGrantsWorkspace, AvailabilitySectionOptions, BillingSectionOptions, ChapterAdmin, ChapterAdminAuthAdapter, ChapterAdminAuthConfig, ChapterAdminAuthLoadContext, ChapterAdminProps, ChapterAdminUser, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, LeaderNetworkOverview, MeetingsSectionOptions, NetworkRecordsWorkspace, NetworkShareActions, NetworkShareActionsProps, Panel, PeopleSectionOptions, RecordActions, RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, admissionGrantsWorkspace, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, networkRecordsWorkspace, peopleSection, useAdminResource } from './admin/index.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../copy-context-0k0-yWHL.js';
+export { ApiFn, BrandStyle, BrandStyleProps, GiftOfferCards, GiftOfferCardsMode, GiftOfferCardsProps, JoinBookingSimulation, JoinConfig, JoinFlowState, JoinIsland, JoinIslandProps, JoinSimulation, JoinStepRenderContext, JoinSubmitRenderContext, JoinTier, JoinTierRenderContext, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberGifts, MemberProvisionalRenderContext, MembersArea, MembersAreaProps, MembershipCardTokenName, MembershipCards, MembershipCardsMode, MembershipCardsProps, PaymentPriceLines, PaymentStep, PaymentStepProps, PaymentStepSimulation, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, SubResponse, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection } from './member/index.js';
 import 'preact';
 import '@odla-ai/crm';
 import '@odla-ai/crm/ui';

package/dist/ui/index.js

@@ -1,6 +1,8 @@
 import {
+  GiftOfferCards,
   JoinIsland,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
+  MemberGifts,
   MembersArea,
   MembershipCards,
   PaymentStep,
@@ -19,10 +21,11 @@ import {
   timeLabel,
   tzShort,
   useTierSelection
-} from "../chunk-UJIVBGL5.js";
+} from "../chunk-I45VYBUV.js";
 import {
   AdminNote,
   AdminPage,
+  AdmissionGrantsWorkspace,
   ChapterAdmin,
   LeaderNetworkOverview,
   NetworkRecordsWorkspace,
@@ -35,6 +38,7 @@ import {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  admissionGrantsWorkspace,
   applicationLifecycleAdapter,
   availabilitySection,
   billingSection,
@@ -49,22 +53,25 @@ import {
   networkRecordsWorkspace,
   peopleSection,
   useAdminResource
-} from "../chunk-TXE5ZDI4.js";
+} from "../chunk-LWM32REV.js";
 import {
   BrandStyle,
   ChapterCopyProvider,
   useChapterCopy
-} from "../chunk-JAWTIROV.js";
+} from "../chunk-IAWBE5PX.js";
 import "../chunk-IVXVECKR.js";
 export {
   AdminNote,
   AdminPage,
+  AdmissionGrantsWorkspace,
   BrandStyle,
   ChapterAdmin,
   ChapterCopyProvider,
+  GiftOfferCards,
   JoinIsland,
   LeaderNetworkOverview,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
+  MemberGifts,
   MembersArea,
   MembershipCards,
   NetworkRecordsWorkspace,
@@ -81,6 +88,7 @@ export {
   adminRouteHref,
   adminSectionFromUrl,
   adminSectionHref,
+  admissionGrantsWorkspace,
   applicationLifecycleAdapter,
   availabilitySection,
   billingSection,

package/dist/ui/member/index.d.ts

@@ -1,7 +1,7 @@
 import * as preact from 'preact';
 import { ComponentChildren, JSX } from 'preact';
-import { b as ChapterCopy, c as ChapterBrand } from '../../copy-context-c1tqPXOR.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-c1tqPXOR.js';
+import { b as ChapterCopy, c as ChapterBrand } from '../../copy-context-0k0-yWHL.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-0k0-yWHL.js';
 import '@odla-ai/crm';
 
 /** A bookable slot: a start instant in epoch milliseconds. */
@@ -140,7 +140,12 @@ interface PaymentStepProps {
     /** Refund-policy copy the applicant must acknowledge to start payment. */
     refundPolicyText: string;
     /** Called once the payment succeeds (or is processing) — advance to booking. */
-    onPaid: () => void;
+    onPaid: (result: {
+        gift: boolean;
+        giftCode?: string;
+    }) => void;
+    /** Override checkout creation for authenticated member gift purchases. */
+    startCheckout?: () => Promise<SubResponse>;
     /** Stripe Elements appearance passed through without Chapter reinterpretation. */
     appearance?: Record<string, unknown>;
     /** Stripe Elements custom-font descriptors. */
@@ -168,6 +173,14 @@ interface PaymentPriceLines {
 interface PaymentStepSimulation {
     lineItems: PaymentPriceLines;
 }
+/** Checkout setup response shared by membership and gift Payment Element flows. */
+interface SubResponse {
+    clientSecret?: string;
+    publishableKey?: string | null;
+    lineItems?: PaymentPriceLines;
+    gift?: boolean;
+    giftCode?: string;
+}
 /** The card-entry step: acknowledge the refund policy → create the subscription
  *  → mount Stripe Elements → confirm. */
 declare function PaymentStep(props: PaymentStepProps): preact.JSX.Element;
@@ -238,6 +251,32 @@ declare function TierPlaceholder(context: JoinTierRenderContext): ComponentChild
  */
 declare function tierNeedsPayment(selected: JoinTier | null, paymentsReady: boolean): boolean;
 
+/** 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;
+}
+/** Provider-free gift offer shape rendered by Chapter and exact CMS previews. */
+type PublicGiftOffer = Omit<GiftOffer, "stripePriceId" | "target">;
+
 /** The public join config (the shape `GET /api/join-config` returns). */
 interface JoinConfig {
     id: string;
@@ -249,6 +288,7 @@ interface JoinConfig {
     tiers?: readonly JoinTier[];
     /** Resolved copy for the packaged join flow. */
     copy?: ChapterCopy["join"];
+    giftOffers?: readonly PublicGiftOffer[];
 }
 /** Server-validated state used to resume a join journey after a redirect. */
 type JoinFlowState = {
@@ -262,6 +302,14 @@ type JoinFlowState = {
 } | {
     step: "booking";
     applicationId: string;
+} | {
+    step: "accepted";
+    applicationId: string;
+} | {
+    step: "gift";
+    applicationId: string;
+    claimId?: string;
+    code?: string;
 } | {
     step: "done";
     applicationId: string;
@@ -301,12 +349,24 @@ interface JoinIslandProps {
     }> & {
         membersHref: string;
     }) => ComponentChildren;
+    /** Replace the no-interview acceptance card while retaining orchestration. */
+    renderAccepted?: (context: Extract<JoinFlowState, {
+        step: "accepted";
+    }> & {
+        membersHref: string;
+    }) => ComponentChildren;
+    /** Replace the one-time gift-code card while retaining capability recovery. */
+    renderGift?: (context: Extract<JoinFlowState, {
+        step: "gift";
+    }>) => ComponentChildren;
     /** Replace the submit control without replacing the application form. */
     renderSubmit?: (context: JoinSubmitRenderContext) => ComponentChildren;
     /** Render the site's tier chooser; the fallback is intentionally unstyled. */
     renderTiers?: (context: JoinTierRenderContext) => ComponentChildren;
     /** Preselect a tier when it is offered. */
     initialTierId?: string;
+    /** Preselect a gift offer instead of self-membership. */
+    initialGiftOfferId?: string;
     /** Additional host validation gate for the submit action. */
     submitDisabled?: boolean;
     /** Stripe Elements presentation and site-owned payment content. */
@@ -326,9 +386,8 @@ interface JoinIslandProps {
 
 /** Load canonical server state for a capability-bearing application id. */
 declare function loadJoinResume(applicationId: string, fetcher?: typeof fetch): Promise<JoinFlowState>;
-/** The signup island. Renders the site's form, keeps one application
- *  `submissionId` across ambiguous retries, then drives payment (when the
- *  chapter charges) and booking (when a calendar is connected) to confirmation. */
+
+/** Signup island with stable retries and server-driven payment/booking continuation. */
 declare function JoinIsland(props: JoinIslandProps): JSX.Element;
 
 /** The first stable, shared Chapter membership-page renderer contract. */
@@ -417,6 +476,26 @@ declare function membershipApplicationHref(applicationPath: string | undefined,
  */
 declare function MembershipCards(props: MembershipCardsProps): JSX.Element;
 
+/** Interactive live selection or inert exact-preview rendering. */
+type GiftOfferCardsMode = "select" | "preview";
+/** Public provider-free offer-card renderer inputs. */
+interface GiftOfferCardsProps {
+    offers: readonly PublicGiftOffer[];
+    mode?: GiftOfferCardsMode;
+    selectedOfferId?: string | null;
+    onSelect?: (offerId: string) => void;
+    ariaLabel?: string;
+}
+/** Exact Chapter gift-offer renderer shared by live signup, members, and CMS preview. */
+declare function GiftOfferCards(props: GiftOfferCardsProps): JSX.Element;
+
+/** Authenticated buyer ledger, checkout, code rotation, and beneficiary redemption. */
+declare function MemberGifts(props: {
+    api: ApiFn;
+    copy: ChapterCopy["members"]["gifts"];
+    paymentCopy: ChapterCopy["join"]["payment"];
+}): preact.JSX.Element | null;
+
 /** Props for {@link BrandStyle}. */
 interface BrandStyleProps {
     brand: ChapterBrand | undefined;
@@ -427,4 +506,4 @@ interface BrandStyleProps {
  *  there is no brand to theme). */
 declare function BrandStyle(props: BrandStyleProps): preact.JSX.Element | null;
 
-export { type ApiFn, BrandStyle, type BrandStyleProps, type JoinBookingSimulation, type JoinConfig, type JoinFlowState, JoinIsland, type JoinIslandProps, type JoinSimulation, type JoinStepRenderContext, type JoinSubmitRenderContext, type JoinTier, type JoinTierRenderContext, MEMBERSHIP_CARD_TOKEN_DEFAULTS, type MemberProvisionalRenderContext, MembersArea, type MembersAreaProps, type MembershipCardTokenName, MembershipCards, type MembershipCardsMode, type MembershipCardsProps, type PaymentPriceLines, PaymentStep, type PaymentStepProps, type PaymentStepSimulation, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection };
+export { type ApiFn, BrandStyle, type BrandStyleProps, GiftOfferCards, type GiftOfferCardsMode, type GiftOfferCardsProps, type JoinBookingSimulation, type JoinConfig, type JoinFlowState, JoinIsland, type JoinIslandProps, type JoinSimulation, type JoinStepRenderContext, type JoinSubmitRenderContext, type JoinTier, type JoinTierRenderContext, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberGifts, type MemberProvisionalRenderContext, MembersArea, type MembersAreaProps, type MembershipCardTokenName, MembershipCards, type MembershipCardsMode, type MembershipCardsProps, type PaymentPriceLines, PaymentStep, type PaymentStepProps, type PaymentStepSimulation, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, type SubResponse, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection };

package/dist/ui/member/index.js

@@ -1,6 +1,8 @@
 import {
+  GiftOfferCards,
   JoinIsland,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
+  MemberGifts,
   MembersArea,
   MembershipCards,
   PaymentStep,
@@ -19,18 +21,20 @@ import {
   timeLabel,
   tzShort,
   useTierSelection
-} from "../../chunk-UJIVBGL5.js";
+} from "../../chunk-I45VYBUV.js";
 import {
   BrandStyle,
   ChapterCopyProvider,
   useChapterCopy
-} from "../../chunk-JAWTIROV.js";
+} from "../../chunk-IAWBE5PX.js";
 import "../../chunk-IVXVECKR.js";
 export {
   BrandStyle,
   ChapterCopyProvider,
+  GiftOfferCards,
   JoinIsland,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
+  MemberGifts,
   MembersArea,
   MembershipCards,
   PaymentStep,