@atscript/db 0.1.128 → 0.1.129

package/dist/sync.d.cts

@@ -1,5 +1,5 @@
-import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, Nt as TGenericLogger, O as TColumnDiff, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-CkbZn_z-.cjs";
-import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-BevOyVrC.cjs";
+import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, O as TColumnDiff, Pt as TGenericLogger, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-B7eYWS5q.cjs";
+import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-C2UCnGHd.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts
@@ -175,6 +175,13 @@ declare class SyncEntry {
    * @since 0.1.128
    */
   toInit(): TSyncEntryInit;
+  /**
+   * This entry as an `error` entry with `msg` appended to its errors — the
+   * shape a DDL failure inside the entry's step reports (the planned work is
+   * kept, the status says it did not land).
+   * @since 0.1.129
+   */
+  withError(msg: string): SyncEntry;
   /**
    * Whether desired work is still pending after this entry — DDL that was
    * not issued because the entry errored or safe mode skipped it (see
@@ -379,13 +386,14 @@ interface TSyncOptions {
    */
   safe?: boolean;
   /**
-   * Logger for sync progress and failures (index/FK DDL errors are logged,
-   * not thrown). Default: NoopLogger — pass `console` to surface them.
+   * Logger for sync progress and failures (DDL errors inside a table's step
+   * are logged and recorded on its entry, not thrown). Default: NoopLogger —
+   * pass `console` to surface them.
    */
   logger?: TGenericLogger;
   /**
-   * What to do when the run finishes with errored entries (failed index/FK
-   * DDL, external-view checks, pre-flight refusals, …):
+   * What to do when the run finishes with errored entries (failed DDL inside
+   * a table's step, external-view checks, pre-flight refusals, …):
    * - `"warn"` (default) — emit a one-line summary plus per-entry error lines
    *   via the configured logger, **falling back to `console` when no logger
    *   is set** (errors are never silently swallowed by the NoopLogger default);
@@ -459,6 +467,7 @@ declare class SchemaSync {
    * Introspects one desired table and computes its plan entry.
    * `probeRecreateInbound` — whether a drop-and-recreate's live inbound FKs
    * are worth probing (a removed table exists that could block it).
+   * `safe` — safe mode skips the key rebuild, so its plan rule does not apply.
    */
   private discoverTable;
   /**
@@ -486,6 +495,8 @@ declare class SchemaSync {
    * before the table they block) and late groups (after the views) alike.
    */
   private dropRemovedGroup;
+  /** The error-entry message of a DDL failure inside a view step, logged at error level. */
+  private stepFailed;
   /**
    * Surfaces the run outcome per the `onError` policy. Reporting must never be
    * silently lost to the NoopLogger default — when no real logger is
@@ -503,6 +514,13 @@ declare class SchemaSync {
   private resolveTypeMapper;
   /**
    * Populates plan init from a column diff (shared by Path A and Path B).
+   *
+   * The plan's rule set is canonical (since 0.1.129): every change the
+   * executor cannot apply without DDL it does not have is an `error` entry
+   * here, and `executeSyncTable` returns an errored plan entry untouched —
+   * so the executor's own copies of these rules are reached only when
+   * discovery had no diff (a pending rename whose old name it could not
+   * introspect).
    */
   private populatePlanFromDiff;
   /**

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, Nt as TGenericLogger, O as TColumnDiff, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-BTl4NzNN.mjs";
-import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-BEB5Jl8M.mjs";
+import { B as TDbForeignKey, K as TDbObjectKind, L as TDbDefaultValue, O as TColumnDiff, Pt as TGenericLogger, Z as TDbStorageType, at as TExistingForeignKey, ht as TReferencingForeignKey, it as TExistingColumn, mt as TPrimaryKeyChange, ot as TExistingTableOption, rt as TEnsureTableOptions, t as AtscriptDbReadable, yt as TTableOptionDiff, z as TDbFieldMeta } from "./db-readable-Bn1bV_eC.mjs";
+import { c as AtscriptQueryFieldRef$1, i as AtscriptDbView, l as AtscriptQueryNode$1, t as DbSpace } from "./db-space-DdIPYD0Q.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts
@@ -175,6 +175,13 @@ declare class SyncEntry {
    * @since 0.1.128
    */
   toInit(): TSyncEntryInit;
+  /**
+   * This entry as an `error` entry with `msg` appended to its errors — the
+   * shape a DDL failure inside the entry's step reports (the planned work is
+   * kept, the status says it did not land).
+   * @since 0.1.129
+   */
+  withError(msg: string): SyncEntry;
   /**
    * Whether desired work is still pending after this entry — DDL that was
    * not issued because the entry errored or safe mode skipped it (see
@@ -379,13 +386,14 @@ interface TSyncOptions {
    */
   safe?: boolean;
   /**
-   * Logger for sync progress and failures (index/FK DDL errors are logged,
-   * not thrown). Default: NoopLogger — pass `console` to surface them.
+   * Logger for sync progress and failures (DDL errors inside a table's step
+   * are logged and recorded on its entry, not thrown). Default: NoopLogger —
+   * pass `console` to surface them.
    */
   logger?: TGenericLogger;
   /**
-   * What to do when the run finishes with errored entries (failed index/FK
-   * DDL, external-view checks, pre-flight refusals, …):
+   * What to do when the run finishes with errored entries (failed DDL inside
+   * a table's step, external-view checks, pre-flight refusals, …):
    * - `"warn"` (default) — emit a one-line summary plus per-entry error lines
    *   via the configured logger, **falling back to `console` when no logger
    *   is set** (errors are never silently swallowed by the NoopLogger default);
@@ -459,6 +467,7 @@ declare class SchemaSync {
    * Introspects one desired table and computes its plan entry.
    * `probeRecreateInbound` — whether a drop-and-recreate's live inbound FKs
    * are worth probing (a removed table exists that could block it).
+   * `safe` — safe mode skips the key rebuild, so its plan rule does not apply.
    */
   private discoverTable;
   /**
@@ -486,6 +495,8 @@ declare class SchemaSync {
    * before the table they block) and late groups (after the views) alike.
    */
   private dropRemovedGroup;
+  /** The error-entry message of a DDL failure inside a view step, logged at error level. */
+  private stepFailed;
   /**
    * Surfaces the run outcome per the `onError` policy. Reporting must never be
    * silently lost to the NoopLogger default — when no real logger is
@@ -503,6 +514,13 @@ declare class SchemaSync {
   private resolveTypeMapper;
   /**
    * Populates plan init from a column diff (shared by Path A and Path B).
+   *
+   * The plan's rule set is canonical (since 0.1.129): every change the
+   * executor cannot apply without DDL it does not have is an `error` entry
+   * here, and `executeSyncTable` returns an errored plan entry untouched —
+   * so the executor's own copies of these rules are reached only when
+   * discovery had no diff (a pending rename whose old name it could not
+   * introspect).
    */
   private populatePlanFromDiff;
   /**