@ai-matrx/records 0.93.5 → 0.94.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog — @ai-matrx/records
 
+## 0.94.0 — an archived row has a door back (lane F5)
+
+From the live Applets audit (2026-10-09, R5): a reading-list Applet's archive confirm promised "you can restore it
+later" and nothing could read an archived row — the table port's only list door, `custom.read_records_keyset`,
+answers live rows only.
+- **`Query.archived: true`** (`@ai-matrx/records/data`) answers a source's ARCHIVE: the table port reads
+  `custom.read_records_archived` (the store's own archive door — same ladder, level and masking; newest archived
+  first, paged by an `archived:<offset>` cursor; `where` / `search` / `sort` are not applied to it); the entity port
+  asks the entity door's own archived lane. Each row carries `_archived_at` and `_archived_by_name`.
+- **The data cache keeps the archive apart** (`data/react`): an archive list is never patched, dropped into or
+  placed into by live-row bookkeeping; it is read again when the alias moves, after an archive, and after a restore.
+- Tests: `an-archived-row-has-a-door-back.test.ts`.
+- **Consumer action:** none. A host's archive/restore UI can now read the rows it restores.
+
+## 0.93.6
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.93.5..npm/records/v0.93.6 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.93.5
 ### Unreleased
 ### automations that act when a date arrives and on a schedule (lane AUTOMATION-TIME)

package/dist/data/index.cjs

@@ -6339,6 +6339,7 @@ function clientIn(client, organizationId) {
 var import_uuid4 = require("@ai-matrx/kit/uuid");
 var DATA_PAGE_CEILING = 500;
 var DATA_PAGE_DEFAULT = 50;
+var ARCHIVED_CURSOR = "archived:";
 function refuse2(code, message, hint) {
   return { ok: false, error: { code, message, ...hint ? { hint } : {} } };
 }
@@ -6477,6 +6478,21 @@ function createTableDataPort({ client, aliases }) {
     if (!got.data) return refuse2("not_found", "The change was saved, but this row can no longer be read with your access.", "Ask the table's owner if you should still see it.");
     return { ok: true, data: got.data };
   }
+  async function listArchived(binding, shape, q, cursor) {
+    const limit = Math.max(1, Math.min(Math.floor(q.pageSize ?? DATA_PAGE_DEFAULT), DATA_PAGE_CEILING));
+    const at = cursor?.startsWith(ARCHIVED_CURSOR) ? Number(cursor.slice(ARCHIVED_CURSOR.length)) : 0;
+    const offset = Number.isInteger(at) && at > 0 ? at : 0;
+    const page2 = await seat(binding).listArchived({ table_id: binding.tableId, lane: "org", limit, offset });
+    if (!page2.ok) return page2;
+    const read = page2.data.rows.map((r) => ({ ...r, version: 0, organization_id: binding.organizationId }));
+    const rows = await toRows(binding, shape, read);
+    page2.data.rows.forEach((r, i) => {
+      rows[i]._archived_at = r.archivedAt;
+      rows[i]._archived_by_name = r.archivedByName;
+    });
+    const cursorOut = page2.data.rows.length < limit ? null : `${ARCHIVED_CURSOR}${offset + page2.data.rows.length}`;
+    return { ok: true, data: { rows, total: page2.data.total, cursor: cursorOut } };
+  }
   return {
     async sources() {
       const out = [];
@@ -6518,6 +6534,7 @@ function createTableDataPort({ client, aliases }) {
       }
       const shape = await shapeOf(alias, binding);
       if (!shape.ok) return shape;
+      if (q.archived === true) return listArchived(binding, shape.data, q, cursor);
       const filter = compileWhere(q.where, shape.data);
       if (!filter.ok) return filter;
       const sort = compileSort(q.sort, shape.data);