@odla-ai/chapter 0.26.0 → 0.27.0

package/dist/index.cjs

@@ -141,6 +141,19 @@ var superAdmins = {
     createdAt: attr("number", { indexed: true })
   }
 };
+var networkNotes = {
+  attrs: {
+    id: id(),
+    recordKey: attr("string", { indexed: true }),
+    targetId: attr("string", { indexed: true }),
+    recordType: attr("string", { indexed: true }),
+    recordId: attr("string", { indexed: true }),
+    body: attr("string"),
+    authorId: attr("string", { indexed: true }),
+    authorEmail: attr("string", { optional: true }),
+    createdAt: attr("number", { indexed: true })
+  }
+};
 var applications = {
   attrs: {
     id: id(),
@@ -232,7 +245,7 @@ var emailLog = {
     sentAt: attr("number", { indexed: true })
   }
 };
-function chapterDb(mode, auth) {
+function chapterDb(mode, auth, includeNetworkNotes = false) {
   const entities = {};
   if (mode === "chapter") {
     entities.applications = applications;
@@ -242,6 +255,7 @@ function chapterDb(mode, auth) {
   }
   if (auth.source === "table") entities.admins = admins;
   if (auth.superAdmins) entities.superAdmins = superAdmins;
+  if (includeNetworkNotes) entities.networkNotes = networkNotes;
   const schema = { entities, links: {} };
   const rules = {};
   for (const ns of Object.keys(entities)) {
@@ -633,6 +647,7 @@ var DEFAULT_ADMIN_COPY = {
     overview: "Overview",
     billing: "Billing",
     people: "People",
+    network: "Network",
     portfolio: "Portfolio",
     settings: "Settings",
     calendar: "Calendar",
@@ -994,9 +1009,17 @@ function formationFields(crm, formation) {
   });
 }
 
-// src/config.ts
+// src/config-network.ts
 var SLUG = /^[a-z0-9][a-z0-9-]{1,62}$/;
 var FIELD = /^[a-z][a-zA-Z0-9_]*$/;
+var BINDING = /^[A-Z][A-Z0-9_]{0,127}$/;
+function validateSharedNotes(opts) {
+  const duplicate = opts.values.some((type, index) => opts.values.indexOf(type) !== index);
+  const invalid = opts.values.some((type) => !FIELD.test(type) || !opts.crm.config.types[type] || (opts.fields ? !opts.fields[type] : false));
+  if (duplicate || invalid) {
+    throw new Error(`${opts.path}: must contain unique CRM types allowed by fields`);
+  }
+}
 function resolveNetwork(config, crm) {
   const seen = /* @__PURE__ */ new Set();
   const targets = [];
@@ -1042,23 +1065,87 @@ function resolveNetwork(config, crm) {
     if (!/^[a-zA-Z][a-zA-Z0-9_-]{1,127}$/.test(secretName)) {
       throw new Error(`defineChapter.network.targets.${target.id}.secretName: must be a vault-key identifier`);
     }
+    const binding = target.binding?.trim();
+    if (binding && !BINDING.test(binding)) {
+      throw new Error(
+        `defineChapter.network.targets.${target.id}.binding: must be an uppercase Worker binding identifier`
+      );
+    }
+    const sharedNotes = target.sharedNotes ?? [];
+    validateSharedNotes({
+      path: `defineChapter.network.targets.${target.id}.sharedNotes`,
+      values: sharedNotes,
+      crm,
+      fields
+    });
     targets.push({
       id: target.id,
       name: target.name?.trim() || target.id,
       url: url.origin,
+      ...binding ? { binding } : {},
       secretName,
-      ...fields ? { fields } : {}
+      ...fields ? { fields } : {},
+      sharedNotes
+    });
+  }
+  const readerIds = /* @__PURE__ */ new Set();
+  const readers = [];
+  for (const reader of config.network?.readers ?? []) {
+    if (!SLUG.test(reader.id)) {
+      throw new Error(`defineChapter.network.readers.id: must be a lowercase slug \u2014 got ${JSON.stringify(reader.id)}`);
+    }
+    if (readerIds.has(reader.id)) {
+      throw new Error(`defineChapter.network.readers: duplicate reader "${reader.id}"`);
+    }
+    readerIds.add(reader.id);
+    const entries = Object.entries(reader.fields ?? {});
+    if (entries.length === 0) {
+      throw new Error(`defineChapter.network.readers.${reader.id}.fields: at least one CRM type is required`);
+    }
+    for (const [type, names] of entries) {
+      if (!FIELD.test(type) || names.length === 0 || names.some((name) => !FIELD.test(name))) {
+        throw new Error(
+          `defineChapter.network.readers.${reader.id}.fields.${type}: type and field names must be non-empty CRM identifiers`
+        );
+      }
+      const def = crm.config.types[type];
+      if (!def) {
+        throw new Error(`defineChapter.network.readers.${reader.id}.fields: unknown local CRM type "${type}"`);
+      }
+      const unknown = names.filter((field) => !def.fields[field]);
+      if (unknown.length > 0) {
+        throw new Error(
+          `defineChapter.network.readers.${reader.id}.fields.${type}: ${unknown.map((field) => `"${field}"`).join(", ")} not declared on the local CRM type`
+        );
+      }
+      const nameField = def.nameField ?? "name";
+      if (!names.includes(nameField)) {
+        throw new Error(
+          `defineChapter.network.readers.${reader.id}.fields.${type}: must include required name field "${nameField}"`
+        );
+      }
+    }
+    const sharedNotes = reader.sharedNotes ?? [];
+    validateSharedNotes({
+      path: `defineChapter.network.readers.${reader.id}.sharedNotes`,
+      values: sharedNotes,
+      crm,
+      fields: reader.fields
     });
+    readers.push({ id: reader.id, fields: reader.fields, sharedNotes });
   }
-  return { targets };
+  return { targets, readers };
 }
+
+// src/config.ts
+var SLUG2 = /^[a-z0-9][a-z0-9-]{1,62}$/;
 function isResolvedCrm(x) {
   return !!x && typeof x === "object" && "prepare" in x && typeof x.prepare === "function";
 }
 function defineChapter(config) {
   if (!config || typeof config !== "object") throw new Error("defineChapter: a config object is required");
   const { id: id2, name } = config;
-  if (typeof id2 !== "string" || !SLUG.test(id2)) {
+  if (typeof id2 !== "string" || !SLUG2.test(id2)) {
     throw new Error(`defineChapter.id: must be a lowercase slug [a-z0-9-] (2-63 chars) \u2014 got ${JSON.stringify(id2)}`);
   }
   if (typeof name !== "string" || name.trim() === "") throw new Error("defineChapter.name: a non-empty name is required");
@@ -1083,7 +1170,7 @@ function defineChapter(config) {
   const copy = resolveChapterCopy(config.copy);
   const network = resolveNetwork(config, crm);
   const formation = resolveLeaderFormation(config.formation, crm);
-  const { schema, rules } = chapterDb(mode, auth);
+  const { schema, rules } = chapterDb(mode, auth, network.targets.length > 0);
   const services = config.services ?? ["db", "calendar", "o11y"];
   const account = config.account ?? "none";
   if (account !== "invite" && account !== "create" && account !== "none") {
@@ -1339,6 +1426,11 @@ function createChapterIntegration(chapter, options = {}) {
       // The snapshot route is deliberately private. A credential-free smoke
       // request must prove that the route is mounted and closed.
       { path: "/api/network/snapshot", expectedStatus: 401 },
+      ...chapter.network.readers.length > 0 ? [{ path: "/api/network/records?type=person", expectedStatus: 401 }] : [],
+      ...chapter.network.readers.some((reader) => reader.sharedNotes.length > 0) ? [{
+        path: "/api/network/shared-notes?type=person&recordId=probe",
+        expectedStatus: 401
+      }] : [],
       // Formation metadata is public only when the host explicitly enables
       // the bounded intake contract.
       ...chapter.formation.enabled ? [{ path: "/api/formation/config", expectedStatus: 200 }] : []