@odla-ai/chapter 0.22.1 → 0.24.0

package/dist/index.js

@@ -401,8 +401,8 @@ function resolveApplication(a) {
     maxLen: a?.maxLen ?? {},
     defaultMaxLen: a?.defaultMaxLen ?? 2e3,
     bodyCap: a?.bodyCap ?? 32768,
-    requireDisclaimerAck: a?.requireDisclaimerAck ?? false,
-    profileFields: a?.profileFields ?? null,
+    requireDisclaimerAck: a?.requireDisclaimerAck ?? true,
+    profileFields: a?.profileFields ?? [],
     crmFields: a?.crmFields ?? [],
     maxArrayLen: a?.maxArrayLen ?? 100,
     validateEmail: a?.validateEmail ?? true
@@ -422,7 +422,7 @@ function hasDisclaimerAck(fields) {
 var IDENTITY_FIELDS = /* @__PURE__ */ new Set(["email", "firstName", "lastName"]);
 function applicantProfile(chapter, fields) {
   const app = chapter.application;
-  const allowed = (f) => app.profileFields === null || app.profileFields.includes(f);
+  const allowed = (f) => app.profileFields.includes(f);
   const profile = {};
   for (const f of [...app.required, ...app.optional]) {
     if (IDENTITY_FIELDS.has(f) || !allowed(f)) continue;
@@ -479,6 +479,300 @@ function joinConfig(group, paymentsReady2) {
   };
 }
 
+// src/copy-defaults-admin.ts
+var DEFAULT_ADMIN_COPY = {
+  auth: {
+    checking: "Checking access\u2026",
+    notAuthorized: "Not authorized",
+    accountNotAuthorized: "{account} isn't on the admin list.",
+    thisAccount: "This account",
+    signOut: "Sign out",
+    loading: "Loading\u2026",
+    signInNotConfigured: "Sign-in not configured",
+    missingPublishableKey: "No Clerk publishable key is set for this environment yet.",
+    noWorkspaces: "No admin workspaces are configured.",
+    signInTagline: "Admin sign-in, invite only"
+  },
+  shell: {
+    adminRole: "admin",
+    adminConsole: "Admin Console",
+    adminName: "Admin",
+    navigationLabel: "Admin navigation"
+  },
+  workspaces: {
+    dashboard: "Dashboard",
+    overview: "Overview",
+    billing: "Billing",
+    people: "People",
+    settings: "Settings",
+    calendar: "Calendar",
+    email: "Email",
+    dashboardViewsLabel: "Dashboard views",
+    settingsViewsLabel: "Settings views",
+    collectionsLabel: "CRM collections"
+  },
+  dashboard: {
+    loading: "Loading dashboard\u2026",
+    loadFailed: "Couldn't load the dashboard",
+    upcomingCalls: "Upcoming calls",
+    callsNeedAttention: "{count} need attention",
+    noUpcomingCalls: "No upcoming calls.",
+    drift: "drift",
+    open: "Open",
+    meet: "Meet",
+    applications: "Applications",
+    newMembers: "New members",
+    newMembersUnavailable: "Appears once billing is connected.",
+    revenueAdded: "Revenue \xB7 annual run rate added",
+    revenue: "Revenue",
+    revenueUnavailable: "Appears once billing is connected.",
+    pipeline: "Pipeline",
+    pipelineLabel: "Membership pipeline",
+    thisWeek: "+{count} this week",
+    noChange: "no change",
+    activeMemberships: "Active memberships",
+    annualRunRate: "Annual run rate",
+    testMode: "test mode"
+  },
+  billing: {
+    loading: "Loading\u2026",
+    loadFailed: "Couldn't load billing",
+    notConfigured: "Billing isn't configured. No Stripe key is vaulted for this group.",
+    active: "Active",
+    annualized: "Annualized",
+    renewingSoon: "Renewing within 60 days",
+    pastDue: "Past due",
+    subscriptions: "Subscriptions",
+    testMode: "Stripe test mode",
+    truncated: "Showing the first 100 subscriptions. The list is truncated.",
+    name: "Name",
+    email: "Email",
+    application: "Application",
+    subscription: "Subscription",
+    cancelling: "cancelling",
+    amount: "Amount",
+    renews: "Renews"
+  },
+  availability: {
+    loading: "Loading\u2026",
+    loadFailed: "Couldn't load availability",
+    saved: "Saved.",
+    title: "Booking availability",
+    days: "Days",
+    startHour: "Start hour (0\u201324)",
+    endHour: "End hour (0\u201324)",
+    slotMinutes: "Slot length (minutes)",
+    minNoticeHours: "Minimum notice (hours)",
+    windowDays: "Booking window (days)",
+    timezone: "Timezone",
+    summaryTemplate: "Event summary template",
+    save: "Save availability",
+    dayLabels: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
+  },
+  email: {
+    loading: "Loading\u2026",
+    loadFailed: "Couldn't load email config",
+    saved: "Saved.",
+    sent: "Sent {template} to {address}{redirected}.",
+    testFailed: "Test send did not deliver.",
+    delivery: "Delivery",
+    notificationAddress: "Notification address",
+    replyTo: "Reply-to",
+    debugInbox: "Debug inbox",
+    debugInboxHint: "Non-production sends redirect here.",
+    sendTest: "Send test",
+    enabled: "Enabled",
+    subject: "Subject",
+    body: "Body",
+    save: "Save changes",
+    sendLog: "Send log",
+    sentColumn: "Sent",
+    templateColumn: "Template",
+    statusColumn: "Status",
+    toColumn: "To",
+    failed: "failed",
+    redirected: "redirected",
+    delivered: "delivered"
+  },
+  meetings: {
+    loading: "Loading\u2026",
+    loadFailed: "Couldn't load meetings",
+    cancelConfirm: "Cancel this call? The calendar provider notifies the attendee.",
+    newStartPrompt: "New start time (for example, 2026-08-01 14:00):",
+    parseFailed: "Couldn't parse that time.",
+    agenda: "Agenda",
+    empty: "No meetings.",
+    unknown: "(unknown)",
+    drift: "drift",
+    meet: "Meet",
+    reschedule: "Reschedule",
+    cancel: "Cancel"
+  },
+  network: {
+    title: "Share to a follower",
+    allowlistDescription: "Sends the target's allowlisted fields. Its pipeline and account state remain local.",
+    sharing: "Sharing\u2026",
+    shareWith: "Share with {target}",
+    shared: "Shared with {target}.",
+    shareFailed: "Could not share with {target}.",
+    deliveryFailed: "Delivery failed."
+  },
+  records: {
+    workflowMissing: "This record is not linked to an application workflow.",
+    comms: "Comms",
+    commsHistory: "Comms history",
+    scheduling: "Scheduling",
+    billing: "Billing",
+    notes: "Notes",
+    access: "Access",
+    sharing: "Sharing",
+    lifecycle: "Access & lifecycle",
+    role: "Role",
+    superAdminHint: "Super-admin, managed in odla Studio.",
+    noAccount: "No linked account yet. The role is set once they sign in.",
+    approve: "Approve",
+    refund: "Refund",
+    approved: "Approved.",
+    refunded: "Refund issued.",
+    roleSet: "Role set to {role}.",
+    messageSent: "Message sent.",
+    messageNotSent: "Message was not sent.",
+    loadingTemplates: "Loading templates\u2026",
+    template: "Template",
+    chooseTemplate: "Choose a template\u2026",
+    sending: "Sending\u2026",
+    send: "Send",
+    noMessages: "No messages recorded.",
+    message: "Message",
+    newStartPrompt: "New start time:",
+    parseFailed: "Couldn't parse that time.",
+    cancelConfirm: "Cancel this call?",
+    callCancelled: "Call cancelled.",
+    callRescheduled: "Call rescheduled.",
+    noApplication: "No application is linked to this record.",
+    loadingMeetings: "Loading meetings\u2026",
+    noMeetings: "No meetings recorded.",
+    joinMeeting: "Join meeting",
+    openCalendar: "Open calendar",
+    reschedule: "Reschedule",
+    cancel: "Cancel"
+  }
+};
+
+// src/copy-defaults.ts
+var DEFAULT_COMMON_COPY = {
+  loading: "Loading\u2026",
+  saved: "Saved.",
+  unknown: "(unknown)"
+};
+var DEFAULT_JOIN_COPY = {
+  form: {
+    submit: "Submit application",
+    submitting: "Submitting\u2026",
+    submitFailed: "Your application could not be submitted.",
+    unexpectedFailure: "Something went wrong. Please try again."
+  },
+  booking: {
+    unavailable: "Scheduling is briefly unavailable. We'll reach out by email to arrange your call.",
+    loadFailed: "Times are briefly unavailable. Please try again.",
+    slotTaken: "That time was just taken. Here are the current openings.",
+    failed: "The booking could not be completed.",
+    loading: "Loading available times\u2026",
+    book: "Book this time",
+    booking: "Booking\u2026"
+  },
+  payment: {
+    setupFailed: "Payment could not be set up. Please try again.",
+    preparing: "Preparing secure payment\u2026",
+    pending: "Confirming your payment\u2026",
+    processing: "Processing\u2026",
+    payAndContinue: "Pay and continue",
+    incomplete: "The payment did not complete. Please try again.",
+    consent: "I have read and agree to the pricing and refund policy above."
+  },
+  done: {
+    label: "You're booked",
+    calendarInvite: "A calendar invitation with the video call link is on its way to your email.",
+    memberArea: "Go to your member area"
+  }
+};
+var DEFAULT_MEMBERS_COPY = {
+  loadFailed: "Sign in is briefly unavailable. Please refresh.",
+  account: {
+    signOut: "Sign out",
+    adminConsole: "Admin console"
+  },
+  provisional: {
+    cardLabel: "Your Application",
+    applicationNeeded: "One step remains",
+    applicationNeededBody: "Your account is ready, and the application that completes it takes a few minutes.",
+    apply: "Apply for membership",
+    refunded: "Membership refunded",
+    refundedBody: "Your fee has been refunded in full and your membership is canceled.",
+    active: "Your membership is active.",
+    renews: "Your membership is active and renews {date}.",
+    introductionCall: "Your introduction call",
+    calendarInvite: "A calendar invitation with the video call link is in your email.",
+    joinCall: "Join the video call",
+    bookCall: "Book your introduction call",
+    bookCallBody: "Your application is in. Choose a time below, and a calendar invitation will reach your email.",
+    chooseTime: "Choose a time"
+  },
+  full: {
+    welcome: "Welcome back."
+  },
+  reschedule: {
+    changeTime: "Change your time",
+    unavailable: "Scheduling is briefly unavailable. We'll reach out by email to arrange your call.",
+    loadFailed: "Times are briefly unavailable. Please try again.",
+    slotGone: "That time is no longer available. Please pick another.",
+    loading: "Loading available times\u2026",
+    noTimes: "No open times right now. Please check back soon.",
+    rescheduling: "Rescheduling\u2026",
+    keepTime: "Keep my current time"
+  }
+};
+
+// src/copy-resolve.ts
+var DEFAULT_CHAPTER_COPY = {
+  common: DEFAULT_COMMON_COPY,
+  join: DEFAULT_JOIN_COPY,
+  members: DEFAULT_MEMBERS_COPY,
+  admin: DEFAULT_ADMIN_COPY
+};
+var isObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+function mergeCopy(base, input, path) {
+  if (typeof base === "string") {
+    if (input === void 0) return base;
+    if (typeof input !== "string") throw new Error(`${path}: must be a string`);
+    return input;
+  }
+  if (Array.isArray(base)) {
+    if (input === void 0) return [...base];
+    if (!Array.isArray(input) || !input.every((item) => typeof item === "string")) {
+      throw new Error(`${path}: must be an array of strings`);
+    }
+    return [...input];
+  }
+  if (!isObject(base)) return base;
+  if (input !== void 0 && !isObject(input)) throw new Error(`${path}: must be an object`);
+  const overrides = input;
+  const result = {};
+  for (const [key, value] of Object.entries(base)) {
+    result[key] = mergeCopy(value, overrides?.[key], `${path}.${key}`);
+  }
+  return result;
+}
+function resolveChapterCopy(input) {
+  return mergeCopy(DEFAULT_CHAPTER_COPY, input, "defineChapter.copy");
+}
+function formatChapterCopy(template, values) {
+  return template.replace(
+    /\{([a-zA-Z][a-zA-Z0-9]*)\}/g,
+    (match, key) => Object.prototype.hasOwnProperty.call(values, key) ? String(values[key]) : match
+  );
+}
+
 // src/config.ts
 var SLUG = /^[a-z0-9][a-z0-9-]{1,62}$/;
 var FIELD = /^[a-z][a-zA-Z0-9_]*$/;
@@ -557,11 +851,15 @@ function defineChapter(config) {
     if (!config.prices || typeof config.prices.standardCents !== "number") {
       throw new Error("defineChapter.prices.standardCents: required in chapter mode");
     }
+    if (config.account === void 0) {
+      throw new Error('defineChapter.account: required in chapter mode; choose "none", "create", or "invite" explicitly');
+    }
   }
   const auth = resolveAuth(mode, config.auth);
   const pipeline = resolvePipeline(config.pipeline);
   const application = resolveApplication(config.application);
   const brand = { ...config.brand, wordmark: config.brand?.wordmark ?? name };
+  const copy = resolveChapterCopy(config.copy);
   const network = resolveNetwork(config, crm);
   const { schema, rules } = chapterDb(mode, auth);
   const services = config.services ?? ["db", "calendar", "o11y"];
@@ -616,6 +914,7 @@ function defineChapter(config) {
     name,
     mode,
     brand,
+    copy,
     network,
     crm,
     auth,
@@ -651,6 +950,16 @@ function createChapterIntegration(chapter, options = {}) {
   if (group) {
     seeds.push({ id: "group", ns: "groups", key: { attr: "id", value: chapter.id }, attrs: { ...group, createdAt: now } });
   }
+  const isLeader = (chapter.config.network?.targets?.length ?? 0) > 0;
+  const runbooks = isLeader ? {
+    role: "leader",
+    slugs: ["chapter-leader", "chapter-network", "crm"],
+    guidance: `${chapter.name} is a LEADER hub: it holds the CRM and shares records with its chapters. Read it with \`odla-ai runbook get chapter-leader\`.`
+  } : {
+    role: "follower",
+    slugs: ["chapter-follower", "chapter-network"],
+    guidance: `${chapter.name} is a FOLLOWER site: it receives people and records from a leader hub. Read it with \`odla-ai runbook get chapter-follower\`.`
+  };
   return {
     id: "chapter",
     title: `Chapter: ${chapter.name}`,
@@ -661,7 +970,8 @@ function createChapterIntegration(chapter, options = {}) {
     },
     rules: { ...crmDesc.rules, ...chapter.rules },
     seeds,
-    probes: [...crmDesc.probes ?? []]
+    probes: [...crmDesc.probes ?? []],
+    runbooks
   };
 }
 
@@ -1048,7 +1358,7 @@ function billingColumns(app) {
 async function syncApplicationToCrm(deps, opts) {
   const emailKey = str(opts.app.email).toLowerCase();
   if (!emailKey) return null;
-  const crmDeps = { crm: deps.crm, db: deps.db, now: deps.now, newId: deps.newId };
+  const recordDeps = { crm: deps.crm, db: deps.db, now: deps.now, newId: deps.newId };
   const input = personInputFromApp(deps.chapter, opts.app);
   const { crm_record } = await deps.db.query({
     crm_record: { $: { where: { type: "person", primaryEmail: emailKey }, limit: 1 } }
@@ -1058,16 +1368,16 @@ async function syncApplicationToCrm(deps, opts) {
   let recordId;
   if (existing && typeof existing.id === "string") {
     recordId = existing.id;
-    await updateRecord2(crmDeps, { id: recordId, input });
+    await updateRecord2(recordDeps, { id: recordId, input });
   } else {
-    const created = await createRecord2(crmDeps, { type: "person", input, ...stage ? { stage } : {} });
+    const created = await createRecord2(recordDeps, { type: "person", input, ...stage ? { stage } : {} });
     recordId = created.id;
   }
   if (existing && stage && existing.stage !== stage) {
-    await setStage(crmDeps, { id: recordId, to: stage, authorId: "system", mutationId: `crm:stage:${recordId}:${stage}` }).catch(() => void 0);
+    await setStage(recordDeps, { id: recordId, to: stage, authorId: "system", mutationId: `crm:stage:${recordId}:${stage}` }).catch(() => void 0);
   }
   await deps.db.transact([{ t: "update", ns: "crm_record", id: recordId, attrs: billingColumns(opts.app) }]);
-  await linkIdentity(crmDeps, { recordId, email: emailKey, mutationId: `crm:link:${recordId}:${emailKey}` }).catch(() => void 0);
+  await linkIdentity(recordDeps, { recordId, email: emailKey, mutationId: `crm:link:${recordId}:${emailKey}` }).catch(() => void 0);
   return recordId;
 }
 async function backfillCrm(deps) {
@@ -1437,6 +1747,7 @@ function brandTokens(brand, options = {}) {
   if (fonts?.body) light.push(`--ui-font-sans: ${cleanValue(fonts.body)};`);
   if (fonts?.numeral) light.push(`--ui-font-numeral: ${cleanValue(fonts.numeral)};`);
   const dark = [...paletteDecls(brand.paletteDark), ...semanticDecls(brand.tokensDark)];
+  const invert = paletteDecls(brand.paletteInvert);
   const selector = options.selector ?? ":root";
   const darkSelector = selector === ":root" ? ':root[data-theme="dark"]' : `${selector}[data-theme="dark"]`;
   const systemSelector = selector === ":root" ? ':root:not([data-theme="light"])' : `${selector}:not([data-theme="light"])`;
@@ -1452,10 +1763,26 @@ function brandTokens(brand, options = {}) {
 @media (prefers-color-scheme: dark) {
   ${systemSelector} ${block}
 }
+`;
+  }
+  if (invert.length) {
+    const invertSelector = selector === ":root" ? ".ui-invert" : `${selector}.ui-invert, ${selector} .ui-invert`;
+    css += `${invertSelector} {
+  color-scheme: dark;
+  ${invert.join("\n  ")}
+}
 `;
   }
   return css;
 }
+function chapterBrandFromTokens(compiled, base = {}) {
+  return {
+    ...base,
+    palette: { ...compiled.light, ...base.palette },
+    paletteDark: { ...compiled.dark, ...base.paletteDark },
+    paletteInvert: { ...compiled.dark, ...base.paletteInvert }
+  };
+}
 
 // src/reconcile.ts
 function isReconcilable(meeting, now) {
@@ -1596,6 +1923,7 @@ function applicationBookingUpdate(currentStatus, startAt, htmlLink) {
   };
 }
 export {
+  DEFAULT_CHAPTER_COPY,
   DEFAULT_SHARE_FIELDS,
   SCHEDULING_DEFAULTS,
   applicantProfile,
@@ -1611,6 +1939,7 @@ export {
   canChangeRole,
   canTransition,
   canceledPatch,
+  chapterBrandFromTokens,
   chapterDb,
   clampArray,
   clerkGetUser,
@@ -1630,6 +1959,7 @@ export {
   endForSlot,
   findApplicationRef,
   firstPaymentPatch,
+  formatChapterCopy,
   getVaultSecret,
   hasDisclaimerAck,
   introIdempotencyKey,
@@ -1659,6 +1989,7 @@ export {
   renewalPatch,
   resolveApplication,
   resolveAuth,
+  resolveChapterCopy,
   resolvePipeline,
   resolveScheduling,
   roleFromClaim,