@atscript/db-sqlite 0.1.146 → 0.1.148

package/dist/index.cjs

@@ -78,7 +78,9 @@ var BetterSqlite3Driver = class {
 	registerFunction(name, fn, opts) {
 		this.db.function(name, { deterministic: opts?.deterministic ?? false }, fn);
 	}
+	/** Idempotent: closing an already closed database is a no-op. */
 	close() {
+		if (!this.db.open) return;
 		this.db.close();
 	}
 };
@@ -86,7 +88,8 @@ var BetterSqlite3Driver = class {
 //#region src/calendar-bucket.ts
 /**
 * Name of the scalar SQL function the adapter registers on its driver:
-* `atscript_bucket(value, unit, tz, weekStart)` → TEXT `'YYYY-MM-DD'` or NULL.
+* `atscript_bucket(value, unit, tz, weekStart)` → TEXT `'YYYY-MM-DD'`
+* (`'YYYY-MM-DDTHH:00'` for unit `hour`) or NULL.
 */
 const SQLITE_BUCKET_FN = "atscript_bucket";
 /**
@@ -287,6 +290,7 @@ const sqliteDialect = {
 	},
 	calendarBucket: sqliteCalendarBucket,
 	jsonExtract: sqliteJsonExtract,
+	castDouble: (expr) => `CAST(${expr} AS REAL)`,
 	createViewPrefix: "CREATE VIEW IF NOT EXISTS"
 };
 /**
@@ -438,8 +442,9 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 		colDefs.push(`PRIMARY KEY (${pkCols})`);
 	}
 	if (foreignKeys) for (const fk of foreignKeys.values()) {
-		const localCols = fk.fields.map((f) => `"${esc(f)}"`).join(", ");
-		const targetCols = fk.targetFields.map((f) => `"${esc(f)}"`).join(", ");
+		const { fields, targetFields } = (0, _atscript_db.fkColumns)(fk);
+		const localCols = fields.map((f) => `"${esc(f)}"`).join(", ");
+		const targetCols = targetFields.map((f) => `"${esc(f)}"`).join(", ");
 		let constraint = `FOREIGN KEY (${localCols}) REFERENCES "${esc(fk.targetTable)}" (${targetCols})`;
 		if (fk.onDelete) constraint += ` ON DELETE ${(0, _atscript_db_sql_tools.refActionToSql)(fk.onDelete)}`;
 		if (fk.onUpdate) constraint += ` ON UPDATE ${(0, _atscript_db_sql_tools.refActionToSql)(fk.onUpdate)}`;
@@ -452,23 +457,28 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 /**
 * Translates a uniqu filter expression into a parameterized SQL WHERE clause.
 *
+* Relational predicates (`$some` / `$none`) render as correlated `EXISTS`
+* subqueries referencing the outer table by `opts.qualifier` (default: the
+* source table name) — a statement with an aliased FROM must pass its alias.
+*
+* @param opts - since 0.1.147
 * @returns `{ sql, params }` — the WHERE clause (without "WHERE") and bound params.
 *          Returns `{ sql: '1=1', params: [] }` for empty/null filters.
 */
-function buildWhere(filter) {
-	return (0, _atscript_db_sql_tools.buildWhere)(sqliteDialect, filter);
+function buildWhere(filter, opts) {
+	return (0, _atscript_db_sql_tools.buildWhere)(sqliteDialect, filter, opts);
 }
 /**
 * Like {@link buildWhere} but prefixes all column references with a table alias.
 * Produces `alias."col"` instead of `"col"` — needed for JOINed queries (e.g. FTS5 search).
+* Relational predicates correlate to the same alias (since 0.1.147); their
+* own subquery aliases stay unprefixed.
 */
 function buildPrefixedWhere(alias, filter) {
-	return (0, _atscript_db_sql_tools.buildWhere)({
-		...sqliteDialect,
-		quoteIdentifier(name) {
-			return `${alias}."${esc(name)}"`;
-		}
-	}, filter);
+	return (0, _atscript_db_sql_tools.buildWhere)(sqliteDialect, filter, {
+		columnRef: (name) => `${alias}."${esc(name)}"`,
+		qualifier: alias
+	});
 }
 //#endregion
 //#region src/tx-gate.ts
@@ -706,10 +716,18 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 	calendarBucketUnits() {
 		return this._hasBucketFn ? _atscript_db.ALL_BUCKET_UNITS : super.calendarBucketUnits();
 	}
-	/** Every aggregate function, `countDistinct` included. */
+	/** Every aggregate function: `countDistinct`, `first` and `last` included. */
 	aggregateFns() {
 		return _atscript_db.ALL_AGGREGATE_FNS;
 	}
+	/** Arithmetic in an aggregate `$select` (`{ $expr }`, `{ $fn, $expr }`). */
+	supportsAggregateExpressions() {
+		return true;
+	}
+	/** Computed view columns and first-row joins. */
+	viewCapabilities() {
+		return _atscript_db.ALL_VIEW_CAPABILITIES;
+	}
 	/** Whether the SQLite connection has the sqlite-vec extension loaded. */
 	_supportsVector;
 	/** Whether SQLite math functions (radians/asin/...) are available — geo search. */
@@ -865,6 +883,15 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 	resolveTableName() {
 		return super.resolveTableName(false);
 	}
+	/**
+	* Relational predicates (`$some` / `$none`) render as correlated
+	* `[NOT] EXISTS` subqueries — in reads and in mutation filters alike.
+	*
+	* @since 0.1.147
+	*/
+	supportsRelationFilters(_mode) {
+		return true;
+	}
 	/** SQLite enforces FK constraints natively via PRAGMA foreign_keys. */
 	supportsNativeForeignKeys() {
 		return true;
@@ -919,6 +946,29 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 			};
 		});
 	}
+	supportsInsertIgnore() {
+		return true;
+	}
+	/**
+	* Per row `INSERT … ON CONFLICT DO NOTHING` (covers the primary key and every
+	* unique index; NOT NULL / CHECK / FK still raise — never `INSERT OR IGNORE`).
+	* `changes === 0` marks a skipped row.
+	*/
+	async insertManyIgnore(data) {
+		return this.withTransaction(async () => {
+			const slots = [];
+			const tableName = this.resolveTableName();
+			for (const row of data) {
+				const built = buildInsert(tableName, row);
+				const sql = `${built.sql} ON CONFLICT DO NOTHING`;
+				const params = built.params;
+				this._log(sql, params);
+				const result = await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)));
+				slots.push(result.changes === 0 ? null : { insertedId: this._resolveInsertedId(row, result.lastInsertRowid) });
+			}
+			return slots;
+		});
+	}
 	async findOne(query) {
 		const where = buildWhere(query.filter);
 		const controls = {
@@ -935,6 +985,16 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 		this._log(sql, params);
 		return this._stmt(() => this.driver.all(sql, params));
 	}
+	/**
+	* `$skip` / `$limit` per partition in one statement: a `ROW_NUMBER()`
+	* window over `partitionBy` (the generic `$with` loader's per-parent page).
+	*/
+	async findManyPerPartition(query, partitionBy) {
+		const where = buildWhere(query.filter);
+		const { sql, params } = (0, _atscript_db_sql_tools.buildPartitionedSelect)(sqliteDialect, this.resolveTableName(), where, query.controls, partitionBy);
+		this._log(sql, params);
+		return (0, _atscript_db_sql_tools.stripPartitionRowNumber)(await this._stmt(() => this.driver.all(sql, params)));
+	}
 	async count(query) {
 		const where = buildWhere(query.filter);
 		const sql = `SELECT COUNT(*) as cnt FROM "${esc(this.resolveTableName())}" WHERE ${where.sql}`;
@@ -1658,7 +1718,7 @@ var SqliteAdapter = class SqliteAdapter extends _atscript_db.BaseDbAdapter {
 		const controls = query.controls ?? {};
 		return {
 			tableName: this.resolveTableName(),
-			where: buildWhere(query.filter),
+			where: buildWhere(query.filter, { qualifier: sqliteDialect.quoteTable(_atscript_db_sql_tools.SEARCH_SOURCE_ALIAS) }),
 			dist: haversineDistanceExpr(`"${esc(column)}"`, point),
 			window: (0, _atscript_db_sql_tools.geoWindowFromControls)(controls),
 			controls
@@ -1790,7 +1850,7 @@ function createAdapter(connection, options) {
 		transactionWaitTimeoutMs,
 		transactionWaitWarnMs
 	};
-	return new _atscript_db.DbSpace(() => new SqliteAdapter(driver, adapterOptions));
+	return new _atscript_db.DbSpace(() => new SqliteAdapter(driver, adapterOptions), { onClose: () => driver.close() });
 }
 //#endregion
 exports.BetterSqlite3Driver = BetterSqlite3Driver;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair } from "@atscript/db";
+import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
 import { TMetadataMap } from "@atscript/typescript/utils";
 import { FilterExpr as FilterExpr$1 } from "@uniqu/core";
-import { TSqlFragment, TSqlFragment as TSqlFragment$1 } from "@atscript/db-sql-tools";
+import { TFilterVisitorOptions, TSqlFragment, TSqlFragment as TSqlFragment$1 } from "@atscript/db-sql-tools";
 
 //#region src/types.d.ts
 /**
@@ -121,6 +121,7 @@ declare class BetterSqlite3Driver implements TSqliteDriver {
   registerFunction(name: string, fn: (...args: any[]) => unknown, opts?: {
     deterministic?: boolean;
   }): void;
+  /** Idempotent: closing an already closed database is a no-op. */
   close(): void;
 }
 //#endregion
@@ -267,8 +268,12 @@ declare class SqliteAdapter extends BaseDbAdapter {
    * none otherwise (`BUCKET_NOT_SUPPORTED`, a clean 400).
    */
   calendarBucketUnits(): ReadonlySet<BucketUnit>;
-  /** Every aggregate function, `countDistinct` included. */
+  /** Every aggregate function: `countDistinct`, `first` and `last` included. */
   aggregateFns(): ReadonlySet<AggregateFn>;
+  /** Arithmetic in an aggregate `$select` (`{ $expr }`, `{ $fn, $expr }`). */
+  supportsAggregateExpressions(): boolean;
+  /** Computed view columns and first-row joins. */
+  viewCapabilities(): ReadonlySet<TViewCapability>;
   /** Whether the SQLite connection has the sqlite-vec extension loaded. */
   private _supportsVector;
   /** Whether SQLite math functions (radians/asin/...) are available — geo search. */
@@ -319,6 +324,13 @@ declare class SqliteAdapter extends BaseDbAdapter {
   protected _rollbackTransaction(state: unknown): Promise<void>;
   /** SQLite does not use schemas — override to always exclude schema. */
   resolveTableName(): string;
+  /**
+   * Relational predicates (`$some` / `$none`) render as correlated
+   * `[NOT] EXISTS` subqueries — in reads and in mutation filters alike.
+   *
+   * @since 0.1.147
+   */
+  supportsRelationFilters(_mode: "read" | "write"): boolean;
   /** SQLite enforces FK constraints natively via PRAGMA foreign_keys. */
   supportsNativeForeignKeys(): boolean;
   prepareId(id: unknown, _fieldType: unknown): unknown;
@@ -329,8 +341,20 @@ declare class SqliteAdapter extends BaseDbAdapter {
   private _wrapConstraintError;
   insertOne(data: Record<string, unknown>): Promise<TDbInsertResult>;
   insertMany(data: Array<Record<string, unknown>>): Promise<TDbInsertManyResult>;
+  supportsInsertIgnore(): boolean;
+  /**
+   * Per row `INSERT … ON CONFLICT DO NOTHING` (covers the primary key and every
+   * unique index; NOT NULL / CHECK / FK still raise — never `INSERT OR IGNORE`).
+   * `changes === 0` marks a skipped row.
+   */
+  insertManyIgnore(data: Array<Record<string, unknown>>): Promise<TDbInsertIgnoreSlot[]>;
   findOne(query: DbQuery): Promise<Record<string, unknown> | null>;
   findMany(query: DbQuery): Promise<Array<Record<string, unknown>>>;
+  /**
+   * `$skip` / `$limit` per partition in one statement: a `ROW_NUMBER()`
+   * window over `partitionBy` (the generic `$with` loader's per-parent page).
+   */
+  findManyPerPartition(query: DbQuery, partitionBy: readonly string[]): Promise<Array<Record<string, unknown>>>;
   count(query: DbQuery): Promise<number>;
   aggregate(query: DbQuery): Promise<Array<Record<string, unknown>>>;
   updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number): Promise<TDbUpdateResult>;
@@ -488,10 +512,15 @@ declare class SqliteAdapter extends BaseDbAdapter {
 /**
  * Translates a uniqu filter expression into a parameterized SQL WHERE clause.
  *
+ * Relational predicates (`$some` / `$none`) render as correlated `EXISTS`
+ * subqueries referencing the outer table by `opts.qualifier` (default: the
+ * source table name) — a statement with an aliased FROM must pass its alias.
+ *
+ * @param opts - since 0.1.147
  * @returns `{ sql, params }` — the WHERE clause (without "WHERE") and bound params.
  *          Returns `{ sql: '1=1', params: [] }` for empty/null filters.
  */
-declare function buildWhere(filter: FilterExpr$1): TSqlFragment$1;
+declare function buildWhere(filter: FilterExpr$1, opts?: TFilterVisitorOptions): TSqlFragment$1;
 //#endregion
 //#region src/index.d.ts
 /** `createAdapter` options: driver options plus the transaction-gate options (since 0.1.128). */

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair } from "@atscript/db";
-import { TSqlFragment, TSqlFragment as TSqlFragment$1 } from "@atscript/db-sql-tools";
+import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, 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";
 
@@ -121,6 +121,7 @@ declare class BetterSqlite3Driver implements TSqliteDriver {
   registerFunction(name: string, fn: (...args: any[]) => unknown, opts?: {
     deterministic?: boolean;
   }): void;
+  /** Idempotent: closing an already closed database is a no-op. */
   close(): void;
 }
 //#endregion
@@ -267,8 +268,12 @@ declare class SqliteAdapter extends BaseDbAdapter {
    * none otherwise (`BUCKET_NOT_SUPPORTED`, a clean 400).
    */
   calendarBucketUnits(): ReadonlySet<BucketUnit>;
-  /** Every aggregate function, `countDistinct` included. */
+  /** Every aggregate function: `countDistinct`, `first` and `last` included. */
   aggregateFns(): ReadonlySet<AggregateFn>;
+  /** Arithmetic in an aggregate `$select` (`{ $expr }`, `{ $fn, $expr }`). */
+  supportsAggregateExpressions(): boolean;
+  /** Computed view columns and first-row joins. */
+  viewCapabilities(): ReadonlySet<TViewCapability>;
   /** Whether the SQLite connection has the sqlite-vec extension loaded. */
   private _supportsVector;
   /** Whether SQLite math functions (radians/asin/...) are available — geo search. */
@@ -319,6 +324,13 @@ declare class SqliteAdapter extends BaseDbAdapter {
   protected _rollbackTransaction(state: unknown): Promise<void>;
   /** SQLite does not use schemas — override to always exclude schema. */
   resolveTableName(): string;
+  /**
+   * Relational predicates (`$some` / `$none`) render as correlated
+   * `[NOT] EXISTS` subqueries — in reads and in mutation filters alike.
+   *
+   * @since 0.1.147
+   */
+  supportsRelationFilters(_mode: "read" | "write"): boolean;
   /** SQLite enforces FK constraints natively via PRAGMA foreign_keys. */
   supportsNativeForeignKeys(): boolean;
   prepareId(id: unknown, _fieldType: unknown): unknown;
@@ -329,8 +341,20 @@ declare class SqliteAdapter extends BaseDbAdapter {
   private _wrapConstraintError;
   insertOne(data: Record<string, unknown>): Promise<TDbInsertResult>;
   insertMany(data: Array<Record<string, unknown>>): Promise<TDbInsertManyResult>;
+  supportsInsertIgnore(): boolean;
+  /**
+   * Per row `INSERT … ON CONFLICT DO NOTHING` (covers the primary key and every
+   * unique index; NOT NULL / CHECK / FK still raise — never `INSERT OR IGNORE`).
+   * `changes === 0` marks a skipped row.
+   */
+  insertManyIgnore(data: Array<Record<string, unknown>>): Promise<TDbInsertIgnoreSlot[]>;
   findOne(query: DbQuery): Promise<Record<string, unknown> | null>;
   findMany(query: DbQuery): Promise<Array<Record<string, unknown>>>;
+  /**
+   * `$skip` / `$limit` per partition in one statement: a `ROW_NUMBER()`
+   * window over `partitionBy` (the generic `$with` loader's per-parent page).
+   */
+  findManyPerPartition(query: DbQuery, partitionBy: readonly string[]): Promise<Array<Record<string, unknown>>>;
   count(query: DbQuery): Promise<number>;
   aggregate(query: DbQuery): Promise<Array<Record<string, unknown>>>;
   updateOne(filter: FilterExpr, data: Record<string, unknown>, ops?: TFieldOps, expectedVersion?: number): Promise<TDbUpdateResult>;
@@ -488,10 +512,15 @@ declare class SqliteAdapter extends BaseDbAdapter {
 /**
  * Translates a uniqu filter expression into a parameterized SQL WHERE clause.
  *
+ * Relational predicates (`$some` / `$none`) render as correlated `EXISTS`
+ * subqueries referencing the outer table by `opts.qualifier` (default: the
+ * source table name) — a statement with an aliased FROM must pass its alias.
+ *
+ * @param opts - since 0.1.147
  * @returns `{ sql, params }` — the WHERE clause (without "WHERE") and bound params.
  *          Returns `{ sql: '1=1', params: [] }` for empty/null filters.
  */
-declare function buildWhere(filter: FilterExpr$1): TSqlFragment$1;
+declare function buildWhere(filter: FilterExpr$1, opts?: TFilterVisitorOptions): TSqlFragment$1;
 //#endregion
 //#region src/index.d.ts
 /** `createAdapter` options: driver options plus the transaction-gate options (since 0.1.128). */

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
-import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, BaseDbAdapter, DbError, DbSpace, searchIndexNotFoundMessage, vectorIndexNotFoundMessage } from "@atscript/db";
+import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, BaseDbAdapter, DbError, DbSpace, fkColumns, searchIndexNotFoundMessage, vectorIndexNotFoundMessage } from "@atscript/db";
 import { resolveAggregateSearch } from "@atscript/db/agg";
-import { EMPTY_AND, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, geoWindowFromControls, jsonDollarPath, parseRegexString, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlTimeZoneLiteral, toSqlValue } from "@atscript/db-sql-tools";
+import { EMPTY_AND, SEARCH_SOURCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildPartitionedSelect, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, geoWindowFromControls, jsonDollarPath, parseRegexString, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlTimeZoneLiteral, stripPartitionRowNumber, toSqlValue } from "@atscript/db-sql-tools";
 import { bucketer } from "@uniqu/core";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/better-sqlite3-driver.ts
@@ -77,7 +77,9 @@ var BetterSqlite3Driver = class {
 	registerFunction(name, fn, opts) {
 		this.db.function(name, { deterministic: opts?.deterministic ?? false }, fn);
 	}
+	/** Idempotent: closing an already closed database is a no-op. */
 	close() {
+		if (!this.db.open) return;
 		this.db.close();
 	}
 };
@@ -85,7 +87,8 @@ var BetterSqlite3Driver = class {
 //#region src/calendar-bucket.ts
 /**
 * Name of the scalar SQL function the adapter registers on its driver:
-* `atscript_bucket(value, unit, tz, weekStart)` → TEXT `'YYYY-MM-DD'` or NULL.
+* `atscript_bucket(value, unit, tz, weekStart)` → TEXT `'YYYY-MM-DD'`
+* (`'YYYY-MM-DDTHH:00'` for unit `hour`) or NULL.
 */
 const SQLITE_BUCKET_FN = "atscript_bucket";
 /**
@@ -286,6 +289,7 @@ const sqliteDialect = {
 	},
 	calendarBucket: sqliteCalendarBucket,
 	jsonExtract: sqliteJsonExtract,
+	castDouble: (expr) => `CAST(${expr} AS REAL)`,
 	createViewPrefix: "CREATE VIEW IF NOT EXISTS"
 };
 /**
@@ -437,8 +441,9 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 		colDefs.push(`PRIMARY KEY (${pkCols})`);
 	}
 	if (foreignKeys) for (const fk of foreignKeys.values()) {
-		const localCols = fk.fields.map((f) => `"${esc(f)}"`).join(", ");
-		const targetCols = fk.targetFields.map((f) => `"${esc(f)}"`).join(", ");
+		const { fields, targetFields } = fkColumns(fk);
+		const localCols = fields.map((f) => `"${esc(f)}"`).join(", ");
+		const targetCols = targetFields.map((f) => `"${esc(f)}"`).join(", ");
 		let constraint = `FOREIGN KEY (${localCols}) REFERENCES "${esc(fk.targetTable)}" (${targetCols})`;
 		if (fk.onDelete) constraint += ` ON DELETE ${refActionToSql(fk.onDelete)}`;
 		if (fk.onUpdate) constraint += ` ON UPDATE ${refActionToSql(fk.onUpdate)}`;
@@ -451,23 +456,28 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 /**
 * Translates a uniqu filter expression into a parameterized SQL WHERE clause.
 *
+* Relational predicates (`$some` / `$none`) render as correlated `EXISTS`
+* subqueries referencing the outer table by `opts.qualifier` (default: the
+* source table name) — a statement with an aliased FROM must pass its alias.
+*
+* @param opts - since 0.1.147
 * @returns `{ sql, params }` — the WHERE clause (without "WHERE") and bound params.
 *          Returns `{ sql: '1=1', params: [] }` for empty/null filters.
 */
-function buildWhere(filter) {
-	return buildWhere$1(sqliteDialect, filter);
+function buildWhere(filter, opts) {
+	return buildWhere$1(sqliteDialect, filter, opts);
 }
 /**
 * Like {@link buildWhere} but prefixes all column references with a table alias.
 * Produces `alias."col"` instead of `"col"` — needed for JOINed queries (e.g. FTS5 search).
+* Relational predicates correlate to the same alias (since 0.1.147); their
+* own subquery aliases stay unprefixed.
 */
 function buildPrefixedWhere(alias, filter) {
-	return buildWhere$1({
-		...sqliteDialect,
-		quoteIdentifier(name) {
-			return `${alias}."${esc(name)}"`;
-		}
-	}, filter);
+	return buildWhere$1(sqliteDialect, filter, {
+		columnRef: (name) => `${alias}."${esc(name)}"`,
+		qualifier: alias
+	});
 }
 //#endregion
 //#region src/tx-gate.ts
@@ -705,10 +715,18 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 	calendarBucketUnits() {
 		return this._hasBucketFn ? ALL_BUCKET_UNITS : super.calendarBucketUnits();
 	}
-	/** Every aggregate function, `countDistinct` included. */
+	/** Every aggregate function: `countDistinct`, `first` and `last` included. */
 	aggregateFns() {
 		return ALL_AGGREGATE_FNS;
 	}
+	/** Arithmetic in an aggregate `$select` (`{ $expr }`, `{ $fn, $expr }`). */
+	supportsAggregateExpressions() {
+		return true;
+	}
+	/** Computed view columns and first-row joins. */
+	viewCapabilities() {
+		return ALL_VIEW_CAPABILITIES;
+	}
 	/** Whether the SQLite connection has the sqlite-vec extension loaded. */
 	_supportsVector;
 	/** Whether SQLite math functions (radians/asin/...) are available — geo search. */
@@ -864,6 +882,15 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 	resolveTableName() {
 		return super.resolveTableName(false);
 	}
+	/**
+	* Relational predicates (`$some` / `$none`) render as correlated
+	* `[NOT] EXISTS` subqueries — in reads and in mutation filters alike.
+	*
+	* @since 0.1.147
+	*/
+	supportsRelationFilters(_mode) {
+		return true;
+	}
 	/** SQLite enforces FK constraints natively via PRAGMA foreign_keys. */
 	supportsNativeForeignKeys() {
 		return true;
@@ -918,6 +945,29 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 			};
 		});
 	}
+	supportsInsertIgnore() {
+		return true;
+	}
+	/**
+	* Per row `INSERT … ON CONFLICT DO NOTHING` (covers the primary key and every
+	* unique index; NOT NULL / CHECK / FK still raise — never `INSERT OR IGNORE`).
+	* `changes === 0` marks a skipped row.
+	*/
+	async insertManyIgnore(data) {
+		return this.withTransaction(async () => {
+			const slots = [];
+			const tableName = this.resolveTableName();
+			for (const row of data) {
+				const built = buildInsert$1(tableName, row);
+				const sql = `${built.sql} ON CONFLICT DO NOTHING`;
+				const params = built.params;
+				this._log(sql, params);
+				const result = await this._stmt(() => this._wrapConstraintError(() => this.driver.run(sql, params)));
+				slots.push(result.changes === 0 ? null : { insertedId: this._resolveInsertedId(row, result.lastInsertRowid) });
+			}
+			return slots;
+		});
+	}
 	async findOne(query) {
 		const where = buildWhere(query.filter);
 		const controls = {
@@ -934,6 +984,16 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 		this._log(sql, params);
 		return this._stmt(() => this.driver.all(sql, params));
 	}
+	/**
+	* `$skip` / `$limit` per partition in one statement: a `ROW_NUMBER()`
+	* window over `partitionBy` (the generic `$with` loader's per-parent page).
+	*/
+	async findManyPerPartition(query, partitionBy) {
+		const where = buildWhere(query.filter);
+		const { sql, params } = buildPartitionedSelect(sqliteDialect, this.resolveTableName(), where, query.controls, partitionBy);
+		this._log(sql, params);
+		return stripPartitionRowNumber(await this._stmt(() => this.driver.all(sql, params)));
+	}
 	async count(query) {
 		const where = buildWhere(query.filter);
 		const sql = `SELECT COUNT(*) as cnt FROM "${esc(this.resolveTableName())}" WHERE ${where.sql}`;
@@ -1657,7 +1717,7 @@ var SqliteAdapter = class SqliteAdapter extends BaseDbAdapter {
 		const controls = query.controls ?? {};
 		return {
 			tableName: this.resolveTableName(),
-			where: buildWhere(query.filter),
+			where: buildWhere(query.filter, { qualifier: sqliteDialect.quoteTable(SEARCH_SOURCE_ALIAS) }),
 			dist: haversineDistanceExpr(`"${esc(column)}"`, point),
 			window: geoWindowFromControls(controls),
 			controls
@@ -1789,7 +1849,7 @@ function createAdapter(connection, options) {
 		transactionWaitTimeoutMs,
 		transactionWaitWarnMs
 	};
-	return new DbSpace(() => new SqliteAdapter(driver, adapterOptions));
+	return new DbSpace(() => new SqliteAdapter(driver, adapterOptions), { onClose: () => driver.close() });
 }
 //#endregion
 export { BetterSqlite3Driver, SqliteAdapter, SqliteTxGate, SqliteTxState, buildWhere, createAdapter, getSqliteTxGate };

package/package.json

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