@toa.io/boot 1.0.0-alpha.291 → 1.0.0-alpha.293

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.293](https://github.com/toa-io/toa/compare/v1.0.0-alpha.292...v1.0.0-alpha.293) (2026-09-07)
+
+**Note:** Version bump only for package @toa.io/boot
+
+
+
+
+
+# [1.0.0-alpha.292](https://github.com/toa-io/toa/compare/v1.0.0-alpha.291...v1.0.0-alpha.292) (2026-09-07)
+
+### Features
+
+* **definitions:** the version of Toa is the definitions package's ([3d0272e](https://github.com/toa-io/toa/commit/3d0272ea0ab862f4b6c2e58a2f003f92d0f8a87f))
+* **definitions:** what a package declares is read from one package ([7052341](https://github.com/toa-io/toa/commit/70523411b5d9e2b204c999aa02365173f3bb518d))
+* **norm:** a package's definition is read by one resolver ([bffd41c](https://github.com/toa-io/toa/commit/bffd41c8d18c42786b0bf321623088b9dabc4724))
+
+
 # [1.0.0-alpha.291](https://github.com/toa-io/toa/compare/v1.0.0-alpha.290...v1.0.0-alpha.291) (2026-09-07)
 
 **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.291",
+  "version": "1.0.0-alpha.293",
   "type": "module",
   "description": "Toa Boot",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,14 +21,15 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/atomicity": "1.0.0-alpha.291",
-    "@toa.io/core": "1.0.0-alpha.291",
-    "@toa.io/generic": "1.0.0-alpha.291",
-    "@toa.io/norm": "1.0.0-alpha.291",
-    "@toa.io/schemas": "1.0.0-alpha.291",
+    "@toa.io/atomicity": "1.0.0-alpha.293",
+    "@toa.io/core": "1.0.0-alpha.293",
+    "@toa.io/definitions": "1.0.0-alpha.293",
+    "@toa.io/generic": "1.0.0-alpha.292",
+    "@toa.io/norm": "1.0.0-alpha.293",
+    "@toa.io/schemas": "1.0.0-alpha.293",
     "clone-deep": "4.0.1",
     "dotenv": "17.4.2",
-    "openspan": "1.0.0-alpha.286"
+    "openspan": "1.0.0-alpha.293"
   },
-  "gitHead": "bcd8d8d07bd3e64fc826af8719472404662cc37f"
+  "gitHead": "1e05b3ab64758324c58c425f1f8e52e9f35f1da8"
 }

package/src/bindings/produce.js

@@ -1,3 +1,4 @@
+import { definition } from '@toa.io/norm'
 import { LOOP } from './constants.js'
 import { factory } from './factory.js'
 
@@ -8,7 +9,7 @@ export const produce = async (component, operations) => {
   for (const [binding, endpoints] of group(operations)) {
     const made = await factory(binding)
     const producer = made.producer(component.locator, endpoints, component)
-    const { properties } = await import(binding)
+    const { properties } = (await definition(binding)).module
 
     if (properties.local === true) local.push(producer)
     else other.push(producer)

package/src/composition.js

@@ -1,6 +1,6 @@
 import { console } from 'openspan'
 import { Composition } from '@toa.io/core'
-import { version } from '@toa.io/runtime'
+import { version } from '@toa.io/definitions'
 import { environment } from '@toa.io/generic'
 
 import * as boot from './index.js'

package/src/manifest.js

@@ -1,7 +1,9 @@
 import clone from 'clone-deep'
-import { basename } from 'node:path'
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { basename, join } from 'node:path'
 import { merge } from '@toa.io/generic'
-import { component as load } from '@toa.io/norm'
+import { component as load, revive, NORMALIZED } from '@toa.io/norm'
 import { Locator } from '@toa.io/core'
 
 import { span } from './span.js'
@@ -11,41 +13,9 @@ export const manifest = async (path, options = {}) => {
 
   const manifest = await span(
     { name: `manifest ${basename(path)}`, attributes: { path } },
-    async () => await load(path)
+    async () => await read(path)
   )
 
-  if (options?.bindings !== undefined) {
-    if ('operations' in manifest) {
-      for (const operation of Object.values(manifest.operations)) {
-        operation.bindings = options.bindings
-      }
-    }
-
-    let asyncBinding
-
-    for (const binding of options.bindings) {
-      const { properties } = await import(binding)
-
-      if (properties?.async === true) {
-        asyncBinding = binding
-        break
-      }
-    }
-
-    if (asyncBinding === undefined)
-      throw new Error('Bindings override must contain at least one async binding')
-
-    if ('events' in manifest) {
-      for (const event of Object.values(manifest.events)) event.binding = asyncBinding
-    }
-
-    if ('receivers' in manifest) {
-      for (const receiver of Object.values(manifest.receivers)) {
-        if (receiver.source === undefined) receiver.binding = asyncBinding
-      }
-    }
-  }
-
   if (manifest.extensions === undefined) manifest.extensions = {}
 
   if (options.extensions !== undefined) {
@@ -62,4 +32,18 @@ export const manifest = async (path, options = {}) => {
   return manifest
 }
 
+/**
+ * What the build wrote, where it wrote one. An image carries the manifest a build normalised;
+ * a workspace has no such file and is read as it always was.
+ *
+ * @param {string} path
+ */
+async function read(path) {
+  const file = join(path, NORMALIZED)
+
+  if (!existsSync(file)) return await load(path)
+
+  return revive(JSON.parse(await readFile(file, 'utf8')), path)
+}
+
 const DEFAULTS = {}

package/src/manifest.test.js

@@ -1,9 +1,27 @@
 import { it, mock } from 'node:test'
 import assert from 'node:assert/strict'
 
+import { mkdtemp, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
 import { generate } from 'randomstring'
 
-mock.module('@toa.io/norm', { namedExports: { component: () => mockComponent() } })
+const NORMALIZED = 'manifest.toa.json'
+
+let normalised = 0
+
+mock.module('@toa.io/norm', {
+  namedExports: {
+    component: () => {
+      normalised++
+
+      return mockComponent()
+    },
+    definition: async () => ({ module: {} }),
+    revive: (declared, path) => ({ ...declared, path }),
+    NORMALIZED
+  }
+})
 
 const { manifest } = await import('./manifest.js')
 
@@ -17,6 +35,29 @@ it('should not modify options', async () => {
   assert.deepStrictEqual(options.extensions.length, 2)
 })
 
+it('should normalize a component the build did not', async () => {
+  const before = normalised
+
+  await manifest(path)
+
+  assert.strictEqual(normalised, before + 1)
+})
+
+it('should read what the build wrote, and not normalize', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'toa-manifest-test'))
+  const declared = { name: 'tasks', namespace: 'todos', operations: { compute: {} } }
+
+  await writeFile(join(root, NORMALIZED), JSON.stringify(declared))
+
+  const before = normalised
+  const read = await manifest(root)
+
+  assert.strictEqual(normalised, before, 'the component was normalized')
+  assert.strictEqual(read.path, root)
+  assert.deepStrictEqual(read.operations, declared.operations)
+  assert.strictEqual(read.locator.id, 'todos.tasks')
+})
+
 function mockComponent() {
   return { name: generate(), namespace: generate() }
 }