@toa.io/norm 1.0.0-alpha.259 → 1.0.0-alpha.262

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 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.262](https://github.com/toa-io/toa/compare/v1.0.0-alpha.261...v1.0.0-alpha.262) (2026-08-28)
+
+
+### Features
+
+* **introspection:** add the introspection extension ([a07ed86](https://github.com/toa-io/toa/commit/a07ed8651404258d544f3b6d8236e58cf4da09ac))
+* **operations:** let a service claim a path prefix on the host ([02677d1](https://github.com/toa-io/toa/commit/02677d17fcd4222b07c3be458d93bcc496a016a8))
+
+
+
+
+
 # [1.0.0-alpha.259](https://github.com/toa-io/toa/compare/v1.0.0-alpha.258...v1.0.0-alpha.259) (2026-08-24)
 
 **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.259",
+  "version": "1.0.0-alpha.262",
   "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.259",
+    "@toa.io/core": "1.0.0-alpha.262",
     "@toa.io/generic": "1.0.0-alpha.254",
     "@toa.io/schemas": "1.0.0-alpha.254",
     "@toa.io/yaml": "1.0.0-alpha.254"
   },
-  "gitHead": "3f557c2f855f078163128c317e7cb2f3629968aa"
+  "gitHead": "e14059cf5cc364d933f2a4b3d7114f3b5ec0764f"
 }

package/src/.component/.expand/extensions.js

@@ -13,7 +13,8 @@ const SHORTCUTS = {
   configuration: '@toa.io/extensions.configuration',
   state: '@toa.io/extensions.state',
   stash: '@toa.io/extensions.stash',
-  storages: '@toa.io/extensions.storages'
+  storages: '@toa.io/extensions.storages',
+  introspection: '@toa.io/extensions.introspection'
 }
 
 exports.extensions = extensions

package/src/.component/extensions.js

@@ -34,7 +34,8 @@ const extensions = (manifest) => {
 
 const PREDEFINED = {
   '@toa.io/extensions.telemetry': null,
-  '@toa.io/extensions.fetch': null
+  '@toa.io/extensions.fetch': null,
+  '@toa.io/extensions.introspection': null
 }
 
 exports.extensions = extensions

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

@@ -3,7 +3,7 @@
 const extensions = async (context) => {
   const extensions = {}
   const components = context.components?.slice() ?? []
-  const extracted = await extractExtensionComponents(components, extensions)
+  const extracted = await extractExtensionComponents(components, extensions, context.annotations)
 
   components.push(...extracted)
 
@@ -20,8 +20,9 @@ const extensions = async (context) => {
   return { extensions, components: extracted }
 }
 
-async function extractExtensionComponents (components, extensions) {
+async function extractExtensionComponents (components, extensions, annotations) {
   const { component: load } = require('../../component')
+  const { load: loadDependency } = require('./load')
 
   const extracted = []
 
@@ -33,11 +34,14 @@ async function extractExtensionComponents (components, extensions) {
 
       extensions[reference] = []
 
-      const mod = require(reference)
+      const { metadata, module: mod } = loadDependency(reference)
 
       if (mod.components === undefined) continue
 
-      for (const path of mod.components().paths) {
+      // the annotation decides whether an extension contributes components at all
+      const annotation = annotations?.[metadata?.name ?? reference]
+
+      for (const path of mod.components(annotation).paths) {
         const component = await load(path)
 
         extracted.push(component)
@@ -48,7 +52,7 @@ async function extractExtensionComponents (components, extensions) {
   if (extracted.length === 0)
     return extracted
 
-  const deeper = await extractExtensionComponents(extracted, extensions)
+  const deeper = await extractExtensionComponents(extracted, extensions, annotations)
 
   return extracted.concat(deeper)
 }

package/src/.context/schema.yaml

@@ -86,6 +86,21 @@ properties:
               type: string
             minItems: 2
             maxItems: 2
+  ingress:
+    type: object
+    additionalProperties: false
+    properties:
+      hosts:
+        type: array
+        minItems: 1
+        items:
+          type: string
+      class:
+        type: string
+      annotations:
+        type: object
+      default:
+        type: boolean
   annotations:
     type: object
 required: [runtime, name, registry]

package/src/shortcuts.js

@@ -50,7 +50,8 @@ const SHORTCUTS = {
   configuration: '@toa.io/extensions.configuration',
   stash: '@toa.io/extensions.stash',
   storages: '@toa.io/extensions.storages',
-  telemetry: '@toa.io/extensions.telemetry'
+  telemetry: '@toa.io/extensions.telemetry',
+  introspection: '@toa.io/extensions.introspection'
 }
 
 exports.recognize = recognize

package/test/component/normalize.test.js

@@ -33,7 +33,8 @@ describe('extensions', () => {
 
     expect(manifest.extensions).toStrictEqual({
       '@toa.io/extensions.telemetry': null,
-      '@toa.io/extensions.fetch': null
+      '@toa.io/extensions.fetch': null,
+      '@toa.io/extensions.introspection': {}
     })
   })
 })

package/types/context/declaration.d.ts

@@ -15,6 +15,16 @@ export interface Mono {
   resources?: Resources
 }
 
+/**
+ * Cluster-level ingress configuration, applied to every service that declares one.
+ */
+export interface Ingress {
+  hosts?: string[]
+  class?: string
+  annotations?: Record<string, string>
+  default?: boolean
+}
+
 export interface Declaration {
   name: string
   description?: string
@@ -23,5 +33,6 @@ export interface Declaration {
   registry?: Registry | string
   compositions?: Composition[]
   mono?: Mono
+  ingress?: Ingress
   annotations?: Record<string, object>
 }