@toa.io/norm 1.0.0-alpha.32 → 1.0.0-alpha.320

package/src/map.js

@@ -0,0 +1,24 @@
+import { contract } from '@toa.io/core'
+
+/**
+ * Every component a Context has, with the version it runs and the contract of that version: its
+ * own, the ones its extensions bring, and the ones it evicts. A map is not rendered into a
+ * workload the way variables are, and an evicted component is called like any other, so it is
+ * described like any other.
+ *
+ * @param {toa.norm.Context} context
+ * @returns {Record<string, import('@toa.io/core').Contract>}
+ */
+export const map = (context) => {
+  const components = new Map()
+
+  for (const component of context.components ?? [])
+    components.set(component.locator.id, contract.component(component))
+
+  // what an extension brings reaches a context as an instance of what it depends on
+  for (const instances of Object.values(context.dependencies ?? {}))
+    for (const { component } of instances)
+      components.set(component.locator.id, contract.component(component))
+
+  return Object.fromEntries([...components].sort(([one], [other]) => one.localeCompare(other)))
+}

package/src/shortcuts.js

@@ -1,6 +1,4 @@
-'use strict'
-
-const { empty, merge } = require('@toa.io/generic')
+import { empty, merge } from '@toa.io/generic'
 
 /**
  * Resolves shortcuts
@@ -8,7 +6,7 @@ const { empty, merge } = require('@toa.io/generic')
  * @param {string} token
  * @returns {string}
  */
-const resolve = (token) => {
+export const resolve = (token) => {
   if (token in SHORTCUTS) return SHORTCUTS[token]
   else return token
 }
@@ -20,7 +18,7 @@ const resolve = (token) => {
  * @param {Object} object
  * @param {string} [group]
  */
-const recognize = (shortcuts, object, group) => {
+export const recognize = (shortcuts, object, group) => {
   if (object === undefined) return
 
   const target = group === undefined ? object : {}
@@ -38,21 +36,19 @@ const recognize = (shortcuts, object, group) => {
   if (group !== undefined && !empty(target)) object[group] = merge(object[group], target)
 }
 
-const SHORTCUTS = {
+export const SHORTCUTS = {
   amqp: '@toa.io/bindings.amqp',
+  http: '@toa.io/bindings.http',
   node: '@toa.io/bridges.node',
   bash: '@toa.io/bridges.bash',
   mongodb: '@toa.io/storages.mongodb',
-  sql: '@toa.io/storages.sql',
-  queues: '@toa.io/storages.queues',
   exposition: '@toa.io/extensions.exposition',
-  realtime: '@toa.io/extensions.realtime',
+  realtime: '@toa.io/extensions.exposition#realtime',
   configuration: '@toa.io/extensions.configuration',
-  origins: '@toa.io/extensions.origins',
   stash: '@toa.io/extensions.stash',
-  storages: '@toa.io/extensions.storages'
+  storages: '@toa.io/extensions.storages',
+  telemetry: '@toa.io/extensions.telemetry',
+  cadence: '@toa.io/extensions.cadence',
+  convergence: '@toa.io/extensions.convergence',
+  introspection: '@toa.io/extensions.introspection'
 }
-
-exports.recognize = recognize
-exports.resolve = resolve
-exports.SHORTCUTS = SHORTCUTS

package/test/component/collapse.fixtures.js

@@ -1,55 +1,47 @@
-'use strict'
-
-const { generate } = require('randomstring')
+import { generate } from 'randomstring'
 
 const entity = {
   manifest: {
     entity: {
-      schema: {
-        properties: {
-          foo: {
-            type: 'string'
-          },
-          bar: {
-            type: 'integer'
-          }
+      properties: {
+        foo: {
+          type: 'string'
         },
-        required: ['foo']
-      }
+        bar: {
+          type: 'integer'
+        }
+      },
+      required: ['foo']
     }
   },
   prototype: {
     entity: {
-      schema: {
-        properties: {
-          foo: {
-            default: 'ok'
-          },
-          baz: {
-            type: 'boolean'
-          }
+      properties: {
+        foo: {
+          minLength: 1
         },
-        required: ['baz']
-      }
+        baz: {
+          type: 'boolean'
+        }
+      },
+      required: ['baz']
     }
   },
   result: {
     entity: {
-      schema: {
-        properties: {
-          foo: {
-            type: 'string',
-            default: 'ok'
-          },
-          bar: {
-            type: 'integer'
-          },
-          baz: {
-            type: 'boolean'
-          }
+      properties: {
+        foo: {
+          type: 'string',
+          minLength: 1
         },
-        required: ['foo', 'baz']
-      }
+        bar: {
+          type: 'integer'
+        },
+        baz: {
+          type: 'boolean'
+        }
+      },
+      required: ['foo', 'baz']
     }
   }
 }
@@ -88,7 +80,6 @@ const operations = {
   result: {
     prototype: {
       prototype: null,
-      path: expect.any(String),
       operations: {
         add: {
           bridge: 'a'
@@ -131,4 +122,4 @@ const remotes = {
   }
 }
 
-exports.samples = { entity, operations, remotes }
+export const samples = { entity, operations, remotes }

package/test/component/collapse.test.js

@@ -1,9 +1,10 @@
-'use strict'
+import { describe, it, beforeEach } from 'node:test'
+import assert from 'node:assert/strict'
 
-const clone = require('clone-deep')
+import clone from 'clone-deep'
 
-const fixtures = require('./collapse.fixtures')
-const { collapse } = require('../../src/.component')
+import * as fixtures from './collapse.fixtures.js'
+import { collapse } from '../../src/.component/index.js'
 
 let samples
 
@@ -18,7 +19,7 @@ it('should ignore locator', () => {
 
   collapse(manifest, prototype)
 
-  expect(manifest).toStrictEqual(source)
+  assert.deepStrictEqual(manifest, source)
 })
 
 it('should remove prototype property', () => {
@@ -26,7 +27,7 @@ it('should remove prototype property', () => {
 
   collapse(manifest, {})
 
-  expect(manifest).toStrictEqual({})
+  assert.deepStrictEqual(manifest, {})
 })
 
 describe('entity', () => {
@@ -34,7 +35,80 @@ describe('entity', () => {
     const manifest = clone(samples.entity.manifest)
 
     collapse(manifest, samples.entity.prototype)
-    expect(manifest).toStrictEqual(samples.entity.result)
+    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 inherit migrations ahead of its own, under the prototype name', () => {
+    const manifest = { entity: { migrations: [{ id: '0002', steps: [] }] } }
+    const prototype = {
+      name: 'base',
+      entity: { migrations: [{ id: '0001', steps: [] }] }
+    }
+
+    collapse(manifest, prototype)
+
+    assert.deepStrictEqual(manifest.entity.migrations, [
+      { id: 'base:0001', steps: [], prototype: 'base' },
+      { id: '0002', steps: [] }
+    ])
+  })
+
+  it('should pass on what the prototype inherited as it is', () => {
+    const manifest = { entity: { migrations: [{ id: '0002', steps: [] }] } }
+    const prototype = {
+      name: 'base',
+      entity: {
+        migrations: [
+          { id: 'system:0001', steps: [], prototype: 'system' },
+          { id: '0001', steps: [] }
+        ]
+      }
+    }
+
+    collapse(manifest, prototype)
+
+    assert.deepStrictEqual(
+      manifest.entity.migrations.map(({ id }) => id),
+      ['system:0001', 'base:0001', '0002']
+    )
+  })
+
+  it('should inherit migrations into a component that declares none', () => {
+    const manifest = {}
+    const prototype = {
+      name: 'base',
+      entity: { migrations: [{ id: '0001', steps: [] }] }
+    }
+
+    collapse(manifest, prototype)
+
+    assert.deepStrictEqual(
+      manifest.entity.migrations.map(({ id }) => id),
+      ['base:0001']
+    )
   })
 })
 
@@ -44,12 +118,12 @@ it('should ignore bindings', () => {
   const manifest = clone(source)
 
   collapse(manifest, prototype)
-  expect(manifest).toStrictEqual(source)
+  assert.deepStrictEqual(manifest, source)
 
   delete manifest.bindings
 
   collapse(manifest, prototype)
-  expect(manifest).toStrictEqual({})
+  assert.deepStrictEqual(manifest, {})
 })
 
 it('should merge operations', () => {
@@ -57,5 +131,11 @@ it('should merge operations', () => {
   const prototype = clone(samples.operations.prototype)
 
   collapse(manifest, prototype, '/somewhere')
-  expect(manifest).toStrictEqual(samples.operations.result)
+
+  // the prototype's path is generated, so it is checked apart from the shape
+  assert.strictEqual(typeof manifest.prototype.path, 'string')
+
+  const { path, ...rest } = manifest.prototype
+
+  assert.deepStrictEqual({ ...manifest, prototype: rest }, samples.operations.result)
 })

package/test/component/dependencies.test.js

@@ -1,38 +1,40 @@
-'use strict'
+import { describe, it, beforeEach } from 'node:test'
+import assert from 'node:assert/strict'
 
-const { resolve } = require('node:path')
-const { dependencies } = require('../../src/.component')
+import { resolve } from 'node:path'
+import { dependencies } from '../../src/.component/index.js'
 
-const NORM = resolve(__dirname, '../../')
+const NORM = resolve(import.meta.dirname, '../../')
 
 it('should be', async () => {
-  expect(dependencies).toBeInstanceOf(Function)
+  assert.ok(dependencies instanceof Function)
 })
 
 /** @type {toa.norm.Component} */
 let component
 
 beforeEach(() => {
-  component = /** @type {toa.norm.Component} */ { path: __dirname }
+  component = /** @type {toa.norm.Component} */ { path: import.meta.dirname }
 })
 
-describe.each(/** @type {[string, string][]} */ [
+for (const [_, reference] of [
   ['package id', '@toa.io/norm'],
   ['relative path', '../../']
-])('%s', (_, reference) => {
-  it('should resolve storage', async () => {
-    component.entity = { storage: reference, schema: {} }
+])
+  describe(`${_}`, () => {
+    it('should resolve storage', async () => {
+      component.entity = { storage: reference, schema: {} }
 
-    dependencies(component)
+      dependencies(component)
 
-    expect(component.entity.storage).toStrictEqual(NORM)
+      assert.deepStrictEqual(component.entity.storage, NORM)
+    })
   })
-})
 
 it('should resolve toa packages', async () => {
   component.entity = { storage: '@toa.io/core', schema: {} }
 
   dependencies(component)
 
-  expect(component.entity.storage).toBeDefined()
+  assert.notStrictEqual(component.entity.storage, undefined)
 })

package/test/component/dereference.fixtures.js

@@ -1,16 +1,8 @@
-'use strict'
-
-const source = {
+export const source = {
   entity: {
-    schema: {
-      properties: {
-        foo: {
-          type: 'string'
-        },
-        bar: {
-          type: 'string',
-          default: '.foo'
-        }
+    properties: {
+      foo: {
+        type: 'string'
       }
     }
   },
@@ -19,42 +11,14 @@ 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'
           }
         }
       }
@@ -66,16 +30,11 @@ const source = {
   }
 }
 
-const target = {
+export const target = {
   entity: {
-    schema: {
-      properties: {
-        foo: {
-          type: 'string'
-        },
-        bar: {
-          type: 'string'
-        }
+    properties: {
+      foo: {
+        type: 'string'
       }
     }
   },
@@ -85,28 +44,6 @@ 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'
-                }
-              }
-            }
           }
         }
       },
@@ -125,28 +62,6 @@ 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'
-                }
-              }
-            }
           }
         }
       },
@@ -160,6 +75,3 @@ const target = {
     }
   }
 }
-
-exports.source = source
-exports.target = target

package/test/component/dereference.test.js

@@ -1,9 +1,10 @@
-'use strict'
+import { it, beforeEach } from 'node:test'
+import assert from 'node:assert/strict'
 
-const clone = require('clone-deep')
+import clone from 'clone-deep'
 
-const { dereference } = require('../../src/.component')
-const fixtures = require('./dereference.fixtures')
+import { dereference } from '../../src/.component/index.js'
+import * as fixtures from './dereference.fixtures.js'
 
 let source
 
@@ -14,18 +15,13 @@ beforeEach(() => {
 it('should dereference', () => {
   dereference(source)
 
-  expect(source).toStrictEqual(fixtures.target)
-})
-
-it('should throw on invalid schema reference', () => {
-  source.operations.transit.output.properties.baz = { type: 'string', default: '.' }
-  expect(() => dereference(source)).toThrow(/is not defined/)
-
-  source.operations.transit.output.properties.baz = { type: 'string', default: '.baz' }
-  expect(() => dereference(source)).toThrow(/is not defined/)
+  assert.deepStrictEqual(source, fixtures.target)
 })
 
 it('should throw on invalid forwarding', () => {
   source.operations.create.forward = 'foo'
-  expect(() => dereference(source)).toThrow(/is not defined/)
+  assert.throws(
+    () => dereference(source),
+    (error) => /is not defined/.test(error.message)
+  )
 })

package/test/component/dummies/extension/index.js

@@ -1,9 +1,5 @@
-'use strict'
-
-const manifest = (declaration) => {
+export const manifest = (declaration) => {
   if (declaration.ok !== true) return
 
   return declaration
 }
-
-exports.manifest = manifest

package/test/component/dummies/migrations/conflicting/migrations/0001-one.yaml

@@ -0,0 +1,2 @@
+- delete:
+    filter: {}

package/test/component/dummies/migrations/conflicting/migrations/0001-one.yml

@@ -0,0 +1,2 @@
+- delete:
+    filter: {}

package/test/component/dummies/migrations/malformed/migrations/0001-one.yaml

@@ -0,0 +1 @@
+index: not a list

package/test/component/dummies/migrations/ordered/migrations/0001-first.yml

@@ -0,0 +1,4 @@
+- index:
+    name: index_a
+    keys:
+      a: asc

package/test/component/dummies/migrations/ordered/migrations/0002-second.yaml

@@ -0,0 +1,4 @@
+- index:
+    name: index_b
+    keys:
+      b: asc

package/test/component/dummies/migrations/ordered/migrations/0010-third.json

@@ -0,0 +1 @@
+[{ "delete": { "filter": {} } }]

package/test/component/dummies/migrations/stateless/migrations/0001-one.yaml

@@ -0,0 +1,2 @@
+- delete:
+    filter: {}

package/test/component/expand.fixtures.js

@@ -1,11 +1,10 @@
-'use strict'
-
-const source = {
-  path: '',
+export const source = {
+  path: import.meta.dirname, // `version` hashes the component directory
   entity: {
     schema: {
+      type: 'object',
       properties: {
-        foo: 'string'
+        foo: { type: 'string' }
       }
     },
     storage: 'mongodb'
@@ -16,26 +15,30 @@ const source = {
       bridge: 'node',
       bindings: ['amqp'],
       input: {
+        type: 'object',
         properties: {
-          foo: 'integer',
+          foo: { type: 'integer' },
           bar: {
             type: 'array',
             items: {
+              type: 'object',
               properties: {
-                baz: 'string'
+                baz: { type: 'string' }
               }
             }
           }
         }
       },
       output: {
+        type: 'object',
         properties: {
-          foo: 'integer',
+          foo: { type: 'integer' },
           bar: {
             type: 'array',
             items: {
+              type: 'object',
               properties: {
-                baz: 'string'
+                baz: { type: 'string' }
               }
             }
           }
@@ -59,7 +62,7 @@ const source = {
   }
 }
 
-const target = {
+export const target = {
   entity: {
     schema: {
       type: 'object',
@@ -133,6 +136,3 @@ const target = {
     }
   }
 }
-
-exports.source = source
-exports.target = target