@toa.io/norm 1.0.0-alpha.286 → 1.0.0-alpha.287

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+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.287](https://github.com/toa-io/toa/compare/v1.0.0-alpha.286...v1.0.0-alpha.287) (2026-09-06)
+
+**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.286",
+  "version": "1.0.0-alpha.287",
   "type": "module",
   "description": "Toa declarations normalization and validation",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -21,11 +21,11 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.286",
+    "@toa.io/core": "1.0.0-alpha.287",
     "@toa.io/generic": "1.0.0-alpha.286",
-    "@toa.io/schemas": "1.0.0-alpha.286",
+    "@toa.io/schemas": "1.0.0-alpha.287",
     "fast-glob": "3.3.3",
     "js-yaml": "5.4.1"
   },
-  "gitHead": "81f3d0688f17668b902be336d1749cc715edcdb6"
+  "gitHead": "5c7944a70c16065ab6372072385cc1f02f5db77c"
 }

package/src/.component/collapse.js

@@ -45,6 +45,19 @@ export const collapse = (manifest, prototype) => {
     delete prototype.entity.properties.id
   }
 
+  /*
+   * `id` is the only one a component may state for itself. The rest are written by the runtime
+   * and read by it, so one redeclared here would be merged over what the prototype says and
+   * change what the record holds, or what a criterion against it compares — without the
+   * component that wrote it having anything to do with either.
+   */
+  for (const name of SYSTEM)
+    if (
+      manifest.entity?.properties?.[name] !== undefined &&
+      entity?.properties?.[name] !== undefined
+    )
+      throw new Error(`System property '${name}' cannot be overridden`)
+
   if (prototype.events !== undefined && manifest.events !== undefined)
     for (const event of Object.keys(prototype.events))
       if (event in manifest.events) delete prototype.events[event]
@@ -55,3 +68,6 @@ export const collapse = (manifest, prototype) => {
 
   merge(manifest, { entity, events, extensions })
 }
+
+/** What the runtime writes into every record. `id` is not among them: a component may own it. */
+const SYSTEM = ['VERSION', 'CREATED', 'UPDATED', 'DELETED']

package/test/component/collapse.test.js

@@ -38,6 +38,26 @@ describe('entity', () => {
     assert.deepStrictEqual(manifest, samples.entity.result)
   })
 
+  it('should let a component state its own id', () => {
+    const prototype = { entity: { properties: { id: { type: 'string' }, VERSION: {} } } }
+    const manifest = { name: 'pot', entity: { properties: { id: { type: 'number' } } } }
+
+    collapse(manifest, prototype)
+
+    assert.strictEqual(manifest.entity.custom, true)
+    assert.deepStrictEqual(manifest.entity.properties.id, { type: 'number' })
+  })
+
+  it('should refuse a component that states a property the runtime writes', () => {
+    const prototype = { entity: { properties: { DELETED: { type: 'integer' } } } }
+    const manifest = { name: 'pot', entity: { properties: { DELETED: { type: 'integer' } } } }
+
+    assert.throws(
+      () => collapse(manifest, prototype),
+      /System property 'DELETED' cannot be overridden/
+    )
+  })
+
   it('should not inherit migrations', () => {
     const manifest = { entity: { migrations: [{ id: '0002', steps: [] }] } }
     const prototype = { entity: { migrations: [{ id: '0001', steps: [] }] } }

package/test/component/normalize.test.js

@@ -65,6 +65,16 @@ describe('entity', () => {
     assert.deepStrictEqual(manifest.entity.associated, false)
     assert.deepStrictEqual(manifest.entity.custom, false)
   })
+
+  it('should allow a date-time on the record', async () => {
+    manifest.entity = { properties: { settled: { type: 'string', format: 'date-time' } } }
+
+    await normalize(manifest)
+
+    assert.deepStrictEqual(manifest.entity.properties.settled.format, 'date-time')
+  })
+
+
 })
 
 describe('extensions', () => {