@toa.io/storages.mongodb 1.0.0-alpha.288 → 1.0.0-alpha.289

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 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.289](https://github.com/toa-io/toa/compare/v1.0.0-alpha.288...v1.0.0-alpha.289) (2026-09-07)
+
+* A deploy moves only what changed, and a component sees none of the runtime's environment (#1073) ([f38e3db](https://github.com/toa-io/toa/commit/f38e3db533f24db866c57bfa1ef294eff1eaf499)), closes [#1073](https://github.com/toa-io/toa/issues/1073) [#1064](https://github.com/toa-io/toa/issues/1064) [#1066](https://github.com/toa-io/toa/issues/1066) [#1067](https://github.com/toa-io/toa/issues/1067) [#1068](https://github.com/toa-io/toa/issues/1068) [#1069](https://github.com/toa-io/toa/issues/1069) [#1071](https://github.com/toa-io/toa/issues/1071) [#1070](https://github.com/toa-io/toa/issues/1070) [#1072](https://github.com/toa-io/toa/issues/1072)
+
+### BREAKING CHANGES
+
+* a component that read `process.env.TOA_*` reads `context` instead;
+  `echo(input)` no longer substitutes from the environment; a bash operation sees no
+  `TOA_*`; images no longer set `USER node` — see migrations/289.md.
+
+
 # [1.0.0-alpha.288](https://github.com/toa-io/toa/compare/v1.0.0-alpha.287...v1.0.0-alpha.288) (2026-09-06)
 
 **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.288",
+  "version": "1.0.0-alpha.289",
   "type": "module",
   "description": "Toa MongoDB Storage Connector",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -20,13 +20,13 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/conveyor": "1.0.0-alpha.286",
-    "@toa.io/core": "1.0.0-alpha.288",
-    "@toa.io/generic": "1.0.0-alpha.286",
-    "@toa.io/pointer": "1.0.0-alpha.287",
+    "@toa.io/conveyor": "1.0.0-alpha.289",
+    "@toa.io/core": "1.0.0-alpha.289",
+    "@toa.io/generic": "1.0.0-alpha.289",
+    "@toa.io/pointer": "1.0.0-alpha.289",
     "mongodb": "7.6.0",
     "openspan": "1.0.0-alpha.286",
     "saslprep": "1.0.3"
   },
-  "gitHead": "d3d696f0a4e287c3c297ac81028d600ad7574112"
+  "gitHead": "4fcb482beac5896305d8084cdbc1d5fcf372d108"
 }

package/src/client.js

@@ -5,6 +5,7 @@
  */
 
 import { console } from 'openspan'
+import { environment } from '@toa.io/generic'
 import { Connector } from '@toa.io/core'
 import { resolve } from '@toa.io/pointer'
 import { ID } from './deployment.js'
@@ -182,7 +183,7 @@ export class Client extends Connector {
   async resolveURLs() {
     // Toa's own development stack is not on the conventional ports: the applications built on
     // Toa are, and they share the machine. See CONTRIBUTING.md.
-    if (process.env.TOA_DEV === '1') {
+    if (environment.get('TOA_DEV') === '1') {
       return ['mongodb://developer:secret@localhost:31020']
     } else {
       return await resolve(ID, this.locator.id)
@@ -194,13 +195,11 @@ export class Client extends Connector {
    * @return {string}
    */
   resolveDB() {
-    if (process.env.TOA_CONTEXT !== undefined) {
-      return process.env.TOA_CONTEXT
-    }
+    const context = environment.get('TOA_CONTEXT')
 
-    if (process.env.TOA_DEV === '1') {
-      return 'toa-dev'
-    }
+    if (context !== undefined) return context
+
+    if (environment.get('TOA_DEV') === '1') return 'toa-dev'
 
     throw new Error('Environment variable TOA_CONTEXT is not defined')
   }

package/src/outbox.js

@@ -1,4 +1,5 @@
 import { console } from 'openspan'
+import { environment } from '@toa.io/generic'
 
 /**
  * The outbox rows of one component. Its lifecycle is the Client's, so it is not a Connector.
@@ -160,7 +161,7 @@ const to = ({ id, ...rest }) => ({ _id: id, ...rest })
 const from = ({ _id, ...rest }) => ({ id: _id, ...rest })
 
 function retention() {
-  const value = Number(process.env.TOA_OUTBOX_RETENTION)
+  const value = Number(environment.get('TOA_OUTBOX_RETENTION'))
 
   return Number.isNaN(value) || value < 0 ? RETENTION : value
 }

package/src/storage.js

@@ -4,7 +4,6 @@ import { translate } from './translate.js'
 import { codec } from './record.js'
 import { Outbox } from './outbox.js'
 import { Migrations } from './migrations.js'
-import { SYSTEM } from './system.js'
 import { ReturnDocument } from 'mongodb'
 
 export class Storage extends Connector {
@@ -73,14 +72,16 @@ export class Storage extends Connector {
 
     this.#spans.clear()
 
-    // the runtime's own come first: what a component declares is written against a collection
-    // whose system properties are already what this release holds them as
-    this.#migrations = new Migrations(this.#client.db, this.#collection, [
-      ...SYSTEM,
-      ...(this.#entity.migrations ?? [])
-    ])
+    if (this.#entity.migrations?.length > 0) {
+      this.#migrations = new Migrations(
+        this.#client.db,
+        this.#collection,
+        this.#entity.migrations
+      )
+
+      await this.#migrations.run()
+    }
 
-    await this.#migrations.run()
     await this.#outbox?.index()
   }
 

package/test/storage.test.js

@@ -5,6 +5,7 @@ import { isDeepStrictEqual } from 'node:util'
 import { Storage } from '../src/storage.js'
 
 let collection
+let db
 let storage
 
 beforeEach(async () => {
@@ -15,25 +16,21 @@ beforeEach(async () => {
     updateMany: mock.fn(async () => ({ modifiedCount: 0 }))
   }
 
-  // the runtime's own migrations are applied to every collection, so a storage needs the
-  // database its record of them lives in
-  const state = {
-    insertOne: mock.fn(async () => ({})),
-    findOne: mock.fn(async () => null),
-    updateOne: mock.fn(async () => ({ modifiedCount: 1 }))
-  }
+  db = { collection: mock.fn(() => null) }
 
-  const client = {
-    collection,
-    db: { collection: () => state },
-    link: () => null
-  }
+  const client = { collection, db, link: () => null }
 
   storage = new Storage(client, { schema: { properties: {} } })
 
   await storage.open()
 })
 
+describe('open', () => {
+  it('should not touch the migrations record where the entity declares none', () => {
+    assert.equal(db.collection.mock.callCount(), 0)
+  })
+})
+
 describe('get', () => {
   it('should filter deleted', async () => {
     await storage.get({})

package/src/system.js

@@ -1,44 +0,0 @@
-/**
- * Migrations the runtime owns, applied to every collection ahead of whatever the component
- * declares.
- *
- * These convert what the runtime itself writes, so they are declared here rather than in a
- * migration every component would have to write — the same reason the outbox keeps its own
- * indexes. A component cannot write them: it does not own the system properties, and a
- * prototype's migrations are not inherited.
- *
- * They are applied once for the database, recorded beside the component's own, and named so
- * that the two can never collide.
- */
-export const SYSTEM = [
-  {
-    id: 'system:0001-epoch-millis',
-    steps: [
-      {
-        /*
-         * The system timestamps became dates: what sorts, compares and expires as a moment
-         * rather than as a number that happens to be one. A record written before this holds
-         * them as milliseconds, and a collection holding both would sort every number ahead of
-         * every date — so the release that brings this stops the deployment first.
-         *
-         * `CREATED` says whether a record has been converted, because every record has one.
-         * Null passes through both conversions, which is what an undeleted record's `DELETED`
-         * is; and the widening is not decoration — MongoDB makes a date from a long and
-         * refuses one from an int, and a small enough millisecond is stored as an int.
-         */
-        update: {
-          filter: { CREATED: { $type: 'number' } },
-          update: [
-            {
-              $set: {
-                CREATED: { $toDate: { $toLong: '$CREATED' } },
-                UPDATED: { $toDate: { $toLong: '$UPDATED' } },
-                DELETED: { $toDate: { $toLong: '$DELETED' } }
-              }
-            }
-          ]
-        }
-      }
-    ]
-  }
-]