@odla-ai/chapter 0.29.0 → 0.31.0

package/dist/index.cjs

@@ -31,6 +31,7 @@ __export(index_exports, {
   brandTokens: () => brandTokens,
   bucketSeries: () => bucketSeries,
   buildGroupSeed: () => buildGroupSeed,
+  buildTierSeeds: () => buildTierSeeds,
   canApprove: () => canApprove,
   canBook: () => canBook,
   canChangeRole: () => canChangeRole,
@@ -55,6 +56,7 @@ __export(index_exports, {
   emailGroupFrom: () => emailGroupFrom,
   endForSlot: () => endForSlot,
   findApplicationRef: () => findApplicationRef,
+  findTier: () => findTier,
   firstPaymentPatch: () => firstPaymentPatch,
   formatChapterCopy: () => formatChapterCopy,
   formationFields: () => formationFields,
@@ -67,7 +69,10 @@ __export(index_exports, {
   isSlotAvailable: () => isSlotAvailable,
   isValidEmail: () => isValidEmail,
   joinConfig: () => joinConfig,
+  joinConfigTiers: () => joinConfigTiers,
   leaderCrmConfig: () => leaderCrmConfig,
+  loadOfferableTiers: () => loadOfferableTiers,
+  loadTiers: () => loadTiers,
   meetingCreateRow: () => meetingCreateRow,
   meetingRescheduleUpdate: () => meetingRescheduleUpdate,
   memberApplication: () => memberApplication,
@@ -75,6 +80,7 @@ __export(index_exports, {
   networkSourceTag: () => networkSourceTag,
   normalizeSharedRecord: () => normalizeSharedRecord,
   normalizeWebhookEvent: () => normalizeWebhookEvent,
+  offerableTiers: () => offerableTiers,
   paymentsReady: () => paymentsReady,
   personInputFromApp: () => personInputFromApp,
   planDelivery: () => planDelivery,
@@ -92,6 +98,7 @@ __export(index_exports, {
   resolveLeaderFormation: () => resolveLeaderFormation,
   resolvePipeline: () => resolvePipeline,
   resolveScheduling: () => resolveScheduling,
+  resolveTiers: () => resolveTiers,
   roleFromClaim: () => roleFromClaim,
   sendTemplated: () => sendTemplated,
   sharedPersonInput: () => sharedPersonInput,
@@ -104,6 +111,8 @@ __export(index_exports, {
   submitApplication: () => submitApplication,
   subscriptionIdempotencyKey: () => subscriptionIdempotencyKey,
   syncApplicationToCrm: () => syncApplicationToCrm,
+  tierIsFree: () => tierIsFree,
+  tierPayable: () => tierPayable,
   updateClerkUserMetadata: () => updateClerkUserMetadata,
   updateClerkUserMetadataByEmail: () => updateClerkUserMetadataByEmail,
   validateScheduling: () => validateScheduling,
@@ -113,7 +122,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/config.ts
-var import_crm = require("@odla-ai/crm");
+var import_crm2 = require("@odla-ai/crm");
 
 // src/schema.ts
 function attr(type, flags = {}) {
@@ -178,6 +187,8 @@ var applications = {
     phone: attr("string", { optional: true }),
     state: attr("string", { optional: true }),
     groupId: attr("string", { indexed: true, optional: true }),
+    // The tier this application joined on. Absent on rows that predate tiers.
+    tierId: attr("string", { indexed: true, optional: true }),
     stripeCustomerId: attr("string", { indexed: true, optional: true }),
     stripeSubscriptionId: attr("string", { indexed: true, optional: true }),
     renewalAt: attr("number", { optional: true }),
@@ -209,6 +220,19 @@ var groups = {
     createdAt: attr("number", { indexed: true })
   }
 };
+var tiers = {
+  attrs: {
+    id: id(),
+    groupId: attr("string", { indexed: true }),
+    name: attr("string"),
+    priceCents: attr("number"),
+    stripePriceId: attr("string", { optional: true }),
+    blurb: attr("string", { optional: true }),
+    sortOrder: attr("number", { indexed: true }),
+    active: attr("boolean", { indexed: true }),
+    createdAt: attr("number", { indexed: true })
+  }
+};
 var meetings = {
   attrs: {
     id: id(),
@@ -250,6 +274,7 @@ function chapterDb(mode, auth, includeNetworkNotes = false) {
   if (mode === "chapter") {
     entities.applications = applications;
     entities.groups = groups;
+    entities.tiers = tiers;
     entities.meetings = meetings;
     entities.emailLog = emailLog;
   }
@@ -510,6 +535,9 @@ function canApprove(status, p) {
   return p.approvableFrom.includes(status);
 }
 
+// src/member.ts
+var import_crm = require("@odla-ai/crm");
+
 // src/application-id.ts
 var APPLICATION_ID_DOMAIN = "odla-ai/chapter/application/v1:";
 async function applicationIdForSubmission(submissionId) {
@@ -538,9 +566,21 @@ function resolveApplication(a) {
   if (a?.crmFields !== void 0 && (!Array.isArray(a.crmFields) || !a.crmFields.every((f) => typeof f === "string" && f !== ""))) {
     throw new Error("defineChapter.application.crmFields: must be an array of field-name strings");
   }
+  const conditions = a?.conditions ?? {};
+  for (const [field, declared] of Object.entries(conditions)) {
+    for (const key of ["visibleWhen", "requiredWhen"]) {
+      const expression = declared?.[key];
+      if (expression === void 0) continue;
+      if (typeof expression !== "string" || !expression.trim()) {
+        throw new Error(`defineChapter.application.conditions.${field}.${key}: must be a non-empty CEL condition`);
+      }
+      (0, import_crm.assertFieldCondition)(expression, `defineChapter.application.conditions.${field}.${key}`);
+    }
+  }
   return {
     required,
     optional,
+    conditions,
     maxLen: a?.maxLen ?? {},
     defaultMaxLen: a?.defaultMaxLen ?? 2e3,
     bodyCap: a?.bodyCap ?? 32768,
@@ -577,7 +617,9 @@ function applicantProfile(chapter, fields) {
 }
 async function submitApplication(db, chapter, fields, opts) {
   const app = chapter.application;
-  for (const f of app.required) {
+  const fieldStates = (0, import_crm.resolveFieldStates)(app.conditions ?? {}, fields, app.required);
+  for (const [f, state] of Object.entries(fieldStates)) {
+    if (!state.required) continue;
     const v = fields[f];
     if (typeof v !== "string" || v.trim() === "") return { ok: false, error: `${f} is required` };
   }
@@ -596,10 +638,17 @@ async function submitApplication(db, chapter, fields, opts) {
   const id2 = opts.submissionId ? await applicationIdForSubmission(opts.submissionId) : opts.newId();
   const row = { id: id2, status: chapter.pipeline.initial, createdAt: opts.now };
   for (const f of [...app.required, ...app.optional]) {
+    if (fieldStates[f]?.visible === false) continue;
     if (typeof fields[f] === "string") row[f] = fields[f].trim();
   }
   if (fields.focus !== void 0) row.focus = clampArray(fields.focus, app.maxArrayLen);
   if (opts.groupId) row.groupId = opts.groupId;
+  if (typeof fields.tierId === "string" && fields.tierId) {
+    if (opts.tierIds && !opts.tierIds.includes(fields.tierId)) {
+      return { ok: false, error: "tierId is not an offered tier" };
+    }
+    row.tierId = fields.tierId;
+  }
   if (acked) row.disclaimerAckAt = opts.now;
   const { duplicate } = await db.transact(
     [{ t: "update", ns: "applications", id: id2, attrs: row }],
@@ -607,12 +656,15 @@ async function submitApplication(db, chapter, fields, opts) {
   );
   return { ok: true, id: id2, duplicate, status: chapter.pipeline.initial, disclaimerAckAt: acked ? opts.now : null };
 }
-function joinConfig(group, paymentsReady2) {
+function joinConfig(group, paymentsReady2, tiers2 = [], conditions = {}) {
   return {
     id: group.id,
     name: group.name,
     standardPriceCents: group.standardPriceCents ?? 0,
     foundingDiscountCents: group.foundingDiscountCents ?? 0,
+    tiers: [...tiers2],
+    // The browser evaluates the same conditions the server enforces.
+    conditions,
     disclaimerText: group.disclaimerText ?? "",
     refundPolicyText: group.refundPolicyText ?? "",
     trustCopy: group.trustCopy ?? "",
@@ -1151,7 +1203,7 @@ function defineChapter(config) {
   if (typeof name !== "string" || name.trim() === "") throw new Error("defineChapter.name: a non-empty name is required");
   const mode = config.mode ?? "chapter";
   if (mode !== "chapter" && mode !== "hub") throw new Error(`defineChapter.mode: must be "chapter" or "hub" \u2014 got ${JSON.stringify(config.mode)}`);
-  const crm = isResolvedCrm(config.crm) ? config.crm : (0, import_crm.defineCrm)(config.crm ?? defaultCrm(mode));
+  const crm = isResolvedCrm(config.crm) ? config.crm : (0, import_crm2.defineCrm)(config.crm ?? defaultCrm(mode));
   if (mode === "chapter") {
     if (!config.emails || typeof config.emails.notificationEmail !== "string" || config.emails.notificationEmail === "") {
       throw new Error("defineChapter.emails.notificationEmail: required in chapter mode");
@@ -1243,7 +1295,7 @@ function defineChapter(config) {
 }
 
 // src/leader.ts
-var import_crm2 = require("@odla-ai/crm");
+var import_crm3 = require("@odla-ai/crm");
 function leaderCrmConfig(options = {}) {
   const base = options.base ?? defaultCrm("hub");
   const defaultChapter = {
@@ -1402,16 +1454,72 @@ function leaderCrmConfig(options = {}) {
       reverseLabel: "applicant"
     };
   }
-  return (0, import_crm2.composeCrmConfigs)(base, portfolio);
+  return (0, import_crm3.composeCrmConfigs)(base, portfolio);
+}
+
+// src/descriptor.ts
+var import_crm4 = require("@odla-ai/crm");
+
+// src/tiers.ts
+function buildTierSeeds(groupId, configured = [], now = 0) {
+  return configured.map((tier, index) => ({
+    id: tier.id,
+    groupId,
+    name: tier.name,
+    priceCents: tier.priceCents,
+    ...tier.stripePriceId ? { stripePriceId: tier.stripePriceId } : {},
+    ...tier.blurb ? { blurb: tier.blurb } : {},
+    sortOrder: tier.sortOrder ?? index,
+    active: tier.active !== false,
+    createdAt: now
+  }));
+}
+function tierIsFree(tier) {
+  return !(tier.priceCents > 0) && !tier.stripePriceId;
+}
+function tierPayable(tier, group, hasSecretKey) {
+  if (tierIsFree(tier)) return true;
+  return Boolean(group.stripePublishableKey && tier.stripePriceId && hasSecretKey);
+}
+function byOrder(a, b) {
+  return a.sortOrder - b.sortOrder || a.id.localeCompare(b.id);
+}
+function resolveTiers(group, rows = []) {
+  const stored = rows.filter((tier) => tier.active);
+  if (stored.length) return [...stored].sort(byOrder);
+  return [{
+    id: "standard",
+    groupId: String(group.id ?? ""),
+    name: "Membership",
+    priceCents: group.standardPriceCents ?? 0,
+    ...group.stripePriceId ? { stripePriceId: group.stripePriceId } : {},
+    sortOrder: 0,
+    active: true
+  }];
+}
+function offerableTiers(tiers2, group, hasSecretKey) {
+  return tiers2.filter((tier) => tier.active && tierPayable(tier, group, hasSecretKey));
+}
+function findTier(tiers2, tierId) {
+  if (!tierId) return tiers2.length === 1 ? tiers2[0] : null;
+  return tiers2.find((tier) => tier.id === tierId) ?? null;
+}
+function joinConfigTiers(tiers2) {
+  return tiers2.map((tier) => ({
+    id: tier.id,
+    name: tier.name,
+    priceCents: tier.priceCents,
+    blurb: tier.blurb ?? "",
+    free: tierIsFree(tier)
+  }));
 }
 
 // src/descriptor.ts
-var import_crm3 = require("@odla-ai/crm");
 function createChapterIntegration(chapter, options = {}) {
   const basePath = options.basePath ?? "/api/crm";
   const now = options.now ?? Date.now();
   const emails = chapter.config.emails;
-  const crmDesc = (0, import_crm3.createCrmIntegration)(chapter.crm, {
+  const crmDesc = (0, import_crm4.createCrmIntegration)(chapter.crm, {
     basePath,
     now,
     ...emails?.notificationEmail ? { notificationEmail: emails.notificationEmail } : {},
@@ -1422,6 +1530,14 @@ function createChapterIntegration(chapter, options = {}) {
   const group = chapter.groupSeed();
   if (group) {
     seeds.push({ id: "group", ns: "groups", key: { attr: "id", value: chapter.id }, attrs: { ...group, createdAt: now } });
+    for (const tier of buildTierSeeds(chapter.id, chapter.config.tiers, now)) {
+      seeds.push({
+        id: `tier:${String(tier.id)}`,
+        ns: "tiers",
+        key: { attr: "id", value: String(tier.id) },
+        attrs: tier
+      });
+    }
   }
   const isLeader = (chapter.config.network?.targets?.length ?? 0) > 0;
   const runbooks = isLeader ? {
@@ -1660,7 +1776,7 @@ function canceledPatch() {
 }
 
 // src/network.ts
-var import_crm4 = require("@odla-ai/crm");
+var import_crm5 = require("@odla-ai/crm");
 
 // src/network-contract.ts
 var DEFAULT_SHARE_FIELDS = {
@@ -1762,14 +1878,14 @@ async function upsertPerson(deps, opts) {
   const { crm_record } = await deps.db.query({ crm_record: { $: { where: { type: "person", primaryEmail: email }, limit: 1 } } });
   const existing = crm_record?.[0];
   if (existing && typeof existing.id === "string") {
-    await (0, import_crm4.updateRecord)(crmDeps, { id: existing.id, input: opts.input });
+    await (0, import_crm5.updateRecord)(crmDeps, { id: existing.id, input: opts.input });
     return { recordId: existing.id };
   }
-  const created = await (0, import_crm4.createRecord)(crmDeps, { type: "person", input: opts.input, mutationId: opts.mutationId });
+  const created = await (0, import_crm5.createRecord)(crmDeps, { type: "person", input: opts.input, mutationId: opts.mutationId });
   return { recordId: created.id };
 }
 async function findSharedRecord(deps, record, tag) {
-  const structured = await (0, import_crm4.getRecordByOrigin)(
+  const structured = await (0, import_crm5.getRecordByOrigin)(
     { crm: deps.crm, db: deps.db, now: deps.now, newId: deps.newId },
     record.sourceId,
     record.sourceRecordId
@@ -1821,11 +1937,11 @@ async function projectSharedRecord(deps, shared, options = {}) {
   const existing = await findSharedRecord(deps, record, tag);
   let recordId;
   if (existing && typeof existing.id === "string") {
-    await (0, import_crm4.updateRecord)(crmDeps, { id: existing.id, input: record.input });
+    await (0, import_crm5.updateRecord)(crmDeps, { id: existing.id, input: record.input });
     recordId = existing.id;
   } else {
     recordId = `network_${shortHash(`${record.sourceId}\0${record.type}\0${record.sourceRecordId}`)}`;
-    await (0, import_crm4.createRecord)({ ...crmDeps, newId: () => recordId }, {
+    await (0, import_crm5.createRecord)({ ...crmDeps, newId: () => recordId }, {
       type: record.type,
       input: record.input,
       mutationId: `share-create:${tag}`
@@ -1835,7 +1951,7 @@ async function projectSharedRecord(deps, shared, options = {}) {
     [{ t: "update", ns: "crm_tag", id: tag, attrs: { key: `${recordId}:${tag}`, recordId, tag, createdAt: deps.now() } }],
     { mutationId: `share-map:${tag}:${recordId}` }
   );
-  await (0, import_crm4.upsertRecordOrigin)(crmDeps, {
+  await (0, import_crm5.upsertRecordOrigin)(crmDeps, {
     recordId,
     sourceId: record.sourceId,
     sourceRecordId: record.sourceRecordId,
@@ -1864,7 +1980,7 @@ async function projectApplicant(deps, applicant) {
 }
 
 // src/crm-sync.ts
-var import_crm5 = require("@odla-ai/crm");
+var import_crm6 = require("@odla-ai/crm");
 var str = (v) => typeof v === "string" ? v : v == null ? "" : String(v);
 function personInputFromApp(chapter, app) {
   const input = sharedPersonInput({
@@ -1904,16 +2020,16 @@ async function syncApplicationToCrm(deps, opts) {
   let recordId;
   if (existing && typeof existing.id === "string") {
     recordId = existing.id;
-    await (0, import_crm5.updateRecord)(recordDeps, { id: recordId, input });
+    await (0, import_crm6.updateRecord)(recordDeps, { id: recordId, input });
   } else {
-    const created = await (0, import_crm5.createRecord)(recordDeps, { type: "person", input, ...stage ? { stage } : {} });
+    const created = await (0, import_crm6.createRecord)(recordDeps, { type: "person", input, ...stage ? { stage } : {} });
     recordId = created.id;
   }
   if (existing && stage && existing.stage !== stage) {
-    await (0, import_crm5.setStage)(recordDeps, { id: recordId, to: stage, authorId: "system", mutationId: `crm:stage:${recordId}:${stage}` }).catch(() => void 0);
+    await (0, import_crm6.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 (0, import_crm5.linkIdentity)(recordDeps, { recordId, email: emailKey, mutationId: `crm:link:${recordId}:${emailKey}` }).catch(() => void 0);
+  await (0, import_crm6.linkIdentity)(recordDeps, { recordId, email: emailKey, mutationId: `crm:link:${recordId}:${emailKey}` }).catch(() => void 0);
   return recordId;
 }
 async function backfillCrm(deps) {
@@ -2160,18 +2276,22 @@ var clerkIntegration = {
   ],
   secrets: [
     {
-      key: "CLERK_WEBHOOK_SECRET",
+      // odla-db reads this exact name (CLERK_WEBHOOK_SECRET_NAME in the
+      // platform's clerk-webhook.ts); it is also what `odla-ai secrets set`
+      // writes. It read "CLERK_WEBHOOK_SECRET" until 0.30.0, which sent
+      // adopters to store the value under a name nothing looks up.
+      name: "clerk_webhook_secret",
       description: "Svix signing secret for Clerk user webhooks \u2014 verifies $users sync events.",
       pattern: "whsec_",
       mode: "full",
-      vault: true
+      required: false
     },
     {
-      key: "clerk_secret_key",
+      name: "clerk_secret_key",
       description: "Clerk backend key (sk_*) \u2014 powers account creation, the public role claim, and backend-only private profile signals; it also lets odla-db resolve user email/name via the Clerk API.",
       pattern: "sk_",
       mode: "full",
-      vault: true
+      required: false
     }
   ],
   syncs: [
@@ -2489,4 +2609,36 @@ function applicationBookingUpdate(currentStatus, startAt, htmlLink) {
     ...currentStatus !== "call_scheduled" ? { status: "call_scheduled" } : {}
   };
 }
+
+// src/tiers-store.ts
+function rowToTier(row, groupId) {
+  return {
+    id: String(row.id ?? ""),
+    groupId: String(row.groupId ?? groupId),
+    name: String(row.name ?? ""),
+    priceCents: typeof row.priceCents === "number" ? row.priceCents : 0,
+    ...typeof row.stripePriceId === "string" && row.stripePriceId ? { stripePriceId: row.stripePriceId } : {},
+    ...typeof row.blurb === "string" ? { blurb: row.blurb } : {},
+    sortOrder: typeof row.sortOrder === "number" ? row.sortOrder : 0,
+    // A row that never set `active` is offered; only an explicit false retires
+    // a tier, so a half-seeded row cannot silently hide a membership.
+    active: row.active !== false
+  };
+}
+async function loadTiers(db, group) {
+  const groupId = String(group.id ?? "");
+  let rows;
+  try {
+    rows = (await db.query({
+      tiers: { $: { where: { groupId }, order: { sortOrder: "asc" }, limit: 100 } }
+    })).tiers;
+  } catch {
+    rows = void 0;
+  }
+  const list = Array.isArray(rows) ? rows.map((row) => rowToTier(row, groupId)) : [];
+  return resolveTiers(group, list);
+}
+async function loadOfferableTiers(db, group, hasSecretKey) {
+  return offerableTiers(await loadTiers(db, group), group, hasSecretKey);
+}
 //# sourceMappingURL=index.cjs.map