@atscript/db-sql-tools 0.1.105 → 0.1.107

package/dist/index.cjs

@@ -31,10 +31,13 @@ const EMPTY_OR = {
 function createFilterVisitor(dialect) {
 	return {
 		comparison(field, op, value) {
-			if (op === "$geoWithin") throw new _atscript_db.DbError("GEO_NOT_SUPPORTED", [{
-				path: field,
-				message: "$geoWithin is not supported by this adapter"
-			}]);
+			if (op === "$geoWithin") {
+				if (dialect.geoWithin) return dialect.geoWithin(dialect.quoteIdentifier(field), value);
+				throw new _atscript_db.DbError("GEO_NOT_SUPPORTED", [{
+					path: field,
+					message: "$geoWithin is not supported by this adapter"
+				}]);
+			}
 			const col = dialect.quoteIdentifier(field);
 			const v = dialect.toParam(value);
 			switch (op) {
@@ -138,6 +141,113 @@ 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) {
@@ -147,6 +257,7 @@ function sqlStringLiteral(value) {
 function toSqlValue(value) {
 	if (value === void 0) return null;
 	if (value === null) return null;
+	if (value instanceof Uint8Array) return value;
 	if (typeof value === "object") return JSON.stringify(value);
 	if (typeof value === "boolean") return value ? 1 : 0;
 	return value;
@@ -471,10 +582,13 @@ function parseRegexString(value) {
 exports.AGG_FN_SQL = AGG_FN_SQL;
 exports.EMPTY_AND = EMPTY_AND;
 exports.EMPTY_OR = EMPTY_OR;
+exports.GEO_DISTANCE_ALIAS = GEO_DISTANCE_ALIAS;
 exports.buildAggregateCount = buildAggregateCount;
 exports.buildAggregateSelect = buildAggregateSelect;
 exports.buildCreateView = buildCreateView;
 exports.buildDelete = buildDelete;
+exports.buildGeoSearchCount = buildGeoSearchCount;
+exports.buildGeoSearchSelect = buildGeoSearchSelect;
 exports.buildInsert = buildInsert;
 exports.buildProjection = buildProjection;
 exports.buildSelect = buildSelect;
@@ -484,9 +598,12 @@ exports.createFilterVisitor = createFilterVisitor;
 exports.defaultValueForType = defaultValueForType;
 exports.defaultValueToSqlLiteral = defaultValueToSqlLiteral;
 exports.finalizeParams = finalizeParams;
+exports.geoWindowFromControls = geoWindowFromControls;
+exports.normalizeGeoPointValue = normalizeGeoPointValue;
 exports.parseRegexString = parseRegexString;
 exports.queryNodeToSql = queryNodeToSql;
 exports.queryOpToSql = queryOpToSql;
 exports.refActionToSql = refActionToSql;
+exports.renameGeoDistance = renameGeoDistance;
 exports.sqlStringLiteral = sqlStringLiteral;
 exports.toSqlValue = toSqlValue;

package/dist/index.d.cts

@@ -6,6 +6,11 @@ interface TSqlFragment {
   sql: string;
   params: unknown[];
 }
+/** `$geoWithin` circle: `[lng, lat]` center + radius in meters (core-validated). */
+interface TGeoCircle {
+  center: [number, number];
+  radius: number;
+}
 interface SqlDialect {
   /** Quotes a column/table name */
   quoteIdentifier(name: string): string;
@@ -19,6 +24,13 @@ interface SqlDialect {
   toParam(value: unknown): unknown;
   /** Handle $regex filter */
   regex(quotedCol: string, value: unknown): TSqlFragment;
+  /**
+   * Handle `$geoWithin` filter — circle search on a `db.geoPoint` column.
+   * The circle is pre-validated by the core layer (`center` is a `[lng, lat]`
+   * tuple, `radius` a positive number of meters). Dialects without native geo
+   * support omit this; the filter visitor then throws `GEO_NOT_SUPPORTED`.
+   */
+  geoWithin?(quotedCol: string, circle: TGeoCircle): TSqlFragment;
   /** e.g. 'CREATE VIEW IF NOT EXISTS' or 'CREATE OR REPLACE VIEW' */
   createViewPrefix: string;
   /** Returns a parameter placeholder for the given 1-based index. When absent, '?' is used. */
@@ -42,6 +54,56 @@ declare function createFilterVisitor(dialect: SqlDialect): FilterVisitor<TSqlFra
  */
 declare function buildWhere(dialect: SqlDialect, filter: FilterExpr): TSqlFragment;
 //#endregion
+//#region src/geo.d.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.
+ */
+declare const GEO_DISTANCE_ALIAS = "__atscript_distance";
+/** Distance window for geo search: `$maxDistance` / `$minDistance` in meters. */
+interface TGeoWindow {
+  maxDistance?: number;
+  minDistance?: number;
+}
+/**
+ * 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.
+ */
+declare function buildGeoSearchSelect(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow, controls: {
+  $limit?: number;
+  $skip?: number;
+}): TSqlFragment;
+/**
+ * Count companion for {@link buildGeoSearchSelect} — rows inside the distance
+ * window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
+ */
+declare function buildGeoSearchCount(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow): TSqlFragment;
+/** Extracts the `$maxDistance` / `$minDistance` window from query controls. */
+declare function geoWindowFromControls(controls: Record<string, unknown> | undefined): TGeoWindow;
+/**
+ * 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).
+ */
+declare function normalizeGeoPointValue(value: unknown): [number, number] | undefined;
+/** 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/sql-builder.d.ts
 /**
  * Builds an INSERT statement.
@@ -124,4 +186,4 @@ declare function parseRegexString(value: unknown): {
   flags: string;
 };
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, type SqlDialect, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, parseRegexString, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, type SqlDialect, type TGeoCircle, type TGeoWindow, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, geoWindowFromControls, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, refActionToSql, renameGeoDistance, sqlStringLiteral, toSqlValue };

package/dist/index.d.mts

@@ -6,6 +6,11 @@ interface TSqlFragment {
   sql: string;
   params: unknown[];
 }
+/** `$geoWithin` circle: `[lng, lat]` center + radius in meters (core-validated). */
+interface TGeoCircle {
+  center: [number, number];
+  radius: number;
+}
 interface SqlDialect {
   /** Quotes a column/table name */
   quoteIdentifier(name: string): string;
@@ -19,6 +24,13 @@ interface SqlDialect {
   toParam(value: unknown): unknown;
   /** Handle $regex filter */
   regex(quotedCol: string, value: unknown): TSqlFragment;
+  /**
+   * Handle `$geoWithin` filter — circle search on a `db.geoPoint` column.
+   * The circle is pre-validated by the core layer (`center` is a `[lng, lat]`
+   * tuple, `radius` a positive number of meters). Dialects without native geo
+   * support omit this; the filter visitor then throws `GEO_NOT_SUPPORTED`.
+   */
+  geoWithin?(quotedCol: string, circle: TGeoCircle): TSqlFragment;
   /** e.g. 'CREATE VIEW IF NOT EXISTS' or 'CREATE OR REPLACE VIEW' */
   createViewPrefix: string;
   /** Returns a parameter placeholder for the given 1-based index. When absent, '?' is used. */
@@ -42,6 +54,56 @@ declare function createFilterVisitor(dialect: SqlDialect): FilterVisitor<TSqlFra
  */
 declare function buildWhere(dialect: SqlDialect, filter: FilterExpr): TSqlFragment;
 //#endregion
+//#region src/geo.d.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.
+ */
+declare const GEO_DISTANCE_ALIAS = "__atscript_distance";
+/** Distance window for geo search: `$maxDistance` / `$minDistance` in meters. */
+interface TGeoWindow {
+  maxDistance?: number;
+  minDistance?: number;
+}
+/**
+ * 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.
+ */
+declare function buildGeoSearchSelect(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow, controls: {
+  $limit?: number;
+  $skip?: number;
+}): TSqlFragment;
+/**
+ * Count companion for {@link buildGeoSearchSelect} — rows inside the distance
+ * window (filter applied, pagination ignored). Returns one row: `{ cnt }`.
+ */
+declare function buildGeoSearchCount(dialect: SqlDialect, table: string, where: TSqlFragment, distExpr: TSqlFragment, window: TGeoWindow): TSqlFragment;
+/** Extracts the `$maxDistance` / `$minDistance` window from query controls. */
+declare function geoWindowFromControls(controls: Record<string, unknown> | undefined): TGeoWindow;
+/**
+ * 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).
+ */
+declare function normalizeGeoPointValue(value: unknown): [number, number] | undefined;
+/** 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/sql-builder.d.ts
 /**
  * Builds an INSERT statement.
@@ -124,4 +186,4 @@ declare function parseRegexString(value: unknown): {
   flags: string;
 };
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, type SqlDialect, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, parseRegexString, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, type SqlDialect, type TGeoCircle, type TGeoWindow, type TSqlFragment, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, geoWindowFromControls, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, refActionToSql, renameGeoDistance, sqlStringLiteral, toSqlValue };

package/dist/index.mjs

@@ -30,10 +30,13 @@ const EMPTY_OR = {
 function createFilterVisitor(dialect) {
 	return {
 		comparison(field, op, value) {
-			if (op === "$geoWithin") throw new DbError("GEO_NOT_SUPPORTED", [{
-				path: field,
-				message: "$geoWithin is not supported by this adapter"
-			}]);
+			if (op === "$geoWithin") {
+				if (dialect.geoWithin) return dialect.geoWithin(dialect.quoteIdentifier(field), value);
+				throw new DbError("GEO_NOT_SUPPORTED", [{
+					path: field,
+					message: "$geoWithin is not supported by this adapter"
+				}]);
+			}
 			const col = dialect.quoteIdentifier(field);
 			const v = dialect.toParam(value);
 			switch (op) {
@@ -137,6 +140,113 @@ 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) {
@@ -146,6 +256,7 @@ function sqlStringLiteral(value) {
 function toSqlValue(value) {
 	if (value === void 0) return null;
 	if (value === null) return null;
+	if (value instanceof Uint8Array) return value;
 	if (typeof value === "object") return JSON.stringify(value);
 	if (typeof value === "boolean") return value ? 1 : 0;
 	return value;
@@ -467,4 +578,4 @@ function parseRegexString(value) {
 	};
 }
 //#endregion
-export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, parseRegexString, queryNodeToSql, queryOpToSql, refActionToSql, sqlStringLiteral, toSqlValue };
+export { AGG_FN_SQL, EMPTY_AND, EMPTY_OR, GEO_DISTANCE_ALIAS, buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildProjection, buildSelect, buildUpdate, buildWhere, createFilterVisitor, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, geoWindowFromControls, normalizeGeoPointValue, parseRegexString, queryNodeToSql, queryOpToSql, refActionToSql, renameGeoDistance, sqlStringLiteral, toSqlValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-sql-tools",
-  "version": "0.1.105",
+  "version": "0.1.107",
   "description": "Shared SQL builder utilities for @atscript database adapters.",
   "keywords": [
     "atscript",
@@ -38,11 +38,11 @@
   },
   "devDependencies": {
     "@uniqu/core": "^0.1.6",
-    "unplugin-atscript": "^0.1.76"
+    "unplugin-atscript": "^0.1.77"
   },
   "peerDependencies": {
     "@uniqu/core": "^0.1.6",
-    "@atscript/db": "^0.1.105"
+    "@atscript/db": "^0.1.107"
   },
   "scripts": {
     "build": "vp pack",