@toa.io/norm 1.0.0-alpha.300 → 1.0.0-alpha.302

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 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.302](https://github.com/toa-io/toa/compare/v1.0.0-alpha.301...v1.0.0-alpha.302) (2026-09-11)
+
+**Note:** Version bump only for package @toa.io/norm
+
+
+
+
+
+# [1.0.0-alpha.301](https://github.com/toa-io/toa/compare/v1.0.0-alpha.300...v1.0.0-alpha.301) (2026-09-11)
+
+### Bug Fixes
+
+* **norm:** an operation that takes no input states none ([3b69b4c](https://github.com/toa-io/toa/commit/3b69b4c92b3f06361a3552f036a927f4ff32e58b))
+
+### Features
+
+* **norm:** an environment name may fall back along a colon-separated chain ([a267c1c](https://github.com/toa-io/toa/commit/a267c1caae816a75ada8352d5361b99817c72eb1))
+* **operations:** an evicted component is given its environment and configuration ([6cf7890](https://github.com/toa-io/toa/commit/6cf7890a632a2185d2b7d9790890a04187e5a897))
+
+
 # [1.0.0-alpha.300](https://github.com/toa-io/toa/compare/v1.0.0-alpha.299...v1.0.0-alpha.300) (2026-09-11)
 
 * feat(boot)!: a process is a thing, and an extension may keep something in one ([528d6cd](https://github.com/toa-io/toa/commit/528d6cdd307b45a6c30b6a184d7e06b3328cecf8))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/norm",
-  "version": "1.0.0-alpha.300",
+  "version": "1.0.0-alpha.302",
   "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.300",
-    "@toa.io/definitions": "1.0.0-alpha.300",
-    "@toa.io/generic": "1.0.0-alpha.292",
-    "@toa.io/prototype": "1.0.0-alpha.300",
-    "@toa.io/schemas": "1.0.0-alpha.299",
+    "@toa.io/core": "1.0.0-alpha.302",
+    "@toa.io/definitions": "1.0.0-alpha.302",
+    "@toa.io/generic": "1.0.0-alpha.301",
+    "@toa.io/prototype": "1.0.0-alpha.301",
+    "@toa.io/schemas": "1.0.0-alpha.301",
     "fast-glob": "3.3.3"
   },
-  "gitHead": "f91131a9aeb29aa271f177c4055ddcf0cda8c75e"
+  "gitHead": "3cbbca55a61711db78f98b13e50cf4d1afaf5c08"
 }

package/src/.component/.normalize/operations.js

@@ -13,6 +13,9 @@ export const operations = (component) => {
     // an operation that states no output states an empty schema, which every reply fits
     operation.output ??= {}
 
+    // a bridge says an algorithm takes no input with `null`, which the manifest states as none
+    if (operation.input === null) delete operation.input
+
     if (operation.bindings === undefined) operation.bindings = component.bindings
     if (operation.bindings === null) operation.bindings = []
     if (operation.virtual === true) delete component.operations[endpoint]

package/src/.component/dereference.js

@@ -1,36 +1,8 @@
 import { merge } from '@toa.io/generic'
 
 export const dereference = (manifest) => {
-  // schemas
-  const properties = manifest.entity?.properties
-  const resolver = createResolver(properties)
+  if (!('operations' in manifest)) return
 
-  if (properties !== undefined)
-    for (const [name, property] of Object.entries(properties))
-      properties[name] = schema(property, resolver)
-
-  if ('operations' in manifest) operations(manifest, resolver)
-}
-
-const createResolver = (properties) => (property) => {
-  if (properties?.[property] === undefined) {
-    throw new Error(`Referenced property '${property}' is not defined`)
-  }
-
-  return properties[property]
-}
-
-function operations(manifest, resolver) {
-  for (const operation of Object.values(manifest.operations)) {
-    if (operation.input !== undefined) operation.input = schema(operation.input, resolver)
-
-    if (operation.output !== undefined)
-      if (Array.isArray(operation.output) && operation.output.length === 1)
-        operation.output = [schema(operation.output[0], resolver)]
-      else operation.output = schema(operation.output, resolver)
-  }
-
-  // forwarding
   for (const operation of Object.values(manifest.operations)) {
     if (operation.forward !== undefined) forward(operation, manifest.operations)
   }
@@ -40,24 +12,6 @@ function operations(manifest, resolver) {
   }
 }
 
-const schema = (object, resolve) => {
-  if (object === undefined || object === null || typeof object !== 'object') return
-  if (object.type === 'string' && object.default?.[0] === '.')
-    return resolve(object.default.substring(1))
-
-  if (object.type === 'array') {
-    object.items = schema(object.items, resolve)
-  } else if (object.properties !== undefined) {
-    for (const [name, value] of Object.entries(object.properties)) {
-      if (value?.type === 'string' && value.default === '.')
-        object.properties[name] = resolve(name)
-      else object.properties[name] = schema(value, resolve)
-    }
-  }
-
-  return object
-}
-
 const forward = (operation, operations) => {
   const target = operations[operation.forward]
 

package/src/.component/merge.js

@@ -1,7 +1,7 @@
-import { merge } from '@toa.io/generic'
+import { merge as combine } from '@toa.io/generic'
 import { definition } from '../definition.js'
 
-const bridge = async (root, manifest) => {
+export const merge = async (root, manifest) => {
   await Promise.all([
     define(root, manifest, 'operations'),
     define(root, manifest, 'events'),
@@ -22,7 +22,7 @@ const define = async (root, manifest, property) => {
       const { define } = await bridged(bridge)
       const definition = await define[singular](root, endpoint)
 
-      merge(item, definition)
+      combine(item, definition)
     }
   }
 
@@ -45,7 +45,7 @@ const define = async (root, manifest, property) => {
 
       try {
         if (declared === undefined) manifest[property][endpoint] = item
-        else merge(declared, item)
+        else combine(declared, item)
       } catch (error) {
         console.error(`Error merging ${singular} '${endpoint}' in ${root}`)
         throw error
@@ -69,5 +69,3 @@ async function bridged(reference) {
 
   return module
 }
-
-export { bridge as merge }

package/src/context.js

@@ -16,11 +16,20 @@ import {
   validate
 } from './.context/index.js'
 
-export const context = async (root, environment = variables.get('TOA_ENV')) => {
+export const context = async (
+  root,
+  environment = variables.get('TOA_ENV'),
+  options = {}
+) => {
   const path = resolve(root, CONTEXT)
   const context = /** @type {toa.norm.Context} */ await read(path)
 
-  context.environment = environment
+  const names = environment?.split(':')
+
+  if (names !== undefined && names.length > 1 && names.some((name) => name.length === 0))
+    throw new Error(`Environment '${environment}' contains an empty name.`)
+
+  context.environment = names?.[0]
 
   convolve(context, environment)
   expand(context)
@@ -32,8 +41,9 @@ export const context = async (root, environment = variables.get('TOA_ENV')) => {
 
   context.components = await Promise.all(paths.map(component))
 
-  // before the dependencies, which mark what only evicted components require
-  evict(context)
+  // before the dependencies, which mark what only evicted components require.
+  // `evicted: false` leaves that off: a local run of a component still needs its variables
+  if (options.evicted !== false) evict(context)
 
   // what a context declares of every component that stores anything, its own and the ones its
   // extensions bring, is given to them where those are known: inside `dependencies`

package/test/component/dereference.fixtures.js

@@ -3,10 +3,6 @@ export const source = {
     properties: {
       foo: {
         type: 'string'
-      },
-      bar: {
-        type: 'string',
-        default: '.foo'
       }
     }
   },
@@ -15,42 +11,14 @@ export const source = {
       input: {
         properties: {
           foo: {
-            type: 'string',
-            default: '.'
-          },
-          bar: {
-            type: 'string',
-            default: '.foo'
-          },
-          baz1: {
-            type: 'array',
-            items: {
-              type: 'string',
-              default: '.foo'
-            }
-          },
-          baz2: {
-            type: 'array',
-            items: {
-              properties: {
-                foo: {
-                  type: 'string',
-                  default: '.'
-                },
-                bar: {
-                  type: 'string',
-                  default: '.foo'
-                }
-              }
-            }
+            type: 'string'
           }
         }
       },
       output: {
         properties: {
           bar: {
-            type: 'string',
-            default: '.foo'
+            type: 'string'
           }
         }
       }
@@ -67,9 +35,6 @@ export const target = {
     properties: {
       foo: {
         type: 'string'
-      },
-      bar: {
-        type: 'string'
       }
     }
   },
@@ -79,28 +44,6 @@ export const target = {
         properties: {
           foo: {
             type: 'string'
-          },
-          bar: {
-            type: 'string'
-          },
-          baz1: {
-            type: 'array',
-            items: {
-              type: 'string'
-            }
-          },
-          baz2: {
-            type: 'array',
-            items: {
-              properties: {
-                foo: {
-                  type: 'string'
-                },
-                bar: {
-                  type: 'string'
-                }
-              }
-            }
           }
         }
       },
@@ -119,28 +62,6 @@ export const target = {
         properties: {
           foo: {
             type: 'string'
-          },
-          bar: {
-            type: 'string'
-          },
-          baz1: {
-            type: 'array',
-            items: {
-              type: 'string'
-            }
-          },
-          baz2: {
-            type: 'array',
-            items: {
-              properties: {
-                foo: {
-                  type: 'string'
-                },
-                bar: {
-                  type: 'string'
-                }
-              }
-            }
           }
         }
       },

package/test/component/dereference.test.js

@@ -18,20 +18,6 @@ it('should dereference', () => {
   assert.deepStrictEqual(source, fixtures.target)
 })
 
-it('should throw on invalid schema reference', () => {
-  source.operations.transit.output.properties.baz = { type: 'string', default: '.' }
-  assert.throws(
-    () => dereference(source),
-    (error) => /is not defined/.test(error.message)
-  )
-
-  source.operations.transit.output.properties.baz = { type: 'string', default: '.baz' }
-  assert.throws(
-    () => dereference(source),
-    (error) => /is not defined/.test(error.message)
-  )
-})
-
 it('should throw on invalid forwarding', () => {
   source.operations.create.forward = 'foo'
   assert.throws(

package/test/component/normalize.test.js

@@ -25,6 +25,14 @@ describe('operations', () => {
     assert.deepStrictEqual(manifest.operations.add.output, {})
   })
 
+  it('should state no input for an operation that takes none', async () => {
+    manifest.operations.compute = { type: 'computation', input: null }
+
+    await normalize(manifest)
+
+    assert.equal('input' in manifest.operations.compute, false)
+  })
+
   it('should scope a computation to none', async () => {
     manifest.operations.compute = { type: 'computation' }
 

package/types/context/declaration.d.ts

@@ -1,4 +1,4 @@
-import { Registry, Runtime } from '../context.js'
+import { Registry, Runtime } from '../context.d.ts'
 
 /** A composition as declared, before its members are resolved. */
 interface Composition {

package/types/context.d.ts

@@ -1,6 +1,6 @@
-import { Manifest } from './component.js'
+import { Manifest } from './component.d.ts'
 import { Locator } from '@toa.io/core'
-import type { Declaration } from './context/declaration.js'
+import type { Declaration } from './context/declaration.d.ts'
 
 interface Runtime {
   version: string
@@ -44,4 +44,11 @@ interface Context extends Declaration {
   packages?: Record<string, string>
 }
 
-export function context(path: string, environment?: string): Promise<Context>
+export function context(
+  path: string,
+  environment?: string,
+  options?: {
+    /** `false` does not apply eviction: every component is treated as deployed */
+    evicted?: boolean
+  }
+): Promise<Context>

package/types/entity.d.ts

@@ -1,4 +1,4 @@
-import type { Entity } from './component.js'
+import type { Entity } from './component.d.ts'
 
 /** The schema a stored record must fit. */
 export function schema(entity: Entity): object

package/types/index.d.ts

@@ -1,8 +1,8 @@
-export * as context from './context.js'
-export * as component from './component.js'
+export * as context from './context.d.ts'
+export * as component from './component.d.ts'
 
-export { Manifest } from './component.js'
-export * as entity from './entity.js'
+export { Manifest } from './component.d.ts'
+export * as entity from './entity.d.ts'
 
 export interface Definition {
   /** The package's name, or the reference where it has no package.json */