@toa.io/userland 1.0.0-alpha.3 → 1.0.0-alpha.30

package/samples/src/.replay/.suite/translate/.operation/.prepare/cast.test.js

@@ -1,94 +0,0 @@
-'use strict'
-
-const { cast } = require('./')
-
-it('should be', async () => {
-  expect(cast).toBeInstanceOf(Function)
-})
-
-it('should cast to a Map', async () => {
-  /** @type {toa.sampling.request.Extensions} */
-  const extensions = {
-    state: [{
-      result: {
-        'value:Map': { foo: 'bar' }
-      }
-    }]
-  }
-
-  cast(extensions)
-
-  const value = /** @type {Map} */ extensions.state[0].result.value
-
-  expect(value).toBeDefined()
-  expect(value).toBeInstanceOf(Map)
-  expect(Array.from(value.keys())).toStrictEqual(['foo'])
-  expect(value.get('foo')).toStrictEqual('bar')
-})
-
-it('should not throw if result is undefined', async () => {
-  const extensions = { state: [{}] }
-
-  expect(() => cast(extensions)).not.toThrow()
-})
-
-it('should cast to a Set', async () => {
-  const names = ['Mary', 'Bob', 'Elizabeth']
-
-  /** @type {toa.sampling.request.Extensions} */
-  const extensions = {
-    state: [{
-      result: {
-        'names:Set': names
-      }
-    }]
-  }
-
-  cast(extensions)
-
-  const set = /** @type {Map} */ extensions.state[0].result.names
-
-  expect(set).toBeDefined()
-  expect(set).toBeInstanceOf(Set)
-  expect(Array.from(set)).toStrictEqual(names)
-})
-
-it('should cast to a Function', async () => {
-  const extensions = {
-    foo: [{
-      result: {
-        'resolve:sync': 'hello'
-      }
-    }]
-  }
-
-  cast(extensions)
-
-  const resolve = extensions.foo[0].result.resolve
-
-  expect(resolve).toBeDefined()
-  expect(resolve).toBeInstanceOf(Function)
-  expect(resolve()).toStrictEqual('hello')
-})
-
-it('should cast to async Function', async () => {
-  const extensions = {
-    foo: [{
-      result: {
-        'resolve:async': 'hello'
-      }
-    }]
-  }
-
-  cast(extensions)
-
-  const resolve = extensions.foo[0].result.resolve
-
-  expect(resolve).toBeDefined()
-  expect(resolve).toBeInstanceOf(Function)
-
-  const promise = resolve()
-
-  expect(promise).toBeInstanceOf(Promise)
-  await expect(promise).resolves.toStrictEqual('hello')
-})

package/samples/src/.replay/.suite/translate/.operation/.prepare/expand.js

@@ -1,14 +0,0 @@
-'use strict'
-
-const shortcuts = require('./shortcuts')
-
-/**
- * @param {toa.samples.Operation & Object} declaration
- */
-function expand (declaration) {
-  for (const [shortcut, expand] of Object.entries(shortcuts)) {
-    if (shortcut in declaration) expand(declaration)
-  }
-}
-
-exports.expand = expand

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

@@ -1,7 +0,0 @@
-'use strict'
-
-const { expand } = require('./expand')
-const { cast } = require('./cast')
-
-exports.expand = expand
-exports.cast = cast

package/samples/src/.replay/.suite/translate/.operation/.prepare/shortcuts/.aspect.js

@@ -1,26 +0,0 @@
-'use strict'
-
-const aspect = (name) =>
-  /**
-   * @param {toa.samples.Operation & Record<string, any>} declaration
-   */
-    (declaration) => {
-    const value = declaration[name]
-
-    delete declaration[name]
-
-    if (declaration.extensions === undefined) declaration.extensions = {}
-
-    if (name in declaration.extensions) throw new Error(`${name} aspect sample is ambiguous`)
-
-    /** @type {toa.sampling.request.extensions.Call} */
-    const call = {
-      result: value,
-      permanent: true
-    }
-
-    declaration.extensions[name] = [call]
-
-  }
-
-exports.aspect = aspect

package/samples/src/.replay/.suite/translate/.operation/.prepare/shortcuts/configuration.js

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

package/samples/src/.replay/.suite/translate/.operation/.prepare/shortcuts/http.js

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

package/samples/src/.replay/.suite/translate/.operation/.prepare/shortcuts/index.js

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

package/samples/src/.replay/.suite/translate/.operation/.prepare/shortcuts/state.js

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

package/samples/src/.replay/.suite/translate/.operation/.prepare/types/async.js

@@ -1,3 +0,0 @@
-'use strict'
-
-module.exports = (value) => async () => value

package/samples/src/.replay/.suite/translate/.operation/.prepare/types/cast.js

@@ -1,26 +0,0 @@
-'use strict'
-
-const { map } = require('@toa.io/generic')
-
-const types = {
-  Map: require('./map'),
-  Set: require('./set'),
-  sync: require('./sync'),
-  async: require('./async')
-}
-
-function cast (value) {
-  return map(value, replace)
-}
-
-function replace (key, value) {
-  const [name, type] = key.split(':')
-
-  if (!(type in types)) return
-
-  const typed = types[type](value)
-
-  return [name, typed]
-}
-
-exports.cast = cast

package/samples/src/.replay/.suite/translate/.operation/.prepare/types/index.js

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

package/samples/src/.replay/.suite/translate/.operation/.prepare/types/map.js

@@ -1,3 +0,0 @@
-'use strict'
-
-module.exports = (value) => new Map(Object.entries(value))

package/samples/src/.replay/.suite/translate/.operation/.prepare/types/set.js

@@ -1,3 +0,0 @@
-'use strict'
-
-module.exports = (value) => new Set(value)

package/samples/src/.replay/.suite/translate/.operation/.prepare/types/sync.js

@@ -1,3 +0,0 @@
-'use strict'
-
-module.exports = (value) => () => value

package/samples/src/.replay/.suite/translate/.operation/calls.js

@@ -1,49 +0,0 @@
-'use strict'
-
-const { defined } = require('@toa.io/generic')
-
-/**
- * @param {toa.samples.operation.Calls} calls
- * @returns {toa.sampling.request.context.Calls}
- */
-const calls = (calls) => {
-  /** @type {toa.sampling.request.context.Calls} */
-  const output = {}
-
-  for (let [endpoint, samples] of Object.entries(calls)) {
-    if (!Array.isArray(samples)) samples = [samples]
-
-    const target = []
-
-    for (const sample of samples) {
-      const translation = call(sample)
-
-      target.push(translation)
-    }
-
-    output[endpoint] = target
-  }
-
-  return output
-}
-
-/**
- * @param {toa.samples.operation.Call} call
- * @returns {toa.sampling.request.context.Call}
- */
-const call = (call) => {
-  let request
-  let reply
-
-  const sample = {}
-  const { input, query, output } = call
-
-  if (input !== undefined || query !== undefined) request = defined({ input, query })
-  if (output !== undefined) reply = { output }
-  if (request !== undefined) sample.request = request
-  if (reply !== undefined) sample.reply = reply
-
-  return sample
-}
-
-exports.calls = calls

package/samples/src/.replay/.suite/translate/.operation/cleanup.js

@@ -1,16 +0,0 @@
-'use strict'
-
-const { defined, empty } = require('@toa.io/generic')
-
-/**
- * @param {toa.sampling.request.Sample} sample
- */
-const cleanup = (sample) => {
-  for (const [key, value] of Object.entries(sample)) {
-    if (value === undefined || (typeof value === 'object' && empty(defined(value)))) {
-      delete sample[key]
-    }
-  }
-}
-
-exports.cleanup = cleanup

package/samples/src/.replay/.suite/translate/.operation/events.js

@@ -1,16 +0,0 @@
-'use strict'
-
-/**
- * @param {toa.samples.operations.Events} events
- * @returns {toa.sampling.request.Events}
- */
-const events = (events) => {
-  /** @type {toa.sampling.request.Events} */
-  const set = {}
-
-  for (const [label, sample] of Object.entries(events)) set[label] = { payload: sample }
-
-  return set
-}
-
-exports.events = events

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

@@ -1,11 +0,0 @@
-'use strict'
-
-const { calls } = require('./calls')
-const { events } = require('./events')
-const { cleanup } = require('./cleanup')
-const { prepare } = require('./prepare')
-
-exports.calls = calls
-exports.events = events
-exports.cleanup = cleanup
-exports.prepare = prepare

package/samples/src/.replay/.suite/translate/.operation/prepare.js

@@ -1,14 +0,0 @@
-'use strict'
-
-const { cast, expand } = require('./.prepare')
-
-/**
- * @param {toa.samples.Operation & Object} declaration
- */
-const prepare = (declaration) => {
-  expand(declaration)
-
-  if ('extensions' in declaration) cast(declaration.extensions)
-}
-
-exports.prepare = prepare

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

@@ -1,7 +0,0 @@
-'use strict'
-
-const { operation } = require('./operation')
-const { message } = require('./message')
-
-exports.operation = operation
-exports.message = message

package/samples/src/.replay/.suite/translate/message.js

@@ -1,26 +0,0 @@
-'use strict'
-
-const { schemas } = require('./schemas')
-const translate = require('./.message')
-
-const schema = schemas.schema('message')
-
-/**
- * @param {toa.samples.Message} declaration
- * @param {boolean} autonomous
- * @param {string} component
- * @returns {toa.sampling.Message}
- */
-const message = (declaration, autonomous, component) => {
-  schema.validate(declaration)
-
-  const payload = declaration.payload
-  const request = translate.request(declaration, autonomous)
-
-  /** @type {toa.sampling.messages.Sample} */
-  const sample = { authentic: true, component, request }
-
-  return { payload, sample }
-}
-
-exports.message = message

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

@@ -1,47 +0,0 @@
-'use strict'
-
-const transform = require('./.operation')
-const { schemas } = require('./schemas')
-
-const schema = schemas.schema('operation')
-
-/**
- * @param {toa.samples.Operation} declaration
- * @param {boolean} autonomous
- * @returns {toa.sampling.Request}
- */
-const operation = (declaration, autonomous) => {
-  transform.prepare(declaration)
-  schema.validate(declaration)
-
-  const { title, input, output, local, remote, current, next, extensions } = declaration
-  const reply = { output }
-  const storage = { current, next }
-
-  /** @type {toa.sampling.request.Context} */
-  let context = {}
-
-  /** @type {toa.sampling.request.Events} */
-  let events
-
-  if (local !== undefined) context.local = transform.calls(local)
-  if (remote !== undefined) context.remote = transform.calls(remote)
-  if (declaration.events !== undefined) events = transform.events(declaration.events)
-
-  const sample = /** @type {toa.sampling.request.Sample} */ {
-    authentic: true,
-    autonomous,
-    title,
-    reply,
-    context,
-    storage,
-    events,
-    extensions
-  }
-
-  transform.cleanup(sample)
-
-  return { input, sample }
-}
-
-exports.operation = operation

package/samples/src/.replay/.suite/translate/schemas/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { namespace } = require('@toa.io/schemas')
-
-const schemas = namespace(__dirname)
-
-exports.schemas = schemas

package/samples/src/.replay/.suite/translate/schemas/message.cos.yaml

@@ -1,10 +0,0 @@
-autonomous: boolean
-component: string
-title: string
-payload: object
-input: ~
-query: object
-request:
-  $ref: 'operation'
-  not:
-    required: [input]

package/samples/src/.replay/.suite/translate/schemas/operation.cos.yaml

@@ -1,23 +0,0 @@
-autonomous: boolean
-title: string
-input: ~
-output: ~
-local: &calls
-  ~+:
-    input: ~
-    query:
-      id: string
-      criteria: string
-      omit: number
-      limit: number
-    output: ~
-remote: *calls
-current+: object
-next: object
-events:
-  ~: object
-extensions:
-  ~:
-    - arguments: [~]
-      result: ~
-      permanent: boolean

package/samples/src/.replay/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { test } = require('./test')
-const stage = require('./stage')
-
-exports.test = test
-exports.stage = stage

package/samples/src/.replay/stage.js

@@ -1,60 +0,0 @@
-'use strict'
-
-const stage = require('@toa.io/userland/stage')
-const storage = require.resolve('@toa.io/storages.null')
-
-/**
- * @param {string[]} paths
- * @param {boolean} autonomous
- * @return {Promise<Record<string, toa.core.Component>>}
- */
-async function setup (paths, autonomous) {
-  if (!autonomous) return remotes(paths)
-  else return components(paths)
-}
-
-async function remotes (paths) {
-  await stage.composition(paths)
-
-  const remotes = {}
-
-  for (const path of paths) {
-    const id = await getId(path)
-
-    remotes[id] = await stage.remote(id)
-  }
-
-  return remotes
-}
-
-async function components (paths) {
-  const components = {}
-
-  process.env.TOA_SAMPLING_AUTONOMOUS = '1'
-
-  for (const path of paths) {
-    const id = await getId(path)
-
-    components[id] = await stage.component(path, { storage })
-  }
-
-  delete process.env.TOA_SAMPLING_AUTONOMOUS
-
-  return components
-}
-
-async function getId (path) {
-  const manifest = await stage.manifest(path)
-
-  return manifest.locator.id
-}
-
-/**
- * @return {Promise<void>}
- */
-async function shutdown () {
-  await stage.shutdown()
-}
-
-exports.setup = setup
-exports.shutdown = shutdown

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

@@ -1,23 +0,0 @@
-'use strict'
-
-const replay = require('./.suite')
-
-/**
- * @param {toa.samples.Suite} suite
- * @param {Record<string, toa.core.Component>} components
- * @returns {Function}
- */
-const suite = (suite, components) =>
-  async (test) => {
-    if ('operations' in suite) {
-      await test.test('Operations', replay.operations(suite.operations, components, suite.autonomous))
-    }
-
-    if ('messages' in suite) {
-      await test.test('Messages', replay.messages(suite.messages, suite.autonomous))
-    }
-
-    test.end()
-  }
-
-exports.suite = suite

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

@@ -1,19 +0,0 @@
-'use strict'
-
-const tap = require('tap')
-
-const replay = require('./suite')
-
-/**
- * @param {toa.samples.Suite} suite
- * @param {Record<string, toa.core.Component>} components
- * @param {object} options
- * @return {Promise<boolean>}
- */
-const test = async (suite, components, options) => {
-  const result = await tap.test(suite.title, options, replay.suite(suite, components))
-
-  return result === null ? false : result.ok
-}
-
-exports.test = test

package/samples/src/components.js

@@ -1,13 +0,0 @@
-'use strict'
-
-const { components: load } = require('./suite')
-const { replay } = require('./replay')
-
-/** @type {toa.samples.replay.components} */
-const components = async (paths, options = {}) => {
-  const suite = await load(paths, options)
-
-  return await replay(suite, paths, options.runner)
-}
-
-exports.components = components

package/samples/src/context.js

@@ -1,23 +0,0 @@
-'use strict'
-
-const norm = require('@toa.io/norm')
-
-const test = require('./components')
-const { context: load } = require('./suite')
-const { replay } = require('./replay')
-
-/** @type {toa.samples.replay.context} */
-const context = async (path, options = {}) => {
-  const context = await norm.context(path)
-  const suite = await load(path, options)
-  const paths = context.components.map((component) => component.path)
-
-  let ok = true
-
-  if (options.integration !== true) ok = await test.components(paths, options)
-  if (ok && options.autonomous !== true) ok = await replay(suite, paths, options.runner)
-
-  return ok
-}
-
-exports.context = context

package/samples/src/index.js

@@ -1,9 +0,0 @@
-'use strict'
-
-const { context } = require('./context')
-const { components } = require('./components')
-const { replay } = require('./replay')
-
-exports.context = context
-exports.components = components
-exports.replay = replay

package/samples/src/replay.js

@@ -1,16 +0,0 @@
-'use strict'
-
-const { test, stage } = require('./.replay')
-
-/** @type {toa.samples.replay.replay} */
-const replay = async (suite, paths, options = undefined) => {
-  const components = await stage.setup(paths, suite.autonomous)
-
-  const ok = await test(suite, components, options)
-
-  await stage.shutdown()
-
-  return ok
-}
-
-exports.replay = replay

package/samples/src/suite/.read/filter.js

@@ -1,15 +0,0 @@
-'use strict'
-
-/**
- * @template {{ title: string }} T
- * @param {T[]} samples
- * @param {string} expression
- * @returns {T}
- */
-function filter (samples, expression) {
-  const rx = new RegExp(expression)
-
-  return samples.filter((sample) => rx.test(sample.title))
-}
-
-exports.filter = filter

package/samples/src/suite/.read/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { operations } = require('./operations')
-const { messages } = require('./messages')
-
-exports.operations = operations
-exports.messages = messages