@atscript/db 0.1.161 → 0.1.163

package/dist/sync.d.cts

@@ -1,5 +1,5 @@
-import { At as TPrimaryKeyChange, Jn as TGenericLogger, Lt as TTableOptionDiff, U as TDbFieldMeta, et as TDbObjectKind, gt as TEnsureTableOptions, jt as TReferencingForeignKey, mt as TDerivedChangeReason, nn as DbSpace, vt as TExistingForeignKey, yt as TExistingTableOption } from "./buckets-B4T_alUe.cjs";
-import { _ as computeTableSnapshot, a as hasForeignKeyChanges, b as snapshotToExistingTableOptions, c as TFieldSnapshot, d as TViewColumnSnapshot, f as TViewJoinSnapshot, g as computeTableHash, h as computeSchemaHash, i as fkKey, l as TForeignKeySnapshot, m as canonicalizeQueryNode, n as computeForeignKeyDiff, o as computeColumnDiff, p as TViewSnapshot, t as TForeignKeyDiff, u as TTableSnapshot, v as computeViewSnapshot, y as snapshotToExistingColumns } from "./fk-diff-BWdQ7kRZ.cjs";
+import { Ct as TEnsureTableOptions, Et as TExistingTableOption, G as TDbFieldMeta, Pt as TIndexChange, Tt as TExistingForeignKey, Vt as TReferencingForeignKey, at as TDbObjectKind, cr as TGenericLogger, gn as DbSpace, qt as TTableOptionDiff, xt as TDerivedChangeReason, zt as TPrimaryKeyChange } from "./buckets-B8UOod-v.cjs";
+import { S as snapshotToExistingTableOptions, _ as computeSchemaHash, a as hasForeignKeyChanges, b as computeViewSnapshot, d as TForeignKeySnapshot, f as TTableSnapshot, g as canonicalizeQueryNode, h as TViewSnapshot, i as fkKey, l as sameDefaultValue, m as TViewJoinSnapshot, n as computeForeignKeyDiff, o as TColumnDiffOptions, p as TViewColumnSnapshot, s as computeColumnDiff, t as TForeignKeyDiff, u as TFieldSnapshot, v as computeTableHash, x as snapshotToExistingColumns, y as computeTableSnapshot } from "./fk-diff-BNGawZi9.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts
@@ -150,6 +150,23 @@ interface TSyncEntryInit {
    * @since 0.1.141
    */
   cascadeFrom?: string[];
+  /**
+   * `true` on a managed view whose own definition changed since the last
+   * sync — the reason it is dropped and recreated. Printed as
+   * `· definition changed`.
+   * @since 0.1.162
+   */
+  definitionChanged?: boolean;
+  /**
+   * Managed indexes created, dropped or rebuilt (definition drift). On a
+   * plan entry: what the run's index sync would do to the live table as it
+   * is now (before the entry's column changes; not planned for a table the
+   * run creates, recreates or renames). On a run entry: what it did — not
+   * reported for a created or recreated table. Either marks the entry
+   * `alter`.
+   * @since 0.1.162
+   */
+  indexChanges?: TIndexChange[];
 }
 declare class SyncEntry {
   readonly name: string;
@@ -223,6 +240,10 @@ declare class SyncEntry {
   readonly refused: boolean;
   /** @since 0.1.141 — see {@link TSyncEntryInit.cascadeFrom}. */
   readonly cascadeFrom: string[];
+  /** @since 0.1.162 — see {@link TSyncEntryInit.definitionChanged}. */
+  readonly definitionChanged: boolean;
+  /** @since 0.1.162 — see {@link TSyncEntryInit.indexChanges}. */
+  readonly indexChanges: TIndexChange[];
   constructor(init: TSyncEntryInit);
   /**
    * The init object this entry was built from — lets callers derive a
@@ -259,8 +280,9 @@ declare class SyncEntry {
   /** `! PK (id) → (code) — rebuild (table is empty)` / `— rebuild (rows satisfy the new key)` / `— skipped (safe mode)` */
   private printPkChange;
   /**
-   * `! col: t1 → t2 — drop` (plan), or `! type col (t1 → t2) — skipped (safe
-   * mode)` in plan and result when the `'drop'` recreate was skipped.
+   * `! col: t1 → t2 — drop` (plan), `~ col: t1 → t2 — type changed` (result),
+   * or `! type col (t1 → t2) — skipped (safe mode)` in plan and result when
+   * the `'drop'` recreate was skipped.
    */
   private printTypeChanges;
   /**
@@ -278,6 +300,12 @@ declare class SyncEntry {
    * change. Both: `! option k: a → b — skipped (safe mode)` when pending.
    */
   private printOptionChanges;
+  /** `+ FK(a) → t — add` / `- … — remove` / `~ … — details` (plan); `added` / `removed` (result). */
+  private printForeignKeys;
+  /** `+ index name — add` / `- … — drop` / `~ … — rebuild` (plan); `added` / `dropped` / `rebuilt` (result). */
+  private printIndexChanges;
+  /** `· definition changed` — why a managed view is recreated. */
+  private printDefinitionChanged;
   /** `· after: a, b` (plan only — the executor already runs in this order). */
   private printDependsOn;
   /** `· upstream view "x" recreated` — why an unchanged view is recreated. */
@@ -423,6 +451,14 @@ declare class SchemaSync {
    * `safe` — safe mode skips the key rebuild, so its plan rule does not apply.
    */
   private discoverTable;
+  /**
+   * Folds the index / foreign-key work on each live table as it is now
+   * (`planIndexes` / `planForeignKeys`) into its plan entry. Read only when
+   * plan entries are reported (`plan()`, a refused run) — a run reports what
+   * `syncIndexes` / `syncForeignKeys` did.
+   */
+  private planLiveWork;
+  private planTableLiveWork;
   /**
    * Pure validation over the discovery facts. Every refusal is a change that
    * no order of DDL can apply safely; the messages are user-facing.
@@ -566,4 +602,4 @@ declare function syncSchema(space: DbSpace, types: readonly TAtscriptAnnotatedTy
  */
 declare function planSchema(space: DbSpace, types: readonly TAtscriptAnnotatedType[], opts?: Pick<TSyncOptions, "force" | "safe">): Promise<TSyncPlan>;
 //#endregion
-export { SchemaSync, SyncEntry, type TDbObjectKind, type TDependencyEdge, type TEnsureTableOptions, type TExistingForeignKey, type TFieldSnapshot, type TForeignKeyDiff, type TForeignKeySnapshot, type TPrimaryKeyChange, type TReferencingForeignKey, type TSyncColors, type TSyncDerivedChange, type TSyncEntryInit, type TSyncEntryStatus, type TSyncOptions, type TSyncPlan, type TSyncResult, type TSyncSkippedWork, type TTableSnapshot, type TViewColumnSnapshot, type TViewJoinSnapshot, type TViewSnapshot, canonicalizeQueryNode, computeColumnDiff, computeForeignKeyDiff, computeSchemaHash, computeTableHash, computeTableOptionDiff, computeTableSnapshot, computeViewSnapshot, fkKey, hasForeignKeyChanges, planSchema, readStoredSnapshot, snapshotToExistingColumns, snapshotToExistingTableOptions, syncSchema, topoOrder };
+export { SchemaSync, SyncEntry, type TColumnDiffOptions, type TDbObjectKind, type TDependencyEdge, type TEnsureTableOptions, type TExistingForeignKey, type TFieldSnapshot, type TForeignKeyDiff, type TForeignKeySnapshot, type TPrimaryKeyChange, type TReferencingForeignKey, type TSyncColors, type TSyncDerivedChange, type TSyncEntryInit, type TSyncEntryStatus, type TSyncOptions, type TSyncPlan, type TSyncResult, type TSyncSkippedWork, type TTableSnapshot, type TViewColumnSnapshot, type TViewJoinSnapshot, type TViewSnapshot, canonicalizeQueryNode, computeColumnDiff, computeForeignKeyDiff, computeSchemaHash, computeTableHash, computeTableOptionDiff, computeTableSnapshot, computeViewSnapshot, fkKey, hasForeignKeyChanges, planSchema, readStoredSnapshot, sameDefaultValue, snapshotToExistingColumns, snapshotToExistingTableOptions, syncSchema, topoOrder };

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { At as TPrimaryKeyChange, Jn as TGenericLogger, Lt as TTableOptionDiff, U as TDbFieldMeta, et as TDbObjectKind, gt as TEnsureTableOptions, jt as TReferencingForeignKey, mt as TDerivedChangeReason, nn as DbSpace, vt as TExistingForeignKey, yt as TExistingTableOption } from "./buckets-8mG67Mtw.mjs";
-import { _ as computeTableSnapshot, a as hasForeignKeyChanges, b as snapshotToExistingTableOptions, c as TFieldSnapshot, d as TViewColumnSnapshot, f as TViewJoinSnapshot, g as computeTableHash, h as computeSchemaHash, i as fkKey, l as TForeignKeySnapshot, m as canonicalizeQueryNode, n as computeForeignKeyDiff, o as computeColumnDiff, p as TViewSnapshot, t as TForeignKeyDiff, u as TTableSnapshot, v as computeViewSnapshot, y as snapshotToExistingColumns } from "./fk-diff-5gX42hBt.mjs";
+import { Ct as TEnsureTableOptions, Et as TExistingTableOption, G as TDbFieldMeta, Pt as TIndexChange, Tt as TExistingForeignKey, Vt as TReferencingForeignKey, at as TDbObjectKind, cr as TGenericLogger, gn as DbSpace, qt as TTableOptionDiff, xt as TDerivedChangeReason, zt as TPrimaryKeyChange } from "./buckets-CHyspjYP.mjs";
+import { S as snapshotToExistingTableOptions, _ as computeSchemaHash, a as hasForeignKeyChanges, b as computeViewSnapshot, d as TForeignKeySnapshot, f as TTableSnapshot, g as canonicalizeQueryNode, h as TViewSnapshot, i as fkKey, l as sameDefaultValue, m as TViewJoinSnapshot, n as computeForeignKeyDiff, o as TColumnDiffOptions, p as TViewColumnSnapshot, s as computeColumnDiff, t as TForeignKeyDiff, u as TFieldSnapshot, v as computeTableHash, x as snapshotToExistingColumns, y as computeTableSnapshot } from "./fk-diff-rj9N2QLw.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts
@@ -150,6 +150,23 @@ interface TSyncEntryInit {
    * @since 0.1.141
    */
   cascadeFrom?: string[];
+  /**
+   * `true` on a managed view whose own definition changed since the last
+   * sync — the reason it is dropped and recreated. Printed as
+   * `· definition changed`.
+   * @since 0.1.162
+   */
+  definitionChanged?: boolean;
+  /**
+   * Managed indexes created, dropped or rebuilt (definition drift). On a
+   * plan entry: what the run's index sync would do to the live table as it
+   * is now (before the entry's column changes; not planned for a table the
+   * run creates, recreates or renames). On a run entry: what it did — not
+   * reported for a created or recreated table. Either marks the entry
+   * `alter`.
+   * @since 0.1.162
+   */
+  indexChanges?: TIndexChange[];
 }
 declare class SyncEntry {
   readonly name: string;
@@ -223,6 +240,10 @@ declare class SyncEntry {
   readonly refused: boolean;
   /** @since 0.1.141 — see {@link TSyncEntryInit.cascadeFrom}. */
   readonly cascadeFrom: string[];
+  /** @since 0.1.162 — see {@link TSyncEntryInit.definitionChanged}. */
+  readonly definitionChanged: boolean;
+  /** @since 0.1.162 — see {@link TSyncEntryInit.indexChanges}. */
+  readonly indexChanges: TIndexChange[];
   constructor(init: TSyncEntryInit);
   /**
    * The init object this entry was built from — lets callers derive a
@@ -259,8 +280,9 @@ declare class SyncEntry {
   /** `! PK (id) → (code) — rebuild (table is empty)` / `— rebuild (rows satisfy the new key)` / `— skipped (safe mode)` */
   private printPkChange;
   /**
-   * `! col: t1 → t2 — drop` (plan), or `! type col (t1 → t2) — skipped (safe
-   * mode)` in plan and result when the `'drop'` recreate was skipped.
+   * `! col: t1 → t2 — drop` (plan), `~ col: t1 → t2 — type changed` (result),
+   * or `! type col (t1 → t2) — skipped (safe mode)` in plan and result when
+   * the `'drop'` recreate was skipped.
    */
   private printTypeChanges;
   /**
@@ -278,6 +300,12 @@ declare class SyncEntry {
    * change. Both: `! option k: a → b — skipped (safe mode)` when pending.
    */
   private printOptionChanges;
+  /** `+ FK(a) → t — add` / `- … — remove` / `~ … — details` (plan); `added` / `removed` (result). */
+  private printForeignKeys;
+  /** `+ index name — add` / `- … — drop` / `~ … — rebuild` (plan); `added` / `dropped` / `rebuilt` (result). */
+  private printIndexChanges;
+  /** `· definition changed` — why a managed view is recreated. */
+  private printDefinitionChanged;
   /** `· after: a, b` (plan only — the executor already runs in this order). */
   private printDependsOn;
   /** `· upstream view "x" recreated` — why an unchanged view is recreated. */
@@ -423,6 +451,14 @@ declare class SchemaSync {
    * `safe` — safe mode skips the key rebuild, so its plan rule does not apply.
    */
   private discoverTable;
+  /**
+   * Folds the index / foreign-key work on each live table as it is now
+   * (`planIndexes` / `planForeignKeys`) into its plan entry. Read only when
+   * plan entries are reported (`plan()`, a refused run) — a run reports what
+   * `syncIndexes` / `syncForeignKeys` did.
+   */
+  private planLiveWork;
+  private planTableLiveWork;
   /**
    * Pure validation over the discovery facts. Every refusal is a change that
    * no order of DDL can apply safely; the messages are user-facing.
@@ -566,4 +602,4 @@ declare function syncSchema(space: DbSpace, types: readonly TAtscriptAnnotatedTy
  */
 declare function planSchema(space: DbSpace, types: readonly TAtscriptAnnotatedType[], opts?: Pick<TSyncOptions, "force" | "safe">): Promise<TSyncPlan>;
 //#endregion
-export { SchemaSync, SyncEntry, type TDbObjectKind, type TDependencyEdge, type TEnsureTableOptions, type TExistingForeignKey, type TFieldSnapshot, type TForeignKeyDiff, type TForeignKeySnapshot, type TPrimaryKeyChange, type TReferencingForeignKey, type TSyncColors, type TSyncDerivedChange, type TSyncEntryInit, type TSyncEntryStatus, type TSyncOptions, type TSyncPlan, type TSyncResult, type TSyncSkippedWork, type TTableSnapshot, type TViewColumnSnapshot, type TViewJoinSnapshot, type TViewSnapshot, canonicalizeQueryNode, computeColumnDiff, computeForeignKeyDiff, computeSchemaHash, computeTableHash, computeTableOptionDiff, computeTableSnapshot, computeViewSnapshot, fkKey, hasForeignKeyChanges, planSchema, readStoredSnapshot, snapshotToExistingColumns, snapshotToExistingTableOptions, syncSchema, topoOrder };
+export { SchemaSync, SyncEntry, type TColumnDiffOptions, type TDbObjectKind, type TDependencyEdge, type TEnsureTableOptions, type TExistingForeignKey, type TFieldSnapshot, type TForeignKeyDiff, type TForeignKeySnapshot, type TPrimaryKeyChange, type TReferencingForeignKey, type TSyncColors, type TSyncDerivedChange, type TSyncEntryInit, type TSyncEntryStatus, type TSyncOptions, type TSyncPlan, type TSyncResult, type TSyncSkippedWork, type TTableSnapshot, type TViewColumnSnapshot, type TViewJoinSnapshot, type TViewSnapshot, canonicalizeQueryNode, computeColumnDiff, computeForeignKeyDiff, computeSchemaHash, computeTableHash, computeTableOptionDiff, computeTableSnapshot, computeViewSnapshot, fkKey, hasForeignKeyChanges, planSchema, readStoredSnapshot, sameDefaultValue, snapshotToExistingColumns, snapshotToExistingTableOptions, syncSchema, topoOrder };