@ai-matrx/records 0.99.28 → 0.99.30

package/CHANGELOG.md

@@ -1,8 +1,26 @@
 # Changelog — @ai-matrx/records
 
+## 0.99.30
+
+UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
+Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/records/src`.
+
+## 0.99.29
+
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff 409b5bc198 9e0559b49b -- apps/shared/records/src`
+
+Changed shipped source files (3):
+- `apps/shared/records/src/base.ts`
+- `apps/shared/records/src/core/client.ts`
+- `apps/shared/records/src/table.ts`
+
 ## 0.99.28
 ### Unreleased
 
+- Bases (lane AT-BASE2): `duplicateBase` / `restoreSnapshot` put the copies in a NEW Home (`homeName`; `BaseCopied.homeId`), made by the door that makes a table's Home (`BasePort.createHome`) and moved in by the one move door, new `RecordsClient.recordReparent` (`custom.record_reparent`, `BasePort.moveInto`). A copy's automations and pages get the copy's column and view ids (`idsOfCopies`), and a refused automation, page or read says the store's own sentence in `extrasRefused`. `restoredBaseName`. `tableList()` exposes each table's Home as `home_id` (the record it sits in) and `kept_for` on `Table`.
+
 - Registry: the view key `presentation.headerWrap` (boolean, grids) is declared, so a view can keep it.
 
 ## 0.99.27

package/dist/{client-B7LYr-aE.d.cts → client-B7KEs9hi.d.cts}

@@ -162,6 +162,8 @@ interface Table {
     row_order: string | null;
     /** REC-14. Where this Table lives. Exactly one primary Home. */
     home_id: Uuid | null;
+    /** The feature that keeps this Table out of the person's lists (`snapshot`, `copying`, …); absent for a person's own table. */
+    kept_for?: string | null;
     /** REC-27. One of the nine, defined in code and not editable by Migration. */
     is_kernel: boolean;
     created_by: Uuid | null;
@@ -4352,6 +4354,14 @@ interface RecordsClient {
     recordDelete(args: {
         record_id: Uuid;
     }): Promise<RecordsResult<Timestamp>>;
+    /**
+     * MOVE A RECORD (a Table included) INTO ANOTHER HOME — `custom.record_reparent`, the one door that changes where a
+     * record is contained. `parent_id` is the Home's record id (null takes it out). Admin on the record, viewer on the Home.
+     */
+    recordReparent(args: {
+        record_id: Uuid;
+        parent_id: Uuid | null;
+    }): Promise<RecordsResult<null>>;
     recordRestore(args: {
         record_id: Uuid;
     }): Promise<RecordsResult<void>>;

package/dist/{client-m4soDpHA.d.ts → client-Dthx26hr.d.ts}

@@ -162,6 +162,8 @@ interface Table {
     row_order: string | null;
     /** REC-14. Where this Table lives. Exactly one primary Home. */
     home_id: Uuid | null;
+    /** The feature that keeps this Table out of the person's lists (`snapshot`, `copying`, …); absent for a person's own table. */
+    kept_for?: string | null;
     /** REC-27. One of the nine, defined in code and not editable by Migration. */
     is_kernel: boolean;
     created_by: Uuid | null;
@@ -4352,6 +4354,14 @@ interface RecordsClient {
     recordDelete(args: {
         record_id: Uuid;
     }): Promise<RecordsResult<Timestamp>>;
+    /**
+     * MOVE A RECORD (a Table included) INTO ANOTHER HOME — `custom.record_reparent`, the one door that changes where a
+     * record is contained. `parent_id` is the Home's record id (null takes it out). Admin on the record, viewer on the Home.
+     */
+    recordReparent(args: {
+        record_id: Uuid;
+        parent_id: Uuid | null;
+    }): Promise<RecordsResult<null>>;
     recordRestore(args: {
         record_id: Uuid;
     }): Promise<RecordsResult<void>>;

package/dist/core/index.cjs

@@ -192,6 +192,7 @@ __export(core_exports, {
   hasQuietHours: () => hasQuietHours,
   highestLevel: () => highestLevel,
   holdsARetiredChoice: () => holdsARetiredChoice,
+  idsOfCopies: () => idsOfCopies,
   importCsv: () => importCsv,
   importXlsx: () => importXlsx,
   indexedDbStore: () => indexedDbStore,
@@ -291,6 +292,7 @@ __export(core_exports, {
   removedChoicesInUse: () => removedChoicesInUse,
   resolveObjectOrganization: () => resolveObjectOrganization,
   restoreSnapshot: () => restoreSnapshot,
+  restoredBaseName: () => restoredBaseName,
   richTextPlain: () => richTextPlain,
   ruleThatRefuses: () => ruleThatRefuses,
   rulesWithTopStar: () => rulesWithTopStar,
@@ -2041,6 +2043,9 @@ function moveConsequence(home, to) {
 function baseCopyName(name) {
   return `${name.trim() || "Base"} (copy)`;
 }
+function restoredBaseName(name, on) {
+  return `${name.trim() || "Base"} (restored ${on})`;
+}
 async function duplicateBase(port, args) {
   const made = [];
   const pairs = {};
@@ -2060,10 +2065,21 @@ async function duplicateBase(port, args) {
   }
   const fin = args.tables.length > 1 ? await port.finish({ organizationId: args.organizationId, pairs }) : null;
   if (fin && !fin.ok) return { ok: false, error: fin.error, stoppedAt: args.tables[args.tables.length - 1], made };
+  let homeId = null;
+  if (args.homeName && port.createHome && port.moveInto) {
+    const home = await port.createHome(args.homeName);
+    if (!home.ok) return { ok: false, error: home.error, stoppedAt: args.tables[args.tables.length - 1], made };
+    homeId = home.data;
+    for (const m of made) {
+      const moved = await port.moveInto(m.copy.id, homeId);
+      if (!moved.ok) return { ok: false, error: moved.error, stoppedAt: m.from, made };
+    }
+  }
   const extras = await copyExtras(port, args.tables, pairs);
   return {
     ok: true,
     data: {
+      homeId,
       pairs,
       tables: made,
       relinkedColumns: fin?.ok ? fin.data.relinked_columns : 0,
@@ -2078,10 +2094,47 @@ function pointAtCopies(doc, pairs) {
   for (const [from, to] of Object.entries(pairs)) text2 = text2.split(from).join(to);
   return JSON.parse(text2);
 }
+function sentence(error) {
+  const m = error?.message;
+  return typeof m === "string" && m ? m : "the store gave no reason.";
+}
+function refusedSentence(data) {
+  const errors = data?._errors;
+  const lines = errors ? Object.entries(errors).map(([path, why]) => `${path}: ${why}`) : [];
+  return lines.length ? lines.join("; ") : "the store gave no reason.";
+}
+async function idsOfCopies(port, pairs) {
+  const ids = { ...pairs };
+  if (!port.fieldsOf && !port.viewsOf) return ids;
+  for (const [from, to] of Object.entries(pairs)) {
+    if (port.fieldsOf) {
+      const [a, b] = await Promise.all([port.fieldsOf(from), port.fieldsOf(to)]);
+      if (a.ok && b.ok) {
+        const byKey = new Map(b.data.map((f) => [f.key, f.id]));
+        for (const f of a.data) {
+          const n = byKey.get(f.key);
+          if (n && n !== f.id) ids[f.id] = n;
+        }
+      }
+    }
+    if (port.viewsOf) {
+      const [a, b] = await Promise.all([port.viewsOf(from), port.viewsOf(to)]);
+      if (a.ok && b.ok) {
+        const byName = new Map(b.data.map((v) => [v.name, v.id]));
+        for (const v of a.data) {
+          const n = byName.get(v.name);
+          if (n && n !== v.id) ids[v.id] = n;
+        }
+      }
+    }
+  }
+  return ids;
+}
 async function copyExtras(port, tables, pairs) {
   let automations = 0;
   let pages = 0;
   const extrasRefused = [];
+  const ids = await idsOfCopies(port, pairs);
   for (const t of tables) {
     const copy = pairs[t.id];
     if (!copy) continue;
@@ -2089,13 +2142,14 @@ async function copyExtras(port, tables, pairs) {
       const list = await port.automations(t.id);
       if (list.ok) {
         for (const a of list.data.automations) {
-          const made = await port.automationDeclare({ table_id: copy, spec: pointAtCopies(a.spec, pairs) });
+          const made = await port.automationDeclare({ table_id: copy, spec: pointAtCopies(a.spec, ids) });
           if (made.ok && made.data.ok && made.data.automation_id) {
-            await port.automationSetEnabled?.({ automation_id: made.data.automation_id, enabled: false });
-            automations += 1;
-          } else extrasRefused.push(`Automation "${a.name}" on ${t.name} was not copied.`);
+            const off = await port.automationSetEnabled?.({ automation_id: made.data.automation_id, enabled: false });
+            if (off && !off.ok) extrasRefused.push(`Automation "${a.name}" on ${t.name} was copied but could not be switched off: ${sentence(off.error)}`);
+            else automations += 1;
+          } else extrasRefused.push(`Automation "${a.name}" on ${t.name} was not copied: ${made.ok ? refusedSentence(made.data) : sentence(made.error)}`);
         }
-      }
+      } else extrasRefused.push(`The automations of ${t.name} could not be read: ${sentence(list.error)}`);
     }
     if (port.dashboards && port.dashboardDeclare) {
       const list = await port.dashboards(t.id);
@@ -2104,13 +2158,13 @@ async function copyExtras(port, tables, pairs) {
           const made = await port.dashboardDeclare({
             table_id: copy,
             name: d.name,
-            blocks: pointAtCopies(d.blocks, pairs),
-            presentation: pointAtCopies(d.presentation, pairs)
+            blocks: pointAtCopies(d.blocks, ids),
+            presentation: pointAtCopies(d.presentation, ids)
           });
           if (made.ok) pages += 1;
-          else extrasRefused.push(`Page "${d.name}" on ${t.name} was not copied.`);
+          else extrasRefused.push(`Page "${d.name}" on ${t.name} was not copied: ${sentence(made.error)}`);
         }
-      }
+      } else extrasRefused.push(`The pages of ${t.name} could not be read: ${sentence(list.error)}`);
     }
   }
   return { automations, pages, extrasRefused };
@@ -2149,6 +2203,7 @@ async function restoreSnapshot(port, args) {
     tables: sources,
     withRecords: true,
     nameFor: (t) => `${byCopy.get(t.id) ?? t.name} (restored)`,
+    homeName: restoredBaseName(args.baseName ?? "Base", args.restoredOn ?? (/* @__PURE__ */ new Date()).toLocaleDateString()),
     ...args.onProgress ? { onProgress: args.onProgress } : {}
   });
   for (const s of sources) await port.archive?.(s.id);
@@ -8215,6 +8270,15 @@ function createRecordsClient(given) {
       }
       return result;
     },
+    async recordReparent({ record_id, parent_id }) {
+      const result = await callDoor(
+        DOORS.recordReparent,
+        { p_organization_id: org, p_record_id: record_id, p_parent_id: parent_id },
+        "recordReparent"
+      );
+      if (result.ok) announceRecordChanged(record_id);
+      return result;
+    },
     async recordRestore({ record_id }) {
       const result = await callDoor(
         DOORS.recordRestore,
@@ -8762,7 +8826,9 @@ function createRecordsClient(given) {
       }
       const tables = read.map((row) => {
         const { document } = unfold(row.document);
-        return { ...document, id: row.id, organization_id: org };
+        const doc = document;
+        const home = typeof doc.home_id === "string" ? doc.home_id : typeof doc.parent_id === "string" ? doc.parent_id : null;
+        return { ...doc, home_id: home, id: row.id, organization_id: org };
       });
       tables.sort((a, b) => (a.name ?? "").localeCompare(b.name ?? ""));
       return ok(tables);