@odla-ai/chapter 0.37.0 → 0.38.0

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

@@ -2,7 +2,7 @@ import * as preact from 'preact';
 import { ComponentChildren, JSX } from 'preact';
 import { d as MemberContentProjection, e as MemberContentPageProjection, b as ChapterCopy, f as ChapterBrand } from '../../copy-context-Pbs3keLx.js';
 export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-Pbs3keLx.js';
-import '@odla-ai/crm';
+import { FieldType, FieldConditions } from '@odla-ai/crm';
 
 /** A bookable slot: a start instant in epoch milliseconds. */
 interface Slot {
@@ -302,6 +302,38 @@ interface GiftOffer {
 /** Provider-free gift offer shape rendered by Chapter and exact CMS previews. */
 type PublicGiftOffer = Omit<GiftOffer, "stripePriceId" | "target">;
 
+/** Current public schema version for Chapter flow-field contracts. */
+declare const CHAPTER_FLOW_FIELDS_SCHEMA_VERSION: 1;
+/** Configurable Chapter intake journeys that publish field contracts. */
+type ChapterFieldFlow = "join" | "formation";
+/** Email comparison policy advertised by an email field. */
+type ChapterEmailIdentity = "literal";
+/**
+ * One effective field in a Chapter intake journey.
+ *
+ * IDs, value types, and options come from the follower-declared schema. A hub
+ * or CMS may select, order, and configure only those declared fields; it cannot
+ * use this presentation document to add storage or widen follower authority.
+ */
+interface ChapterFlowField {
+    id: string;
+    label: string;
+    type: FieldType;
+    required: boolean;
+    order: number;
+    maxLength?: number;
+    options?: readonly string[];
+    conditions?: FieldConditions;
+    /** Present only for an email identity field. Aliases such as `+tag` remain significant. */
+    emailIdentity?: ChapterEmailIdentity;
+}
+/** Ordered, versioned effective field state for one Chapter journey. */
+interface ChapterFlowFieldContract {
+    schemaVersion: typeof CHAPTER_FLOW_FIELDS_SCHEMA_VERSION;
+    flow: ChapterFieldFlow;
+    fields: readonly ChapterFlowField[];
+}
+
 /** The public join config (the shape `GET /api/join-config` returns). */
 interface JoinConfig {
     id: string;
@@ -314,6 +346,8 @@ interface JoinConfig {
     /** Resolved copy for the packaged join flow. */
     copy?: ChapterCopy["join"];
     giftOffers?: readonly PublicGiftOffer[];
+    /** Exact ordered field state accepted by the effective server-side join flow. */
+    fieldContract?: ChapterFlowFieldContract;
 }
 /** Server-validated state used to resume a join journey after a redirect. */
 type JoinFlowState = {

package/dist/worker/index.cjs

@@ -199,204 +199,10 @@ async function applicationIdForSubmission(submissionId) {
   return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
 
-// src/admission-grants-contract.ts
-var ADMISSION_GRANTS_SCHEMA_VERSION = 1;
-var ADMISSION_GRANTS_PATH = "/api/admission-grants";
-
-// src/signup-control-canonical.ts
-var encoder = new TextEncoder();
-function canonicalValue(value) {
-  if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
-    return JSON.stringify(value);
-  }
-  if (Array.isArray(value)) return `[${value.map(canonicalValue).join(",")}]`;
-  if (typeof value !== "object") throw new TypeError("signup control contains an unsupported value");
-  const record3 = value;
-  const entries = Object.keys(record3).sort().flatMap((key) => {
-    const item = record3[key];
-    return item === void 0 ? [] : [`${JSON.stringify(key)}:${canonicalValue(item)}`];
-  });
-  return `{${entries.join(",")}}`;
-}
-function canonicalSignupControl(value) {
-  return canonicalValue(value);
-}
-async function signupControlDigest(document) {
-  const digest = await crypto.subtle.digest("SHA-256", encoder.encode(canonicalSignupControl(document)));
-  return `sha256:${Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
-}
-
-// src/admission-grants.ts
-var ID = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/;
-var MAX_GRANTS = 2e3;
-var MAX_NOTE = 2e3;
-var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-var isAdmissionEmail = (value) => EMAIL_RE.test(value);
-function normalizeAdmissionEmail(email) {
+// src/email-identity.ts
+function normalizeChapterEmail(email) {
   return email.trim().toLowerCase();
 }
-function validateAdmissionGrantDocument(input) {
-  const errors = [];
-  const root = input && typeof input === "object" ? input : {};
-  if (root.schemaVersion !== ADMISSION_GRANTS_SCHEMA_VERSION) errors.push("document.schemaVersion must be 1");
-  const revision = Number(root.revision);
-  const generatedAt = Number(root.generatedAt);
-  if (!Number.isSafeInteger(revision) || revision < 1) errors.push("document.revision must be a positive integer");
-  if (!Number.isFinite(generatedAt) || generatedAt <= 0) errors.push("document.generatedAt must be epoch milliseconds");
-  const source = root.source && typeof root.source === "object" ? root.source : {};
-  const target = root.target && typeof root.target === "object" ? root.target : {};
-  const sourceId = typeof source.appId === "string" ? source.appId : "";
-  const sourceActor = typeof source.actor === "string" ? source.actor.trim() : "";
-  const chapterId = typeof target.chapterId === "string" ? target.chapterId : "";
-  const environment = typeof target.environment === "string" ? target.environment : "";
-  if (!ID.test(sourceId)) errors.push("document.source.appId must be an identifier");
-  if (!sourceActor || sourceActor.length > 256) errors.push("document.source.actor must be 1-256 characters");
-  if (!ID.test(chapterId)) errors.push("document.target.chapterId must be an identifier");
-  if (!ID.test(environment)) errors.push("document.target.environment must be an identifier");
-  if (!Array.isArray(root.grants)) errors.push("document.grants must be an array");
-  const rawGrants = Array.isArray(root.grants) ? root.grants : [];
-  if (rawGrants.length > MAX_GRANTS) errors.push(`document.grants supports at most ${MAX_GRANTS} entries`);
-  const grants = [];
-  const seenIds = /* @__PURE__ */ new Set();
-  const seenEmails = /* @__PURE__ */ new Set();
-  for (const [index, raw] of rawGrants.slice(0, MAX_GRANTS).entries()) {
-    const grant = raw && typeof raw === "object" ? raw : {};
-    const id = typeof grant.id === "string" ? grant.id : "";
-    const email = typeof grant.email === "string" ? grant.email.trim() : "";
-    const normalized = normalizeAdmissionEmail(email);
-    const decision = grant.decision;
-    const note = typeof grant.note === "string" ? grant.note.trim() : void 0;
-    const expiresAt = grant.expiresAt === void 0 ? void 0 : Number(grant.expiresAt);
-    if (!ID.test(id)) errors.push(`document.grants[${index}].id must be an identifier`);
-    if (seenIds.has(id)) errors.push(`document.grants repeats id "${id}"`);
-    if (!isAdmissionEmail(normalized)) errors.push(`document.grants[${index}].email must be valid`);
-    if (seenEmails.has(normalized)) errors.push(`document.grants repeats email "${normalized}"`);
-    if (decision !== "waive_interview" && decision !== "require_interview") {
-      errors.push(`document.grants[${index}].decision is invalid`);
-    }
-    if (note && note.length > MAX_NOTE) errors.push(`document.grants[${index}].note is too long`);
-    if (expiresAt !== void 0 && (!Number.isFinite(expiresAt) || expiresAt <= 0)) {
-      errors.push(`document.grants[${index}].expiresAt must be epoch milliseconds`);
-    }
-    seenIds.add(id);
-    seenEmails.add(normalized);
-    grants.push({
-      id,
-      email,
-      decision,
-      ...note ? { note } : {},
-      ...expiresAt !== void 0 ? { expiresAt } : {}
-    });
-  }
-  if (errors.length) return { ok: false, errors };
-  return {
-    ok: true,
-    value: {
-      schemaVersion: ADMISSION_GRANTS_SCHEMA_VERSION,
-      revision,
-      generatedAt,
-      source: { appId: sourceId, actor: sourceActor },
-      target: { chapterId, environment },
-      grants
-    }
-  };
-}
-var rows = (value) => Array.isArray(value) ? value : [];
-function asGrant(row) {
-  if (typeof row.id !== "string" || typeof row.emailNormalized !== "string") return null;
-  if (row.sourceScope !== "local" && row.sourceScope !== "parent") return null;
-  if (row.decision !== "waive_interview" && row.decision !== "require_interview") return null;
-  return row;
-}
-async function findAdmissionGrant(db, targetId, email, now) {
-  const emailNormalized = normalizeAdmissionEmail(email);
-  if (!isAdmissionEmail(emailNormalized)) return null;
-  const result = await db.query({ admissionGrants: { $: { where: { emailNormalized }, limit: 100 } } });
-  const active = rows(result.admissionGrants).map(asGrant).filter((grant) => Boolean(
-    grant && grant.targetId === targetId && grant.active === true && !grant.revokedAt && (!grant.expiresAt || grant.expiresAt > now) && !grant.consumedApplicationId
-  )).sort((a, b) => {
-    const scope = Number(b.sourceScope === "local") - Number(a.sourceScope === "local");
-    return scope || b.createdAt - a.createdAt;
-  });
-  return active[0] ?? null;
-}
-async function hasAdmissionRevision(db, sourceId, targetId, environment) {
-  const where = { sourceId, targetId, environment };
-  if (db.aggregate) {
-    return Number((await db.aggregate("admissionGrantRevisions", { count: true }, { where })).count ?? 0) > 0;
-  }
-  const found = await db.query({ admissionGrantRevisions: {} });
-  return rows(found.admissionGrantRevisions).some((row) => row.sourceId === sourceId && row.targetId === targetId && row.environment === environment);
-}
-async function loadLatestAdmissionRevision(db, sourceId, targetId, environment) {
-  if (!await hasAdmissionRevision(db, sourceId, targetId, environment)) return null;
-  const result = await db.query({ admissionGrantRevisions: { $: {
-    where: { sourceId, targetId, environment },
-    order: { revision: "desc" },
-    limit: 1
-  } } });
-  const row = rows(result.admissionGrantRevisions).sort((a, b) => Number(b.revision ?? 0) - Number(a.revision ?? 0))[0];
-  return row ? row : null;
-}
-async function materializeAdmissionGrants(db, envelope, previous, receivedAt) {
-  const { document, digest } = envelope;
-  const current = rows((await db.query({ admissionGrants: { $: {
-    where: { sourceScope: "parent", sourceId: document.source.appId, targetId: document.target.chapterId },
-    limit: MAX_GRANTS
-  } } })).admissionGrants);
-  const incomingIds = new Set(document.grants.map((grant) => `admission:parent:${document.source.appId}:${grant.id}`));
-  const ops = [];
-  for (const row of current) {
-    const id = String(row.id ?? "");
-    if (id && !incomingIds.has(id)) ops.push({ t: "update", ns: "admissionGrants", id, attrs: {
-      active: false,
-      revokedAt: receivedAt,
-      revokedBy: document.source.actor,
-      updatedAt: receivedAt,
-      updatedBy: document.source.actor
-    } });
-  }
-  for (const grant of document.grants) {
-    const id = `admission:parent:${document.source.appId}:${grant.id}`;
-    const existing = current.find((row) => row.id === id);
-    ops.push({ t: "update", ns: "admissionGrants", id, attrs: {
-      id,
-      sourceGrantId: grant.id,
-      sourceScope: "parent",
-      sourceId: document.source.appId,
-      targetId: document.target.chapterId,
-      email: grant.email,
-      emailNormalized: normalizeAdmissionEmail(grant.email),
-      decision: grant.decision,
-      ...grant.note ? { note: grant.note } : {},
-      ...grant.expiresAt ? { expiresAt: grant.expiresAt } : {},
-      active: true,
-      sourceRevision: document.revision,
-      createdAt: Number(existing?.createdAt ?? receivedAt),
-      createdBy: String(existing?.createdBy ?? document.source.actor),
-      updatedAt: receivedAt,
-      updatedBy: document.source.actor
-    } });
-    const retract = [
-      ...!grant.note && existing?.note !== void 0 ? ["note"] : [],
-      ...grant.expiresAt === void 0 && existing?.expiresAt !== void 0 ? ["expiresAt"] : []
-    ];
-    if (retract.length) ops.push({ t: "retract", ns: "admissionGrants", id, attrs: retract });
-  }
-  if (previous?.active) ops.push({ t: "update", ns: "admissionGrantRevisions", id: previous.id, attrs: { active: false } });
-  const revisionId = `admission-revision:${document.source.appId}:${document.target.environment}:${document.revision}`;
-  ops.push({ t: "update", ns: "admissionGrantRevisions", id: revisionId, attrs: {
-    id: revisionId,
-    sourceId: document.source.appId,
-    targetId: document.target.chapterId,
-    environment: document.target.environment,
-    revision: document.revision,
-    digest,
-    active: true,
-    receivedAt
-  } });
-  await db.transact(ops, { mutationId: `admission-grants:${document.source.appId}:${document.target.environment}:${document.revision}:${digest}` });
-}
 
 // src/member.ts
 var DEFAULT_REQUIRED = ["firstName", "lastName", "email", "referral", "whoYouAre", "message"];
@@ -449,9 +255,9 @@ function resolveApplication(a) {
     validateEmail: a?.validateEmail ?? true
   };
 }
-var EMAIL_RE2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function isValidEmail(value) {
-  return typeof value === "string" && EMAIL_RE2.test(value);
+  return typeof value === "string" && EMAIL_RE.test(value);
 }
 function clampArray(value, max) {
   if (!Array.isArray(value)) return value;
@@ -486,7 +292,7 @@ async function submitApplication(db, chapter, fields, opts) {
     const cap = app.maxLen[f] ?? app.defaultMaxLen;
     if (typeof v === "string" && v.length > cap) return { ok: false, error: `${f} exceeds ${cap} characters` };
   }
-  if (app.validateEmail && typeof fields.email === "string" && !isValidEmail(fields.email)) {
+  if (app.validateEmail && typeof fields.email === "string" && !isValidEmail(fields.email.trim())) {
     return { ok: false, error: "email must be a valid email address" };
   }
   const acked = hasDisclaimerAck(fields);
@@ -502,7 +308,7 @@ async function submitApplication(db, chapter, fields, opts) {
   if (fields.focus !== void 0) row.focus = clampArray(fields.focus, app.maxArrayLen);
   if (opts.groupId) row.groupId = opts.groupId;
   if (typeof fields.email === "string" && isValidEmail(fields.email.trim())) {
-    row.emailNormalized = normalizeAdmissionEmail(fields.email);
+    row.emailNormalized = normalizeChapterEmail(fields.email);
   }
   if (opts.admissionGrant?.decision === "waive_interview") {
     row.admissionGrantId = opts.admissionGrant.id;
@@ -730,6 +536,281 @@ function applicationBookingUpdate(currentStatus, startAt, htmlLink) {
   };
 }
 
+// src/admission-grants-contract.ts
+var ADMISSION_GRANTS_SCHEMA_VERSION = 1;
+var ADMISSION_GRANTS_PATH = "/api/admission-grants";
+
+// src/signup-control-canonical.ts
+var encoder = new TextEncoder();
+function canonicalValue(value) {
+  if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) return `[${value.map(canonicalValue).join(",")}]`;
+  if (typeof value !== "object") throw new TypeError("signup control contains an unsupported value");
+  const record3 = value;
+  const entries = Object.keys(record3).sort().flatMap((key) => {
+    const item = record3[key];
+    return item === void 0 ? [] : [`${JSON.stringify(key)}:${canonicalValue(item)}`];
+  });
+  return `{${entries.join(",")}}`;
+}
+function canonicalSignupControl(value) {
+  return canonicalValue(value);
+}
+async function signupControlDigest(document) {
+  const digest = await crypto.subtle.digest("SHA-256", encoder.encode(canonicalSignupControl(document)));
+  return `sha256:${Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+}
+
+// src/admission-grants.ts
+var ID = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/;
+var MAX_GRANTS = 2e3;
+var MAX_NOTE = 2e3;
+var EMAIL_RE2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var isAdmissionEmail = (value) => EMAIL_RE2.test(value);
+function normalizeAdmissionEmail(email) {
+  return normalizeChapterEmail(email);
+}
+function validateAdmissionGrantDocument(input) {
+  const errors = [];
+  const root = input && typeof input === "object" ? input : {};
+  if (root.schemaVersion !== ADMISSION_GRANTS_SCHEMA_VERSION) errors.push("document.schemaVersion must be 1");
+  const revision = Number(root.revision);
+  const generatedAt = Number(root.generatedAt);
+  if (!Number.isSafeInteger(revision) || revision < 1) errors.push("document.revision must be a positive integer");
+  if (!Number.isFinite(generatedAt) || generatedAt <= 0) errors.push("document.generatedAt must be epoch milliseconds");
+  const source = root.source && typeof root.source === "object" ? root.source : {};
+  const target = root.target && typeof root.target === "object" ? root.target : {};
+  const sourceId = typeof source.appId === "string" ? source.appId : "";
+  const sourceActor = typeof source.actor === "string" ? source.actor.trim() : "";
+  const chapterId = typeof target.chapterId === "string" ? target.chapterId : "";
+  const environment = typeof target.environment === "string" ? target.environment : "";
+  if (!ID.test(sourceId)) errors.push("document.source.appId must be an identifier");
+  if (!sourceActor || sourceActor.length > 256) errors.push("document.source.actor must be 1-256 characters");
+  if (!ID.test(chapterId)) errors.push("document.target.chapterId must be an identifier");
+  if (!ID.test(environment)) errors.push("document.target.environment must be an identifier");
+  if (!Array.isArray(root.grants)) errors.push("document.grants must be an array");
+  const rawGrants = Array.isArray(root.grants) ? root.grants : [];
+  if (rawGrants.length > MAX_GRANTS) errors.push(`document.grants supports at most ${MAX_GRANTS} entries`);
+  const grants = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  const seenEmails = /* @__PURE__ */ new Set();
+  for (const [index, raw] of rawGrants.slice(0, MAX_GRANTS).entries()) {
+    const grant = raw && typeof raw === "object" ? raw : {};
+    const id = typeof grant.id === "string" ? grant.id : "";
+    const email = typeof grant.email === "string" ? grant.email.trim() : "";
+    const normalized = normalizeAdmissionEmail(email);
+    const decision = grant.decision;
+    const note = typeof grant.note === "string" ? grant.note.trim() : void 0;
+    const expiresAt = grant.expiresAt === void 0 ? void 0 : Number(grant.expiresAt);
+    if (!ID.test(id)) errors.push(`document.grants[${index}].id must be an identifier`);
+    if (seenIds.has(id)) errors.push(`document.grants repeats id "${id}"`);
+    if (!isAdmissionEmail(normalized)) errors.push(`document.grants[${index}].email must be valid`);
+    if (seenEmails.has(normalized)) errors.push(`document.grants repeats email "${normalized}"`);
+    if (decision !== "waive_interview" && decision !== "require_interview") {
+      errors.push(`document.grants[${index}].decision is invalid`);
+    }
+    if (note && note.length > MAX_NOTE) errors.push(`document.grants[${index}].note is too long`);
+    if (expiresAt !== void 0 && (!Number.isFinite(expiresAt) || expiresAt <= 0)) {
+      errors.push(`document.grants[${index}].expiresAt must be epoch milliseconds`);
+    }
+    seenIds.add(id);
+    seenEmails.add(normalized);
+    grants.push({
+      id,
+      email,
+      decision,
+      ...note ? { note } : {},
+      ...expiresAt !== void 0 ? { expiresAt } : {}
+    });
+  }
+  if (errors.length) return { ok: false, errors };
+  return {
+    ok: true,
+    value: {
+      schemaVersion: ADMISSION_GRANTS_SCHEMA_VERSION,
+      revision,
+      generatedAt,
+      source: { appId: sourceId, actor: sourceActor },
+      target: { chapterId, environment },
+      grants
+    }
+  };
+}
+var rows = (value) => Array.isArray(value) ? value : [];
+function asGrant(row) {
+  if (typeof row.id !== "string" || typeof row.emailNormalized !== "string") return null;
+  if (row.sourceScope !== "local" && row.sourceScope !== "parent") return null;
+  if (row.decision !== "waive_interview" && row.decision !== "require_interview") return null;
+  return row;
+}
+async function findAdmissionGrant(db, targetId, email, now) {
+  const emailNormalized = normalizeAdmissionEmail(email);
+  if (!isAdmissionEmail(emailNormalized)) return null;
+  const result = await db.query({ admissionGrants: { $: { where: { emailNormalized }, limit: 100 } } });
+  const active = rows(result.admissionGrants).map(asGrant).filter((grant) => Boolean(
+    grant && grant.targetId === targetId && grant.active === true && !grant.revokedAt && (!grant.expiresAt || grant.expiresAt > now) && !grant.consumedApplicationId
+  )).sort((a, b) => {
+    const scope = Number(b.sourceScope === "local") - Number(a.sourceScope === "local");
+    return scope || b.createdAt - a.createdAt;
+  });
+  return active[0] ?? null;
+}
+async function hasAdmissionRevision(db, sourceId, targetId, environment) {
+  const where = { sourceId, targetId, environment };
+  if (db.aggregate) {
+    return Number((await db.aggregate("admissionGrantRevisions", { count: true }, { where })).count ?? 0) > 0;
+  }
+  const found = await db.query({ admissionGrantRevisions: {} });
+  return rows(found.admissionGrantRevisions).some((row) => row.sourceId === sourceId && row.targetId === targetId && row.environment === environment);
+}
+async function loadLatestAdmissionRevision(db, sourceId, targetId, environment) {
+  if (!await hasAdmissionRevision(db, sourceId, targetId, environment)) return null;
+  const result = await db.query({ admissionGrantRevisions: { $: {
+    where: { sourceId, targetId, environment },
+    order: { revision: "desc" },
+    limit: 1
+  } } });
+  const row = rows(result.admissionGrantRevisions).sort((a, b) => Number(b.revision ?? 0) - Number(a.revision ?? 0))[0];
+  return row ? row : null;
+}
+async function materializeAdmissionGrants(db, envelope, previous, receivedAt) {
+  const { document, digest } = envelope;
+  const current = rows((await db.query({ admissionGrants: { $: {
+    where: { sourceScope: "parent", sourceId: document.source.appId, targetId: document.target.chapterId },
+    limit: MAX_GRANTS
+  } } })).admissionGrants);
+  const incomingIds = new Set(document.grants.map((grant) => `admission:parent:${document.source.appId}:${grant.id}`));
+  const ops = [];
+  for (const row of current) {
+    const id = String(row.id ?? "");
+    if (id && !incomingIds.has(id)) ops.push({ t: "update", ns: "admissionGrants", id, attrs: {
+      active: false,
+      revokedAt: receivedAt,
+      revokedBy: document.source.actor,
+      updatedAt: receivedAt,
+      updatedBy: document.source.actor
+    } });
+  }
+  for (const grant of document.grants) {
+    const id = `admission:parent:${document.source.appId}:${grant.id}`;
+    const existing = current.find((row) => row.id === id);
+    ops.push({ t: "update", ns: "admissionGrants", id, attrs: {
+      id,
+      sourceGrantId: grant.id,
+      sourceScope: "parent",
+      sourceId: document.source.appId,
+      targetId: document.target.chapterId,
+      email: grant.email,
+      emailNormalized: normalizeAdmissionEmail(grant.email),
+      decision: grant.decision,
+      ...grant.note ? { note: grant.note } : {},
+      ...grant.expiresAt ? { expiresAt: grant.expiresAt } : {},
+      active: true,
+      sourceRevision: document.revision,
+      createdAt: Number(existing?.createdAt ?? receivedAt),
+      createdBy: String(existing?.createdBy ?? document.source.actor),
+      updatedAt: receivedAt,
+      updatedBy: document.source.actor
+    } });
+    const retract = [
+      ...!grant.note && existing?.note !== void 0 ? ["note"] : [],
+      ...grant.expiresAt === void 0 && existing?.expiresAt !== void 0 ? ["expiresAt"] : []
+    ];
+    if (retract.length) ops.push({ t: "retract", ns: "admissionGrants", id, attrs: retract });
+  }
+  if (previous?.active) ops.push({ t: "update", ns: "admissionGrantRevisions", id: previous.id, attrs: { active: false } });
+  const revisionId = `admission-revision:${document.source.appId}:${document.target.environment}:${document.revision}`;
+  ops.push({ t: "update", ns: "admissionGrantRevisions", id: revisionId, attrs: {
+    id: revisionId,
+    sourceId: document.source.appId,
+    targetId: document.target.chapterId,
+    environment: document.target.environment,
+    revision: document.revision,
+    digest,
+    active: true,
+    receivedAt
+  } });
+  await db.transact(ops, { mutationId: `admission-grants:${document.source.appId}:${document.target.environment}:${document.revision}:${digest}` });
+}
+
+// src/flow-fields.ts
+var CHAPTER_FLOW_FIELDS_SCHEMA_VERSION = 1;
+var APPLICATION_LABELS = {
+  firstName: "First name",
+  lastName: "Last name",
+  email: "Email",
+  referral: "Referral source",
+  referralName: "Referral name",
+  whoYouAre: "Who you are",
+  linkedin: "LinkedIn",
+  message: "Intro message",
+  phone: "Phone",
+  state: "State"
+};
+function humanize(id) {
+  const text3 = id.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
+  return text3 ? `${text3[0].toUpperCase()}${text3.slice(1)}` : id;
+}
+function applicationDefs(chapter) {
+  try {
+    return chapter.crm.type("person").fields;
+  } catch {
+    return {};
+  }
+}
+function applicationType(id, def) {
+  if (def && ["string", "email", "url", "enum"].includes(def.type)) return def.type;
+  return id === "email" ? "email" : id === "linkedin" ? "url" : "string";
+}
+function applicationFlowFields(chapter, application = chapter.application) {
+  const defs = applicationDefs(chapter);
+  return [...application.required, ...application.optional].map((id, order) => {
+    const def = defs[id];
+    const conditions = application.conditions[id];
+    const type = applicationType(id, def);
+    return {
+      id,
+      label: def?.label ?? APPLICATION_LABELS[id] ?? humanize(id),
+      type,
+      required: application.required.includes(id),
+      order,
+      maxLength: application.maxLen[id] ?? application.defaultMaxLen,
+      ...type === "enum" && def?.options ? { options: [...def.options] } : {},
+      ...conditions ? { conditions: { ...conditions } } : {},
+      ...type === "email" ? { emailIdentity: "literal" } : {}
+    };
+  });
+}
+function resolveFormationFlowFields(crm, formation) {
+  if (!formation.enabled) return [];
+  const def = crm.type(formation.type);
+  return [...formation.required, ...formation.optional].map((id, order) => {
+    const field = def.fields[id];
+    return {
+      id,
+      label: field.label ?? humanize(id),
+      type: field.type,
+      required: formation.required.includes(id),
+      order,
+      maxLength: formation.maxLen[id] ?? formation.defaultMaxLen,
+      ...field.options ? { options: [...field.options] } : {},
+      ...id === def.emailField || field.type === "email" ? { emailIdentity: "literal" } : {}
+    };
+  });
+}
+function formationFlowFields(chapter, formation = chapter.formation) {
+  return resolveFormationFlowFields(chapter.crm, formation);
+}
+function chapterFlowFieldContract(chapter, flow, application = chapter.application) {
+  return {
+    schemaVersion: CHAPTER_FLOW_FIELDS_SCHEMA_VERSION,
+    flow,
+    fields: flow === "join" ? applicationFlowFields(chapter, application) : formationFlowFields(chapter)
+  };
+}
+
 // src/gift-offers.ts
 var GIFT_OFFER_CATALOG_VERSION = 1;
 var MAX_GIFT_OFFERS = 20;
@@ -1735,7 +1816,7 @@ async function notifyAdminOfApplication(db, env, chapterId, applicationId, field
 // src/worker-routes.ts
 async function memberSessionApplication(db, chapterId, email) {
   let apps = (await db.query({ applications: { $: {
-    where: { emailNormalized: normalizeAdmissionEmail(email) },
+    where: { emailNormalized: normalizeChapterEmail(email) },
     limit: 20
   } } })).applications;
   if (!apps?.length) apps = (await db.query({ applications: { $: { where: { email }, limit: 20 } } })).applications;
@@ -1834,6 +1915,7 @@ var handleMember = async (req, url, env, ctx) => {
     const application = controlledApplication(chapter.application, activeControl?.document);
     return json({
       ...joinConfig(group, paymentsReady, joinConfigTiers(offered), application.conditions),
+      fieldContract: chapterFlowFieldContract(chapter, "join", application),
       copy: { ...chapter.copy.join, ...activeControl?.document.application?.copy ?? {} },
       ...activeControl ? { signupControl: {
         revision: activeControl.revision,
@@ -3077,7 +3159,7 @@ var handleAdminAdmissionGrants = async (req, url, env, ctx) => {
       return json({ error: "invalid JSON body" }, 400);
     }
     const email = typeof body.email === "string" ? body.email.trim() : "";
-    const emailNormalized = normalizeAdmissionEmail(email);
+    const emailNormalized = normalizeChapterEmail(email);
     if (!isValidEmail(emailNormalized)) return json({ error: "email must be valid" }, 400);
     const decision = body.decision ?? "waive_interview";
     if (decision !== "waive_interview" && decision !== "require_interview") {
@@ -3579,7 +3661,7 @@ async function rotateGiftClaim(db, claim, now) {
 async function redeemGiftClaim(db, claim, beneficiary, now) {
   if (claim.status !== "pending" || Number(claim.codeExpiresAt) <= now) return null;
   const chapterId = String(claim.chapterId);
-  const emailNormalized = normalizeAdmissionEmail(beneficiary.email);
+  const emailNormalized = normalizeChapterEmail(beneficiary.email);
   const target = claim.target;
   const ops = [];
   let result;
@@ -3876,7 +3958,7 @@ async function startSubscription(req, env, ctx) {
         offer,
         purchaserType: "application",
         purchaserEmail: String(app.email ?? ""),
-        purchaserEmailNormalized: normalizeAdmissionEmail(String(app.email ?? "")),
+        purchaserEmailNormalized: normalizeChapterEmail(String(app.email ?? "")),
         purchaserApplicationId: applicationId,
         stripeSecret: secretKey,
         publishableKey: group.stripePublishableKey,
@@ -4025,7 +4107,7 @@ var handleGifts = async (req, url, env, ctx) => {
     if (!user) return json({ error: "unauthorized" }, 401);
     const control2 = await loadActiveSignupControl(db, ctx.chapter.id, env.ODLA_ENV);
     const found = await db.query({ giftClaims: { $: { where: {
-      purchaserEmailNormalized: normalizeAdmissionEmail(user.email),
+      purchaserEmailNormalized: normalizeChapterEmail(user.email),
       chapterId: ctx.chapter.id
     }, limit: 200 } } });
     const group = first3((await db.query({ groups: { $: { where: { id: ctx.chapter.id }, limit: 1 } } })).groups);
@@ -4052,7 +4134,7 @@ var handleGifts = async (req, url, env, ctx) => {
     const group = first3((await db.query({ groups: { $: { where: { id: ctx.chapter.id }, limit: 1 } } })).groups);
     const stripeSecret = await getVaultSecret(db, "stripe_secret_key");
     if (!group || !stripeSecret || typeof group.stripePublishableKey !== "string") return json({ error: "payments not configured" }, 503);
-    const emailNormalized = normalizeAdmissionEmail(user.email);
+    const emailNormalized = normalizeChapterEmail(user.email);
     const applications = rows2((await db.query({ applications: { $: { where: { emailNormalized }, limit: 20 } } })).applications);
     const app = applications.sort((a, b) => Number(b.createdAt ?? 0) - Number(a.createdAt ?? 0))[0];
     try {
@@ -4094,7 +4176,7 @@ var handleGifts = async (req, url, env, ctx) => {
         return invalid();
       }
     }
-    const owns = user ? claim.purchaserEmailNormalized === normalizeAdmissionEmail(user.email) : claim.purchaserApplicationId === applicationId;
+    const owns = user ? claim.purchaserEmailNormalized === normalizeChapterEmail(user.email) : claim.purchaserApplicationId === applicationId;
     if (!owns) return invalid();
     const rotated = await rotateGiftClaim(db, claim, Date.now());
     return rotated ? json(rotated) : invalid();
@@ -5618,31 +5700,17 @@ var handleAdminNetworkSharedNotes = async (req, url, env, ctx) => {
 
 // src/worker-routes-formation.ts
 var import_crm9 = require("@odla-ai/crm");
-
-// src/formation.ts
-function formationFields(crm, formation) {
-  const def = crm.type(formation.type);
-  return [...formation.required, ...formation.optional].map((id) => {
-    const field = def.fields[id];
-    return {
-      id,
-      label: field.label ?? id,
-      type: field.type,
-      required: formation.required.includes(id),
-      ...field.options ? { options: field.options } : {}
-    };
-  });
-}
-
-// src/worker-routes-formation.ts
 var SUBMISSION = /^[A-Za-z0-9_-]{8,128}$/;
 var handleFormation = async (req, url, env, ctx) => {
   const formation = ctx.chapter.formation;
   if (!formation.enabled) return null;
   if (req.method === "GET" && url.pathname === "/api/formation/config") {
+    const fieldContract = chapterFlowFieldContract(ctx.chapter, "formation");
     return json({
       type: formation.type,
-      fields: formationFields(ctx.chapter.crm, formation)
+      fieldContract,
+      // Backward compatibility for hosts that consumed the original array.
+      fields: fieldContract.fields
     });
   }
   if (req.method !== "POST" || url.pathname !== "/api/formation/applications") return null;