@atscript/db 0.1.150 → 0.1.152

package/dist/agg.d.cts

@@ -1,3 +1,3 @@
-import { r as TResolvedBucket } from "./buckets-24Ac4sIS.cjs";
+import { r as TResolvedBucket } from "./buckets-tzd8iIM2.cjs";
 import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-42CSpGDR.cjs";
 export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, type BucketExpr, type BucketUnit, type CalendarBucketLabel, type ComputedExpr, type ResolvedBucket, type TDbAggregateFn, type TResolvedBucket, type WeekStart, assertAggregateFn, isAggregateExpr, isBucketExpr, resolveAggregateSearch, resolveAlias };

package/dist/agg.d.mts

@@ -1,3 +1,3 @@
-import { r as TResolvedBucket } from "./buckets-XOz0Bw5x.mjs";
+import { r as TResolvedBucket } from "./buckets-Cb0zmhDc.mjs";
 import { _ as TDbAggregateFn, a as AggregateResult, c as CalendarBucketLabel, d as WeekStart, f as isAggregateExpr, h as resolveAlias, i as AggregateQuery, l as ComputedExpr, m as resolveAggregateSearch, n as AggregateExpr, o as BucketExpr, p as isBucketExpr, r as AggregateFn, s as BucketUnit, t as AggregateControls, u as ResolvedBucket, v as assertAggregateFn } from "./agg-Wo-smrYV.mjs";
 export { type AggregateControls, type AggregateExpr, type AggregateFn, type AggregateQuery, type AggregateResult, type BucketExpr, type BucketUnit, type CalendarBucketLabel, type ComputedExpr, type ResolvedBucket, type TDbAggregateFn, type TResolvedBucket, type WeekStart, assertAggregateFn, isAggregateExpr, isBucketExpr, resolveAggregateSearch, resolveAlias };

package/dist/{buckets-XOz0Bw5x.d.mts → buckets-Cb0zmhDc.d.mts}

@@ -707,6 +707,8 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
    * @since 0.1.148
    */
   get uniqueKeySets(): string[][];
+  private _uniqueKeySets?;
+  private _computeUniqueKeySets;
   /** Preferred row identifier field names. Defaults to primary keys. */
   get preferredId(): readonly string[];
   /** Legitimate row-identifier shapes (primary key + every unique index). */
@@ -1201,7 +1203,12 @@ type TCascadePin = FilterExpr[] | undefined;
 declare abstract class IntegrityStrategy {
   abstract validateForeignKeys(items: Array<Record<string, unknown>>, meta: TableMetadata, fkLookupResolver: TFkLookupResolver | undefined, writeTableResolver: TWriteTableResolver | undefined, partial?: boolean, excludeTargetTable?: string): Promise<void>;
   abstract cascadeBeforeDelete(filter: FilterExpr, tableName: string, meta: TableMetadata, cascadeResolver: TCascadeResolver, translateFilter: (f: FilterExpr) => FilterExpr, adapter: BaseDbAdapter): Promise<TCascadePin>;
-  abstract needsCascade(cascadeResolver: TCascadeResolver | undefined): boolean;
+  /**
+   * Whether a delete must run the application-level cascade pass. `tableName`
+   * (optional, since 0.1.151) lets the strategy answer `false` for a table
+   * nothing references.
+   */
+  abstract needsCascade(cascadeResolver: TCascadeResolver | undefined, tableName?: string): boolean;
 }
 /**
  * Integrity strategy for adapters with native FK support (e.g. SQLite, MySQL).
@@ -1396,6 +1403,21 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * parent, so the write never touches a child of another parent.
    */
   private _rowFilters;
+  /**
+   * Whether a `*One` / `bulk*` write of `payloads` is a single statement that
+   * needs no wrapping transaction (since 0.1.151): one root-level row, no
+   * `guard` / `check` (their reads and the write must share one snapshot),
+   * no nested navigation data (multi-table phases), and FK integrity enforced
+   * by the database (application-level FK checks read before writing). The
+   * write then calls the adapter outside any transaction of its own — one
+   * `insertMany([row])` / `replaceOne` / `updateOne` / `nativePatch`, or a
+   * read-only `count` for an empty patch; the array-operator read-modify-write
+   * still opens a transaction for its pair. Adapters may rely on it: a
+   * single-row `insertMany` reached this way runs outside a transaction.
+   */
+  private _isSingleStatementWrite;
+  /** Runs a write body inside the adapter transaction — or directly for a single-statement write. */
+  private _inWriteTransaction;
   /** Whether `filter` names every primary-key field (so it IS the row's exact key). */
   private _isPkFilter;
   /**
@@ -1465,6 +1487,13 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * engine's own default applies. The version column is never touched.
    */
   protected _applyDefaults(data: Record<string, unknown>): Record<string, unknown>;
+  /**
+   * Parsed `@db.default 'literal'` values that are primitives — reused for
+   * every row (an object / array default is parsed per row: each row gets
+   * its own instance).
+   */
+  private _primitiveDefaults?;
+  private _valueDefault;
   /**
    * The JS value for a `@db.default 'literal'`: strings (including unions of
    * string literals) are used as-is, every other design type is parsed as
@@ -1858,6 +1887,12 @@ declare class DbSpace implements AsyncDisposable {
   private _readables;
   /** All tables created in this space — used for reverse FK lookup during cascade. */
   private _allTables;
+  /**
+   * Per-table-name memo of {@link _getCascadeTargets} / {@link _getFkLookupTarget}
+   * (since 0.1.151) — both scan every table; cleared whenever a table is added.
+   */
+  private _cascadeTargets;
+  private _fkLookupTargets;
   /** Every table / view handle the space created — flagged closed on {@link close}. */
   private _handles;
   /** Lazily created adapter for administrative ops (drop table/view) that don't need a registered readable. */
@@ -1952,11 +1987,13 @@ declare class DbSpace implements AsyncDisposable {
    * Accesses `table.foreignKeys` which triggers `_flatten()` if needed.
    */
   private _getCascadeTargets;
+  private _scanCascadeTargets;
   /**
    * Resolves a table name to a queryable target for FK validation.
    * Searches all registered tables for one with the matching table name.
    */
   private _getFkLookupTarget;
+  private _scanFkLookupTarget;
 }
 //#endregion
 //#region src/base-adapter.d.ts

package/dist/{buckets-24Ac4sIS.d.cts → buckets-tzd8iIM2.d.cts}

@@ -707,6 +707,8 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
    * @since 0.1.148
    */
   get uniqueKeySets(): string[][];
+  private _uniqueKeySets?;
+  private _computeUniqueKeySets;
   /** Preferred row identifier field names. Defaults to primary keys. */
   get preferredId(): readonly string[];
   /** Legitimate row-identifier shapes (primary key + every unique index). */
@@ -1201,7 +1203,12 @@ type TCascadePin = FilterExpr[] | undefined;
 declare abstract class IntegrityStrategy {
   abstract validateForeignKeys(items: Array<Record<string, unknown>>, meta: TableMetadata, fkLookupResolver: TFkLookupResolver | undefined, writeTableResolver: TWriteTableResolver | undefined, partial?: boolean, excludeTargetTable?: string): Promise<void>;
   abstract cascadeBeforeDelete(filter: FilterExpr, tableName: string, meta: TableMetadata, cascadeResolver: TCascadeResolver, translateFilter: (f: FilterExpr) => FilterExpr, adapter: BaseDbAdapter): Promise<TCascadePin>;
-  abstract needsCascade(cascadeResolver: TCascadeResolver | undefined): boolean;
+  /**
+   * Whether a delete must run the application-level cascade pass. `tableName`
+   * (optional, since 0.1.151) lets the strategy answer `false` for a table
+   * nothing references.
+   */
+  abstract needsCascade(cascadeResolver: TCascadeResolver | undefined, tableName?: string): boolean;
 }
 /**
  * Integrity strategy for adapters with native FK support (e.g. SQLite, MySQL).
@@ -1396,6 +1403,21 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * parent, so the write never touches a child of another parent.
    */
   private _rowFilters;
+  /**
+   * Whether a `*One` / `bulk*` write of `payloads` is a single statement that
+   * needs no wrapping transaction (since 0.1.151): one root-level row, no
+   * `guard` / `check` (their reads and the write must share one snapshot),
+   * no nested navigation data (multi-table phases), and FK integrity enforced
+   * by the database (application-level FK checks read before writing). The
+   * write then calls the adapter outside any transaction of its own — one
+   * `insertMany([row])` / `replaceOne` / `updateOne` / `nativePatch`, or a
+   * read-only `count` for an empty patch; the array-operator read-modify-write
+   * still opens a transaction for its pair. Adapters may rely on it: a
+   * single-row `insertMany` reached this way runs outside a transaction.
+   */
+  private _isSingleStatementWrite;
+  /** Runs a write body inside the adapter transaction — or directly for a single-statement write. */
+  private _inWriteTransaction;
   /** Whether `filter` names every primary-key field (so it IS the row's exact key). */
   private _isPkFilter;
   /**
@@ -1465,6 +1487,13 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * engine's own default applies. The version column is never touched.
    */
   protected _applyDefaults(data: Record<string, unknown>): Record<string, unknown>;
+  /**
+   * Parsed `@db.default 'literal'` values that are primitives — reused for
+   * every row (an object / array default is parsed per row: each row gets
+   * its own instance).
+   */
+  private _primitiveDefaults?;
+  private _valueDefault;
   /**
    * The JS value for a `@db.default 'literal'`: strings (including unions of
    * string literals) are used as-is, every other design type is parsed as
@@ -1858,6 +1887,12 @@ declare class DbSpace implements AsyncDisposable {
   private _readables;
   /** All tables created in this space — used for reverse FK lookup during cascade. */
   private _allTables;
+  /**
+   * Per-table-name memo of {@link _getCascadeTargets} / {@link _getFkLookupTarget}
+   * (since 0.1.151) — both scan every table; cleared whenever a table is added.
+   */
+  private _cascadeTargets;
+  private _fkLookupTargets;
   /** Every table / view handle the space created — flagged closed on {@link close}. */
   private _handles;
   /** Lazily created adapter for administrative ops (drop table/view) that don't need a registered readable. */
@@ -1952,11 +1987,13 @@ declare class DbSpace implements AsyncDisposable {
    * Accesses `table.foreignKeys` which triggers `_flatten()` if needed.
    */
   private _getCascadeTargets;
+  private _scanCascadeTargets;
   /**
    * Resolves a table name to a queryable target for FK validation.
    * Searches all registered tables for one with the matching table name.
    */
   private _getFkLookupTarget;
+  private _scanFkLookupTarget;
 }
 //#endregion
 //#region src/base-adapter.d.ts