@toa.io/storages.mongodb 1.0.0-alpha.313 → 1.0.0-alpha.315

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 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.315](https://github.com/toa-io/toa/compare/v1.0.0-alpha.314...v1.0.0-alpha.315) (2026-09-23)
+
+**Note:** Version bump only for package @toa.io/storages.mongodb
+
+
+
+
+
+# [1.0.0-alpha.314](https://github.com/toa-io/toa/compare/v1.0.0-alpha.313...v1.0.0-alpha.314) (2026-09-19)
+
+* feat(core)!: let an operation state how long its calls are remembered ([af177c2](https://github.com/toa-io/toa/commit/af177c2ab3d00d475840b5ef9e612f04e82b72bd))
+
+### BREAKING CHANGES
+
+* `inbox.retention` under 600 is refused. See
+  migrations/313.md.
+
+
 # [1.0.0-alpha.313](https://github.com/toa-io/toa/compare/v1.0.0-alpha.312...v1.0.0-alpha.313) (2026-09-18)
 
 **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.313",
+  "version": "1.0.0-alpha.315",
   "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.311",
-    "@toa.io/core": "1.0.0-alpha.312",
-    "@toa.io/definitions": "1.0.0-alpha.313",
+    "@toa.io/core": "1.0.0-alpha.315",
+    "@toa.io/definitions": "1.0.0-alpha.315",
     "@toa.io/generic": "1.0.0-alpha.311",
     "@toa.io/pointer": "1.0.0-alpha.311",
     "mongodb": "7.6.0",
     "openspan": "1.0.0-alpha.305"
   },
-  "gitHead": "7da3b2627ceeefd1fa19d5c8851be88d928523b6"
+  "gitHead": "d88ed286bf44bf95b5f3d9db6e7d4621261dbb99"
 }

package/src/inbox.js

@@ -39,12 +39,18 @@ export class Inbox {
    * whole mechanism: the call has been made, this transaction changes nothing, and the caller
    * is answered from what is already there.
    *
-   * @param {{ id: string, reply: object }} call
+   * The record carries the moment it expires rather than leaving that to the index, because the
+   * window is the operation's where it states one, and an index has one window for all of them.
+   *
+   * @param {{ id: string, reply: object, retention?: number }} call
    * @param {import('mongodb').ClientSession} session
    */
   async insert(call, session) {
+    const at = new Date()
+    const expires = new Date(at.getTime() + (call.retention ?? this.#retention) * 1000)
+
     await this.#collection.insertOne(
-      { _id: call.id, reply: call.reply ?? {}, at: new Date() },
+      { _id: call.id, reply: call.reply ?? {}, at, expires },
       { session }
     )
   }
@@ -56,18 +62,44 @@ export class Inbox {
    */
   async index() {
     const desired = {
-      // how long a call is remembered is how long a duplicate of it is caught
-      inbox_at: {
-        fields: { at: 1 },
-        options: { name: 'inbox_at', expireAfterSeconds: this.#retention }
+      // a record is reaped at the moment it names, which is how each keeps a window of its own
+      inbox_expires: {
+        fields: { expires: 1 },
+        options: { name: 'inbox_expires', expireAfterSeconds: 0 }
       }
     }
 
+    await this.#backfill()
+
     for (const { fields, options } of Object.values(desired))
       await index(this.#collection, fields, options)
 
     await prune(this.#collection, Object.keys(desired))
   }
+
+  /**
+   * A record written before a record named its own expiry was reaped by an index on `at`, which
+   * this replaces. One with no `expires` would be kept forever under the new index, so it is
+   * given the one it had: the deployment's window after it was written. Done before the old
+   * index is pruned, so that nothing is left unreaped in between, and on every boot, because a
+   * process of the previous release may still be writing them during a rolling deploy. After
+   * that it finds nothing.
+   */
+  async #backfill() {
+    await this.#collection.updateMany({ expires: { $exists: false } }, [
+      {
+        $set: {
+          expires: {
+            $dateAdd: {
+              startDate: { $ifNull: ['$at', '$$NOW'] },
+              unit: 'second',
+              amount: this.#retention
+            }
+          }
+        }
+      }
+    ])
+  }
 }
 
 function retention() {
@@ -77,7 +109,7 @@ function retention() {
 }
 
 /**
- * Seconds a call is remembered. An hour, and not the outbox's day: what a duplicate arrives
+ * Seconds a call of an operation that states no window of its own is remembered. An hour, and not the outbox's day: what a duplicate arrives
  * within is the broker's redelivery, the five attempts `comq` makes of a message, and whatever
  * a client retries on — minutes. Every call of an operation that declares `once` is a document
  * here for this long.

package/src/storage.js

@@ -411,7 +411,7 @@ export class Storage extends Connector {
           call.reply?.output === undefined ? { ...call.reply, output: state } : call.reply
 
         try {
-          await this.#inbox.insert({ id: call.id, reply }, session)
+          await this.#inbox.insert({ ...call, reply }, session)
         } catch (error) {
           if (error?.code !== ERR_DUPLICATE_KEY) throw error