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

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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.262](https://github.com/toa-io/toa/compare/v1.0.0-alpha.261...v1.0.0-alpha.262) (2026-08-28)
+
+
+### Bug Fixes
+
+* **boot:** let the composition own the process discovery ([2201e88](https://github.com/toa-io/toa/commit/2201e8852517fd1d2822c775c9b126eb60399580))
+
+
+### Features
+
+* **core:** identify the origin of a call with `request.source` ([9da6b66](https://github.com/toa-io/toa/commit/9da6b66df852690351a1e82c7b8cc176fd89774a))
+
+
+
+
+
 # [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)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/boot",
-  "version": "1.0.0-alpha.259",
+  "version": "1.0.0-alpha.262",
   "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.259",
+    "@toa.io/core": "1.0.0-alpha.262",
     "@toa.io/filesystem": "1.0.0-alpha.254",
     "@toa.io/generic": "1.0.0-alpha.254",
-    "@toa.io/norm": "1.0.0-alpha.259",
+    "@toa.io/norm": "1.0.0-alpha.262",
     "@toa.io/schemas": "1.0.0-alpha.254",
     "clone-deep": "4.0.1",
     "dotenv": "16.1.1",
     "openspan": "1.0.0-alpha.254"
   },
-  "gitHead": "3f557c2f855f078163128c317e7cb2f3629968aa"
+  "gitHead": "e14059cf5cc364d933f2a4b3d7114f3b5ec0764f"
 }

package/src/call.js

@@ -4,12 +4,13 @@ const { Call, Transmission } = require('@toa.io/core')
 
 const boot = require('./index')
 
-const call = (locator, endpoint, definition, entity) => {
+// eslint-disable-next-line max-params
+const call = (locator, endpoint, definition, entity, source) => {
   const consumers = boot.bindings.consume(locator, endpoint, definition.bindings)
   const transmission = new Transmission(consumers)
   const contract = boot.contract.request(definition, entity)
 
-  return new Call(transmission, contract)
+  return new Call(transmission, contract, source)
 }
 
 exports.call = call

package/src/composition.js

@@ -62,6 +62,14 @@ async function composition (paths, options) {
 
       const composition = new Composition(expositions.flat(), producers.concat(settles), receivers.flat(), tenants.flat())
 
+      /*
+       * A lookup that is never answered holds a connection open, and whoever
+       * awaits it has nothing to disconnect — the remote it would belong to does
+       * not exist yet. The composition owns the process's discovery instead, so
+       * an unanswered lookup cannot outlive it.
+       */
+      composition.depends(await boot.discovery.discovery())
+
       return boot.extensions.manage(composition)
     } catch (exception) {
       await Promise.all(expositions.flat().map((connector) => connector.disconnect(true)))

package/src/context.js

@@ -5,7 +5,7 @@ const { Context, Locator } = require('@toa.io/core')
 const boot = require('./index')
 
 const context = async (manifest) => {
-  const local = await boot.remote(manifest.locator, manifest)
+  const local = await boot.remote(manifest.locator, undefined, manifest)
   const aspects = boot.extensions.aspects(manifest)
 
   const lookup = async (namespace, name) => {

package/src/emission.js

@@ -10,7 +10,7 @@ const emission = (definitions, locator, context) => {
 
   const events = Object.entries(definitions).map(([label, definition]) => {
     const emitter = boot.bindings.emit(definition.binding, locator, label)
-    const decorator = extensions.emitter(emitter, label)
+    const decorator = extensions.emitter(emitter, label, locator)
     const bridge = boot.bridge.event(definition.bridge, definition.path, label, context)
 
     return new Event({ ...definition, label: `${locator.id}.${label}` }, decorator, bridge)

package/src/extensions/emitter.js

@@ -5,13 +5,14 @@ const { instances } = require('./instances')
 /**
  * @param {toa.core.bindings.Emitter} emitter
  * @param {string} label
+ * @param {toa.core.Locator} locator
  * @returns {toa.core.bindings.Emitter}
  */
-const emitter = (emitter, label) => {
+const emitter = (emitter, label, locator) => {
   let decorated = emitter
 
   for (const factory of Object.values(instances)) {
-    if (factory.emitter !== undefined) decorated = factory.emitter(decorated, label)
+    if (factory.emitter !== undefined) decorated = factory.emitter(decorated, label, locator)
   }
 
   return decorated

package/src/receivers.js

@@ -9,15 +9,19 @@ const receivers = async (manifest, component) => {
   if (manifest.receivers === undefined) return []
 
   const receivers = []
-  const local = await boot.remote(manifest.locator, manifest)
+  const local = await boot.remote(manifest.locator, undefined, manifest)
 
   for (const [label, definition] of Object.entries(manifest.receivers)) {
     const locator = Locator.parse(label)
     const source = definition.source ? Locator.parse(definition.source) : locator
-    const destination = `${source.id}.${label.split('.').pop()}`
+    const event = label.split('.').pop()
+    const destination = `${source.id}.${event}`
+
+    // the origin of the calls this receiver makes to its local operation
+    const origin = { namespace: source.namespace, component: source.name, event }
 
     const bridge = definition.bridge !== undefined ? boot.bridge.receiver(definition.bridge, manifest.path, label) : undefined
-    const receiver = new Receiver({ ...definition, label, destination }, local, bridge)
+    const receiver = new Receiver({ ...definition, label, destination, origin }, local, bridge)
     const decorator = extensions.receiver(receiver, manifest.locator)
 
     const transport = definition.binding ?? await resolveBinding(locator, label)

package/src/remote.js

@@ -6,7 +6,12 @@ const { remap } = require('@toa.io/generic')
 
 const boot = require('./index')
 
-const remote = async (locator, manifest) => {
+/**
+ * @param {toa.core.Locator} locator
+ * @param {toa.core.Source} [source] the origin stamped on every call made through this remote
+ * @param {toa.norm.Component} [manifest] skips discovery when the manifest is already known
+ */
+const remote = async (locator, source, manifest) => {
   let discovery
 
   if (manifest === undefined) {
@@ -18,7 +23,8 @@ const remote = async (locator, manifest) => {
 
   const calls = manifest.operations === undefined
     ? {}
-    : remap(manifest.operations, (definition, endpoint) => boot.call(locator, endpoint, definition, manifest.entity))
+    : remap(manifest.operations,
+      (definition, endpoint) => boot.call(locator, endpoint, definition, manifest.entity, source))
 
   const remote = new Remote(locator, calls)
 

package/types/index.d.ts

@@ -5,7 +5,7 @@ export * as bindings from './bindings'
 
 export async function composition (paths: string[], options?: composition.Options): Promise<core.Connector>
 
-export async function remote (locator: core.Locator): Promise<core.Remote>
+export async function remote (locator: core.Locator, source?: core.Source): Promise<core.Remote>
 
 export async function receive<T = any> (
   label: string,