@atscript/db-mongo 0.1.163 → 0.1.165

package/dist/index.cjs

@@ -1025,21 +1025,36 @@ function filterOptionsOf(host) {
 	return { collation: require_mongo_accumulator.collationOfAdapter(host) };
 }
 /**
-* 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.
+* Returns available search indexes as generic metadata for UI. Each index is
+* listed once, by its declared name; the text default (the index `search()`
+* answers with when none is named) carries `isDefault` and lists `DEFAULT` —
+* which also resolves — as an alias (since 0.1.165). Only an index without a
+* name of its own (a dynamic Atlas mapping) is listed as `DEFAULT`. The vector
+* default is the first vector index.
 */
+/** Classic `$text` relevance order: `textScore` descending, `_id` breaking ties (since 0.1.165). */
+const RELEVANCE_SORT = { $sort: {
+	_score: -1,
+	_id: 1
+} };
 function getSearchIndexesImpl(host) {
 	const result = [];
+	const indexes = host.getMongoSearchIndexes();
+	const textDefault = indexes.get(DEFAULT_INDEX_NAME);
+	let defaultListedByName = false;
+	for (const [name, index] of indexes) if (index === textDefault && name !== "DEFAULT") defaultListedByName = true;
 	let firstVector = true;
-	for (const [name, index] of host.getMongoSearchIndexes()) {
+	for (const [name, index] of indexes) {
 		const isVector = index.type === "vector";
+		const aliased = !isVector && index === textDefault && name !== "DEFAULT";
+		if (name === "DEFAULT" && defaultListedByName) continue;
 		result.push({
 			name,
+			...aliased ? { aliases: [DEFAULT_INDEX_NAME] } : {},
 			description: `${index.type} index`,
 			type: isVector ? "vector" : "text",
 			fields: searchIndexPaths(host, index),
-			isDefault: isVector ? firstVector : name === DEFAULT_INDEX_NAME
+			isDefault: isVector ? firstVector : index === textDefault
 		});
 		if (isVector) firstVector = false;
 	}
@@ -1514,7 +1529,7 @@ async function runSearchPipeline(host, stage, query, label, { threshold, classic
 	pipeline.push(...filterStages ?? require_mongo_accumulator.mongoFilterStages(query.filter, filterOptionsOf(host)));
 	const { stages: sorted, cleanup } = require_mongo_accumulator.sortStages(controls);
 	if (sorted.length > 0) pipeline.push(...sorted);
-	else if (classicText) pipeline.push({ $sort: { _score: -1 } });
+	else if (classicText) pipeline.push(RELEVANCE_SORT);
 	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
 	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
 	else pipeline.push({ $limit: 1e3 });
@@ -1544,7 +1559,7 @@ async function runSearchWithCountPipeline(host, stage, query, label, { threshold
 		preStages.push({ $match: { _score: { $gte: threshold } } });
 	} else if (classicText) preStages.push({ $addFields: { _score: { $meta: "textScore" } } });
 	const { stages: dataStages, cleanup } = require_mongo_accumulator.sortStages(controls);
-	if (dataStages.length === 0 && classicText) dataStages.push({ $sort: { _score: -1 } });
+	if (dataStages.length === 0 && classicText) dataStages.push(RELEVANCE_SORT);
 	if (controls.$skip) dataStages.push({ $skip: controls.$skip });
 	if (controls.$limit) dataStages.push({ $limit: controls.$limit });
 	if (cleanup) dataStages.push(cleanup);
@@ -2212,6 +2227,37 @@ const validateMongoIdPlugin = (ctx, def, value) => {
 	}
 };
 //#endregion
+//#region src/lib/mongo-transaction-support.ts
+const verdicts = /* @__PURE__ */ new WeakMap();
+/** Whether the client's server runs transactions, asked once per client; a failed probe is retried. */
+function transactionSupport(client) {
+	let verdict = verdicts.get(client);
+	if (!verdict) {
+		verdict = probe(client).catch((error) => {
+			verdicts.delete(client);
+			throw error;
+		});
+		verdicts.set(client, verdict);
+	}
+	return verdict;
+}
+/**
+* A replica-set member reports `setName` (an uninitiated `--replSet` member
+* `isreplicaset: true`), a mongos — also behind a load balancer —
+* `msg: 'isdbgrid'`. Anything else is a standalone `mongod`.
+*/
+async function probe(client) {
+	const admin = client.db("admin");
+	let reply;
+	try {
+		reply = await admin.command({ hello: 1 });
+	} catch (error) {
+		if (!(error instanceof mongodb.MongoServerError) || error.code !== 59) throw error;
+		reply = await admin.command({ isMaster: 1 });
+	}
+	return reply.setName != null || reply.isreplicaset === true || reply.msg === "isdbgrid";
+}
+//#endregion
 //#region src/lib/mongo-adapter.ts
 /** Mirrors the `mongo.objectId` primitive's pattern — only definite hex ids convert. */
 const OBJECT_ID_HEX = /^[a-fA-F0-9]{24}$/;
@@ -2297,48 +2343,30 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 		return other instanceof MongoAdapter && other._transactionOwner() === this._transactionOwner() && other.db.databaseName === this.db.databaseName;
 	}
 	/**
-	* Per-client cache: whether transactions are unavailable (standalone MongoDB).
-	* Shared across all adapter instances for the same client so topology is probed once.
-	*/
-	static _txDisabledClients = /* @__PURE__ */ new WeakSet();
-	get _txDisabled() {
-		return this.client ? MongoAdapter._txDisabledClients.has(this.client) : true;
-	}
-	set _txDisabled(value) {
-		if (value && this.client) MongoAdapter._txDisabledClients.add(this.client);
-	}
-	/**
 	* Uses MongoDB's Convenient Transaction API (`session.withTransaction()`).
 	* This handles txnNumber management and automatic retry for
 	* `TransientTransactionError` / `UnknownTransactionCommitResult`.
 	*
+	* Transaction support is read from the server, not the connection mode: a
+	* `directConnection=true` client to a replica-set primary runs real
+	* transactions; a standalone `mongod` (or an adapter without a client)
+	* runs `fn` without one.
+	*
 	* `opts.isolation` (since 0.1.162): a MongoDB transaction reads one
 	* snapshot, which satisfies `'read committed'` and `'repeatable read'`;
 	* `'serializable'` throws `ISOLATION_NOT_SUPPORTED` (snapshot isolation
-	* allows write skew), and so does any level on a topology without
-	* transactions (standalone), where `fn` would run without one.
+	* allows write skew), and so does any level where `fn` would run without
+	* a transaction.
 	*/
 	async withTransaction(fn, opts) {
 		const isolation = this._checkIsolation(opts);
 		if (this._getTransactionState()) return fn();
-		const passThrough = () => {
-			if (isolation) throw this._isolationNotSupported(`Isolation '${isolation}' needs a MongoDB transaction — this topology (standalone) has none`);
+		const passThrough = (reason) => {
+			if (isolation) throw this._isolationNotSupported(`Isolation '${isolation}' needs a MongoDB transaction — ${reason}`);
 			return fn();
 		};
-		if (this._txDisabled || !this._client) return passThrough();
-		try {
-			const topology = this._client.topology;
-			if (topology) {
-				const type = (topology.description ?? topology.s?.description)?.type;
-				if (type === "Single" || type === "Unknown") {
-					this._txDisabled = true;
-					return passThrough();
-				}
-			}
-		} catch {
-			this._txDisabled = true;
-			return passThrough();
-		}
+		if (!this._client) return passThrough("the adapter was created without a MongoClient");
+		if (!await transactionSupport(this._client)) return passThrough("the server is a standalone mongod (transactions need a replica set or mongos)");
 		const session = this._client.startSession();
 		try {
 			let result;
@@ -2778,7 +2806,7 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 					weights: Object.fromEntries(index.fields.filter((f) => f.weight && !f.integer).map((f) => [f.name, f.weight]))
 				};
 				if (index === defaultFulltext) defaultIndex = converted;
-				else if (!this._searchIndexesMap.has(index.name)) this._searchIndexesMap.set(index.name, converted);
+				if (!this._searchIndexesMap.has(index.name)) this._searchIndexesMap.set(index.name, converted);
 			}
 			for (const index of this._mongoIndexes.values()) switch (index.type) {
 				case "text":
@@ -3014,10 +3042,10 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 	}
 	/** Rethrows a duplicate-key (11000) server error as `CONFLICT`, anything else as is. */
 	_mapConstraintError(error) {
-		if (error instanceof mongodb.MongoServerError && error.code === 11e3) throw new _atscript_db.DbError("CONFLICT", [{
-			path: error.keyPattern ? Object.keys(error.keyPattern)[0] ?? "" : "",
-			message: error.message
-		}]);
+		if (error instanceof mongodb.MongoServerError && error.code === 11e3) throw (0, _atscript_db.constraintViolation)("CONFLICT", {
+			columns: error.keyPattern ? Object.keys(error.keyPattern) : void 0,
+			name: error.message.match(/index: (\S+) dup key/)?.[1]
+		}, error.message);
 		throw error;
 	}
 	/** An update-shaped write under {@link _wrapDuplicateKeyError}, reduced to `TDbUpdateResult`. */
@@ -3213,11 +3241,13 @@ var MongoAdapter = class MongoAdapter extends _atscript_db.BaseDbAdapter {
 		};
 		const versionColumn = this._table.versionColumnPhysical;
 		const counters = this._table.onUpdateIncPhysical;
+		const keep = this._table.insertOnlyPhysical;
 		this._log("replaceOne", mongoFilter, data);
-		if (versionColumn !== void 0 || counters.length > 0) {
+		if (versionColumn !== void 0 || counters.length > 0 || keep.length > 0) {
 			const replacement = {};
 			for (const [key, value] of Object.entries(data)) replacement[key] = { $literal: value };
 			for (const col of counters) replacement[col] = incExpr(col, 1);
+			for (const col of keep) replacement[col] = `$${col}`;
 			if (versionColumn !== void 0) replacement[versionColumn] = { $add: [`$${versionColumn}`, 1] };
 			const pipeline = [{ $replaceWith: replacement }];
 			return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, pipeline, this._getSessionOpts()));

package/dist/index.d.cts

@@ -318,23 +318,21 @@ declare class MongoAdapter extends BaseDbAdapter {
    * client may serve several (since 0.1.147).
    */
   sharesStoreWith(other: BaseDbAdapter): boolean;
-  /**
-   * Per-client cache: whether transactions are unavailable (standalone MongoDB).
-   * Shared across all adapter instances for the same client so topology is probed once.
-   */
-  private static readonly _txDisabledClients;
-  private get _txDisabled();
-  private set _txDisabled(value);
   /**
    * Uses MongoDB's Convenient Transaction API (`session.withTransaction()`).
    * This handles txnNumber management and automatic retry for
    * `TransientTransactionError` / `UnknownTransactionCommitResult`.
    *
+   * Transaction support is read from the server, not the connection mode: a
+   * `directConnection=true` client to a replica-set primary runs real
+   * transactions; a standalone `mongod` (or an adapter without a client)
+   * runs `fn` without one.
+   *
    * `opts.isolation` (since 0.1.162): a MongoDB transaction reads one
    * snapshot, which satisfies `'read committed'` and `'repeatable read'`;
    * `'serializable'` throws `ISOLATION_NOT_SUPPORTED` (snapshot isolation
-   * allows write skew), and so does any level on a topology without
-   * transactions (standalone), where `fn` would run without one.
+   * allows write skew), and so does any level where `fn` would run without
+   * a transaction.
    */
   withTransaction<T>(fn: () => Promise<T>, opts?: TTransactionOptions): Promise<T>;
   private static readonly _ISOLATION_LEVELS;

package/dist/index.d.mts

@@ -318,23 +318,21 @@ declare class MongoAdapter extends BaseDbAdapter {
    * client may serve several (since 0.1.147).
    */
   sharesStoreWith(other: BaseDbAdapter): boolean;
-  /**
-   * Per-client cache: whether transactions are unavailable (standalone MongoDB).
-   * Shared across all adapter instances for the same client so topology is probed once.
-   */
-  private static readonly _txDisabledClients;
-  private get _txDisabled();
-  private set _txDisabled(value);
   /**
    * Uses MongoDB's Convenient Transaction API (`session.withTransaction()`).
    * This handles txnNumber management and automatic retry for
    * `TransientTransactionError` / `UnknownTransactionCommitResult`.
    *
+   * Transaction support is read from the server, not the connection mode: a
+   * `directConnection=true` client to a replica-set primary runs real
+   * transactions; a standalone `mongod` (or an adapter without a client)
+   * runs `fn` without one.
+   *
    * `opts.isolation` (since 0.1.162): a MongoDB transaction reads one
    * snapshot, which satisfies `'read committed'` and `'repeatable read'`;
    * `'serializable'` throws `ISOLATION_NOT_SUPPORTED` (snapshot isolation
-   * allows write skew), and so does any level on a topology without
-   * transactions (standalone), where `fn` would run without one.
+   * allows write skew), and so does any level where `fn` would run without
+   * a transaction.
    */
   withTransaction<T>(fn: () => Promise<T>, opts?: TTransactionOptions): Promise<T>;
   private static readonly _ISOLATION_LEVELS;

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { a as buildMongoQuery, c as planStages, f as sortStages, g as queryNodeToExpr, h as orNull, i as buildMongoFilter, l as correlate, n as distinctCountExpr, o as collationOfAdapter, p as exprToMongo, r as REL_FILTER_TEMP_PREFIX, s as mongoFilterStages, t as buildAccumulator, u as hasNullsPlacement } from "./mongo-accumulator-DMPFOscc.mjs";
 import { t as dynamicSearchEncryptedMessage } from "./search-messages-mQSpJ4GD.mjs";
-import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, BaseDbAdapter, DbError, DbSpace, andFilters, bucketTimeZoneUnavailable, computeInsights, containsRelationFilter, createChangeRecorder, createFailureCollector, defaultFulltextIndex, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, isAtscriptDbView, isFieldRef, isPlainObject, isViewType, queryReadColumns, relationStaticFilter, resolveDesignType, searchIndexNotFoundMessage, searchTermInteger, tableNameOf, translateQueryTree, uniqueKeyTuple, vectorIndexNotFoundMessage } from "@atscript/db";
+import { ALL_AGGREGATE_FNS, ALL_BUCKET_UNITS, ALL_VIEW_CAPABILITIES, BaseDbAdapter, DbError, DbSpace, andFilters, bucketTimeZoneUnavailable, computeInsights, constraintViolation, containsRelationFilter, createChangeRecorder, createFailureCollector, defaultFulltextIndex, geoIndexNotFoundMessage, getDbFieldOp, getKeyProps, getPath, isAtscriptDbView, isFieldRef, isPlainObject, isViewType, queryReadColumns, relationStaticFilter, resolveDesignType, searchIndexNotFoundMessage, searchTermInteger, tableNameOf, translateQueryTree, uniqueKeyTuple, vectorIndexNotFoundMessage } from "@atscript/db";
 import { MongoBulkWriteError, MongoClient, MongoServerError, ObjectId } from "mongodb";
 import { resolveAggregateSearch } from "@atscript/db/agg";
 //#region src/lib/path-utils.ts
@@ -1024,21 +1024,36 @@ function filterOptionsOf(host) {
 	return { collation: collationOfAdapter(host) };
 }
 /**
-* 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.
+* Returns available search indexes as generic metadata for UI. Each index is
+* listed once, by its declared name; the text default (the index `search()`
+* answers with when none is named) carries `isDefault` and lists `DEFAULT` —
+* which also resolves — as an alias (since 0.1.165). Only an index without a
+* name of its own (a dynamic Atlas mapping) is listed as `DEFAULT`. The vector
+* default is the first vector index.
 */
+/** Classic `$text` relevance order: `textScore` descending, `_id` breaking ties (since 0.1.165). */
+const RELEVANCE_SORT = { $sort: {
+	_score: -1,
+	_id: 1
+} };
 function getSearchIndexesImpl(host) {
 	const result = [];
+	const indexes = host.getMongoSearchIndexes();
+	const textDefault = indexes.get(DEFAULT_INDEX_NAME);
+	let defaultListedByName = false;
+	for (const [name, index] of indexes) if (index === textDefault && name !== "DEFAULT") defaultListedByName = true;
 	let firstVector = true;
-	for (const [name, index] of host.getMongoSearchIndexes()) {
+	for (const [name, index] of indexes) {
 		const isVector = index.type === "vector";
+		const aliased = !isVector && index === textDefault && name !== "DEFAULT";
+		if (name === "DEFAULT" && defaultListedByName) continue;
 		result.push({
 			name,
+			...aliased ? { aliases: [DEFAULT_INDEX_NAME] } : {},
 			description: `${index.type} index`,
 			type: isVector ? "vector" : "text",
 			fields: searchIndexPaths(host, index),
-			isDefault: isVector ? firstVector : name === DEFAULT_INDEX_NAME
+			isDefault: isVector ? firstVector : index === textDefault
 		});
 		if (isVector) firstVector = false;
 	}
@@ -1513,7 +1528,7 @@ async function runSearchPipeline(host, stage, query, label, { threshold, classic
 	pipeline.push(...filterStages ?? mongoFilterStages(query.filter, filterOptionsOf(host)));
 	const { stages: sorted, cleanup } = sortStages(controls);
 	if (sorted.length > 0) pipeline.push(...sorted);
-	else if (classicText) pipeline.push({ $sort: { _score: -1 } });
+	else if (classicText) pipeline.push(RELEVANCE_SORT);
 	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
 	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
 	else pipeline.push({ $limit: 1e3 });
@@ -1543,7 +1558,7 @@ async function runSearchWithCountPipeline(host, stage, query, label, { threshold
 		preStages.push({ $match: { _score: { $gte: threshold } } });
 	} else if (classicText) preStages.push({ $addFields: { _score: { $meta: "textScore" } } });
 	const { stages: dataStages, cleanup } = sortStages(controls);
-	if (dataStages.length === 0 && classicText) dataStages.push({ $sort: { _score: -1 } });
+	if (dataStages.length === 0 && classicText) dataStages.push(RELEVANCE_SORT);
 	if (controls.$skip) dataStages.push({ $skip: controls.$skip });
 	if (controls.$limit) dataStages.push({ $limit: controls.$limit });
 	if (cleanup) dataStages.push(cleanup);
@@ -2211,6 +2226,37 @@ const validateMongoIdPlugin = (ctx, def, value) => {
 	}
 };
 //#endregion
+//#region src/lib/mongo-transaction-support.ts
+const verdicts = /* @__PURE__ */ new WeakMap();
+/** Whether the client's server runs transactions, asked once per client; a failed probe is retried. */
+function transactionSupport(client) {
+	let verdict = verdicts.get(client);
+	if (!verdict) {
+		verdict = probe(client).catch((error) => {
+			verdicts.delete(client);
+			throw error;
+		});
+		verdicts.set(client, verdict);
+	}
+	return verdict;
+}
+/**
+* A replica-set member reports `setName` (an uninitiated `--replSet` member
+* `isreplicaset: true`), a mongos — also behind a load balancer —
+* `msg: 'isdbgrid'`. Anything else is a standalone `mongod`.
+*/
+async function probe(client) {
+	const admin = client.db("admin");
+	let reply;
+	try {
+		reply = await admin.command({ hello: 1 });
+	} catch (error) {
+		if (!(error instanceof MongoServerError) || error.code !== 59) throw error;
+		reply = await admin.command({ isMaster: 1 });
+	}
+	return reply.setName != null || reply.isreplicaset === true || reply.msg === "isdbgrid";
+}
+//#endregion
 //#region src/lib/mongo-adapter.ts
 /** Mirrors the `mongo.objectId` primitive's pattern — only definite hex ids convert. */
 const OBJECT_ID_HEX = /^[a-fA-F0-9]{24}$/;
@@ -2296,48 +2342,30 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 		return other instanceof MongoAdapter && other._transactionOwner() === this._transactionOwner() && other.db.databaseName === this.db.databaseName;
 	}
 	/**
-	* Per-client cache: whether transactions are unavailable (standalone MongoDB).
-	* Shared across all adapter instances for the same client so topology is probed once.
-	*/
-	static _txDisabledClients = /* @__PURE__ */ new WeakSet();
-	get _txDisabled() {
-		return this.client ? MongoAdapter._txDisabledClients.has(this.client) : true;
-	}
-	set _txDisabled(value) {
-		if (value && this.client) MongoAdapter._txDisabledClients.add(this.client);
-	}
-	/**
 	* Uses MongoDB's Convenient Transaction API (`session.withTransaction()`).
 	* This handles txnNumber management and automatic retry for
 	* `TransientTransactionError` / `UnknownTransactionCommitResult`.
 	*
+	* Transaction support is read from the server, not the connection mode: a
+	* `directConnection=true` client to a replica-set primary runs real
+	* transactions; a standalone `mongod` (or an adapter without a client)
+	* runs `fn` without one.
+	*
 	* `opts.isolation` (since 0.1.162): a MongoDB transaction reads one
 	* snapshot, which satisfies `'read committed'` and `'repeatable read'`;
 	* `'serializable'` throws `ISOLATION_NOT_SUPPORTED` (snapshot isolation
-	* allows write skew), and so does any level on a topology without
-	* transactions (standalone), where `fn` would run without one.
+	* allows write skew), and so does any level where `fn` would run without
+	* a transaction.
 	*/
 	async withTransaction(fn, opts) {
 		const isolation = this._checkIsolation(opts);
 		if (this._getTransactionState()) return fn();
-		const passThrough = () => {
-			if (isolation) throw this._isolationNotSupported(`Isolation '${isolation}' needs a MongoDB transaction — this topology (standalone) has none`);
+		const passThrough = (reason) => {
+			if (isolation) throw this._isolationNotSupported(`Isolation '${isolation}' needs a MongoDB transaction — ${reason}`);
 			return fn();
 		};
-		if (this._txDisabled || !this._client) return passThrough();
-		try {
-			const topology = this._client.topology;
-			if (topology) {
-				const type = (topology.description ?? topology.s?.description)?.type;
-				if (type === "Single" || type === "Unknown") {
-					this._txDisabled = true;
-					return passThrough();
-				}
-			}
-		} catch {
-			this._txDisabled = true;
-			return passThrough();
-		}
+		if (!this._client) return passThrough("the adapter was created without a MongoClient");
+		if (!await transactionSupport(this._client)) return passThrough("the server is a standalone mongod (transactions need a replica set or mongos)");
 		const session = this._client.startSession();
 		try {
 			let result;
@@ -2777,7 +2805,7 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 					weights: Object.fromEntries(index.fields.filter((f) => f.weight && !f.integer).map((f) => [f.name, f.weight]))
 				};
 				if (index === defaultFulltext) defaultIndex = converted;
-				else if (!this._searchIndexesMap.has(index.name)) this._searchIndexesMap.set(index.name, converted);
+				if (!this._searchIndexesMap.has(index.name)) this._searchIndexesMap.set(index.name, converted);
 			}
 			for (const index of this._mongoIndexes.values()) switch (index.type) {
 				case "text":
@@ -3013,10 +3041,10 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 	}
 	/** Rethrows a duplicate-key (11000) server error as `CONFLICT`, anything else as is. */
 	_mapConstraintError(error) {
-		if (error instanceof MongoServerError && error.code === 11e3) throw new DbError("CONFLICT", [{
-			path: error.keyPattern ? Object.keys(error.keyPattern)[0] ?? "" : "",
-			message: error.message
-		}]);
+		if (error instanceof MongoServerError && error.code === 11e3) throw constraintViolation("CONFLICT", {
+			columns: error.keyPattern ? Object.keys(error.keyPattern) : void 0,
+			name: error.message.match(/index: (\S+) dup key/)?.[1]
+		}, error.message);
 		throw error;
 	}
 	/** An update-shaped write under {@link _wrapDuplicateKeyError}, reduced to `TDbUpdateResult`. */
@@ -3212,11 +3240,13 @@ var MongoAdapter = class MongoAdapter extends BaseDbAdapter {
 		};
 		const versionColumn = this._table.versionColumnPhysical;
 		const counters = this._table.onUpdateIncPhysical;
+		const keep = this._table.insertOnlyPhysical;
 		this._log("replaceOne", mongoFilter, data);
-		if (versionColumn !== void 0 || counters.length > 0) {
+		if (versionColumn !== void 0 || counters.length > 0 || keep.length > 0) {
 			const replacement = {};
 			for (const [key, value] of Object.entries(data)) replacement[key] = { $literal: value };
 			for (const col of counters) replacement[col] = incExpr(col, 1);
+			for (const col of keep) replacement[col] = `$${col}`;
 			if (versionColumn !== void 0) replacement[versionColumn] = { $add: [`$${versionColumn}`, 1] };
 			const pipeline = [{ $replaceWith: replacement }];
 			return this._wrapUpdate(() => this.collection.updateOne(mongoFilter, pipeline, this._getSessionOpts()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-mongo",
-  "version": "0.1.163",
+  "version": "0.1.165",
   "description": "Mongodb plugin for atscript.",
   "keywords": [
     "atscript",
@@ -46,19 +46,19 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.109",
-    "@atscript/typescript": "^0.1.109",
+    "@atscript/core": "^0.2.1",
+    "@atscript/typescript": "^0.2.1",
     "@uniqu/core": "^0.1.15",
     "mongodb": "^6.17.0",
     "mongodb-memory-server-core": "^10.0.0",
-    "unplugin-atscript": "^0.1.109"
+    "unplugin-atscript": "^0.2.1"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.109",
-    "@atscript/typescript": "^0.1.109",
+    "@atscript/core": "^0.2.1",
+    "@atscript/typescript": "^0.2.1",
     "@uniqu/core": "^0.1.15",
     "mongodb": "^6.17.0",
-    "@atscript/db": "^0.1.163"
+    "@atscript/db": "^0.1.165"
   },
   "scripts": {
     "build": "vp pack",