@toa.io/userland 0.10.0 → 0.20.0-alpha.0

package/samples/test/suite.components.test.js

@@ -34,7 +34,7 @@ it('should define suite as autonomous', async () => {
   expect(suite.autonomous).toStrictEqual(true)
 })
 
-it('should load component samples', async () => {
+it('should load operation samples', async () => {
   const expected = await operations()
 
   expect(Object.keys(suite.operations)).toStrictEqual([component])
@@ -47,12 +47,6 @@ it('should load component samples', async () => {
   expect(set.undo).toStrictEqual(expected.undo)
 })
 
-it('should load message samples', async () => {
-  const expected = await messages()
-
-  expect(suite.messages).toStrictEqual(expected)
-})
-
 describe('options', () => {
   const paths = [dummy, pot]
 
@@ -63,11 +57,6 @@ describe('options', () => {
     suite = await components(paths, options)
 
     expect(suite.operations['dummies.pot']).toBeUndefined()
-
-    const messages = suite.messages['somewhere.something.happened']
-
-    expect(messages.length).toStrictEqual(1)
-    expect(messages[0].component).toStrictEqual('dummies.dummy')
   })
 
   it('should filter samples by operation name', async () => {
@@ -101,16 +90,14 @@ describe('options', () => {
     expect(suite.operations['dummies.dummy'].undo[0].title).toStrictEqual('Should not undo')
   })
 
-  it('should filter message samples by title', async () => {
+  it('should filter operation samples by title', async () => {
     /** @type {toa.samples.suite.Options} */
-    const options = { title: 'Something happened with a dummy' }
+    const options = { title: 'Should not undo' }
 
     suite = await components(paths, options)
 
-    const messages = suite.messages['somewhere.something.happened']
-
-    expect(messages.length).toStrictEqual(1)
-    expect(messages[0].title).toStrictEqual(options.title)
+    expect(Object.keys(suite.operations['dummies.dummy']).length).toStrictEqual(1)
+    expect(suite.operations['dummies.dummy'].undo[0].title).toStrictEqual(options.title)
   })
 })
 
@@ -133,16 +120,3 @@ const operations = async () => {
     do: [...do1, ...do2], undo
   }
 }
-
-/**
- *
- * @returns {Promise<toa.samples.messages.Set>}
- */
-const messages = async () => {
-  const label = 'somewhere.something.happened'
-  const file = resolve(dummy, 'samples/messages', label + '.yaml')
-  const declarations = await yaml.load.all(file)
-  const messages = declarations.map((sample) => ({ component, ...sample }))
-
-  return { [label]: messages }
-}

package/samples/types/operation.d.ts

@@ -1,5 +1,5 @@
 import * as _core from '@toa.io/core/types'
-import * as _sampling from '@toa.io/extensions.sampling'
+import * as _sampling from '@toa.io/extensions.sampling/types/request'
 
 declare namespace toa.samples {
 
@@ -27,7 +27,7 @@ declare namespace toa.samples {
     remote?: operations.Calls
     local?: operations.Calls
     events?: operations.Events
-    extensions?: _sampling.request.Extensions
+    extensions?: _sampling.Extensions
   }
 
 }

package/samples/types/replay.d.ts

@@ -2,9 +2,9 @@ import * as _suite from './suite'
 
 declare namespace toa.samples.replay {
 
-  type components = (paths: string[], options?: _suite.Options) => Promise<boolean>
-  type context = (path: string, options?: _suite.Options) => Promise<boolean>
-  type replay = (suite: _suite.Suite, paths: string[]) => Promise<boolean>
+    type components = (paths: string[], options?: _suite.Options) => Promise<boolean>
+    type context = (path: string, options?: _suite.Options) => Promise<boolean>
+    type replay = (suite: _suite.Suite, paths: string[], options?: object) => Promise<boolean>
 
 }
 

package/samples/types/suite.d.ts

@@ -1,3 +1,4 @@
+import * as _core from '@toa.io/core/types'
 import * as _operations from './operation'
 import * as _messages from './message'
 
@@ -8,15 +9,17 @@ declare namespace toa.samples {
 
     type Options = {
       id?: string
-      integration?: boolean
       component?: string
+      autonomous?: boolean
+      integration?: boolean
       operation?: string
       title?: string
+      runner?: object
     }
   }
 
   type Suite = {
-    title: string
+    title?: string
     autonomous: boolean
     operations?: suite.Operations
     messages?: _messages.Set

package/stage/src/binding/binding.js

@@ -5,42 +5,43 @@
  */
 class Binding {
   /** @type {Record<string, function[]>} */
-  #subs = {}
+  #callbacks = {}
 
   /** @type {Record<string, function>} */
-  #calls = {}
+  #producers = {}
 
   async subscribe (label, callback) {
-    if (this.#subs[label] === undefined) this.#subs[label] = []
+    if (this.#callbacks[label] === undefined) this.#callbacks[label] = []
 
-    this.#subs[label].push(callback)
+    this.#callbacks[label].push(callback)
   }
 
   async emit (label, message) {
-    const callbacks = this.#subs[label]
-
-    if (callbacks === undefined) return undefined
+    if (!(label in this.#callbacks)) return
 
+    const callbacks = this.#callbacks[label]
     const promises = callbacks.map((callback) => callback(message))
 
     await Promise.all(promises)
   }
 
   async reply (label, produce) {
-    if (this.#calls[label] !== undefined) throw new Error(`Label '${label}' is already bound`)
+    if (label in this.#producers) throw new Error(`Label '${label}' is already bound`)
 
-    this.#calls[label] = produce
+    this.#producers[label] = produce
   }
 
   async request (label, request) {
-    if (this.#calls[label] === undefined) throw new Error(`Label '${label}' is not bound`)
+    if (!(label in this.#producers)) throw new Error(`Label '${label}' is not bound`)
+
+    const produce = this.#producers[label]
 
-    return this.#calls[label](request)
+    return produce(request)
   }
 
   reset () {
-    this.#subs = {}
-    this.#calls = {}
+    this.#callbacks = {}
+    this.#producers = {}
   }
 }
 

package/stage/src/component.js

@@ -4,8 +4,10 @@ const boot = require('@toa.io/boot')
 const { state } = require('./state')
 
 /** @type {toa.stage.Component} */
-const component = async (path) => {
-  const manifest = await boot.manifest(path)
+const component = async (path, options) => {
+  options = Object.assign({}, DEFAULTS, options)
+
+  const manifest = await boot.manifest(path, options)
   const component = await boot.component(manifest)
 
   await component.connect()
@@ -15,4 +17,7 @@ const component = async (path) => {
   return component
 }
 
+const binding = require.resolve('./binding')
+const DEFAULTS = { bindings: [binding] }
+
 exports.component = component

package/stage/src/index.js

@@ -7,9 +7,6 @@ const { remote } = require('./remote')
 const { shutdown } = require('./shutdown')
 const binding = require('./binding')
 
-// staging always runs on local deployment environment
-process.env.TOA_DEV = '1'
-
 exports.manifest = manifest
 exports.component = component
 exports.composition = composition

package/stage/test/component.test.js

@@ -18,7 +18,7 @@ it('should boot component', async () => {
   const path = generate()
   const component = await stage.component(path)
 
-  expect(mock.boot.manifest).toHaveBeenCalledWith(path)
+  expect(mock.boot.manifest.mock.calls[0][0]).toStrictEqual(path)
   expect(mock.boot.component).toHaveBeenCalledWith(await mock.boot.manifest.mock.results[0].value)
   expect(component).toStrictEqual(await mock.boot.component.mock.results[0].value)
   expect(component.connect).toHaveBeenCalled()

package/stage/types/index.d.ts

@@ -1,9 +1,10 @@
 import * as _core from '@toa.io/core/types'
 import * as _norm from '@toa.io/norm/types'
+import * as _composition from '@toa.io/boot/types/composition'
 
 declare namespace toa.stage {
   type Manifest = (path: string) => Promise<_norm.Component>
-  type Component = (path: string) => Promise<_core.Component>
+  type Component = (path: string, options?: _composition.Options) => Promise<_core.Component>
   type Composition = (paths: string[]) => Promise<void>
   type Remote = (id: string) => Promise<_core.Component>
   type Shutdown = () => Promise<void>

package/example/components/tea.pots/samples/messages/store.orders.created.yaml

@@ -1,37 +0,0 @@
-title: Should book a pot
-payload:
-  pot: 1b9d7983bc204c8f8928d843a666a642
-input:
-  booked: true
-query:
-  id: 1b9d7983bc204c8f8928d843a666a642
----
-title: Should book a pot (with request sample)
-payload:
-  pot: 1b9d7983bc204c8f8928d843a666a642
-input:
-  booked: true
-query:
-  id: 1b9d7983bc204c8f8928d843a666a642
-request:
-  current:
-    id: 1b9d7983bc204c8f8928d843a666a642
-    material: glass
-    booked: false
-  next:
-    id: 1b9d7983bc204c8f8928d843a666a642
-    material: glass
-    booked: true
----
-title: Should book a pot (without receiver output verification)
-payload:
-  pot: 1b9d7983bc204c8f8928d843a666a642
-request:
-  current:
-    id: 1b9d7983bc204c8f8928d843a666a642
-    material: glass
-    booked: false
-  next:
-    id: 1b9d7983bc204c8f8928d843a666a642
-    material: glass
-    booked: true

package/samples/src/.replay/.suite/translate/.operation/specials/configuration.js

@@ -1,26 +0,0 @@
-'use strict'
-
-/**
- * @param {toa.samples.Operation & Object} declaration
- */
-const configuration = (declaration) => {
-  const configuration = declaration.configuration
-
-  delete declaration.configuration
-
-  if (declaration.extensions === undefined) declaration.extensions = {}
-
-  if ('configuration' in declaration.extensions) {
-    throw new Error('Configuration extension sample is ambiguous')
-  }
-
-  /** @type {toa.sampling.request.extensions.Call} */
-  const call = {
-    result: configuration,
-    permanent: true
-  }
-
-  declaration.extensions.configuration = [call]
-}
-
-exports.configuration = configuration

package/samples/src/.replay/.suite/translate/.operation/specials/index.js

@@ -1,5 +0,0 @@
-'use strict'
-
-const { configuration } = require('./configuration')
-
-exports.configuration = configuration

package/samples/test/replay.fixtures.js

@@ -1,72 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-const { random } = require('@toa.io/generic')
-
-/** @type {toa.samples.Suite} */
-const suite = { autonomous: true, operations: {} }
-
-/**
- * @returns {toa.samples.Operation[]}
- */
-const ops = () => {
-  const samples = []
-
-  for (let i = 0; i < random(3) + 1; i++) {
-    const sample = {
-      input: generate(),
-      output: generate(),
-      local: generate(),
-      current: generate(),
-      next: generate()
-    }
-
-    samples.push(sample)
-  }
-
-  return samples
-}
-
-/**
- * @returns {toa.samples.Message[]}
- */
-const msgs = () => {
-  /** @type {toa.samples.Message[]} */
-  const samples = []
-
-  for (let i = 0; i < random(3) + 1; i++) {
-    const sample = /** @type {toa.samples.Message} */ {
-      component: generate(),
-      payload: generate(),
-      input: generate()
-    }
-
-    samples.push(sample)
-  }
-
-  return samples
-}
-
-// components
-for (let i = 0; i < random(3) + 1; i++) {
-  const id = generate() + '.' + generate()
-  const operations = {}
-  const messages = {}
-
-  for (let j = 0; j < random(3) + 1; j++) {
-    const endpoint = generate()
-    const label = generate()
-
-    operations[endpoint] = ops()
-    messages[label] = msgs()
-  }
-
-  suite.operations[id] = operations
-}
-
-/** @type {string} */
-const label = generate()
-
-suite.messages = { [label]: msgs() }
-
-exports.suite = suite