@atscript/db-sqlite 0.1.161 → 0.1.163

package/dist/index.cjs

@@ -310,6 +310,7 @@ const sqliteDialect = {
 		return `"${esc(name)}"`;
 	},
 	unlimitedLimit: "-1",
+	stringLiteral: _atscript_db_sql_tools.sqlStringLiteral,
 	toValue: _atscript_db_sql_tools.toSqlValue,
 	toParam(value) {
 		if (value === void 0) return null;
@@ -801,6 +802,21 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 	supportsNullsPlacement() {
 		return true;
 	}
+	/**
+	* Locking reads are accepted as a no-op (since 0.1.162): every transaction
+	* starts with `BEGIN IMMEDIATE`, which holds the database write lock, so
+	* reads inside it are current and no other writer can run until it ends.
+	*/
+	supportsReadLocks() {
+		return true;
+	}
+	/** Every level — a `BEGIN IMMEDIATE` transaction is serializable. @since 0.1.162 */
+	isolationLevels() {
+		return _atscript_db.ALL_ISOLATION_LEVELS;
+	}
+	_inherentIsolation() {
+		return "serializable";
+	}
 	/** Computed view columns and first-row joins. */
 	viewCapabilities() {
 		return _atscript_db.ALL_VIEW_CAPABILITIES;
@@ -1153,8 +1169,25 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 			modifiedCount: result.changes
 		};
 	}
+	/**
+	* Bounded writes (since 0.1.162) through an ordered, limited rowid subquery
+	* (`rowid IN (SELECT rowid … ORDER BY … LIMIT n)`) — no
+	* `SQLITE_ENABLE_UPDATE_DELETE_LIMIT` build needed.
+	*/
+	supportsWriteLimit() {
+		return true;
+	}
+	/** One writer at a time: the rowid pick and the write run as one statement, never interleaved. */
+	writeLimitIsAtomic() {
+		return true;
+	}
+	/** `where` narrowed to a bounded write's rows, or `where` itself when unbounded. */
+	_boundedWhere(where, bound) {
+		if (!bound) return where;
+		return (0, _atscript_db_sql_tools.writeLimitWhere)(sqliteDialect, `"${esc(this.resolveTableName())}"`, ["rowid"], where, bound);
+	}
 	async updateMany(filter, data, ops, opts) {
-		const where = buildWhere(filter);
+		const where = this._boundedWhere(buildWhere(filter), opts?.limit);
 		const versionColumn = this._versionColumnFor(opts);
 		const { sql, params } = buildUpdate(this.resolveTableName(), data, where, ops, versionColumn);
 		this._log(sql, params);
@@ -1168,10 +1201,10 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 		const where = buildWhere(filter);
 		const tableName = this.resolveTableName();
 		const versionColumn = this._table.versionColumnPhysical;
-		const { sql, params } = buildUpdate(tableName, (0, _atscript_db_sql_tools.fillReplacePayload)(data, (0, _atscript_db_sql_tools.replaceColumnsFor)(this._table.fieldDescriptors, this.nativeDefaultFns()), versionColumn), {
+		const { sql, params } = buildUpdate(tableName, (0, _atscript_db_sql_tools.fillReplacePayload)(data, (0, _atscript_db_sql_tools.replaceColumnsFor)(this._table.fieldDescriptors, this.nativeDefaultFns()), versionColumn, this._table.onUpdateIncPhysical), {
 			sql: `rowid = (SELECT rowid FROM "${esc(tableName)}" WHERE ${where.sql} LIMIT 1)`,
 			params: where.params
-		}, void 0, versionColumn, expectedVersion);
+		}, this._onUpdateIncOps(), versionColumn, expectedVersion);
 		this._log(sql, params);
 		const result = await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)));
 		return {
@@ -1182,7 +1215,7 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 	async replaceMany(filter, data) {
 		const where = buildWhere(filter);
 		const versionColumn = this._table.versionColumnPhysical;
-		const { sql, params } = buildUpdate(this.resolveTableName(), data, where, void 0, versionColumn);
+		const { sql, params } = buildUpdate(this.resolveTableName(), data, where, this._onUpdateIncOps(), versionColumn);
 		this._log(sql, params);
 		const result = await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)));
 		return {
@@ -1197,8 +1230,8 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 		this._log(sql, where.params);
 		return { deletedCount: (await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, where.params)))).changes };
 	}
-	async deleteMany(filter) {
-		const where = buildWhere(filter);
+	async deleteMany(filter, opts) {
+		const where = this._boundedWhere(buildWhere(filter), opts?.limit);
 		const { sql, params } = buildDelete(this.resolveTableName(), where);
 		this._log(sql, params);
 		return { deletedCount: (await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)))).changes };
@@ -1494,30 +1527,33 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 		});
 	}
 	async syncIndexes() {
-		return this._withExclusiveConnection(async () => {
-			const tableName = this.resolveTableName();
-			await this.syncIndexesWithDiff({
-				listExisting: async () => this.driver.all(`PRAGMA index_list("${esc(tableName)}")`).filter((i) => !i.name.startsWith("sqlite_")).map((i) => ({
-					name: i.name,
-					columns: this.driver.all(`PRAGMA index_info("${esc(i.name)}")`).map((c) => c.name).filter((n) => n !== null)
-				})),
-				createIndex: async (index) => {
-					const unique = index.type === "unique" ? "UNIQUE " : "";
-					const cols = index.fields.map((f) => `"${esc(f.name)}" ${f.sort === "desc" ? "DESC" : "ASC"}`).join(", ");
-					const sql = `CREATE ${unique}INDEX IF NOT EXISTS "${esc(index.key)}" ON "${esc(tableName)}" (${cols})`;
-					this._log(sql);
-					this.driver.exec(sql);
-				},
-				dropIndex: async (name) => {
-					const sql = `DROP INDEX IF EXISTS "${esc(name)}"`;
-					this._log(sql);
-					this.driver.exec(sql);
-				},
-				shouldSkipType: (type) => type === "fulltext" || type === "geo"
-			});
-			this._syncFtsIndexes(tableName);
-			this._syncVecIndexes(tableName);
+		return this._withExclusiveConnection(() => this._syncIndexes(false));
+	}
+	async _syncIndexes(dryRun) {
+		const tableName = this.resolveTableName();
+		const changes = await this.syncIndexesWithDiff({
+			dryRun,
+			listExisting: async () => this.driver.all(`PRAGMA index_list("${esc(tableName)}")`).filter((i) => !i.name.startsWith("sqlite_")).map((i) => ({
+				name: i.name,
+				columns: this.driver.all(`PRAGMA index_info("${esc(i.name)}")`).map((c) => c.name).filter((n) => n !== null)
+			})),
+			createIndex: async (index) => {
+				const unique = index.type === "unique" ? "UNIQUE " : "";
+				const cols = index.fields.map((f) => `"${esc(f.name)}" ${f.sort === "desc" ? "DESC" : "ASC"}`).join(", ");
+				const sql = `CREATE ${unique}INDEX IF NOT EXISTS "${esc(index.key)}" ON "${esc(tableName)}" (${cols})`;
+				this._log(sql);
+				this.driver.exec(sql);
+			},
+			dropIndex: async (name) => {
+				const sql = `DROP INDEX IF EXISTS "${esc(name)}"`;
+				this._log(sql);
+				this.driver.exec(sql);
+			},
+			skipIndex: (index) => index.type === "fulltext" || index.type === "geo" ? null : void 0
 		});
+		changes.push(...await this._syncFtsIndexes(tableName, dryRun));
+		changes.push(...await this._syncVecIndexes(tableName, dryRun));
+		return changes;
 	}
 	getSearchIndexes() {
 		const indexes = [];
@@ -1686,20 +1722,31 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 	/**
 	* Creates/drops FTS5 virtual tables and sync triggers to match desired fulltext indexes.
 	*/
-	_syncFtsIndexes(tableName) {
+	async _syncFtsIndexes(tableName, dryRun) {
+		const { changes, apply } = (0, _atscript_db.createChangeRecorder)(dryRun);
 		const ftIndexes = this._getFulltextIndexes().filter((idx) => (0, _atscript_db.splitFulltextFields)(idx).text.length > 0);
 		const desiredFtsTables = new Set(ftIndexes.map((idx) => this._ftsTableName(idx.name)));
-		const existingFts = this.driver.all(`SELECT name, sql FROM sqlite_master WHERE type='table' AND name LIKE ?`, [`${tableName}__fts__%`]).filter((r) => r.sql.startsWith("CREATE VIRTUAL TABLE")).map((r) => r.name);
-		for (const name of existingFts) if (!desiredFtsTables.has(name)) this._dropFtsTable(name);
+		const existingFts = this._listShadowTables(tableName, "fts");
+		for (const name of existingFts) if (!desiredFtsTables.has(name)) await apply({
+			name,
+			action: "drop"
+		}, name, () => this._dropFtsTable(name));
 		const existingSet = new Set(existingFts);
 		for (const index of ftIndexes) {
 			const ftsTable = this._ftsTableName(index.name);
-			if (!existingSet.has(ftsTable)) this._createFtsTable(tableName, ftsTable, index);
-			else if (!this._ftsColumnsMatch(ftsTable, index)) {
+			if (!existingSet.has(ftsTable)) await apply({
+				name: ftsTable,
+				action: "add"
+			}, ftsTable, () => this._createFtsTable(tableName, ftsTable, index));
+			else if (!this._ftsColumnsMatch(ftsTable, index)) await apply({
+				name: ftsTable,
+				action: "rebuild"
+			}, ftsTable, () => {
 				this._dropFtsTable(ftsTable);
 				this._createFtsTable(tableName, ftsTable, index);
-			}
+			});
 		}
+		return changes;
 	}
 	/** Whether an existing FTS5 table has exactly the index's text columns, in order. */
 	_ftsColumnsMatch(ftsTable, index) {
@@ -1930,21 +1977,29 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 	/**
 	* Creates/drops vec0 virtual shadow tables and sync triggers to match desired vector fields.
 	*/
-	_syncVecIndexes(tableName) {
-		if (this._vectorFields.size === 0) return;
+	async _syncVecIndexes(tableName, dryRun) {
+		const { changes, apply } = (0, _atscript_db.createChangeRecorder)(dryRun);
+		if (this._vectorFields.size === 0) return changes;
 		if (!this._detectVectorSupport()) {
 			this._log("[atscript-db-sqlite] sqlite-vec not available, skipping vec0 shadow table sync (vector fields stored as JSON)");
-			return;
+			return changes;
 		}
 		const desiredVecTables = /* @__PURE__ */ new Map();
 		for (const [fieldPath, meta] of this._vectorFields.entries()) desiredVecTables.set(this._vecTableName(meta.indexName), {
 			field: fieldPath,
 			meta
 		});
-		const existingVec = this.driver.all(`SELECT name, sql FROM sqlite_master WHERE type='table' AND name LIKE ?`, [`${tableName}__vec__%`]).filter((r) => r.sql.startsWith("CREATE VIRTUAL TABLE")).map((r) => r.name);
-		for (const name of existingVec) if (!desiredVecTables.has(name)) this._dropVecTable(name);
+		const existingVec = this._listShadowTables(tableName, "vec");
+		for (const name of existingVec) if (!desiredVecTables.has(name)) await apply({
+			name,
+			action: "drop"
+		}, name, () => this._dropVecTable(name));
 		const existingSet = new Set(existingVec);
-		for (const [vecTable, { field, meta }] of desiredVecTables.entries()) if (!existingSet.has(vecTable)) this._createVecTable(tableName, vecTable, field, meta);
+		for (const [vecTable, { field, meta }] of desiredVecTables.entries()) if (!existingSet.has(vecTable)) await apply({
+			name: vecTable,
+			action: "add"
+		}, vecTable, () => this._createVecTable(tableName, vecTable, field, meta));
+		return changes;
 	}
 	/** Creates a vec0 virtual shadow table with sync triggers and seeds it from existing rows. */
 	_createVecTable(tableName, vecTable, field, vec) {
@@ -2034,8 +2089,7 @@ function andWhere(left, right) {
 *  PRAGMA returns `'active'` (SQL-quoted), we store `active` (raw). */
 function normalizeSqliteDefault(value) {
 	if (value === null) return;
-	if (value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1);
-	return value;
+	return (0, _atscript_db_sql_tools.unquoteSqlStringLiteral)(value) ?? value;
 }
 //#endregion
 //#region src/index.ts

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TJsonCopyTarget, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
+import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteManyOptions, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbIsolationLevel, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TIndexChange, TJsonCopyTarget, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
 import { TMetadataMap } from "@atscript/typescript/utils";
 import { FilterExpr as FilterExpr$1 } from "@uniqu/core";
 import { TFilterVisitorOptions, TSqlFragment, TSqlFragment as TSqlFragment$1 } from "@atscript/db-sql-tools";
@@ -299,6 +299,15 @@ declare class SqliteAdapter extends BaseDbAdapter {
   supportsAggregateExpressions(): boolean;
   /** `$nulls` / `@db.sort.nulls` NULL placement — `NULLS FIRST` / `NULLS LAST`. */
   supportsNullsPlacement(): boolean;
+  /**
+   * Locking reads are accepted as a no-op (since 0.1.162): every transaction
+   * starts with `BEGIN IMMEDIATE`, which holds the database write lock, so
+   * reads inside it are current and no other writer can run until it ends.
+   */
+  supportsReadLocks(): boolean;
+  /** Every level — a `BEGIN IMMEDIATE` transaction is serializable. @since 0.1.162 */
+  isolationLevels(): ReadonlySet<TDbIsolationLevel>;
+  protected _inherentIsolation(): TDbIsolationLevel;
   /** Computed view columns and first-row joins. */
   viewCapabilities(): ReadonlySet<TViewCapability>;
   /** INSERT text per column signature (rows of one table share a handful of shapes). */
@@ -406,11 +415,21 @@ declare class SqliteAdapter extends BaseDbAdapter {
   count(query: DbQuery): Promise<number>;
   aggregate(query: DbQuery): Promise<Array<Record<string, unknown>>>;
   updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
+  /**
+   * Bounded writes (since 0.1.162) through an ordered, limited rowid subquery
+   * (`rowid IN (SELECT rowid … ORDER BY … LIMIT n)`) — no
+   * `SQLITE_ENABLE_UPDATE_DELETE_LIMIT` build needed.
+   */
+  supportsWriteLimit(): boolean;
+  /** One writer at a time: the rowid pick and the write run as one statement, never interleaved. */
+  writeLimitIsAtomic(): boolean;
+  /** `where` narrowed to a bounded write's rows, or `where` itself when unbounded. */
+  private _boundedWhere;
   updateMany(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   replaceOne(filter: FilterExpr, data: Record<string, unknown>, expectedVersion?: number): Promise<TDbUpdateResult>;
   replaceMany(filter: FilterExpr, data: Record<string, unknown>): Promise<TDbUpdateResult>;
   deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
-  deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
+  deleteMany(filter: FilterExpr, opts?: TDbDeleteManyOptions): Promise<TDbDeleteResult>;
   /**
    * SQLite accepts forward FK references, so a foreign-key cycle is created
    * inline in any order — `opts.deferForeignKeysTo` is accepted and ignored.
@@ -462,7 +481,8 @@ declare class SqliteAdapter extends BaseDbAdapter {
    * sync). A virtual table's hidden columns (`hidden` 1) are skipped.
    */
   getExistingColumnsForTable(tableName: string): Promise<TExistingColumn[]>;
-  syncIndexes(): Promise<void>;
+  syncIndexes(): Promise<TIndexChange[]>;
+  protected _syncIndexes(dryRun: boolean): Promise<TIndexChange[]>;
   getSearchIndexes(): TSearchIndexInfo[];
   search(text: string, query: DbQuery, indexName?: string): Promise<Array<Record<string, unknown>>>;
   searchWithCount(text: string, query: DbQuery, indexName?: string): Promise<{

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TJsonCopyTarget, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
+import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteManyOptions, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbIsolationLevel, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TIndexChange, TJsonCopyTarget, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
 import { TFilterVisitorOptions, TSqlFragment, TSqlFragment as TSqlFragment$1 } from "@atscript/db-sql-tools";
 import { FilterExpr as FilterExpr$1 } from "@uniqu/core";
 import { TMetadataMap } from "@atscript/typescript/utils";
@@ -299,6 +299,15 @@ declare class SqliteAdapter extends BaseDbAdapter {
   supportsAggregateExpressions(): boolean;
   /** `$nulls` / `@db.sort.nulls` NULL placement — `NULLS FIRST` / `NULLS LAST`. */
   supportsNullsPlacement(): boolean;
+  /**
+   * Locking reads are accepted as a no-op (since 0.1.162): every transaction
+   * starts with `BEGIN IMMEDIATE`, which holds the database write lock, so
+   * reads inside it are current and no other writer can run until it ends.
+   */
+  supportsReadLocks(): boolean;
+  /** Every level — a `BEGIN IMMEDIATE` transaction is serializable. @since 0.1.162 */
+  isolationLevels(): ReadonlySet<TDbIsolationLevel>;
+  protected _inherentIsolation(): TDbIsolationLevel;
   /** Computed view columns and first-row joins. */
   viewCapabilities(): ReadonlySet<TViewCapability>;
   /** INSERT text per column signature (rows of one table share a handful of shapes). */
@@ -406,11 +415,21 @@ declare class SqliteAdapter extends BaseDbAdapter {
   count(query: DbQuery): Promise<number>;
   aggregate(query: DbQuery): Promise<Array<Record<string, unknown>>>;
   updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
+  /**
+   * Bounded writes (since 0.1.162) through an ordered, limited rowid subquery
+   * (`rowid IN (SELECT rowid … ORDER BY … LIMIT n)`) — no
+   * `SQLITE_ENABLE_UPDATE_DELETE_LIMIT` build needed.
+   */
+  supportsWriteLimit(): boolean;
+  /** One writer at a time: the rowid pick and the write run as one statement, never interleaved. */
+  writeLimitIsAtomic(): boolean;
+  /** `where` narrowed to a bounded write's rows, or `where` itself when unbounded. */
+  private _boundedWhere;
   updateMany(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, opts?: TDbUpdateOptions): Promise<TDbUpdateResult>;
   replaceOne(filter: FilterExpr, data: Record<string, unknown>, expectedVersion?: number): Promise<TDbUpdateResult>;
   replaceMany(filter: FilterExpr, data: Record<string, unknown>): Promise<TDbUpdateResult>;
   deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
-  deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
+  deleteMany(filter: FilterExpr, opts?: TDbDeleteManyOptions): Promise<TDbDeleteResult>;
   /**
    * SQLite accepts forward FK references, so a foreign-key cycle is created
    * inline in any order — `opts.deferForeignKeysTo` is accepted and ignored.
@@ -462,7 +481,8 @@ declare class SqliteAdapter extends BaseDbAdapter {
    * sync). A virtual table's hidden columns (`hidden` 1) are skipped.
    */
   getExistingColumnsForTable(tableName: string): Promise<TExistingColumn[]>;
-  syncIndexes(): Promise<void>;
+  syncIndexes(): Promise<TIndexChange[]>;
+  protected _syncIndexes(dryRun: boolean): Promise<TIndexChange[]>;
   getSearchIndexes(): TSearchIndexInfo[];
   search(text: string, query: DbQuery, indexName?: string): Promise<Array<Record<string, unknown>>>;
   searchWithCount(text: string, query: DbQuery, indexName?: string): Promise<{

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
-import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, BaseDbAdapter, DbError, DbSpace, defaultFulltextIndex, describeFulltext, fkColumns, searchIndexNotFoundMessage, searchTermInteger, splitFulltextFields, vectorIndexNotFoundMessage } from "@atscript/db";
+import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_ISOLATION_LEVELS, ALL_VIEW_CAPABILITIES, BaseDbAdapter, DbError, DbSpace, createChangeRecorder, defaultFulltextIndex, describeFulltext, fkColumns, searchIndexNotFoundMessage, searchTermInteger, splitFulltextFields, vectorIndexNotFoundMessage } from "@atscript/db";
 import { resolveAggregateSearch } from "@atscript/db/agg";
-import { EMPTY_AND, InsertSqlCache, SEARCH_SOURCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildJsonColumnCopy, buildJsonifyText, buildKeyViolationCount, buildPartitionedSelect, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, fromSourceSql, geoWindowFromControls, jsonDollarPath, orFragment, orderByList, parseRegexString, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, viewReadSource } from "@atscript/db-sql-tools";
+import { EMPTY_AND, InsertSqlCache, SEARCH_SOURCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildJsonColumnCopy, buildJsonifyText, buildKeyViolationCount, buildPartitionedSelect, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, fromSourceSql, geoWindowFromControls, jsonDollarPath, orFragment, orderByList, parseRegexString, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue, unquoteSqlStringLiteral, viewReadSource, writeLimitWhere } from "@atscript/db-sql-tools";
 import { bucketer } from "@uniqu/core";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/better-sqlite3-driver.ts
@@ -309,6 +309,7 @@ const sqliteDialect = {
 		return `"${esc(name)}"`;
 	},
 	unlimitedLimit: "-1",
+	stringLiteral: sqlStringLiteral,
 	toValue: toSqlValue,
 	toParam(value) {
 		if (value === void 0) return null;
@@ -800,6 +801,21 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 	supportsNullsPlacement() {
 		return true;
 	}
+	/**
+	* Locking reads are accepted as a no-op (since 0.1.162): every transaction
+	* starts with `BEGIN IMMEDIATE`, which holds the database write lock, so
+	* reads inside it are current and no other writer can run until it ends.
+	*/
+	supportsReadLocks() {
+		return true;
+	}
+	/** Every level — a `BEGIN IMMEDIATE` transaction is serializable. @since 0.1.162 */
+	isolationLevels() {
+		return ALL_ISOLATION_LEVELS;
+	}
+	_inherentIsolation() {
+		return "serializable";
+	}
 	/** Computed view columns and first-row joins. */
 	viewCapabilities() {
 		return ALL_VIEW_CAPABILITIES;
@@ -1152,8 +1168,25 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 			modifiedCount: result.changes
 		};
 	}
+	/**
+	* Bounded writes (since 0.1.162) through an ordered, limited rowid subquery
+	* (`rowid IN (SELECT rowid … ORDER BY … LIMIT n)`) — no
+	* `SQLITE_ENABLE_UPDATE_DELETE_LIMIT` build needed.
+	*/
+	supportsWriteLimit() {
+		return true;
+	}
+	/** One writer at a time: the rowid pick and the write run as one statement, never interleaved. */
+	writeLimitIsAtomic() {
+		return true;
+	}
+	/** `where` narrowed to a bounded write's rows, or `where` itself when unbounded. */
+	_boundedWhere(where, bound) {
+		if (!bound) return where;
+		return writeLimitWhere(sqliteDialect, `"${esc(this.resolveTableName())}"`, ["rowid"], where, bound);
+	}
 	async updateMany(filter, data, ops, opts) {
-		const where = buildWhere(filter);
+		const where = this._boundedWhere(buildWhere(filter), opts?.limit);
 		const versionColumn = this._versionColumnFor(opts);
 		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where, ops, versionColumn);
 		this._log(sql, params);
@@ -1167,10 +1200,10 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 		const where = buildWhere(filter);
 		const tableName = this.resolveTableName();
 		const versionColumn = this._table.versionColumnPhysical;
-		const { sql, params } = buildUpdate$1(tableName, fillReplacePayload(data, replaceColumnsFor(this._table.fieldDescriptors, this.nativeDefaultFns()), versionColumn), {
+		const { sql, params } = buildUpdate$1(tableName, fillReplacePayload(data, replaceColumnsFor(this._table.fieldDescriptors, this.nativeDefaultFns()), versionColumn, this._table.onUpdateIncPhysical), {
 			sql: `rowid = (SELECT rowid FROM "${esc(tableName)}" WHERE ${where.sql} LIMIT 1)`,
 			params: where.params
-		}, void 0, versionColumn, expectedVersion);
+		}, this._onUpdateIncOps(), versionColumn, expectedVersion);
 		this._log(sql, params);
 		const result = await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)));
 		return {
@@ -1181,7 +1214,7 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 	async replaceMany(filter, data) {
 		const where = buildWhere(filter);
 		const versionColumn = this._table.versionColumnPhysical;
-		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where, void 0, versionColumn);
+		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where, this._onUpdateIncOps(), versionColumn);
 		this._log(sql, params);
 		const result = await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)));
 		return {
@@ -1196,8 +1229,8 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 		this._log(sql, where.params);
 		return { deletedCount: (await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, where.params)))).changes };
 	}
-	async deleteMany(filter) {
-		const where = buildWhere(filter);
+	async deleteMany(filter, opts) {
+		const where = this._boundedWhere(buildWhere(filter), opts?.limit);
 		const { sql, params } = buildDelete$1(this.resolveTableName(), where);
 		this._log(sql, params);
 		return { deletedCount: (await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)))).changes };
@@ -1493,30 +1526,33 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 		});
 	}
 	async syncIndexes() {
-		return this._withExclusiveConnection(async () => {
-			const tableName = this.resolveTableName();
-			await this.syncIndexesWithDiff({
-				listExisting: async () => this.driver.all(`PRAGMA index_list("${esc(tableName)}")`).filter((i) => !i.name.startsWith("sqlite_")).map((i) => ({
-					name: i.name,
-					columns: this.driver.all(`PRAGMA index_info("${esc(i.name)}")`).map((c) => c.name).filter((n) => n !== null)
-				})),
-				createIndex: async (index) => {
-					const unique = index.type === "unique" ? "UNIQUE " : "";
-					const cols = index.fields.map((f) => `"${esc(f.name)}" ${f.sort === "desc" ? "DESC" : "ASC"}`).join(", ");
-					const sql = `CREATE ${unique}INDEX IF NOT EXISTS "${esc(index.key)}" ON "${esc(tableName)}" (${cols})`;
-					this._log(sql);
-					this.driver.exec(sql);
-				},
-				dropIndex: async (name) => {
-					const sql = `DROP INDEX IF EXISTS "${esc(name)}"`;
-					this._log(sql);
-					this.driver.exec(sql);
-				},
-				shouldSkipType: (type) => type === "fulltext" || type === "geo"
-			});
-			this._syncFtsIndexes(tableName);
-			this._syncVecIndexes(tableName);
+		return this._withExclusiveConnection(() => this._syncIndexes(false));
+	}
+	async _syncIndexes(dryRun) {
+		const tableName = this.resolveTableName();
+		const changes = await this.syncIndexesWithDiff({
+			dryRun,
+			listExisting: async () => this.driver.all(`PRAGMA index_list("${esc(tableName)}")`).filter((i) => !i.name.startsWith("sqlite_")).map((i) => ({
+				name: i.name,
+				columns: this.driver.all(`PRAGMA index_info("${esc(i.name)}")`).map((c) => c.name).filter((n) => n !== null)
+			})),
+			createIndex: async (index) => {
+				const unique = index.type === "unique" ? "UNIQUE " : "";
+				const cols = index.fields.map((f) => `"${esc(f.name)}" ${f.sort === "desc" ? "DESC" : "ASC"}`).join(", ");
+				const sql = `CREATE ${unique}INDEX IF NOT EXISTS "${esc(index.key)}" ON "${esc(tableName)}" (${cols})`;
+				this._log(sql);
+				this.driver.exec(sql);
+			},
+			dropIndex: async (name) => {
+				const sql = `DROP INDEX IF EXISTS "${esc(name)}"`;
+				this._log(sql);
+				this.driver.exec(sql);
+			},
+			skipIndex: (index) => index.type === "fulltext" || index.type === "geo" ? null : void 0
 		});
+		changes.push(...await this._syncFtsIndexes(tableName, dryRun));
+		changes.push(...await this._syncVecIndexes(tableName, dryRun));
+		return changes;
 	}
 	getSearchIndexes() {
 		const indexes = [];
@@ -1685,20 +1721,31 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 	/**
 	* Creates/drops FTS5 virtual tables and sync triggers to match desired fulltext indexes.
 	*/
-	_syncFtsIndexes(tableName) {
+	async _syncFtsIndexes(tableName, dryRun) {
+		const { changes, apply } = createChangeRecorder(dryRun);
 		const ftIndexes = this._getFulltextIndexes().filter((idx) => splitFulltextFields(idx).text.length > 0);
 		const desiredFtsTables = new Set(ftIndexes.map((idx) => this._ftsTableName(idx.name)));
-		const existingFts = this.driver.all(`SELECT name, sql FROM sqlite_master WHERE type='table' AND name LIKE ?`, [`${tableName}__fts__%`]).filter((r) => r.sql.startsWith("CREATE VIRTUAL TABLE")).map((r) => r.name);
-		for (const name of existingFts) if (!desiredFtsTables.has(name)) this._dropFtsTable(name);
+		const existingFts = this._listShadowTables(tableName, "fts");
+		for (const name of existingFts) if (!desiredFtsTables.has(name)) await apply({
+			name,
+			action: "drop"
+		}, name, () => this._dropFtsTable(name));
 		const existingSet = new Set(existingFts);
 		for (const index of ftIndexes) {
 			const ftsTable = this._ftsTableName(index.name);
-			if (!existingSet.has(ftsTable)) this._createFtsTable(tableName, ftsTable, index);
-			else if (!this._ftsColumnsMatch(ftsTable, index)) {
+			if (!existingSet.has(ftsTable)) await apply({
+				name: ftsTable,
+				action: "add"
+			}, ftsTable, () => this._createFtsTable(tableName, ftsTable, index));
+			else if (!this._ftsColumnsMatch(ftsTable, index)) await apply({
+				name: ftsTable,
+				action: "rebuild"
+			}, ftsTable, () => {
 				this._dropFtsTable(ftsTable);
 				this._createFtsTable(tableName, ftsTable, index);
-			}
+			});
 		}
+		return changes;
 	}
 	/** Whether an existing FTS5 table has exactly the index's text columns, in order. */
 	_ftsColumnsMatch(ftsTable, index) {
@@ -1929,21 +1976,29 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 	/**
 	* Creates/drops vec0 virtual shadow tables and sync triggers to match desired vector fields.
 	*/
-	_syncVecIndexes(tableName) {
-		if (this._vectorFields.size === 0) return;
+	async _syncVecIndexes(tableName, dryRun) {
+		const { changes, apply } = createChangeRecorder(dryRun);
+		if (this._vectorFields.size === 0) return changes;
 		if (!this._detectVectorSupport()) {
 			this._log("[atscript-db-sqlite] sqlite-vec not available, skipping vec0 shadow table sync (vector fields stored as JSON)");
-			return;
+			return changes;
 		}
 		const desiredVecTables = /* @__PURE__ */ new Map();
 		for (const [fieldPath, meta] of this._vectorFields.entries()) desiredVecTables.set(this._vecTableName(meta.indexName), {
 			field: fieldPath,
 			meta
 		});
-		const existingVec = this.driver.all(`SELECT name, sql FROM sqlite_master WHERE type='table' AND name LIKE ?`, [`${tableName}__vec__%`]).filter((r) => r.sql.startsWith("CREATE VIRTUAL TABLE")).map((r) => r.name);
-		for (const name of existingVec) if (!desiredVecTables.has(name)) this._dropVecTable(name);
+		const existingVec = this._listShadowTables(tableName, "vec");
+		for (const name of existingVec) if (!desiredVecTables.has(name)) await apply({
+			name,
+			action: "drop"
+		}, name, () => this._dropVecTable(name));
 		const existingSet = new Set(existingVec);
-		for (const [vecTable, { field, meta }] of desiredVecTables.entries()) if (!existingSet.has(vecTable)) this._createVecTable(tableName, vecTable, field, meta);
+		for (const [vecTable, { field, meta }] of desiredVecTables.entries()) if (!existingSet.has(vecTable)) await apply({
+			name: vecTable,
+			action: "add"
+		}, vecTable, () => this._createVecTable(tableName, vecTable, field, meta));
+		return changes;
 	}
 	/** Creates a vec0 virtual shadow table with sync triggers and seeds it from existing rows. */
 	_createVecTable(tableName, vecTable, field, vec) {
@@ -2033,8 +2088,7 @@ function andWhere(left, right) {
 *  PRAGMA returns `'active'` (SQL-quoted), we store `active` (raw). */
 function normalizeSqliteDefault(value) {
 	if (value === null) return;
-	if (value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1);
-	return value;
+	return unquoteSqlStringLiteral(value) ?? value;
 }
 //#endregion
 //#region src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-sqlite",
-  "version": "0.1.161",
+  "version": "0.1.163",
   "description": "SQLite adapter for @atscript/db with swappable driver support.",
   "keywords": [
     "atscript",
@@ -36,21 +36,21 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.108",
-    "@atscript/typescript": "^0.1.108",
+    "@atscript/core": "^0.1.109",
+    "@atscript/typescript": "^0.1.109",
     "@types/better-sqlite3": "^7.6.13",
     "@uniqu/core": "^0.1.15",
     "better-sqlite3": "^12.6.2",
     "sqlite-vec": "^0.1.9",
-    "unplugin-atscript": "^0.1.108"
+    "unplugin-atscript": "^0.1.109"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.108",
-    "@atscript/typescript": "^0.1.108",
+    "@atscript/core": "^0.1.109",
+    "@atscript/typescript": "^0.1.109",
     "@uniqu/core": "^0.1.15",
     "better-sqlite3": ">=11.0.0",
-    "@atscript/db-sql-tools": "^0.1.161",
-    "@atscript/db": "^0.1.161"
+    "@atscript/db": "^0.1.163",
+    "@atscript/db-sql-tools": "^0.1.163"
   },
   "peerDependenciesMeta": {
     "better-sqlite3": {