@ai-matrx/records 0.58.114 → 0.58.115

package/dist/react/index.d.cts

@@ -11298,6 +11298,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;
@@ -13118,6 +13133,10 @@ interface UseFieldMutation {
     retire: (args: {
         field_id: Uuid;
     }) => Promise<boolean>;
+    /** Bring a removed column back, with its values. */
+    restore: (args: {
+        field_id: Uuid;
+    }) => Promise<boolean>;
     saving: boolean;
     error: RecordsError | null;
     clearError: () => void;

package/dist/react/index.d.ts

@@ -11298,6 +11298,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;
@@ -13118,6 +13133,10 @@ interface UseFieldMutation {
     retire: (args: {
         field_id: Uuid;
     }) => Promise<boolean>;
+    /** Bring a removed column back, with its values. */
+    restore: (args: {
+        field_id: Uuid;
+    }) => Promise<boolean>;
     saving: boolean;
     error: RecordsError | null;
     clearError: () => void;

package/dist/react/index.js

@@ -38924,6 +38924,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
@@ -40388,6 +40391,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,
@@ -42788,6 +42813,11 @@ function useFieldMutation() {
         if (gone) announce(null);
         return gone;
       },
+      restore: async (args) => {
+        const back = await run(() => client.fieldRestore({ field_id: args.field_id }), false);
+        if (back) announce(null);
+        return back;
+      },
       saving,
       error,
       clearError: () => setError(null)