@toa.io/extensions.exposition 0.22.1 → 0.24.0-alpha.0

package/source/directives/octets/Permute.ts

@@ -0,0 +1,37 @@
+import { NotAcceptable, NotFound } from '../../HTTP'
+import * as schemas from './schemas'
+import type { Maybe } from '@toa.io/types'
+import type { Component } from '@toa.io/core'
+import type { Output } from '../../Directive'
+
+import type { Directive, Input } from './types'
+
+export class Permute implements Directive {
+  public readonly targeted = false
+
+  private readonly discovery: Promise<Component>
+  private storage: Component | null = null
+
+  public constructor (value: null, discovery: Promise<Component>) {
+    schemas.remove.validate(value)
+
+    this.discovery = discovery
+  }
+
+  public async apply (storage: string, request: Input): Promise<Output> {
+    this.storage ??= await this.discovery
+
+    if (request.encoder === null)
+      throw new NotAcceptable()
+
+    const path = request.path
+    const list = await request.parse()
+    const input = { storage, path, list }
+    const error = await this.storage.invoke<Maybe<unknown>>('permute', { input })
+
+    if (error instanceof Error)
+      throw new NotFound()
+
+    return {}
+  }
+}

package/source/directives/octets/Store.ts

@@ -0,0 +1,158 @@
+import { Readable } from 'node:stream'
+import { posix } from 'node:path'
+import { match } from 'matchacho'
+import { promex } from '@toa.io/generic'
+import { BadRequest, UnsupportedMediaType } from '../../HTTP'
+import * as schemas from './schemas'
+import type { Maybe } from '@toa.io/types'
+import type { Entry } from '@toa.io/extensions.storages'
+import type { Remotes } from '../../Remotes'
+import type { ErrorType } from 'error-value'
+import type { Component } from '@toa.io/core'
+import type { Output } from '../../Directive'
+import type { Directive, Input } from './types'
+
+export class Store implements Directive {
+  public readonly targeted = false
+
+  private readonly accept: string | undefined
+  private readonly workflow: Workflow | undefined
+  private readonly discovery: Record<string, Promise<Component>> = {}
+  private readonly remotes: Remotes
+  private readonly components: Record<string, Component> = {}
+  private storage: Component | null = null
+
+  public constructor
+  (options: Options | null, discovery: Promise<Component>, remotes: Remotes) {
+    schemas.store.validate(options)
+
+    this.accept = match(options?.accept,
+      String, (value: string) => value,
+      Array, (types: string[]) => types.join(','),
+      undefined)
+
+    this.workflow = match(options?.workflow,
+      Array, (units: Unit[]) => units,
+      Object, (unit: Unit) => [unit],
+      undefined)
+
+    this.discovery.storage = discovery
+    this.remotes = remotes
+  }
+
+  public async apply (storage: string, request: Input): Promise<Output> {
+    this.storage ??= await this.discovery.storage
+
+    const input = { storage, request, accept: this.accept }
+    const entry = await this.storage.invoke('store', { input })
+
+    return match<Output>(entry,
+      Error, (error: ErrorType) => this.throw(error),
+      () => this.reply(request, storage, entry))
+  }
+
+  private reply (request: Input, storage: string, entry: Entry): Output {
+    const body = this.workflow === undefined
+      ? entry
+      : Readable.from(this.execute(request, storage, entry))
+
+    return { body }
+  }
+
+  private throw (error: ErrorType): never {
+    throw match(error.code,
+      'NOT_ACCEPTABLE', () => new UnsupportedMediaType(),
+      'TYPE_MISMATCH', () => new BadRequest(),
+      error)
+  }
+
+  /* eslint-disable no-useless-return, max-depth */
+
+  /**
+   * Execute workflow units sequentially, steps within a unit in parallel.
+   * Yield results as soon as they come.
+   *
+   * If you need to change this, it may take a while.
+   */
+  private async * execute (request: Input, storage: string, entry: Entry): AsyncGenerator {
+    yield entry
+
+    const path = posix.join(request.path, entry.id)
+    let interrupted = false
+
+    for (const unit of this.workflow as Workflow) {
+      if (interrupted)
+        break
+
+      const steps = Object.keys(unit)
+
+      // unit result promises queue
+      const results = Array.from(steps, promex<unknown>)
+      let next = 0
+
+      // execute steps in parallel
+      for (const step of steps)
+        // these promises are indirectly awaited in the yield loop
+        void (async () => {
+          const endpoint = unit[step]
+          const context: Context = { storage, path, entry }
+          const result = await this.call(endpoint, context)
+
+          if (interrupted)
+            return
+
+          // as a result is received, resolve the next promise from the queue
+          const promise = results[next++]
+
+          if (result instanceof Error) {
+            interrupted = true
+            promise.resolve({ error: { step, ...result } })
+
+            // cancel pending promises
+            results[next].resolve(null)
+          } else
+            promise.resolve({ [step]: result ?? null })
+        })().catch((e) => results[next].reject(e))
+
+      // yield results from the queue as they come
+      for (const promise of results) {
+        const result = await promise
+
+        if (result === null) // canceled promise
+          break
+        else
+          yield result
+      }
+    }
+  }
+
+  private async call (endpoint: string, context: Context): Promise<Maybe<unknown>> {
+    const [operation, component, namespace = 'default'] = endpoint.split('.').reverse()
+    const key = `${namespace}.${component}`
+
+    this.components[key] ??= await this.discover(key, namespace, component)
+
+    return await this.components[key].invoke(operation, { input: context })
+  }
+
+  private async discover (key: string, namespace: string, component: string): Promise<Component> {
+    if (this.discovery[key] === undefined)
+      this.discovery[key] = this.remotes.discover(namespace, component)
+
+    return await this.discovery[key]
+  }
+}
+
+type Unit = Record<string, string>
+type Workflow = Unit[]
+
+interface Options {
+  accept: string | string[]
+  workflow: Workflow | Unit
+}
+
+interface Context {
+  storage: string
+  path: string
+  entry: Entry
+}

package/source/directives/octets/index.ts

@@ -0,0 +1,3 @@
+import Family from './Family'
+
+export = Family

package/source/directives/octets/schemas.ts

@@ -0,0 +1,12 @@
+import { resolve } from 'node:path'
+import schemas from '@toa.io/schemas'
+
+const path = resolve(__dirname, '../../../schemas/octets')
+const namespace = schemas.namespace(path)
+
+export const context = namespace.schema('context')
+export const store = namespace.schema('store')
+export const fetch = namespace.schema('fetch')
+export const remove = namespace.schema('delete')
+export const list = namespace.schema('list')
+export const permute = namespace.schema('permute')

package/source/directives/octets/types.ts

@@ -0,0 +1,13 @@
+import type * as directive from '../../Directive'
+
+export interface Directive {
+  readonly targeted: boolean
+
+  apply: (storage: string, input: Input) => directive.Output | Promise<directive.Output>
+}
+
+export interface Extension {
+  octets?: string
+}
+
+export type Input = directive.Input & Extension

package/transpiled/Annotation.d.ts

@@ -0,0 +1,7 @@
+export interface Annotation {
+    host?: string;
+    class?: string;
+    annotations?: Record<string, string>;
+    debug: boolean;
+    '/'?: object;
+}

package/transpiled/Annotation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Annotation.js.map

package/transpiled/Annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Annotation.js","sourceRoot":"","sources":["../source/Annotation.ts"],"names":[],"mappings":""}

package/transpiled/Branch.d.ts

@@ -0,0 +1,7 @@
+import type * as RTD from './RTD/syntax';
+export interface Branch {
+    namespace: string;
+    component: string;
+    isolated: boolean;
+    node: RTD.Node;
+}

package/transpiled/Branch.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Branch.js.map

package/transpiled/Branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Branch.js","sourceRoot":"","sources":["../source/Branch.ts"],"names":[],"mappings":""}

package/transpiled/Composition.d.ts

@@ -0,0 +1,14 @@
+import { Connector } from '@toa.io/core';
+import { type Bootloader } from './Factory';
+export declare class Composition extends Connector {
+    private readonly boot;
+    constructor(boot: Bootloader);
+    protected open(): Promise<void>;
+    protected dispose(): void;
+}
+export declare function components(): Components;
+interface Components {
+    labels: string[];
+    paths: string[];
+}
+export {};

package/transpiled/Composition.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.components = exports.Composition = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@toa.io/core");
+class Composition extends core_1.Connector {
+    boot;
+    constructor(boot) {
+        super();
+        this.boot = boot;
+    }
+    async open() {
+        const paths = find();
+        const composition = await this.boot.composition(paths);
+        await composition.connect();
+        this.depends(composition);
+        console.info('Composition complete.');
+    }
+    dispose() {
+        console.info('Composition shutdown complete.');
+    }
+}
+exports.Composition = Composition;
+function find() {
+    return entries().map((entry) => (0, node_path_1.resolve)(ROOT, entry.name));
+}
+function entries() {
+    const entries = (0, node_fs_1.readdirSync)(ROOT, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory());
+}
+function components() {
+    const labels = [];
+    const paths = [];
+    for (const entry of entries()) {
+        labels.push(entry.name.replace('.', '-'));
+        paths.push((0, node_path_1.resolve)(ROOT, entry.name));
+    }
+    return { labels, paths };
+}
+exports.components = components;
+const ROOT = (0, node_path_1.resolve)(__dirname, '../components/');
+//# sourceMappingURL=Composition.js.map

package/transpiled/Composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Composition.js","sourceRoot":"","sources":["../source/Composition.ts"],"names":[],"mappings":";;;AAAA,qCAAkD;AAClD,yCAAmC;AACnC,uCAAwC;AAGxC,MAAa,WAAY,SAAQ,gBAAS;IACvB,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAEtD,MAAM,WAAW,CAAC,OAAO,EAAE,CAAA;QAE3B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAEzB,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACvC,CAAC;IAEkB,OAAO;QACxB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAChD,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,IAAI;IACX,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,OAAO;IACd,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;AACvD,CAAC;AAED,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACzC,KAAK,CAAC,IAAI,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;KACtC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1B,CAAC;AAVD,gCAUC;AAOD,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA"}

package/transpiled/Context.d.ts

@@ -0,0 +1,5 @@
+import { type Endpoint } from './Endpoint';
+import { type Directives } from './Directive';
+import { type Branch } from './Branch';
+import type * as RTD from './RTD';
+export type Context = RTD.Context<Endpoint, Directives, Branch>;

package/transpiled/Context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Context.js.map

package/transpiled/Context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../source/Context.ts"],"names":[],"mappings":""}

package/transpiled/Directive.d.ts

@@ -0,0 +1,32 @@
+import { type IncomingMessage, type OutgoingMessage } from './HTTP';
+import { type Remotes } from './Remotes';
+import type * as RTD from './RTD';
+export declare class Directives implements RTD.Directives<Directives> {
+    private readonly directives;
+    constructor(directives: DirectiveSet[]);
+    preflight(request: IncomingMessage, parameters: RTD.Parameter[]): Promise<Output>;
+    settle(request: IncomingMessage, response: OutgoingMessage): Promise<void>;
+    merge(directives: Directives): void;
+}
+export declare class DirectivesFactory implements RTD.DirectivesFactory<Directives> {
+    private readonly remtoes;
+    private readonly families;
+    private readonly mandatory;
+    constructor(families: Family[], remotes: Remotes);
+    create(declarations: RTD.syntax.Directive[]): Directives;
+}
+export declare const shortcuts: RTD.syntax.Shortcuts;
+export interface Family<TDirective = any, TExtension = any> {
+    readonly name: string;
+    readonly mandatory: boolean;
+    create: (name: string, value: any, remotes: Remotes) => TDirective;
+    preflight: (directives: TDirective[], request: IncomingMessage & TExtension, parameters: RTD.Parameter[]) => Output | Promise<Output>;
+    settle?: (directives: TDirective[], request: IncomingMessage & TExtension, response: OutgoingMessage) => void | Promise<void>;
+}
+interface DirectiveSet {
+    family: Family;
+    directives: any[];
+}
+export type Input = IncomingMessage;
+export type Output = OutgoingMessage | null;
+export {};

package/transpiled/Directive.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shortcuts = exports.DirectivesFactory = exports.Directives = void 0;
+class Directives {
+    directives;
+    constructor(directives) {
+        this.directives = directives;
+    }
+    async preflight(request, parameters) {
+        for (const directive of this.directives) {
+            const output = await directive.family.preflight(directive.directives, request, parameters);
+            if (output !== null) {
+                await this.settle(request, output);
+                return output;
+            }
+        }
+        return null;
+    }
+    async settle(request, response) {
+        for (const directive of this.directives)
+            if (directive.family.settle !== undefined)
+                await directive.family.settle(directive.directives, request, response);
+    }
+    merge(directives) {
+        this.directives.push(...directives.directives);
+    }
+}
+exports.Directives = Directives;
+class DirectivesFactory {
+    remtoes;
+    families = {};
+    mandatory = [];
+    constructor(families, remotes) {
+        for (const family of families) {
+            this.families[family.name] = family;
+            if (family.mandatory)
+                this.mandatory.push(family.name);
+        }
+        this.remtoes = remotes;
+    }
+    create(declarations) {
+        const groups = {};
+        const mandatory = new Set(this.mandatory);
+        declarations.sort((a, b) => (mandatory.has(b.family) ? 1 : 0) - (mandatory.has(a.family) ? 1 : 0));
+        for (const declaration of declarations) {
+            const family = this.families[declaration.family];
+            if (family === undefined)
+                throw new Error(`Directive family '${declaration.family}' not found.`);
+            const directive = family.create(declaration.name, declaration.value, this.remtoes);
+            groups[family.name] ??= [];
+            groups[family.name].push(directive);
+            mandatory.delete(family.name);
+        }
+        const sets = [];
+        for (const family of mandatory)
+            sets.push({
+                family: this.families[family],
+                directives: []
+            });
+        for (const [family, directives] of Object.entries(groups))
+            sets.push({
+                family: this.families[family],
+                directives
+            });
+        return new Directives(sets);
+    }
+}
+exports.DirectivesFactory = DirectivesFactory;
+exports.shortcuts = new Map([
+    ['anonymous', 'auth:anonymous'],
+    ['id', 'auth:id'],
+    ['role', 'auth:role'],
+    ['rule', 'auth:rule'],
+    ['incept', 'auth:incept']
+]);
+//# sourceMappingURL=Directive.js.map

package/transpiled/Directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Directive.js","sourceRoot":"","sources":["../source/Directive.ts"],"names":[],"mappings":"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"}

package/transpiled/Endpoint.d.ts

@@ -0,0 +1,20 @@
+import { type Component, type Reply } from '@toa.io/core';
+import { type Remotes } from './Remotes';
+import { Mapping } from './Mapping';
+import { type Context } from './Context';
+import type * as RTD from './RTD';
+import type * as http from './HTTP';
+export declare class Endpoint implements RTD.Endpoint<Endpoint> {
+    private readonly endpoint;
+    private readonly mapping;
+    private readonly discovery;
+    private remote;
+    constructor(endpoint: string, mapping: Mapping, discovery: Promise<Component>);
+    call(body: any, query: http.Query, parameters: RTD.Parameter[]): Promise<Reply>;
+    close(): Promise<void>;
+}
+export declare class EndpointsFactory implements RTD.EndpointsFactory<Endpoint> {
+    private readonly remotes;
+    constructor(remotes: Remotes);
+    create(method: RTD.syntax.Method, context: Context): Endpoint;
+}

package/transpiled/Endpoint.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndpointsFactory = exports.Endpoint = void 0;
+const Mapping_1 = require("./Mapping");
+class Endpoint {
+    endpoint;
+    mapping;
+    discovery;
+    remote = null;
+    constructor(endpoint, mapping, discovery) {
+        this.endpoint = endpoint;
+        this.mapping = mapping;
+        this.discovery = discovery;
+    }
+    async call(body, query, parameters) {
+        const request = this.mapping.fit(body, query, parameters);
+        this.remote ??= await this.discovery;
+        return await this.remote.invoke(this.endpoint, request);
+    }
+    async close() {
+        this.remote ??= await this.discovery;
+        await this.remote.disconnect(INTERRUPT);
+    }
+}
+exports.Endpoint = Endpoint;
+class EndpointsFactory {
+    remotes;
+    constructor(remotes) {
+        this.remotes = remotes;
+    }
+    create(method, context) {
+        if (method.mapping === undefined)
+            throw new Error('Cannot create Endpoint without mapping.');
+        const mapping = Mapping_1.Mapping.create(method.mapping.query);
+        const namespace = method.mapping.namespace ?? context.extension?.namespace;
+        const component = method.mapping.component ?? context.extension?.component;
+        if (namespace === undefined || component === undefined)
+            throw new Error('Annotation endpoints must be fully qualified.');
+        const discovery = this.remotes.discover(namespace, component);
+        return new Endpoint(method.mapping.endpoint, mapping, discovery);
+    }
+}
+exports.EndpointsFactory = EndpointsFactory;
+const INTERRUPT = true;
+//# sourceMappingURL=Endpoint.js.map

package/transpiled/Endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoint.js","sourceRoot":"","sources":["../source/Endpoint.ts"],"names":[],"mappings":";;;AAEA,uCAAmC;AAKnC,MAAa,QAAQ;IACF,QAAQ,CAAQ;IAChB,OAAO,CAAS;IAChB,SAAS,CAAoB;IACtC,MAAM,GAAqB,IAAI,CAAA;IAEvC,YAAoB,QAAgB,EAAE,OAAgB,EAAE,SAA6B;QACnF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAEM,KAAK,CAAC,IAAI,CAAE,IAAS,EAAE,KAAiB,EAAE,UAA2B;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QAEzD,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAEpC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,SAAS,CAAA;QAEpC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IACzC,CAAC;CACF;AAzBD,4BAyBC;AAED,MAAa,gBAAgB;IACV,OAAO,CAAS;IAEjC,YAAoB,OAAgB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAEM,MAAM,CAAE,MAAyB,EAAE,OAAgB;QACxD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAC9B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAE5D,MAAM,OAAO,GAAG,iBAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACpD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,SAAS,CAAA;QAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,SAAS,CAAA;QAE1E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;YACpD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAElE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAE7D,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAClE,CAAC;CACF;AAtBD,4CAsBC;AAED,MAAM,SAAS,GAAG,IAAI,CAAA"}

package/transpiled/Factory.d.ts

@@ -0,0 +1,10 @@
+import { syntax } from './RTD';
+import type { Connector, Locator, extensions } from '@toa.io/core';
+export declare class Factory implements extensions.Factory {
+    private readonly boot;
+    private readonly families;
+    constructor(boot: Bootloader);
+    tenant(locator: Locator, node: syntax.Node): Connector;
+    service(): Connector | null;
+}
+export type Bootloader = typeof import('@toa.io/boot');

package/transpiled/Factory.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Factory = void 0;
+const Tenant_1 = require("./Tenant");
+const Gateway_1 = require("./Gateway");
+const Remotes_1 = require("./Remotes");
+const RTD_1 = require("./RTD");
+const HTTP_1 = require("./HTTP");
+const Endpoint_1 = require("./Endpoint");
+const directives = __importStar(require("./directives"));
+const Directive_1 = require("./Directive");
+const Composition_1 = require("./Composition");
+const root = __importStar(require("./root"));
+class Factory {
+    boot;
+    families;
+    constructor(boot) {
+        this.boot = boot;
+        this.families = directives.families;
+    }
+    tenant(locator, node) {
+        const broadcast = this.boot.bindings.broadcast(CHANNEL, locator.id);
+        return new Tenant_1.Tenant(broadcast, locator, node);
+    }
+    service() {
+        const debug = process.env.TOA_EXPOSITION_DEBUG === '1';
+        const broadcast = this.boot.bindings.broadcast(CHANNEL);
+        const server = HTTP_1.Server.create({ methods: RTD_1.syntax.verbs, debug });
+        const remotes = new Remotes_1.Remotes(this.boot);
+        const node = root.resolve();
+        const methods = new Endpoint_1.EndpointsFactory(remotes);
+        const directives = new Directive_1.DirectivesFactory(this.families, remotes);
+        const tree = new RTD_1.Tree(node, methods, directives);
+        const composition = new Composition_1.Composition(this.boot);
+        const gateway = new Gateway_1.Gateway(broadcast, server, tree);
+        gateway.depends(remotes);
+        gateway.depends(composition);
+        return gateway;
+    }
+}
+exports.Factory = Factory;
+const CHANNEL = 'exposition';
+//# sourceMappingURL=Factory.js.map

package/transpiled/Factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qCAAiC;AACjC,uCAAmC;AACnC,uCAAmC;AACnC,+BAAoC;AACpC,iCAA+B;AAC/B,yCAA4D;AAC5D,yDAA0C;AAC1C,2CAA6E;AAC7E,+CAA2C;AAC3C,6CAA8B;AAG9B,MAAa,OAAO;IACD,IAAI,CAAY;IAChB,QAAQ,CAAU;IAEnC,YAAoB,IAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAA;IACrC,CAAC;IAEM,MAAM,CAAE,OAAgB,EAAE,IAAiB;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QAEnE,OAAO,IAAI,eAAM,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAC7C,CAAC;IAEM,OAAO;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,CAAA;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,aAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,YAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9D,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAC3B,MAAM,OAAO,GAAG,IAAI,2BAAgB,CAAC,OAAO,CAAC,CAAA;QAC7C,MAAM,UAAU,GAAG,IAAI,6BAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAChE,MAAM,IAAI,GAAG,IAAI,UAAI,CAAuB,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;QAEtE,MAAM,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;QAEpD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACxB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE5B,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AAjCD,0BAiCC;AAED,MAAM,OAAO,GAAG,YAAY,CAAA"}

package/transpiled/Gateway.d.ts

@@ -0,0 +1,19 @@
+import { type bindings, Connector } from '@toa.io/core';
+import * as http from './HTTP';
+import { type Tree } from './RTD';
+import { type Label } from './discovery';
+import { type Endpoint } from './Endpoint';
+import { type Directives } from './Directive';
+export declare class Gateway extends Connector {
+    private readonly broadcast;
+    private readonly tree;
+    constructor(broadcast: Broadcast, server: http.Server, tree: Tree<Endpoint, Directives>);
+    protected open(): Promise<void>;
+    protected dispose(): void;
+    private process;
+    private call;
+    private discover;
+    private merge;
+}
+type Broadcast = bindings.Broadcast<Label>;
+export {};