@toa.io/storages.mongodb 1.0.0-alpha.301 → 1.0.0-alpha.303

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.303](https://github.com/toa-io/toa/compare/v1.0.0-alpha.302...v1.0.0-alpha.303) (2026-09-12)
+
+### Features
+
+* **metrics:** measure storage, stash, blob storages and fetch ([252298b](https://github.com/toa-io/toa/commit/252298bb9f34421694da4ee89742d62b47c39dfb))
+
+### Performance Improvements
+
+* **storages.mongodb:** rename a record's _id to id in place ([4aeb2a1](https://github.com/toa-io/toa/commit/4aeb2a1d61f7f2b0ddab203b5887152e8917ef7f))
+
+
+# [1.0.0-alpha.302](https://github.com/toa-io/toa/compare/v1.0.0-alpha.301...v1.0.0-alpha.302) (2026-09-11)
+
+**Note:** Version bump only for package @toa.io/storages.mongodb
+
+
+
+
+
 # [1.0.0-alpha.301](https://github.com/toa-io/toa/compare/v1.0.0-alpha.300...v1.0.0-alpha.301) (2026-09-11)
 
 **Note:** Version bump only for package @toa.io/storages.mongodb

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/storages.mongodb",
-  "version": "1.0.0-alpha.301",
+  "version": "1.0.0-alpha.303",
   "type": "module",
   "description": "Toa MongoDB Storage Connector",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,12 +21,12 @@
   },
   "dependencies": {
     "@toa.io/conveyor": "1.0.0-alpha.301",
-    "@toa.io/core": "1.0.0-alpha.301",
-    "@toa.io/definitions": "1.0.0-alpha.301",
+    "@toa.io/core": "1.0.0-alpha.303",
+    "@toa.io/definitions": "1.0.0-alpha.303",
     "@toa.io/generic": "1.0.0-alpha.301",
     "@toa.io/pointer": "1.0.0-alpha.301",
     "mongodb": "7.6.0",
-    "openspan": "1.0.0-alpha.301"
+    "openspan": "1.0.0-alpha.303"
   },
-  "gitHead": "cc49bc90efd35464b2ad7803246786c607a44685"
+  "gitHead": "b8e9dd89f6d49756944687a95dfc786f12947286"
 }

package/readme.md

@@ -2,8 +2,7 @@
 
 ## Tracing
 
-Commands are recorded as `client` spans within the trace of the current invocation,
-using the [driver command monitoring events](https://www.mongodb.com/docs/drivers/node/current/monitoring/command-monitoring/).
+Commands are recorded as `client` spans within the trace of the current invocation.
 
 Spans are named `{command} {collection}` and carry `db.*` attributes following the
 [OpenTelemetry semantic conventions](https://opentelemetry.io/docs/specs/semconv/database/mongodb/):

package/src/measurements.js

@@ -0,0 +1,39 @@
+import { registry } from 'openspan'
+
+/**
+ * What this storage measures. `provider` is which database it is, so that a deployment running more
+ * than one can be read a kind at a time. No database label: the database is the context, which
+ * every series already carries as its resource.
+ */
+const meters = registry()
+
+/** Prometheus' own ladder, in seconds: from five milliseconds to ten seconds. */
+const DURATIONS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+
+const PROVIDER = 'mongodb'
+
+const duration = meters.histogram(
+  'toa.storage.query.duration',
+  { buckets: DURATIONS, unit: 's' },
+  { provider: null, collection: null, operation: null }
+)
+
+/**
+ * A compare-and-swap that lost. Whether it is retried or raised is the operation's to declare, and
+ * the retried one succeeds — so without this it is a duration that grew and nothing else.
+ */
+const conflicts = meters.counter('toa.storage.conflicts', {
+  provider: null,
+  collection: null
+})
+
+export function query(collection, operation) {
+  return {
+    histogram: duration,
+    labels: { provider: PROVIDER, collection, operation }
+  }
+}
+
+export function conflicted(collection) {
+  conflicts.add(1, { provider: PROVIDER, collection })
+}

package/src/record.js

@@ -4,12 +4,18 @@ export function to(entity) {
   return /** @type {toa.mongodb.Record} */ { _id: id, ...rest }
 }
 
+/**
+ * Renamed in the object the driver decoded, which is a new one for every document; an entity
+ * copies a state before an operation that writes changes it. A copy costs ten times the rename,
+ * and what it would keep is only `id` in front, which a reply does not promise.
+ */
 export function from(record) {
   if (record === undefined || record === null) return null
 
-  const { _id, ...rest } = record
+  record.id = record._id
+  delete record._id
 
-  return { id: _id, ...rest }
+  return record
 }
 
 /**

package/src/storage.js

@@ -5,6 +5,7 @@ import { codec } from './record.js'
 import { Inbox } from './inbox.js'
 import { Outbox } from './outbox.js'
 import { Migrations } from './migrations.js'
+import { conflicted, query } from './measurements.js'
 import { ReturnDocument } from 'mongodb'
 
 export class Storage extends Connector {
@@ -184,6 +185,9 @@ export class Storage extends Connector {
       this.#collection.findOneAndReplace(criteria, record, { session })
     )
 
+    // the version moved under this write: whoever asked either retries it or raises
+    if (result === null) conflicted(this.#collection.collectionName)
+
     return result !== null
   }
 
@@ -509,7 +513,8 @@ export class Storage extends Connector {
           'db.namespace': this.#collection.dbName,
           'db.operation.name': method,
           'db.collection.name': collection
-        }
+        },
+        measure: query(collection, method)
       }
 
       this.#spans.set(method, options)