@toa.io/core 1.0.0-alpha.31 → 1.0.0-alpha.310

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

package/test/connector.test.js

@@ -1,176 +0,0 @@
-'use strict'
-
-const fixtures = require('./connector.fixtures')
-
-let sequence
-
-beforeEach(() => {
-  sequence = []
-})
-
-describe('callbacks', () => {
-  let a
-
-  beforeEach(() => {
-    a = new fixtures.TestConnector('a', sequence)
-  })
-
-  it('should call connection', async () => {
-    await a.connect()
-    expect(sequence).toEqual(['+a'])
-  })
-
-  it('should call disconnection', async () => {
-    await a.connect()
-    await a.disconnect()
-
-    expect(sequence.indexOf('+a')).toBeLessThan(sequence.indexOf('-a'))
-  })
-
-  it('should reconnect', async () => {
-    await a.connect()
-    await a.reconnect()
-    await a.reconnect()
-
-    expect(sequence).toEqual(['+a', '-a', '*a', '+a', '-a', '*a', '+a'])
-  })
-})
-
-describe('dependencies', () => {
-  let a
-  let b
-  let c
-  let d
-
-  beforeEach(() => {
-    a = new fixtures.TestConnector('a', sequence)
-    b = new fixtures.TestConnector('b', sequence)
-    c = new fixtures.TestConnector('c', sequence)
-    d = new fixtures.TestConnector('d', sequence)
-  })
-
-  it('should wait dependencies on connection', async () => {
-    a.depends(b).depends(c)
-    a.depends(d)
-
-    await a.connect()
-
-    expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('+b'))
-    expect(sequence.indexOf('+b')).toBeLessThan(sequence.indexOf('+a'))
-    expect(sequence.indexOf('+d')).toBeLessThan(sequence.indexOf('+a'))
-  })
-
-  it('should wait array of connectors', async () => {
-    a.depends([b, d])
-    b.depends(c)
-    d.depends(c)
-
-    await a.connect()
-
-    expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('+b'))
-    expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('+d'))
-    expect(sequence.indexOf('+b')).toBeLessThan(sequence.indexOf('+a'))
-    expect(sequence.indexOf('+d')).toBeLessThan(sequence.indexOf('+a'))
-  })
-
-  it('should wait array(1) of connectors', async () => {
-    a.depends([b])
-    b.depends(c)
-
-    await a.connect()
-
-    expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('+b'))
-    expect(sequence.indexOf('+b')).toBeLessThan(sequence.indexOf('+a'))
-  })
-
-  it('should throw on empty array', async () => {
-    expect(() => a.depends([])).toThrow(/must not be empty/)
-  })
-
-  it('should await 2-way dependencies', async () => {
-    a.depends([b, c, d])
-    d.depends([b, c])
-
-    await a.connect()
-
-    expect(sequence.indexOf('+b')).toBeLessThan(sequence.indexOf('+a'))
-    expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('+a'))
-    expect(sequence.indexOf('+d')).toBeLessThan(sequence.indexOf('+a'))
-
-    expect(sequence.indexOf('+b')).toBeLessThan(sequence.indexOf('+d'))
-    expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('+d'))
-  })
-
-  it('should disconnect before dependencies', async () => {
-    a.depends(b).depends(c)
-    b.depends(d)
-
-    await a.disconnect()
-
-    expect(sequence.indexOf('-a')).toBeLessThan(sequence.indexOf('-b'))
-    expect(sequence.indexOf('-b')).toBeLessThan(sequence.indexOf('-c'))
-    expect(sequence.indexOf('-b')).toBeLessThan(sequence.indexOf('-d'))
-  })
-
-  it('should call disconnected', async () => {
-    a.depends(b).depends(c)
-    b.depends(d)
-
-    await a.disconnect()
-
-    expect(sequence.indexOf('*c')).toBeLessThan(sequence.indexOf('*b'))
-    expect(sequence.indexOf('*b')).toBeLessThan(sequence.indexOf('*a'))
-    expect(sequence.indexOf('*d')).toBeLessThan(sequence.indexOf('*b'))
-    expect(sequence.indexOf('*a')).toBe(sequence.length - 1)
-  })
-
-  it('should disconnect if no parents left', async () => {
-    a.depends(c)
-    b.depends(c)
-
-    await a.connect()
-    await b.connect()
-
-    expect(sequence).toEqual(['+c', '+a', '+b'])
-
-    await a.disconnect()
-
-    expect(sequence).toEqual(['+c', '+a', '+b', '-a', '*a'])
-
-    await b.disconnect()
-
-    expect(sequence).toEqual(['+c', '+a', '+b', '-a', '*a', '-b', '-c', '*c', '*b'])
-  })
-
-  it('should throw if depends not on Connector', async () => {
-    expect(() => a.depends({})).toThrow()
-  })
-
-  describe('errors', () => {
-    let f
-
-    beforeEach(() => {
-      f = new fixtures.FailingConnector()
-    })
-
-    it('should disconnect on fail', async () => {
-      f.depends(b).depends(c)
-
-      await expect(f.connect()).rejects.toThrow('FailingConnector')
-      expect(sequence).toEqual(['+c', '+b', '-b', '-c', '*c', '*b'])
-    })
-
-    it('should interrupt connection chain', async () => {
-      a.depends(f).depends(c)
-      f.depends(d)
-
-      await expect(a.connect()).rejects.toThrow('FailingConnector')
-
-      expect(sequence.indexOf('+c')).toBeLessThan(sequence.indexOf('-c'))
-      expect(sequence.indexOf('+d')).toBeLessThan(sequence.indexOf('-d'))
-
-      expect(sequence.indexOf('+a')).toBe(-1)
-      expect(sequence.indexOf('-a')).toBe(-1)
-    })
-  })
-})

package/test/context.fixtures.js

@@ -1,18 +0,0 @@
-'use strict'
-
-const { Connector } = require('../src/connector')
-
-const local = {
-  link: jest.fn()
-}
-
-const discover = jest.fn(() => ({
-  invoke: jest.fn(),
-  link: jest.fn()
-}))
-
-const aspects = [new Connector(), new Connector()]
-
-exports.local = local
-exports.discover = discover
-exports.aspects = aspects

package/test/context.test.js

@@ -1,29 +0,0 @@
-'use strict'
-
-const fixtures = require('./context.fixtures')
-const { Context } = require('../src/context')
-
-/** @type {toa.core.Context} */
-let context
-
-beforeEach(() => {
-  jest.clearAllMocks()
-
-  context = new Context(fixtures.local, fixtures.discover, fixtures.aspects)
-})
-
-it('should expose aspects', () => {
-  expect(context.aspects).toBeDefined()
-  expect(context.aspects).toStrictEqual(fixtures.aspects)
-})
-
-describe('call', () => {
-  it('should discover once', async () => {
-    const request = {}
-
-    await context.call('a', 'b', 'c', request)
-    await context.call('a', 'b', 'c', request)
-
-    expect(fixtures.discover).toHaveBeenCalledTimes(1)
-  })
-})

package/test/contract/conditions.test.js

@@ -1,26 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-
-const { Conditions } = require('../../src/contract/conditions')
-const fixtures = require('./contract.fixtures')
-
-let conditions
-
-beforeEach(() => {
-  conditions = new Conditions(fixtures.schema)
-})
-
-it('should fit value', () => {
-  const value = { foo: generate() }
-
-  conditions.fit(value)
-
-  expect(fixtures.schema.fit).toHaveBeenCalledWith(value)
-})
-
-it('should throw on invalid value', () => {
-  const value = { invalid: true }
-
-  expect(() => conditions.fit(value)).toThrow()
-})

package/test/contract/contract.fixtures.js

@@ -1,33 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-const { load } = require('@toa.io/yaml')
-const { resolve } = require('path')
-
-// noinspection JSCheckFunctionSignatures
-const schema = {
-  fit: jest.fn((input) => (input.invalid ? { message: generate() } : null))
-}
-
-const query = {
-  parse: jest.fn(() => ({ [generate()]: generate() }))
-}
-
-const declaration = {}
-
-const schemas = {
-  request: {
-    type: 'object',
-    properties: {
-      input: { type: 'null' },
-      query: load.sync(resolve(__dirname, '../../src/contract/schemas/query.yaml')),
-      authentic: { type: 'boolean' }
-    },
-    additionalProperties: true
-  }
-}
-
-exports.schema = schema
-exports.query = query
-exports.declaration = declaration
-exports.schemas = schemas

package/test/contract/request.test.js

@@ -1,112 +0,0 @@
-'use strict'
-
-const clone = require('clone-deep')
-const { generate } = require('randomstring')
-
-jest.mock('../../src/contract/conditions')
-
-const { Request } = require('../../src/contract/request')
-const { Conditions } = require('../../src/contract/conditions')
-const fixtures = require('./contract.fixtures')
-
-let contract
-
-beforeEach(() => {
-  jest.clearAllMocks()
-
-  contract = new Request(fixtures.schema)
-})
-
-const dummy = { schema: { properties: {} } }
-
-it('should extend Conditions', () => {
-  expect(contract).toBeInstanceOf(Conditions)
-  expect(Conditions).toHaveBeenCalledWith(fixtures.schema)
-})
-
-it('should fit request', () => {
-  const request = { [generate()]: generate() }
-
-  contract.fit(request)
-
-  expect(Conditions.mock.instances[0].fit).toHaveBeenCalledWith(request)
-})
-
-describe('schema', () => {
-  let schema
-
-  beforeEach(() => {
-    schema = clone(fixtures.schemas.request)
-  })
-
-  it('should provide schema', () => {
-    expect(Request.schema({}, dummy)).toBeDefined()
-  })
-
-  it('should add required input if defined', () => {
-    const input = { type: 'number' }
-
-    expect(Request.schema({ input }, dummy).properties.input).toStrictEqual(input)
-  })
-
-  it('should set input as null if undefined', async () => {
-    expect(Request.schema({}, dummy).properties.input).toStrictEqual({ type: 'null' })
-  })
-
-  it('should contain query if declaration.query is not defined', () => {
-    expect(Request.schema({}, dummy).properties.query).toBeDefined()
-  })
-
-  it('should not contain query if declaration.query is false', () => {
-    schema.properties.query = { type: 'null' }
-    expect(Request.schema({ query: false }, dummy)).toStrictEqual(schema)
-  })
-
-  it('should require query if declaration.query is true', () => {
-    schema.required = ['query']
-    expect(Request.schema({ query: true }, dummy).required).toStrictEqual(expect.arrayContaining(['query']))
-  })
-
-  it('should forbid projection for non observations', () => {
-    expect(Request.schema({ type: 'transition' }, dummy).properties.query.properties.projection)
-      .toBe(undefined)
-
-    expect(Request.schema({ type: 'assignment' }, dummy).properties.query.properties.projection)
-      .toBe(undefined)
-
-    expect(Request.schema({ type: 'observation' }, dummy).properties.query.properties.projection)
-      .toBeDefined()
-  })
-
-  it('should forbid version for observations', () => {
-    expect(Request.schema({ type: 'transition' }, dummy).properties.query.properties.version)
-      .toBeDefined()
-
-    expect(Request.schema({ type: 'observation' }, dummy).properties.query.properties.version)
-      .toBe(undefined)
-  })
-
-  it('should allow omit, limit only for set observations', () => {
-    const schema = Request.schema({ type: 'transition' }, dummy)
-    const transition = schema.properties.query.properties
-
-    expect(transition.omit).toBeUndefined()
-    expect(transition.limit).toBeUndefined()
-
-    const object = Request.schema({
-      type: 'observation',
-      scope: 'object'
-    }, dummy).properties.query.properties
-
-    expect(object.omit).toBeUndefined()
-    expect(object.limit).toBeUndefined()
-
-    const objects = Request.schema({
-      type: 'observation',
-      scope: 'objects'
-    }, dummy).properties.query.properties
-
-    expect(objects.omit).toBeDefined()
-    expect(objects.limit).toBeDefined()
-  })
-})

package/test/emission.fixtures.js

@@ -1,17 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-
-// noinspection JSCheckFunctionSignatures
-const events = [0, 1, 2].map((index) => ({
-  emit: jest.fn(async (state) => ({ ...state, event: index }))
-}))
-
-const event = {
-  origin: { [generate()]: generate() },
-  state: { [generate()]: generate() },
-  changeset: { [generate()]: generate() }
-}
-
-exports.events = events
-exports.event = event