@toa.io/norm 1.0.0-alpha.266 → 1.0.0-alpha.270

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.270](https://github.com/toa-io/toa/compare/v1.0.0-alpha.269...v1.0.0-alpha.270) (2026-08-31)
+
+
+### Bug Fixes
+
+* **norm:** resolve annotations keyed by a dependency id ([e2860cd](https://github.com/toa-io/toa/commit/e2860cd2cc93dd3a135c092db1d943f80648ee56))
+* **norm:** return the hash after hashing a file ([35058bd](https://github.com/toa-io/toa/commit/35058bdaae19f367197ea5b800742349e507ab11))
+
+
+### Performance Improvements
+
+* **boot:** stop paying for what a composition does not need to start ([1619c27](https://github.com/toa-io/toa/commit/1619c2743072f4706939ce72f3074e615d26a91e))
+
+
+
+
+
 # [1.0.0-alpha.266](https://github.com/toa-io/toa/compare/v1.0.0-alpha.265...v1.0.0-alpha.266) (2026-08-29)
 
 **Note:** Version bump only for package @toa.io/norm

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/norm",
-  "version": "1.0.0-alpha.266",
+  "version": "1.0.0-alpha.270",
   "description": "Toa declarations normalization and validation",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -20,10 +20,10 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.266",
+    "@toa.io/core": "1.0.0-alpha.270",
     "@toa.io/generic": "1.0.0-alpha.254",
-    "@toa.io/schemas": "1.0.0-alpha.263",
+    "@toa.io/schemas": "1.0.0-alpha.270",
     "@toa.io/yaml": "1.0.0-alpha.254"
   },
-  "gitHead": "0d2b83ff9ed6bf6d9fee7bf00f979b9ee38e9713"
+  "gitHead": "94400bdd411b4c25074ffcf58184580ddd060268"
 }

package/src/.component/.expand/version.js

@@ -3,43 +3,59 @@
 const { join } = require('node:path')
 const { createHash } = require('node:crypto')
 const fs = require('node:fs/promises')
-const { createReadStream } = require('node:fs')
-const { once } = require('node:events')
 
 async function version (manifest) {
   manifest.version ??= await hash(manifest.path)
 }
 
+/**
+ * Identifies a build of a component: it becomes the tag of its image, so it must be the
+ * same for the same sources and different for different ones — on any machine.
+ *
+ * What the image excludes cannot change it: `node_modules` is in the `.dockerignore` the
+ * build writes (see `operations/src/deployment/images/image.js`), so hashing it would only
+ * retag an identical image after a local install.
+ */
 async function hash (path) {
-  const hash = await hashd(path)
+  const files = (await list(path)).sort()
+  const digests = await Promise.all(files.map((file) => digest(join(path, file))))
+  const total = createHash('sha256')
 
-  return hash.digest('hex').slice(0, 8)
+  // the path is part of it: moving a file changes the build even if no content did
+  for (let i = 0; i < files.length; i++)
+    total.update(files[i]).update(digests[i])
+
+  return total.digest('hex').slice(0, 8)
 }
 
 /**
- * @param {string} path
- * @param {import('node:crypto').Hash} hash
+ * @param {string} root
+ * @param {string} [path] relative
+ * @param {string[]} [acc]
+ * @returns {Promise<string[]>} paths relative to `root`
  */
-async function hashd (path, hash = createHash('sha256')) {
-  const stat = await fs.stat(path)
+async function list (root, path = '', acc = []) {
+  const entries = await fs.readdir(join(root, path), { withFileTypes: true })
 
-  if (stat.isFile()) {
-    const stream = createReadStream(path)
+  for (const entry of entries) {
+    if (EXCLUDED.has(entry.name))
+      continue
 
-    stream.pipe(hash, { end: false })
+    const relative = path === '' ? entry.name : `${path}/${entry.name}`
 
-    return await once(stream, 'end')
+    if (entry.isDirectory())
+      await list(root, relative, acc)
+    else if (entry.isFile())
+      acc.push(relative)
   }
 
-  if (stat.isDirectory()) {
-    const entries = await fs.opendir(path)
-
-    for await (const entry of entries) {
-      await hashd(join(path, entry.name), hash)
-    }
+  return acc
+}
 
-    return hash
-  }
+async function digest (path) {
+  return createHash('sha256').update(await fs.readFile(path)).digest()
 }
 
+const EXCLUDED = new Set(['node_modules', '.git'])
+
 exports.version = version

package/src/.context/.dependencies/resolve.js

@@ -25,15 +25,27 @@ const resolve = (references, annotations) => {
   }
 
   for (const dependency of Object.keys(annotations)) {
-    const { module } = load(dependency)
+    if (dependency in dependencies) continue
 
-    if (!module.standalone || (dependency in dependencies))
-      continue
+    // an annotation may be keyed by a dependency id rather than by a module reference
+    const module = optional(dependency)
 
-    dependencies[dependency] = []
+    if (module?.standalone === true) dependencies[dependency] = []
   }
 
   return dependencies
 }
 
+/**
+ * @param {string} reference
+ * @returns {object | null}
+ */
+function optional (reference) {
+  try {
+    return load(reference).module
+  } catch {
+    return null
+  }
+}
+
 exports.resolve = resolve

package/test/component/expand.fixtures.js

@@ -1,7 +1,7 @@
 'use strict'
 
 const source = {
-  path: '',
+  path: __dirname, // `version` hashes the component directory
   entity: {
     schema: {
       properties: {

package/test/component/expand.test.js

@@ -11,17 +11,31 @@ beforeEach(() => {
   source = clone(fixtures.source)
 })
 
-it('should expand', () => {
-  expand(source)
+it('should expand', async () => {
+  await expand(source)
   expect(source).toMatchObject(fixtures.target)
 })
 
+it('should derive version from the component contents', async () => {
+  await expand(source)
+
+  expect(source.version).toMatch(/^[0-9a-f]{8}$/)
+})
+
+it('should keep declared version', async () => {
+  source.version = '1.0.0'
+
+  await expand(source)
+
+  expect(source.version).toStrictEqual('1.0.0')
+})
+
 it('should recognize storages.queues', async () => {
   const queues = { foo: 'bar' }
 
   source.queues = clone(queues)
 
-  expand(source)
+  await expand(source)
 
   expect(source.queues).toBeUndefined()
   expect(source.properties['@toa.io/storages.queues']).toMatchObject(queues)