@toa.io/userland 1.2.0-dev.0 → 1.2.0-dev.10

package/example/components/echo/operations/signal.js

@@ -1,7 +1,15 @@
 'use strict'
 
-async function computation (input, context) {
-  return context.configuration.signal
+class Computation {
+  #context
+
+  async mount (context) {
+    this.#context = context
+  }
+
+  async execute () {
+    return this.#context.configuration.signal
+  }
 }
 
-exports.computation = computation
+exports.Computation = Computation

package/example/components/math.calculations/samples/add.yaml

@@ -1,7 +1,6 @@
 title: Should add numbers
 input:
-  a: 1
-  b: 2
+  $import: assets/ab.yaml
 output: 3
 ---
 title: Should add negative numbers

package/example/components/math.calculations/samples/assets/ab.yaml

@@ -0,0 +1,2 @@
+a: 1
+b: 2

package/example/components/web/operations/get.js

@@ -2,6 +2,10 @@
 
 async function computation (_, context) {
   const response = await context.http.dev.path.to.resource.get()
+  const type = response.headers.get('content-type')
+
+  if (type !== 'application/json') return { error: { code: 0, message: 'Unsupported media type ' + type } }
+
   const output = await response.json()
 
   return { output }

package/example/components/web/samples/get.yaml

@@ -1,5 +1,7 @@
 title: Should return response
 http:
+  headers:
+    get:sync: 'application/json'
   json:async:
     foo: bar
 output:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/userland",
-  "version": "1.2.0-dev.0",
+  "version": "1.2.0-dev.10",
   "description": "Toa development kit",
   "homepage": "https://toa.io",
   "author": {
@@ -24,14 +24,14 @@
   "main": "src/index.js",
   "types": "types/index.d.ts",
   "dependencies": {
-    "@toa.io/boot": "1.0.2-dev.0",
-    "@toa.io/core": "1.1.0-dev.0",
-    "@toa.io/filesystem": "1.0.2-dev.0",
-    "@toa.io/generic": "0.11.0-dev.0",
-    "@toa.io/norm": "1.0.2-dev.0",
-    "@toa.io/schemas": "0.8.4-dev.0",
-    "@toa.io/yaml": "0.7.6-dev.0",
+    "@toa.io/boot": "1.0.2-dev.10",
+    "@toa.io/core": "1.1.0-dev.10",
+    "@toa.io/filesystem": "1.0.2-dev.10",
+    "@toa.io/generic": "0.11.0-dev.10",
+    "@toa.io/norm": "1.0.2-dev.10",
+    "@toa.io/schemas": "0.8.4-dev.10",
+    "@toa.io/yaml": "0.7.6-dev.10",
     "tap": "16.3.4"
   },
-  "gitHead": "44a59b3ec335a1be8655b543891767bae799dba1"
+  "gitHead": "df6df35ff3e9f2d9416118a979d3885a8a1cd897"
 }

package/samples/readme.md

@@ -92,6 +92,40 @@ context (so as required extensions). See [examples](../example/samples).
 
 ## Replay
 
-Samples may be *replayed* using [`toa replay`](/runtime/cli/readme.md#replay) command.
-
 > Replaying samples requires local deployment environment.
+
+### CLI
+
+Samples may be replayed using [`toa replay`](/runtime/cli/readme.md#replay) command.
+
+See [features](/features/cli/replay.feature).
+
+### Framework
+
+`async components(paths: string[], options?): boolean`
+
+Replay component samples.
+
+`async components(paths: string[], options?): boolean`
+
+Replay context and its components' samples.
+
+#### Options
+
+<dl>
+<dt><code><strong>id</strong>: string</code></dt>
+<dd>Replay samples for a specified component</dd>
+
+<dt><code><strong>integration</strong>: string</code></dt>
+<dd>Replay samples for a specified component only</dd>
+<dd></dd>
+
+<dt><code><strong>operation</strong>: string</code></dt>
+<dd>Replay samples for specified operation</dd>
+
+<dt><code><strong>title</strong>: string</code></dt>
+<dd>Replay samples with titles matching given regexp</dd>
+
+</dl>
+
+See [types](types/suite.d.ts).

package/samples/src/.replay/.suite/operations.js

@@ -12,7 +12,6 @@ const operations = (operations, autonomous) =>
     for (const [id, set] of Object.entries(operations)) {
       await test.test(id, component(id, set, autonomous))
     }
-
   }
 
 exports.operations = operations

package/samples/src/.replay/test.js

@@ -6,12 +6,13 @@ const replay = require('./suite')
 
 /**
  * @param {toa.samples.Suite} suite
+ * @param {object} options
  * @return {Promise<boolean>}
  */
-const test = async (suite) => {
-  const { ok } = await tap.test(suite.title, replay.suite(suite))
+const test = async (suite, options) => {
+  const result = await tap.test(suite.title, options, replay.suite(suite))
 
-  return ok
+  return result === null ? false : result.ok
 }
 
 exports.test = test

package/samples/src/components.js

@@ -7,7 +7,7 @@ const { replay } = require('./replay')
 const components = async (paths, options = {}) => {
   const suite = await load(paths, options)
 
-  return await replay(suite, paths)
+  return await replay(suite, paths, options.runner)
 }
 
 exports.components = components

package/samples/src/context.js

@@ -15,7 +15,7 @@ const context = async (path, options = {}) => {
   let ok = true
 
   if (options.integration !== true) ok = await test.components(paths, options)
-  if (ok) ok = await replay(suite, paths)
+  if (ok) ok = await replay(suite, paths, options.runner)
 
   return ok
 }

package/samples/src/replay.js

@@ -4,10 +4,10 @@ const stage = require('@toa.io/userland/stage')
 const { test } = require('./.replay')
 
 /** @type {toa.samples.replay.replay} */
-const replay = async (suite, paths) => {
+const replay = async (suite, paths, options) => {
   await stage.composition(paths)
 
-  const ok = await test(suite)
+  const ok = await test(suite, options)
 
   await stage.shutdown()
 

package/samples/test/components.test.js

@@ -18,7 +18,7 @@ it('should be', () => {
 const paths = [generate()]
 
 /** @type {toa.samples.suite.Options} */
-const options = { component: generate() }
+const options = { component: generate(), runner: { [generate()]: generate() } }
 
 /** @type {boolean} */
 let result
@@ -34,7 +34,7 @@ it('should load suite', async () => {
 it('should replay suite', async () => {
   const suite = await mock.suite.components.mock.results[0].value
 
-  expect(mock.replay.replay).toHaveBeenCalledWith(suite, paths)
+  expect(mock.replay.replay).toHaveBeenCalledWith(suite, paths, options.runner)
 })
 
 it('should return result', async () => {

package/samples/test/context.test.js

@@ -27,7 +27,7 @@ const COMPONENTS = resolve(CONTEXT, 'components/*')
 let paths
 
 /** @type {toa.samples.suite.Options} */
-const options = { component: generate() }
+const options = { component: generate(), runner: { [generate()]: generate() } }
 
 /** @type {boolean} */
 let ok
@@ -55,7 +55,7 @@ it('should load integration suite', async () => {
 it('should replay integration suite', async () => {
   const suite = await mock.suite.context.mock.results[0].value
 
-  expect(replay.replay).toHaveBeenCalledWith(suite, paths)
+  expect(replay.replay).toHaveBeenCalledWith(suite, paths, options.runner)
 })
 
 it('should return false if components replay failed', async () => {

package/samples/test/replay.test.js

@@ -75,7 +75,6 @@ it('should invoke operations with translated samples', async () => {
 it('should emit translated messages', async () => {
   /**
    * @param {toa.samples.Message} declaration
-   * @param {string} id
    * @returns {{index: number, message: toa.sampling.Message}}
    */
   const translation = (declaration) => {

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

@@ -3,24 +3,25 @@ import * as _messages from './message'
 
 declare namespace toa.samples {
 
-  namespace suite {
-    type Operations = Record<string, _operations.Set>
+    namespace suite {
+        type Operations = Record<string, _operations.Set>
 
-    type Options = {
-      id?: string
-      integration?: boolean
-      component?: string
-      operation?: string
-      title?: string
+        type Options = {
+            id?: string
+            integration?: boolean
+            component?: string
+            operation?: string
+            title?: string
+            runner?: object
+        }
     }
-  }
 
-  type Suite = {
-    title: string
-    autonomous: boolean
-    operations?: suite.Operations
-    messages?: _messages.Set
-  }
+    type Suite = {
+        title: string
+        autonomous: boolean
+        operations?: suite.Operations
+        messages?: _messages.Set
+    }
 
 }