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

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 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))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/norm",
-  "version": "1.0.0-alpha.326",
+  "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.326",
-    "@toa.io/definitions": "1.0.0-alpha.326",
+    "@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/prototype": "1.0.0-alpha.327",
     "@toa.io/schemas": "1.0.0-alpha.326",
     "tinyglobby": "0.2.17"
   },
-  "gitHead": "60f11bdc805d0c39bcb06064b2218b11114a35ad"
+  "gitHead": "cd6d6d77f19fbae5d7ff85d18005ca8deb9c77f3"
 }

package/src/.component/.expand/version.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

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

@@ -38,7 +38,9 @@ export const context = async (
   validate(context)
 
   // 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))
+  const paths = (await glob(resolve(root, COMPONENTS), GLOB)).map((path) =>
+    path.slice(0, -1)
+  )
 
   context.components = await Promise.all(paths.map(component))
 

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',