@odla-ai/chapter 0.17.0 → 0.19.0

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

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { CrmClient, Crm } from '@odla-ai/crm';
+import { CrmClient, Crm, CrmRecord } from '@odla-ai/crm';
 
 /** What each admin section receives. `client` is a CrmClient bound to the
  * signed-in admin's bearer token; `navigate` switches sections. */
@@ -70,29 +70,40 @@ interface CollectionSectionOptions {
     id?: string;
     /** Nav label. Defaults to the type's plural label from the CRM config. */
     label?: string;
+    /** Show the lifecycle action panel (role change / approve / refund) on an open
+     *  record — for application-backed people. Default `true` for `type: "person"`,
+     *  `false` otherwise (a `deal`/`investment` has no approve/refund). */
+    lifecycle?: boolean;
+    /** Role ladder for the role selector. Default `["provisional","member","admin"]`
+     *  — pass your `chapter.auth.ladder` if you use a custom ladder. */
+    roles?: readonly string[];
 }
 /**
  * Build a CRM collection admin section for ANY declared record type: a
  * server-driven records table plus a facet-composed detail drawer (fields,
- * pipeline stage, tags) over the token-bound CrmClient. This is the generic kit —
- * call it once per collection a site runs (members, deals, investments), and each
- * renders with the same UX. Every action goes through `/api/crm/*`, never a direct
- * db write, so the CRM invariants hold.
+ * pipeline stage, tags) over the token-bound CrmClient, and — for people — a
+ * lifecycle action panel (role change, approve, refund) wired to the
+ * `/api/admin/*` routes. This is the generic kit — call it once per collection a
+ * site runs (members, deals, investments), and each renders with the same UX.
+ * CRM edits go through `/api/crm/*` and lifecycle actions through `/api/admin/*`,
+ * never a direct db write, so the invariants hold.
  */
 declare function collectionSection(options: CollectionSectionOptions): AdminSection;
 /**
  * Build the People/CRM admin section — {@link collectionSection} preset to the
- * `person` type. Kept as a convenience; new collections use `collectionSection`.
+ * `person` type (so the lifecycle actions are on). New collections use
+ * `collectionSection`.
  */
-declare function peopleSection(options: PeopleSectionOptions): AdminSection;
+declare function peopleSection(options: PeopleSectionOptions & {
+    roles?: readonly string[];
+}): AdminSection;
 
 /** Options for {@link dashboardSection}. */
 interface DashboardSectionOptions {
     id?: string;
     label?: string;
 }
-/** Build the Dashboard admin section over `GET /api/admin/dashboard`. Drop the
- *  result into `ChapterAdmin`'s `sections`. */
+/** Build the Dashboard admin section over `GET /api/admin/dashboard`. */
 declare function dashboardSection(options?: DashboardSectionOptions): AdminSection;
 
 /** Options for {@link billingSection}. */
@@ -122,6 +133,28 @@ interface MeetingsSectionOptions {
  *  `GET /api/admin/meetings`, with reschedule/cancel actions. */
 declare function meetingsSection(options?: MeetingsSectionOptions): AdminSection;
 
+/** Options for {@link availabilitySection}. */
+interface AvailabilitySectionOptions {
+    id?: string;
+    label?: string;
+}
+/** Build the Availability admin section: the booking-rules editor over
+ *  `GET/PUT /api/admin/scheduling`, with field-keyed validation surfaced inline. */
+declare function availabilitySection(options?: AvailabilitySectionOptions): AdminSection;
+
+/** Props for {@link RecordActions}. */
+interface RecordActionsProps {
+    getToken: () => Promise<string | null>;
+    record: CrmRecord;
+    /** The role ladder offered by the role selector. Default provisional→admin. */
+    roles: readonly string[];
+    /** Called after any action mutates state, so the caller can refresh. */
+    onChanged: () => void;
+}
+/** The role/approve/refund controls for one person record. Renders only the
+ *  actions the record supports. */
+declare function RecordActions({ getToken, record, roles, onChanged }: RecordActionsProps): react.JSX.Element | null;
+
 /** 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>;
@@ -137,4 +170,22 @@ interface AdminResource<T> {
  *  or when `path` changes. */
 declare function useAdminResource<T = unknown>(getToken: () => Promise<string | null>, path: string): AdminResource<T>;
 
-export { type AdminResource, type AdminSection, type AdminSectionContext, type BillingSectionOptions, ChapterAdmin, type ChapterAdminProps, type CollectionSectionOptions, type DashboardSectionOptions, type EmailSectionOptions, type MeetingsSectionOptions, type PeopleSectionOptions, adminFetch, billingSection, collectionSection, dashboardSection, emailSection, meetingsSection, peopleSection, useAdminResource };
+/** The centered content column every admin section renders into. */
+declare function AdminPage({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+/** An odla-ui `.panel` card with an optional heading + trailing actions. */
+declare function Panel({ title, actions, children }: {
+    title?: ReactNode;
+    actions?: ReactNode;
+    children: ReactNode;
+}): react.JSX.Element;
+/** A loud banner when the odla-ui theme token layer is missing — the silent-and-
+ *  total failure S&S flagged. Renders nothing when the theme is present. */
+declare function ThemeWarning(): react.JSX.Element | null;
+/** A centered status line for loading / empty / error states. */
+declare function AdminNote({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+
+export { AdminNote, AdminPage, type AdminResource, type AdminSection, type AdminSectionContext, type AvailabilitySectionOptions, type BillingSectionOptions, ChapterAdmin, type ChapterAdminProps, type CollectionSectionOptions, type DashboardSectionOptions, type EmailSectionOptions, type MeetingsSectionOptions, Panel, type PeopleSectionOptions, RecordActions, type RecordActionsProps, ThemeWarning, adminFetch, availabilitySection, billingSection, collectionSection, dashboardSection, emailSection, meetingsSection, peopleSection, useAdminResource };

package/dist/ui/admin/index.js

@@ -1,6 +1,12 @@
 import {
+  AdminNote,
+  AdminPage,
   ChapterAdmin,
+  Panel,
+  RecordActions,
+  ThemeWarning,
   adminFetch,
+  availabilitySection,
   billingSection,
   collectionSection,
   dashboardSection,
@@ -8,10 +14,16 @@ import {
   meetingsSection,
   peopleSection,
   useAdminResource
-} from "../../chunk-HB2HUJCW.js";
+} from "../../chunk-D3QMK3ED.js";
 export {
+  AdminNote,
+  AdminPage,
   ChapterAdmin,
+  Panel,
+  RecordActions,
+  ThemeWarning,
   adminFetch,
+  availabilitySection,
   billingSection,
   collectionSection,
   dashboardSection,

package/dist/ui/index.d.ts

@@ -1,4 +1,4 @@
-export { AdminResource, AdminSection, AdminSectionContext, BillingSectionOptions, ChapterAdmin, ChapterAdminProps, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, MeetingsSectionOptions, PeopleSectionOptions, adminFetch, billingSection, collectionSection, dashboardSection, emailSection, meetingsSection, peopleSection, useAdminResource } from './admin/index.js';
+export { AdminNote, AdminPage, AdminResource, AdminSection, AdminSectionContext, AvailabilitySectionOptions, BillingSectionOptions, ChapterAdmin, ChapterAdminProps, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, MeetingsSectionOptions, Panel, PeopleSectionOptions, RecordActions, RecordActionsProps, ThemeWarning, adminFetch, availabilitySection, billingSection, collectionSection, dashboardSection, emailSection, meetingsSection, peopleSection, useAdminResource } from './admin/index.js';
 export { ApiFn, BrandStyle, BrandStyleProps, JoinConfig, JoinIsland, JoinIslandProps, MembersArea, MembersAreaProps, PaymentStep, PaymentStepProps, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, timeLabel, tzShort } from './member/index.js';
 import 'react';
 import '@odla-ai/crm';

package/dist/ui/index.js

@@ -13,10 +13,16 @@ import {
   groupSlotsByDay,
   timeLabel,
   tzShort
-} from "../chunk-ZCZK6QLC.js";
+} from "../chunk-GWY2ZTN7.js";
 import {
+  AdminNote,
+  AdminPage,
   ChapterAdmin,
+  Panel,
+  RecordActions,
+  ThemeWarning,
   adminFetch,
+  availabilitySection,
   billingSection,
   collectionSection,
   dashboardSection,
@@ -24,16 +30,22 @@ import {
   meetingsSection,
   peopleSection,
   useAdminResource
-} from "../chunk-HB2HUJCW.js";
+} from "../chunk-D3QMK3ED.js";
 export {
+  AdminNote,
+  AdminPage,
   BrandStyle,
   ChapterAdmin,
   JoinIsland,
   MembersArea,
+  Panel,
   PaymentStep,
+  RecordActions,
   Rescheduler,
   SlotPicker,
+  ThemeWarning,
   adminFetch,
+  availabilitySection,
   billingSection,
   collectionSection,
   dashboardSection,

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

@@ -124,8 +124,13 @@ declare function PaymentStep(props: PaymentStepProps): react.JSX.Element;
 /** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
 interface ChapterBrand {
     /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
-     * or `--ui-*` token names). */
+     * 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>;
     fonts?: {
         display?: string;
         body?: string;

package/dist/ui/member/index.js

@@ -13,7 +13,7 @@ import {
   groupSlotsByDay,
   timeLabel,
   tzShort
-} from "../../chunk-ZCZK6QLC.js";
+} from "../../chunk-GWY2ZTN7.js";
 export {
   BrandStyle,
   JoinIsland,

package/dist/worker/index.d.cts

@@ -35,8 +35,13 @@ type DbRules = Record<string, Rule>;
 /** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
 interface ChapterBrand {
     /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
-     * or `--ui-*` token names). */
+     * 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>;
     fonts?: {
         display?: string;
         body?: string;

package/dist/worker/index.d.ts

@@ -35,8 +35,13 @@ type DbRules = Record<string, Rule>;
 /** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
 interface ChapterBrand {
     /** Palette overrides written into styles.css :root (e.g. `{ moss: "#2F3E34" }`
-     * or `--ui-*` token names). */
+     * 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>;
     fonts?: {
         display?: string;
         body?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odla-ai/chapter",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "A foundation for membership sites: one config (defineChapter) stands up a full member site (join, Stripe membership, Google booking, member area, admin, CRM) or an admin-only hub, on odla-db + Clerk + @odla-ai/crm + calendar + email.",
   "license": "MIT",
   "homepage": "https://odla.ai/docs/packages/chapter",