@ai-matrx/records 0.99.26 → 0.99.27

package/dist/index.d.cts

@@ -136,6 +136,38 @@ interface BasePort {
         relinked_columns: number;
         relinked_cells: number;
     }>>;
+    /** Automations and pages (dashboards) of a table, so a base copy carries them: `RecordsClient.automations` / `dashboards`. */
+    automations?(tableId: Uuid): Promise<RecordsResult<{
+        automations: Array<{
+            id: Uuid;
+            name: string;
+            spec: unknown;
+            enabled: boolean;
+        }>;
+    }>>;
+    automationDeclare?(args: {
+        table_id: Uuid;
+        spec: unknown;
+    }): Promise<RecordsResult<{
+        ok: boolean;
+        automation_id?: Uuid;
+    }>>;
+    automationSetEnabled?(args: {
+        automation_id: Uuid;
+        enabled: boolean;
+    }): Promise<RecordsResult<unknown>>;
+    dashboards?(tableId: Uuid): Promise<RecordsResult<Array<{
+        dashboard_id: Uuid;
+        name: string;
+        blocks: unknown[];
+        presentation: Record<string, unknown>;
+    }>>>;
+    dashboardDeclare?(args: {
+        table_id: Uuid;
+        name: string;
+        blocks: unknown[];
+        presentation: Record<string, unknown> | null;
+    }): Promise<RecordsResult<Uuid>>;
     /** `RecordsClient.tableArchive` / its restore: put a copy away, or bring it back to be copied from. */
     archive?(tableId: Uuid): Promise<RecordsResult<unknown>>;
     unarchive?(tableId: Uuid): Promise<RecordsResult<unknown>>;
@@ -157,6 +189,11 @@ interface BaseCopied {
     }>;
     relinkedColumns: number;
     relinkedCells: number;
+    /** Automations copied (every one OFF) and pages copied, with every table id inside them pointing at the copies. */
+    automations: number;
+    pages: number;
+    /** One sentence per automation or page that could not be copied. */
+    extrasRefused: string[];
     /** What a copy never carries, from the per-table door's own words, once per table. */
     notCopied: string[];
 }
@@ -182,6 +219,8 @@ declare function duplicateBase(port: BasePort, args: {
     nameFor?: (table: BaseTable) => string;
     onProgress?: (p: BaseCopyProgress) => void;
 }): Promise<BaseCopyResult>;
+/** Every table id (and any id of a copied table) inside a document becomes its copy's id. Column keys are kept by a copy, so they stay. */
+declare function pointAtCopies<T>(doc: T, pairs: Record<Uuid, Uuid>): T;
 interface BaseSnapshotRecord {
     label: string;
     origin: "manual" | "schedule";
@@ -524,4 +563,4 @@ declare function alternatePatch(document: RecordDocument, field_key: string, alt
 };
 declare function chooseAlternate(client: Pick<RecordsClient, "recordRead" | "recordAsOf" | "recordUpdate">, { record_id, field_key, alternate_index, rank }: ChooseAlternateArgs): Promise<RecordsResult<number>>;
 
-export { type BaseCopied, type BaseCopyProgress, type BaseCopyResult, type BasePort, type BaseSnapshotRecord, type BaseTable, CaptureFileRef, CaptureOutcome, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSyncReport, type ChooseAlternateArgs, CoercibleField, Delivery, Freshness, type MergeField, MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, type MergeFieldTransform, type MissingBehavior, OverridePolicy, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, REFUSALS_WORTH_REPEATING, RecordDocument, RecordsResult, type ResolutionTriple, TableDuplicateProgress, TableDuplicated, Timestamp, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, Uuid, alternatePatch, autonumberJoin, autonumberPrefixOf, autonumberSearchOf, autonumberWords, baseCopyName, chooseAlternate, duplicateBase, filterWithAutonumber, indexedDbStore, isAutonumberField, isDecided, localeDateOrder, memoryStore, mintClientKey, openCaptureQueue, rankTypedMatches, readTypedDate, readTypedNumber, readTypedTime, restoreSnapshot, snapshotBase, twoDigitYear, typedDateText, typedMatchScore, typedTimeText };
+export { type BaseCopied, type BaseCopyProgress, type BaseCopyResult, type BasePort, type BaseSnapshotRecord, type BaseTable, CaptureFileRef, CaptureOutcome, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSyncReport, type ChooseAlternateArgs, CoercibleField, Delivery, Freshness, type MergeField, MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, type MergeFieldTransform, type MissingBehavior, OverridePolicy, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, REFUSALS_WORTH_REPEATING, RecordDocument, RecordsResult, type ResolutionTriple, TableDuplicateProgress, TableDuplicated, Timestamp, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, Uuid, alternatePatch, autonumberJoin, autonumberPrefixOf, autonumberSearchOf, autonumberWords, baseCopyName, chooseAlternate, duplicateBase, filterWithAutonumber, indexedDbStore, isAutonumberField, isDecided, localeDateOrder, memoryStore, mintClientKey, openCaptureQueue, pointAtCopies, rankTypedMatches, readTypedDate, readTypedNumber, readTypedTime, restoreSnapshot, snapshotBase, twoDigitYear, typedDateText, typedMatchScore, typedTimeText };

package/dist/index.d.ts

@@ -136,6 +136,38 @@ interface BasePort {
         relinked_columns: number;
         relinked_cells: number;
     }>>;
+    /** Automations and pages (dashboards) of a table, so a base copy carries them: `RecordsClient.automations` / `dashboards`. */
+    automations?(tableId: Uuid): Promise<RecordsResult<{
+        automations: Array<{
+            id: Uuid;
+            name: string;
+            spec: unknown;
+            enabled: boolean;
+        }>;
+    }>>;
+    automationDeclare?(args: {
+        table_id: Uuid;
+        spec: unknown;
+    }): Promise<RecordsResult<{
+        ok: boolean;
+        automation_id?: Uuid;
+    }>>;
+    automationSetEnabled?(args: {
+        automation_id: Uuid;
+        enabled: boolean;
+    }): Promise<RecordsResult<unknown>>;
+    dashboards?(tableId: Uuid): Promise<RecordsResult<Array<{
+        dashboard_id: Uuid;
+        name: string;
+        blocks: unknown[];
+        presentation: Record<string, unknown>;
+    }>>>;
+    dashboardDeclare?(args: {
+        table_id: Uuid;
+        name: string;
+        blocks: unknown[];
+        presentation: Record<string, unknown> | null;
+    }): Promise<RecordsResult<Uuid>>;
     /** `RecordsClient.tableArchive` / its restore: put a copy away, or bring it back to be copied from. */
     archive?(tableId: Uuid): Promise<RecordsResult<unknown>>;
     unarchive?(tableId: Uuid): Promise<RecordsResult<unknown>>;
@@ -157,6 +189,11 @@ interface BaseCopied {
     }>;
     relinkedColumns: number;
     relinkedCells: number;
+    /** Automations copied (every one OFF) and pages copied, with every table id inside them pointing at the copies. */
+    automations: number;
+    pages: number;
+    /** One sentence per automation or page that could not be copied. */
+    extrasRefused: string[];
     /** What a copy never carries, from the per-table door's own words, once per table. */
     notCopied: string[];
 }
@@ -182,6 +219,8 @@ declare function duplicateBase(port: BasePort, args: {
     nameFor?: (table: BaseTable) => string;
     onProgress?: (p: BaseCopyProgress) => void;
 }): Promise<BaseCopyResult>;
+/** Every table id (and any id of a copied table) inside a document becomes its copy's id. Column keys are kept by a copy, so they stay. */
+declare function pointAtCopies<T>(doc: T, pairs: Record<Uuid, Uuid>): T;
 interface BaseSnapshotRecord {
     label: string;
     origin: "manual" | "schedule";
@@ -524,4 +563,4 @@ declare function alternatePatch(document: RecordDocument, field_key: string, alt
 };
 declare function chooseAlternate(client: Pick<RecordsClient, "recordRead" | "recordAsOf" | "recordUpdate">, { record_id, field_key, alternate_index, rank }: ChooseAlternateArgs): Promise<RecordsResult<number>>;
 
-export { type BaseCopied, type BaseCopyProgress, type BaseCopyResult, type BasePort, type BaseSnapshotRecord, type BaseTable, CaptureFileRef, CaptureOutcome, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSyncReport, type ChooseAlternateArgs, CoercibleField, Delivery, Freshness, type MergeField, MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, type MergeFieldTransform, type MissingBehavior, OverridePolicy, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, REFUSALS_WORTH_REPEATING, RecordDocument, RecordsResult, type ResolutionTriple, TableDuplicateProgress, TableDuplicated, Timestamp, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, Uuid, alternatePatch, autonumberJoin, autonumberPrefixOf, autonumberSearchOf, autonumberWords, baseCopyName, chooseAlternate, duplicateBase, filterWithAutonumber, indexedDbStore, isAutonumberField, isDecided, localeDateOrder, memoryStore, mintClientKey, openCaptureQueue, rankTypedMatches, readTypedDate, readTypedNumber, readTypedTime, restoreSnapshot, snapshotBase, twoDigitYear, typedDateText, typedMatchScore, typedTimeText };
+export { type BaseCopied, type BaseCopyProgress, type BaseCopyResult, type BasePort, type BaseSnapshotRecord, type BaseTable, CaptureFileRef, CaptureOutcome, type CaptureQueue, type CaptureQueueCounts, type CaptureQueueOptions, type CaptureQueuePorts, type CaptureQueueStore, type CaptureSyncReport, type ChooseAlternateArgs, CoercibleField, Delivery, Freshness, type MergeField, MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, type MergeFieldTransform, type MissingBehavior, OverridePolicy, type QueuedCapture, type QueuedCaptureFile, type QueuedCaptureState, REFUSALS_WORTH_REPEATING, RecordDocument, RecordsResult, type ResolutionTriple, TableDuplicateProgress, TableDuplicated, Timestamp, type TypedDate, type TypedMatchScore, type TypedNumber, type TypedTime, Uuid, alternatePatch, autonumberJoin, autonumberPrefixOf, autonumberSearchOf, autonumberWords, baseCopyName, chooseAlternate, duplicateBase, filterWithAutonumber, indexedDbStore, isAutonumberField, isDecided, localeDateOrder, memoryStore, mintClientKey, openCaptureQueue, pointAtCopies, rankTypedMatches, readTypedDate, readTypedNumber, readTypedTime, restoreSnapshot, snapshotBase, twoDigitYear, typedDateText, typedMatchScore, typedTimeText };

package/dist/index.js

@@ -1719,6 +1719,7 @@ 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 };
+  const extras = await copyExtras(port, args.tables, pairs);
   return {
     ok: true,
     data: {
@@ -1726,10 +1727,53 @@ async function duplicateBase(port, args) {
       tables: made,
       relinkedColumns: fin?.ok ? fin.data.relinked_columns : 0,
       relinkedCells: fin?.ok ? fin.data.relinked_cells : 0,
+      ...extras,
       notCopied: [...notCopied]
     }
   };
 }
+function pointAtCopies(doc, pairs) {
+  let text = JSON.stringify(doc);
+  for (const [from, to] of Object.entries(pairs)) text = text.split(from).join(to);
+  return JSON.parse(text);
+}
+async function copyExtras(port, tables, pairs) {
+  let automations = 0;
+  let pages = 0;
+  const extrasRefused = [];
+  for (const t of tables) {
+    const copy = pairs[t.id];
+    if (!copy) continue;
+    if (port.automations && port.automationDeclare) {
+      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) });
+          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.`);
+        }
+      }
+    }
+    if (port.dashboards && port.dashboardDeclare) {
+      const list = await port.dashboards(t.id);
+      if (list.ok) {
+        for (const d of list.data) {
+          const made = await port.dashboardDeclare({
+            table_id: copy,
+            name: d.name,
+            blocks: pointAtCopies(d.blocks, pairs),
+            presentation: pointAtCopies(d.presentation, pairs)
+          });
+          if (made.ok) pages += 1;
+          else extrasRefused.push(`Page "${d.name}" on ${t.name} was not copied.`);
+        }
+      }
+    }
+  }
+  return { automations, pages, extrasRefused };
+}
 async function snapshotBase(port, args) {
   const copied = await duplicateBase(port, {
     organizationId: args.organizationId,
@@ -5707,6 +5751,7 @@ export {
   parseTableHome,
   parseTableMoved,
   personStampText,
+  pointAtCopies,
   portalArchiveConsequence,
   portalConfirmLine,
   portalPath,