@toa.io/norm 1.0.0-alpha.325 → 1.0.0-alpha.327

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 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.327](https://github.com/toa-io/toa/compare/v1.0.0-alpha.326...v1.0.0-alpha.327) (2026-10-10)
+
+### Features
+
+* name a component without a namespace by its name ([abcdd9c](https://github.com/toa-io/toa/commit/abcdd9c9a3d3c5c1c68b74544791848e59a7e158))
+
+
+# [1.0.0-alpha.326](https://github.com/toa-io/toa/compare/v1.0.0-alpha.325...v1.0.0-alpha.326) (2026-10-06)
+
+* feat(core)!: deliver an operation's error as its code and its cause ([18d303b](https://github.com/toa-io/toa/commit/18d303b9143930735e4b093345db1dbf37f90052))
+
+### Bug Fixes
+
+* **deps:** find files with tinyglobby, which carries no braces ([ef951af](https://github.com/toa-io/toa/commit/ef951af26b5f93fec567033520c62ca01f397355))
+
+### BREAKING CHANGES
+
+* an error returned with a `code` field and no message is an exception,
+  and a property of an error other than `cause` no longer reaches the caller.
+
+
 # [1.0.0-alpha.325](https://github.com/toa-io/toa/compare/v1.0.0-alpha.324...v1.0.0-alpha.325) (2026-10-02)
 
 **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.325",
+  "version": "1.0.0-alpha.327",
   "type": "module",
   "description": "Toa declarations normalization and validation",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,12 +21,12 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.323",
-    "@toa.io/definitions": "1.0.0-alpha.325",
+    "@toa.io/core": "1.0.0-alpha.327",
+    "@toa.io/definitions": "1.0.0-alpha.327",
     "@toa.io/generic": "1.0.0-alpha.311",
-    "@toa.io/prototype": "1.0.0-alpha.323",
-    "@toa.io/schemas": "1.0.0-alpha.311",
-    "fast-glob": "3.3.3"
+    "@toa.io/prototype": "1.0.0-alpha.327",
+    "@toa.io/schemas": "1.0.0-alpha.326",
+    "tinyglobby": "0.2.17"
   },
-  "gitHead": "95bc03e65c65f02d536da6ed027cf4f78f5cec74"
+  "gitHead": "cd6d6d77f19fbae5d7ff85d18005ca8deb9c77f3"
 }

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

@@ -1,7 +1,7 @@
 import { join } from 'node:path'
 import { createHash } from 'node:crypto'
 import fs from 'node:fs/promises'
-import glob from 'fast-glob'
+import { glob } from 'tinyglobby'
 
 import { definition } from '../../definition.js'
 
@@ -21,7 +21,9 @@ export async function version(manifest) {
  */
 async function hash(manifest) {
   const files = (await list(manifest)).sort()
-  const digests = await Promise.all(files.map((file) => digest(join(manifest.path, file))))
+  const digests = await Promise.all(
+    files.map((file) => digest(join(manifest.path, file)))
+  )
   const total = createHash('sha256')
 
   // the path is part of it: moving a file changes the build even if no content did
@@ -39,6 +41,7 @@ async function list(manifest) {
     cwd: manifest.path,
     dot: true,
     onlyFiles: true,
+    expandDirectories: false,
     // sources a component keeps outside its own directory are its own: what a link points to is
     // hashed as the file it stands for, so changing it changes the version
     followSymbolicLinks: true,

package/src/.component/migrations.js

@@ -1,7 +1,7 @@
 import { basename, extname, resolve } from 'node:path'
 import { readFile } from 'node:fs/promises'
 
-import glob from 'fast-glob'
+import { glob } from 'tinyglobby'
 import { yaml } from '@toa.io/generic'
 
 /**
@@ -54,4 +54,4 @@ async function read(path) {
 
 const DIRECTORY = 'migrations'
 const EXTENSIONS = '.{yaml,yml,json}'
-const GLOB = { onlyFiles: true, absolute: true }
+const GLOB = { onlyFiles: true, absolute: true, expandDirectories: false }

package/src/.component/schema.yaml

@@ -186,10 +186,10 @@ properties:
           output:
             $ref: https://json-schema.org/draft/2019-09/schema
           errors:
-            # what a reply may carry as a code: the error schema allows either
+            # what a reply may carry as a code: the message of the error returned
             type: array
             items:
-              type: [string, integer]
+              type: string
           query:
             type: boolean
         required: [type, scope, bindings]

package/src/.component/validate.js

@@ -49,7 +49,9 @@ const streams = async (manifest) => {
     if (operation.stream === undefined || operation.bindings.length === 0) continue
     if (await carried(operation.bindings)) continue
 
-    throw new Error(`Operation '${endpoint}' takes a stream, which none of its bindings carries`)
+    throw new Error(
+      `Operation '${endpoint}' takes a stream, which none of its bindings carries`
+    )
   }
 }
 

package/src/.context/.dependencies/extensions.js

@@ -65,7 +65,12 @@ async function extractDeclaredServices(context, extensions, contributed) {
   return extracted
 }
 
-async function extractExtensionComponents(components, extensions, contributed, annotations) {
+async function extractExtensionComponents(
+  components,
+  extensions,
+  contributed,
+  annotations
+) {
   const extracted = []
 
   for (const component of components) {

package/src/.context/dependencies.js

@@ -46,5 +46,6 @@ function unmanaged(context, contributed) {
   }
 
   for (const brought of contributed.values())
-    for (const component of brought) if (!required.has(component)) component.evicted = true
+    for (const component of brought)
+      if (!required.has(component)) component.evicted = true
 }

package/src/.context/evict.js

@@ -31,7 +31,9 @@ export const evict = (context) => {
   for (const composition of context.compositions) {
     if (composition.services === undefined) continue
 
-    composition.services = composition.services.filter((reference) => !services.has(reference))
+    composition.services = composition.services.filter(
+      (reference) => !services.has(reference)
+    )
 
     if (composition.services.length === 0) delete composition.services
   }

package/src/.context/expand.js

@@ -15,4 +15,31 @@ export const expand = (context) => {
 
   if (context.evicted?.services !== undefined)
     context.evicted.services = context.evicted.services.map(shortcuts.resolve)
+
+  // a component that declares no namespace is written by its name, and is known by its id
+  for (const composition of context.compositions ?? [])
+    if (Array.isArray(composition.components))
+      composition.components = composition.components.map((id) => complete(id, 2))
+
+  if (Array.isArray(context.evicted?.components))
+    context.evicted.components = context.evicted.components.map((id) => complete(id, 2))
+
+  if (Array.isArray(context.events))
+    context.events = context.events.map((event) => complete(event, 3))
+}
+
+/**
+ * `name` is `default.name` where an id has two segments, `name.event` is `default.name.event`
+ * where it has three. Anything else is left for the schema to refuse as it is written.
+ *
+ * @param {unknown} id
+ * @param {number} segments how many a complete one has
+ */
+function complete(id, segments) {
+  if (typeof id !== 'string' || id.split('.').length !== segments - 1) return id
+
+  return `${NAMESPACE}.${id}`
 }
+
+/** Where a component that declares no namespace is. */
+const NAMESPACE = 'default'

package/src/context.js

@@ -1,6 +1,6 @@
 import { resolve } from 'node:path'
 import { convolve, environment as variables } from '@toa.io/generic'
-import glob from 'fast-glob'
+import { glob } from 'tinyglobby'
 import { readFile } from 'node:fs/promises'
 import { yaml as jsyaml } from '@toa.io/generic'
 
@@ -37,7 +37,10 @@ export const context = async (
 
   validate(context)
 
-  const paths = await glob(resolve(root, COMPONENTS), GLOB)
+  // a directory is answered with the separator that ends it, and a component's path has none
+  const paths = (await glob(resolve(root, COMPONENTS), GLOB)).map((path) =>
+    path.slice(0, -1)
+  )
 
   context.components = await Promise.all(paths.map(component))
 
@@ -58,7 +61,7 @@ export const context = async (
 const CONTEXT = 'context.toa.yaml'
 const COMPONENTS = 'components/*'
 
-const GLOB = { onlyDirectories: true, absolute: true }
+const GLOB = { onlyDirectories: true, absolute: true, expandDirectories: false }
 
 /**
  * Reads a YAML file, resolving anchors into distinct objects so that

package/src/manifest.js

@@ -58,7 +58,11 @@ function walk(manifest, rewrite) {
     for (const item of Object.values(manifest[property] ?? {}))
       if (item.path !== undefined) rewrite(item)
 
-  for (let prototype = manifest.prototype; prototype != null; prototype = prototype.prototype)
+  for (
+    let prototype = manifest.prototype;
+    prototype != null;
+    prototype = prototype.prototype
+  )
     if (prototype.path !== undefined) rewrite(prototype)
 }
 
@@ -73,7 +77,8 @@ const SELF = '.'
 
 function carried(path, root) {
   if (path === root) return SELF
-  if (path.startsWith(root + sep)) return SELF + '/' + relative(root, path).split(sep).join('/')
+  if (path.startsWith(root + sep))
+    return SELF + '/' + relative(root, path).split(sep).join('/')
 
   return specifier(path)
 }

package/src/map.js

@@ -20,5 +20,7 @@ export const map = (context) => {
     for (const { component } of instances)
       components.set(component.locator.id, contract.component(component))
 
-  return Object.fromEntries([...components].sort(([one], [other]) => one.localeCompare(other)))
+  return Object.fromEntries(
+    [...components].sort(([one], [other]) => one.localeCompare(other))
+  )
 }

package/test/component/validate.test.js

@@ -277,7 +277,9 @@ describe('operations', () => {
     it('should refuse the names the scopes had before `entry` and `entries`', async () => {
       for (const scope of ['object', 'objects']) {
         manifest.operations.get.scope = scope
-        await assert.rejects(validate(manifest), (error) => /allowed values/.test(error.message))
+        await assert.rejects(validate(manifest), (error) =>
+          /allowed values/.test(error.message)
+        )
       }
     })
 
@@ -309,7 +311,9 @@ describe('operations', () => {
 
     it('should not be a window shorter than ten minutes', async () => {
       manifest.operations.add.once = 599
-      await assert.rejects(validate(manifest), (error) => /must be >= 600/.test(error.message))
+      await assert.rejects(validate(manifest), (error) =>
+        /must be >= 600/.test(error.message)
+      )
     })
 
     it('should not be a fraction of a second', async () => {
@@ -393,7 +397,9 @@ describe('stateful', () => {
 
     operation.stateful = 'yes'
 
-    await assert.rejects(validate(manifest), (error) => /must be boolean/.test(error.message))
+    await assert.rejects(validate(manifest), (error) =>
+      /must be boolean/.test(error.message)
+    )
   })
 })
 
@@ -411,7 +417,9 @@ describe('unchained', () => {
 
     operation.unchained = 'yes'
 
-    await assert.rejects(validate(manifest), (error) => /must be boolean/.test(error.message))
+    await assert.rejects(validate(manifest), (error) =>
+      /must be boolean/.test(error.message)
+    )
   })
 })
 

package/test/manifest.test.js

@@ -35,7 +35,12 @@ describe('a manifest carried through a file', () => {
     })
 
   it('does not carry a key with no value', () => {
-    const carried = plain({ name: 'a', namespace: 'b', path: '/x', operations: { echo: { input: undefined } } })
+    const carried = plain({
+      name: 'a',
+      namespace: 'b',
+      path: '/x',
+      operations: { echo: { input: undefined } }
+    })
 
     assert.deepStrictEqual(carried.operations.echo, {})
   })
@@ -64,7 +69,10 @@ describe('a manifest carried through a file', () => {
 
   it('reads what is inherited where the prototype is', async () => {
     const prototype = (await component(COMPONENT)).prototype.path
-    const revived = revive(carry(await component(COMPONENT)), '/composition/external-consumer')
+    const revived = revive(
+      carry(await component(COMPONENT)),
+      '/composition/external-consumer'
+    )
 
     // an event of the prototype's is in the prototype, wherever the component is
     assert.strictEqual(revived.events.created.path, prototype)
@@ -95,7 +103,10 @@ describe('what cannot be carried', () => {
   it('refuses a prototype an image would not have', async () => {
     const manifest = await component(EXTENDED)
 
-    assert.throws(() => plain(manifest), /is in no package, so an image cannot carry what is in it/)
+    assert.throws(
+      () => plain(manifest),
+      /is in no package, so an image cannot carry what is in it/
+    )
   })
 
   it('refuses a path inside the component it does not know about', () => {
@@ -113,7 +124,7 @@ describe('what cannot be carried', () => {
     assert.throws(() => plain(manifest), /carries a path of the machine that read it/)
   })
 
-  it('leaves a value of the application\'s own alone', () => {
+  it("leaves a value of the application's own alone", () => {
     const carried = plain({
       name: 'a',
       namespace: 'b',

package/types/component.d.ts

@@ -12,7 +12,7 @@ export type Operation = {
   description?: string
   input?: any
   output?: any
-  error?: any
+  errors?: string[]
   query?: boolean
   /** served by every process under an address of its own, which a call to it names */
   stateful?: boolean