@toa.io/boot 1.0.0-alpha.257 → 1.0.0-alpha.259

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.259](https://github.com/toa-io/toa/compare/v1.0.0-alpha.258...v1.0.0-alpha.259) (2026-08-24)
+
+
+### Features
+
+* **runtime:** split component RC into preflight and settle ([0d648b3](https://github.com/toa-io/toa/commit/0d648b314e4aac226c254bf01a86affa04b59b34))
+
+
+
+
+
 # [1.0.0-alpha.257](https://github.com/toa-io/toa/compare/v1.0.0-alpha.256...v1.0.0-alpha.257) (2026-08-24)
 
 **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.257",
+  "version": "1.0.0-alpha.259",
   "description": "Toa Boot",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -20,14 +20,14 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.257",
+    "@toa.io/core": "1.0.0-alpha.259",
     "@toa.io/filesystem": "1.0.0-alpha.254",
     "@toa.io/generic": "1.0.0-alpha.254",
-    "@toa.io/norm": "1.0.0-alpha.257",
+    "@toa.io/norm": "1.0.0-alpha.259",
     "@toa.io/schemas": "1.0.0-alpha.254",
     "clone-deep": "4.0.1",
     "dotenv": "16.1.1",
     "openspan": "1.0.0-alpha.254"
   },
-  "gitHead": "2db23a4e2ff6740a5f852208a9b896812ec6f819"
+  "gitHead": "3f557c2f855f078163128c317e7cb2f3629968aa"
 }

package/src/bindings/produce.js

@@ -3,8 +3,21 @@
 const { LOOP } = require('./constants')
 const { factory } = require('./factory')
 
-const produce = (component, operations) => group(operations, (factory, endpoints) =>
-  factory.producer(component.locator, endpoints, component))
+const produce = (component, operations) => {
+  const local = []
+  const other = []
+
+  group(operations, (binding, endpoints) => {
+    const producer = factory(binding).producer(component.locator, endpoints, component)
+
+    if (require(binding).properties.local === true)
+      local.push(producer)
+    else
+      other.push(producer)
+  })
+
+  return { local, other }
+}
 
 const group = (operations, callback) => {
   const map = {}
@@ -23,7 +36,8 @@ const group = (operations, callback) => {
       }
     }
 
-  return Object.entries(map).map(([binding, endpoints]) => callback(factory(binding), endpoints))
+  for (const [binding, endpoints] of Object.entries(map))
+    callback(binding, endpoints)
 }
 
 exports.produce = produce

package/src/cascade.js

@@ -4,7 +4,7 @@ const { Cascade } = require('@toa.io/core')
 
 const boot = require('./index')
 
-async function cascade (manifest, endpoint, definition, context, rc) {
+async function cascade (manifest, endpoint, definition, context, preflight) {
   const bridges = []
 
   if (definition.forward) endpoint = definition.forward
@@ -27,7 +27,7 @@ async function cascade (manifest, endpoint, definition, context, rc) {
     bridges.unshift(bridge)
   }
 
-  return new Cascade(bridges, rc)
+  return new Cascade(bridges, preflight)
 }
 
 exports.cascade = cascade

package/src/component.js

@@ -28,24 +28,29 @@ const create = async (manifest, locator) => {
     state = new State(storage, entity, emission, manifest.entity.associated)
   }
 
-  const rc = await boot.rc(manifest, context)
-  const operations = await bootOperations(manifest, context, state, rc)
+  const phases = await boot.rc(manifest, context)
+  const operations = await bootOperations(manifest, context, state, phases?.preflight)
   const component = new Component(locator, operations)
 
   if (storage) component.depends(storage)
   if (emission) component.depends(emission)
 
-  return boot.extensions.component(component)
+  const decorated = boot.extensions.component(component)
+
+  if (phases?.settle !== undefined)
+    decorated.settle = phases.settle
+
+  return decorated
 }
 
-async function bootOperations (manifest, context, state, rc) {
+async function bootOperations (manifest, context, state, preflight) {
   if (manifest.operations === undefined)
     return {}
 
   const operations = {}
 
   for (const [endpoint, definition] of Object.entries(manifest.operations))
-    operations[endpoint] = await boot.operation(manifest, endpoint, definition, context, state, rc)
+    operations[endpoint] = await boot.operation(manifest, endpoint, definition, context, state, preflight)
 
   return operations
 }

package/src/composition.js

@@ -25,19 +25,48 @@ async function composition (paths, options) {
     const expositions = await span('expose discovery',
       async () => await Promise.all(manifests.map(boot.discovery.expose)))
 
-    const components = await span('create components',
-      async () => await Promise.all(manifests.map(boot.component)))
+    try {
+      const components = await span('create components',
+        async () => await Promise.all(manifests.map(boot.component)))
 
-    const producers = components.map((component, index) =>
-      boot.bindings.produce(component, manifests[index].operations))
+      const groups = components.map((component, index) =>
+        boot.bindings.produce(component, manifests[index].operations))
 
-    const receivers = await span('create receivers',
-      async () => await Promise.all(components.map((component, index) =>
-        boot.receivers(manifests[index], component))))
+      const receivers = await span('create receivers',
+        async () => await Promise.all(components.map((component, index) =>
+          boot.receivers(manifests[index], component))))
 
-    const composition = new Composition(expositions.flat(), producers.flat(), receivers.flat(), tenants.flat())
+      const producers = []
+      const settles = []
 
-    return boot.extensions.manage(composition)
+      for (let i = 0; i < components.length; i++) {
+        const { local, other } = groups[i]
+        const settle = components[i].settle
+
+        producers.push(...local, ...other)
+
+        if (settle === undefined)
+          continue
+
+        if (local.length > 0)
+          settle.depends(local)
+
+        for (const producer of other)
+          producer.depends(settle)
+
+        for (const receiver of receivers[i])
+          receiver.depends(settle)
+
+        settles.push(settle)
+      }
+
+      const composition = new Composition(expositions.flat(), producers.concat(settles), receivers.flat(), tenants.flat())
+
+      return boot.extensions.manage(composition)
+    } catch (exception) {
+      await Promise.all(expositions.flat().map((connector) => connector.disconnect(true)))
+      throw exception
+    }
   })
 }
 

package/src/discovery.js

@@ -29,7 +29,8 @@ const lookup = async (locator) => {
 const expose = async (manifest) => {
   const exposition = new Exposition(manifest.locator, manifest)
   const operations = { [ENDPOINT]: { bindings: BINDINGS } }
-  const producers = boot.bindings.produce(exposition, operations)
+  const { local, other } = boot.bindings.produce(exposition, operations)
+  const producers = local.concat(other)
 
   await Promise.all(producers.map((producer) => producer.connect()))
 

package/src/operation.js

@@ -12,8 +12,8 @@ const {
 
 const boot = require('./index')
 
-async function operation (manifest, endpoint, definition, context, scope, rc) {
-  const cascade = await boot.cascade(manifest, endpoint, definition, context, rc)
+async function operation (manifest, endpoint, definition, context, scope, preflight) {
+  const cascade = await boot.cascade(manifest, endpoint, definition, context, preflight)
   const reply = boot.contract.reply(definition.output, definition.error)
   const input = definition.input
   const request = boot.contract.request({ input }, manifest.entity)