@toa.io/boot 1.0.0-alpha.300 → 1.0.0-alpha.302

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.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
+
+
+
+
+
 # [1.0.0-alpha.300](https://github.com/toa-io/toa/compare/v1.0.0-alpha.299...v1.0.0-alpha.300) (2026-09-11)
 
 * feat(boot)!: a process is a thing, and an extension may keep something in one ([528d6cd](https://github.com/toa-io/toa/commit/528d6cdd307b45a6c30b6a184d7e06b3328cecf8))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/boot",
-  "version": "1.0.0-alpha.300",
+  "version": "1.0.0-alpha.302",
   "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.300",
-    "@toa.io/core": "1.0.0-alpha.300",
-    "@toa.io/definitions": "1.0.0-alpha.300",
-    "@toa.io/generic": "1.0.0-alpha.292",
-    "@toa.io/norm": "1.0.0-alpha.300",
-    "@toa.io/schemas": "1.0.0-alpha.299",
+    "@toa.io/atomicity": "1.0.0-alpha.302",
+    "@toa.io/core": "1.0.0-alpha.302",
+    "@toa.io/definitions": "1.0.0-alpha.302",
+    "@toa.io/generic": "1.0.0-alpha.301",
+    "@toa.io/norm": "1.0.0-alpha.302",
+    "@toa.io/schemas": "1.0.0-alpha.301",
     "clone-deep": "4.0.1",
     "dotenv": "17.4.2",
-    "openspan": "1.0.0-alpha.293"
+    "openspan": "1.0.0-alpha.301"
   },
-  "gitHead": "f91131a9aeb29aa271f177c4055ddcf0cda8c75e"
+  "gitHead": "3cbbca55a61711db78f98b13e50cf4d1afaf5c08"
 }

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()
       )

package/src/index.js

@@ -1,56 +1,29 @@
 // the environment is read at module scope elsewhere, so it is loaded first
-import { load as env } from './env.js'
+export { load as env } from './env.js'
 
-import * as bindings from './bindings/index.js'
-import * as bridge from './bridge.js'
-import * as contract from './contract.js'
-import * as discovery from './discovery.js'
-import * as extensions from './extensions/index.js'
+export * as bindings from './bindings/index.js'
+export * as bridge from './bridge.js'
+export * as contract from './contract.js'
+export * as discovery from './discovery.js'
+export * as extensions from './extensions/index.js'
 
-import { call } from './call.js'
-import { cascade } from './cascade.js'
-import { component } from './component.js'
-import { composition } from './composition.js'
-import { context } from './context.js'
-import { emission } from './emission.js'
-import { events } from './events.js'
-import { inbox } from './inbox.js'
-import { outbox } from './outbox.js'
-import { atomicity } from './atomicity.js'
-import { atom } from './atom.js'
-import { manifest } from './manifest.js'
-import { operation } from './operation.js'
-import { receivers, receive } from './receivers.js'
-import { remote } from './remote.js'
-import { storage } from './storage.js'
-import { guards } from './guards.js'
-import { host } from './host.js'
-import { rc } from './rc.js'
-import { Workload } from './workload.js'
-
-export {
-  call,
-  env,
-  cascade,
-  component,
-  composition,
-  context,
-  emission,
-  events,
-  inbox,
-  outbox,
-  atomicity,
-  atom,
-  host,
-  manifest,
-  operation,
-  receivers,
-  receive,
-  remote,
-  storage,
-  guards,
-  rc,
-  Workload
-}
-
-export { bindings, bridge, contract, discovery, extensions }
+export { call } from './call.js'
+export { cascade } from './cascade.js'
+export { component } from './component.js'
+export { composition } from './composition.js'
+export { context } from './context.js'
+export { emission } from './emission.js'
+export { events } from './events.js'
+export { inbox } from './inbox.js'
+export { outbox } from './outbox.js'
+export { atomicity } from './atomicity.js'
+export { atom } from './atom.js'
+export { manifest } from './manifest.js'
+export { operation } from './operation.js'
+export { receivers, receive } from './receivers.js'
+export { remote } from './remote.js'
+export { storage } from './storage.js'
+export { guards } from './guards.js'
+export { host } from './host.js'
+export { rc } from './rc.js'
+export { Workload } from './workload.js'

package/types/index.d.ts

@@ -1,8 +1,8 @@
 import type * as core from '@toa.io/core'
 import type * as types from '@toa.io/core/types'
-import * as composition from './composition.js'
+import * as composition from './composition.d.ts'
 
-export * as bindings from './bindings.js'
+export * as bindings from './bindings.d.ts'
 
 export async function composition(
   paths: string[],

package/types/manifest.d.ts

@@ -1,5 +1,5 @@
 import * as _norm from '@toa.io/norm/types'
-import * as _composition from './composition.js'
+import * as _composition from './composition.d.ts'
 
 declare namespace toa.boot {
   type Manifest = (