@ai-matrx/records 0.93.5 → 0.94.0

package/dist/entity/react.d.ts

@@ -171,6 +171,10 @@ interface Row {
     _organization_id: Uuid;
     /** On a platform row only: the organization's custom fields (a real column may be named `custom`). */
     _custom?: Record<string, unknown>;
+    /** On a row read with `archived: true`: when it was archived (ISO). */
+    _archived_at?: string;
+    /** On a row read with `archived: true`: who archived it, or null when the store cannot say. */
+    _archived_by_name?: string | null;
     [key: string]: unknown;
 }
 /** §0. What a write carries, keyed by `Column.key`; `_custom` on platform sources. */
@@ -197,6 +201,12 @@ interface Query {
     lane?: Lane;
     /** A filter, never a lock. Default "all". */
     org?: Uuid | "all";
+    /**
+     * THE ARCHIVE (the archived-items law): `true` answers the rows that were archived instead of the live
+     * ones, newest-archived first, each carrying `_archived_at` and `_archived_by_name`, so a screen can offer
+     * Restore. The archive door takes no `where` / `search` / `sort`: they are not applied to it.
+     */
+    archived?: boolean;
 }
 /** §4. One page; `cursor` is null on the last one. */
 interface Page {

package/dist/entity/react.js

@@ -841,7 +841,7 @@ function createEntityDataPort(options) {
       }
       const wire = toWire(q, customKeys);
       if (binding.organizationId) wire.scope = { ...wire.scope, organization_id: binding.organizationId };
-      const answer = await client.list({ token: binding.token, ...wire, after: cursor ?? null });
+      const answer = await client.list({ token: binding.token, ...wire, after: cursor ?? null, ...q.archived === true ? { archived: "archived" } : {} });
       if (!answer.ok) return answer;
       const { data } = answer;
       if (data.sort_ignored.length > 0) {