@toa.io/boot 1.0.0-alpha.320 → 1.0.0-alpha.322

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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.322](https://github.com/toa-io/toa/compare/v1.0.0-alpha.321...v1.0.0-alpha.322) (2026-09-29)
+
+**Note:** Version bump only for package @toa.io/boot
+
+
+
+
+
+# [1.0.0-alpha.321](https://github.com/toa-io/toa/compare/v1.0.0-alpha.320...v1.0.0-alpha.321) (2026-09-28)
+
+### Features
+
+* **core:** give a destination that carries changes to other regions what the regional ones write ([a7d2fd1](https://github.com/toa-io/toa/commit/a7d2fd1eecd50645d14f7cb5c588069c3073ba72))
+
+
 # [1.0.0-alpha.320](https://github.com/toa-io/toa/compare/v1.0.0-alpha.319...v1.0.0-alpha.320) (2026-09-28)
 
 **Note:** Version bump only for package @toa.io/boot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/boot",
-  "version": "1.0.0-alpha.320",
+  "version": "1.0.0-alpha.322",
   "type": "module",
   "description": "Toa Boot",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,15 +21,15 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/atomicity": "1.0.0-alpha.320",
-    "@toa.io/core": "1.0.0-alpha.320",
-    "@toa.io/definitions": "1.0.0-alpha.320",
+    "@toa.io/atomicity": "1.0.0-alpha.322",
+    "@toa.io/core": "1.0.0-alpha.322",
+    "@toa.io/definitions": "1.0.0-alpha.322",
     "@toa.io/generic": "1.0.0-alpha.311",
-    "@toa.io/norm": "1.0.0-alpha.320",
+    "@toa.io/norm": "1.0.0-alpha.322",
     "@toa.io/schemas": "1.0.0-alpha.311",
     "clone-deep": "4.0.1",
     "dotenv": "18.0.3",
     "openspan": "1.0.0-alpha.305"
   },
-  "gitHead": "5ef92ab939a596e4ac820965c59c015820eba7b2"
+  "gitHead": "ef65352a8bd7bc0ef400fcc8cde0e19a3bb92199"
 }

package/src/component.js

@@ -38,6 +38,9 @@ const create = async (manifest, locator) => {
   // a destination that renders the component's events renders them with its context
   await boot.rendering(manifest, destinations, context)
 
+  // and one that carries a change to other regions carries what the regional ones write
+  boot.regional(destinations)
+
   const outbox = boot.outbox(manifest, storage, emission, destinations)
 
   let state

package/src/index.js

@@ -23,6 +23,7 @@ export { operation } from './operation.js'
 export { receivers, receive } from './receivers.js'
 export { remote } from './remote.js'
 export { rendering } from './rendering.js'
+export { regional } from './regional.js'
 export { storage } from './storage.js'
 export { guards } from './guards.js'
 export { host } from './host.js'

package/src/regional.js

@@ -0,0 +1,18 @@
+import { Regional } from '@toa.io/core'
+
+/**
+ * Gives every destination that carries a change to other regions the others that write to
+ * something each region keeps for itself. Neither knows what the other is: the carrier is given
+ * what they export, and hands back what arrives.
+ *
+ * @param {import('@toa.io/core/types').outbox.Destination[]} destinations
+ * @returns {void}
+ */
+export const regional = (destinations) => {
+  const regionals = destinations.filter((destination) => Regional.is(destination))
+
+  if (regionals.length === 0) return
+
+  for (const destination of destinations)
+    if (destination.carries === true) destination.regional = new Regional(regionals)
+}

package/src/regional.test.js

@@ -0,0 +1,28 @@
+import { it } from 'node:test'
+import assert from 'node:assert/strict'
+
+import { regional } from './regional.js'
+
+const regionalDestination = (name) => ({
+  name,
+  export: async () => [name],
+  import: async () => undefined
+})
+
+it('should give a carrier the regional destinations', async () => {
+  const carrier = { name: 'convergence', carries: true }
+  const events = { name: 'events' }
+
+  regional([events, carrier, regionalDestination('realtime')])
+
+  assert.deepEqual(await carrier.regional.export({}), { realtime: ['realtime'] })
+  assert.equal('regional' in events, false)
+})
+
+it('should give a carrier nothing where no destination is regional', () => {
+  const carrier = { name: 'convergence', carries: true }
+
+  regional([carrier, { name: 'events' }])
+
+  assert.equal(carrier.regional, undefined)
+})