@atscript/db 0.1.155 → 0.1.156

package/dist/agg.d.cts

@@ -1,3 +1,3 @@
-import { r as TResolvedBucket } from "./buckets-DcWm3SLt.cjs";
+import { r as TResolvedBucket } from "./buckets-B4T_alUe.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-goCoky8v.mjs";
+import { r as TResolvedBucket } from "./buckets-8mG67Mtw.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-goCoky8v.d.mts → buckets-8mG67Mtw.d.mts}

@@ -1551,8 +1551,23 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * that object is present (an absent or `null` embedded object stays so), and
    * in every object of an array on the way; a field inside a JSON value or an
    * array has no column default, so the SDK fills its function default too.
-   */
-  protected _applyDefaults(data: Record<string, unknown>): Record<string, unknown>;
+   * Every `now` default the SDK fills gets the one time `now` (one per write
+   * call, so `createdAt` / `updatedAt` of a new row are equal).
+   */
+  protected _applyDefaults(data: Record<string, unknown>, now?: number): Record<string, unknown>;
+  /**
+   * `@db.onUpdate.now` (since 0.1.156): sets each such field of a replace /
+   * patch payload to `now`, overriding the caller's value. A nested field
+   * (`audit.updatedAt`) is set inside its object only when the payload
+   * carries that object — in every item of an array on the way and of the
+   * items an array patch operator adds or updates — like
+   * {@link _applyDefaults}. `topLevel: false` (a patch) instead drops the
+   * caller's values of the table's own columns: {@link _stampTopLevel} sets
+   * them once the patch is known to write something.
+   */
+  private _stampOnUpdate;
+  /** Sets the top-level `@db.onUpdate.now` columns of a non-empty patch to `now`. */
+  private _stampTopLevel;
   /** {@link _nestedDefaultFillable} per nested default path. */
   private _fillableDefaults?;
   /**
@@ -2788,9 +2803,12 @@ declare abstract class BaseDbAdapter {
   abstract deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
   /**
    * Synchronizes indexes between the Atscript definitions and the database.
-   * Uses `this._table.indexes` for the full index definitions.
+   * Uses `this._table.indexes` for the full index definitions. Schema sync
+   * passes `opts` when safe mode skipped work the indexes depend on (see
+   * {@link TSyncIndexesOptions}); an adapter whose indexes do not depend on it
+   * ignores them.
    */
-  abstract syncIndexes(): Promise<void>;
+  abstract syncIndexes(opts?: TSyncIndexesOptions): Promise<void>;
   /**
    * Ensures the table exists in the database, creating it if needed.
    * Uses `this._table.tableName`, `this._table.schema`, etc.
@@ -2922,8 +2940,9 @@ declare abstract class BaseDbAdapter {
    * given columns. Called by schema sync BEFORE {@link dropColumns} — engines
    * like SQLite refuse to drop a column while an index still references it,
    * and a composite index that survives by name must be rebuilt without the
-   * removed column (recreated later by {@link syncIndexes}).
-   * Optional — only relational adapters implement this.
+   * removed column (recreated later by {@link syncIndexes}). MongoDB drops
+   * them because a unique index would reject the `$unset` (`null` twice).
+   * Optional — the SQL adapters and MongoDB implement this.
    */
   dropIndexesForColumns?(columns: string[]): Promise<void>;
   /**
@@ -3115,6 +3134,12 @@ declare class TableMetadata {
   /** Adapter-contributed multi-field unique keys (logical paths) — see `TMetadataOverrides.addUniqueKeys`. */
   uniqueKeys: string[][];
   defaults: Map<string, TDbDefaultValue>;
+  /**
+   * Logical paths annotated with `@db.onUpdate.now` (`number.timestamp.updated`
+   * applies it): set to the current time by every update and replace.
+   * @since 0.1.156
+   */
+  onUpdateNow: Set<string>;
   /** Logical path → `@db.column` override (top-level keys only on document storage). */
   columnMap: Map<string, string>;
   dimensions: string[];
@@ -4183,6 +4208,23 @@ interface TEnsureTableOptions {
    */
   deferForeignKeysTo?: ReadonlySet<string>;
 }
+/**
+ * Options accepted by `BaseDbAdapter.syncIndexes` (since 0.1.156): indexes
+ * that stay as they are because safe mode skipped the change they depend on
+ * (`entry.skipped`) — it is pending, applied by the next run without `safe`.
+ */
+interface TSyncIndexesOptions {
+  /**
+   * The primary-key rebuild is skipped (`'pk-rebuild'`): an adapter whose
+   * key is an index (MongoDB's `__pk` unique index) keeps the live one.
+   */
+  keepPrimaryKey?: boolean;
+  /**
+   * Physical columns whose type change is skipped (`'recreate'`): indexes
+   * over them are neither dropped, replaced nor created.
+   */
+  keepColumns?: readonly string[];
+}
 /** Result of applying column diff to the database. */
 interface TSyncColumnResult {
   added: string[];
@@ -4683,4 +4725,4 @@ declare function isJsonValueField(fd: TDbFieldMeta): boolean;
  */
 declare function jsonValueAncestor(path: string, jsonValueParents: ReadonlySet<string>): string | undefined;
 //#endregion
-export { TDbInsertResult as $, BaseDbAdapter as $t, TColumnDiff as A, ResolvedRelationFilter as An, TPrimaryKeyChange as At, TDbDefaultFn as B, relationStaticFilter as Bn, TViewJsonType as Bt, NavPropsOf$1 as C, NativeIntegrity as Cn, TIdDescriptor as Ct, PrimaryKeyOf$1 as D, resolveDesignType as Dn, TJsonCopyTarget as Dt, OwnPropsOf$1 as E, DbResponse as En, TInsertOptions as Et, TDbActionLevel as F, andFilters as Fn, TSyncColumnResult as Ft, TDbIndex as G, TReadControls as Gn, UniqueryControls$1 as Gt, TDbDeleteResult as H, TDbEncryptionOptions as Hn, TWriteTableResolver as Ht, TDbActionProcessor as I, containsRelationFilter as In, TTableOptionDiff as It, TDbInsertIgnoreOptions as J, TExprAggregate as Jn, isGeoIndexableType as Jt, TDbIndexField as K, NoopLogger as Kn, WithRelation$1 as Kt, TDbActionTargetSummary as L, forEachResolvedRelation as Ln, TTableResolver as Lt, TCrudPermissions as M, TRelationFilterJunction as Mn, TRelationInfo as Mt, TDbActionInfo as N, TRelationFilterTable as Nn, TRowResolveOptions as Nt, TCascadeResolver as O, REL_FILTER_MAX_DEPTH as On, TMetaResponse as Ot, TDbActionIntent as P, TRelationStaticFilter as Pn, TSearchIndexInfo as Pt, TDbInsertManyResult as Q, ALL_VIEW_CAPABILITIES as Qt, TDbAvailableActions as R, hasRelationOp as Rn, TTouchManyOptions as Rt, FlatOf$1 as S, IntegrityStrategy as Sn, TFkLookupTarget as St, NullsPlacement$1 as T, AtscriptDbReadable as Tn, TIdentification as Tt, TDbFieldMeta as U, DocumentFieldMapper as Un, TypedWithRelation as Ut, TDbDefaultValue as V, DbEncryption as Vn, TWriteOptions as Vt, TDbForeignKey as W, FieldMappingStrategy as Wn, Uniquery$1 as Wt, TDbInsertIgnoreSlot as X, TRowOrderKey as Xn, TPathPresence as Xt, TDbInsertIgnoreResult as Y, TFirstLast as Yn, isGeoPointType as Yt, TDbInsertManyIgnoreResult as Z, UniquSelect as Zn, ALL_BUCKET_UNITS as Zt, DbPatch as _, TViewPlan as _n, TExistingColumn as _t, isJsonValueField as a, TViewColumnMapping as an, TDbStorageType as at, FieldOpsFor as b, translateQueryTree as bn, TFieldMeta as bt, resolveCalendarBuckets as c, TViewReadPlan as cn, TDbWriteAction as ct, AggregateFn$1 as d, AtscriptOrderItem as dn, TDbWriteGuard as dt, TViewCapability as en, TDbObjectKind as et, AggregateQuery$1 as f, AtscriptQueryComparison as fn, TDbWriteGuardContext as ft, DbControls as g, TViewJoin as gn, TEnsureTableOptions as gt, AtscriptDbWritable as h, AtscriptRef as hn, TDerivedColumn as ht, isBucketableField as i, AtscriptDbView as in, TDbRemoveGuardContext as it, TCrudOp as j, TRelGuardState as jn, TReferencingForeignKey as jt, TCascadeTarget as k, REL_FILTER_MAX_NODES as kn, TMetadataOverrides as kt, AggregateControls as l, aliasTargetOf as ln, TDbWriteCheck as lt, AtscriptDbTableLike as m, AtscriptQueryNode$1 as mn, TDerivedChangeReason as mt, TComputedSelect as n, TAdapterFactory as nn, TDbRelation as nt, jsonValueAncestor as o, isAtscriptDbView as on, TDbUpdateOptions as ot, AggregateResult as p, AtscriptQueryFieldRef$1 as pn, TDeleteOptions as pt, TDbIndexType as q, TGenericLogger as qn, TableMetadata as qt, TResolvedBucket as r, TDbSpaceOptions as rn, TDbRemoveGuard as rt, normalizeComputedSelect as s, isViewType as sn, TDbUpdateResult as st, TBucketFieldSource as t, DbSpace as tn, TDbReferentialAction as tt, AggregateExpr$1 as u, AtscriptExprNode$1 as un, TDbWriteCheckContext as ut, DbQuery as v, evaluateExpr as vn, TExistingForeignKey as vt, NullableOptional as w, TCascadePin as wn, TIdResolveOptions as wt, FilterExpr$1 as x, AtscriptDbTable as xn, TFkLookupResolver as xt, DbRow as y, isFieldRef as yn, TExistingTableOption as yt, TDbCollation as z, isResolvedRelationFilter as zn, TValueFormatterPair as zt };
+export { TDbInsertResult as $, ALL_VIEW_CAPABILITIES as $t, TColumnDiff as A, REL_FILTER_MAX_NODES as An, TPrimaryKeyChange as At, TDbDefaultFn as B, isResolvedRelationFilter as Bn, TValueFormatterPair as Bt, NavPropsOf$1 as C, IntegrityStrategy as Cn, TIdDescriptor as Ct, PrimaryKeyOf$1 as D, DbResponse as Dn, TJsonCopyTarget as Dt, OwnPropsOf$1 as E, AtscriptDbReadable as En, TInsertOptions as Et, TDbActionLevel as F, TRelationStaticFilter as Fn, TSyncColumnResult as Ft, TDbIndex as G, FieldMappingStrategy as Gn, Uniquery$1 as Gt, TDbDeleteResult as H, DbEncryption as Hn, TWriteOptions as Ht, TDbActionProcessor as I, andFilters as In, TSyncIndexesOptions as It, TDbInsertIgnoreOptions as J, TGenericLogger as Jn, TableMetadata as Jt, TDbIndexField as K, TReadControls as Kn, UniqueryControls$1 as Kt, TDbActionTargetSummary as L, containsRelationFilter as Ln, TTableOptionDiff as Lt, TCrudPermissions as M, TRelGuardState as Mn, TRelationInfo as Mt, TDbActionInfo as N, TRelationFilterJunction as Nn, TRowResolveOptions as Nt, TCascadeResolver as O, resolveDesignType as On, TMetaResponse as Ot, TDbActionIntent as P, TRelationFilterTable as Pn, TSearchIndexInfo as Pt, TDbInsertManyResult as Q, UniquSelect as Qn, ALL_BUCKET_UNITS as Qt, TDbAvailableActions as R, forEachResolvedRelation as Rn, TTableResolver as Rt, FlatOf$1 as S, AtscriptDbTable as Sn, TFkLookupTarget as St, NullsPlacement$1 as T, TCascadePin as Tn, TIdentification as Tt, TDbFieldMeta as U, TDbEncryptionOptions as Un, TWriteTableResolver as Ut, TDbDefaultValue as V, relationStaticFilter as Vn, TViewJsonType as Vt, TDbForeignKey as W, DocumentFieldMapper as Wn, TypedWithRelation as Wt, TDbInsertIgnoreSlot as X, TFirstLast as Xn, isGeoPointType as Xt, TDbInsertIgnoreResult as Y, TExprAggregate as Yn, isGeoIndexableType as Yt, TDbInsertManyIgnoreResult as Z, TRowOrderKey as Zn, TPathPresence as Zt, DbPatch as _, TViewJoin as _n, TExistingColumn as _t, isJsonValueField as a, AtscriptDbView as an, TDbStorageType as at, FieldOpsFor as b, isFieldRef as bn, TFieldMeta as bt, resolveCalendarBuckets as c, isViewType as cn, TDbWriteAction as ct, AggregateFn$1 as d, AtscriptExprNode$1 as dn, TDbWriteGuard as dt, BaseDbAdapter as en, TDbObjectKind as et, AggregateQuery$1 as f, AtscriptOrderItem as fn, TDbWriteGuardContext as ft, DbControls as g, AtscriptRef as gn, TEnsureTableOptions as gt, AtscriptDbWritable as h, AtscriptQueryNode$1 as hn, TDerivedColumn as ht, isBucketableField as i, TDbSpaceOptions as in, TDbRemoveGuardContext as it, TCrudOp as j, ResolvedRelationFilter as jn, TReferencingForeignKey as jt, TCascadeTarget as k, REL_FILTER_MAX_DEPTH as kn, TMetadataOverrides as kt, AggregateControls as l, TViewReadPlan as ln, TDbWriteCheck as lt, AtscriptDbTableLike as m, AtscriptQueryFieldRef$1 as mn, TDerivedChangeReason as mt, TComputedSelect as n, DbSpace as nn, TDbRelation as nt, jsonValueAncestor as o, TViewColumnMapping as on, TDbUpdateOptions as ot, AggregateResult as p, AtscriptQueryComparison as pn, TDeleteOptions as pt, TDbIndexType as q, NoopLogger as qn, WithRelation$1 as qt, TResolvedBucket as r, TAdapterFactory as rn, TDbRemoveGuard as rt, normalizeComputedSelect as s, isAtscriptDbView as sn, TDbUpdateResult as st, TBucketFieldSource as t, TViewCapability as tn, TDbReferentialAction as tt, AggregateExpr$1 as u, aliasTargetOf as un, TDbWriteCheckContext as ut, DbQuery as v, TViewPlan as vn, TExistingForeignKey as vt, NullableOptional as w, NativeIntegrity as wn, TIdResolveOptions as wt, FilterExpr$1 as x, translateQueryTree as xn, TFkLookupResolver as xt, DbRow as y, evaluateExpr as yn, TExistingTableOption as yt, TDbCollation as z, hasRelationOp as zn, TTouchManyOptions as zt };

package/dist/{buckets-DcWm3SLt.d.cts → buckets-B4T_alUe.d.cts}

@@ -1551,8 +1551,23 @@ declare class AtscriptDbTable<T extends TAtscriptAnnotatedType = TAtscriptAnnota
    * that object is present (an absent or `null` embedded object stays so), and
    * in every object of an array on the way; a field inside a JSON value or an
    * array has no column default, so the SDK fills its function default too.
-   */
-  protected _applyDefaults(data: Record<string, unknown>): Record<string, unknown>;
+   * Every `now` default the SDK fills gets the one time `now` (one per write
+   * call, so `createdAt` / `updatedAt` of a new row are equal).
+   */
+  protected _applyDefaults(data: Record<string, unknown>, now?: number): Record<string, unknown>;
+  /**
+   * `@db.onUpdate.now` (since 0.1.156): sets each such field of a replace /
+   * patch payload to `now`, overriding the caller's value. A nested field
+   * (`audit.updatedAt`) is set inside its object only when the payload
+   * carries that object — in every item of an array on the way and of the
+   * items an array patch operator adds or updates — like
+   * {@link _applyDefaults}. `topLevel: false` (a patch) instead drops the
+   * caller's values of the table's own columns: {@link _stampTopLevel} sets
+   * them once the patch is known to write something.
+   */
+  private _stampOnUpdate;
+  /** Sets the top-level `@db.onUpdate.now` columns of a non-empty patch to `now`. */
+  private _stampTopLevel;
   /** {@link _nestedDefaultFillable} per nested default path. */
   private _fillableDefaults?;
   /**
@@ -2788,9 +2803,12 @@ declare abstract class BaseDbAdapter {
   abstract deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
   /**
    * Synchronizes indexes between the Atscript definitions and the database.
-   * Uses `this._table.indexes` for the full index definitions.
+   * Uses `this._table.indexes` for the full index definitions. Schema sync
+   * passes `opts` when safe mode skipped work the indexes depend on (see
+   * {@link TSyncIndexesOptions}); an adapter whose indexes do not depend on it
+   * ignores them.
    */
-  abstract syncIndexes(): Promise<void>;
+  abstract syncIndexes(opts?: TSyncIndexesOptions): Promise<void>;
   /**
    * Ensures the table exists in the database, creating it if needed.
    * Uses `this._table.tableName`, `this._table.schema`, etc.
@@ -2922,8 +2940,9 @@ declare abstract class BaseDbAdapter {
    * given columns. Called by schema sync BEFORE {@link dropColumns} — engines
    * like SQLite refuse to drop a column while an index still references it,
    * and a composite index that survives by name must be rebuilt without the
-   * removed column (recreated later by {@link syncIndexes}).
-   * Optional — only relational adapters implement this.
+   * removed column (recreated later by {@link syncIndexes}). MongoDB drops
+   * them because a unique index would reject the `$unset` (`null` twice).
+   * Optional — the SQL adapters and MongoDB implement this.
    */
   dropIndexesForColumns?(columns: string[]): Promise<void>;
   /**
@@ -3115,6 +3134,12 @@ declare class TableMetadata {
   /** Adapter-contributed multi-field unique keys (logical paths) — see `TMetadataOverrides.addUniqueKeys`. */
   uniqueKeys: string[][];
   defaults: Map<string, TDbDefaultValue>;
+  /**
+   * Logical paths annotated with `@db.onUpdate.now` (`number.timestamp.updated`
+   * applies it): set to the current time by every update and replace.
+   * @since 0.1.156
+   */
+  onUpdateNow: Set<string>;
   /** Logical path → `@db.column` override (top-level keys only on document storage). */
   columnMap: Map<string, string>;
   dimensions: string[];
@@ -4183,6 +4208,23 @@ interface TEnsureTableOptions {
    */
   deferForeignKeysTo?: ReadonlySet<string>;
 }
+/**
+ * Options accepted by `BaseDbAdapter.syncIndexes` (since 0.1.156): indexes
+ * that stay as they are because safe mode skipped the change they depend on
+ * (`entry.skipped`) — it is pending, applied by the next run without `safe`.
+ */
+interface TSyncIndexesOptions {
+  /**
+   * The primary-key rebuild is skipped (`'pk-rebuild'`): an adapter whose
+   * key is an index (MongoDB's `__pk` unique index) keeps the live one.
+   */
+  keepPrimaryKey?: boolean;
+  /**
+   * Physical columns whose type change is skipped (`'recreate'`): indexes
+   * over them are neither dropped, replaced nor created.
+   */
+  keepColumns?: readonly string[];
+}
 /** Result of applying column diff to the database. */
 interface TSyncColumnResult {
   added: string[];
@@ -4683,4 +4725,4 @@ declare function isJsonValueField(fd: TDbFieldMeta): boolean;
  */
 declare function jsonValueAncestor(path: string, jsonValueParents: ReadonlySet<string>): string | undefined;
 //#endregion
-export { TDbInsertResult as $, BaseDbAdapter as $t, TColumnDiff as A, ResolvedRelationFilter as An, TPrimaryKeyChange as At, TDbDefaultFn as B, relationStaticFilter as Bn, TViewJsonType as Bt, NavPropsOf$1 as C, NativeIntegrity as Cn, TIdDescriptor as Ct, PrimaryKeyOf$1 as D, resolveDesignType as Dn, TJsonCopyTarget as Dt, OwnPropsOf$1 as E, DbResponse as En, TInsertOptions as Et, TDbActionLevel as F, andFilters as Fn, TSyncColumnResult as Ft, TDbIndex as G, TReadControls as Gn, UniqueryControls$1 as Gt, TDbDeleteResult as H, TDbEncryptionOptions as Hn, TWriteTableResolver as Ht, TDbActionProcessor as I, containsRelationFilter as In, TTableOptionDiff as It, TDbInsertIgnoreOptions as J, TExprAggregate as Jn, isGeoIndexableType as Jt, TDbIndexField as K, NoopLogger as Kn, WithRelation$1 as Kt, TDbActionTargetSummary as L, forEachResolvedRelation as Ln, TTableResolver as Lt, TCrudPermissions as M, TRelationFilterJunction as Mn, TRelationInfo as Mt, TDbActionInfo as N, TRelationFilterTable as Nn, TRowResolveOptions as Nt, TCascadeResolver as O, REL_FILTER_MAX_DEPTH as On, TMetaResponse as Ot, TDbActionIntent as P, TRelationStaticFilter as Pn, TSearchIndexInfo as Pt, TDbInsertManyResult as Q, ALL_VIEW_CAPABILITIES as Qt, TDbAvailableActions as R, hasRelationOp as Rn, TTouchManyOptions as Rt, FlatOf$1 as S, IntegrityStrategy as Sn, TFkLookupTarget as St, NullsPlacement$1 as T, AtscriptDbReadable as Tn, TIdentification as Tt, TDbFieldMeta as U, DocumentFieldMapper as Un, TypedWithRelation as Ut, TDbDefaultValue as V, DbEncryption as Vn, TWriteOptions as Vt, TDbForeignKey as W, FieldMappingStrategy as Wn, Uniquery$1 as Wt, TDbInsertIgnoreSlot as X, TRowOrderKey as Xn, TPathPresence as Xt, TDbInsertIgnoreResult as Y, TFirstLast as Yn, isGeoPointType as Yt, TDbInsertManyIgnoreResult as Z, UniquSelect as Zn, ALL_BUCKET_UNITS as Zt, DbPatch as _, TViewPlan as _n, TExistingColumn as _t, isJsonValueField as a, TViewColumnMapping as an, TDbStorageType as at, FieldOpsFor as b, translateQueryTree as bn, TFieldMeta as bt, resolveCalendarBuckets as c, TViewReadPlan as cn, TDbWriteAction as ct, AggregateFn$1 as d, AtscriptOrderItem as dn, TDbWriteGuard as dt, TViewCapability as en, TDbObjectKind as et, AggregateQuery$1 as f, AtscriptQueryComparison as fn, TDbWriteGuardContext as ft, DbControls as g, TViewJoin as gn, TEnsureTableOptions as gt, AtscriptDbWritable as h, AtscriptRef as hn, TDerivedColumn as ht, isBucketableField as i, AtscriptDbView as in, TDbRemoveGuardContext as it, TCrudOp as j, TRelGuardState as jn, TReferencingForeignKey as jt, TCascadeTarget as k, REL_FILTER_MAX_NODES as kn, TMetadataOverrides as kt, AggregateControls as l, aliasTargetOf as ln, TDbWriteCheck as lt, AtscriptDbTableLike as m, AtscriptQueryNode$1 as mn, TDerivedChangeReason as mt, TComputedSelect as n, TAdapterFactory as nn, TDbRelation as nt, jsonValueAncestor as o, isAtscriptDbView as on, TDbUpdateOptions as ot, AggregateResult as p, AtscriptQueryFieldRef$1 as pn, TDeleteOptions as pt, TDbIndexType as q, TGenericLogger as qn, TableMetadata as qt, TResolvedBucket as r, TDbSpaceOptions as rn, TDbRemoveGuard as rt, normalizeComputedSelect as s, isViewType as sn, TDbUpdateResult as st, TBucketFieldSource as t, DbSpace as tn, TDbReferentialAction as tt, AggregateExpr$1 as u, AtscriptExprNode$1 as un, TDbWriteCheckContext as ut, DbQuery as v, evaluateExpr as vn, TExistingForeignKey as vt, NullableOptional as w, TCascadePin as wn, TIdResolveOptions as wt, FilterExpr$1 as x, AtscriptDbTable as xn, TFkLookupResolver as xt, DbRow as y, isFieldRef as yn, TExistingTableOption as yt, TDbCollation as z, isResolvedRelationFilter as zn, TValueFormatterPair as zt };
+export { TDbInsertResult as $, ALL_VIEW_CAPABILITIES as $t, TColumnDiff as A, REL_FILTER_MAX_NODES as An, TPrimaryKeyChange as At, TDbDefaultFn as B, isResolvedRelationFilter as Bn, TValueFormatterPair as Bt, NavPropsOf$1 as C, IntegrityStrategy as Cn, TIdDescriptor as Ct, PrimaryKeyOf$1 as D, DbResponse as Dn, TJsonCopyTarget as Dt, OwnPropsOf$1 as E, AtscriptDbReadable as En, TInsertOptions as Et, TDbActionLevel as F, TRelationStaticFilter as Fn, TSyncColumnResult as Ft, TDbIndex as G, FieldMappingStrategy as Gn, Uniquery$1 as Gt, TDbDeleteResult as H, DbEncryption as Hn, TWriteOptions as Ht, TDbActionProcessor as I, andFilters as In, TSyncIndexesOptions as It, TDbInsertIgnoreOptions as J, TGenericLogger as Jn, TableMetadata as Jt, TDbIndexField as K, TReadControls as Kn, UniqueryControls$1 as Kt, TDbActionTargetSummary as L, containsRelationFilter as Ln, TTableOptionDiff as Lt, TCrudPermissions as M, TRelGuardState as Mn, TRelationInfo as Mt, TDbActionInfo as N, TRelationFilterJunction as Nn, TRowResolveOptions as Nt, TCascadeResolver as O, resolveDesignType as On, TMetaResponse as Ot, TDbActionIntent as P, TRelationFilterTable as Pn, TSearchIndexInfo as Pt, TDbInsertManyResult as Q, UniquSelect as Qn, ALL_BUCKET_UNITS as Qt, TDbAvailableActions as R, forEachResolvedRelation as Rn, TTableResolver as Rt, FlatOf$1 as S, AtscriptDbTable as Sn, TFkLookupTarget as St, NullsPlacement$1 as T, TCascadePin as Tn, TIdentification as Tt, TDbFieldMeta as U, TDbEncryptionOptions as Un, TWriteTableResolver as Ut, TDbDefaultValue as V, relationStaticFilter as Vn, TViewJsonType as Vt, TDbForeignKey as W, DocumentFieldMapper as Wn, TypedWithRelation as Wt, TDbInsertIgnoreSlot as X, TFirstLast as Xn, isGeoPointType as Xt, TDbInsertIgnoreResult as Y, TExprAggregate as Yn, isGeoIndexableType as Yt, TDbInsertManyIgnoreResult as Z, TRowOrderKey as Zn, TPathPresence as Zt, DbPatch as _, TViewJoin as _n, TExistingColumn as _t, isJsonValueField as a, AtscriptDbView as an, TDbStorageType as at, FieldOpsFor as b, isFieldRef as bn, TFieldMeta as bt, resolveCalendarBuckets as c, isViewType as cn, TDbWriteAction as ct, AggregateFn$1 as d, AtscriptExprNode$1 as dn, TDbWriteGuard as dt, BaseDbAdapter as en, TDbObjectKind as et, AggregateQuery$1 as f, AtscriptOrderItem as fn, TDbWriteGuardContext as ft, DbControls as g, AtscriptRef as gn, TEnsureTableOptions as gt, AtscriptDbWritable as h, AtscriptQueryNode$1 as hn, TDerivedColumn as ht, isBucketableField as i, TDbSpaceOptions as in, TDbRemoveGuardContext as it, TCrudOp as j, ResolvedRelationFilter as jn, TReferencingForeignKey as jt, TCascadeTarget as k, REL_FILTER_MAX_DEPTH as kn, TMetadataOverrides as kt, AggregateControls as l, TViewReadPlan as ln, TDbWriteCheck as lt, AtscriptDbTableLike as m, AtscriptQueryFieldRef$1 as mn, TDerivedChangeReason as mt, TComputedSelect as n, DbSpace as nn, TDbRelation as nt, jsonValueAncestor as o, TViewColumnMapping as on, TDbUpdateOptions as ot, AggregateResult as p, AtscriptQueryComparison as pn, TDeleteOptions as pt, TDbIndexType as q, NoopLogger as qn, WithRelation$1 as qt, TResolvedBucket as r, TAdapterFactory as rn, TDbRemoveGuard as rt, normalizeComputedSelect as s, isAtscriptDbView as sn, TDbUpdateResult as st, TBucketFieldSource as t, TViewCapability as tn, TDbReferentialAction as tt, AggregateExpr$1 as u, aliasTargetOf as un, TDbWriteCheckContext as ut, DbQuery as v, TViewPlan as vn, TExistingForeignKey as vt, NullableOptional as w, NativeIntegrity as wn, TIdResolveOptions as wt, FilterExpr$1 as x, translateQueryTree as xn, TFkLookupResolver as xt, DbRow as y, evaluateExpr as yn, TExistingTableOption as yt, TDbCollation as z, hasRelationOp as zn, TTouchManyOptions as zt };

package/dist/{column-diff-C68V_eYM.mjs → column-diff-DR1glykD.mjs}

@@ -1,8 +1,8 @@
 import { a as aggregateExpressionsNotSupported, n as CasMismatchError, r as DbError, u as spaceClosedError } from "./db-error-eSsQX7rt.mjs";
 import { a as SOURCE_VALUE_FNS, c as isFirstLast, o as SUPPORTED_AGGREGATE_FNS, r as BASE_AGGREGATE_FNS, t as AGG_ANNOTATIONS } from "./aggregate-fns-B_sgl4mB.mjs";
 import { A as hasRelationOp, D as containsRelationFilter, F as resolveRelationFilterTree, H as tableNameOf, I as compositeKey, J as viewExprNullable, K as isFieldRef, L as findFKEntryForRelation, M as noteRelationFilter, N as relGuardState, O as createRelationFilterHost, R as findFKForRelation, S as uniqueKeyTuple, U as computeOf, V as slicePerGroup, W as computedOperands, Y as walkViewExpr, _ as remapDeleteFkViolation, a as batchPatchNestedFrom, b as rowMatchesKey, c as batchReplaceNestedFrom, d as checkDepthOverflow, f as planNestedFromVia, g as enrichFkViolation, h as validateBatch, i as batchInsertNestedVia, l as batchReplaceNestedTo, m as preValidateNestedFrom, n as batchInsertNestedFrom, p as planPatchNestedTo, r as batchInsertNestedTo, s as batchPatchNestedVia, t as applyPatchNestedTo, u as batchReplaceNestedVia, v as findRowsByKeys, x as sameKey, y as pkTupleKey, z as findRemoteFK } from "./nested-writer-BOj_c_lI.mjs";
-import { a as forceNavNonOptional, c as getKeyProps, d as soleUnionMember, f as unionValueMembers, i as dbPlugin, l as columnUnionBase, n as buildPatchPartial, t as buildDbValidator, u as pathPresence } from "./validator-BC3nwFi4.mjs";
-import { a as DERIVED_INCOMPATIBLE, n as searchMemberKind, r as numericTypeProblem, s as isJsonLeafType } from "./search-fields-DBIZKwyb.mjs";
+import { a as forceNavNonOptional, c as getKeyProps, d as soleUnionMember, f as unionValueMembers, i as dbPlugin, l as columnUnionBase, n as buildPatchPartial, t as buildDbValidator, u as pathPresence } from "./validator-B3fPJjS1.mjs";
+import { a as DERIVED_INCOMPATIBLE, n as searchMemberKind, r as numericTypeProblem, s as isJsonLeafType } from "./search-fields-CE8cmj9X.mjs";
 import { a as isPlainObject, i as isEmptyObject, n as findAncestorInSet, o as selfOrAncestor, r as getPath, t as deletePath } from "./object-TkiJQ-Dp.mjs";
 import { resolveAlias as resolveAlias$1 } from "./agg.mjs";
 import { t as NOT_DIMENSION_REASON } from "./aggregate-rules-jdPrxqWa.mjs";
@@ -503,6 +503,12 @@ var TableMetadata = class {
 	/** Adapter-contributed multi-field unique keys (logical paths) — see `TMetadataOverrides.addUniqueKeys`. */
 	uniqueKeys = [];
 	defaults = /* @__PURE__ */ new Map();
+	/**
+	* Logical paths annotated with `@db.onUpdate.now` (`number.timestamp.updated`
+	* applies it): set to the current time by every update and replace.
+	* @since 0.1.156
+	*/
+	onUpdateNow = /* @__PURE__ */ new Set();
 	/** Logical path → `@db.column` override (top-level keys only on document storage). */
 	columnMap = /* @__PURE__ */ new Map();
 	dimensions = [];
@@ -827,6 +833,7 @@ var TableMetadata = class {
 		if (columnFrom && renamable) this._columnFromMap.set(fieldName, columnFrom);
 		const resolvedDefault = resolveDefaultFromMetadata(metadata);
 		if (resolvedDefault) this.defaults.set(fieldName, resolvedDefault);
+		if (metadata.has("db.onUpdate.now")) this.onUpdateNow.add(fieldName);
 		if (metadata.has("db.ignore")) this.ignoredFields.add(fieldName);
 		if (isNavRelation(metadata)) {
 			this.navFields.add(fieldName);
@@ -996,6 +1003,7 @@ var TableMetadata = class {
 		if (metadata.has("db.search.vector") || metadata.has("db.search.filter")) reject("@db.search.*", "search over ciphertext is impossible");
 		if (metadata.has("db.mongo.search.text") || metadata.has("db.mongo.search.autocomplete")) reject("@db.mongo.search.*", "Atlas Search over ciphertext is impossible");
 		if (metadata.has("db.column.version")) reject("@db.column.version", "the OCC filter needs cleartext equality");
+		if (metadata.has("db.onUpdate.now")) reject("@db.onUpdate.now", "the update time is set after the encryption transform");
 		if (metadata.has("db.default.increment") || metadata.has("db.default.now")) reject("@db.default.increment / @db.default.now", "engine-side defaults bypass the encryption transform");
 		if (metadata.get("db.patch.strategy") === "merge") reject("@db.patch.strategy \"merge\"", "ciphertext is opaque — partial merges would silently drop omitted keys");
 	}
@@ -6809,10 +6817,11 @@ function assertNoVersionWrites(data, versionColumn) {
 * Whether a logical (pre-decomposition) patch writes ONLY version-exempt
 * fields (`@db.column.version.exempt`). `data` has nav fields, filter keys and
 * derived fields removed and `$cas` separated. Mirrors `flattenPatchPayload`
-* (keep the two side by side): PK keys are skipped; an exempt path (or one
-* under an exempt ancestor) is covered whatever its value (scalar, field op,
-* array ops, object); a non-exempt merge-strategy object recurses (only the
-* supplied children are written); anything else is a non-exempt write.
+* (keep the two side by side): PK keys and `@db.onUpdate.now` fields are
+* skipped; an exempt path (or one under an exempt ancestor) is covered
+* whatever its value (scalar, field op, array ops, object); a non-exempt
+* merge-strategy object recurses (only the supplied children are written);
+* anything else is a non-exempt write.
 * True iff at least one key is covered and none is not.
 * @since 0.1.150
 */
@@ -6821,11 +6830,12 @@ function isVersionExemptPatch(data, table) {
 	if (meta.versionExemptPaths.size === 0) return false;
 	const primaryKeys = meta.primaryKeys;
 	const flatMap = meta.flatMap;
+	const stamps = meta.onUpdateNow;
 	const walk = (obj, prefix) => {
 		let result = "none";
 		for (const [k, value] of Object.entries(obj)) {
 			const key = prefix ? `${prefix}.${k}` : k;
-			if (primaryKeys.includes(key)) continue;
+			if (primaryKeys.includes(key) || stamps.has(key)) continue;
 			if (meta.isVersionExemptPath(key)) {
 				result = "exempt";
 				continue;
@@ -7138,7 +7148,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		const singleStatement = !ignore && this._isSingleStatementWrite(payloads, depth, guard, check);
 		return enrichFkViolation(this._meta, () => this._inWriteTransaction(singleStatement, async () => {
 			const clone = depth === 0 ? _cloneWritePayload : _shallowPrunedClone;
-			let items = payloads.map((p) => this._applyDefaults(clone(p)));
+			const now = Date.now();
+			let items = payloads.map((p) => this._applyDefaults(clone(p), now));
 			if (ignore) this._linkToByKeyInIgnoreMode(items);
 			let originals = canNest ? items.map((item) => ({ ...item })) : [];
 			const validator = this.getValidator("insert");
@@ -7214,10 +7225,12 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			const versionColumn = this.versionColumn;
 			const expectedVersions = Array.from({ length: payloads.length });
 			const clone = depth === 0 ? _cloneWritePayload : _shallowPrunedClone;
+			const now = Date.now();
 			const items = payloads.map((p, i) => {
 				const c = clone(p);
 				expectedVersions[i] = separateCas(c, versionColumn);
-				return this._applyDefaults(c);
+				this._stampOnUpdate(c, now, true);
+				return this._applyDefaults(c, now);
 			});
 			const originals = canNest ? items.map((item) => ({ ...item })) : [];
 			const validator = this.getValidator("bulkReplace");
@@ -7301,9 +7314,11 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			const versionColumn = this.versionColumn;
 			const expectedVersions = Array.from({ length: payloads.length });
 			const clone = depth === 0 ? _cloneWritePayload : _shallowPrunedClone;
+			const now = Date.now();
 			const cloned = payloads.map((p, i) => {
 				const c = clone(p);
 				expectedVersions[i] = separateCas(c, versionColumn);
+				this._stampOnUpdate(c, now, false);
 				return c;
 			});
 			const validator = this.getValidator("bulkUpdate");
@@ -7350,6 +7365,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 					continue;
 				}
 				const updateOpts = expectedVersion === void 0 && versionColumn !== void 0 && isVersionExemptPatch(data, this) ? [KEEP_VERSION] : [];
+				this._stampTopLevel(data, now);
 				let result;
 				if (this.adapter.supportsNativePatch()) {
 					const ops = separateFieldOps(data);
@@ -7509,6 +7525,8 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver, true);
 		const dataCopy = _cloneWritePayload(data);
 		this._meta.stripDerived(dataCopy);
+		const now = Date.now();
+		this._stampOnUpdate(dataCopy, now, false);
 		const versionColumn = this.versionColumn;
 		if ("$cas" in dataCopy) throw new DbError("INVALID_QUERY", [{
 			path: "$cas",
@@ -7516,6 +7534,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		}]);
 		if (versionColumn !== void 0) assertNoVersionWrites(dataCopy, versionColumn);
 		const updateOpts = versionColumn !== void 0 && isVersionExemptPatch(dataCopy, this) ? [KEEP_VERSION] : [];
+		this._stampTopLevel(dataCopy, now);
 		await this._encryptItems([dataCopy], "patch");
 		const update = decomposePatch(dataCopy, this);
 		const ops = separateFieldOps(update);
@@ -7536,6 +7555,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		this._guardMutationFilter(filter);
 		await this._integrity.validateForeignKeys([data], this._meta, this._fkLookupResolver, this._writeTableResolver);
 		const dataCopy = _cloneWritePayload(data);
+		this._stampOnUpdate(dataCopy, Date.now(), true);
 		await this._encryptItems([dataCopy], "write");
 		return enrichFkViolation(this._meta, () => this.adapter.replaceMany(this._fieldMapper.translateFilter(filter, this._meta), this._fieldMapper.prepareForWrite(dataCopy, this._meta, this.adapter)));
 	}
@@ -7910,8 +7930,10 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	* that object is present (an absent or `null` embedded object stays so), and
 	* in every object of an array on the way; a field inside a JSON value or an
 	* array has no column default, so the SDK fills its function default too.
+	* Every `now` default the SDK fills gets the one time `now` (one per write
+	* call, so `createdAt` / `updatedAt` of a new row are equal).
 	*/
-	_applyDefaults(data) {
+	_applyDefaults(data, now = Date.now()) {
 		const nativeFns = this.adapter.nativeDefaultFns();
 		const versionField = this._meta.versionField;
 		for (const [field, def] of this._meta.defaults.entries()) {
@@ -7919,7 +7941,7 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 			let make;
 			if (def.kind === "value") make = () => this._valueDefault(field, def.value);
 			else if (def.kind === "fn" && (!nativeFns.has(def.fn) || findAncestorInSet(field, this._meta.jsonParents) !== void 0)) {
-				if (def.fn === "now") make = Date.now;
+				if (def.fn === "now") make = () => now;
 				else if (def.fn === "uuid") make = () => crypto.randomUUID();
 			}
 			if (!make) continue;
@@ -7929,6 +7951,26 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 		}
 		return data;
 	}
+	/**
+	* `@db.onUpdate.now` (since 0.1.156): sets each such field of a replace /
+	* patch payload to `now`, overriding the caller's value. A nested field
+	* (`audit.updatedAt`) is set inside its object only when the payload
+	* carries that object — in every item of an array on the way and of the
+	* items an array patch operator adds or updates — like
+	* {@link _applyDefaults}. `topLevel: false` (a patch) instead drops the
+	* caller's values of the table's own columns: {@link _stampTopLevel} sets
+	* them once the patch is known to write something.
+	*/
+	_stampOnUpdate(data, now, topLevel) {
+		for (const field of this._meta.onUpdateNow) if (!field.includes(".")) if (topLevel) data[field] = now;
+		else delete data[field];
+		else if (this._nestedDefaultFillable(field)) stampNested(data, field.split("."), 0, now);
+	}
+	/** Sets the top-level `@db.onUpdate.now` columns of a non-empty patch to `now`. */
+	_stampTopLevel(data, now) {
+		if (isEmptyObject(data)) return;
+		for (const field of this._meta.onUpdateNow) if (!field.includes(".")) data[field] = now;
+	}
 	/** {@link _nestedDefaultFillable} per nested default path. */
 	_fillableDefaults;
 	/**
@@ -8122,6 +8164,27 @@ var AtscriptDbTable = class extends AtscriptDbReadable {
 	}
 };
 /**
+* Sets `segs` below `value` to `now` (see `_stampOnUpdate`), through
+* arrays and the item lists of array patch operators (`$insert`, `$upsert`,
+* `$replace`, `$update` — not `$remove`).
+*/
+function stampNested(value, segs, i, now) {
+	if (Array.isArray(value)) {
+		for (const item of value) stampNested(item, segs, i, now);
+		return;
+	}
+	if (!isPlainObject(value)) return;
+	const key = segs[i];
+	if (i === segs.length - 1) {
+		value[key] = now;
+		return;
+	}
+	const next = value[key];
+	if (isPlainObject(next) && Object.keys(next).some((k) => k.startsWith("$"))) {
+		for (const [op, items] of Object.entries(next)) if (op !== "$remove") stampNested(items, segs, i + 1, now);
+	} else stampNested(next, segs, i + 1, now);
+}
+/**
 * Sets `segs[i..]` to `make()` where it is `undefined`, inside present plain
 * objects only — fanned out over the objects of every array on the way.
 */