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

package/src/connector.js

@@ -1,183 +0,0 @@
-'use strict'
-
-const { console } = require('@toa.io/console')
-const { newid } = require('@toa.io/generic')
-
-/**
- * Abstract connections hierarchy
- * @implements {toa.core.Connector}
- */
-class Connector {
-  /** @type {Array<Connector>} */
-  #dependencies = []
-
-  /** @type {Array<Connector>} */
-  #links = []
-
-  /** @type {Promise} */
-  #connecting
-
-  /** @type {Promise} */
-  #disconnecting
-
-  /** @type {string} */
-  id
-  /** @type {boolean} */
-  connected = false
-
-  constructor () {
-    this.id = this.constructor.name + '#' + newid().substring(0, 8)
-  }
-
-  /**
-   * Creates a dependency and backlink with another Connector or a set of Connectors
-   *
-   * See .connect() and .disconnect()
-   *
-   * @param connector {Connector | any | Array<Connector | any>}
-   * @returns {Connector}
-   */
-  depends (connector) {
-    /** @type {Connector} */
-    let next
-
-    if (connector instanceof Array) {
-      if (connector.length === 0) throw new Error('Connectors array must not be empty')
-
-      if (connector.length > 1) {
-        next = new Connector()
-
-        for (const item of connector) {
-          this.#dependencies.push(item)
-          item.depends(next)
-        }
-      } else next = connector[0]
-    } else next = connector
-
-    this.#dependencies.push(next)
-    next.link(this)
-
-    return next
-  }
-
-  /**
-   * Creates a backlink to another Connector
-   *
-   * See .connect() and .disconnect()
-   *
-   * @param connector {Connector}
-   * @returns {void}
-   */
-  link (connector) {
-    this.#links.push(connector)
-  }
-
-  /**
-   * Connects dependants then self
-   *
-   * In case of exception disconnects with current connection interruption
-   *
-   * Method is idempotent
-   *
-   * @returns {Promise<void>}
-   */
-  async connect () {
-    if (this.#connecting) return this.#connecting
-
-    this.#disconnecting = undefined
-
-    console.debug(`Connecting '${this.id}' with ${this.#dependencies.length} dependencies...`)
-
-    this.#connecting = (async () => {
-      await Promise.all(this.#dependencies.map((connector) => connector.connect()))
-      await this.open()
-    })()
-
-    try {
-      await this.#connecting
-      this.connected = true
-    } catch (e) {
-      await this.disconnect(true)
-      throw e
-    }
-
-    console.debug(`Connector '${this.id}' connected`)
-  }
-
-  /**
-   * Disconnects self then dependants
-   *
-   * Does nothing if there are connected linked Connectors
-   *
-   * Method is idempotent
-   *
-   * @param [interrupt] {boolean}
-   * @returns {Promise<void>}
-   */
-  async disconnect (interrupt) {
-    if (interrupt !== true) await this.#connecting
-
-    if (this.#disconnecting) return this.#disconnecting
-
-    const linked = this.#links.reduce((acc, parent) => acc || parent.connected, false)
-
-    if (linked && interrupt !== true) return
-
-    this.connected = false
-    this.#connecting = undefined
-
-    this.#disconnecting = (async () => {
-      const start = +new Date()
-
-      const interval = setInterval(() => {
-        const delay = +new Date() - start
-
-        if (delay > DELAY) console.warn(`Connector ${this.id} still disconnecting (${delay})`)
-      }, DELAY)
-
-      if (interrupt !== true) await this.close()
-
-      clearInterval(interval)
-
-      await Promise.all(this.#dependencies.map(connector => connector.disconnect()))
-
-      await this.dispose()
-    })()
-
-    await this.#disconnecting
-
-    console.debug(`Connector '${this.id}' disconnected`)
-  }
-
-  async reconnect () {
-    await this.disconnect()
-    await this.connect()
-  }
-
-  debug (node = {}) {
-    node[this.id] = { connected: this.connected }
-
-    if (this.#dependencies.length > 0) for (const connector of this.#dependencies) connector.debug?.(node[this.id])
-
-    return node
-  }
-
-  /**
-   * Called on connection
-   */
-  async open () {}
-
-  /**
-   * Called on disconnection
-   */
-  async close () {}
-
-  /**
-   * Called after self and dependants disconnection is complete
-   */
-  async dispose () {}
-}
-
-const DELAY = 5000
-
-exports.Connector = Connector

package/src/context.js

@@ -1,55 +0,0 @@
-'use strict'
-
-const { Connector } = require('./connector')
-
-/**
- * @implements {toa.core.Context}
- */
-class Context extends Connector {
-  aspects
-
-  #local
-  #discover
-  #remotes = {}
-
-  constructor (local, discover, aspects = []) {
-    super()
-
-    this.aspects = aspects
-
-    this.#local = local
-    this.#discover = discover
-
-    this.depends(local)
-
-    if (aspects.length > 0) this.depends(aspects)
-  }
-
-  async apply (endpoint, request) {
-    return this.#local.invoke(endpoint, request)
-  }
-
-  async call (namespace, name, endpoint, request) {
-    const remote = await this.#remote(namespace, name)
-
-    return remote.invoke(endpoint, request)
-  }
-
-  async #remote (namespace, name) {
-    const key = namespace + '.' + name
-
-    this.#remotes[key] ??= this.#connect(namespace, name)
-
-    return this.#remotes[key]
-  }
-
-  async #connect (namespace, name) {
-    const remote = await this.#discover(namespace, name)
-
-    this.depends(remote)
-
-    return remote
-  }
-}
-
-exports.Context = Context

package/src/contract/conditions.js

@@ -1,21 +0,0 @@
-'use strict'
-
-const { SystemException } = require('../exceptions')
-
-class Conditions {
-  #schema
-
-  constructor (schema) {
-    this.#schema = schema
-  }
-
-  fit (value) {
-    const error = this.#schema.fit(value)
-
-    if (error !== null) throw new this.constructor.Exception(error)
-  }
-
-  static Exception = SystemException
-}
-
-exports.Conditions = Conditions

package/src/contract/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { Request } = require('./request')
-const { Reply } = require('./reply')
-
-exports.Request = Request
-exports.Reply = Reply

package/src/contract/reply.js

@@ -1,25 +0,0 @@
-'use strict'
-
-const schemas = require('./schemas')
-const { Conditions } = require('./conditions')
-const { ResponseContractException } = require('../exceptions')
-
-class Reply extends Conditions {
-  static Exception = ResponseContractException
-
-  /**
-   * @returns {toa.schema.JSON}
-   */
-  static schema (output, error) {
-    const schema = { type: 'object', properties: {}, additionalProperties: false }
-
-    if (output !== undefined) schema.properties.output = output
-
-    if (error !== undefined) schema.properties.error = error
-    else schema.properties.error = schemas.error
-
-    return schema
-  }
-}
-
-exports.Reply = Reply

package/src/contract/request.js

@@ -1,67 +0,0 @@
-'use strict'
-
-const schemas = require('./schemas')
-const { RequestContractException } = require('../exceptions')
-const { Conditions } = require('./conditions')
-
-class Request extends Conditions {
-  static Exception = RequestContractException
-
-  /**
-   * @returns {toa.schema.JSON}
-   */
-  static schema (definition, entity) {
-    const schema = {
-      type: 'object',
-      properties: { authentic: { type: 'boolean' } },
-      additionalProperties: true
-    }
-
-    const required = []
-
-    if (definition.input !== undefined) {
-      schema.properties.input = definition.input
-      required.push('input')
-    } else {
-      schema.properties.input = { type: 'null' }
-    }
-
-    if (entity === undefined)
-      definition.query = false
-
-    if (definition.query === true)
-      required.push('query')
-
-    if (definition.query === false)
-      schema.properties.query = { type: 'null' }
-
-    if (definition.query !== false) {
-      const query = structuredClone(schemas.query)
-
-      query.properties.id = entity.schema.properties.id
-
-      if (definition.type === 'observation') {
-        delete query.properties.version
-      } else {
-        delete query.properties.projection
-      }
-
-      if (definition.type !== 'observation' || definition.scope !== 'objects') {
-        delete query.properties.omit
-        delete query.properties.limit
-      } else {
-        if (query.required === undefined) query.required = ['limit']
-        else query.required.push('limit')
-      }
-
-      schema.properties.query = query
-    }
-
-    if (required.length > 0)
-      schema.required = required
-
-    return schema
-  }
-}
-
-exports.Request = Request

package/src/contract/schemas/error.yaml

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

package/src/contract/schemas/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { resolve } = require('path')
-const { load } = require('@toa.io/yaml')
-
-exports.query = load.sync(resolve(__dirname, './query.yaml'))
-exports.error = load.sync(resolve(__dirname, './error.yaml'))

package/src/contract/schemas/query.yaml

@@ -1,30 +0,0 @@
-type: object
-properties:
-  id: { }
-  version:
-    type: integer
-    minimum: 0
-  criteria:
-    type: string
-  omit:
-    type: integer
-    minimum: 0
-  limit:
-    type: integer
-    minimum: 0
-  sort:
-    type: array
-    uniqueItems: true
-    minItems: 1
-    items:
-      type: string
-      pattern: ^\w{1,32}(?::(?:asc|desc))?$
-  projection:
-    type: array
-    uniqueItems: true
-    minItems: 1
-    items:
-      type: string
-      not:
-        const: id
-additionalProperties: false

package/src/discovery.js

@@ -1,44 +0,0 @@
-'use strict'
-
-const { console } = require('@toa.io/console')
-const { Connector } = require('./connector')
-
-class Discovery extends Connector {
-  #lookup
-  #lookups
-
-  constructor (lookup) {
-    super()
-
-    this.#lookup = lookup
-  }
-
-  async open () {
-    this.#lookups = {}
-  }
-
-  async lookup (locator) {
-    const id = locator.id
-
-    if (this.#lookups[id] === undefined) {
-      this.#lookups[id] = await this.#lookup(locator)
-      this.depends(this.#lookups[id])
-    }
-
-    console.debug(`Sending lookup request to '${id}'`)
-
-    const warning = () => console.warn(`Waiting for lookup response from '${id}'...`)
-    const timeout = setTimeout(warning, TIMEOUT)
-
-    const output = await this.#lookups[id].invoke()
-
-    console.debug(`Lookup response from '${id}' received`)
-    clearTimeout(timeout)
-
-    return output
-  }
-}
-
-const TIMEOUT = 5000
-
-exports.Discovery = Discovery

package/src/emission.js

@@ -1,23 +0,0 @@
-'use strict'
-
-const { Connector } = require('./connector')
-
-class Emission extends Connector {
-  #events
-
-  constructor (events) {
-    super()
-
-    this.#events = events
-
-    this.depends(events)
-  }
-
-  async emit (event) {
-    const emission = this.#events.map((e) => e.emit(event))
-
-    await Promise.all(emission)
-  }
-}
-
-exports.Emission = Emission

package/src/entities/changeset.js

@@ -1,38 +0,0 @@
-'use strict'
-
-const { EntityContractException } = require('../exceptions')
-
-class Changeset {
-  /** @type {toa.core.Query} */
-  query
-
-  #schema
-  #state
-
-  constructor (schema, query) {
-    this.query = query
-
-    this.#schema = schema
-    this.#state = schema.system()
-  }
-
-  get () {
-    return this.#state
-  }
-
-  set (value) {
-    const error = this.#schema.adapt(value)
-
-    if (error !== null) throw new EntityContractException(error)
-
-    value._updated = Date.now()
-
-    this.#state = value
-  }
-
-  export () {
-    return this.#state
-  }
-}
-
-exports.Changeset = Changeset

package/src/entities/entity.js

@@ -1,74 +0,0 @@
-'use strict'
-
-const { difference, newid } = require('@toa.io/generic')
-const { EntityContractException } = require('../exceptions')
-
-class Entity {
-  #schema
-  #origin = null
-  #state
-
-  constructor (schema, argument) {
-    this.#schema = schema
-
-    if (typeof argument === 'object') {
-      const object = structuredClone(argument)
-      this.set(object)
-      this.#origin = argument
-    } else {
-      const id = argument === undefined ? newid() : argument
-      this.#init(id)
-    }
-  }
-
-  get () {
-    return this.#state
-  }
-
-  set (value) {
-    const error = this.#schema.fit(value)
-
-    if (error !== null)
-      throw new EntityContractException(error)
-
-    this.#set(value)
-  }
-
-  event () {
-    return {
-      origin: this.#origin,
-      state: this.#state,
-      changeset: this.#origin === null ? this.#state : difference(this.#origin, this.#state),
-      trailers: this.#state._trailers
-    }
-  }
-
-  #init (id) {
-    const value = {
-      ...this.#schema.defaults({ id }),
-      _version: 0,
-      _created: Date.now()
-    }
-
-    this.#set(value)
-  }
-
-  #set (value) {
-    if (!('_trailers' in value))
-      Object.defineProperty(value, '_trailers', {
-        writable: false,
-        configurable: false,
-        enumerable: false,
-        value: {}
-      })
-
-    if (this.#state !== undefined) {
-      value._updated = Date.now()
-      value._version++
-    }
-
-    this.#state = value
-  }
-}
-
-exports.Entity = Entity

package/src/entities/factory.js

@@ -1,33 +0,0 @@
-'use strict'
-
-const { Entity } = require('./entity')
-const { EntitySet } = require('./set')
-const { Changeset } = require('./changeset')
-
-class Factory {
-  #schema
-
-  constructor (schema) {
-    this.#schema = schema
-  }
-
-  init (id) {
-    return new Entity(this.#schema, id)
-  }
-
-  object (record) {
-    return new Entity(this.#schema, record)
-  }
-
-  objects (recordset) {
-    const set = recordset.map((record) => this.object(record))
-
-    return new EntitySet(set)
-  }
-
-  changeset (query) {
-    return new Changeset(this.#schema, query)
-  }
-}
-
-exports.Factory = Factory

package/src/entities/index.js

@@ -1,5 +0,0 @@
-'use strict'
-
-const { Factory } = require('./factory')
-
-exports.Factory = Factory

package/src/entities/set.js

@@ -1,15 +0,0 @@
-'use strict'
-
-class EntitySet {
-  #set
-
-  constructor (set) {
-    this.#set = set
-  }
-
-  get () {
-    return this.#set.map((entity) => entity.get())
-  }
-}
-
-exports.EntitySet = EntitySet

package/src/event.js

@@ -1,40 +0,0 @@
-'use strict'
-
-const { Connector } = require('./connector')
-
-/**
- * @implements {toa.core.Event}
- */
-class Event extends Connector {
-  /** @type {toa.core.bindings.Emitter} */
-  #emitter
-  #bridge
-  #conditioned
-  #subjective
-
-  constructor (definition, emitter, bridge = undefined) {
-    super()
-
-    this.#conditioned = definition.conditioned
-    this.#subjective = definition.subjective
-    this.#emitter = emitter
-    this.#bridge = bridge
-
-    this.depends(emitter)
-
-    if (bridge !== undefined) this.depends(bridge)
-  }
-
-  async emit (event) {
-    if (this.#conditioned === false || await this.#bridge.condition(event) === true) {
-      const payload = this.#subjective ? await this.#bridge.payload(event) : event.state
-
-      /** @type {toa.core.Message} */
-      const message = { payload }
-
-      await this.#emitter.emit(message)
-    }
-  }
-}
-
-exports.Event = Event