@ai-matrx/records 0.58.114 → 0.58.115

package/dist/core/index.d.cts

@@ -536,6 +536,21 @@ interface RecordsClient {
     fieldRetire(args: {
         field_id: Uuid;
     }): Promise<RecordsResult<boolean>>;
+    /**
+     * Bring a removed column back (`custom.field_restore`): the set that was retired with it, the
+     * Table's declaration of those columns, and the links they made. The values never left.
+     */
+    fieldRestore(args: {
+        field_id: Uuid;
+    }): Promise<RecordsResult<boolean>>;
+    /**
+     * THE COLUMNS THIS TABLE HAD AND NO LONGER HAS (grids review 3): its retired Field records,
+     * newest first, through the same archived door the Table archive uses — addressed at the Field
+     * kernel (every Field is a record in it) and paged until the door answers short.
+     */
+    fieldsRetired(args: {
+        table_id: Uuid;
+    }): Promise<RecordsResult<ArchivedRow[]>>;
     /** What the registry says about a token, and whether it can hold a value at all. */
     entityTable(args: {
         token: string;
@@ -2112,6 +2127,7 @@ declare const DOORS: {
     readonly fieldDeclare: "field_declare";
     readonly fieldUpdate: "field_update";
     readonly fieldRetire: "field_retire";
+    readonly fieldRestore: "field_restore";
     readonly entityTable: "entity_table";
     readonly entityFields: "entity_fields";
     readonly entityFieldDeclare: "entity_field_declare";

package/dist/core/index.d.ts

@@ -536,6 +536,21 @@ interface RecordsClient {
     fieldRetire(args: {
         field_id: Uuid;
     }): Promise<RecordsResult<boolean>>;
+    /**
+     * Bring a removed column back (`custom.field_restore`): the set that was retired with it, the
+     * Table's declaration of those columns, and the links they made. The values never left.
+     */
+    fieldRestore(args: {
+        field_id: Uuid;
+    }): Promise<RecordsResult<boolean>>;
+    /**
+     * THE COLUMNS THIS TABLE HAD AND NO LONGER HAS (grids review 3): its retired Field records,
+     * newest first, through the same archived door the Table archive uses — addressed at the Field
+     * kernel (every Field is a record in it) and paged until the door answers short.
+     */
+    fieldsRetired(args: {
+        table_id: Uuid;
+    }): Promise<RecordsResult<ArchivedRow[]>>;
     /** What the registry says about a token, and whether it can hold a value at all. */
     entityTable(args: {
         token: string;
@@ -2112,6 +2127,7 @@ declare const DOORS: {
     readonly fieldDeclare: "field_declare";
     readonly fieldUpdate: "field_update";
     readonly fieldRetire: "field_retire";
+    readonly fieldRestore: "field_restore";
     readonly entityTable: "entity_table";
     readonly entityFields: "entity_fields";
     readonly entityFieldDeclare: "entity_field_declare";

package/dist/core/index.js

@@ -40146,6 +40146,9 @@ var DOORS = {
   fieldDeclare: "field_declare",
   fieldUpdate: "field_update",
   fieldRetire: "field_retire",
+  // THE UNDO OF field_retire (lane STORE-RESTORE-DOORS): the set that went together comes back
+  // whole, the Table declares the columns again, and the values never left the records.
+  fieldRestore: "field_restore",
   // CUSTOM FIELDS ON A STANDARD BUSINESS TABLE. Every door above is keyed by a
   // custom Table's uuid, and a standard table has no Table record - so until
   // 2026-09-20 `custom.applicable_fields(org, 'party', null)` answered `22P02
@@ -41445,6 +41448,28 @@ function createRecordsClient(config) {
         "fieldRetire"
       );
     },
+    async fieldRestore({ field_id }) {
+      return callDoor(
+        DOORS.fieldRestore,
+        { p_organization_id: org, p_field_id: field_id },
+        "fieldRestore"
+      );
+    },
+    async fieldsRetired({ table_id }) {
+      const kernel = await callDoor(DOORS.fieldKernelId, {}, "fieldsRetired.kernel");
+      if (!kernel.ok) return err(kernel.error);
+      const PAGE = 200;
+      const found = [];
+      for (let page = 0; page < 25; page += 1) {
+        const answered = await this.listArchived({ table_id: kernel.data, lane: "org", limit: PAGE, offset: page * PAGE });
+        if (!answered.ok) return err(answered.error);
+        for (const row of answered.data.rows) {
+          if (String(row.document["entity_definition_id"] ?? "") === table_id) found.push(row);
+        }
+        if (answered.data.rows.length < PAGE) break;
+      }
+      return ok(found);
+    },
     async relationWords({ field_id, value }) {
       return callDoor(
         DOORS.relationWords,