@toa.io/operations 1.0.0-alpha.270 → 1.0.0-alpha.273

package/CHANGELOG.md

@@ -3,6 +3,58 @@
 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.273](https://github.com/toa-io/toa/compare/v1.0.0-alpha.272...v1.0.0-alpha.273) (2026-09-02)
+
+**Note:** Version bump only for package @toa.io/operations
+
+
+
+
+
+# [1.0.0-alpha.272](https://github.com/toa-io/toa/compare/v1.0.0-alpha.271...v1.0.0-alpha.272) (2026-09-01)
+
+
+* feat(atomicity)!: take a quorum of independent servers ([862562f](https://github.com/toa-io/toa/commit/862562f24d77ec00127dbbd88d43802b208c643b))
+* refactor(atomicity)!: take one Redis, not a cluster ([b0a4770](https://github.com/toa-io/toa/commit/b0a4770dff5dfe8fee4b9ae637a4dd297454fcd4))
+* refactor(core)!: pump the outbox in one cycle ([bf590fe](https://github.com/toa-io/toa/commit/bf590fe8ed59c701b5fd1a91ba4874685b79242f))
+* refactor(atomicity)!: rename the connector and free it of the outbox ([21f1a41](https://github.com/toa-io/toa/commit/21f1a41aceafcfd35c7620014062fe46b54afa95))
+* feat(core)!: commit events with the state that produced them ([1eb68cc](https://github.com/toa-io/toa/commit/1eb68cc435dbfa03faa16009fceb866693d22e1a)), closes [#20](https://github.com/toa-io/toa/issues/20)
+
+
+### Features
+
+* **atomicity:** make the interval a setting, and stop repeating n-and-i ([5c3a6d1](https://github.com/toa-io/toa/commit/5c3a6d1533751a21b7eb7d9c737f1a270bf5a5ae))
+
+
+### BREAKING CHANGES
+
+* `atomicity.redis` accepts a list again, of independent servers rather
+than cluster nodes, and refuses an even number of them.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+* `atomicity.redis` is a string. A list is refused at export.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+* `Storage.outbox.pending` takes a fourth argument, the id to
+continue from.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+* `@toa.io/partitions.redis` is now `@toa.io/atomicity`, and its
+`lanes(total)` is `slots(total)`. Redis is declared as `atomicity` in the context
+rather than `outbox.redis`, and read from `TOA_ATOMICITY_REDIS`.
+`TOA_OUTBOX_PARTITION_INTERVAL` is `TOA_ATOMICITY_INTERVAL`.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+* `event.changeset` is removed; use `origin` and `state`. `State`
+takes an `Outbox` in place of an `Emission`. `difference` is dropped from
+`@toa.io/generic` along with its last caller.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+
+
+
+
 # [1.0.0-alpha.270](https://github.com/toa-io/toa/compare/v1.0.0-alpha.269...v1.0.0-alpha.270) (2026-08-31)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/operations",
-  "version": "1.0.0-alpha.270",
+  "version": "1.0.0-alpha.273",
   "description": "Toa Deployment",
   "homepage": "https://toa.io",
   "author": {
@@ -27,12 +27,11 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/filesystem": "1.0.0-alpha.254",
-    "@toa.io/generic": "1.0.0-alpha.254",
-    "@toa.io/norm": "1.0.0-alpha.270",
-    "@toa.io/yaml": "1.0.0-alpha.254",
+    "@toa.io/generic": "1.0.0-alpha.273",
+    "@toa.io/norm": "1.0.0-alpha.273",
     "execa": "5.1.1",
-    "fs-extra": "11.1.1"
+    "fs-extra": "11.1.1",
+    "js-yaml": "4.3.1"
   },
-  "gitHead": "94400bdd411b4c25074ffcf58184580ddd060268"
+  "gitHead": "ad3284850ece95ffd5325fd0995707fc144c9c3d"
 }

package/src/deployment/.deployment/.describe/events.js

@@ -0,0 +1,67 @@
+'use strict'
+
+/**
+ * Tells each component which of its events something consumes. An event nobody consumes gets
+ * no emitter, no exchange and no outbox row, and a component none of whose events are consumed
+ * gets no outbox at all.
+ *
+ * A component that declares events always gets the variable, empty when nothing is consumed —
+ * an absent variable means every event, which is what a run without a deployment gets.
+ *
+ * @param {toa.norm.Context} context
+ * @param {toa.deployment.Dependency} dependency
+ */
+function events (context, dependency) {
+  const components = deployed(context)
+  const consumed = collect(components, context.events, dependency.events)
+
+  for (const { locator, events } of components) {
+    if (events === undefined) continue
+
+    const labels = Object.keys(events)
+      .filter((label) => consumed.has(locator.id + '.' + label))
+
+    dependency.variables[locator.label] ??= []
+
+    dependency.variables[locator.label].push({
+      name: VARIABLE + locator.uppercase,
+      value: labels.join(' ')
+    })
+  }
+}
+
+/**
+ * Every component this context deploys, its own and those its extensions bring. `components`
+ * holds only the former; the latter reach a deployment as instances of what they depend on,
+ * which is also how they are given the rest of their variables.
+ */
+function deployed (context) {
+  const components = new Map()
+
+  for (const instances of Object.values(context.dependencies ?? {}))
+    for (const { component } of instances)
+      components.set(component.locator.id, component)
+
+  return [...components.values()]
+}
+
+/**
+ * Everything that consumes an event of this context: the receivers of its own components, what
+ * a dependency declares it consumes, and what the context says is consumed outside it.
+ */
+function collect (components, declared, contributed) {
+  const consumed = new Set(declared ?? [])
+
+  for (const label of contributed ?? []) consumed.add(label)
+
+  for (const { receivers } of components)
+    for (const [label, receiver] of Object.entries(receivers ?? {}))
+      // a receiver with a source consumes from a foreign broker, not from this context
+      if (receiver.source === undefined) consumed.add(label)
+
+  return consumed
+}
+
+const VARIABLE = 'TOA_EVENTS_'
+
+exports.events = events

package/src/deployment/.deployment/describe.js

@@ -4,6 +4,7 @@ const desc = require('./.describe')
 const { addVariables } = require('./.describe/variables')
 const { addMounts } = require('./.describe/mounts')
 const { resources } = require('./.describe/resources')
+const { events } = require('./.describe/events')
 
 const describe = (context, compositions, dependency, image) => {
   const { services } = dependency
@@ -20,6 +21,51 @@ const describe = (context, compositions, dependency, image) => {
     }
   )
 
+  const atomicity = context.atomicity
+
+  if (atomicity?.redis !== undefined) {
+    const addresses = Array.isArray(atomicity.redis) ? atomicity.redis : [atomicity.redis]
+
+    // a lock is taken on `floor(n / 2) + 1` of them, so an even number tolerates no more
+    // losses than the odd number below it, and two tolerate fewer than one does
+    if (addresses.length % 2 === 0)
+      throw new Error(`'atomicity.redis' takes an odd number of addresses, ` +
+        `${addresses.length} given`)
+
+    dependency.variables.global.push({
+      name: 'TOA_ATOMICITY_REDIS',
+      value: addresses.join(' ')
+    })
+  }
+
+  if (atomicity?.interval !== undefined)
+    dependency.variables.global.push({
+      name: 'TOA_ATOMICITY_INTERVAL',
+      value: String(atomicity.interval)
+    })
+
+  const outbox = context.outbox
+
+  if (outbox?.interval !== undefined)
+    dependency.variables.global.push({
+      name: 'TOA_OUTBOX_INTERVAL',
+      value: String(outbox.interval)
+    })
+
+  if (outbox?.batch !== undefined)
+    dependency.variables.global.push({
+      name: 'TOA_OUTBOX_BATCH',
+      value: String(outbox.batch)
+    })
+
+  if (outbox?.retention !== undefined)
+    dependency.variables.global.push({
+      name: 'TOA_OUTBOX_RETENTION',
+      value: String(outbox.retention)
+    })
+
+  events(context, dependency)
+
   const credentials = context.registry?.credentials
 
   if (image !== undefined) {

package/src/deployment/.deployment/merge.js

@@ -13,6 +13,9 @@ const merge = (dependencies) => {
   /** @type {toa.deployment.dependency.Variables} */
   const variables = {}
 
+  /** event labels consumed by something other than a component's own receivers */
+  const events = []
+
   const mounts = {}
 
   /** @type {toa.deployment.dependency.Probe | false | undefined} */
@@ -23,13 +26,14 @@ const merge = (dependencies) => {
     if (dependency.services !== undefined) services.push(...dependency.services)
     if (dependency.proxies !== undefined) proxies.push(...dependency.proxies)
     if (dependency.variables !== undefined) append(variables, dependency.variables)
+    if (dependency.events !== undefined) events.push(...dependency.events)
     if (dependency.mounts !== undefined) append(mounts, dependency.mounts)
     if (dependency.probe !== undefined) probe = dependency.probe
   }
 
   reserve(services, probe)
 
-  return { references, services, proxies, variables, mounts, probe }
+  return { references, services, proxies, variables, mounts, events, probe }
 }
 
 /**

package/src/deployment/deployment.js

@@ -2,7 +2,7 @@
 
 const { join } = require('node:path')
 const { writeFile: write } = require('node:fs/promises')
-const { dump } = require('@toa.io/yaml')
+const jsyaml = require('js-yaml')
 const fs = require('fs-extra')
 
 const { merge, declare, describe } = require('./.deployment')
@@ -92,3 +92,7 @@ function addVariables (list, variables, used = new Set()) {
 const TEMPLATES = join(__dirname, 'chart/templates')
 
 exports.Deployment = Deployment
+
+function dump (object) {
+  return jsyaml.dump(object, { noRefs: true, lineWidth: -1 })
+}

package/src/deployment/images/composition.js

@@ -5,7 +5,6 @@ const fs = require('fs-extra')
 const { createHash } = require('node:crypto')
 
 const { Image } = require('./image')
-const { undef } = require('@toa.io/concise/source/expressions/undefined')
 
 class Composition extends Image {
   dockerfile = join(__dirname, 'composition.Dockerfile')

package/src/deployment/images/runtime-base.test.js

@@ -1,8 +1,8 @@
 'use strict'
 
 const { join } = require('node:path')
-const { readFile } = require('node:fs/promises')
-const { directory } = require('@toa.io/filesystem')
+const { mkdtemp, readFile } = require('node:fs/promises')
+const { tmpdir } = require('node:os')
 
 const { Image, RUNTIME_IMAGE } = require('./image')
 
@@ -41,7 +41,7 @@ describe('runtime base image', () => {
   let root
 
   beforeEach(async () => {
-    root = await directory.temp('toa-runtime-base-test')
+    root = await mkdtemp(join(tmpdir(), 'toa-runtime-base-test'))
   })
 
   it('should default build.image to version-pinned GHCR runtime image', async () => {

package/src/deployment/workspace.js

@@ -1,6 +1,8 @@
 'use strict'
 
-const { directory } = require('@toa.io/filesystem')
+const { mkdir, mkdtemp, readdir } = require('node:fs/promises')
+const { join, resolve } = require('node:path')
+const { tmpdir } = require('node:os')
 
 /**
  * @param {string} type
@@ -8,8 +10,15 @@ const { directory } = require('@toa.io/filesystem')
  * @return {Promise<string>}
  */
 async function create (type, path) {
-  if (path === undefined) path = await directory.temp('toa-' + type)
-  else path = await directory.ensure(path)
+  if (path === undefined) return await mkdtemp(join(tmpdir(), 'toa-' + type))
+
+  path = resolve(path)
+
+  await mkdir(path, { recursive: true })
+
+  const entries = await readdir(path)
+
+  if (entries.length > 0) throw new Error('Target directory must be empty')
 
   return path
 }

package/types/_deployment/dependency.d.ts

@@ -50,6 +50,7 @@ declare namespace toa.deployment {
       services?: Service[] // dependency.Service
       proxies?: Proxy[]
       variables?: Variables
+      events?: string[]
     }
 
   }
@@ -59,6 +60,7 @@ declare namespace toa.deployment {
     services?: _service.Service[] // deployment.Service
     proxies?: dependency.Proxy[]
     variables?: dependency.Variables
+    events?: string[]
   }
 
 }

package/types/dependency.ts

@@ -38,6 +38,8 @@ export interface Dependency {
   services?: Service[]
   variables?: Variables
   mounts?: Mounts
+  /** Event labels (`namespace.name.event`) this dependency consumes. */
+  events?: string[]
   /** Default probe for compositions and services without their own probe. `false` disables. */
   probe?: Probe | false
 }