@ai-matrx/records 0.55.1 → 0.56.0

package/dist/index.js

@@ -225,6 +225,7 @@ function fieldKindFor(field, kernel) {
       return "text";
   }
 }
+var UUID_TEXT = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var TRUE_WORDS = /* @__PURE__ */ new Set(["true", "yes", "y", "1", "\u2713", "x", "checked", "on"]);
 var FALSE_WORDS = /* @__PURE__ */ new Set(["false", "no", "n", "0", "", "unchecked", "off"]);
 function coercionLabel(field) {
@@ -316,11 +317,23 @@ function coerceTypedAnswer(field, raw, opts = {}) {
     // id belongs, and every filter, colour and rollup built on that column
     // would stop agreeing with it. So it is refused and the person is told
     // which control does hold it.
+    //
+    // BUT AN ID IS AN IDENTITY (RELATION-TARGETS, 2026-09-23). A Person or File
+    // column holds the kernel Person / File record, and the store itself now
+    // turns the id a writer actually holds — a member's user id, an uploaded
+    // file's id, or the record's own id — into that record at every write door
+    // (`custom.relation_kernel_record`), refusing anything else in its own
+    // words ("… names someone who is not a member of …"). So an import column
+    // of member ids, or an agent handing over the file it just uploaded, is a
+    // value and not a refusal; the store, not this mirror, decides whether the
+    // id is somebody here.
     case "member":
+      if (UUID_TEXT.test(text)) return { value: text.toLowerCase() };
       return {
         refusal: `${label} names a person in this organization, so it is chosen rather than typed. Open it and pick them.`
       };
     case "attachment":
+      if (UUID_TEXT.test(text)) return { value: text.toLowerCase() };
       return {
         refusal: `${label} holds a file, which cannot arrive as typed-in text. Open it and attach the file.`
       };
@@ -425,6 +438,80 @@ function stableFilterKey(filter) {
   return `{${parts.join(",")}}`;
 }
 
+// src/grid.ts
+function actionRefusals(error) {
+  return Array.isArray(error.detail) ? error.detail : [];
+}
+function exampleSpec(useCase) {
+  return {
+    business: useCase.business.name,
+    tables: useCase.tables.map((t) => ({
+      token: t.token,
+      name: t.name,
+      labelSingular: t.labelSingular,
+      labelPlural: t.labelPlural,
+      type: t.type,
+      display: t.display,
+      weight: t.weight,
+      ordered: t.ordered,
+      titleField: t.titleField,
+      describes: t.describes,
+      fields: t.fields.map((f) => ({
+        key: f.key,
+        label: f.label,
+        parityType: f.parityType,
+        multi: f.multi,
+        dated: f.dated,
+        required: f.required,
+        unit: f.unit ?? void 0,
+        rules: f.rules,
+        choices: f.choices,
+        source: f.source,
+        computeOn: f.computeOn,
+        relationTarget: f.relationTarget,
+        relationMax: f.relationMax,
+        sensitivity: f.sensitivity,
+        contextPolicy: f.contextPolicy
+      })),
+      rows: t.rows
+    }))
+  };
+}
+function exportCellText(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
+  return JSON.stringify(value);
+}
+async function exportPageXlsx(page, labels = {}, sheetLabel = "Records") {
+  const XLSX = await import("xlsx");
+  const header = page.columns.map((c) => labels[c] ?? c);
+  const body = page.rows.map((row) => page.columns.map((c) => exportCellText(row[c])));
+  const workbook = XLSX.utils.book_new();
+  const name = sheetLabel.replace(/[\\/?*[\]:]/g, " ").trim().slice(0, 31) || "Records";
+  XLSX.utils.book_append_sheet(workbook, XLSX.utils.aoa_to_sheet([header, ...body]), name);
+  const withheld = Object.entries(page.withheld ?? {});
+  if (withheld.length > 0) {
+    XLSX.utils.book_append_sheet(
+      workbook,
+      XLSX.utils.aoa_to_sheet([
+        ["Column", "Why it is empty in this export"],
+        ...withheld.map(([k, v]) => [labels[k] ?? k, typeof v === "string" ? v : JSON.stringify(v)])
+      ]),
+      "Withheld columns"
+    );
+  }
+  if (page.page?.next !== null && page.page?.next !== void 0) {
+    XLSX.utils.book_append_sheet(
+      workbook,
+      XLSX.utils.aoa_to_sheet([[
+        `This file holds the first ${page.page.returned} rows. The table has more; export again from row ${page.page.next + 1}.`
+      ]]),
+      "More rows"
+    );
+  }
+  return XLSX.write(workbook, { type: "array", bookType: "xlsx", compression: true });
+}
+
 // src/capture-queue.ts
 var DB_NAME = "matrx-capture";
 var DB_VERSION = 1;
@@ -2561,6 +2648,7 @@ export {
   TABLE_TYPES,
   VALUE_ALTERNATE_KEYS,
   VALUE_ENVELOPE_KEYS,
+  actionRefusals,
   archivedByLine,
   archivedWhen,
   asPermissionLevel,
@@ -2575,6 +2663,8 @@ export {
   emptyArchiveLine,
   emptyPortalArchiveLine,
   err,
+  exampleSpec,
+  exportPageXlsx,
   fieldKindFor,
   forgetAllOps,
   highestLevel,