@atscript/db-sql-tools 0.1.141 → 0.1.143

package/dist/index.cjs

@@ -173,113 +173,6 @@ function buildWhere(dialect, filter) {
 	return (0, _uniqu_core.walkFilter)(filter, getVisitor(dialect)) ?? EMPTY_AND;
 }
 //#endregion
-//#region src/geo.ts
-/**
-* Internal alias for the computed distance column in geo search queries.
-* Renamed to the public `$distance` pseudo-field after fetch (same convention
-* as the MongoDB adapter) — SQL identifiers starting with `$` are awkward
-* across dialects, so the public name can't be used directly.
-*/
-const GEO_DISTANCE_ALIAS = "__atscript_distance";
-/**
-* Builds a distance-ranked geo search SELECT:
-*
-* ```sql
-* SELECT * FROM (
-*   SELECT t.*, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
-* ) _g
-* WHERE __atscript_distance IS NOT NULL [AND <= ?] [AND >= ?]
-* ORDER BY __atscript_distance ASC LIMIT ? [OFFSET ?]
-* ```
-*
-* `distExpr` computes meters from the query point to the geo column (NULL for
-* rows without a point — those are excluded, matching MongoDB `$geoNear`).
-* Placeholders stay `?`-style; callers finalize for `$N` dialects.
-*/
-function buildGeoSearchSelect(dialect, table, where, distExpr, window, controls) {
-	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
-	let sql = `SELECT * FROM (${`SELECT ${dialect.quoteTable("t")}.*, ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
-	const params = [...distExpr.params, ...where.params];
-	if (window.maxDistance !== void 0) {
-		sql += ` AND ${alias} <= ?`;
-		params.push(window.maxDistance);
-	}
-	if (window.minDistance !== void 0) {
-		sql += ` AND ${alias} >= ?`;
-		params.push(window.minDistance);
-	}
-	sql += ` ORDER BY ${alias} ASC`;
-	if (controls.$limit !== void 0) {
-		sql += ` LIMIT ?`;
-		params.push(controls.$limit);
-	}
-	if (controls.$skip !== void 0) {
-		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
-		sql += ` OFFSET ?`;
-		params.push(controls.$skip);
-	}
-	return finalizeParams(dialect, {
-		sql,
-		params
-	});
-}
-/**
-* Count companion for {@link buildGeoSearchSelect} — rows inside the distance
-* window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
-*/
-function buildGeoSearchCount(dialect, table, where, distExpr, window) {
-	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
-	let sql = `SELECT COUNT(*) AS cnt FROM (${`SELECT ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
-	const params = [...distExpr.params, ...where.params];
-	if (window.maxDistance !== void 0) {
-		sql += ` AND ${alias} <= ?`;
-		params.push(window.maxDistance);
-	}
-	if (window.minDistance !== void 0) {
-		sql += ` AND ${alias} >= ?`;
-		params.push(window.minDistance);
-	}
-	return finalizeParams(dialect, {
-		sql,
-		params
-	});
-}
-/** Extracts the `$maxDistance` / `$minDistance` window from query controls. */
-function geoWindowFromControls(controls) {
-	return {
-		maxDistance: typeof controls?.$maxDistance === "number" ? controls.$maxDistance : void 0,
-		minDistance: typeof controls?.$minDistance === "number" ? controls.$minDistance : void 0
-	};
-}
-/**
-* Normalizes a write-path geo value to a `[lng, lat]` tuple. The value may be
-* the raw tuple or its JSON-string form (the relational field mapper
-* stringifies `storage: json` fields before adapter formatters run).
-* Returns `undefined` for anything else (e.g. `$geoWithin` circle objects,
-* which must pass through untouched).
-*/
-function normalizeGeoPointValue(value) {
-	let candidate = value;
-	if (typeof candidate === "string") {
-		if (!candidate.startsWith("[")) return;
-		try {
-			candidate = JSON.parse(candidate);
-		} catch {
-			return;
-		}
-	}
-	if (Array.isArray(candidate) && candidate.length === 2 && typeof candidate[0] === "number" && typeof candidate[1] === "number") return [candidate[0], candidate[1]];
-}
-/** Renames the internal distance alias to the public `$distance` field (in place). */
-function renameGeoDistance(row) {
-	if ("__atscript_distance" in row) {
-		const distance = row[GEO_DISTANCE_ALIAS];
-		delete row[GEO_DISTANCE_ALIAS];
-		row.$distance = typeof distance === "string" ? Number(distance) : distance;
-	}
-	return row;
-}
-//#endregion
 //#region src/common.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
 function sqlStringLiteral(value) {
@@ -891,16 +784,223 @@ function derivedColumnExpr(dialect, field) {
 }
 /**
 * Builds a column projection (SELECT clause fields).
+*
+* @param qualifier - optional table alias every column (and the `*`
+*   fallback) is qualified with (`"t"."col"`), for projections over a joined
+*   or aliased source such as the geo / vector search subqueries (since 0.1.143).
 */
-function buildProjection(dialect, select) {
+function buildProjection(dialect, select, qualifier) {
+	const prefix = qualifier === void 0 ? "" : `${dialect.quoteTable(qualifier)}.`;
 	const fields = select?.asArray;
-	if (!fields) return "*";
+	if (!fields) return `${prefix}*`;
 	let sql = "";
 	for (let i = 0; i < fields.length; i++) {
 		if (i > 0) sql += ", ";
-		sql += dialect.quoteIdentifier(fields[i]);
+		sql += prefix + dialect.quoteIdentifier(fields[i]);
+	}
+	return sql || `${prefix}*`;
+}
+//#endregion
+//#region src/geo.ts
+/**
+* Internal alias for the computed distance column in geo search queries.
+* Renamed to the public `$distance` pseudo-field after fetch (same convention
+* as the MongoDB adapter) — SQL identifiers starting with `$` are awkward
+* across dialects, so the public name can't be used directly.
+*/
+const GEO_DISTANCE_ALIAS = "__atscript_distance";
+/**
+* Builds a distance-ranked geo search SELECT:
+*
+* ```sql
+* SELECT * FROM (
+*   SELECT <t.cols | t.*>, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
+* ) _g
+* WHERE __atscript_distance IS NOT NULL [AND <= ?] [AND >= ?]
+* ORDER BY __atscript_distance ASC LIMIT ? [OFFSET ?]
+* ```
+*
+* `distExpr` computes meters from the query point to the geo column (NULL for
+* rows without a point — those are excluded, matching MongoDB `$geoNear`).
+* `controls.$select` projects the row columns exactly like `buildSelect` does
+* (inclusion and exclusion forms, resolved by `UniquSelect.asArray`); the
+* distance column is always returned. Placeholders stay `?`-style; callers
+* finalize for `$N` dialects.
+*/
+function buildGeoSearchSelect(dialect, table, where, distExpr, window, controls) {
+	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
+	let sql = `SELECT * FROM (${`SELECT ${buildProjection(dialect, controls.$select, "t")}, ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
+	const params = [...distExpr.params, ...where.params];
+	if (window.maxDistance !== void 0) {
+		sql += ` AND ${alias} <= ?`;
+		params.push(window.maxDistance);
+	}
+	if (window.minDistance !== void 0) {
+		sql += ` AND ${alias} >= ?`;
+		params.push(window.minDistance);
+	}
+	sql += ` ORDER BY ${alias} ASC`;
+	if (controls.$limit !== void 0) {
+		sql += ` LIMIT ?`;
+		params.push(controls.$limit);
+	}
+	if (controls.$skip !== void 0) {
+		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
+		sql += ` OFFSET ?`;
+		params.push(controls.$skip);
+	}
+	return finalizeParams(dialect, {
+		sql,
+		params
+	});
+}
+/**
+* Count companion for {@link buildGeoSearchSelect} — rows inside the distance
+* window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
+*/
+function buildGeoSearchCount(dialect, table, where, distExpr, window) {
+	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
+	let sql = `SELECT COUNT(*) AS cnt FROM (${`SELECT ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
+	const params = [...distExpr.params, ...where.params];
+	if (window.maxDistance !== void 0) {
+		sql += ` AND ${alias} <= ?`;
+		params.push(window.maxDistance);
+	}
+	if (window.minDistance !== void 0) {
+		sql += ` AND ${alias} >= ?`;
+		params.push(window.minDistance);
+	}
+	return finalizeParams(dialect, {
+		sql,
+		params
+	});
+}
+/** Extracts the `$maxDistance` / `$minDistance` window from query controls. */
+function geoWindowFromControls(controls) {
+	return {
+		maxDistance: typeof controls?.$maxDistance === "number" ? controls.$maxDistance : void 0,
+		minDistance: typeof controls?.$minDistance === "number" ? controls.$minDistance : void 0
+	};
+}
+/**
+* Normalizes a write-path geo value to a `[lng, lat]` tuple. The value may be
+* the raw tuple or its JSON-string form (the relational field mapper
+* stringifies `storage: json` fields before adapter formatters run).
+* Returns `undefined` for anything else (e.g. `$geoWithin` circle objects,
+* which must pass through untouched).
+*/
+function normalizeGeoPointValue(value) {
+	let candidate = value;
+	if (typeof candidate === "string") {
+		if (!candidate.startsWith("[")) return;
+		try {
+			candidate = JSON.parse(candidate);
+		} catch {
+			return;
+		}
 	}
-	return sql || "*";
+	if (Array.isArray(candidate) && candidate.length === 2 && typeof candidate[0] === "number" && typeof candidate[1] === "number") return [candidate[0], candidate[1]];
+}
+/** Renames the internal distance alias to the public `$distance` field (in place). */
+function renameGeoDistance(row) {
+	if ("__atscript_distance" in row) {
+		const distance = row[GEO_DISTANCE_ALIAS];
+		delete row[GEO_DISTANCE_ALIAS];
+		row.$distance = typeof distance === "string" ? Number(distance) : distance;
+	}
+	return row;
+}
+//#endregion
+//#region src/vector.ts
+/** Column every vector search row carries: the engine's distance to the query vector. */
+const VECTOR_DISTANCE_ALIAS = "_distance";
+/** Alias of the row source inside the vector search queries. */
+const SOURCE_ALIAS = "_v";
+/**
+* The row source of a vector search over a plain table:
+*
+* ```sql
+* SELECT t.*, <distExpr> AS _distance FROM <table> t WHERE <where>
+* ```
+*
+* `withRows: false` selects the distance only (the count companion).
+* Placeholders stay `?`-style.
+* @since 0.1.143
+*/
+function vectorDistanceSource(dialect, table, where, distExpr, withRows = true) {
+	const t = dialect.quoteTable("t");
+	return {
+		sql: `SELECT ${withRows ? `${t}.*, ` : ""}${distExpr.sql} AS ${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)} FROM ${dialect.quoteTable(table)} AS ${t} WHERE ${where.sql}`,
+		params: [...distExpr.params, ...where.params]
+	};
+}
+/** The outer WHERE of a vector search: the distance cap, then a residual filter over the source. */
+function outerWhere(dialect, maxDistance, residual) {
+	const parts = [];
+	const params = [];
+	if (maxDistance !== void 0) {
+		parts.push(`${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)} <= ?`);
+		params.push(maxDistance);
+	}
+	if (residual && residual.sql !== "1=1") {
+		parts.push(`(${residual.sql})`);
+		params.push(...residual.params);
+	}
+	return {
+		sql: parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "",
+		params
+	};
+}
+/**
+* Builds a distance-ranked vector search SELECT over a row source that
+* carries a `_distance` column ({@link vectorDistanceSource}, or an
+* engine-specific one such as a vector-index join):
+*
+* ```sql
+* SELECT <_v.cols, _v._distance | *> FROM (<source>) _v
+* [WHERE _distance <= ? [AND (<residual>)]]
+* ORDER BY _distance ASC LIMIT ? [OFFSET ?]
+* ```
+*
+* `$select` projects the OUTER query exactly like `buildSelect` does
+* (inclusion and exclusion forms, resolved by `UniquSelect.asArray`), so a
+* residual filter still sees every source column; `_distance` is always
+* returned. `maxDistance` is the threshold on the engine's distance scale;
+* a `residual` filter references the source's columns qualified by `_v`.
+* Placeholders are finalized for the dialect.
+* @since 0.1.143
+*/
+function buildVectorSearchSelect(dialect, source, opts) {
+	const v = dialect.quoteTable(SOURCE_ALIAS);
+	const cols = opts.select?.asArray?.length ? `${buildProjection(dialect, opts.select, SOURCE_ALIAS)}, ${v}.${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)}` : "*";
+	const where = outerWhere(dialect, opts.maxDistance, opts.residual);
+	let sql = `SELECT ${cols} FROM (${source.sql}) AS ${v}${where.sql} ORDER BY ${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)} ASC LIMIT ?`;
+	const params = [
+		...source.params,
+		...where.params,
+		opts.limit
+	];
+	if (opts.skip) {
+		sql += ` OFFSET ?`;
+		params.push(opts.skip);
+	}
+	return finalizeParams(dialect, {
+		sql,
+		params
+	});
+}
+/**
+* Count companion for {@link buildVectorSearchSelect} — rows the search
+* could return (distance cap and residual applied, pagination ignored).
+* Returns one row: `{ cnt }`.
+* @since 0.1.143
+*/
+function buildVectorSearchCount(dialect, source, opts) {
+	const where = outerWhere(dialect, opts.maxDistance, opts.residual);
+	return finalizeParams(dialect, {
+		sql: `SELECT COUNT(*) AS cnt FROM (${source.sql}) AS ${dialect.quoteTable(SOURCE_ALIAS)}${where.sql}`,
+		params: [...source.params, ...where.params]
+	});
 }
 //#endregion
 //#region src/regex.ts
@@ -933,6 +1033,7 @@ exports.EMPTY_AND = EMPTY_AND;
 exports.EMPTY_OR = EMPTY_OR;
 exports.GEO_DISTANCE_ALIAS = GEO_DISTANCE_ALIAS;
 exports.SQL_DEFAULT = SQL_DEFAULT;
+exports.VECTOR_DISTANCE_ALIAS = VECTOR_DISTANCE_ALIAS;
 exports.buildAggregateCount = buildAggregateCount;
 exports.buildAggregateSelect = buildAggregateSelect;
 exports.buildCreateView = buildCreateView;
@@ -944,6 +1045,8 @@ exports.buildInsertMany = buildInsertMany;
 exports.buildProjection = buildProjection;
 exports.buildSelect = buildSelect;
 exports.buildUpdate = buildUpdate;
+exports.buildVectorSearchCount = buildVectorSearchCount;
+exports.buildVectorSearchSelect = buildVectorSearchSelect;
 exports.buildWhere = buildWhere;
 exports.createFilterVisitor = createFilterVisitor;
 exports.defaultValueForType = defaultValueForType;
@@ -966,3 +1069,4 @@ exports.replaceColumnsFor = replaceColumnsFor;
 exports.sqlStringLiteral = sqlStringLiteral;
 exports.sqlTimeZoneLiteral = sqlTimeZoneLiteral;
 exports.toSqlValue = toSqlValue;
+exports.vectorDistanceSource = vectorDistanceSource;

package/dist/index.d.cts

@@ -135,6 +135,12 @@ declare function buildWhere(dialect: SqlDialect, filter: FilterExpr): TSqlFragme
  * across dialects, so the public name can't be used directly.
  */
 declare const GEO_DISTANCE_ALIAS = "__atscript_distance";
+/** The query controls a geo search page reads — an adapter passes its `query.controls` as-is. */
+interface TGeoSearchControls {
+  $limit?: number;
+  $skip?: number;
+  $select?: UniquSelect;
+}
 /** Distance window for geo search: `$maxDistance` / `$minDistance` in meters. */
 interface TGeoWindow {
   maxDistance?: number;
@@ -145,7 +151,7 @@ interface TGeoWindow {
  *
  * ```sql
  * SELECT * FROM (
- *   SELECT t.*, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
+ *   SELECT <t.cols | t.*>, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
  * ) _g
  * WHERE __atscript_distance IS NOT NULL [AND <= ?] [AND >= ?]
  * ORDER BY __atscript_distance ASC LIMIT ? [OFFSET ?]
@@ -153,12 +159,12 @@ interface TGeoWindow {
  *
  * `distExpr` computes meters from the query point to the geo column (NULL for
  * rows without a point — those are excluded, matching MongoDB `$geoNear`).
- * Placeholders stay `?`-style; callers finalize for `$N` dialects.
+ * `controls.$select` projects the row columns exactly like `buildSelect` does
+ * (inclusion and exclusion forms, resolved by `UniquSelect.asArray`); the
+ * distance column is always returned. Placeholders stay `?`-style; callers
+ * finalize for `$N` dialects.
  */
-declare function buildGeoSearchSelect(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow, controls: {
-  $limit?: number;
-  $skip?: number;
-}): TSqlFragment;
+declare function buildGeoSearchSelect(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow, controls: TGeoSearchControls): TSqlFragment;
 /**
  * Count companion for {@link buildGeoSearchSelect} — rows inside the distance
  * window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
@@ -177,6 +183,58 @@ declare function normalizeGeoPointValue(value: unknown): [number, number] | unde
 /** Renames the internal distance alias to the public `$distance` field (in place). */
 declare function renameGeoDistance(row: Record<string, unknown>): Record<string, unknown>;
 //#endregion
+//#region src/vector.d.ts
+/** Column every vector search row carries: the engine's distance to the query vector. */
+declare const VECTOR_DISTANCE_ALIAS = "_distance";
+/**
+ * The row source of a vector search over a plain table:
+ *
+ * ```sql
+ * SELECT t.*, <distExpr> AS _distance FROM <table> t WHERE <where>
+ * ```
+ *
+ * `withRows: false` selects the distance only (the count companion).
+ * Placeholders stay `?`-style.
+ * @since 0.1.143
+ */
+declare function vectorDistanceSource(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, withRows?: boolean): TSqlFragment;
+/**
+ * Builds a distance-ranked vector search SELECT over a row source that
+ * carries a `_distance` column ({@link vectorDistanceSource}, or an
+ * engine-specific one such as a vector-index join):
+ *
+ * ```sql
+ * SELECT <_v.cols, _v._distance | *> FROM (<source>) _v
+ * [WHERE _distance <= ? [AND (<residual>)]]
+ * ORDER BY _distance ASC LIMIT ? [OFFSET ?]
+ * ```
+ *
+ * `$select` projects the OUTER query exactly like `buildSelect` does
+ * (inclusion and exclusion forms, resolved by `UniquSelect.asArray`), so a
+ * residual filter still sees every source column; `_distance` is always
+ * returned. `maxDistance` is the threshold on the engine's distance scale;
+ * a `residual` filter references the source's columns qualified by `_v`.
+ * Placeholders are finalized for the dialect.
+ * @since 0.1.143
+ */
+declare function buildVectorSearchSelect(dialect: SqlDialect, source: TSqlFragment, opts: {
+  select?: UniquSelect;
+  limit: number;
+  skip?: number;
+  maxDistance?: number;
+  residual?: TSqlFragment;
+}): TSqlFragment;
+/**
+ * Count companion for {@link buildVectorSearchSelect} — rows the search
+ * could return (distance cap and residual applied, pagination ignored).
+ * Returns one row: `{ cnt }`.
+ * @since 0.1.143
+ */
+declare function buildVectorSearchCount(dialect: SqlDialect, source: TSqlFragment, opts: {
+  maxDistance?: number;
+  residual?: TSqlFragment;
+}): TSqlFragment;
+//#endregion
 //#region src/view-builder.d.ts
 /**
  * Builds a CREATE VIEW statement from a view plan and column mappings.
@@ -286,8 +344,12 @@ declare function buildDelete(dialect: SqlDialect, table: string, where: TSqlFrag
 declare function derivedColumnExpr(dialect: SqlDialect, field: TDbFieldMeta): string;
 /**
  * Builds a column projection (SELECT clause fields).
+ *
+ * @param qualifier - optional table alias every column (and the `*`
+ *   fallback) is qualified with (`"t"."col"`), for projections over a joined
+ *   or aliased source such as the geo / vector search subqueries (since 0.1.143).
  */
-declare function buildProjection(dialect: SqlDialect, select?: UniquSelect): string;
+declare function buildProjection(dialect: SqlDialect, select?: UniquSelect, qualifier?: string): string;
 //#endregion
 //#region src/common.d.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
@@ -384,4 +446,4 @@ declare function parseRegexString(value: unknown): {
   flags: string;
 };
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TFilterVisitorOptions, type TGeoCircle, type TGeoWindow, type TReplaceColumn, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TFilterVisitorOptions, type TGeoCircle, type TGeoSearchControls, type TGeoWindow, type TReplaceColumn, type TSqlFragment, VECTOR_DISTANCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, toSqlValue, vectorDistanceSource };

package/dist/index.d.mts

@@ -135,6 +135,12 @@ declare function buildWhere(dialect: SqlDialect, filter: FilterExpr): TSqlFragme
  * across dialects, so the public name can't be used directly.
  */
 declare const GEO_DISTANCE_ALIAS = "__atscript_distance";
+/** The query controls a geo search page reads — an adapter passes its `query.controls` as-is. */
+interface TGeoSearchControls {
+  $limit?: number;
+  $skip?: number;
+  $select?: UniquSelect;
+}
 /** Distance window for geo search: `$maxDistance` / `$minDistance` in meters. */
 interface TGeoWindow {
   maxDistance?: number;
@@ -145,7 +151,7 @@ interface TGeoWindow {
  *
  * ```sql
  * SELECT * FROM (
- *   SELECT t.*, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
+ *   SELECT <t.cols | t.*>, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
  * ) _g
  * WHERE __atscript_distance IS NOT NULL [AND <= ?] [AND >= ?]
  * ORDER BY __atscript_distance ASC LIMIT ? [OFFSET ?]
@@ -153,12 +159,12 @@ interface TGeoWindow {
  *
  * `distExpr` computes meters from the query point to the geo column (NULL for
  * rows without a point — those are excluded, matching MongoDB `$geoNear`).
- * Placeholders stay `?`-style; callers finalize for `$N` dialects.
+ * `controls.$select` projects the row columns exactly like `buildSelect` does
+ * (inclusion and exclusion forms, resolved by `UniquSelect.asArray`); the
+ * distance column is always returned. Placeholders stay `?`-style; callers
+ * finalize for `$N` dialects.
  */
-declare function buildGeoSearchSelect(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow, controls: {
-  $limit?: number;
-  $skip?: number;
-}): TSqlFragment;
+declare function buildGeoSearchSelect(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow, controls: TGeoSearchControls): TSqlFragment;
 /**
  * Count companion for {@link buildGeoSearchSelect} — rows inside the distance
  * window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
@@ -177,6 +183,58 @@ declare function normalizeGeoPointValue(value: unknown): [number, number] | unde
 /** Renames the internal distance alias to the public `$distance` field (in place). */
 declare function renameGeoDistance(row: Record<string, unknown>): Record<string, unknown>;
 //#endregion
+//#region src/vector.d.ts
+/** Column every vector search row carries: the engine's distance to the query vector. */
+declare const VECTOR_DISTANCE_ALIAS = "_distance";
+/**
+ * The row source of a vector search over a plain table:
+ *
+ * ```sql
+ * SELECT t.*, <distExpr> AS _distance FROM <table> t WHERE <where>
+ * ```
+ *
+ * `withRows: false` selects the distance only (the count companion).
+ * Placeholders stay `?`-style.
+ * @since 0.1.143
+ */
+declare function vectorDistanceSource(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, withRows?: boolean): TSqlFragment;
+/**
+ * Builds a distance-ranked vector search SELECT over a row source that
+ * carries a `_distance` column ({@link vectorDistanceSource}, or an
+ * engine-specific one such as a vector-index join):
+ *
+ * ```sql
+ * SELECT <_v.cols, _v._distance | *> FROM (<source>) _v
+ * [WHERE _distance <= ? [AND (<residual>)]]
+ * ORDER BY _distance ASC LIMIT ? [OFFSET ?]
+ * ```
+ *
+ * `$select` projects the OUTER query exactly like `buildSelect` does
+ * (inclusion and exclusion forms, resolved by `UniquSelect.asArray`), so a
+ * residual filter still sees every source column; `_distance` is always
+ * returned. `maxDistance` is the threshold on the engine's distance scale;
+ * a `residual` filter references the source's columns qualified by `_v`.
+ * Placeholders are finalized for the dialect.
+ * @since 0.1.143
+ */
+declare function buildVectorSearchSelect(dialect: SqlDialect, source: TSqlFragment, opts: {
+  select?: UniquSelect;
+  limit: number;
+  skip?: number;
+  maxDistance?: number;
+  residual?: TSqlFragment;
+}): TSqlFragment;
+/**
+ * Count companion for {@link buildVectorSearchSelect} — rows the search
+ * could return (distance cap and residual applied, pagination ignored).
+ * Returns one row: `{ cnt }`.
+ * @since 0.1.143
+ */
+declare function buildVectorSearchCount(dialect: SqlDialect, source: TSqlFragment, opts: {
+  maxDistance?: number;
+  residual?: TSqlFragment;
+}): TSqlFragment;
+//#endregion
 //#region src/view-builder.d.ts
 /**
  * Builds a CREATE VIEW statement from a view plan and column mappings.
@@ -286,8 +344,12 @@ declare function buildDelete(dialect: SqlDialect, table: string, where: TSqlFrag
 declare function derivedColumnExpr(dialect: SqlDialect, field: TDbFieldMeta): string;
 /**
  * Builds a column projection (SELECT clause fields).
+ *
+ * @param qualifier - optional table alias every column (and the `*`
+ *   fallback) is qualified with (`"t"."col"`), for projections over a joined
+ *   or aliased source such as the geo / vector search subqueries (since 0.1.143).
  */
-declare function buildProjection(dialect: SqlDialect, select?: UniquSelect): string;
+declare function buildProjection(dialect: SqlDialect, select?: UniquSelect, qualifier?: string): string;
 //#endregion
 //#region src/common.d.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
@@ -384,4 +446,4 @@ declare function parseRegexString(value: unknown): {
   flags: string;
 };
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TFilterVisitorOptions, type TGeoCircle, type TGeoWindow, type TReplaceColumn, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, SQL_DEFAULT, type SqlDialect, type TFilterVisitorOptions, type TGeoCircle, type TGeoSearchControls, type TGeoWindow, type TReplaceColumn, type TSqlFragment, VECTOR_DISTANCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, toSqlValue, vectorDistanceSource };

package/dist/index.mjs

@@ -172,113 +172,6 @@ function buildWhere(dialect, filter) {
 	return walkFilter(filter, getVisitor(dialect)) ?? EMPTY_AND;
 }
 //#endregion
-//#region src/geo.ts
-/**
-* Internal alias for the computed distance column in geo search queries.
-* Renamed to the public `$distance` pseudo-field after fetch (same convention
-* as the MongoDB adapter) — SQL identifiers starting with `$` are awkward
-* across dialects, so the public name can't be used directly.
-*/
-const GEO_DISTANCE_ALIAS = "__atscript_distance";
-/**
-* Builds a distance-ranked geo search SELECT:
-*
-* ```sql
-* SELECT * FROM (
-*   SELECT t.*, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
-* ) _g
-* WHERE __atscript_distance IS NOT NULL [AND <= ?] [AND >= ?]
-* ORDER BY __atscript_distance ASC LIMIT ? [OFFSET ?]
-* ```
-*
-* `distExpr` computes meters from the query point to the geo column (NULL for
-* rows without a point — those are excluded, matching MongoDB `$geoNear`).
-* Placeholders stay `?`-style; callers finalize for `$N` dialects.
-*/
-function buildGeoSearchSelect(dialect, table, where, distExpr, window, controls) {
-	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
-	let sql = `SELECT * FROM (${`SELECT ${dialect.quoteTable("t")}.*, ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
-	const params = [...distExpr.params, ...where.params];
-	if (window.maxDistance !== void 0) {
-		sql += ` AND ${alias} <= ?`;
-		params.push(window.maxDistance);
-	}
-	if (window.minDistance !== void 0) {
-		sql += ` AND ${alias} >= ?`;
-		params.push(window.minDistance);
-	}
-	sql += ` ORDER BY ${alias} ASC`;
-	if (controls.$limit !== void 0) {
-		sql += ` LIMIT ?`;
-		params.push(controls.$limit);
-	}
-	if (controls.$skip !== void 0) {
-		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
-		sql += ` OFFSET ?`;
-		params.push(controls.$skip);
-	}
-	return finalizeParams(dialect, {
-		sql,
-		params
-	});
-}
-/**
-* Count companion for {@link buildGeoSearchSelect} — rows inside the distance
-* window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
-*/
-function buildGeoSearchCount(dialect, table, where, distExpr, window) {
-	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
-	let sql = `SELECT COUNT(*) AS cnt FROM (${`SELECT ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
-	const params = [...distExpr.params, ...where.params];
-	if (window.maxDistance !== void 0) {
-		sql += ` AND ${alias} <= ?`;
-		params.push(window.maxDistance);
-	}
-	if (window.minDistance !== void 0) {
-		sql += ` AND ${alias} >= ?`;
-		params.push(window.minDistance);
-	}
-	return finalizeParams(dialect, {
-		sql,
-		params
-	});
-}
-/** Extracts the `$maxDistance` / `$minDistance` window from query controls. */
-function geoWindowFromControls(controls) {
-	return {
-		maxDistance: typeof controls?.$maxDistance === "number" ? controls.$maxDistance : void 0,
-		minDistance: typeof controls?.$minDistance === "number" ? controls.$minDistance : void 0
-	};
-}
-/**
-* Normalizes a write-path geo value to a `[lng, lat]` tuple. The value may be
-* the raw tuple or its JSON-string form (the relational field mapper
-* stringifies `storage: json` fields before adapter formatters run).
-* Returns `undefined` for anything else (e.g. `$geoWithin` circle objects,
-* which must pass through untouched).
-*/
-function normalizeGeoPointValue(value) {
-	let candidate = value;
-	if (typeof candidate === "string") {
-		if (!candidate.startsWith("[")) return;
-		try {
-			candidate = JSON.parse(candidate);
-		} catch {
-			return;
-		}
-	}
-	if (Array.isArray(candidate) && candidate.length === 2 && typeof candidate[0] === "number" && typeof candidate[1] === "number") return [candidate[0], candidate[1]];
-}
-/** Renames the internal distance alias to the public `$distance` field (in place). */
-function renameGeoDistance(row) {
-	if ("__atscript_distance" in row) {
-		const distance = row[GEO_DISTANCE_ALIAS];
-		delete row[GEO_DISTANCE_ALIAS];
-		row.$distance = typeof distance === "string" ? Number(distance) : distance;
-	}
-	return row;
-}
-//#endregion
 //#region src/common.ts
 /** Formats a string value as a SQL literal with single-quote escaping. */
 function sqlStringLiteral(value) {
@@ -890,16 +783,223 @@ function derivedColumnExpr(dialect, field) {
 }
 /**
 * Builds a column projection (SELECT clause fields).
+*
+* @param qualifier - optional table alias every column (and the `*`
+*   fallback) is qualified with (`"t"."col"`), for projections over a joined
+*   or aliased source such as the geo / vector search subqueries (since 0.1.143).
 */
-function buildProjection(dialect, select) {
+function buildProjection(dialect, select, qualifier) {
+	const prefix = qualifier === void 0 ? "" : `${dialect.quoteTable(qualifier)}.`;
 	const fields = select?.asArray;
-	if (!fields) return "*";
+	if (!fields) return `${prefix}*`;
 	let sql = "";
 	for (let i = 0; i < fields.length; i++) {
 		if (i > 0) sql += ", ";
-		sql += dialect.quoteIdentifier(fields[i]);
+		sql += prefix + dialect.quoteIdentifier(fields[i]);
+	}
+	return sql || `${prefix}*`;
+}
+//#endregion
+//#region src/geo.ts
+/**
+* Internal alias for the computed distance column in geo search queries.
+* Renamed to the public `$distance` pseudo-field after fetch (same convention
+* as the MongoDB adapter) — SQL identifiers starting with `$` are awkward
+* across dialects, so the public name can't be used directly.
+*/
+const GEO_DISTANCE_ALIAS = "__atscript_distance";
+/**
+* Builds a distance-ranked geo search SELECT:
+*
+* ```sql
+* SELECT * FROM (
+*   SELECT <t.cols | t.*>, <distExpr> AS __atscript_distance FROM <table> t WHERE <filter>
+* ) _g
+* WHERE __atscript_distance IS NOT NULL [AND <= ?] [AND >= ?]
+* ORDER BY __atscript_distance ASC LIMIT ? [OFFSET ?]
+* ```
+*
+* `distExpr` computes meters from the query point to the geo column (NULL for
+* rows without a point — those are excluded, matching MongoDB `$geoNear`).
+* `controls.$select` projects the row columns exactly like `buildSelect` does
+* (inclusion and exclusion forms, resolved by `UniquSelect.asArray`); the
+* distance column is always returned. Placeholders stay `?`-style; callers
+* finalize for `$N` dialects.
+*/
+function buildGeoSearchSelect(dialect, table, where, distExpr, window, controls) {
+	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
+	let sql = `SELECT * FROM (${`SELECT ${buildProjection(dialect, controls.$select, "t")}, ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
+	const params = [...distExpr.params, ...where.params];
+	if (window.maxDistance !== void 0) {
+		sql += ` AND ${alias} <= ?`;
+		params.push(window.maxDistance);
+	}
+	if (window.minDistance !== void 0) {
+		sql += ` AND ${alias} >= ?`;
+		params.push(window.minDistance);
+	}
+	sql += ` ORDER BY ${alias} ASC`;
+	if (controls.$limit !== void 0) {
+		sql += ` LIMIT ?`;
+		params.push(controls.$limit);
+	}
+	if (controls.$skip !== void 0) {
+		if (controls.$limit === void 0) sql += ` LIMIT ${dialect.unlimitedLimit}`;
+		sql += ` OFFSET ?`;
+		params.push(controls.$skip);
+	}
+	return finalizeParams(dialect, {
+		sql,
+		params
+	});
+}
+/**
+* Count companion for {@link buildGeoSearchSelect} — rows inside the distance
+* window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
+*/
+function buildGeoSearchCount(dialect, table, where, distExpr, window) {
+	const alias = dialect.quoteIdentifier(GEO_DISTANCE_ALIAS);
+	let sql = `SELECT COUNT(*) AS cnt FROM (${`SELECT ${distExpr.sql} AS ${alias} FROM ${dialect.quoteTable(table)} AS ${dialect.quoteTable("t")} WHERE ${where.sql}`}) AS ${dialect.quoteTable("_g")} WHERE ${alias} IS NOT NULL`;
+	const params = [...distExpr.params, ...where.params];
+	if (window.maxDistance !== void 0) {
+		sql += ` AND ${alias} <= ?`;
+		params.push(window.maxDistance);
+	}
+	if (window.minDistance !== void 0) {
+		sql += ` AND ${alias} >= ?`;
+		params.push(window.minDistance);
+	}
+	return finalizeParams(dialect, {
+		sql,
+		params
+	});
+}
+/** Extracts the `$maxDistance` / `$minDistance` window from query controls. */
+function geoWindowFromControls(controls) {
+	return {
+		maxDistance: typeof controls?.$maxDistance === "number" ? controls.$maxDistance : void 0,
+		minDistance: typeof controls?.$minDistance === "number" ? controls.$minDistance : void 0
+	};
+}
+/**
+* Normalizes a write-path geo value to a `[lng, lat]` tuple. The value may be
+* the raw tuple or its JSON-string form (the relational field mapper
+* stringifies `storage: json` fields before adapter formatters run).
+* Returns `undefined` for anything else (e.g. `$geoWithin` circle objects,
+* which must pass through untouched).
+*/
+function normalizeGeoPointValue(value) {
+	let candidate = value;
+	if (typeof candidate === "string") {
+		if (!candidate.startsWith("[")) return;
+		try {
+			candidate = JSON.parse(candidate);
+		} catch {
+			return;
+		}
 	}
-	return sql || "*";
+	if (Array.isArray(candidate) && candidate.length === 2 && typeof candidate[0] === "number" && typeof candidate[1] === "number") return [candidate[0], candidate[1]];
+}
+/** Renames the internal distance alias to the public `$distance` field (in place). */
+function renameGeoDistance(row) {
+	if ("__atscript_distance" in row) {
+		const distance = row[GEO_DISTANCE_ALIAS];
+		delete row[GEO_DISTANCE_ALIAS];
+		row.$distance = typeof distance === "string" ? Number(distance) : distance;
+	}
+	return row;
+}
+//#endregion
+//#region src/vector.ts
+/** Column every vector search row carries: the engine's distance to the query vector. */
+const VECTOR_DISTANCE_ALIAS = "_distance";
+/** Alias of the row source inside the vector search queries. */
+const SOURCE_ALIAS = "_v";
+/**
+* The row source of a vector search over a plain table:
+*
+* ```sql
+* SELECT t.*, <distExpr> AS _distance FROM <table> t WHERE <where>
+* ```
+*
+* `withRows: false` selects the distance only (the count companion).
+* Placeholders stay `?`-style.
+* @since 0.1.143
+*/
+function vectorDistanceSource(dialect, table, where, distExpr, withRows = true) {
+	const t = dialect.quoteTable("t");
+	return {
+		sql: `SELECT ${withRows ? `${t}.*, ` : ""}${distExpr.sql} AS ${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)} FROM ${dialect.quoteTable(table)} AS ${t} WHERE ${where.sql}`,
+		params: [...distExpr.params, ...where.params]
+	};
+}
+/** The outer WHERE of a vector search: the distance cap, then a residual filter over the source. */
+function outerWhere(dialect, maxDistance, residual) {
+	const parts = [];
+	const params = [];
+	if (maxDistance !== void 0) {
+		parts.push(`${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)} <= ?`);
+		params.push(maxDistance);
+	}
+	if (residual && residual.sql !== "1=1") {
+		parts.push(`(${residual.sql})`);
+		params.push(...residual.params);
+	}
+	return {
+		sql: parts.length > 0 ? ` WHERE ${parts.join(" AND ")}` : "",
+		params
+	};
+}
+/**
+* Builds a distance-ranked vector search SELECT over a row source that
+* carries a `_distance` column ({@link vectorDistanceSource}, or an
+* engine-specific one such as a vector-index join):
+*
+* ```sql
+* SELECT <_v.cols, _v._distance | *> FROM (<source>) _v
+* [WHERE _distance <= ? [AND (<residual>)]]
+* ORDER BY _distance ASC LIMIT ? [OFFSET ?]
+* ```
+*
+* `$select` projects the OUTER query exactly like `buildSelect` does
+* (inclusion and exclusion forms, resolved by `UniquSelect.asArray`), so a
+* residual filter still sees every source column; `_distance` is always
+* returned. `maxDistance` is the threshold on the engine's distance scale;
+* a `residual` filter references the source's columns qualified by `_v`.
+* Placeholders are finalized for the dialect.
+* @since 0.1.143
+*/
+function buildVectorSearchSelect(dialect, source, opts) {
+	const v = dialect.quoteTable(SOURCE_ALIAS);
+	const cols = opts.select?.asArray?.length ? `${buildProjection(dialect, opts.select, SOURCE_ALIAS)}, ${v}.${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)}` : "*";
+	const where = outerWhere(dialect, opts.maxDistance, opts.residual);
+	let sql = `SELECT ${cols} FROM (${source.sql}) AS ${v}${where.sql} ORDER BY ${dialect.quoteIdentifier(VECTOR_DISTANCE_ALIAS)} ASC LIMIT ?`;
+	const params = [
+		...source.params,
+		...where.params,
+		opts.limit
+	];
+	if (opts.skip) {
+		sql += ` OFFSET ?`;
+		params.push(opts.skip);
+	}
+	return finalizeParams(dialect, {
+		sql,
+		params
+	});
+}
+/**
+* Count companion for {@link buildVectorSearchSelect} — rows the search
+* could return (distance cap and residual applied, pagination ignored).
+* Returns one row: `{ cnt }`.
+* @since 0.1.143
+*/
+function buildVectorSearchCount(dialect, source, opts) {
+	const where = outerWhere(dialect, opts.maxDistance, opts.residual);
+	return finalizeParams(dialect, {
+		sql: `SELECT COUNT(*) AS cnt FROM (${source.sql}) AS ${dialect.quoteTable(SOURCE_ALIAS)}${where.sql}`,
+		params: [...source.params, ...where.params]
+	});
 }
 //#endregion
 //#region src/regex.ts
@@ -927,4 +1027,4 @@ function parseRegexString(value) {
 	};
 }
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, SQL_DEFAULT, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, SQL_DEFAULT, VECTOR_DISTANCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildInsertMany, buildProjection, buildSelect, buildUpdate, buildVectorSearchCount, buildVectorSearchSelect, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, derivedColumnExpr, fillReplacePayload, finalizeParams, geoWindowFromControls, groupKeySql, insertManyColumns, jsonDollarPath, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, quotedJsonPathSegments, refActionToSql, renameGeoDistance, replaceColumnsFor, sqlStringLiteral, sqlTimeZoneLiteral, toSqlValue, vectorDistanceSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-sql-tools",
-  "version": "0.1.141",
+  "version": "0.1.143",
   "description": "Shared SQL builder utilities for @atscript database adapters.",
   "keywords": [
     "atscript",
@@ -42,7 +42,7 @@
   },
   "peerDependencies": {
     "@uniqu/core": "^0.1.11",
-    "@atscript/db": "^0.1.141"
+    "@atscript/db": "^0.1.143"
   },
   "scripts": {
     "build": "vp pack",