@toa.io/boot 1.0.0-alpha.301 → 1.0.0-alpha.303

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.303](https://github.com/toa-io/toa/compare/v1.0.0-alpha.302...v1.0.0-alpha.303) (2026-09-12)
+
+**Note:** Version bump only for package @toa.io/boot
+
+
+
+
+
+# [1.0.0-alpha.302](https://github.com/toa-io/toa/compare/v1.0.0-alpha.301...v1.0.0-alpha.302) (2026-09-11)
+
+### Features
+
+* **boot:** a run command may wait until the component is served ([0f66bed](https://github.com/toa-io/toa/commit/0f66bedf7b54dc9c1397f7f32bbccbffde7288ca))
+
+
 # [1.0.0-alpha.301](https://github.com/toa-io/toa/compare/v1.0.0-alpha.300...v1.0.0-alpha.301) (2026-09-11)
 
 **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.301",
+  "version": "1.0.0-alpha.303",
   "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.301",
-    "@toa.io/core": "1.0.0-alpha.301",
-    "@toa.io/definitions": "1.0.0-alpha.301",
+    "@toa.io/atomicity": "1.0.0-alpha.303",
+    "@toa.io/core": "1.0.0-alpha.303",
+    "@toa.io/definitions": "1.0.0-alpha.303",
     "@toa.io/generic": "1.0.0-alpha.301",
-    "@toa.io/norm": "1.0.0-alpha.301",
+    "@toa.io/norm": "1.0.0-alpha.303",
     "@toa.io/schemas": "1.0.0-alpha.301",
     "clone-deep": "4.0.1",
     "dotenv": "17.4.2",
-    "openspan": "1.0.0-alpha.301"
+    "openspan": "1.0.0-alpha.303"
   },
-  "gitHead": "cc49bc90efd35464b2ad7803246786c607a44685"
+  "gitHead": "b8e9dd89f6d49756944687a95dfc786f12947286"
 }

package/src/component.js

@@ -68,6 +68,8 @@ const create = async (manifest, locator) => {
 
   if (phases?.settle !== undefined) decorated.settle = phases.settle
 
+  if (phases?.ready !== undefined) decorated.ready = phases.ready
+
   // a dependency closes after its dependant, so the component is already closed
   // when the RC releases what it opened
   if (phases?.dispose !== undefined) decorated.depends(phases.dispose)

package/src/composition.js

@@ -59,10 +59,11 @@ export async function composition(paths, options) {
 
       const producers = []
       const settles = []
+      const readies = []
 
       for (let i = 0; i < components.length; i++) {
         const { local, other } = groups[i]
-        const settle = components[i].settle
+        const { settle, ready } = components[i]
         const serving = [...local, ...other]
 
         producers.push(...serving)
@@ -78,6 +79,19 @@ export async function composition(paths, options) {
         for (const receiver of receivers[i])
           for (const producer of serving) receiver.depends(producer)
 
+        /*
+         * The broker producers serve the stateful endpoints under the process's name, and the
+         * name is held once they are open — before then a call to it is refused. `ready` is where
+         * a component hands the name out, so it waits for every producer and receiver of its own.
+         */
+        if (ready !== undefined) {
+          for (const producer of serving) ready.depends(producer)
+
+          for (const receiver of receivers[i]) ready.depends(receiver)
+
+          readies.push(ready)
+        }
+
         if (settle === undefined) continue
 
         if (local.length > 0) settle.depends(local)
@@ -91,7 +105,7 @@ export async function composition(paths, options) {
 
       const composition = new Composition(
         expositions.flat(),
-        producers.concat(settles),
+        producers.concat(settles, readies),
         receivers.flat(),
         tenants.flat()
       )