@odla-ai/chapter 0.14.0 → 0.15.1

package/dist/index.d.cts

@@ -242,10 +242,13 @@ interface ChapterConfig {
     auth?: ChapterAuth;
     /** odla services (db implied). Default `["db","calendar","o11y"]`. */
     services?: readonly string[];
-    /** Apply-time account provisioning: `"invite"` (default) mints a Clerk
-     *  invitation, `"create"` makes the account server-side (so join can say the
-     *  account is ready), `"none"` skips it. Any of these needs a `clerk_secret_key`
-     *  vault secret to act. */
+    /** Apply-time account provisioning. **Default `"none"`** — it provisions
+     *  nothing, because the alternatives have an outbound side effect and a site
+     *  that never made the choice must not be mailing people. `"create"` makes the
+     *  Clerk account server-side (so join can say the account is ready);
+     *  `"invite"` **emails the applicant a Clerk invitation**. Both non-default
+     *  models need a `clerk_secret_key` vault secret to act. Opt in explicitly —
+     *  leaving this unset provisions no accounts. */
     account?: AccountModel;
     /** WHEN lifecycle email fires. Addressing and content live on the group row
      *  (owner-editable at runtime); this is the trigger, which is a build-time
@@ -284,7 +287,7 @@ interface Chapter {
     schema: DbSchema;
     rules: DbRules;
     services: readonly string[];
-    /** Resolved apply-time account provisioning model (default `"invite"`). */
+    /** Resolved apply-time account provisioning model (default `"none"`). */
     account: AccountModel;
     /** Resolved send policy — when each lifecycle email fires. */
     sends: ResolvedSends;

package/dist/index.d.ts

@@ -242,10 +242,13 @@ interface ChapterConfig {
     auth?: ChapterAuth;
     /** odla services (db implied). Default `["db","calendar","o11y"]`. */
     services?: readonly string[];
-    /** Apply-time account provisioning: `"invite"` (default) mints a Clerk
-     *  invitation, `"create"` makes the account server-side (so join can say the
-     *  account is ready), `"none"` skips it. Any of these needs a `clerk_secret_key`
-     *  vault secret to act. */
+    /** Apply-time account provisioning. **Default `"none"`** — it provisions
+     *  nothing, because the alternatives have an outbound side effect and a site
+     *  that never made the choice must not be mailing people. `"create"` makes the
+     *  Clerk account server-side (so join can say the account is ready);
+     *  `"invite"` **emails the applicant a Clerk invitation**. Both non-default
+     *  models need a `clerk_secret_key` vault secret to act. Opt in explicitly —
+     *  leaving this unset provisions no accounts. */
     account?: AccountModel;
     /** WHEN lifecycle email fires. Addressing and content live on the group row
      *  (owner-editable at runtime); this is the trigger, which is a build-time
@@ -284,7 +287,7 @@ interface Chapter {
     schema: DbSchema;
     rules: DbRules;
     services: readonly string[];
-    /** Resolved apply-time account provisioning model (default `"invite"`). */
+    /** Resolved apply-time account provisioning model (default `"none"`). */
     account: AccountModel;
     /** Resolved send policy — when each lifecycle email fires. */
     sends: ResolvedSends;

package/dist/index.js

@@ -513,10 +513,23 @@ function defineChapter(config) {
   const application = resolveApplication(config.application);
   const { schema, rules } = chapterDb(mode, auth);
   const services = config.services ?? ["db", "calendar", "o11y"];
-  const account = config.account ?? "invite";
+  const account = config.account ?? "none";
   if (account !== "invite" && account !== "create" && account !== "none") {
     throw new Error(`defineChapter.account: must be "invite", "create", or "none" \u2014 got "${String(account)}"`);
   }
+  if (application.crmFields.length > 0) {
+    let personFields = null;
+    try {
+      personFields = Object.keys(crm.type("person").fields ?? {});
+    } catch {
+    }
+    const unknown = personFields ? application.crmFields.filter((f) => !personFields.includes(f)) : [];
+    if (unknown.length > 0) {
+      throw new Error(
+        `defineChapter.application.crmFields: ${unknown.map((f) => `"${f}"`).join(", ")} not declared on the CRM "person" type (declared: ${personFields?.join(", ")}). An undeclared field is silently dropped from the CRM projection \u2014 add it to your crm config's person fields, or remove it from crmFields.`
+      );
+    }
+  }
   const adminNotification = config.sends?.adminNotification ?? "submit";
   if (adminNotification !== "submit" && adminNotification !== "payment" && adminNotification !== "never") {
     throw new Error(