@atscript/db-mongo 0.1.163 → 0.1.164

package/dist/index.cjs

@@ -2212,6 +2212,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 +2328,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;

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

@@ -2211,6 +2211,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 +2327,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-mongo",
-  "version": "0.1.163",
+  "version": "0.1.164",
   "description": "Mongodb plugin for atscript.",
   "keywords": [
     "atscript",
@@ -58,7 +58,7 @@
     "@atscript/typescript": "^0.1.109",
     "@uniqu/core": "^0.1.15",
     "mongodb": "^6.17.0",
-    "@atscript/db": "^0.1.163"
+    "@atscript/db": "^0.1.164"
   },
   "scripts": {
     "build": "vp pack",