@atscript/db-mongo 0.1.103 → 0.1.105

package/dist/agg.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mongo_filter = require("./mongo-filter-1EpqdD-T.cjs");
+const require_mongo_filter = require("./mongo-filter-z_hLPMyv.cjs");
 let _atscript_db_agg = require("@atscript/db/agg");
 //#region src/agg.ts
 /** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */

package/dist/agg.mjs

@@ -1,4 +1,4 @@
-import { t as buildMongoFilter } from "./mongo-filter-DBYaF9aH.mjs";
+import { t as buildMongoFilter } from "./mongo-filter-DceAGI-S.mjs";
 import { resolveAlias } from "@atscript/db/agg";
 //#region src/agg.ts
 /** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */

package/dist/index.cjs

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mongo_filter = require("./mongo-filter-1EpqdD-T.cjs");
-const require_plugin = require("./plugin-Bq6hZMBA.cjs");
+const require_mongo_filter = require("./mongo-filter-z_hLPMyv.cjs");
 let _atscript_db = require("@atscript/db");
 let mongodb = require("mongodb");
 //#region src/lib/projection-dedupe.ts
@@ -654,6 +653,83 @@ async function vectorSearchWithCountImpl(host, vector, query, indexName) {
 	const controls = query.controls || {};
 	return runSearchWithCountPipeline(host, buildVectorSearchStage(host, vector, indexName, controls.$limit), query, "vectorSearchWithCount", resolveThreshold(host, controls, indexName));
 }
+/**
+* Field name `$geoNear` writes the computed distance into. Renamed to the
+* public `$distance` pseudo-field after fetch — Mongo field paths cannot
+* start with `$`, so the public name can't be used as `distanceField`.
+*/
+const DISTANCE_FIELD = "__atscript_distance";
+/** Distance-ranked geo search via a leading `$geoNear` aggregation stage. */
+async function geoSearchImpl(host, point, query, indexName) {
+	const controls = query.controls || {};
+	const pipeline = [buildGeoNearStage(host, point, query, indexName)];
+	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
+	pipeline.push({ $limit: controls.$limit || 1e3 });
+	pushGeoProjection(pipeline, query.controls);
+	host._log("aggregate (geoSearch)", pipeline);
+	return (await wrapInvalidQuery(() => host.collection.aggregate(pipeline, host._getSessionOpts()).toArray())).map((row) => renameDistance(row));
+}
+/** Geo search with faceted count (rows within the distance window). */
+async function geoSearchWithCountImpl(host, point, query, indexName) {
+	const controls = query.controls || {};
+	const dataStages = [];
+	if (controls.$skip) dataStages.push({ $skip: controls.$skip });
+	if (controls.$limit) dataStages.push({ $limit: controls.$limit });
+	pushGeoProjection(dataStages, query.controls);
+	const pipeline = [buildGeoNearStage(host, point, query, indexName), { $facet: {
+		data: dataStages,
+		meta: [{ $count: "count" }]
+	} }];
+	host._log("aggregate (geoSearchWithCount)", pipeline);
+	const result = await wrapInvalidQuery(() => host.collection.aggregate(pipeline, host._getSessionOpts()).toArray());
+	return {
+		data: (result[0]?.data || []).map((row) => renameDistance(row)),
+		count: result[0]?.meta?.[0]?.count || 0
+	};
+}
+/** Builds the leading `$geoNear` stage; the filter rides in its `query` option. */
+function buildGeoNearStage(host, point, query, indexName) {
+	const controls = query.controls || {};
+	const geoNear = {
+		near: {
+			type: "Point",
+			coordinates: point
+		},
+		distanceField: DISTANCE_FIELD,
+		spherical: true,
+		key: resolveGeoKeyPath(host, indexName),
+		query: require_mongo_filter.buildMongoFilter(query.filter)
+	};
+	if (typeof controls.$maxDistance === "number") geoNear.maxDistance = controls.$maxDistance;
+	if (typeof controls.$minDistance === "number") geoNear.minDistance = controls.$minDistance;
+	return { $geoNear: geoNear };
+}
+/** Resolves the physical field path of the targeted geo index. */
+function resolveGeoKeyPath(host, indexName) {
+	const geoIndexes = [...host._table.indexes.values()].filter((index) => index.type === "geo");
+	const field = (indexName ? geoIndexes.find((candidate) => candidate.name === indexName) : geoIndexes[0])?.fields[0]?.name;
+	if (!field) throw new _atscript_db.DbError("GEO_INDEX_MISSING", [{
+		path: indexName ?? "",
+		message: `No geo index${indexName ? ` "${indexName}"` : ""} on "${host._table.tableName}"`
+	}]);
+	return field;
+}
+/** Appends a `$project` stage, keeping the computed distance in inclusion mode. */
+function pushGeoProjection(stages, controls) {
+	const projection = controls?.$select?.asProjection;
+	if (!projection) return;
+	const deduped = dedupeProjection(projection);
+	if (Object.values(deduped).some((v) => v === 1)) deduped[DISTANCE_FIELD] = 1;
+	stages.push({ $project: deduped });
+}
+/** Renames the internal distance field to the public `$distance` pseudo-field. */
+function renameDistance(row) {
+	if (DISTANCE_FIELD in row) {
+		row.$distance = row[DISTANCE_FIELD];
+		delete row[DISTANCE_FIELD];
+	}
+	return row;
+}
 /** Resolves the effective threshold: query-time $threshold > schema-level @db.search.vector.threshold. */
 function resolveThreshold(host, controls, indexName) {
 	const queryThreshold = controls.$threshold;
@@ -1129,6 +1205,9 @@ async function syncIndexesImpl(host) {
 				fields[f.name] = "text";
 				weights[f.name] = f.weight ?? 1;
 			}
+		} else if (index.type === "geo") {
+			mongoType = "2dsphere";
+			for (const f of index.fields) fields[f.name] = "2dsphere";
 		} else {
 			mongoType = index.type;
 			for (const f of index.fields) fields[f.name] = 1;
@@ -1159,7 +1238,8 @@ async function syncIndexesImpl(host) {
 			switch (local.type) {
 				case "plain":
 				case "unique":
-				case "text": {
+				case "text":
+				case "2dsphere": {
 					const fieldsMatch = local.type === "text" || objMatch(local.fields, remote.key);
 					const weightsMatch = objMatch(local.weights || {}, remote.weights || {});
 					const optionsMatch = local.type === "text" || local.type === "unique" === (remote.unique === true) && partialFilterEqual(local.partialFilterExpression, remote.partialFilterExpression);
@@ -1200,6 +1280,11 @@ async function syncIndexesImpl(host) {
 				name: key
 			});
 			break;
+		case "2dsphere":
+			if (!indexesToCreate.has(key)) continue;
+			host._log("createIndex (2dsphere)", key, value.fields);
+			await host.collection.createIndex(value.fields, { name: key });
+			break;
 		default:
 	}
 	try {
@@ -1521,9 +1606,31 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	* filterability blocker the way it is for SQL adapters.
 	* `canSortField` keeps the conservative default (no sort on JSON storage):
 	* sort-by-min/max-element on arrays is a footgun for generic UI sort headers.
+	*
+	* The `@db.encrypted` veto is core-supplied and absolute: ciphertext
+	* envelopes cannot be filtered, no matter how permissive Mongo is.
 	*/
-	canFilterField(_fd) {
-		return true;
+	canFilterField(fd) {
+		return !fd.encrypted;
+	}
+	/**
+	* Converts `db.geoPoint` tuples to/from GeoJSON Point storage:
+	* write `[lng, lat]` → `{ type: 'Point', coordinates: [lng, lat] }`,
+	* unwrap back to the tuple on read. Non-tuple values (e.g. `$geoWithin`
+	* operator objects flowing through filter translation) pass through.
+	*/
+	formatValue(field) {
+		if (!field.isGeoPoint) return;
+		return {
+			toStorage: (value) => Array.isArray(value) && value.length === 2 && typeof value[0] === "number" && typeof value[1] === "number" ? {
+				type: "Point",
+				coordinates: value
+			} : value,
+			fromStorage: (value) => {
+				const v = value;
+				return v && typeof v === "object" && v.type === "Point" && Array.isArray(v.coordinates) ? v.coordinates : value;
+			}
+		};
 	}
 	getAdapterTableName(_type) {}
 	supportsNativeRelations() {
@@ -1722,6 +1829,15 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	async vectorSearchWithCount(vector, query, indexName) {
 		return vectorSearchWithCountImpl(this, vector, query, indexName);
 	}
+	isGeoSearchable() {
+		return true;
+	}
+	async geoSearch(point, query, indexName) {
+		return geoSearchImpl(this, point, query, indexName);
+	}
+	async geoSearchWithCount(point, query, indexName) {
+		return geoSearchWithCountImpl(this, point, query, indexName);
+	}
 	async findManyWithCount(query) {
 		const filter = require_mongo_filter.buildMongoFilter(query.filter);
 		const controls = query.controls || {};
@@ -2164,7 +2280,6 @@ function createAdapter(connection, _options) {
 //#endregion
 exports.CollectionPatcher = CollectionPatcher;
 exports.MongoAdapter = MongoAdapter;
-exports.MongoPlugin = require_plugin.MongoPlugin;
 exports.buildMongoFilter = require_mongo_filter.buildMongoFilter;
 exports.createAdapter = createAdapter;
 exports.validateMongoIdPlugin = validateMongoIdPlugin;

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import { t as MongoPlugin } from "./index-Bl_O47fp.cjs";
 import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbForeignKey, TDbInsertManyResult, TDbInsertResult, TDbRelation, TDbUpdateResult, TExistingTableOption, TFieldOps, TMetadataOverrides, TSearchIndexInfo, TSyncColumnResult, TTableResolver, TableMetadata, WithRelation, getKeyProps } from "@atscript/db";
 import { AggregationCursor, ClientSession, Collection, Db, Document, Filter, MongoClient, ObjectId, UpdateFilter, UpdateOptions } from "mongodb";
 import { TAtscriptAnnotatedType, TMetadataMap, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
@@ -149,8 +148,8 @@ declare class CollectionPatcher {
 interface TPlainIndex {
   key: string;
   name: string;
-  type: "plain" | "unique" | "text";
-  fields: Record<string, 1 | "text">;
+  type: "plain" | "unique" | "text" | "2dsphere";
+  fields: Record<string, 1 | "text" | "2dsphere">;
   weights: Record<string, number>;
   /**
    * For "present-only" unique indexes on optional fields: a MongoDB
@@ -280,8 +279,21 @@ declare class MongoAdapter extends BaseDbAdapter {
    * filterability blocker the way it is for SQL adapters.
    * `canSortField` keeps the conservative default (no sort on JSON storage):
    * sort-by-min/max-element on arrays is a footgun for generic UI sort headers.
+   *
+   * The `@db.encrypted` veto is core-supplied and absolute: ciphertext
+   * envelopes cannot be filtered, no matter how permissive Mongo is.
+   */
+  canFilterField(fd: TDbFieldMeta): boolean;
+  /**
+   * Converts `db.geoPoint` tuples to/from GeoJSON Point storage:
+   * write `[lng, lat]` → `{ type: 'Point', coordinates: [lng, lat] }`,
+   * unwrap back to the tuple on read. Non-tuple values (e.g. `$geoWithin`
+   * operator objects flowing through filter translation) pass through.
    */
-  canFilterField(_fd: TDbFieldMeta): boolean;
+  formatValue(field: TDbFieldMeta): {
+    toStorage: (value: unknown) => unknown;
+    fromStorage: (value: unknown) => unknown;
+  } | undefined;
   getAdapterTableName(_type: unknown): string | undefined;
   supportsNativeRelations(): boolean;
   loadRelations(rows: Array<Record<string, unknown>>, withRelations: WithRelation[], relations: ReadonlyMap<string, TDbRelation>, foreignKeys: ReadonlyMap<string, TDbForeignKey>, tableResolver?: TTableResolver): Promise<void>;
@@ -310,6 +322,12 @@ declare class MongoAdapter extends BaseDbAdapter {
     data: Array<Record<string, unknown>>;
     count: number;
   }>;
+  isGeoSearchable(): boolean;
+  geoSearch(point: [number, number], query: DbQuery, indexName?: string): Promise<Record<string, unknown>[]>;
+  geoSearchWithCount(point: [number, number], query: DbQuery, indexName?: string): Promise<{
+    data: Array<Record<string, unknown>>;
+    count: number;
+  }>;
   findManyWithCount(query: DbQuery): Promise<{
     data: Array<Record<string, unknown>>;
     count: number;
@@ -408,4 +426,4 @@ declare const validateMongoIdPlugin: TValidatorPlugin;
 //#region src/lib/index.d.ts
 declare function createAdapter(connection: string, _options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { CollectionPatcher, MongoAdapter, MongoPlugin, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };
+export { CollectionPatcher, MongoAdapter, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-import { t as MongoPlugin } from "./index-Bl_O47fp.mjs";
 import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbForeignKey, TDbInsertManyResult, TDbInsertResult, TDbRelation, TDbUpdateResult, TExistingTableOption, TFieldOps, TMetadataOverrides, TSearchIndexInfo, TSyncColumnResult, TTableResolver, TableMetadata, WithRelation, getKeyProps } from "@atscript/db";
 import { AggregationCursor, ClientSession, Collection, Db, Document, Filter, MongoClient, ObjectId, UpdateFilter, UpdateOptions } from "mongodb";
 import { TAtscriptAnnotatedType, TMetadataMap, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
@@ -149,8 +148,8 @@ declare class CollectionPatcher {
 interface TPlainIndex {
   key: string;
   name: string;
-  type: "plain" | "unique" | "text";
-  fields: Record<string, 1 | "text">;
+  type: "plain" | "unique" | "text" | "2dsphere";
+  fields: Record<string, 1 | "text" | "2dsphere">;
   weights: Record<string, number>;
   /**
    * For "present-only" unique indexes on optional fields: a MongoDB
@@ -280,8 +279,21 @@ declare class MongoAdapter extends BaseDbAdapter {
    * filterability blocker the way it is for SQL adapters.
    * `canSortField` keeps the conservative default (no sort on JSON storage):
    * sort-by-min/max-element on arrays is a footgun for generic UI sort headers.
+   *
+   * The `@db.encrypted` veto is core-supplied and absolute: ciphertext
+   * envelopes cannot be filtered, no matter how permissive Mongo is.
+   */
+  canFilterField(fd: TDbFieldMeta): boolean;
+  /**
+   * Converts `db.geoPoint` tuples to/from GeoJSON Point storage:
+   * write `[lng, lat]` → `{ type: 'Point', coordinates: [lng, lat] }`,
+   * unwrap back to the tuple on read. Non-tuple values (e.g. `$geoWithin`
+   * operator objects flowing through filter translation) pass through.
    */
-  canFilterField(_fd: TDbFieldMeta): boolean;
+  formatValue(field: TDbFieldMeta): {
+    toStorage: (value: unknown) => unknown;
+    fromStorage: (value: unknown) => unknown;
+  } | undefined;
   getAdapterTableName(_type: unknown): string | undefined;
   supportsNativeRelations(): boolean;
   loadRelations(rows: Array<Record<string, unknown>>, withRelations: WithRelation[], relations: ReadonlyMap<string, TDbRelation>, foreignKeys: ReadonlyMap<string, TDbForeignKey>, tableResolver?: TTableResolver): Promise<void>;
@@ -310,6 +322,12 @@ declare class MongoAdapter extends BaseDbAdapter {
     data: Array<Record<string, unknown>>;
     count: number;
   }>;
+  isGeoSearchable(): boolean;
+  geoSearch(point: [number, number], query: DbQuery, indexName?: string): Promise<Record<string, unknown>[]>;
+  geoSearchWithCount(point: [number, number], query: DbQuery, indexName?: string): Promise<{
+    data: Array<Record<string, unknown>>;
+    count: number;
+  }>;
   findManyWithCount(query: DbQuery): Promise<{
     data: Array<Record<string, unknown>>;
     count: number;
@@ -408,4 +426,4 @@ declare const validateMongoIdPlugin: TValidatorPlugin;
 //#region src/lib/index.d.ts
 declare function createAdapter(connection: string, _options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { CollectionPatcher, MongoAdapter, MongoPlugin, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };
+export { CollectionPatcher, MongoAdapter, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };

package/dist/index.mjs

@@ -1,5 +1,4 @@
-import { t as buildMongoFilter } from "./mongo-filter-DBYaF9aH.mjs";
-import { t as MongoPlugin } from "./plugin-KVFAwoGw.mjs";
+import { t as buildMongoFilter } from "./mongo-filter-DceAGI-S.mjs";
 import { AtscriptDbView, BaseDbAdapter, DbError, DbSpace, computeInsights, getDbFieldOp, getKeyProps, resolveDesignType } from "@atscript/db";
 import { MongoClient, MongoServerError, ObjectId } from "mongodb";
 //#region src/lib/projection-dedupe.ts
@@ -653,6 +652,83 @@ async function vectorSearchWithCountImpl(host, vector, query, indexName) {
 	const controls = query.controls || {};
 	return runSearchWithCountPipeline(host, buildVectorSearchStage(host, vector, indexName, controls.$limit), query, "vectorSearchWithCount", resolveThreshold(host, controls, indexName));
 }
+/**
+* Field name `$geoNear` writes the computed distance into. Renamed to the
+* public `$distance` pseudo-field after fetch — Mongo field paths cannot
+* start with `$`, so the public name can't be used as `distanceField`.
+*/
+const DISTANCE_FIELD = "__atscript_distance";
+/** Distance-ranked geo search via a leading `$geoNear` aggregation stage. */
+async function geoSearchImpl(host, point, query, indexName) {
+	const controls = query.controls || {};
+	const pipeline = [buildGeoNearStage(host, point, query, indexName)];
+	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
+	pipeline.push({ $limit: controls.$limit || 1e3 });
+	pushGeoProjection(pipeline, query.controls);
+	host._log("aggregate (geoSearch)", pipeline);
+	return (await wrapInvalidQuery(() => host.collection.aggregate(pipeline, host._getSessionOpts()).toArray())).map((row) => renameDistance(row));
+}
+/** Geo search with faceted count (rows within the distance window). */
+async function geoSearchWithCountImpl(host, point, query, indexName) {
+	const controls = query.controls || {};
+	const dataStages = [];
+	if (controls.$skip) dataStages.push({ $skip: controls.$skip });
+	if (controls.$limit) dataStages.push({ $limit: controls.$limit });
+	pushGeoProjection(dataStages, query.controls);
+	const pipeline = [buildGeoNearStage(host, point, query, indexName), { $facet: {
+		data: dataStages,
+		meta: [{ $count: "count" }]
+	} }];
+	host._log("aggregate (geoSearchWithCount)", pipeline);
+	const result = await wrapInvalidQuery(() => host.collection.aggregate(pipeline, host._getSessionOpts()).toArray());
+	return {
+		data: (result[0]?.data || []).map((row) => renameDistance(row)),
+		count: result[0]?.meta?.[0]?.count || 0
+	};
+}
+/** Builds the leading `$geoNear` stage; the filter rides in its `query` option. */
+function buildGeoNearStage(host, point, query, indexName) {
+	const controls = query.controls || {};
+	const geoNear = {
+		near: {
+			type: "Point",
+			coordinates: point
+		},
+		distanceField: DISTANCE_FIELD,
+		spherical: true,
+		key: resolveGeoKeyPath(host, indexName),
+		query: buildMongoFilter(query.filter)
+	};
+	if (typeof controls.$maxDistance === "number") geoNear.maxDistance = controls.$maxDistance;
+	if (typeof controls.$minDistance === "number") geoNear.minDistance = controls.$minDistance;
+	return { $geoNear: geoNear };
+}
+/** Resolves the physical field path of the targeted geo index. */
+function resolveGeoKeyPath(host, indexName) {
+	const geoIndexes = [...host._table.indexes.values()].filter((index) => index.type === "geo");
+	const field = (indexName ? geoIndexes.find((candidate) => candidate.name === indexName) : geoIndexes[0])?.fields[0]?.name;
+	if (!field) throw new DbError("GEO_INDEX_MISSING", [{
+		path: indexName ?? "",
+		message: `No geo index${indexName ? ` "${indexName}"` : ""} on "${host._table.tableName}"`
+	}]);
+	return field;
+}
+/** Appends a `$project` stage, keeping the computed distance in inclusion mode. */
+function pushGeoProjection(stages, controls) {
+	const projection = controls?.$select?.asProjection;
+	if (!projection) return;
+	const deduped = dedupeProjection(projection);
+	if (Object.values(deduped).some((v) => v === 1)) deduped[DISTANCE_FIELD] = 1;
+	stages.push({ $project: deduped });
+}
+/** Renames the internal distance field to the public `$distance` pseudo-field. */
+function renameDistance(row) {
+	if (DISTANCE_FIELD in row) {
+		row.$distance = row[DISTANCE_FIELD];
+		delete row[DISTANCE_FIELD];
+	}
+	return row;
+}
 /** Resolves the effective threshold: query-time $threshold > schema-level @db.search.vector.threshold. */
 function resolveThreshold(host, controls, indexName) {
 	const queryThreshold = controls.$threshold;
@@ -1128,6 +1204,9 @@ async function syncIndexesImpl(host) {
 				fields[f.name] = "text";
 				weights[f.name] = f.weight ?? 1;
 			}
+		} else if (index.type === "geo") {
+			mongoType = "2dsphere";
+			for (const f of index.fields) fields[f.name] = "2dsphere";
 		} else {
 			mongoType = index.type;
 			for (const f of index.fields) fields[f.name] = 1;
@@ -1158,7 +1237,8 @@ async function syncIndexesImpl(host) {
 			switch (local.type) {
 				case "plain":
 				case "unique":
-				case "text": {
+				case "text":
+				case "2dsphere": {
 					const fieldsMatch = local.type === "text" || objMatch(local.fields, remote.key);
 					const weightsMatch = objMatch(local.weights || {}, remote.weights || {});
 					const optionsMatch = local.type === "text" || local.type === "unique" === (remote.unique === true) && partialFilterEqual(local.partialFilterExpression, remote.partialFilterExpression);
@@ -1199,6 +1279,11 @@ async function syncIndexesImpl(host) {
 				name: key
 			});
 			break;
+		case "2dsphere":
+			if (!indexesToCreate.has(key)) continue;
+			host._log("createIndex (2dsphere)", key, value.fields);
+			await host.collection.createIndex(value.fields, { name: key });
+			break;
 		default:
 	}
 	try {
@@ -1520,9 +1605,31 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	* filterability blocker the way it is for SQL adapters.
 	* `canSortField` keeps the conservative default (no sort on JSON storage):
 	* sort-by-min/max-element on arrays is a footgun for generic UI sort headers.
+	*
+	* The `@db.encrypted` veto is core-supplied and absolute: ciphertext
+	* envelopes cannot be filtered, no matter how permissive Mongo is.
 	*/
-	canFilterField(_fd) {
-		return true;
+	canFilterField(fd) {
+		return !fd.encrypted;
+	}
+	/**
+	* Converts `db.geoPoint` tuples to/from GeoJSON Point storage:
+	* write `[lng, lat]` → `{ type: 'Point', coordinates: [lng, lat] }`,
+	* unwrap back to the tuple on read. Non-tuple values (e.g. `$geoWithin`
+	* operator objects flowing through filter translation) pass through.
+	*/
+	formatValue(field) {
+		if (!field.isGeoPoint) return;
+		return {
+			toStorage: (value) => Array.isArray(value) && value.length === 2 && typeof value[0] === "number" && typeof value[1] === "number" ? {
+				type: "Point",
+				coordinates: value
+			} : value,
+			fromStorage: (value) => {
+				const v = value;
+				return v && typeof v === "object" && v.type === "Point" && Array.isArray(v.coordinates) ? v.coordinates : value;
+			}
+		};
 	}
 	getAdapterTableName(_type) {}
 	supportsNativeRelations() {
@@ -1721,6 +1828,15 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	async vectorSearchWithCount(vector, query, indexName) {
 		return vectorSearchWithCountImpl(this, vector, query, indexName);
 	}
+	isGeoSearchable() {
+		return true;
+	}
+	async geoSearch(point, query, indexName) {
+		return geoSearchImpl(this, point, query, indexName);
+	}
+	async geoSearchWithCount(point, query, indexName) {
+		return geoSearchWithCountImpl(this, point, query, indexName);
+	}
 	async findManyWithCount(query) {
 		const filter = buildMongoFilter(query.filter);
 		const controls = query.controls || {};
@@ -2161,4 +2277,4 @@ function createAdapter(connection, _options) {
 	return new DbSpace(() => new MongoAdapter(db, client));
 }
 //#endregion
-export { CollectionPatcher, MongoAdapter, MongoPlugin, buildMongoFilter, createAdapter, validateMongoIdPlugin };
+export { CollectionPatcher, MongoAdapter, buildMongoFilter, createAdapter, validateMongoIdPlugin };

package/dist/{mongo-filter-DBYaF9aH.mjs → mongo-filter-DceAGI-S.mjs}

@@ -17,6 +17,11 @@ function parseRegexString(value) {
 		flags: ""
 	};
 }
+/**
+* Earth radius in meters used by MongoDB's `$centerSphere` radians conversion
+* (Mongo documents dividing by 6378.1 km).
+*/
+const EARTH_RADIUS_M = 6378100;
 const mongoVisitor = {
 	comparison(field, op, value) {
 		if (op === "$eq") return { [field]: value };
@@ -27,6 +32,10 @@ const mongoVisitor = {
 				$options: flags
 			} } : { [field]: { $regex: pattern } };
 		}
+		if (op === "$geoWithin") {
+			const { center, radius } = value;
+			return { [field]: { $geoWithin: { $centerSphere: [center, radius / EARTH_RADIUS_M] } } };
+		}
 		return { [field]: { [op]: value } };
 	},
 	and(children) {

package/dist/{mongo-filter-1EpqdD-T.cjs → mongo-filter-z_hLPMyv.cjs}

@@ -17,6 +17,11 @@ function parseRegexString(value) {
 		flags: ""
 	};
 }
+/**
+* Earth radius in meters used by MongoDB's `$centerSphere` radians conversion
+* (Mongo documents dividing by 6378.1 km).
+*/
+const EARTH_RADIUS_M = 6378100;
 const mongoVisitor = {
 	comparison(field, op, value) {
 		if (op === "$eq") return { [field]: value };
@@ -27,6 +32,10 @@ const mongoVisitor = {
 				$options: flags
 			} } : { [field]: { $regex: pattern } };
 		}
+		if (op === "$geoWithin") {
+			const { center, radius } = value;
+			return { [field]: { $geoWithin: { $centerSphere: [center, radius / EARTH_RADIUS_M] } } };
+		}
 		return { [field]: { [op]: value } };
 	},
 	and(children) {