@toa.io/core 1.0.0-alpha.0 → 1.0.0-alpha.107

package/test/entities/entity.fixtures.js

@@ -16,10 +16,13 @@ const state = () => ({
   _created: generate(),
   _updated: generate(),
   _deleted: generate(),
-  _version: generate()
+  _version: 0
 })
 
-const failed = () => ({ ...state(), fail: true })
+const failed = () => ({
+  ...state(),
+  fail: true
+})
 
 exports.schema = schema
 exports.state = state

package/test/entities/entity.test.js

@@ -7,37 +7,12 @@ beforeEach(() => {
   jest.clearAllMocks()
 })
 
-describe('new', () => {
-  it('should throw on schema error', () => {
-    const entity = new Entity(fixtures.schema)
-
-    expect(() => entity.set(fixtures.failed())).toThrow()
-  })
-
-  it('should provide state', () => {
-    const entity = new Entity(fixtures.schema)
-    const state = fixtures.state()
-
-    entity.set(state)
-
-    expect(entity.get()).toEqual(state)
-  })
-})
-
 describe('argument', () => {
-  it('should provide initial state if no argument passed', () => {
-    const entity = new Entity(fixtures.schema)
-    const defaults = fixtures.schema.defaults.mock.results[0].value
-    const expected = { ...defaults, _version: 0 }
-
-    expect(entity.get()).toStrictEqual(expected)
-  })
-
   it('should set state', () => {
     const state = fixtures.state()
     const entity = new Entity(fixtures.schema, state)
 
-    expect(entity.get()).toStrictEqual(state)
+    expect(entity.get()).toEqual(state)
   })
 })
 
@@ -51,26 +26,12 @@ it('should provide event', () => {
 
   const event = entity.event()
 
-  expect(event).toStrictEqual({
+  expect(event).toEqual(expect.objectContaining({
     state,
     origin,
-    changeset: { foo: 'new value' }
-  })
-})
-
-it('should define `id` as readonly', async () => {
-  const origin = fixtures.state()
-  const entity = new Entity(fixtures.schema, origin)
-  const state = entity.get()
-
-  expect(() => (state.id = 1)).toThrow('assign to read only property')
-})
-
-it('should seal id', async () => {
-  const origin = fixtures.state()
-  const entity = new Entity(fixtures.schema, origin)
-  const state = entity.get()
-  const redefine = () => Object.defineProperty(state, 'id', { writable: true })
-
-  expect(redefine).toThrow('redefine property')
+    changeset: expect.objectContaining({
+      foo: 'new value',
+      _version: 1
+    })
+  }))
 })

package/types/bindings.d.ts

@@ -8,6 +8,8 @@ declare namespace toa.core.bindings {
 
   interface Consumer extends _core.Connector {
     request (request: Request): Promise<_core.Reply>
+
+    task (request: Request): Promise<void>
   }
 
   interface Emitter extends _core.Connector {
@@ -37,4 +39,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>
+export type Broadcast<L = any> = toa.core.bindings.Broadcast<L>

package/types/bridges.ts

@@ -0,0 +1,30 @@
+import type { Request, Reply } from './request'
+import type { Context } from './context'
+
+export interface Algorithm {
+  mount: (context?: Context) => Promise<void>
+
+  execute: ((input: any, scope: object | object[]) => Promise<Reply>) |
+  ((input: any) => Promise<Reply>) |
+  (() => Promise<Reply>)
+}
+
+export interface Event {
+  condition: (object: object) => Promise<boolean>
+
+  payload: (object: object) => Promise<object>
+}
+
+export interface Receiver {
+  condition: (object: object) => Promise<boolean>
+
+  request: (object: object) => Promise<Request>
+}
+
+export interface Factory {
+  algorithm?: (path: string, name: string, context: Context) => Algorithm
+
+  event?: (path: string, label: string) => Event
+
+  receiver?: (path: string, label: string) => Receiver
+}

package/types/component.d.ts

@@ -1,9 +1,12 @@
 import { Connector } from './connector'
 import { Locator } from './locator'
 import { Request } from './request'
+import { Operation } from './operations'
 
-export interface Component extends Connector{
+export class Component extends Connector {
   locator: Locator
 
+  constructor (locator: Locator, operations: Record<string, Operation>)
+
   invoke<T = any> (endpoint: string, request: Request): Promise<T>
 }

package/types/context.d.ts

@@ -3,25 +3,19 @@ import * as _reply from './reply'
 import * as _extensions from './extensions'
 import * as _connector from './connector'
 
-declare namespace toa.core {
+export interface Context extends _connector.Connector{
+  aspects: _extensions.Aspect[]
 
-  interface Context extends _connector.Connector {
-    aspects: _extensions.Aspect[]
+  /**
+   * Calls local endpoint
+   */
+  apply (endpoint: string, request: _request.Request): Promise<_reply.Reply>
 
-    /**
-     * Calls local endpoint
-     */
-    apply(endpoint: string, request: _request.Request): Promise<_reply.Reply>
-
-    /**
-     * Calls remote endpoint
-     */
-    call(namespace: string, name: string, endpoint: string, request: _request.Request): Promise<_reply.Reply>
-
-    // shortcuts
-    [key: string]: any
-  }
+  /**
+   * Calls remote endpoint
+   */
+  call (namespace: string, name: string, endpoint: string, request: _request.Request): Promise<_reply.Reply>
 
+  // shortcuts
+  [key: string]: any
 }
-
-export type Context = toa.core.Context

package/types/extensions.d.ts

@@ -3,9 +3,10 @@ import * as _component from './component'
 import * as _context from './context'
 import * as _storages from './storages'
 import * as _bindings from './bindings'
+import { Manifest } from '@toa.io/norm'
 
-export interface Factory{
-  tenant? (locator: _core.Locator, manifest: object): _core.Connector
+export interface Factory {
+  tenant? (locator: _core.Locator, manifest: object, component: Manifest): _core.Connector
 
   aspect? (locator: _core.Locator, manifest: object | null): Aspect | Aspect[]
 
@@ -22,7 +23,7 @@ export interface Factory{
   receiver? (receiver: _core.Receiver, locator: _core.Locator): _core.Receiver
 }
 
-export interface Aspect extends _core.Connector{
+export interface Aspect extends _core.Connector {
   name: string
 
   invoke (...args: any[]): any

package/types/index.ts

@@ -0,0 +1,15 @@
+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 type { Component } from './component'
+export type { Remote } from './remote'
+export { Connector } from './connector'
+export type { Context } from './context'
+export type { Exception } from './exception'
+export { Locator } from './locator'
+export type { Receiver } from './receiver'
+export type { Message } from './message'
+export type { Request, Query, Reply } from './request'

package/types/locator.d.ts

@@ -1,10 +1,11 @@
-export class Locator {
+export class Locator{
   public readonly name: string
   public readonly namespace: string
 
   public readonly id: string
   public readonly label: string
   public readonly uppercase: string
+  public readonly lowercase: string
 
   constructor (name: string, namespace?: string)
 

package/types/operations.d.ts

@@ -1,2 +1,8 @@
+import { Request } from './request'
+
 export type type = 'transition' | 'observation' | 'assignment' | 'computation' | 'effect'
 export type scope = 'object' | 'objects' | 'changeset'
+
+export class Operation {
+  invoke<T = any> (request: Request): Promise<T>
+}

package/types/remote.d.ts

@@ -0,0 +1,18 @@
+import { Component } from './component'
+
+export class Remote extends Component {
+  explain (endpoint: string): Promise<Explanation>
+}
+
+interface Explanation {
+  input: Schema | null
+  output: Schema | null
+  errors?: string[]
+}
+
+interface Schema {
+  type: string
+  properties: {
+    [key: string]: Schema
+  }
+}

package/types/request.d.ts

@@ -14,6 +14,7 @@ export interface Request {
   input?: any
   query?: Query
   authentic?: boolean
+  task?: boolean
 }
 
 export interface Reply {

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/types/bridges.d.ts

@@ -1,41 +0,0 @@
-import * as _core from '@toa.io/core/types'
-import type * as reply from './reply'
-import type * as context from './context'
-import type * as connector from './connector'
-
-declare namespace toa.core.bridges {
-
-  interface Algorithm extends connector.Connector {
-    mount(context?: context.Context): Promise<void>
-
-    execute(input: any, scope: object | object[]): Promise<reply.Reply>
-
-    execute(input: any): Promise<reply.Reply>
-
-    execute(): Promise<reply.Reply>
-  }
-
-  interface Event {
-    condition(object): Promise<boolean>
-
-    payload(object): Promise<object>
-  }
-
-  interface Receiver {
-    condition(object): Promise<boolean>
-
-    request(object): Promise<_core.Request>
-  }
-
-  interface Factory {
-    algorithm(path: string, name: string, context: context.Context): Algorithm
-
-    event(path: string, label: string): Event
-
-    receiver(path: string, label: string): Receiver
-  }
-
-}
-
-export type Algorithm = toa.core.bridges.Algorithm
-export type Factory = toa.core.bridges.Factory

package/types/index.d.ts

@@ -1,14 +0,0 @@
-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'
-export { Context } from './context'
-export { Exception } from './exception'
-export { Locator } from './locator'
-export { Receiver } from './receiver'
-export { Message } from './message'
-export { Request, Query, Reply } from './request'