@ai-matrx/records 0.83.2 → 0.84.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog — @ai-matrx/records
 
+## 0.84.0 — an empty box is no value; a link is never sorted by its ids
+
+- **`createTableDataPort` writes "" as null for every column that is not words** (`blankToNull`, exported from
+  `./data/table-port`): a cleared date input sent `post_date: ""` and `record_write` refused it ("Post Date
+  takes a date") with nothing on screen (Applets live test, 2026-10-08). Text columns keep "".
+- **A sort by a link (relation) column is refused by name** ("\"Brand\" is a link, so the store cannot sort
+  by it."): the store would order by the ids in the cell, a sort that looks like it did nothing.
+- Tests red→green in `src/__tests__/an-empty-box-is-no-value-and-a-link-is-never-sorted-by-id.test.ts`.
+- **Consumer action:** a page that sorted a table source by a link field sorts its rows on the page by the
+  links' labels (`@ai-matrx/applets` `sortRows`).
+
 ## 0.83.2
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/data/index.cjs

@@ -214,6 +214,9 @@ function compileSort(sort, shape) {
   for (const s of sort ?? []) {
     const column = shape.columns.find((c) => c.key === s.column);
     if (!column) return { ok: false, error: noSuchColumn(s.column) };
+    if (column.type === "relation") {
+      return { ok: false, error: refusal(`"${column.label}" is a link, so the store cannot sort by it.`, "Sort the rows on the page by each link's label. Nothing was read.") };
+    }
     const as = isNumberColumn(column.type) ? "number" : isDateColumn(column.type) ? "date" : "text";
     out.push({ field: column.key, direction: s.direction === "desc" ? "desc" : "asc", as });
   }
@@ -6072,6 +6075,11 @@ function relationIdsOf(value) {
   }
   return out;
 }
+var WORD_TYPES = /* @__PURE__ */ new Set(["text", "long_text", "rich_text", "email", "url", "phone", "markdown"]);
+function blankToNull(type, value) {
+  if (typeof value === "string" && value.trim() === "" && !WORD_TYPES.has(type)) return null;
+  return value;
+}
 function createTableDataPort({ client, aliases }) {
   const shapes = /* @__PURE__ */ new Map();
   let warnedNotLive = false;
@@ -6145,7 +6153,7 @@ function createTableDataPort({ client, aliases }) {
       if (!column) return refuse2("invalid_argument", `This table has no column "${key}".`, "Ask columns() for the keys this table has now. Nothing was saved.");
       if (column.readOnly) return refuse2("invalid_argument", `"${column.label}" is worked out by the table, so it cannot be written.`, "Nothing was saved.");
       const kinds = column.type === "relation" ? entityKindsOf(shape.fields.get(key)) : [];
-      out[key] = kinds.length ? entityRefsOf2(value, kinds) : column.type === "relation" ? relationIdsOf(value) : value;
+      out[key] = kinds.length ? entityRefsOf2(value, kinds) : column.type === "relation" ? relationIdsOf(value) : blankToNull(column.type, value);
     }
     return { ok: true, data: out };
   }