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

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 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.303](https://github.com/toa-io/toa/compare/v1.0.0-alpha.302...v1.0.0-alpha.303) (2026-09-12)
+
+### Features
+
+* **operations:** a composition states how many replicas it runs ([4466f5a](https://github.com/toa-io/toa/commit/4466f5abcc22c6dceb2994a0143b6bf9d5201d9d))
+* **telemetry:** let a component declare its own metrics ([05aa3c7](https://github.com/toa-io/toa/commit/05aa3c72cd6a160e1cef99df6176a7f627075bc0))
+
+
 # [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/norm",
-  "version": "1.0.0-alpha.302",
+  "version": "1.0.0-alpha.303",
   "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.302",
-    "@toa.io/definitions": "1.0.0-alpha.302",
+    "@toa.io/core": "1.0.0-alpha.303",
+    "@toa.io/definitions": "1.0.0-alpha.303",
     "@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": "3cbbca55a61711db78f98b13e50cf4d1afaf5c08"
+  "gitHead": "b8e9dd89f6d49756944687a95dfc786f12947286"
 }

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

@@ -13,5 +13,6 @@ const SHORTCUTS = {
   stash: '@toa.io/extensions.stash',
   storages: '@toa.io/extensions.storages',
   cadence: '@toa.io/extensions.cadence',
-  introspection: '@toa.io/extensions.introspection'
+  introspection: '@toa.io/extensions.introspection',
+  telemetry: '@toa.io/extensions.telemetry'
 }

package/src/.context/schema.yaml

@@ -77,6 +77,9 @@ properties:
             minLength: 1
         resources:
           $ref: '#/definitions/resources'
+        replicas:
+          type: integer
+          minimum: 1
       required: [name, components]
   evicted:
     description: >

package/test/component/normalize.test.js

@@ -81,15 +81,15 @@ describe('entity', () => {
 
     assert.deepStrictEqual(manifest.entity.properties.settled.format, 'date-time')
   })
-
-
 })
 
 describe('extensions', () => {
   it('should add predefined extensions', async () => {
     await extensions(manifest)
 
-    assert.strictEqual(manifest.extensions['@toa.io/extensions.telemetry'], null)
+    // telemetry normalizes its declaration, so a component that declares nothing has an
+    // empty one rather than none; fetch has no manifest of its own to normalize
+    assert.deepStrictEqual(manifest.extensions['@toa.io/extensions.telemetry'], {})
     assert.strictEqual(manifest.extensions['@toa.io/extensions.fetch'], null)
   })
 
@@ -99,7 +99,7 @@ describe('extensions', () => {
     await extensions(manifest)
 
     assert.deepStrictEqual(manifest.extensions, {
-      '@toa.io/extensions.telemetry': null,
+      '@toa.io/extensions.telemetry': {},
       '@toa.io/extensions.fetch': null,
       '@toa.io/extensions.introspection': {}
     })

package/test/context/validate.test.js

@@ -125,6 +125,21 @@ describe('compositions', () => {
       (error) => /must NOT have additional properties/.test(error.message)
     )
   })
+
+  it('should allow replicas of one', () => {
+    context.compositions[0].replicas = 1
+
+    assert.doesNotThrow(() => validate(context))
+  })
+
+  it('should refuse replicas below one', () => {
+    context.compositions[0].replicas = 0
+
+    assert.throws(
+      () => validate(context),
+      (error) => /must be >= 1/.test(error.message)
+    )
+  })
 })
 
 describe('evicted', () => {

package/types/context/declaration.d.ts

@@ -5,6 +5,7 @@ interface Composition {
   name: string
   components: string[]
   services?: string[]
+  replicas?: number
 }
 
 /** What Toa does not deploy for a context, whatever else names it: still part of it, deployed by other means. */

package/types/context.d.ts

@@ -23,6 +23,7 @@ interface Composition {
   name: string
   components: Manifest[]
   services?: string[]
+  replicas?: number
   /** what a deploy installs for the services this composition runs, by package name */
   packages?: Record<string, string>
 }