@atscript/db 0.1.148 → 0.1.150

package/dist/agg.d.cts

@@ -1,3 +1,3 @@
-import { r as TResolvedBucket } from "./buckets-DJiYlMXc.cjs";
+import { r as TResolvedBucket } from "./buckets-24Ac4sIS.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-CNdTOnei.mjs";
+import { r as TResolvedBucket } from "./buckets-XOz0Bw5x.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-DJiYlMXc.d.cts → buckets-24Ac4sIS.d.cts}

@@ -744,6 +744,14 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
    * @internal Adapter-facing surface; not part of the consumer API.
    */
   get versionColumnPhysical(): string | undefined;
+  /**
+   * Logical paths of the `@db.column.version.exempt` fields, including objects
+   * whose direct children are all exempt. A patch that writes only these (and
+   * no `$cas`) does not bump the version column. Empty when the table has no
+   * `@db.column.version`.
+   * @since 0.1.150
+   */
+  get versionExemptFields(): ReadonlySet<string>;
   /** Dimension fields from `@db.column.dimension`. */
   get dimensions(): readonly string[];
   /** Measure fields from `@db.column.measure`. */
@@ -2044,6 +2052,13 @@ declare abstract class BaseDbAdapter {
    * When disabled, no log strings are constructed — zero overhead.
    */
   setVerbose(enabled: boolean): void;
+  /**
+   * Physical version column an UPDATE must bump, or `undefined` when it must
+   * not: no `@db.column.version`, or a version-exempt patch
+   * (`opts.keepVersion`, since 0.1.150 — the core never combines it with
+   * `expectedVersion`; a violation throws).
+   */
+  protected _versionColumnFor(opts?: TDbUpdateOptions, expectedVersion?: number): string | undefined;
   /**
    * Logs a debug message if verbose mode is enabled.
    * Adapters call this to log DB operations with zero overhead when disabled.
@@ -2309,9 +2324,10 @@ declare abstract class BaseDbAdapter {
    *
    * @param filter - Filter identifying the record to patch.
    * @param patch - The patch payload with array operations.
+   * @param opts - `keepVersion`: skip the version bump (see {@link TDbUpdateOptions}).
    * @returns Update result.
    */
-  nativePatch(_filter: FilterExpr, _patch: unknown, _ops?: TFieldOps, _expectedVersion?: number): Promise<TDbUpdateResult>;
+  nativePatch(_filter: FilterExpr, _patch: unknown, _ops?: TFieldOps, _expectedVersion?: number, _opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   /**
    * Called before field flattening begins.
    * Use to extract table-level adapter-specific annotations.
@@ -2416,6 +2432,13 @@ declare abstract class BaseDbAdapter {
   /**
    * Returns available search indexes for this adapter.
    * UI uses this to show index picker. Override in adapters that support search.
+   *
+   * A fulltext index may carry integer members ({@link TDbIndexField.integer},
+   * since 0.1.150): list them in `fields`, keep them out of the physical text
+   * index, and OR `member = n` into the search predicate when
+   * `searchTermInteger(text)` is defined. An index of integer members only
+   * is still listed (it makes the table natively searchable); a term that is
+   * not a whole number then matches nothing.
    */
   getSearchIndexes(): TSearchIndexInfo[];
   private _physicalToLogical?;
@@ -2444,7 +2467,9 @@ declare abstract class BaseDbAdapter {
    */
   isVectorSearchable(): boolean;
   /**
-   * Full-text search. Override in adapters that support search.
+   * Full-text search. Override in adapters that support search. The text
+   * match is OR'd with exact-number equality on the index's integer members
+   * when the whole term is a whole number (see `searchTermInteger`).
    *
    * @param text - Search text.
    * @param query - Filter, sort, limit, etc.
@@ -2563,12 +2588,17 @@ declare abstract class BaseDbAdapter {
   /** Whether {@link insertManyIgnore} is implemented (drives `crud.insert: ["onConflict"]` in `/meta`). @since 0.1.148 */
   supportsInsertIgnore(): boolean;
   abstract replaceOne(filter: FilterExpr, data: Record<string, unknown>, expectedVersion?: number): Promise<TDbUpdateResult>;
-  abstract updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number): Promise<TDbUpdateResult>;
+  /**
+   * `opts.keepVersion` — skip the version bump (and never combine with
+   * `expectedVersion`); see {@link TDbUpdateOptions}.
+   */
+  abstract updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   abstract deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
   abstract findOne(query: DbQuery): Promise<Record<string, unknown> | null>;
   abstract findMany(query: DbQuery): Promise<Array<Record<string, unknown>>>;
   abstract count(query: DbQuery): Promise<number>;
-  abstract updateMany(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps): Promise<TDbUpdateResult>;
+  /** `opts.keepVersion` — skip the version bump; see {@link TDbUpdateOptions}. */
+  abstract updateMany(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   abstract replaceMany(filter: FilterExpr, data: Record<string, unknown>): Promise<TDbUpdateResult>;
   abstract deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
   /**
@@ -2862,6 +2892,15 @@ declare class TableMetadata {
   measures: string[];
   /** Logical field name annotated with `@db.column.version`, if any. */
   versionField?: string;
+  /** Paths annotated with `@db.column.version.exempt`, as declared (since 0.1.150). */
+  private _versionExemptDeclared;
+  /**
+   * Version-exempt paths (since 0.1.150): the declared ones plus every object
+   * whose direct children are all exempt (upward closure). A path is exempt
+   * when it, or an ancestor, is in this set — see {@link isVersionExemptPath}.
+   * Empty when the table declares no `@db.column.version`.
+   */
+  versionExemptPaths: ReadonlySet<string>;
   /** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
   quantityRefByField: Map<string, string>;
   /** Logical paths annotated with `@db.encrypted` — stored as one opaque ciphertext column. */
@@ -2977,6 +3016,16 @@ declare class TableMetadata {
    * Scans `@db.*` and `@meta.id` annotations on a field during flattening.
    */
   private _scanGenericAnnotations;
+  /**
+   * Validates the `@db.column.version.exempt` placements (E1–E5, the runtime
+   * mirror of the compile-time check, so pre-compiled models fail fast) and
+   * computes {@link versionExemptPaths} with its upward closure. Runs after
+   * `_applyOverrides` (the primary keys are final) and before `jsonFields` is
+   * released. A table without a version column ignores the annotation.
+   */
+  private _finalizeVersionExempt;
+  /** Whether `path` — or an ancestor of it — is version-exempt (since 0.1.150). */
+  isVersionExemptPath(path: string): boolean;
   /**
    * Build-time diagnostics for `@db.encrypted` (§6 of the field-encryption
    * spec). Mirrors the compile-time AnnotationSpec validation so models built
@@ -3030,6 +3079,13 @@ declare class TableMetadata {
    * Resolves `fkTargetField` for FK fields in field descriptors.
    */
   private _resolveFkTargetFields;
+  /**
+   * Flags the integer members of fulltext indexes (matched by exact number,
+   * never part of the physical text index) and enforces that each is
+   * index-backed — the equality branch must not scan. Runs while index field
+   * names are still logical.
+   */
+  private _resolveIntegerFulltextMembers;
   private _finalizeIndexes;
   /**
    * Captures legitimate row-identifier shapes from the metadata: primary key
@@ -3446,6 +3502,18 @@ interface TDbUpdateResult {
   matchedCount: number;
   modifiedCount: number;
 }
+/**
+ * Per-call options of an adapter UPDATE (since 0.1.150).
+ */
+interface TDbUpdateOptions {
+  /**
+   * The patch writes only `@db.column.version.exempt` fields: leave the
+   * version column untouched (no `+1`). The core sets it only for CAS-free
+   * patches — never together with `expectedVersion`. An adapter that ignores
+   * the option keeps bumping (the pre-0.1.150 behaviour).
+   */
+  keepVersion?: boolean;
+}
 interface TDbDeleteResult {
   deletedCount: number;
 }
@@ -3469,6 +3537,13 @@ interface TDbIndexField {
    * re-resolving the field type. Undefined when the field cannot be resolved.
    */
   designType?: string;
+  /**
+   * Fulltext member matched by exact whole-number equality, never part of the
+   * physical text index (integer field; since 0.1.150). Adapters exclude it
+   * from text DDL and OR `member = n` into their search predicate when the
+   * search term is a whole number (see `searchTermInteger`).
+   */
+  integer?: boolean;
 }
 interface TDbIndex {
   /** Unique key used for identity/diffing (e.g., "atscript__plain__email") */
@@ -4263,4 +4338,4 @@ declare function isJsonValueField(fd: TDbFieldMeta): boolean;
  */
 declare function jsonValueAncestor(path: string, jsonValueParents: ReadonlySet<string>): string | undefined;
 //#endregion
-export { TDbReferentialAction as $, AtscriptDbView as $t, TCrudOp as A, containsRelationFilter as An, TSearchIndexInfo as At, TDbDefaultValue as B, NoopLogger as Bn, Uniquery$1 as Bt, NavPropsOf$1 as C, REL_FILTER_MAX_NODES as Cn, TInsertOptions as Ct, TCascadeResolver as D, TRelationFilterTable as Dn, TReferencingForeignKey as Dt, PrimaryKeyOf$1 as E, TRelationFilterJunction as En, TPrimaryKeyChange as Et, TDbActionProcessor as F, DbEncryption as Fn, TValueFormatterPair as Ft, TDbIndexField as G, UniquSelect as Gn, isGeoPointType as Gt, TDbFieldMeta as H, TExprAggregate as Hn, WithRelation$1 as Ht, TDbActionTargetSummary as I, TDbEncryptionOptions as In, TViewJsonType as It, TDbInsertIgnoreSlot as J, BaseDbAdapter as Jt, TDbIndexType as K, ALL_BUCKET_UNITS as Kt, TDbAvailableActions as L, DocumentFieldMapper as Ln, TWriteOptions as Lt, TDbActionInfo as M, hasRelationOp as Mn, TTableOptionDiff as Mt, TDbActionIntent as N, isResolvedRelationFilter as Nn, TTableResolver as Nt, TCascadeTarget as O, TRelationStaticFilter as On, TRelationInfo as Ot, TDbActionLevel as P, relationStaticFilter as Pn, TTouchManyOptions as Pt, TDbObjectKind as Q, TDbSpaceOptions as Qt, TDbCollation as R, FieldMappingStrategy as Rn, TWriteTableResolver as Rt, FlatOf$1 as S, REL_FILTER_MAX_DEPTH as Sn, TIdentification as St, OwnPropsOf$1 as T, TRelGuardState as Tn, TMetadataOverrides as Tt, TDbForeignKey as U, TFirstLast as Un, TableMetadata as Ut, TDbDeleteResult as V, TGenericLogger as Vn, UniqueryControls$1 as Vt, TDbIndex as W, TRowOrderKey as Wn, isGeoIndexableType as Wt, TDbInsertManyResult as X, DbSpace as Xt, TDbInsertManyIgnoreResult as Y, TViewCapability as Yt, TDbInsertResult as Z, TAdapterFactory as Zt, DbPatch as _, NativeIntegrity as _n, TFieldMeta as _t, isJsonValueField as a, AtscriptOrderItem as an, TDbWriteAction as at, FieldOpsFor as b, DbResponse as bn, TIdDescriptor as bt, resolveCalendarBuckets as c, AtscriptQueryNode$1 as cn, TDbWriteGuard as ct, AggregateFn$1 as d, TViewPlan as dn, TDerivedChangeReason as dt, TViewColumnMapping as en, TDbRelation as et, AggregateQuery$1 as f, evaluateExpr as fn, TDerivedColumn as ft, DbControls as g, IntegrityStrategy as gn, TExistingTableOption as gt, AtscriptDbWritable as h, AtscriptDbTable as hn, TExistingForeignKey as ht, isBucketableField as i, AtscriptExprNode$1 as in, TDbUpdateResult as it, TCrudPermissions as j, forEachResolvedRelation as jn, TSyncColumnResult as jt, TColumnDiff as k, andFilters as kn, TRowResolveOptions as kt, AggregateControls as l, AtscriptRef as ln, TDbWriteGuardContext as lt, AtscriptDbTableLike as m, translateQueryTree as mn, TExistingColumn as mt, TComputedSelect as n, isViewType as nn, TDbRemoveGuardContext as nt, jsonValueAncestor as o, AtscriptQueryComparison as on, TDbWriteCheck as ot, AggregateResult as p, isFieldRef as pn, TEnsureTableOptions as pt, TDbInsertIgnoreResult as q, ALL_VIEW_CAPABILITIES as qt, TResolvedBucket as r, aliasTargetOf as rn, TDbStorageType as rt, normalizeComputedSelect as s, AtscriptQueryFieldRef$1 as sn, TDbWriteCheckContext as st, TBucketFieldSource as t, isAtscriptDbView as tn, TDbRemoveGuard as tt, AggregateExpr$1 as u, TViewJoin as un, TDeleteOptions as ut, DbQuery as v, TCascadePin as vn, TFkLookupResolver as vt, NullableOptional as w, ResolvedRelationFilter as wn, TMetaResponse as wt, FilterExpr$1 as x, resolveDesignType as xn, TIdResolveOptions as xt, DbRow as y, AtscriptDbReadable as yn, TFkLookupTarget as yt, TDbDefaultFn as z, TReadControls as zn, TypedWithRelation as zt };
+export { TDbReferentialAction as $, TDbSpaceOptions as $t, TCrudOp as A, andFilters as An, TRowResolveOptions as At, TDbDefaultValue as B, TReadControls as Bn, TypedWithRelation as Bt, NavPropsOf$1 as C, REL_FILTER_MAX_DEPTH as Cn, TIdentification as Ct, TCascadeResolver as D, TRelationFilterJunction as Dn, TPrimaryKeyChange as Dt, PrimaryKeyOf$1 as E, TRelGuardState as En, TMetadataOverrides as Et, TDbActionProcessor as F, relationStaticFilter as Fn, TTouchManyOptions as Ft, TDbIndexField as G, TRowOrderKey as Gn, isGeoIndexableType as Gt, TDbFieldMeta as H, TGenericLogger as Hn, UniqueryControls$1 as Ht, TDbActionTargetSummary as I, DbEncryption as In, TValueFormatterPair as It, TDbInsertIgnoreSlot as J, ALL_VIEW_CAPABILITIES as Jt, TDbIndexType as K, UniquSelect as Kn, isGeoPointType as Kt, TDbAvailableActions as L, TDbEncryptionOptions as Ln, TViewJsonType as Lt, TDbActionInfo as M, forEachResolvedRelation as Mn, TSyncColumnResult as Mt, TDbActionIntent as N, hasRelationOp as Nn, TTableOptionDiff as Nt, TCascadeTarget as O, TRelationFilterTable as On, TReferencingForeignKey as Ot, TDbActionLevel as P, isResolvedRelationFilter as Pn, TTableResolver as Pt, TDbObjectKind as Q, TAdapterFactory as Qt, TDbCollation as R, DocumentFieldMapper as Rn, TWriteOptions as Rt, FlatOf$1 as S, resolveDesignType as Sn, TIdResolveOptions as St, OwnPropsOf$1 as T, ResolvedRelationFilter as Tn, TMetaResponse as Tt, TDbForeignKey as U, TExprAggregate as Un, WithRelation$1 as Ut, TDbDeleteResult as V, NoopLogger as Vn, Uniquery$1 as Vt, TDbIndex as W, TFirstLast as Wn, TableMetadata as Wt, TDbInsertManyResult as X, TViewCapability as Xt, TDbInsertManyIgnoreResult as Y, BaseDbAdapter as Yt, TDbInsertResult as Z, DbSpace as Zt, DbPatch as _, IntegrityStrategy as _n, TExistingTableOption as _t, isJsonValueField as a, AtscriptExprNode$1 as an, TDbUpdateResult as at, FieldOpsFor as b, AtscriptDbReadable as bn, TFkLookupTarget as bt, resolveCalendarBuckets as c, AtscriptQueryFieldRef$1 as cn, TDbWriteCheckContext as ct, AggregateFn$1 as d, TViewJoin as dn, TDeleteOptions as dt, AtscriptDbView as en, TDbRelation as et, AggregateQuery$1 as f, TViewPlan as fn, TDerivedChangeReason as ft, DbControls as g, AtscriptDbTable as gn, TExistingForeignKey as gt, AtscriptDbWritable as h, translateQueryTree as hn, TExistingColumn as ht, isBucketableField as i, aliasTargetOf as in, TDbUpdateOptions as it, TCrudPermissions as j, containsRelationFilter as jn, TSearchIndexInfo as jt, TColumnDiff as k, TRelationStaticFilter as kn, TRelationInfo as kt, AggregateControls as l, AtscriptQueryNode$1 as ln, TDbWriteGuard as lt, AtscriptDbTableLike as m, isFieldRef as mn, TEnsureTableOptions as mt, TComputedSelect as n, isAtscriptDbView as nn, TDbRemoveGuardContext as nt, jsonValueAncestor as o, AtscriptOrderItem as on, TDbWriteAction as ot, AggregateResult as p, evaluateExpr as pn, TDerivedColumn as pt, TDbInsertIgnoreResult as q, ALL_BUCKET_UNITS as qt, TResolvedBucket as r, isViewType as rn, TDbStorageType as rt, normalizeComputedSelect as s, AtscriptQueryComparison as sn, TDbWriteCheck as st, TBucketFieldSource as t, TViewColumnMapping as tn, TDbRemoveGuard as tt, AggregateExpr$1 as u, AtscriptRef as un, TDbWriteGuardContext as ut, DbQuery as v, NativeIntegrity as vn, TFieldMeta as vt, NullableOptional as w, REL_FILTER_MAX_NODES as wn, TInsertOptions as wt, FilterExpr$1 as x, DbResponse as xn, TIdDescriptor as xt, DbRow as y, TCascadePin as yn, TFkLookupResolver as yt, TDbDefaultFn as z, FieldMappingStrategy as zn, TWriteTableResolver as zt };

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

@@ -744,6 +744,14 @@ declare class AtscriptDbReadable<T extends TAtscriptAnnotatedType = TAtscriptAnn
    * @internal Adapter-facing surface; not part of the consumer API.
    */
   get versionColumnPhysical(): string | undefined;
+  /**
+   * Logical paths of the `@db.column.version.exempt` fields, including objects
+   * whose direct children are all exempt. A patch that writes only these (and
+   * no `$cas`) does not bump the version column. Empty when the table has no
+   * `@db.column.version`.
+   * @since 0.1.150
+   */
+  get versionExemptFields(): ReadonlySet<string>;
   /** Dimension fields from `@db.column.dimension`. */
   get dimensions(): readonly string[];
   /** Measure fields from `@db.column.measure`. */
@@ -2044,6 +2052,13 @@ declare abstract class BaseDbAdapter {
    * When disabled, no log strings are constructed — zero overhead.
    */
   setVerbose(enabled: boolean): void;
+  /**
+   * Physical version column an UPDATE must bump, or `undefined` when it must
+   * not: no `@db.column.version`, or a version-exempt patch
+   * (`opts.keepVersion`, since 0.1.150 — the core never combines it with
+   * `expectedVersion`; a violation throws).
+   */
+  protected _versionColumnFor(opts?: TDbUpdateOptions, expectedVersion?: number): string | undefined;
   /**
    * Logs a debug message if verbose mode is enabled.
    * Adapters call this to log DB operations with zero overhead when disabled.
@@ -2309,9 +2324,10 @@ declare abstract class BaseDbAdapter {
    *
    * @param filter - Filter identifying the record to patch.
    * @param patch - The patch payload with array operations.
+   * @param opts - `keepVersion`: skip the version bump (see {@link TDbUpdateOptions}).
    * @returns Update result.
    */
-  nativePatch(_filter: FilterExpr, _patch: unknown, _ops?: TFieldOps, _expectedVersion?: number): Promise<TDbUpdateResult>;
+  nativePatch(_filter: FilterExpr, _patch: unknown, _ops?: TFieldOps, _expectedVersion?: number, _opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   /**
    * Called before field flattening begins.
    * Use to extract table-level adapter-specific annotations.
@@ -2416,6 +2432,13 @@ declare abstract class BaseDbAdapter {
   /**
    * Returns available search indexes for this adapter.
    * UI uses this to show index picker. Override in adapters that support search.
+   *
+   * A fulltext index may carry integer members ({@link TDbIndexField.integer},
+   * since 0.1.150): list them in `fields`, keep them out of the physical text
+   * index, and OR `member = n` into the search predicate when
+   * `searchTermInteger(text)` is defined. An index of integer members only
+   * is still listed (it makes the table natively searchable); a term that is
+   * not a whole number then matches nothing.
    */
   getSearchIndexes(): TSearchIndexInfo[];
   private _physicalToLogical?;
@@ -2444,7 +2467,9 @@ declare abstract class BaseDbAdapter {
    */
   isVectorSearchable(): boolean;
   /**
-   * Full-text search. Override in adapters that support search.
+   * Full-text search. Override in adapters that support search. The text
+   * match is OR'd with exact-number equality on the index's integer members
+   * when the whole term is a whole number (see `searchTermInteger`).
    *
    * @param text - Search text.
    * @param query - Filter, sort, limit, etc.
@@ -2563,12 +2588,17 @@ declare abstract class BaseDbAdapter {
   /** Whether {@link insertManyIgnore} is implemented (drives `crud.insert: ["onConflict"]` in `/meta`). @since 0.1.148 */
   supportsInsertIgnore(): boolean;
   abstract replaceOne(filter: FilterExpr, data: Record<string, unknown>, expectedVersion?: number): Promise<TDbUpdateResult>;
-  abstract updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number): Promise<TDbUpdateResult>;
+  /**
+   * `opts.keepVersion` — skip the version bump (and never combine with
+   * `expectedVersion`); see {@link TDbUpdateOptions}.
+   */
+  abstract updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   abstract deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
   abstract findOne(query: DbQuery): Promise<Record<string, unknown> | null>;
   abstract findMany(query: DbQuery): Promise<Array<Record<string, unknown>>>;
   abstract count(query: DbQuery): Promise<number>;
-  abstract updateMany(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps): Promise<TDbUpdateResult>;
+  /** `opts.keepVersion` — skip the version bump; see {@link TDbUpdateOptions}. */
+  abstract updateMany(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   abstract replaceMany(filter: FilterExpr, data: Record<string, unknown>): Promise<TDbUpdateResult>;
   abstract deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
   /**
@@ -2862,6 +2892,15 @@ declare class TableMetadata {
   measures: string[];
   /** Logical field name annotated with `@db.column.version`, if any. */
   versionField?: string;
+  /** Paths annotated with `@db.column.version.exempt`, as declared (since 0.1.150). */
+  private _versionExemptDeclared;
+  /**
+   * Version-exempt paths (since 0.1.150): the declared ones plus every object
+   * whose direct children are all exempt (upward closure). A path is exempt
+   * when it, or an ancestor, is in this set — see {@link isVersionExemptPath}.
+   * Empty when the table declares no `@db.column.version`.
+   */
+  versionExemptPaths: ReadonlySet<string>;
   /** path → sibling-ref path for `@db.amount.currency.ref` / `@db.unit.ref`. */
   quantityRefByField: Map<string, string>;
   /** Logical paths annotated with `@db.encrypted` — stored as one opaque ciphertext column. */
@@ -2977,6 +3016,16 @@ declare class TableMetadata {
    * Scans `@db.*` and `@meta.id` annotations on a field during flattening.
    */
   private _scanGenericAnnotations;
+  /**
+   * Validates the `@db.column.version.exempt` placements (E1–E5, the runtime
+   * mirror of the compile-time check, so pre-compiled models fail fast) and
+   * computes {@link versionExemptPaths} with its upward closure. Runs after
+   * `_applyOverrides` (the primary keys are final) and before `jsonFields` is
+   * released. A table without a version column ignores the annotation.
+   */
+  private _finalizeVersionExempt;
+  /** Whether `path` — or an ancestor of it — is version-exempt (since 0.1.150). */
+  isVersionExemptPath(path: string): boolean;
   /**
    * Build-time diagnostics for `@db.encrypted` (§6 of the field-encryption
    * spec). Mirrors the compile-time AnnotationSpec validation so models built
@@ -3030,6 +3079,13 @@ declare class TableMetadata {
    * Resolves `fkTargetField` for FK fields in field descriptors.
    */
   private _resolveFkTargetFields;
+  /**
+   * Flags the integer members of fulltext indexes (matched by exact number,
+   * never part of the physical text index) and enforces that each is
+   * index-backed — the equality branch must not scan. Runs while index field
+   * names are still logical.
+   */
+  private _resolveIntegerFulltextMembers;
   private _finalizeIndexes;
   /**
    * Captures legitimate row-identifier shapes from the metadata: primary key
@@ -3446,6 +3502,18 @@ interface TDbUpdateResult {
   matchedCount: number;
   modifiedCount: number;
 }
+/**
+ * Per-call options of an adapter UPDATE (since 0.1.150).
+ */
+interface TDbUpdateOptions {
+  /**
+   * The patch writes only `@db.column.version.exempt` fields: leave the
+   * version column untouched (no `+1`). The core sets it only for CAS-free
+   * patches — never together with `expectedVersion`. An adapter that ignores
+   * the option keeps bumping (the pre-0.1.150 behaviour).
+   */
+  keepVersion?: boolean;
+}
 interface TDbDeleteResult {
   deletedCount: number;
 }
@@ -3469,6 +3537,13 @@ interface TDbIndexField {
    * re-resolving the field type. Undefined when the field cannot be resolved.
    */
   designType?: string;
+  /**
+   * Fulltext member matched by exact whole-number equality, never part of the
+   * physical text index (integer field; since 0.1.150). Adapters exclude it
+   * from text DDL and OR `member = n` into their search predicate when the
+   * search term is a whole number (see `searchTermInteger`).
+   */
+  integer?: boolean;
 }
 interface TDbIndex {
   /** Unique key used for identity/diffing (e.g., "atscript__plain__email") */
@@ -4263,4 +4338,4 @@ declare function isJsonValueField(fd: TDbFieldMeta): boolean;
  */
 declare function jsonValueAncestor(path: string, jsonValueParents: ReadonlySet<string>): string | undefined;
 //#endregion
-export { TDbReferentialAction as $, AtscriptDbView as $t, TCrudOp as A, containsRelationFilter as An, TSearchIndexInfo as At, TDbDefaultValue as B, NoopLogger as Bn, Uniquery$1 as Bt, NavPropsOf$1 as C, REL_FILTER_MAX_NODES as Cn, TInsertOptions as Ct, TCascadeResolver as D, TRelationFilterTable as Dn, TReferencingForeignKey as Dt, PrimaryKeyOf$1 as E, TRelationFilterJunction as En, TPrimaryKeyChange as Et, TDbActionProcessor as F, DbEncryption as Fn, TValueFormatterPair as Ft, TDbIndexField as G, UniquSelect as Gn, isGeoPointType as Gt, TDbFieldMeta as H, TExprAggregate as Hn, WithRelation$1 as Ht, TDbActionTargetSummary as I, TDbEncryptionOptions as In, TViewJsonType as It, TDbInsertIgnoreSlot as J, BaseDbAdapter as Jt, TDbIndexType as K, ALL_BUCKET_UNITS as Kt, TDbAvailableActions as L, DocumentFieldMapper as Ln, TWriteOptions as Lt, TDbActionInfo as M, hasRelationOp as Mn, TTableOptionDiff as Mt, TDbActionIntent as N, isResolvedRelationFilter as Nn, TTableResolver as Nt, TCascadeTarget as O, TRelationStaticFilter as On, TRelationInfo as Ot, TDbActionLevel as P, relationStaticFilter as Pn, TTouchManyOptions as Pt, TDbObjectKind as Q, TDbSpaceOptions as Qt, TDbCollation as R, FieldMappingStrategy as Rn, TWriteTableResolver as Rt, FlatOf$1 as S, REL_FILTER_MAX_DEPTH as Sn, TIdentification as St, OwnPropsOf$1 as T, TRelGuardState as Tn, TMetadataOverrides as Tt, TDbForeignKey as U, TFirstLast as Un, TableMetadata as Ut, TDbDeleteResult as V, TGenericLogger as Vn, UniqueryControls$1 as Vt, TDbIndex as W, TRowOrderKey as Wn, isGeoIndexableType as Wt, TDbInsertManyResult as X, DbSpace as Xt, TDbInsertManyIgnoreResult as Y, TViewCapability as Yt, TDbInsertResult as Z, TAdapterFactory as Zt, DbPatch as _, NativeIntegrity as _n, TFieldMeta as _t, isJsonValueField as a, AtscriptOrderItem as an, TDbWriteAction as at, FieldOpsFor as b, DbResponse as bn, TIdDescriptor as bt, resolveCalendarBuckets as c, AtscriptQueryNode$1 as cn, TDbWriteGuard as ct, AggregateFn$1 as d, TViewPlan as dn, TDerivedChangeReason as dt, TViewColumnMapping as en, TDbRelation as et, AggregateQuery$1 as f, evaluateExpr as fn, TDerivedColumn as ft, DbControls as g, IntegrityStrategy as gn, TExistingTableOption as gt, AtscriptDbWritable as h, AtscriptDbTable as hn, TExistingForeignKey as ht, isBucketableField as i, AtscriptExprNode$1 as in, TDbUpdateResult as it, TCrudPermissions as j, forEachResolvedRelation as jn, TSyncColumnResult as jt, TColumnDiff as k, andFilters as kn, TRowResolveOptions as kt, AggregateControls as l, AtscriptRef as ln, TDbWriteGuardContext as lt, AtscriptDbTableLike as m, translateQueryTree as mn, TExistingColumn as mt, TComputedSelect as n, isViewType as nn, TDbRemoveGuardContext as nt, jsonValueAncestor as o, AtscriptQueryComparison as on, TDbWriteCheck as ot, AggregateResult as p, isFieldRef as pn, TEnsureTableOptions as pt, TDbInsertIgnoreResult as q, ALL_VIEW_CAPABILITIES as qt, TResolvedBucket as r, aliasTargetOf as rn, TDbStorageType as rt, normalizeComputedSelect as s, AtscriptQueryFieldRef$1 as sn, TDbWriteCheckContext as st, TBucketFieldSource as t, isAtscriptDbView as tn, TDbRemoveGuard as tt, AggregateExpr$1 as u, TViewJoin as un, TDeleteOptions as ut, DbQuery as v, TCascadePin as vn, TFkLookupResolver as vt, NullableOptional as w, ResolvedRelationFilter as wn, TMetaResponse as wt, FilterExpr$1 as x, resolveDesignType as xn, TIdResolveOptions as xt, DbRow as y, AtscriptDbReadable as yn, TFkLookupTarget as yt, TDbDefaultFn as z, TReadControls as zn, TypedWithRelation as zt };
+export { TDbReferentialAction as $, TDbSpaceOptions as $t, TCrudOp as A, andFilters as An, TRowResolveOptions as At, TDbDefaultValue as B, TReadControls as Bn, TypedWithRelation as Bt, NavPropsOf$1 as C, REL_FILTER_MAX_DEPTH as Cn, TIdentification as Ct, TCascadeResolver as D, TRelationFilterJunction as Dn, TPrimaryKeyChange as Dt, PrimaryKeyOf$1 as E, TRelGuardState as En, TMetadataOverrides as Et, TDbActionProcessor as F, relationStaticFilter as Fn, TTouchManyOptions as Ft, TDbIndexField as G, TRowOrderKey as Gn, isGeoIndexableType as Gt, TDbFieldMeta as H, TGenericLogger as Hn, UniqueryControls$1 as Ht, TDbActionTargetSummary as I, DbEncryption as In, TValueFormatterPair as It, TDbInsertIgnoreSlot as J, ALL_VIEW_CAPABILITIES as Jt, TDbIndexType as K, UniquSelect as Kn, isGeoPointType as Kt, TDbAvailableActions as L, TDbEncryptionOptions as Ln, TViewJsonType as Lt, TDbActionInfo as M, forEachResolvedRelation as Mn, TSyncColumnResult as Mt, TDbActionIntent as N, hasRelationOp as Nn, TTableOptionDiff as Nt, TCascadeTarget as O, TRelationFilterTable as On, TReferencingForeignKey as Ot, TDbActionLevel as P, isResolvedRelationFilter as Pn, TTableResolver as Pt, TDbObjectKind as Q, TAdapterFactory as Qt, TDbCollation as R, DocumentFieldMapper as Rn, TWriteOptions as Rt, FlatOf$1 as S, resolveDesignType as Sn, TIdResolveOptions as St, OwnPropsOf$1 as T, ResolvedRelationFilter as Tn, TMetaResponse as Tt, TDbForeignKey as U, TExprAggregate as Un, WithRelation$1 as Ut, TDbDeleteResult as V, NoopLogger as Vn, Uniquery$1 as Vt, TDbIndex as W, TFirstLast as Wn, TableMetadata as Wt, TDbInsertManyResult as X, TViewCapability as Xt, TDbInsertManyIgnoreResult as Y, BaseDbAdapter as Yt, TDbInsertResult as Z, DbSpace as Zt, DbPatch as _, IntegrityStrategy as _n, TExistingTableOption as _t, isJsonValueField as a, AtscriptExprNode$1 as an, TDbUpdateResult as at, FieldOpsFor as b, AtscriptDbReadable as bn, TFkLookupTarget as bt, resolveCalendarBuckets as c, AtscriptQueryFieldRef$1 as cn, TDbWriteCheckContext as ct, AggregateFn$1 as d, TViewJoin as dn, TDeleteOptions as dt, AtscriptDbView as en, TDbRelation as et, AggregateQuery$1 as f, TViewPlan as fn, TDerivedChangeReason as ft, DbControls as g, AtscriptDbTable as gn, TExistingForeignKey as gt, AtscriptDbWritable as h, translateQueryTree as hn, TExistingColumn as ht, isBucketableField as i, aliasTargetOf as in, TDbUpdateOptions as it, TCrudPermissions as j, containsRelationFilter as jn, TSearchIndexInfo as jt, TColumnDiff as k, TRelationStaticFilter as kn, TRelationInfo as kt, AggregateControls as l, AtscriptQueryNode$1 as ln, TDbWriteGuard as lt, AtscriptDbTableLike as m, isFieldRef as mn, TEnsureTableOptions as mt, TComputedSelect as n, isAtscriptDbView as nn, TDbRemoveGuardContext as nt, jsonValueAncestor as o, AtscriptOrderItem as on, TDbWriteAction as ot, AggregateResult as p, evaluateExpr as pn, TDerivedColumn as pt, TDbInsertIgnoreResult as q, ALL_BUCKET_UNITS as qt, TResolvedBucket as r, isViewType as rn, TDbStorageType as rt, normalizeComputedSelect as s, AtscriptQueryComparison as sn, TDbWriteCheck as st, TBucketFieldSource as t, TViewColumnMapping as tn, TDbRemoveGuard as tt, AggregateExpr$1 as u, AtscriptRef as un, TDbWriteGuardContext as ut, DbQuery as v, NativeIntegrity as vn, TFieldMeta as vt, NullableOptional as w, REL_FILTER_MAX_NODES as wn, TInsertOptions as wt, FilterExpr$1 as x, DbResponse as xn, TIdDescriptor as xt, DbRow as y, TCascadePin as yn, TFkLookupResolver as yt, TDbDefaultFn as z, FieldMappingStrategy as zn, TWriteTableResolver as zt };