@toa.io/boot 1.0.0-alpha.310 → 1.0.0-alpha.312

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 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.312](https://github.com/toa-io/toa/compare/v1.0.0-alpha.311...v1.0.0-alpha.312) (2026-09-18)
+
+### Features
+
+* **boot:** offer a streamed endpoint to the bindings that carry a stream ([0099b4e](https://github.com/toa-io/toa/commit/0099b4e12bff4ce5dba2d0098f0b8c6a18fff2c5))
+* **boot:** tell a producer which of its endpoints take a stream ([6383adc](https://github.com/toa-io/toa/commit/6383adcebf38d889db80d8cbd19fe38f3ba4eb2e))
+* **core:** refuse a call that carries no stream where the operation takes one ([fb78e02](https://github.com/toa-io/toa/commit/fb78e02fa620b15f6aa7bac184dd8a6ede923150))
+* **core:** require the property that carries a stream, and refuse a task that carries one ([fdc7e6b](https://github.com/toa-io/toa/commit/fdc7e6b345ee22b030a52f1fda0e91e6bf63a392))
+
+
+# [1.0.0-alpha.311](https://github.com/toa-io/toa/compare/v1.0.0-alpha.310...v1.0.0-alpha.311) (2026-09-17)
+
+### Features
+
+* read the scope of a process once, as it boots ([0d65de5](https://github.com/toa-io/toa/commit/0d65de58ffc655ff872b8e66f95c5609ada3370a))
+
+
 # [1.0.0-alpha.310](https://github.com/toa-io/toa/compare/v1.0.0-alpha.309...v1.0.0-alpha.310) (2026-09-16)
 
 **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.310",
+  "version": "1.0.0-alpha.312",
   "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.310",
-    "@toa.io/core": "1.0.0-alpha.310",
-    "@toa.io/definitions": "1.0.0-alpha.310",
-    "@toa.io/generic": "1.0.0-alpha.310",
-    "@toa.io/norm": "1.0.0-alpha.310",
-    "@toa.io/schemas": "1.0.0-alpha.310",
+    "@toa.io/atomicity": "1.0.0-alpha.312",
+    "@toa.io/core": "1.0.0-alpha.312",
+    "@toa.io/definitions": "1.0.0-alpha.312",
+    "@toa.io/generic": "1.0.0-alpha.311",
+    "@toa.io/norm": "1.0.0-alpha.312",
+    "@toa.io/schemas": "1.0.0-alpha.311",
     "clone-deep": "4.0.1",
     "dotenv": "17.4.2",
     "openspan": "1.0.0-alpha.305"
   },
-  "gitHead": "d952c57f77279729e26d52d50c6df47138ad0a4f"
+  "gitHead": "3cdff9b9779eeb6ae83913fefc0b502a10a0236a"
 }

package/src/bindings/consume.js

@@ -1,9 +1,21 @@
 import { LOOP } from './constants.js'
 import { factory } from './factory.js'
+import { carries } from './produce.js'
 
-export const consume = async (locator, endpoint, bindings) =>
-  await Promise.all(
-    [LOOP]
-      .concat(bindings)
-      .map(async (binding) => (await factory(binding)).consumer(locator, endpoint))
+export const consume = async (locator, endpoint, bindings, streamed = false) => {
+  const declared = [LOOP].concat(bindings)
+  const carrying = streamed ? await filter(declared) : declared
+
+  return await Promise.all(
+    carrying.map(async (binding) => (await factory(binding)).consumer(locator, endpoint))
   )
+}
+
+/** A call that carries a stream is handed to nothing that cannot carry one. */
+const filter = async (bindings) => {
+  const carrying = []
+
+  for (const binding of bindings) if (await carries(binding)) carrying.push(binding)
+
+  return carrying
+}

package/src/bindings/produce.js

@@ -6,11 +6,13 @@ export const produce = async (component, operations) => {
   const local = []
   const other = []
   const stateful = addressed(operations)
+  const streams = streamed(operations)
 
-  for (const [binding, endpoints] of group(operations)) {
+  for (const [binding, endpoints] of await group(operations)) {
     const made = await factory(binding)
     const carried = stateful.filter((endpoint) => endpoints.includes(endpoint))
-    const producer = made.producer(component.locator, endpoints, component, carried)
+    const carries = streams.filter((endpoint) => endpoints.includes(endpoint))
+    const producer = made.producer(component.locator, endpoints, component, carried, carries)
     const { properties } = (await definition(binding)).module
 
     if (properties.local === true) local.push(producer)
@@ -20,6 +22,14 @@ export const produce = async (component, operations) => {
   return { local, other }
 }
 
+/** The endpoints that take one of their input properties as a stream. */
+const streamed = (operations) =>
+  operations === undefined
+    ? []
+    : Object.entries(operations)
+        .filter(([, operation]) => operation.stream !== undefined)
+        .map(([endpoint]) => endpoint)
+
 /** The endpoints that take addressed calls only. */
 const addressed = (operations) =>
   operations === undefined
@@ -29,7 +39,7 @@ const addressed = (operations) =>
         .map(([endpoint]) => endpoint)
 
 /** The endpoints each binding carries, as entries. */
-const group = (operations) => {
+const group = async (operations) => {
   const map = {}
 
   if (operations !== undefined)
@@ -40,6 +50,9 @@ const group = (operations) => {
         : [LOOP].concat(operation.bindings)
 
       for (const binding of bindings) {
+        // an endpoint that takes a stream is served by the bindings that carry one, and by no other
+        if (operation.stream !== undefined && !(await carries(binding))) continue
+
         if (!map[binding]) map[binding] = []
 
         map[binding].push(endpoint)
@@ -48,3 +61,7 @@ const group = (operations) => {
 
   return Object.entries(map)
 }
+
+/** Whether a binding carries a call whose input holds a stream, which only its module says. */
+export const carries = async (binding) =>
+  (await definition(binding)).module.properties.streams === true

package/src/call.js

@@ -4,7 +4,12 @@ import * as boot from './index.js'
 
 // eslint-disable-next-line max-params
 export const call = async (locator, endpoint, definition, entity, source) => {
-  const consumers = await boot.bindings.consume(locator, endpoint, definition.bindings)
+  const consumers = await boot.bindings.consume(
+    locator,
+    endpoint,
+    definition.bindings,
+    definition.stream !== undefined
+  )
   const transmission = new Transmission(consumers)
   const contract = boot.contract.request(definition, entity)
 
@@ -23,6 +28,7 @@ export const call = async (locator, endpoint, definition, entity, source) => {
     `${locator.id}.${endpoint}`,
     source,
     stateful,
-    readable
+    readable,
+    definition.stream
   )
 }

package/src/component.js

@@ -17,6 +17,10 @@ const create = async (manifest, locator) => {
   // component is imported: nothing of it is left in `process.env` for that module to read
   environment.absorb()
 
+  // the suffix is what it is now, `.env` having been read: whatever this process sets for the
+  // processes it starts later does not rename what it has
+  environment.suffix()
+
   await boot.extensions.load(manifest)
 
   // the storage is told whether there will be an outbox, so what it publishes to comes first:

package/src/composition.js

@@ -11,6 +11,10 @@ export async function composition(paths, options) {
   // component is imported: nothing of it is left in `process.env` for that module to read
   environment.absorb()
 
+  // the suffix is what it is now, `.env` having been read: whatever this process sets for the
+  // processes it starts later does not rename what it has
+  environment.suffix()
+
   options = Object.assign({}, options)
 
   return span('boot composition', async () => {

package/src/operation.js

@@ -21,7 +21,7 @@ export async function operation(
   const cascade = await boot.cascade(manifest, endpoint, definition, context, preflight)
   const reply = boot.contract.reply(definition.output, definition.errors)
   const input = definition.input
-  const request = boot.contract.request({ input }, manifest.entity)
+  const request = boot.contract.request({ input, stream: definition.stream }, manifest.entity)
   const contracts = { reply, request }
 
   const query =