@toa.io/boot 1.0.0-alpha.32 → 1.0.0-alpha.320

package/types/index.d.ts

@@ -1,21 +1,73 @@
-import * as core from '@toa.io/core'
-import * as composition from './composition'
+import type * as core from '@toa.io/core'
+import type * as types from '@toa.io/core/types'
+import type * as norm from '@toa.io/norm/types'
+import * as composition from './composition.d.ts'
 
-export * as bindings from './bindings'
+export * as bindings from './bindings.d.ts'
 
-export async function composition (paths: string[], options?: composition.Options): Promise<core.Connector>
+export async function manifest(
+  path: string,
+  options?: composition.Options
+): Promise<norm.Manifest>
 
-export async function remote (locator: core.Locator): Promise<core.Component>
+/** What this process was given about the components it calls. */
+export namespace map {
+  /** the file to read it from, or the map itself */
+  function use(value: string | Record<string, core.Contract> | undefined): void
 
-export async function receive<T = any> (
+  /** what this process composes, stated by the boot that composes it */
+  function compose(manifests: norm.Manifest[]): Promise<void>
+
+  /** forgets what this process composed */
+  function forget(): void
+
+  function contract(id: string): Promise<core.Contract | undefined>
+}
+
+export async function composition(
+  paths: string[],
+  options?: composition.Options
+): Promise<core.Connector>
+
+export async function remote(
+  locator: core.Locator,
+  source?: types.Source
+): Promise<core.Remote>
+
+export async function receive<T = any>(
   label: string,
-  receiver: Receiver,
+  receiver: Receiver
 ): Promise<core.Connector>
 
-export async function receive<T = any> (
+export async function receive<T = any>(
   label: string,
   group: string | undefined,
-  receiver: Receiver,
+  receiver: Receiver
 ): Promise<core.Connector>
 
-type Receiver = { receive: (message: core.Message<T>) => void | Promise<void> }
+type Receiver = { receive: (message: types.Message<T>) => void | Promise<void> }
+
+export function host(): types.extensions.Host
+
+/** A process, as a connector: what the command built, and what the extensions keep in one. */
+export class Workload extends core.Connector {
+  constructor(build: (workload: Workload) => Promise<core.Connector>)
+
+  /** A part of this process a halt takes down and builds again. */
+  gate(build: () => Promise<core.Connector>): core.Gate
+
+  /** Whether what a halt takes down is up. */
+  running(): boolean
+
+  /** Whether this process is quiet: it does nothing of its own accord and holds everything. */
+  quiescent(): boolean
+
+  /** Stops what this process does of its own accord, holding open everything it has. */
+  quiesce(): Promise<void>
+
+  /** Undoes a quiesce. */
+  cancel(): Promise<void>
+
+  /** Stops this process for `seconds`, then builds it again. */
+  stop(seconds: number): void
+}

package/types/manifest.d.ts

@@ -1,8 +1,9 @@
 import * as _norm from '@toa.io/norm/types'
-import * as _composition from './composition'
+import * as _composition from './composition.d.ts'
 
 declare namespace toa.boot {
-
-  type Manifest = (path: string, options?: _composition.Options) => Promise<_norm.Component>
-
+  type Manifest = (
+    path: string,
+    options?: _composition.Options
+  ) => Promise<_norm.Component>
 }

package/src/discovery.js

@@ -1,43 +0,0 @@
-'use strict'
-
-const { Discovery, Exposition } = require('@toa.io/core')
-
-const boot = require('./index')
-
-let promise
-let instance = null
-
-const discovery = async () => {
-  if (instance === null) {
-    instance = new Discovery(lookup)
-    promise = instance.connect()
-  }
-
-  await promise
-
-  return instance
-}
-
-const lookup = async (locator) => {
-  const call = boot.call(locator, ENDPOINT, { bindings: BINDINGS })
-
-  await call.connect()
-
-  return call
-}
-
-const expose = async (manifest) => {
-  const exposition = new Exposition(manifest.locator, manifest)
-  const operations = { [ENDPOINT]: { bindings: BINDINGS } }
-  const producers = boot.bindings.produce(exposition, operations)
-
-  await Promise.all(producers.map((producer) => producer.connect()))
-
-  return producers
-}
-
-const BINDINGS = ['@toa.io/bindings.amqp']
-const ENDPOINT = '.lookup'
-
-exports.discovery = discovery
-exports.expose = expose

package/src/exposition.js

@@ -1,17 +0,0 @@
-'use strict'
-
-const { Exposition, Locator } = require('@toa.io/core')
-
-const boot = require('./index')
-
-const exposition = async (manifest) => {
-  const locator = new Locator('', '')
-  const exposition = new Exposition(locator, manifest)
-  const producers = boot.bindings.expose(exposition)
-
-  await Promise.all(producers.map((producer) => producer.connect()))
-
-  return producers
-}
-
-exports.exposition = exposition