@ai-matrx/records 0.55.1 → 0.56.0

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -65,6 +75,7 @@ __export(src_exports, {
   TABLE_TYPES: () => TABLE_TYPES,
   VALUE_ALTERNATE_KEYS: () => VALUE_ALTERNATE_KEYS,
   VALUE_ENVELOPE_KEYS: () => VALUE_ENVELOPE_KEYS,
+  actionRefusals: () => actionRefusals,
   archivedByLine: () => archivedByLine,
   archivedWhen: () => archivedWhen,
   asPermissionLevel: () => asPermissionLevel,
@@ -79,6 +90,8 @@ __export(src_exports, {
   emptyArchiveLine: () => emptyArchiveLine,
   emptyPortalArchiveLine: () => emptyPortalArchiveLine,
   err: () => err,
+  exampleSpec: () => exampleSpec,
+  exportPageXlsx: () => exportPageXlsx,
   fieldKindFor: () => fieldKindFor,
   forgetAllOps: () => forgetAllOps,
   highestLevel: () => highestLevel,
@@ -339,6 +352,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) {
@@ -430,11 +444,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.`
       };
@@ -539,6 +565,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;