@odla-ai/chapter 0.20.2 → 0.21.0

package/dist/worker/index.d.cts

@@ -32,8 +32,36 @@ interface Rule {
 }
 /** Namespace → rule set. */
 type DbRules = Record<string, Rule>;
-/** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
+/** 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;
+    chartPositive?: string;
+    chartNegative?: 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;
+    /** 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}. */
@@ -67,7 +95,7 @@ interface ChapterNetworkTarget {
     id: string;
     /** Human-facing site name. Defaults to `id`. */
     name?: string;
-    /** Absolute follower origin, e.g. `https://silver.example.com`. */
+    /** Absolute follower origin, e.g. `https://chapter.example.com`. */
     url: string;
     /** Leader-vault key holding this follower's share secret. Defaults to
      * `network_share_<id-with-underscores>`. */
@@ -138,10 +166,10 @@ interface ChapterScheduling {
 }
 /** How a signed-in user's role is determined.
  *
- * - `"claim"` reads a role ladder from a JWT claim (Silver & Salt's model:
+ * - `"claim"` reads a role ladder from a JWT claim (the member-site model:
  *   `provisional → member → admin`). Admin is the last (highest) rung; the
  *   read-only `superAdmins` tier sits above it.
- * - `"table"` gates on the deny-all `admins` allowlist (Built Not Found's model):
+ * - `"table"` gates on the deny-all `admins` allowlist (the hub model):
  *   a binary "email is an admin or isn't", set only in odla Studio.
  *
  * Defaults: `"claim"` in `chapter` mode, `"table"` in `hub` mode. */
@@ -168,7 +196,7 @@ interface ResolvedAuth {
 }
 /** 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
- *  Silver & Salt's pipeline. Status never moves backwards (package-enforced). */
+ *  the reference pipeline. Status never moves backwards (package-enforced). */
 interface ChapterPipeline {
     stages?: readonly string[];
     bookableFrom?: readonly string[];
@@ -185,8 +213,8 @@ interface ResolvedPipeline {
 }
 /** The application (join form) validation surface — which string fields are
  *  required vs accepted, their max lengths, and the request body cap. Drives
- *  submit validation + the CRM slot projection; defaults to Silver & Salt's form.
- *  The `applications` schema attrs stay fixed (byte-equal to S&S); this is
+ *  submit validation + the CRM slot projection; defaults to the reference form.
+ *  The `applications` schema attrs stay fixed; this is
  *  validation config, not schema generation. */
 interface ChapterApplication {
     required?: readonly string[];
@@ -258,7 +286,7 @@ interface ChapterConfig {
     /** `notificationEmail` required in `chapter` mode. */
     emails?: ChapterEmails;
     scheduling?: ChapterScheduling;
-    /** Application status pipeline (stages + bookable/approvable subsets). Defaults to S&S's. */
+    /** Application status pipeline (stages + bookable/approvable subsets). */
     pipeline?: ChapterPipeline;
     /** Join-form validation (required/optional fields, max lengths, body cap). */
     application?: ChapterApplication;

package/dist/worker/index.d.ts

@@ -32,8 +32,36 @@ interface Rule {
 }
 /** Namespace → rule set. */
 type DbRules = Record<string, Rule>;
-/** Brand tokens that theme the site: palette, fonts, wordmark, nav, logos. */
+/** 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;
+    chartPositive?: string;
+    chartNegative?: 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;
+    /** 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}. */
@@ -67,7 +95,7 @@ interface ChapterNetworkTarget {
     id: string;
     /** Human-facing site name. Defaults to `id`. */
     name?: string;
-    /** Absolute follower origin, e.g. `https://silver.example.com`. */
+    /** Absolute follower origin, e.g. `https://chapter.example.com`. */
     url: string;
     /** Leader-vault key holding this follower's share secret. Defaults to
      * `network_share_<id-with-underscores>`. */
@@ -138,10 +166,10 @@ interface ChapterScheduling {
 }
 /** How a signed-in user's role is determined.
  *
- * - `"claim"` reads a role ladder from a JWT claim (Silver & Salt's model:
+ * - `"claim"` reads a role ladder from a JWT claim (the member-site model:
  *   `provisional → member → admin`). Admin is the last (highest) rung; the
  *   read-only `superAdmins` tier sits above it.
- * - `"table"` gates on the deny-all `admins` allowlist (Built Not Found's model):
+ * - `"table"` gates on the deny-all `admins` allowlist (the hub model):
  *   a binary "email is an admin or isn't", set only in odla Studio.
  *
  * Defaults: `"claim"` in `chapter` mode, `"table"` in `hub` mode. */
@@ -168,7 +196,7 @@ interface ResolvedAuth {
 }
 /** 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
- *  Silver & Salt's pipeline. Status never moves backwards (package-enforced). */
+ *  the reference pipeline. Status never moves backwards (package-enforced). */
 interface ChapterPipeline {
     stages?: readonly string[];
     bookableFrom?: readonly string[];
@@ -185,8 +213,8 @@ interface ResolvedPipeline {
 }
 /** The application (join form) validation surface — which string fields are
  *  required vs accepted, their max lengths, and the request body cap. Drives
- *  submit validation + the CRM slot projection; defaults to Silver & Salt's form.
- *  The `applications` schema attrs stay fixed (byte-equal to S&S); this is
+ *  submit validation + the CRM slot projection; defaults to the reference form.
+ *  The `applications` schema attrs stay fixed; this is
  *  validation config, not schema generation. */
 interface ChapterApplication {
     required?: readonly string[];
@@ -258,7 +286,7 @@ interface ChapterConfig {
     /** `notificationEmail` required in `chapter` mode. */
     emails?: ChapterEmails;
     scheduling?: ChapterScheduling;
-    /** Application status pipeline (stages + bookable/approvable subsets). Defaults to S&S's. */
+    /** Application status pipeline (stages + bookable/approvable subsets). */
     pipeline?: ChapterPipeline;
     /** Join-form validation (required/optional fields, max lengths, body cap). */
     application?: ChapterApplication;

package/dist/worker/index.js

@@ -1138,7 +1138,7 @@ function createStripeProvider(config) {
           "expand[0]": "latest_invoice.confirmation_secret",
           metadata: meta
         },
-        // The hardening S&S lacked: one subscription per application, so a client
+        // Hardening: one subscription per application, so a client
         // retry between create and the db write can't orphan a second one.
         `sub:${input.applicationId}`
       );
@@ -1709,18 +1709,30 @@ var handleAdminPeopleRole = async (req, url, env, ctx) => {
 };
 
 // src/series.ts
-function bucketSeries(points, now, weeks = 12) {
-  const WEEK = 7 * 864e5;
-  const end = now;
-  const start = end - weeks * WEEK;
-  const buckets = Array.from({ length: weeks }, (_, i) => ({ weekStart: start + i * WEEK, value: 0 }));
-  for (const p of points) {
-    if (!Number.isFinite(p.t) || p.t < start || p.t > end) continue;
-    const idx = Math.min(weeks - 1, Math.floor((p.t - start) / WEEK));
-    const bucket = buckets[idx];
-    if (bucket) bucket.value += Number.isFinite(p.v) ? p.v : 0;
-  }
-  return buckets;
+function periodSeries(points, now, count, periodMs) {
+  const start = now - count * periodMs;
+  const previousStart = start - count * periodMs;
+  const current = Array.from({ length: count }, () => 0);
+  const previous = Array.from({ length: count }, () => 0);
+  for (const point of points) {
+    if (!Number.isFinite(point.t) || !Number.isFinite(point.v)) continue;
+    if (point.t >= start && point.t <= now) {
+      const index = Math.min(count - 1, Math.floor((point.t - start) / periodMs));
+      current[index] = (current[index] ?? 0) + point.v;
+    } else if (point.t >= previousStart && point.t < start) {
+      const index = Math.min(count - 1, Math.floor((point.t - previousStart) / periodMs));
+      previous[index] = (previous[index] ?? 0) + point.v;
+    }
+  }
+  const labels = current.map((_, index) => new Date(start + index * periodMs).toISOString().slice(5, 10));
+  return { labels, current, previous };
+}
+function dashboardMetricData(points, now) {
+  const DAY = 864e5;
+  return {
+    wow: periodSeries(points, now, 7, DAY),
+    mom: periodSeries(points, now, 4, 7 * DAY)
+  };
 }
 function subAnnualCents(sub) {
   const items = sub.items?.data ?? [];
@@ -1803,8 +1815,8 @@ var handleAdminDashboard = async (req, url, env, ctx) => {
     if (subsRes.ok) {
       const subs = rows(subsRes.body.data);
       const subMs = (s) => (s.created ?? 0) * 1e3;
-      membersSeries = bucketSeries(subs.map((s) => ({ t: subMs(s), v: 1 })), now);
-      revenueSeries = bucketSeries(subs.map((s) => ({ t: subMs(s), v: subAnnualCents(s) })), now);
+      membersSeries = dashboardMetricData(subs.map((s) => ({ t: subMs(s), v: 1 })), now);
+      revenueSeries = dashboardMetricData(subs.map((s) => ({ t: subMs(s), v: subAnnualCents(s) })), now);
       const active = subs.filter((s) => s.status === "active");
       revenue = {
         billingReady: true,
@@ -1816,7 +1828,7 @@ var handleAdminDashboard = async (req, url, env, ctx) => {
       };
     }
   }
-  const applicationsSeries = bucketSeries(apps.map((a) => ({ t: a.createdAt || 0, v: 1 })), now);
+  const applicationsSeries = dashboardMetricData(apps.map((a) => ({ t: a.createdAt || 0, v: 1 })), now);
   return json({ applications, applicationsSeries, pipeline, pipelineDelta, calls, agenda, timezone, revenue, revenueSeries, membersSeries });
 };
 var handleAdminBilling = async (req, url, env, ctx) => {