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

package/example/.env

@@ -0,0 +1,9 @@
+TOA_ENV=local
+TOA_AMQP_CONTEXT=eyIuIjpbImFtcXA6Ly9sb2NhbGhvc3QiXX0=
+TOA_AMQP_CONTEXT__USERNAME=developer
+TOA_AMQP_CONTEXT__PASSWORD=secret
+TOA_MONGODB_TEA_POTS=mongodb://localhost
+TOA_MONGODB_TEA_POTS_USERNAME=developer
+TOA_MONGODB_TEA_POTS_PASSWORD=secret
+TOA_ORIGINS_DEFAULT_WEB_DEV=http://localhost
+TOA_ORIGINS_DEFAULT_WEB__PROPERTIES=3gAA

package/example/components/echo/manifest.toa.yaml

@@ -11,3 +11,5 @@ operations:
 
 configuration:
   signal: quack
+
+state: ~

package/example/components/math.calculations/operations/increment.js

@@ -4,9 +4,7 @@ async function computation (input, context) {
   let value = input.value
 
   for (let i = 0; i < input.times; i++) {
-    const reply = await context.local.add({ input: { a: value, b: 1 } })
-
-    value = reply.output
+    value = await context.local.add({ input: { a: value, b: 1 } })
   }
 
   return value

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

@@ -1,6 +1,6 @@
 title: Should add numbers
 input:
-  $import: assets/ab.yaml
+  <assign: assets/ab.yaml
 output: 3
 ---
 title: Should add negative numbers

package/example/components/web/manifest.toa.yaml

@@ -5,4 +5,4 @@ operations:
     output: object
 
 origins:
-  dev: https://null
+  dev: http://api.example.com

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

@@ -1,14 +1,14 @@
 'use strict'
 
+const { Nope } = require('nopeable')
+
 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()
+  if (type !== 'application/json') return new Nope(0, 'Unsupported media type ' + type)
 
-  return { output }
+  return await response.json()
 }
 
 exports.computation = computation

package/example/context.toa.yaml

@@ -1,3 +1,10 @@
 name: examples
 packages: components/*
 registry: example
+
+amqp: amqp://localhost
+mongodb: mongodb://localhost
+
+origins:
+  default.web:
+    dev: http://localhost

package/example/stage/call.test.js

@@ -6,10 +6,7 @@ const stage = require('@toa.io/userland/stage')
 
 const root = resolve(__dirname, '../components')
 
-/** @type {toa.core.Component} */
 let echo
-
-/** @type {toa.core.Component} */
 let math
 
 beforeAll(async () => {
@@ -32,7 +29,7 @@ afterAll(async () => {
 it('should call endpoint', async () => {
   const reply = await echo.invoke('signal', {})
 
-  expect(reply.output).toStrictEqual('quack')
+  expect(reply).toStrictEqual('quack')
 })
 
 it('should throw on invalid input', async () => {

package/example/stage/events.test.js

@@ -6,7 +6,6 @@ const stage = require('@toa.io/userland/stage')
 const binding = stage.binding.binding
 const root = resolve(__dirname, '../components')
 
-/** @type {toa.core.Component} */
 let remote
 
 beforeAll(async () => {
@@ -27,7 +26,7 @@ afterAll(async () => {
 
 it('should receive event', async () => {
   const created = await remote.invoke('transit', { input: { material: 'glass' } })
-  const id = created.output.id
+  const id = created.id
   const payload = { pot: id }
   const message = { payload }
   const request = { query: { id } }
@@ -36,7 +35,7 @@ it('should receive event', async () => {
 
   const reply = await remote.invoke('observe', request)
 
-  expect(reply.output.booked).toStrictEqual(true)
+  expect(reply.booked).toStrictEqual(true)
 })
 
 it('should emit event', async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/userland",
-  "version": "0.20.0-dev.8",
+  "version": "0.20.0",
   "description": "Toa development kit",
   "homepage": "https://toa.io",
   "author": {
@@ -24,15 +24,15 @@
   "main": "src/index.js",
   "types": "types/index.d.ts",
   "dependencies": {
-    "@toa.io/boot": "0.20.0-dev.8",
-    "@toa.io/core": "0.20.0-dev.8",
-    "@toa.io/filesystem": "0.20.0-dev.8",
-    "@toa.io/generic": "0.20.0-dev.8",
-    "@toa.io/norm": "0.20.0-dev.8",
-    "@toa.io/schemas": "0.20.0-dev.8",
-    "@toa.io/storages.null": "0.20.0-dev.8",
-    "@toa.io/yaml": "0.20.0-dev.8",
+    "@toa.io/boot": "0.20.0",
+    "@toa.io/core": "0.20.0",
+    "@toa.io/filesystem": "0.20.0",
+    "@toa.io/generic": "0.20.0",
+    "@toa.io/norm": "0.20.0",
+    "@toa.io/schemas": "0.20.0",
+    "@toa.io/storages.null": "0.20.0",
+    "@toa.io/yaml": "0.20.0",
     "tap": "16.3.4"
   },
-  "gitHead": "d8c08ec7def70ad93de06541af497cce8c4c1b50"
+  "gitHead": "28fc4b45c224c3683acaaf0e4abd1eb04e07b408"
 }

package/samples/readme.md

@@ -33,7 +33,8 @@ and `name` must match corresponding component, therefore are optional.
 ## Message Samples
 
 Message Sample is an object containing receiver's input (`payload`) to be substituted and
-outcomes (`input` and `query`) to be verified. Message sample may contain the corresponding operation
+outcomes (`input` and `query`) to be verified. Message sample may contain the corresponding
+operation
 sample. See its [schema](./src/.replay/.suite/translate/schemas/message.cos.yaml).
 
 > Message samples are only supported at [context level](#autonomy).
@@ -52,7 +53,8 @@ label of the event receiver is consuming.
 
 #### Aspect Result Type Hints
 
-When using aspect calls, there might be situations where the returned values cannot be adequately described using YAML.
+When using aspect calls, there might be situations where the returned values cannot be adequately
+described using YAML.
 To address this issue, type hints can be used.
 
 ```yaml
@@ -62,7 +64,7 @@ state:
     bar: 2
 ```
 
-In the above code snippet, the `state` Aspect returns a `values` field of type Map.
+In the code snippet above, the `state` Aspect returns a `values` field of type Map.
 
 ```yaml
 state:
@@ -92,8 +94,6 @@ context (so as required extensions). See [examples](../example/samples).
 
 ## Replay
 
-> Replaying samples requires local deployment environment.
-
 ### CLI
 
 Samples may be replayed using [`toa replay`](/runtime/cli/readme.md#replay) command.

package/samples/test/replay.translate.message.test.js

@@ -108,16 +108,12 @@ describe('validation', () => {
     expect(check).toThrow('must be string')
   })
 
-  it.each(['input', 'query'])('should throw if request.%s is defined', async (key) => {
+  it.each([['input', 'query']])('should throw if request.%s is defined', async (key) => {
     expect.assertions(1)
 
     declaration[key] = { id: generate() }
     declaration.request = /** @type {toa.samples.Operation} */ { [key]: { id: generate() } }
 
-    try {
-      check()
-    } catch (exception) {
-      expect(exception).toMatchObject({ path: '/request' })
-    }
+    expect(() => check()).toThrow('/request')
   })
 })

package/samples/test/replay.translate.operation.test.js

@@ -35,7 +35,7 @@ describe('validation', () => {
   it('should not allow additional properties', () => {
     declaration.foo = generate()
 
-    expect(() => translate(declaration, true)).toThrow('must NOT have additional properties')
+    expect(() => translate(declaration, true)).toThrow('not expected')
   })
 })
 

package/stage/src/composition.js

@@ -6,9 +6,9 @@ const { state } = require('./state')
 const binding = require.resolve('./binding')
 
 /** @type {toa.stage.Composition} */
-const composition = async (paths) => {
-  /** @type {toa.boot.composition.Options} */
-  const options = { bindings: [binding] }
+const composition = async (paths, options) => {
+  options ??= { bindings: [binding] }
+
   const composition = await boot.composition(paths, options)
 
   await composition.connect()

package/stage/src/index.js

@@ -10,6 +10,7 @@ const binding = require('./binding')
 exports.manifest = manifest
 exports.component = component
 exports.composition = composition
+exports.compose = composition
 exports.remote = remote
 exports.shutdown = shutdown
 exports.binding = binding

package/stage/types/index.d.ts

@@ -2,28 +2,16 @@ 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, options?: _composition.Options) => Promise<_core.Component>
-  type Composition = (paths: string[]) => Promise<void>
-  type Remote = (id: string) => Promise<_core.Component>
-  type Shutdown = () => Promise<void>
+export function manifest (path: string): Promise<_norm.Component>
 
-  interface Stage {
-    manifest: toa.stage.Manifest
-    component: toa.stage.Component
-    composition: toa.stage.Composition
-    remote: toa.stage.Remote
-    shutdown: toa.stage.Shutdown
-  }
-}
+export function component (path: string): Promise<_core.Component>
 
-export type Stage = toa.stage.Stage
+export function composition (paths: string[], options?: _composition.Options): Promise<void>
 
-export const manifest: toa.stage.Manifest
-export const component: toa.stage.Component
-export const composition: toa.stage.Composition
-export const remote: toa.stage.Remote
-export const shutdown: toa.stage.Shutdown
+export function compose (paths: string[]): Promise<void>
+
+export function remote (id: string): Promise<_core.Component>
+
+export function shutdown (): Promise<void>
 
 export * as binding from './binding'