@atscript/db-mongo 0.1.142 → 0.1.143

package/dist/index.cjs

@@ -569,12 +569,14 @@ function buildLookupInnerPipeline(withRel, requiredFields) {
 	if (sort) pipeline.push({ $sort: sort });
 	if (skip) pipeline.push({ $skip: skip });
 	if (limit !== null && limit !== void 0) pipeline.push({ $limit: limit });
-	if (select) {
-		const projection = {};
-		for (const f of select) projection[f] = 1;
-		for (const f of requiredFields) projection[f] = 1;
-		if (!select.includes("_id") && !requiredFields.includes("_id")) projection["_id"] = 0;
-		pipeline.push({ $project: dedupeProjection(projection) });
+	const projection = select ? new _atscript_db.UniquSelect(select).asProjection : void 0;
+	if (projection) {
+		const project = { ...projection };
+		if (Object.values(project).some((flag) => flag === 1 || flag === true)) {
+			for (const f of requiredFields) project[f] = 1;
+			if (!("_id" in projection) && !requiredFields.includes("_id")) project._id = 0;
+		} else for (const f of requiredFields) delete project[f];
+		if (Object.keys(project).length > 0) pipeline.push({ $project: dedupeProjection(project) });
 	}
 	return pipeline;
 }
@@ -642,16 +644,39 @@ function findRemoteFK(target, thisTableName, alias) {
 }
 //#endregion
 //#region src/lib/mongo-search.ts
-/** Returns available search indexes as generic metadata for UI. */
+/**
+* Returns available search indexes as generic metadata for UI. The text
+* default is the `DEFAULT` entry (an alias of the index `search()` answers
+* with when none is named); the vector default is the first vector index.
+*/
 function getSearchIndexesImpl(host) {
 	const result = [];
-	for (const [name, index] of host.getMongoSearchIndexes()) result.push({
-		name,
-		description: `${index.type} index`,
-		type: index.type === "vector" ? "vector" : "text"
-	});
+	let firstVector = true;
+	for (const [name, index] of host.getMongoSearchIndexes()) {
+		const isVector = index.type === "vector";
+		result.push({
+			name,
+			description: `${index.type} index`,
+			type: isVector ? "vector" : "text",
+			fields: searchIndexPaths(host, index),
+			isDefault: isVector ? firstVector : name === DEFAULT_INDEX_NAME
+		});
+		if (isVector) firstVector = false;
+	}
 	return result;
 }
+/**
+* LOGICAL paths an index reads: a classic text index by its `@db.index.fulltext`
+* definition, an Atlas index by the paths it maps; `undefined` (every field)
+* for a dynamic mapping or an index whose fields cannot be told.
+*/
+function searchIndexPaths(host, index) {
+	if (index.type === "text") {
+		const source = host._table.indexes.get(index.key);
+		return source ? host._indexLogicalPaths(source) : void 0;
+	}
+	return "paths" in index && index.paths ? [...index.paths] : void 0;
+}
 /** Checks if any vector search index is available. */
 function isVectorSearchableImpl(host) {
 	for (const index of host.getMongoSearchIndexes().values()) if (index.type === "vector") return true;
@@ -663,7 +688,7 @@ function isVectorSearchableImpl(host) {
 */
 function requireSearchStage(host, text, indexName, controls) {
 	const plan = buildSearchStage(host, text, indexName, controls);
-	if (!plan) throw new Error(indexName ? `Search index "${indexName}" not found` : "No search index available");
+	if (!plan) throw new Error((0, _atscript_db.searchIndexNotFoundMessage)(indexName));
 	return plan;
 }
 /**
@@ -759,7 +784,7 @@ function resolveGeoKeyPath(host, indexName) {
 	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}"`
+		message: (0, _atscript_db.geoIndexNotFoundMessage)(host._table.tableName, indexName)
 	}]);
 	return field;
 }
@@ -935,13 +960,13 @@ function buildVectorSearchStage(host, vector, indexName, limit) {
 	let index;
 	if (indexName) {
 		const found = host.getMongoSearchIndex(indexName);
-		if (!found || found.type !== "vector") throw new Error(`Vector index "${indexName}" not found`);
+		if (!found || found.type !== "vector") throw new Error((0, _atscript_db.vectorIndexNotFoundMessage)(indexName));
 		index = found;
 	} else for (const idx of host.getMongoSearchIndexes().values()) if (idx.type === "vector") {
 		index = idx;
 		break;
 	}
-	if (!index) throw new Error("No vector index available");
+	if (!index) throw new Error((0, _atscript_db.vectorIndexNotFoundMessage)());
 	let vectorField;
 	if (index.definition.fields) {
 		for (const f of index.definition.fields) if (f.type === "vector") {
@@ -1975,7 +2000,7 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 				path: field,
 				similarity: vectorIndex.similarity || "cosine",
 				numDimensions: vectorIndex.dimensions
-			}] });
+			}] }, { paths: [field] });
 			const threshold = metadata.get("db.search.vector.threshold");
 			if (threshold !== void 0) this._vectorThresholds.set(mongoIndexKey("vector", indexName), threshold);
 		}
@@ -2461,7 +2486,8 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 			type,
 			definition,
 			fuzzy: meta?.fuzzy,
-			strategy: meta?.strategy
+			strategy: meta?.strategy,
+			paths: meta?.paths ?? (type === "search_text" ? [] : void 0)
 		};
 		this._mongoIndexes.set(key, index);
 		return index;
@@ -2478,6 +2504,7 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 		let index = this._mongoIndexes.get(mongoIndexKey(type, name));
 		if (!index && type === "search_text") index = this._setSearchIndex(type, name, { mappings: { fields: {} } });
 		if (!index) return;
+		if (index.paths && !index.paths.includes(fieldName)) index.paths.push(fieldName);
 		const rootFields = index.definition.mappings.fields;
 		const segments = fieldName.split(".");
 		const topKey = this._table.columnMap.get(segments[0]) ?? segments[0];

package/dist/index.d.cts

@@ -185,6 +185,12 @@ interface TSearchIndex {
    * - `text` — single `text` operator over all string-mapped fields.
    */
   strategy?: "compound" | "autocomplete" | "text";
+  /**
+   * LOGICAL paths of the fields the index maps (search_text) or embeds
+   * (vector); absent for a dynamic mapping (every field). Reported as
+   * `TSearchIndexInfo.fields` (since 0.1.143).
+   */
+  paths?: string[];
 }
 type TMongoIndex = TPlainIndex | TSearchIndex;
 declare function mongoIndexKey(type: TMongoIndex["type"], name: string): string;
@@ -459,6 +465,7 @@ declare class MongoAdapter extends BaseDbAdapter {
       maxEdits: number;
     };
     strategy?: TSearchIndex["strategy"];
+    paths?: string[];
   }): TSearchIndex;
   /**
    * Adds (and merges, by mapping `type`) one or more Atlas field-type mappings to

package/dist/index.d.mts

@@ -185,6 +185,12 @@ interface TSearchIndex {
    * - `text` — single `text` operator over all string-mapped fields.
    */
   strategy?: "compound" | "autocomplete" | "text";
+  /**
+   * LOGICAL paths of the fields the index maps (search_text) or embeds
+   * (vector); absent for a dynamic mapping (every field). Reported as
+   * `TSearchIndexInfo.fields` (since 0.1.143).
+   */
+  paths?: string[];
 }
 type TMongoIndex = TPlainIndex | TSearchIndex;
 declare function mongoIndexKey(type: TMongoIndex["type"], name: string): string;
@@ -459,6 +465,7 @@ declare class MongoAdapter extends BaseDbAdapter {
       maxEdits: number;
     };
     strategy?: TSearchIndex["strategy"];
+    paths?: string[];
   }): TSearchIndex;
   /**
    * Adds (and merges, by mapping `type`) one or more Atlas field-type mappings to

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as queryNodeToExpr, i as orNull, n as distinctCountExpr, r as buildMongoFilter, t as buildAccumulator } from "./mongo-accumulator-Dc0w4t0l.mjs";
-import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, BaseDbAdapter, DbError, DbSpace, bucketTimeZoneUnavailable, computeInsights, createFailureCollector, getDbFieldOp, getKeyProps, isAtscriptDbView, isFieldRef, resolveDesignType, tableNameOf, translateQueryTree } from "@atscript/db";
+import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, BaseDbAdapter, DbError, DbSpace, UniquSelect, bucketTimeZoneUnavailable, computeInsights, createFailureCollector, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, isAtscriptDbView, isFieldRef, resolveDesignType, searchIndexNotFoundMessage, tableNameOf, translateQueryTree, vectorIndexNotFoundMessage } from "@atscript/db";
 import { MongoClient, MongoServerError, ObjectId } from "mongodb";
 import { resolveAggregateSearch } from "@atscript/db/agg";
 //#region src/lib/path-utils.ts
@@ -568,12 +568,14 @@ function buildLookupInnerPipeline(withRel, requiredFields) {
 	if (sort) pipeline.push({ $sort: sort });
 	if (skip) pipeline.push({ $skip: skip });
 	if (limit !== null && limit !== void 0) pipeline.push({ $limit: limit });
-	if (select) {
-		const projection = {};
-		for (const f of select) projection[f] = 1;
-		for (const f of requiredFields) projection[f] = 1;
-		if (!select.includes("_id") && !requiredFields.includes("_id")) projection["_id"] = 0;
-		pipeline.push({ $project: dedupeProjection(projection) });
+	const projection = select ? new UniquSelect(select).asProjection : void 0;
+	if (projection) {
+		const project = { ...projection };
+		if (Object.values(project).some((flag) => flag === 1 || flag === true)) {
+			for (const f of requiredFields) project[f] = 1;
+			if (!("_id" in projection) && !requiredFields.includes("_id")) project._id = 0;
+		} else for (const f of requiredFields) delete project[f];
+		if (Object.keys(project).length > 0) pipeline.push({ $project: dedupeProjection(project) });
 	}
 	return pipeline;
 }
@@ -641,16 +643,39 @@ function findRemoteFK(target, thisTableName, alias) {
 }
 //#endregion
 //#region src/lib/mongo-search.ts
-/** Returns available search indexes as generic metadata for UI. */
+/**
+* Returns available search indexes as generic metadata for UI. The text
+* default is the `DEFAULT` entry (an alias of the index `search()` answers
+* with when none is named); the vector default is the first vector index.
+*/
 function getSearchIndexesImpl(host) {
 	const result = [];
-	for (const [name, index] of host.getMongoSearchIndexes()) result.push({
-		name,
-		description: `${index.type} index`,
-		type: index.type === "vector" ? "vector" : "text"
-	});
+	let firstVector = true;
+	for (const [name, index] of host.getMongoSearchIndexes()) {
+		const isVector = index.type === "vector";
+		result.push({
+			name,
+			description: `${index.type} index`,
+			type: isVector ? "vector" : "text",
+			fields: searchIndexPaths(host, index),
+			isDefault: isVector ? firstVector : name === DEFAULT_INDEX_NAME
+		});
+		if (isVector) firstVector = false;
+	}
 	return result;
 }
+/**
+* LOGICAL paths an index reads: a classic text index by its `@db.index.fulltext`
+* definition, an Atlas index by the paths it maps; `undefined` (every field)
+* for a dynamic mapping or an index whose fields cannot be told.
+*/
+function searchIndexPaths(host, index) {
+	if (index.type === "text") {
+		const source = host._table.indexes.get(index.key);
+		return source ? host._indexLogicalPaths(source) : void 0;
+	}
+	return "paths" in index && index.paths ? [...index.paths] : void 0;
+}
 /** Checks if any vector search index is available. */
 function isVectorSearchableImpl(host) {
 	for (const index of host.getMongoSearchIndexes().values()) if (index.type === "vector") return true;
@@ -662,7 +687,7 @@ function isVectorSearchableImpl(host) {
 */
 function requireSearchStage(host, text, indexName, controls) {
 	const plan = buildSearchStage(host, text, indexName, controls);
-	if (!plan) throw new Error(indexName ? `Search index "${indexName}" not found` : "No search index available");
+	if (!plan) throw new Error(searchIndexNotFoundMessage(indexName));
 	return plan;
 }
 /**
@@ -758,7 +783,7 @@ function resolveGeoKeyPath(host, indexName) {
 	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}"`
+		message: geoIndexNotFoundMessage(host._table.tableName, indexName)
 	}]);
 	return field;
 }
@@ -934,13 +959,13 @@ function buildVectorSearchStage(host, vector, indexName, limit) {
 	let index;
 	if (indexName) {
 		const found = host.getMongoSearchIndex(indexName);
-		if (!found || found.type !== "vector") throw new Error(`Vector index "${indexName}" not found`);
+		if (!found || found.type !== "vector") throw new Error(vectorIndexNotFoundMessage(indexName));
 		index = found;
 	} else for (const idx of host.getMongoSearchIndexes().values()) if (idx.type === "vector") {
 		index = idx;
 		break;
 	}
-	if (!index) throw new Error("No vector index available");
+	if (!index) throw new Error(vectorIndexNotFoundMessage());
 	let vectorField;
 	if (index.definition.fields) {
 		for (const f of index.definition.fields) if (f.type === "vector") {
@@ -1974,7 +1999,7 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 				path: field,
 				similarity: vectorIndex.similarity || "cosine",
 				numDimensions: vectorIndex.dimensions
-			}] });
+			}] }, { paths: [field] });
 			const threshold = metadata.get("db.search.vector.threshold");
 			if (threshold !== void 0) this._vectorThresholds.set(mongoIndexKey("vector", indexName), threshold);
 		}
@@ -2460,7 +2485,8 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 			type,
 			definition,
 			fuzzy: meta?.fuzzy,
-			strategy: meta?.strategy
+			strategy: meta?.strategy,
+			paths: meta?.paths ?? (type === "search_text" ? [] : void 0)
 		};
 		this._mongoIndexes.set(key, index);
 		return index;
@@ -2477,6 +2503,7 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 		let index = this._mongoIndexes.get(mongoIndexKey(type, name));
 		if (!index && type === "search_text") index = this._setSearchIndex(type, name, { mappings: { fields: {} } });
 		if (!index) return;
+		if (index.paths && !index.paths.includes(fieldName)) index.paths.push(fieldName);
 		const rootFields = index.definition.mappings.fields;
 		const segments = fieldName.split(".");
 		const topKey = this._table.columnMap.get(segments[0]) ?? segments[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-mongo",
-  "version": "0.1.142",
+  "version": "0.1.143",
   "description": "Mongodb plugin for atscript.",
   "keywords": [
     "atscript",
@@ -58,7 +58,7 @@
     "@atscript/typescript": "^0.1.95",
     "@uniqu/core": "^0.1.11",
     "mongodb": "^6.17.0",
-    "@atscript/db": "^0.1.142"
+    "@atscript/db": "^0.1.143"
   },
   "scripts": {
     "postinstall": "asc -f dts",