@toa.io/userland 1.0.0-alpha.6 → 1.0.0-alpha.8

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

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

@@ -1,40 +0,0 @@
-'use strict'
-
-const { join, basename } = require('node:path')
-const { file: { glob } } = require('@toa.io/filesystem')
-const yaml = require('@toa.io/yaml')
-
-const { filter } = require('./filter')
-
-/**
- * @param {string} path
- * @param {toa.samples.suite.Options} options
- * @returns {Promise<toa.samples.messages.Set>}
- */
-const messages = async (path, options) => {
-  /** @type {toa.samples.messages.Set} */
-  const messages = {}
-
-  const pattern = join(path, DIRECTORY, PATTERN)
-  const files = await glob(pattern)
-
-  for (const file of files) {
-    const label = basename(file, EXTENSION)
-
-    let samples = /** @type {toa.samples.Message[]} */ await yaml.load.all(file)
-
-    if (options.id !== undefined) samples.forEach((sample) => (sample.component = options.id))
-    if (options.component !== undefined) samples = samples.filter((sample) => sample.component === options.component)
-    if (options.title !== undefined) samples = filter(samples, options.title)
-
-    messages[label] = samples
-  }
-
-  return messages
-}
-
-const DIRECTORY = 'samples/messages'
-const EXTENSION = '.yaml'
-const PATTERN = '*' + EXTENSION
-
-exports.messages = messages

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

@@ -1,51 +0,0 @@
-'use strict'
-
-const { basename, join } = require('node:path')
-const { file: { glob } } = require('@toa.io/filesystem')
-const { merge } = require('@toa.io/generic')
-const yaml = require('@toa.io/yaml')
-
-const { parse } = require('./parse')
-const { filter } = require('./filter')
-
-/**
- * @param {string} path
- * @param {toa.samples.suite.Options} options
- * @returns {Promise<toa.samples.suite.Operations>}
- */
-const operations = async (path, options) => {
-  /** @type {toa.samples.suite.Operations} */
-  const operations = {}
-
-  const pattern = join(path, DIRECTORY, PATTERN)
-  const files = await glob(pattern)
-
-  for (const file of files) {
-    const name = basename(file, EXTENSION)
-    const [component, operation] = parse(name, options.id)
-
-    if (options.component !== undefined && component !== options.component) continue
-    if (options.operation !== undefined && operation !== options.operation) continue
-
-    let samples = /** @type {toa.samples.Operation[]} */ await yaml.load.all(file)
-
-    if (options.title !== undefined) samples = filter(samples, options.title)
-    if (samples.length === 0) continue
-
-    if (operations[component] === undefined) operations[component] = {}
-
-    /** @type {toa.samples.operations.Set} */
-    const set = operations[component]
-
-    if (set[operation] === undefined) set[operation] = samples
-    else set[operation] = /** @type {toa.samples.Operation[]} */ merge(set[operation], samples)
-  }
-
-  return operations
-}
-
-const DIRECTORY = 'samples'
-const EXTENSION = '.yaml'
-const PATTERN = '*' + EXTENSION
-
-exports.operations = operations

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

@@ -1,20 +0,0 @@
-'use strict'
-
-/**
- * @param {string} name
- * @param {string} [def]
- * @returns {[string, string]}
- */
-const parse = (name, def) => {
-  const parts = name.split('.')
-  const [endpoint, component, namespace] = parts.reverse()
-  const id = namespace === undefined ? def : namespace + '.' + component
-
-  if (id !== undefined && def !== undefined && id !== def) {
-    throw new Error(`Component id mismatch: '${id}' expected, '${component}' given`)
-  }
-
-  return [id, endpoint]
-}
-
-exports.parse = parse