@toa.io/core 1.0.0-alpha.32 → 1.0.0-alpha.321

package/src/operation.js

@@ -1,69 +0,0 @@
-'use strict'
-
-const { Connector } = require('./connector')
-const { SystemException } = require('./exceptions')
-
-class Operation extends Connector {
-  scope
-
-  #cascade
-  #contracts
-  #query
-  #scope
-
-  constructor (cascade, scope, contracts, query, definition) {
-    super()
-
-    this.scope = scope
-
-    this.#cascade = cascade
-    this.#contracts = contracts
-    this.#query = query
-    this.#scope = definition.scope
-
-    this.depends(cascade)
-  }
-
-  async invoke (request) {
-    try {
-      if (request.authentic !== true) this.#contracts.request.fit(request)
-      if ('query' in request) request.query = this.#query.parse(request.query)
-
-      const store = { request }
-
-      return await this.process(store)
-    } catch (e) {
-      const exception = e instanceof Error ? new SystemException(e) : e
-
-      return { exception }
-    }
-  }
-
-  async process (store) {
-    await this.acquire(store)
-    await this.run(store)
-    await this.commit(store)
-
-    return store.reply
-  }
-
-  async acquire () {}
-
-  async run (store) {
-    const { request, state } = store
-    // noinspection UnnecessaryLocalVariableJS
-    const reply = await this.#cascade.run(request.input, state) || {}
-
-    // this.#contracts.reply.fit(reply)
-
-    store.reply = reply
-  }
-
-  async commit () {}
-
-  async query (query) {
-    return this.scope[this.#scope](query)
-  }
-}
-
-exports.Operation = Operation

package/src/query/criteria.js

@@ -1,41 +0,0 @@
-'use strict'
-
-const { parse } = require('@rsql/parser')
-const { QuerySyntaxException } = require('../exceptions')
-
-const criteria = (criteria, properties) => {
-  let ast
-
-  try {
-    ast = parse(criteria)
-  } catch (e) {
-    throw new QuerySyntaxException(e.message)
-  }
-
-  if (properties !== undefined) coerce(ast, properties)
-
-  return ast
-}
-
-const coerce = (node, properties) => {
-  if (node.type === 'COMPARISON' && node.left?.type === 'SELECTOR' && node.right?.type === 'VALUE') {
-    const property = properties[node.left.selector]
-
-    if (property === undefined) {
-      throw new QuerySyntaxException(`Criteria selector '${node.left.selector}' is not defined`)
-    }
-
-    if (COERCE[property.type] !== undefined) { node.right.value = COERCE[property.type](node.right.value) }
-  } else {
-    if (node.left !== undefined) coerce(node.left, properties)
-    if (node.right !== undefined) coerce(node.right, properties)
-  }
-}
-
-const COERCE = {
-  number: Number.parseFloat,
-  integer: Number.parseInt,
-  boolean: (value) => value === 'true'
-}
-
-exports.criteria = criteria

package/src/query/options.js

@@ -1,40 +0,0 @@
-'use strict'
-
-const { QuerySyntaxException } = require('../exceptions')
-
-const options = (options, properties, system) => {
-  if (options.sort !== undefined) options.sort = sort(options.sort, properties)
-
-  if (options.projection !== undefined) projection(options.projection, properties)
-
-  return options
-}
-
-const sort = (sort, properties) => {
-  const result = []
-
-  for (const sorting of sort) {
-    const [property, direction] = sorting.split(':')
-
-    if (properties[property] === undefined) {
-      throw new QuerySyntaxException(`Sort property '${property}' is not defined`)
-    }
-
-    result.push([property, direction || 'asc'])
-  }
-
-  return result
-}
-
-const projection = (projection, properties) => {
-  for (const property of projection) {
-    if (properties[property] === undefined) {
-      throw new QuerySyntaxException(`Projection property '${property}' is not defined`)
-    }
-  }
-
-  if (projection.includes('_version') === false)
-    projection.push('_version')
-}
-
-exports.options = options

package/src/query.js

@@ -1,41 +0,0 @@
-'use strict'
-
-const { empty } = require('@toa.io/generic')
-const parse = { ...require('./query/criteria'), ...require('./query/options') }
-
-class Query {
-  #properties
-  #system
-
-  constructor (properties) {
-    this.#properties = properties
-    this.#system = Object.keys(properties).filter((key) => properties[key].system === true)
-  }
-
-  /**
-   * @param {toa.core.request.Query} query
-   * @returns {toa.core.storages.Query}
-   */
-  parse (query) {
-    /** @type {toa.core.storages.Query} */
-    const result = {}
-    const { id, version, criteria, ...rest } = query
-
-    const options = this.#options(rest)
-
-    if (id !== undefined) result.id = id
-    if (version !== undefined) result.version = version
-    if (criteria !== undefined) result.criteria = parse.criteria(criteria, this.#properties)
-    if (options !== undefined) result.options = options
-
-    return result
-  }
-
-  #options (options) {
-    if (empty(options)) return
-
-    return parse.options(options, this.#properties, this.#system)
-  }
-}
-
-exports.Query = Query

package/src/receiver.js

@@ -1,61 +0,0 @@
-'use strict'
-
-const { add } = require('@toa.io/generic')
-const { Connector } = require('./connector')
-
-/**
- * @implements {toa.core.Receiver}
- */
-class Receiver extends Connector {
-  /** @type {boolean} */
-  #conditioned
-
-  /** @type {boolean} */
-  #adaptive
-
-  /** @type {string} */
-  #endpoint
-
-  /** @type {unknown[]} */
-  #arguments
-
-  #local
-
-  #bridge
-
-  constructor (definition, local, bridge) {
-    super()
-
-    const { conditioned, adaptive, operation } = definition
-
-    this.#conditioned = conditioned
-    this.#adaptive = adaptive
-    this.#endpoint = operation
-    this.#arguments = definition.arguments
-
-    this.#local = local
-    this.#bridge = bridge
-
-    this.depends(local)
-    if (bridge !== undefined) this.depends(bridge)
-  }
-
-  /** @hot */
-  async receive (message) {
-    const { payload, ...extensions } = message
-
-    if (this.#conditioned && await this.#bridge.condition(payload) === false) return
-
-    const request = await this.#request(payload)
-
-    add(request, extensions)
-
-    await this.#local.invoke(this.#endpoint, request)
-  }
-
-  async #request (payload) {
-    return this.#adaptive ? await this.#bridge.request(payload, ...(this.#arguments ?? [])) : { input: payload }
-  }
-}
-
-exports.Receiver = Receiver

package/src/reflection.js

@@ -1,28 +0,0 @@
-'use strict'
-
-const { Connector } = require('./connector')
-
-/**
- * @implements {toa.core.Reflection}
- */
-class Reflection extends Connector {
-  /** @type {toa.core.reflection.Source} */
-  #source
-
-  value
-
-  /**
-   * @param {toa.core.reflection.Source} source
-   */
-  constructor (source) {
-    super()
-
-    this.#source = source
-  }
-
-  async open () {
-    this.value = await this.#source()
-  }
-}
-
-exports.Reflection = Reflection

package/src/remote.js

@@ -1,17 +0,0 @@
-'use strict'
-
-const { console } = require('@toa.io/console')
-
-const { Component } = require('./component')
-
-class Remote extends Component {
-  async open () {
-    console.info(`Remote '${this.locator.id}' connected`)
-  }
-
-  async dispose () {
-    console.info(`Remote '${this.locator.id}' disconnected`)
-  }
-}
-
-exports.Remote = Remote

package/src/state.js

@@ -1,99 +0,0 @@
-'use strict'
-
-const { empty } = require('@toa.io/generic')
-
-const {
-  StatePreconditionException,
-  StateNotFoundException
-} = require('./exceptions')
-
-class State {
-  #associated
-  #storage
-  #entity
-  #emission
-
-  constructor (storage, entity, emission, associated) {
-    this.#storage = storage
-    this.#entity = entity
-    this.#emission = emission
-    this.#associated = associated === true
-  }
-
-  init (id) {
-    return this.#entity.init(id)
-  }
-
-  async object (query) {
-    const record = await this.#storage.get(query)
-
-    if (record === null) {
-      if (this.#associated && query.id !== undefined && query.version === undefined) {
-        return this.init(query.id)
-      } else if (query.version !== undefined) throw new StatePreconditionException()
-    }
-
-    if (record === null) {
-      return null
-    } else {
-      return this.#entity.object(record)
-    }
-  }
-
-  async objects (query) {
-    const recordset = await this.#storage.find(query)
-
-    return this.#entity.objects(recordset)
-  }
-
-  changeset (query) {
-    return this.#entity.changeset(query)
-  }
-
-  none () {
-    return null
-  }
-
-  async commit (state) {
-    const event = state.event()
-
-    let ok = true
-
-    if (!empty(event.changeset)) {
-      const object = state.get()
-
-      ok = await this.#storage.store(object)
-
-      // #20
-      if (ok === true) {
-        await this.#emission.emit(event)
-      }
-    }
-
-    return ok
-  }
-
-  async apply (state) {
-    const changeset = state.export()
-
-    const result = await this.#storage.upsert(state.query, changeset)
-
-    if (result === null) {
-      if (state.query.version !== undefined) {
-        throw new StatePreconditionException()
-      } else {
-        throw new StateNotFoundException()
-      }
-    } else {
-      // same as above
-      await this.#emission.emit({
-        changeset,
-        state: result
-      })
-    }
-
-    return result
-  }
-}
-
-exports.State = State

package/src/transition.js

@@ -1,67 +0,0 @@
-'use strict'
-
-const { retry } = require('@toa.io/generic')
-
-const { Operation } = require('./operation')
-const {
-  StateConcurrencyException,
-  StateNotFoundException
-} = require('./exceptions')
-
-class Transition extends Operation {
-  #concurrency
-
-  constructor (cascade, scope, contract, query, definition) {
-    super(cascade, scope, contract, query, definition)
-
-    this.#concurrency = definition.concurrency
-  }
-
-  async process (store) {
-    return retry((retry) => this.#retry(store, retry), RETRY)
-  }
-
-  async acquire (store) {
-    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()
-  }
-
-  async commit (store) {
-    const { scope, state, reply, retry } = store
-
-    if (reply.error !== undefined) return
-
-    scope.set(state)
-
-    const result = await this.scope.commit(scope)
-
-    if (result === false) {
-      if (this.#concurrency === 'retry')
-        return retry()
-      else
-        throw new StateConcurrencyException()
-    }
-  }
-
-  async #retry (store, retry) {
-    store.retry = retry
-
-    return super.process(store)
-  }
-}
-
-const RETRY = {
-  base: 10,
-  max: 5000,
-  dispersion: 1,
-  retries: Infinity
-}
-
-exports.Transition = Transition

package/src/transmission.js

@@ -1,33 +0,0 @@
-'use strict'
-
-const { Connector } = require('./connector')
-const { TransmissionException } = require('./exceptions')
-
-class Transmission extends Connector {
-  #bindings
-
-  constructor (bindings) {
-    super()
-
-    this.#bindings = bindings
-    this.depends(bindings)
-  }
-
-  async request (request) {
-    let reply = false
-    let i = 0
-
-    while (reply === false && i < this.#bindings.length) {
-      reply = await this.#bindings[i].request(request)
-      i++
-    }
-
-    if (reply === false) {
-      throw new TransmissionException(`All (${this.#bindings.length}) bindings rejected.`)
-    }
-
-    return reply
-  }
-}
-
-exports.Transmission = Transmission

package/test/call.fixtures.js

@@ -1,27 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-
-// noinspection JSCheckFunctionSignatures
-const transmission = {
-  request: jest.fn((request) => ({ [request.invalid ? 'exception' : 'output']: generate() })),
-  link: jest.fn()
-}
-
-const contract = {
-  fit: jest.fn(() => null)
-}
-
-const request = () => ({
-  ok: {
-    input: { [generate()]: generate() },
-    query: { [generate()]: generate() }
-  },
-  bad: {
-    invalid: true
-  }
-})
-
-exports.transmission = transmission
-exports.contract = contract
-exports.request = request

package/test/call.test.js

@@ -1,46 +0,0 @@
-'use strict'
-
-const fixtures = require('./call.fixtures')
-const { Call } = require('../src/call')
-
-let call
-
-beforeEach(() => {
-  jest.clearAllMocks()
-
-  call = new Call(fixtures.transmission, fixtures.contract)
-})
-
-it('should depend on transmission', () => {
-  expect(fixtures.transmission.link).toHaveBeenLastCalledWith(call)
-})
-
-it('should call transmission', async () => {
-  const request = fixtures.request().ok
-
-  await call.invoke(request)
-
-  expect(fixtures.transmission.request).toHaveBeenCalledWith(request)
-})
-
-it('should fit request', async () => {
-  const request = fixtures.request().ok
-
-  await call.invoke(request)
-
-  expect(fixtures.contract.fit).toHaveBeenLastCalledWith(request)
-})
-
-it('should return reply', async () => {
-  const request = fixtures.request().ok
-
-  const reply = await call.invoke(request)
-
-  expect(reply).toStrictEqual(fixtures.transmission.request.mock.results[0].value.output)
-})
-
-it('should throw received exceptions', async () => {
-  const request = fixtures.request().bad
-
-  await expect(call.invoke(request)).rejects.toBeDefined()
-})

package/test/component.fixtures.js

@@ -1,21 +0,0 @@
-'use strict'
-
-const randomstring = require('randomstring')
-
-const invocation = () => jest.fn(() => randomstring.generate())
-
-const invocations = {
-  foo: {
-    invoke: invocation('foo'),
-    link: () => null
-  },
-  bar: {
-    invoke: invocation('bar'),
-    link: () => null
-  }
-}
-
-const locator = {}
-
-exports.invocations = invocations
-exports.locator = locator

package/test/component.test.js

@@ -1,40 +0,0 @@
-'use strict'
-
-const { Component } = require('../src/component')
-const { codes } = require('../src/exceptions')
-const fixtures = require('./component.fixtures')
-
-describe('Invocations', () => {
-  const name = ['foo', 'bar'][Math.floor(2 * Math.random())]
-  const invocation = fixtures.invocations[name]
-  const component = new Component(fixtures.locator, fixtures.invocations)
-
-  beforeEach(() => {
-    jest.clearAllMocks()
-  })
-
-  it('should invoke', async () => {
-    await component.invoke(name)
-
-    expect(invocation.invoke).toBeCalled()
-  })
-
-  it('should throw on unknown invocation name', async () => {
-    await expect(() => component.invoke('baz'))
-      .rejects.toMatchObject({ code: codes.NotImplemented })
-  })
-
-  it('should invoke input and query', async () => {
-    const input = { test: Math.random() }
-    const query = { test: Math.random() }
-    await component.invoke(name, { input, query })
-
-    expect(invocation.invoke).toBeCalledWith({ input, query })
-  })
-
-  it('should return io', async () => {
-    const io = await component.invoke(name)
-
-    expect(io).toBe(fixtures.invocations[name].invoke.mock.results[0].value)
-  })
-})

package/test/connector.fixtures.js

@@ -1,40 +0,0 @@
-'use strict'
-
-const { random, timeout } = require('@toa.io/generic')
-const { Connector } = require('../src/connector')
-
-class TestConnector extends Connector {
-  #label
-  #seq
-
-  constructor (label, seq) {
-    super()
-
-    this.#seq = seq
-    this.#label = label
-  }
-
-  async open () {
-    await timeout(random(10))
-    this.#seq.push(`+${this.#label}`)
-  }
-
-  async close () {
-    await timeout(random(10))
-    this.#seq.push(`-${this.#label}`)
-  }
-
-  async dispose () {
-    this.#seq.push(`*${this.#label}`)
-  }
-}
-
-class FailingConnector extends Connector {
-  async open () {
-    await timeout(random(10))
-    throw new Error('FailingConnector')
-  }
-}
-
-exports.TestConnector = TestConnector
-exports.FailingConnector = FailingConnector