@toa.io/core 0.8.1-dev.1 → 0.20.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/core",
-  "version": "0.8.1-dev.1",
+  "version": "0.20.0-alpha.0",
   "description": "Toa Core",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -12,18 +12,22 @@
     "url": "https://github.com/toa-io/toa/issues"
   },
   "main": "src/index.js",
+  "types": "types/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "test": "echo \"Error: run tests from root\" && exit 1"
   },
+  "peerDependencies": {
+    "nopeable": "*"
+  },
   "dependencies": {
     "@rsql/parser": "1.2.4",
-    "@toa.io/console": "0.6.0",
-    "@toa.io/generic": "0.9.0-dev.1",
-    "@toa.io/yaml": "0.7.3-dev.1",
+    "@toa.io/console": "0.20.0-alpha.0",
+    "@toa.io/generic": "0.20.0-alpha.0",
+    "@toa.io/yaml": "0.20.0-alpha.0",
     "clone-deep": "4.0.1"
   },
-  "gitHead": "8b3fb929284365afb0d301756dfbcc549734dc99"
+  "gitHead": "d047190899218b5249901a01a2a4caec5b34cf09"
 }

package/src/call.js

@@ -1,6 +1,7 @@
 'use strict'
 
 const { Connector } = require('./connector')
+const { Nope } = require('nopeable')
 
 class Call extends Connector {
   #transmitter
@@ -18,11 +19,21 @@ class Call extends Connector {
   async invoke (request = {}) {
     this.#contract.fit(request)
 
-    const { exception, ...reply } = await this.#transmitter.request(request)
+    // avoid validation on the recipient's side
+    request.authentic = true
 
-    if (exception) throw exception
+    const reply = await this.#transmitter.request(request)
 
-    return reply
+    if (reply === null) return null
+    else {
+      if (reply.exception !== undefined)
+        throw reply.exception
+
+      if (reply.error !== undefined)
+        return new Nope(reply.error)
+
+      return reply.output
+    }
   }
 }
 

package/src/cascade.js

@@ -5,27 +5,31 @@ const { Connector } = require('./connector')
 
 class Cascade extends Connector {
   #bridges
+  #last
 
   constructor (bridges) {
     super()
 
     this.#bridges = bridges
+    this.#last = bridges[bridges.length - 1]
 
     this.depends(bridges)
   }
 
   async run (...args) {
-    const reply = {}
-
-    for (const bridge of this.#bridges) {
-      const partial = await bridge.execute(...args)
-
-      if (partial.error) return { error: partial.error }
-
-      merge(reply, partial)
-    }
-
-    return reply
+    // const reply = {}
+    //
+    // for (const bridge of this.#bridges) {
+    //   const partial = await bridge.execute(...args)
+    //
+    //   if (partial.error) return { error: partial.error }
+    //
+    //   merge(reply, partial)
+    // }
+    //
+    // return reply
+
+    return this.#last.execute(...args)
   }
 }
 

package/src/contract/request.js

@@ -13,11 +13,10 @@ class Request extends Conditions {
    * @returns {toa.schema.JSON}
    */
   static schema (definition) {
-    const schema = { type: 'object', properties: {}, additionalProperties: true }
+    const schema = { type: 'object', properties: { authentic: { type: 'boolean' } }, additionalProperties: true }
     const required = []
 
     if (definition.input !== undefined) {
-      definition.input.additionalProperties = false
       schema.properties.input = definition.input
       required.push('input')
     } else {

package/src/contract/schemas/error.yaml

@@ -1,7 +1,9 @@
+type: object
 properties:
   code:
-    type: integer
-    minimum: 0
+    anyOf:
+      - type: integer
+      - type: string
   message:
     type: string
-required: [code, message]
+required: [code]

package/src/contract/schemas/query.yaml

@@ -1,3 +1,4 @@
+type: object
 properties:
   id:
     $ref: https://schemas.toa.io/0.0.0/definitions#/definitions/id

package/src/discovery.js

@@ -30,7 +30,7 @@ class Discovery extends Connector {
     const warning = () => console.warn(`Waiting for lookup response from '${id}'...`)
     const timeout = setTimeout(warning, TIMEOUT)
 
-    const { output } = await this.#lookups[id].invoke()
+    const output = await this.#lookups[id].invoke()
 
     console.debug(`Lookup response from '${id}' received`)
     clearTimeout(timeout)

package/src/exceptions.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { swap } = require('@toa.io/generic')
+
 const codes = {
   System: 0,
   NotImplemented: 10,
@@ -93,4 +95,5 @@ for (const [name, code] of Object.entries(codes)) {
 }
 
 exports.codes = codes
+exports.names = swap(codes)
 // #endregion

package/src/observation.js

@@ -14,6 +14,11 @@ class Observation extends Operation {
     store.scope = scope
     store.state = state
   }
+
+  async run (store) {
+    if (store.scope === null) store.reply = null
+    else await super.run(store)
+  }
 }
 
 exports.Observation = Observation

package/src/operation.js

@@ -7,17 +7,17 @@ class Operation extends Connector {
   scope
 
   #cascade
-  #contract
+  #contracts
   #query
   #scope
 
-  constructor (cascade, scope, contract, query, definition) {
+  constructor (cascade, scope, contracts, query, definition) {
     super()
 
     this.scope = scope
 
     this.#cascade = cascade
-    this.#contract = contract
+    this.#contracts = contracts
     this.#query = query
     this.#scope = definition.scope
 
@@ -26,7 +26,8 @@ class Operation extends Connector {
 
   async invoke (request) {
     try {
-      if (request.query) request.query = this.#query.parse(request.query)
+      if (request.authentic !== true) this.#contracts.request.fit(request)
+      if ('query' in request) request.query = this.#query.parse(request.query)
 
       const store = { request }
 
@@ -52,7 +53,7 @@ class Operation extends Connector {
     const { request, state } = store
     const reply = await this.#cascade.run(request.input, state) || {}
 
-    this.#contract.fit(reply)
+    this.#contracts.reply.fit(reply)
 
     store.reply = reply
   }

package/src/receiver.js

@@ -19,29 +19,29 @@ class Receiver extends Connector {
   /** @type {toa.core.Component} */
   #local
 
-  /** @type {toa.core.bridges.Event} */
+  /** @type {toa.core.bridges.Receiver} */
   #bridge
 
   /**
    *
    * @param {toa.norm.component.Receiver} definition
    * @param {toa.core.Component} local
-   * @param {toa.core.bridges.Event} bridge
+   * @param {toa.core.bridges.Receiver} bridge
    */
   constructor (definition, local, bridge) {
     super()
 
-    const { conditioned, adaptive, transition } = definition
+    const { conditioned, adaptive, operation } = definition
 
     this.#conditioned = conditioned
     this.#adaptive = adaptive
-    this.#endpoint = transition
+    this.#endpoint = operation
 
     this.#local = local
     this.#bridge = bridge
 
     this.depends(local)
-    this.depends(bridge)
+    if (bridge !== undefined) this.depends(bridge)
   }
 
   /** @hot */
@@ -52,13 +52,13 @@ class Receiver extends Connector {
 
     const request = await this.#request(payload)
 
-    if (extensions) add(request, extensions)
+    add(request, extensions)
 
     await this.#local.invoke(this.#endpoint, request)
   }
 
   async #request (payload) {
-    return this.#adaptive ? await this.#bridge.request(payload) : payload
+    return this.#adaptive ? await this.#bridge.request(payload) : { input: payload }
   }
 }
 

package/src/state.js

@@ -28,9 +28,9 @@ class State {
   }
 
   init (id) {
-    if (this.#initialized === true && id === undefined) {
-      throw new StateInitializationException('Cannot initialize entity which is initialized. Use request.query.id to access.')
-    }
+    // if (this.#initialized === true && id === undefined) {
+    //   throw new StateInitializationException('Cannot initialize entity which is initialized. Use request.query.id to access.')
+    // }
 
     return this.#entity.init(id)
   }
@@ -41,10 +41,10 @@ class State {
     if (record === null) {
       if (this.#initialized && query.id !== undefined && query.version === undefined) return this.init(query.id)
       else if (query.version !== undefined) throw new StatePreconditionException()
-      else throw new StateNotFoundException()
     }
 
-    return this.#entity.object(record)
+    if (record === null) return null
+    else return this.#entity.object(record)
   }
 
   async objects (query) {
@@ -94,7 +94,7 @@ class State {
       else throw new StateNotFoundException()
     }
 
-    // TODO: same as above
+    // same as above
     await this.#emission.emit({ changeset, state: result })
   }
 }

package/src/transition.js

@@ -3,7 +3,7 @@
 const { retry } = require('@toa.io/generic')
 
 const { Operation } = require('./operation')
-const { StateConcurrencyException } = require('./exceptions')
+const { StateConcurrencyException, StateNotFoundException } = require('./exceptions')
 
 class Transition extends Operation {
   #concurrency
@@ -22,6 +22,9 @@ class Transition extends Operation {
     const { request } = store
 
     store.scope = request.query ? await this.query(request.query) : this.scope.init()
+
+    if (store.scope === null) throw new StateNotFoundException()
+
     store.state = store.scope.get()
   }
 

package/test/call.fixtures.js

@@ -4,7 +4,8 @@ const { generate } = require('randomstring')
 
 // noinspection JSCheckFunctionSignatures
 const transmission = {
-  request: jest.fn((request) => ({ [request.invalid ? 'exception' : generate()]: generate() }))
+  request: jest.fn((request) => ({ [request.invalid ? 'exception' : 'output']: generate() })),
+  link: jest.fn()
 }
 
 const contract = {

package/test/call.test.js

@@ -1,11 +1,7 @@
 'use strict'
 
-const { Call } = require('../src/call')
 const fixtures = require('./call.fixtures')
-
-jest.mock('../src/connector')
-
-const { Connector } = require('../src/connector')
+const { Call } = require('../src/call')
 
 let call
 
@@ -16,9 +12,7 @@ beforeEach(() => {
 })
 
 it('should depend on transmission', () => {
-  expect(call).toBeInstanceOf(Connector)
-  expect(call).toBe(Connector.mock.instances[0])
-  expect(Connector.mock.instances[0].depends).toHaveBeenCalledWith(fixtures.transmission)
+  expect(fixtures.transmission.link).toHaveBeenLastCalledWith(call)
 })
 
 it('should call transmission', async () => {
@@ -42,7 +36,7 @@ it('should return reply', async () => {
 
   const reply = await call.invoke(request)
 
-  expect(reply).toStrictEqual(fixtures.transmission.request.mock.results[0].value)
+  expect(reply).toStrictEqual(fixtures.transmission.request.mock.results[0].value.output)
 })
 
 it('should throw received exceptions', async () => {

package/test/contract/contract.fixtures.js

@@ -20,7 +20,8 @@ const schemas = {
     type: 'object',
     properties: {
       input: { type: 'null' },
-      query: load.sync(resolve(__dirname, '../../src/contract/schemas/query.yaml'))
+      query: load.sync(resolve(__dirname, '../../src/contract/schemas/query.yaml')),
+      authentic: { type: 'boolean' }
     },
     additionalProperties: true
   }

package/test/receiver.fixtures.js

@@ -3,7 +3,7 @@
 const { generate } = require('randomstring')
 
 const definition = /** @type {toa.norm.component.Receiver} */ {
-  transition: generate(),
+  operation: generate(),
   conditioned: false,
   adaptive: false
 }

package/test/receiver.test.js

@@ -34,7 +34,7 @@ it('should apply', async () => {
 
   await receiver.receive({ payload })
 
-  expect(fixtures.local.invoke).toHaveBeenCalledWith(definition.transition, payload)
+  expect(fixtures.local.invoke).toHaveBeenCalledWith(definition.operation, { input: payload })
 })
 
 it.each([[false], [true]])('should pass UI extensions (adaptive: %s)', async (adaptive) => {
@@ -49,7 +49,7 @@ it.each([[false], [true]])('should pass UI extensions (adaptive: %s)', async (ad
 
   await receiver.receive(message)
 
-  const request = adaptive ? await fixtures.bridge.request.mock.results[0].value : payload
+  const request = adaptive ? await fixtures.bridge.request.mock.results[0].value : { input: payload }
   const expected = merge(clone(request), extension)
 
   const argument = fixtures.local.invoke.mock.calls[0][1]
@@ -68,7 +68,7 @@ describe('conditioned', () => {
     await receiver.receive({ payload })
 
     expect(fixtures.bridge.condition).toHaveBeenCalledWith(payload)
-    expect(fixtures.local.invoke).toHaveBeenCalledWith(definition.transition, payload)
+    expect(fixtures.local.invoke).toHaveBeenCalledWith(definition.operation, { input: payload })
   })
 
   it('should not apply if condition is false', async () => {
@@ -90,6 +90,6 @@ describe('adaptive', () => {
     await receiver.receive({ payload })
 
     expect(fixtures.local.invoke)
-      .toHaveBeenCalledWith(definition.transition, await fixtures.bridge.request.mock.results[0].value)
+      .toHaveBeenCalledWith(definition.operation, await fixtures.bridge.request.mock.results[0].value)
   })
 })

package/types/bindings.d.ts

@@ -7,29 +7,29 @@ declare namespace toa.core.bindings {
   }
 
   interface Consumer extends _core.Connector {
-    request(request: Request): Promise<_core.Reply>
+    request (request: Request): Promise<_core.Reply>
   }
 
   interface Emitter extends _core.Connector {
-    emit(message: _core.Message): Promise<void>
+    emit (message: _core.Message): Promise<void>
   }
 
-  interface Broadcast extends _core.Connector {
-    transmit(label: string, payload: object): Promise<void>
+  interface Broadcast<L> extends _core.Connector {
+    transmit<T> (label: L, payload: T): Promise<void>
 
-    receive(label: string, callback: (payload: object) => Promise<void>): Promise<void>
+    receive<T> (label: L, callback: (payload: T) => void | Promise<void>): Promise<void>
   }
 
   interface Factory {
-    producer?(locator: _core.Locator, endpoints: Array<string>, producer: _core.Component): _core.Connector
+    producer? (locator: _core.Locator, endpoints: Array<string>, producer: _core.Component): _core.Connector
 
-    consumer?(locator: _core.Locator, endpoint: string): Consumer
+    consumer? (locator: _core.Locator, endpoint: string): Consumer
 
-    emitter?(locator: _core.Locator, label: string): Emitter
+    emitter? (locator: _core.Locator, label: string): Emitter
 
-    receiver?(locator: _core.Locator, label: string, group: string, receiver: _core.Receiver): _core.Connector
+    receiver? (locator: _core.Locator, label: string, group: string, receiver: _core.Receiver): _core.Connector
 
-    broadcast?(name: string, group?: string): Broadcast
+    broadcast? (name: string, group?: string): Broadcast
   }
 
 }
@@ -37,3 +37,4 @@ declare namespace toa.core.bindings {
 export type Emitter = toa.core.bindings.Emitter
 export type Factory = toa.core.bindings.Factory
 export type Properties = toa.core.bindings.Properties
+export type Broadcast<L> = toa.core.bindings.Broadcast<L>

package/types/component.d.ts

@@ -0,0 +1,10 @@
+import { Connector } from './connector'
+import { Locator } from './locator'
+import { Request } from './request'
+import { type Nopeable } from 'nopeable'
+
+export interface Component extends Connector {
+  locator: Locator
+
+  invoke<T> (endpoint: string, request: Request): Promise<T>
+}

package/types/connector.d.ts

@@ -1,24 +1,18 @@
-declare namespace toa.core {
+export class Connector {
+  public id: string
+  public connected: boolean
 
-  interface Connector {
-    id: string
-    connected: boolean
+  public connect (): Promise<void>
 
-    depends(connector: Connector): Connector
+  public disconnect (interrupt?: boolean): Promise<void>
 
-    link(connector: Connector): void
+  public depends (connector: Connector | Connector[]): Connector
 
-    connect(): Promise<void>
+  link (connector: Connector): void
 
-    disconnect(interrupt?: boolean): Promise<void>
+  protected open (): Promise<void> | void
 
-    open(): Promise<void>
-
-    close(): Promise<void>
-
-    dispose(): Promise<void>
-  }
+  protected close (): Promise<void> | void
 
+  protected dispose (): Promise<void> | void
 }
-
-export type Connector = toa.core.Connector

package/types/exception.d.ts

@@ -1,10 +1,4 @@
-declare namespace toa.core {
-
-  interface Exception {
-    code: number
-    message: string
-  }
-
+export interface Exception {
+  code: number
+  message: string
 }
-
-export type Exception = toa.core.Exception

package/types/extensions.d.ts

@@ -7,21 +7,21 @@ import * as _bindings from './bindings'
 declare namespace toa.core.extensions {
 
   interface Factory {
-    tenant?(locator: _core.Locator, declaration: object): _core.Connector
+    tenant? (locator: _core.Locator, manifest: object): _core.Connector
 
-    aspect?(locator: _core.Locator, declaration: object): Aspect | Aspect[]
+    aspect? (locator: _core.Locator, manifest: object | null): Aspect | Aspect[]
 
-    service?(name?: string): _core.Connector
+    service? (name?: string): _core.Connector | null
 
-    component?(component: _component.Component): _component.Component
+    component? (component: _component.Component): _component.Component
 
-    context?(context: _context.Context): _context.Context
+    context? (context: _context.Context): _context.Context
 
-    storage?(storage: _storages.Storage): _storages.Storage
+    storage? (storage: _storages.Storage): _storages.Storage
 
-    emitter?(emitter: _bindings.Emitter, label: string): _bindings.Emitter
+    emitter? (emitter: _bindings.Emitter, label: string): _bindings.Emitter
 
-    receiver?(receiver: _core.Receiver, locator: _core.Locator): _core.Receiver
+    receiver? (receiver: _core.Receiver, locator: _core.Locator): _core.Receiver
   }
 
   interface Aspect extends _core.Connector {

package/types/index.d.ts

@@ -2,6 +2,7 @@ export * as bindings from './bindings'
 export * as extensions from './extensions'
 export * as storages from './storages'
 export * as bridges from './bridges'
+export * as operations from './operations'
 
 export { Component } from './component'
 export { Connector } from './connector'
@@ -10,5 +11,4 @@ export { Exception } from './exception'
 export { Locator } from './locator'
 export { Receiver } from './receiver'
 export { Message } from './message'
-export { Reply } from './reply'
-export { Request, Query } from './request'
+export { Request, Query, Reply } from './request'

package/types/locator.d.ts

@@ -1,16 +1,12 @@
-declare namespace toa.core {
+export class Locator {
+  public readonly name: string
+  public readonly namespace: string
 
-    interface Locator {
-        name: string
-        namespace: string
+  public readonly id: string
+  public readonly label: string
+  public readonly uppercase: string
 
-        id: string
-        label: string
-        uppercase: string
-
-        hostname(type?: string): string
-    }
+  constructor (name: string, namespace?: string)
 
+  hostname (type?: string): string
 }
-
-export type Locator = toa.core.Locator

package/types/operations.d.ts

@@ -0,0 +1,2 @@
+export type type = 'transition' | 'observation' | 'assignment' | 'computation' | 'effect'
+export type scope = 'object' | 'objects' | 'changeset'

package/types/reflection.d.ts

@@ -1,16 +1,14 @@
-// noinspection ES6UnusedImports
-
-import { Connector } from './connector'
+import * as _core from './connector'
 
 declare namespace toa.core {
 
-    namespace reflection {
-        type Source = () => Promise<any>
-    }
+  namespace reflection {
+    type Source = () => Promise<any>
+  }
 
-    interface Reflection<T> extends Connector {
-        value: T
-    }
+  interface Reflection<T> extends _core.Connector {
+    value: T
+  }
 }
 
 export type Source = toa.core.reflection.Source

package/types/request.d.ts

@@ -1,25 +1,23 @@
-declare namespace toa.core {
+import { Exception } from './exception'
 
-  namespace request {
-
-    interface Query {
-      id?: string
-      criteria?: string
-      omit?: number
-      limit?: number
-      sort?: Array<string>
-      projection?: Array<string>
-      version?: number
-    }
-
-  }
-
-  type Request = {
-    input?: any
-    query?: request.Query
-  }
+export interface Query {
+  id?: string
+  criteria?: string
+  omit?: number
+  limit?: number
+  sort?: Array<string>
+  projection?: Array<string>
+  version?: number
+}
 
+export interface Request {
+  input?: any
+  query?: Query
+  authentic?: boolean
 }
 
-export type Request = toa.core.Request
-export type Query = toa.core.request.Query
+export interface Reply {
+  output?: any
+  error?: object
+  exception?: Exception
+}

package/test/cascade.fixtures.js

@@ -1,11 +0,0 @@
-'use strict'
-
-const bridges = ['a', 'b', 'c'].map((index) => ({
-  execute: jest.fn((request) => {
-    if (request?.error === index) return { error: index }
-
-    return { output: { [index]: true } }
-  })
-}))
-
-exports.bridges = bridges

package/test/cascade.test.js

@@ -1,42 +0,0 @@
-'use strict'
-
-jest.mock('../src/connector')
-
-const clone = require('clone-deep')
-
-const { Connector } = require('../src/connector')
-const { Cascade } = require('../src/cascade')
-const fixtures = require('./cascade.fixtures')
-
-let cascade
-
-beforeEach(() => {
-  jest.clearAllMocks()
-
-  cascade = new Cascade(clone(fixtures.bridges))
-})
-
-it('should depend on bridges', () => {
-  expect(cascade).toBeInstanceOf(Connector)
-  expect(Connector.mock.instances[0].depends).toHaveBeenCalledWith(fixtures.bridges)
-})
-
-it('should call bridges.execute', async () => {
-  const args = [1, 2]
-  await cascade.run(...args)
-
-  for (const bridge of fixtures.bridges) expect(bridge.execute).toHaveBeenCalledWith(...args)
-})
-
-it('should merge output', async () => {
-  const reply = await cascade.run()
-
-  expect(reply).toStrictEqual({ output: { a: true, b: true, c: true } })
-})
-
-it('should interrupt on error', async () => {
-  const reply = await cascade.run({ error: 'b' })
-
-  expect(reply).toStrictEqual({ error: 'b' })
-  expect(fixtures.bridges[2].execute).not.toHaveBeenCalled()
-})

package/types/component.ts

@@ -1,16 +0,0 @@
-import * as _connector from './connector'
-import * as _locator from './locator'
-import * as _request from './request'
-import * as _reply from './reply'
-
-declare namespace toa.core {
-
-  interface Component extends _connector.Connector {
-    locator: _locator.Locator
-
-    invoke(endpoint: string, request: _request.Request): Promise<_reply.Reply>
-  }
-
-}
-
-export type Component = toa.core.Component

package/types/reply.d.ts

@@ -1,15 +0,0 @@
-// noinspection ES6UnusedImports
-
-import { Exception } from './exception'
-
-declare namespace toa.core {
-
-    interface Reply {
-        output?: Object
-        error?: Object
-        exception?: Exception
-    }
-
-}
-
-export type Reply = toa.core.Reply