@toa.io/norm 0.20.0-dev.8 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/norm",
-  "version": "0.20.0-dev.8",
+  "version": "0.20.0",
   "description": "Toa declarations normalization and validation",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -12,6 +12,7 @@
     "url": "https://github.com/toa-io/toa/issues"
   },
   "main": "src/index.js",
+  "types": "types/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -19,11 +20,11 @@
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
   "dependencies": {
-    "@toa.io/core": "0.20.0-dev.8",
-    "@toa.io/generic": "0.20.0-dev.8",
-    "@toa.io/schema": "0.20.0-dev.8",
-    "@toa.io/schemas": "0.20.0-dev.8",
-    "@toa.io/yaml": "0.20.0-dev.8"
+    "@toa.io/core": "0.20.0",
+    "@toa.io/generic": "0.20.0",
+    "@toa.io/schema": "0.20.0",
+    "@toa.io/schemas": "0.20.0",
+    "@toa.io/yaml": "0.20.0"
   },
-  "gitHead": "d8c08ec7def70ad93de06541af497cce8c4c1b50"
+  "gitHead": "28fc4b45c224c3683acaaf0e4abd1eb04e07b408"
 }

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

@@ -9,8 +9,11 @@ function extensions (manifest) {
 
 const SHORTCUTS = {
   exposition: '@toa.io/extensions.exposition',
+  realtime: '@toa.io/extensions.realtime',
   origins: '@toa.io/extensions.origins',
-  configuration: '@toa.io/extensions.configuration'
+  configuration: '@toa.io/extensions.configuration',
+  state: '@toa.io/extensions.state',
+  stash: '@toa.io/extensions.stash'
 }
 
 exports.extensions = extensions

package/src/.component/.expand/operations.js

@@ -10,7 +10,10 @@ function operations (manifest) {
     if (operation.input !== undefined) operation.input = expand(operation.input)
     if (operation.output !== undefined) operation.output = expand(operation.output)
     if (operation.bridge !== undefined) operation.bridge = resolve(operation.bridge)
-    if (operation.bindings !== undefined) operation.bindings = operation.bindings.map(resolve)
+
+    if (operation.bindings !== undefined && operation.bindings !== null) {
+      operation.bindings = operation.bindings.map(resolve)
+    }
   }
 }
 

package/src/.component/.normalize/index.js

@@ -1,11 +1,9 @@
 'use strict'
 
 const { events } = require('./events')
-const { extensions } = require('./extensions')
 const { operations } = require('./operations')
 const { receivers } = require('./receivers')
 
 exports.events = events
-exports.extensions = extensions
 exports.operations = operations
 exports.receivers = receivers

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

@@ -4,7 +4,11 @@ const operations = (component) => {
   if (component.operations === undefined) return
 
   for (const [endpoint, operation] of Object.entries(component.operations)) {
+    if (operation.type === 'computation' || operation.type === 'effect')
+      operation.query = false
+
     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/{.normalize/extensions.js → extensions.js}

@@ -1,11 +1,8 @@
 'use strict'
 
 const { directory: { find } } = require('@toa.io/filesystem')
-const { resolve } = require('../../shortcuts')
+const { resolve } = require('../shortcuts')
 
-/**
- * @param {toa.norm.Component} manifest
- */
 const extensions = (manifest) => {
   if (manifest.extensions === undefined) return
 

package/src/.component/index.js

@@ -8,6 +8,7 @@ const { expand } = require('./expand')
 const { merge } = require('./merge')
 const { normalize } = require('./normalize')
 const { validate } = require('./validate')
+const { extensions } = require('./extensions')
 
 exports.collapse = collapse
 exports.defaults = defaults
@@ -17,3 +18,4 @@ exports.expand = expand
 exports.merge = merge
 exports.normalize = normalize
 exports.validate = validate
+exports.extensions = extensions

package/src/.component/normalize.js

@@ -1,14 +1,11 @@
 'use strict'
 
-const { convolve } = require('@toa.io/generic')
-const { events, operations, extensions, receivers } = require('./.normalize')
+const { events, operations, receivers } = require('./.normalize')
 
-const normalize = (component, environment) => {
-  convolve(component, environment)
+const normalize = (component) => {
   operations(component)
   events(component)
   receivers(component)
-  extensions(component)
 }
 
 exports.normalize = normalize

package/src/.component/schema.yaml

@@ -20,7 +20,7 @@ properties:
       operations:
         type: object
         propertyNames:
-          $ref: 'definitions#/definitions/token'
+          $ref: 'definitions#/definitions/name'
         patternProperties:
           '.*':
             type: object
@@ -39,14 +39,15 @@ properties:
       label:
         $ref: 'definitions#/definitions/label'
 
+  name:
+    $ref: 'definitions#/definitions/token'
+
   namespace:
     $ref: 'definitions#/definitions/token'
     default: 'default'
     not:
       oneOf:
         - const: 'system'
-  name:
-    $ref: 'definitions#/definitions/token'
 
   version:
     $ref: 'definitions#/definitions/version'
@@ -67,18 +68,17 @@ properties:
             type: object
             propertyNames:
               oneOf:
-                - $ref: 'definitions#/definitions/token'
-                - enum: [ _version ]
+                - $ref: 'definitions#/definitions/name'
+                - enum: [_version]
       initialized:
         type: boolean
         default: false
-    required: [ schema ]
+    required: [schema]
     additionalProperties: false
 
   bindings:
     type: array
     uniqueItems: true
-    minItems: 1
     items:
       $ref: '#/definitions/binding'
 
@@ -88,19 +88,19 @@ properties:
   operations:
     type: object
     propertyNames:
-      $ref: 'definitions#/definitions/token'
+      $ref: 'definitions#/definitions/name'
     patternProperties:
       '.*':
         type: object
         properties:
           type:
-            enum: [ transition, observation, assignment, computation, effect ]
+            enum: [transition, observation, assignment, computation, effect]
           scope:
-            enum: [ object, objects, changeset, none ]
+            enum: [object, objects, changeset, none]
           concurrency:
-            enum: [ none, retry ]
+            enum: [none, retry]
           forward:
-            $ref: 'definitions#/definitions/token'
+            $ref: 'definitions#/definitions/name'
           bridge:
             type: string
           bindings:
@@ -111,7 +111,7 @@ properties:
             $ref: 'definitions#/definitions/schema'
           query:
             type: boolean
-        required: [ type, scope, bindings ]
+        required: [type, scope, bindings]
         allOf:
           - if: # transition
               properties:
@@ -120,15 +120,15 @@ properties:
             then:
               properties:
                 scope:
-                  enum: [ object ]
+                  enum: [object]
               if: # transition query: false
                 not:
                   properties:
                     query:
                       const: false
-                  required: [ query ]
+                  required: [query]
               then:
-                required: [ concurrency ]
+                required: [concurrency]
           - if: # not transition
               not:
                 properties:
@@ -145,7 +145,7 @@ properties:
             then:
               properties:
                 scope:
-                  enum: [ object, objects, none ]
+                  enum: [object, objects, none]
                 query:
                   not:
                     const: false
@@ -156,7 +156,7 @@ properties:
             then:
               properties:
                 scope:
-                  enum: [ changeset ]
+                  enum: [changeset]
           - if: # computation
               properties:
                 type:
@@ -166,6 +166,9 @@ properties:
                 scope:
                   const: none
                   default: none
+                query:
+                  const: false
+                  default: false
           - if: # effect
               properties:
                 type:
@@ -175,13 +178,16 @@ properties:
                 scope:
                   const: none
                   default: none
+                query:
+                  const: false
+                  default: false
         additionalProperties: false
     additionalProperties: false
 
   events:
     type: object
     propertyNames:
-      $ref: 'definitions#/definitions/token'
+      $ref: 'definitions#/definitions/name'
     patternProperties:
       '.*':
         type: object
@@ -198,7 +204,7 @@ properties:
           subjective:
             type: boolean
             default: false
-        required: [ bridge, path ]
+        required: [bridge, path]
         additionalProperties: false
 
   receivers:
@@ -208,13 +214,15 @@ properties:
         type: object
         properties:
           operation:
-            $ref: 'definitions#/definitions/token'
+            $ref: 'definitions#/definitions/name'
           bridge:
             type: string
           binding:
             type: string
           source:
-            $ref: 'definitions#/definitions/token'
+            $ref: 'definitions#/definitions/name'
+            not:
+              const: context
           path:
             type: string
           conditioned:
@@ -223,7 +231,7 @@ properties:
           adaptive:
             type: boolean
             default: false
-        required: [ operation ]
+        required: [operation]
         additionalProperties: false
 
   extensions:

package/src/.context/.dependencies/connectors.js

@@ -1,14 +1,14 @@
 'use strict'
 
-/**
- * @param {toa.norm.Context} context
- * @returns {toa.norm.context.dependencies.References}
- */
-const connectors = (context) => {
-  /** @type {toa.norm.context.dependencies.References} */
+const connectors = (context, extracted) => {
   const connectors = {}
 
-  for (const component of context.components) {
+  const components = (context.components === undefined
+      ? extracted
+      : context.components.concat(extracted)
+  ) ?? []
+
+  for (const component of components) {
     if (connectors[component.entity.storage] === undefined) {
       connectors[component.entity.storage] = []
     }

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

@@ -1,24 +1,56 @@
 'use strict'
 
-/**
- * @param {toa.norm.Context} context
- * @returns {toa.norm.context.dependencies.References}
- */
-const extensions = (context) => {
-  /** @type {toa.norm.context.dependencies.References} */
+const extensions = async (context) => {
   const extensions = {}
+  const components = context.components?.slice() ?? []
+  const extracted = await extractExtensionComponents(components, extensions)
 
-  for (const component of context.components) {
-    if (component.extensions !== undefined) {
-      for (const reference of Object.keys(component.extensions)) {
-        if (extensions[reference] === undefined) extensions[reference] = []
+  components.push(...extracted)
 
-        extensions[reference].push(component)
+  for (const component of components) {
+    if (component.extensions === undefined) continue
+
+    for (const reference of Object.keys(component.extensions)) {
+      if (extensions[reference] === undefined) extensions[reference] = []
+
+      extensions[reference].push(component)
+    }
+  }
+
+  return { extensions, components: extracted }
+}
+
+async function extractExtensionComponents (components, extensions) {
+  const { component: load } = require('../../component')
+
+  const extracted = []
+
+  for (const component of components) {
+    if (component.extensions === undefined) continue
+
+    for (const reference of Object.keys(component.extensions)) {
+      if (reference in extensions) continue
+
+      extensions[reference] = []
+
+      const mod = require(reference)
+
+      if (mod.components === undefined) continue
+
+      for (const path of mod.components().paths) {
+        const component = await load(path)
+
+        extracted.push(component)
       }
     }
   }
 
-  return extensions
+  if (extracted.length === 0)
+    return extracted
+
+  const deeper = await extractExtensionComponents(extracted, extensions)
+
+  return extracted.concat(deeper)
 }
 
 exports.extensions = extensions

package/src/.context/.dependencies/resolve.js

@@ -1,15 +1,8 @@
 'use strict'
 
-const { join } = require('node:path')
 const { load } = require('./load')
 
-/**
- * @param {toa.norm.context.dependencies.References} references
- * @param {Object} annotations
- * @returns {toa.norm.context.Dependencies}
- */
 const resolve = (references, annotations) => {
-  /** @type {toa.norm.context.Dependencies} */
   const dependencies = {}
 
   for (const [dependency, components] of Object.entries(references)) {
@@ -18,7 +11,8 @@ const resolve = (references, annotations) => {
 
     const instances = components.map((component) => ({
       locator: component.locator,
-      manifest: component.extensions?.[id]
+      manifest: component.extensions?.[id],
+      component
     }))
 
     dependencies[dependency] = instances

package/src/.context/dependencies.js

@@ -2,13 +2,10 @@
 
 const { connectors, extensions, resolve } = require('./.dependencies')
 
-/**
- * @param {toa.norm.Context} context
- * @returns {toa.norm.context.Dependencies}
- */
-const dependencies = (context) => {
-  /** @type {toa.norm.context.dependencies.References} */
-  const references = { ...connectors(context), ...extensions(context) }
+const dependencies = async (context) => {
+  const { extensions: e, components } = await extensions(context)
+  const c = connectors(context, components)
+  const references = { ...c, ...e }
 
   return resolve(references, context.annotations)
 }

package/src/component.js

@@ -14,17 +14,16 @@ const {
   dereference,
   defaults,
   dependencies,
-  normalize
+  normalize,
+  extensions
 } = require('./.component')
 
-/**
- * @type {toa.norm.component.Constructor}
- */
 const component = async (path) => {
   const manifest = await load(path)
 
-  normalize(manifest, process.env.TOA_ENV)
+  normalize(manifest)
   validate(manifest)
+  extensions(manifest)
 
   manifest.locator = new Locator(manifest.name, manifest.namespace)
 

package/src/context.js

@@ -16,9 +16,6 @@ const {
   validate
 } = require('./.context')
 
-/**
- * @type {toa.norm.context.Constructor}
- */
 const context = async (root, environment = process.env.TOA_ENV) => {
   const path = resolve(root, CONTEXT)
   const context = /** @type {toa.norm.Context} */ await load(path)
@@ -35,7 +32,7 @@ const context = async (root, environment = process.env.TOA_ENV) => {
   const paths = await glob(pattern)
 
   context.components = await Promise.all(paths.map(component))
-  context.dependencies = dependencies(context)
+  context.dependencies = await dependencies(context)
 
   dereference(context)
   complete(context)

package/src/shortcuts.js

@@ -46,8 +46,10 @@ const SHORTCUTS = {
   sql: '@toa.io/storages.sql',
   queues: '@toa.io/storages.queues',
   exposition: '@toa.io/extensions.exposition',
+  realtime: '@toa.io/extensions.realtime',
   configuration: '@toa.io/extensions.configuration',
-  origins: '@toa.io/extensions.origins'
+  origins: '@toa.io/extensions.origins',
+  stash: '@toa.io/extensions.stash'
 }
 
 exports.recognize = recognize

package/test/component/normalize.fixtures.js

@@ -3,15 +3,19 @@
 const { generate } = require('randomstring')
 
 const operations = {
+  namespace: 'dummies',
+  name: 'dummy',
   path: __dirname,
   bindings: ['foo', 'bar'],
   'bindings@local': ['foo'],
   operations: {
-    add: {}
+    add: {
+      type: 'assignment'
+    }
   },
   extensions: {
     '@toa.io/extensions.exposition': {
-      ['/' + generate()]: ['add']
+      ['/' + generate()]: {}
     },
     './dummies/extension': {
       ok: true

package/test/component/normalize.test.js

@@ -12,13 +12,6 @@ beforeEach(() => {
   manifest = clone(fixtures.operations)
 })
 
-describe('environment', () => {
-  it('should convolve with environment argument', () => {
-    normalize(manifest, 'local')
-    expect(manifest.operations.add.bindings).toStrictEqual(['foo'])
-  })
-})
-
 describe('operations', () => {
   it('should set default bindings', () => {
     normalize(manifest)
@@ -36,12 +29,6 @@ describe('extensions', () => {
 
     expect(manifest.extensions[path]).toStrictEqual(origins)
   })
-
-  it('should throw if manifest is undefined', () => {
-    manifest.extensions['./dummies/extension'].ok = false
-
-    expect(() => normalize(manifest)).toThrow(/hasn't returned manifest/)
-  })
 })
 
 describe('receivers', () => {

package/test/component/validate.fixtures.js

@@ -34,6 +34,16 @@ const ok = {
       scope: 'changeset',
       bridge: 'whatever',
       bindings: ['@toa.io/bindings.http', '@toa.io/bindings.amqp']
+    },
+    compute: {
+      type: 'computation',
+      bridge: 'whatever',
+      bindings: ['@toa.io/bindings.http', '@toa.io/bindings.amqp']
+    },
+    affect: {
+      type: 'effect',
+      bridge: 'whatever',
+      bindings: ['@toa.io/bindings.http', '@toa.io/bindings.amqp']
     }
   },
   events: {

package/test/component/validate.test.js

@@ -37,14 +37,14 @@ describe('namespace', () => {
     manifest.namespace = 'foo_'
     expect(() => validate(manifest)).toThrow(/must match pattern/)
 
-    manifest.namespace = 'foo-'
+    manifest.namespace = 'foo_bar'
     expect(() => validate(manifest)).toThrow(/must match pattern/)
 
-    manifest.namespace = 'foo-BAR'
-    expect(() => validate(manifest)).not.toThrow()
+    manifest.namespace = 'foo-'
+    expect(() => validate(manifest)).toThrow(/must match pattern/)
 
-    manifest.namespace = 'foo_bar'
-    expect(() => validate(manifest)).not.toThrow()
+    manifest.namespace = 'foo-bar'
+    expect(() => validate(manifest)).toThrow('must match pattern')
 
     manifest.namespace = 'FooBar12'
     expect(() => validate(manifest)).not.toThrow()
@@ -172,6 +172,15 @@ describe('operations', () => {
     expect(() => validate(manifest)).toThrow(/must NOT be valid/)
   })
 
+  it.each([
+    ['computation', 'compute'],
+    ['effect', 'affect']
+  ])('should set query: false for %s', async (_, operation) => {
+    validate(manifest)
+
+    expect(manifest.operations[operation].query).toBe(false)
+  })
+
   describe('scope', () => {
     it('should have scope', () => {
       delete manifest.operations.get.scope
@@ -230,7 +239,7 @@ describe('operations', () => {
 
 describe('receivers', () => {
   it('should throw if transition points to undefined operation', () => {
-    manifest.receivers['foo.bar.happened'].operation = 'not-exists'
+    manifest.receivers['foo.bar.happened'].operation = 'notExists'
 
     expect(() => validate(manifest)).toThrow(/refers to undefined operation/)
   })
@@ -240,4 +249,10 @@ describe('receivers', () => {
 
     expect(() => validate(manifest)).toThrow(/one of the allowed types/)
   })
+
+  it('should throw if source has a name `context`', async () => {
+    manifest.receivers['foo.bar.happened'].source = 'context'
+
+    expect(() => validate(manifest)).toThrow(/must NOT be valid/)
+  })
 })

package/types/component.d.ts

@@ -1,81 +1,62 @@
-import type {Locator} from '@toa.io/core/types'
+import type { Locator, operations } from '@toa.io/core'
 
-export namespace toa.norm {
-
-  namespace component {
-    namespace operations {
-
-      type Type = 'transition' | 'observation' | 'assignment' | 'computation' | 'effect'
-      type Scope = 'object' | 'objects' | 'changeset'
-
-    }
-
-    interface Map {
-      [id: string]: Component
-    }
-
-    interface Operation {
-      type?: operations.Type
-      scope?: operations.Scope
-      bindings?: string[]
-      input?: any
-      output?: any
-      error?: any
-    }
-
-    interface Operations {
-      [key: string]: Operation
-    }
-
-    interface Event {
-      binding: string
-    }
+type Map = {
+  [id: string]: Component
+}
 
-    interface Events {
-      [key: string]: Event
-    }
+type Operation = {
+  type: operations.type
+  scope?: operations.scope
+  bindings?: string[]
+  input?: any
+  output?: any
+  error?: any
+  query?: boolean
+}
 
-    interface Receiver {
-      operation: string
-      adaptive: boolean
-      conditioned: boolean
-      bridge: string
-      binding: string
-      path: string
-      source?: string
-    }
+type Operations = {
+  [key: string]: Operation
+}
 
-    type Entity = {
-      schema: Object
-      storage?: string
-      initialized?: boolean
-    }
+type Event = {
+  binding: string
+}
 
-    interface Declaration {
-      prototype: string
-      namespace: string
-      name: string
-      version: string
-      entity: Entity
-      bindings: string[]
-      operations?: Operations
-      events?: Events
-      receivers: Record<string, Receiver>
-      extensions?: Record<string, object>
-      properties?: Record<string, object>
-    }
+type Events = {
+  [key: string]: Event
+}
 
-    type Constructor = (path: string) => Promise<Component>
-  }
+type Receiver = {
+  operation: string
+  adaptive: boolean
+  conditioned: boolean
+  bridge: string
+  binding: string
+  path: string
+  source?: string
+}
 
-  interface Component extends component.Declaration {
-    locator: Locator
-    path: string
-  }
+type Entity = {
+  schema: Object
+  storage?: string
+  initialized?: boolean
 }
 
-export type Component = toa.norm.Component
-export type Operation = toa.norm.component.Operation
-export type Declaration = toa.norm.component.Declaration
+type Declaration = {
+  prototype?: string
+  namespace: string
+  name: string
+  version: string
+  entity?: Entity
+  bindings?: string[]
+  operations: Operations
+  events?: Events
+  receivers?: Record<string, Receiver>
+  extensions?: Record<string, object>
+  properties?: Record<string, object>
+}
 
-export const component: toa.norm.component.Constructor
+export type Manifest = Declaration & {
+  locator: Locator
+  path: string
+}

package/types/context/declaration.d.ts

@@ -0,0 +1,17 @@
+import { Composition, Registry, Runtime } from '../context'
+
+interface Composition {
+  name: string,
+  components: string[]
+}
+
+export interface Declaration {
+  name: string
+  description?: string
+  version?: string
+  runtime?: Runtime | string
+  registry?: Registry | string
+  packages?: string
+  compositions?: Composition[]
+  annotations?: Record<string, object>
+}

package/types/context.d.ts

@@ -1,76 +1,41 @@
 import * as _component from './component'
 import { Locator } from '@toa.io/core/types'
+import type { Declaration } from './context/declaration'
 
-declare namespace toa.norm {
-
-  namespace context {
-
-    interface Runtime {
-      version: string
-      registry?: string
-      proxy?: string
-    }
-
-    interface Registry {
-      base?: string
-      platforms?: string[] | null
-      build?: {
-        arguments?: string[]
-        run?: string
-      }
-    }
-
-    interface Composition {
-      name: string,
-      components: string[] | _component.Component[]
-    }
-
-    namespace dependencies {
-
-      type Instance = {
-        locator: Locator
-        manifest?: Object
-      }
-
-      type References = {
-        [reference: string]: _component.Component[]
-      }
-
-    }
-
-    interface Dependencies {
-      [reference: string]: dependencies.Instance[]
-    }
-
-    interface Declaration {
-      name: string
-      description?: string
-      version?: string
-      runtime?: Runtime | string
-      registry?: Registry | string
-      packages?: string
-      compositions?: Composition[]
-      annotations?: Record<string, object>
-    }
-
-    type Constructor = (path: string, environment?: string) => Promise<Context>
-  }
+interface Runtime {
+  version: string
+  registry?: string
+  proxy?: string
+}
 
-  interface Context extends context.Declaration {
-    runtime?: context.Runtime
-    environment?: string
-    registry?: context.Registry
-    components?: _component.Component[]
-    dependencies?: context.Dependencies
-  }
+interface Registry {
+  base?: string
+  platforms?: string[] | null
+  build?: {
+    arguments?: string[]
+    run?: string
+  },
+  credentials: string
+}
 
+interface Composition {
+  name: string,
+  components: _component.Component[]
 }
 
-export type Composition = toa.norm.context.Composition
-export type Context = toa.norm.Context
+export interface Dependency<T = undefined> {
+  locator: Locator
+  manifest: T,
+  component: _component.Component
+}
 
-export namespace dependencies {
-  export type Instance = toa.norm.context.dependencies.Instance
+interface Context extends Declaration {
+  runtime?: Runtime
+  environment?: string
+  registry?: Registry
+  compositions?: Composition[]
+  components?: _component.Component[]
+  dependencies?: Record<string, Dependency[]>
 }
 
-export const context: toa.norm.context.Constructor
+export function context (path: string, environment?: string): Promise<Context>

package/types/index.d.ts

@@ -1,5 +1,4 @@
-export { component } from './component'
-export { context } from './context'
+export * as context from './context'
+export * as component from './component'
 
-export type { Composition, dependencies } from './context'
-export type { Component, Operation } from './component'
+export { Manifest } from './component'

package/features/component.operations.feature

@@ -1,54 +0,0 @@
-Feature: Operations declaration
-
-  Scenario Outline: Operation <channel> entity references
-
-  Operation IO schemas may reference entity's properties using syntax:
-  - `.` - entity's property with the same name
-  - '.foo` - entity's property with `foo` name
-
-    Given I have an entity schema:
-      """
-      foo: string
-      bar: 1
-      """
-    When I declare assignment with:
-      """
-      <channel>:
-        foo: .
-        baz: .bar
-      """
-    Then normalized assignment declaration must contain:
-      """
-      <channel>:
-        type: object
-        properties:
-          foo:
-            type: string
-          baz:
-            type: number
-            default: 1
-      """
-
-    Examples:
-      | channel |
-      | input   |
-      | output  |
-
-  Scenario: Prototype property reference
-
-  Operation IO schemas must be able to reference prototype's entity properties.
-
-    When I declare assignment with:
-      """
-      output:
-        id: .
-      """
-
-    Then normalized assignment declaration must contain:
-      """
-      output:
-        type: object
-        properties:
-          id:
-            $ref: https://schemas.toa.io/0.0.0/definitions#/definitions/id
-      """

package/features/steps/.test/manifest.test.js

@@ -1,111 +0,0 @@
-'use strict'
-
-const { AssertionError } = require('assert')
-const { generate } = require('randomstring')
-const { dump } = require('@toa.io/yaml')
-const gherkin = require('@toa.io/tomato')
-
-const mock = { gherkin }
-
-jest.mock('@cucumber/cucumber', () => mock.gherkin)
-require('../manifest')
-
-it('should be', () => undefined)
-
-/** @type {toa.norm.features.Context} */
-let context
-
-beforeEach(() => {
-  const manifest = /** @type {toa.norm.component.Declaration} */ {
-    name: 'test',
-    namespace: 'features',
-    version: '1.0.0',
-    entity: null
-  }
-
-  context = { manifest }
-})
-
-describe('Given I have an entity schema:', () => {
-  const step = gherkin.steps.Gi('I have an entity schema:')
-
-  it('should be', () => undefined)
-
-  it('should set entity schema', () => {
-    const schema = { foo: 'string' }
-    const yaml = dump(schema)
-
-    step.call(context, yaml)
-
-    expect(context.manifest.entity).toStrictEqual({ schema })
-  })
-})
-
-describe('When I declare {operation} with:', () => {
-  const step = gherkin.steps.Wh('I declare {operation} with:')
-
-  it('should be', () => undefined)
-
-  it('should declare operation', () => {
-    const type = 'assignment'
-    const scope = 'changeset'
-    const input = {}
-    const yaml = dump(input)
-
-    step.call(context, type, yaml)
-
-    expect(context.manifest.operations[type]).toStrictEqual({ type, scope })
-  })
-})
-
-describe('Then normalized {operation} declaration must contain:', () => {
-  const step = gherkin.steps.Th('normalized {operation} declaration must contain:')
-
-  it('should be', () => undefined)
-
-  it('should throw if does not contain', async () => {
-    const type = 'assignment'
-
-    context.manifest.operations = {
-      [type]: {
-        type,
-        input: { bar: 'number' },
-        scope: 'changeset'
-      }
-    }
-
-    const input = {
-      type: 'object',
-      properties: {
-        bar: { type: 'string' }
-      }
-    }
-
-    const yaml = dump({ input })
-
-    await expect(step.call(context, type, yaml)).rejects.toThrow(AssertionError)
-  })
-
-  it('should not throw if contain', async () => {
-    const type = 'assignment'
-
-    context.manifest.operations = {
-      [type]: {
-        type,
-        input: { bar: 'number' },
-        scope: 'changeset'
-      }
-    }
-
-    const input = {
-      type: 'object',
-      properties: {
-        bar: { type: 'number' }
-      }
-    }
-
-    const yaml = dump({ input })
-
-    await expect(step.call(context, type, yaml)).resolves.not.toThrow()
-  })
-})

package/features/steps/.types/context.d.ts

@@ -1,9 +0,0 @@
-import { Declaration } from '../../../types/component'
-
-declare namespace toa.norm.features {
-
-  type Context = {
-    manifest?: Declaration
-  }
-
-}

package/features/steps/hooks.js

@@ -1,18 +0,0 @@
-'use strict'
-
-const { Before } = require('@cucumber/cucumber')
-
-Before(
-  /**
-   * @this {toa.norm.features.Context}
-   */
-  function () {
-    this.manifest = {
-      name: 'test',
-      namespace: 'features',
-      version: '1.0.0',
-      entity: {
-        storage: null
-      }
-    }
-  })

package/features/steps/manifest.js

@@ -1,66 +0,0 @@
-'use strict'
-
-const assert = require('node:assert')
-const { join } = require('node:path')
-const { parse, save } = require('@toa.io/yaml')
-const { directory } = require('@toa.io/filesystem')
-const { match } = require('@toa.io/generic')
-
-const { component: load } = require('../../src')
-
-const { Given, When, Then } = require('@cucumber/cucumber')
-
-Given('I have an entity schema:',
-  /**
-   * @param {string} yaml
-   * @this {toa.norm.features.Context}
-   */
-  function (yaml) {
-    const schema = parse(yaml)
-
-    this.manifest.entity = { schema }
-  })
-
-When('I declare {operation} with:',
-  /**
-   * @param {toa.norm.component.operations.Type} type
-   * @param {string} yaml
-   * @this {toa.norm.features.Context}
-   */
-  function (type, yaml) {
-    /** @type {toa.norm.component.Operation} */
-    const declaration = parse(yaml)
-
-    declaration.type = type
-    declaration.scope = scope(type)
-
-    this.manifest.operations = { [type]: declaration }
-  })
-
-Then('normalized {operation} declaration must contain:',
-  /**
-   * @param {toa.norm.component.operations.Type} type
-   * @param {string} yaml
-   * @this {toa.norm.features.Context}
-   */
-  async function (type, yaml) {
-    const temp = await directory.temp()
-    const path = join(temp, 'manifest.toa.yaml')
-
-    await save(this.manifest, path)
-
-    const manifest = await load(temp)
-    const operation = manifest.operations[type]
-    const query = parse(yaml)
-    const contains = match(operation, query)
-
-    assert.equal(contains, true)
-  })
-
-/**
- * @param {toa.norm.component.operations.Type} type
- * @returns {toa.norm.component.operations.Scope}
- */
-const scope = (type) => {
-  return type === 'assignment' ? 'changeset' : 'object'
-}

package/features/steps/parameters.js

@@ -1,9 +0,0 @@
-'use strict'
-
-const { defineParameterType } = require('@cucumber/cucumber')
-
-defineParameterType({
-  name: 'operation',
-  regexp: /transition|observation|assignment/,
-  transformer: (type) => type
-})