@toa.io/extensions.realtime 1.0.0-alpha.26 → 1.0.0-alpha.263

package/source/extension.ts

@@ -0,0 +1,82 @@
+import { encode } from '@toa.io/generic'
+import { components } from './Composition'
+import type { Dependency, Instances, Resources, Service } from '@toa.io/operations'
+
+export const standalone = true
+export { components } from './Composition'
+
+export function deployment (instances: Instances<Declaration>, annotation?: Declaration & Annotation): Dependency {
+  const routes = []
+  const { resources, ...annotatedRoutes } = annotation ?? {}
+  const labels = components().labels
+
+  if (annotatedRoutes !== undefined)
+    routes.push(...parse(annotatedRoutes))
+
+  for (const instance of instances) {
+    const completed: Declaration = {}
+
+    for (const [key, value] of Object.entries(instance.manifest)) {
+      const event = instance.locator.id + '.' + key
+
+      completed[event] = value
+    }
+
+    routes.push(...parse(completed))
+  }
+
+  const service: Service = {
+    group: 'realtime',
+    name: 'streams',
+
+    version: require('../package.json').version,
+    components: labels,
+    resources,
+    variables: [{
+      name: 'TOA_REALTIME',
+      value: encode(routes)
+    }]
+  }
+
+  return { services: [service] }
+}
+
+export function parse (declaration: Declaration): Route[] {
+  const routes: Route[] = []
+
+  for (const [event, value] of Object.entries(declaration))
+    if (isObject(value)) {
+      const properties = Array.isArray(value.key) ? value.key : [value.key]
+
+      routes.push({ event, properties, expose: value.expose })
+    } else {
+      const properties = Array.isArray(value) ? value : [value]
+
+      routes.push({ event, properties })
+    }
+
+  return routes
+}
+
+function isObject (value: Entry): value is RouteDeclaration {
+  return typeof value === 'object' && !Array.isArray(value)
+}
+
+export type Entry = string | string[] | RouteDeclaration
+
+export type Declaration = Record<string, Entry>
+
+export interface RouteDeclaration {
+  key: string | string[]
+  expose?: string[]
+}
+
+export interface Route {
+  event: string
+  properties: string[]
+  expose?: string[]
+}
+
+interface Annotation {
+  resources?: Resources
+}

package/source/index.ts

@@ -1 +1,2 @@
 export { Factory } from './Factory'
+export * from './extension'

package/transpiled/Composition.d.ts

@@ -4,5 +4,11 @@ export declare class Composition extends Connector {
     private readonly boot;
     constructor(boot: Bootloader);
     protected open(): Promise<void>;
-    protected dispose(): void;
 }
+export declare function find(): string[];
+export declare function components(): Components;
+interface Components {
+    labels: string[];
+    paths: string[];
+}
+export {};

package/transpiled/Composition.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Composition = void 0;
+exports.components = exports.find = 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");
@@ -15,19 +15,26 @@ class Composition extends core_1.Connector {
         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));
 }
+exports.find = find;
 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

@@ -1 +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,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA"}
+{"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;IAC3B,CAAC;CACF;AAhBD,kCAgBC;AAED,SAAgB,IAAI;IAClB,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5D,CAAC;AAFD,oBAEC;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,CAAC;QAC9B,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;IACvC,CAAC;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/Factory.js

@@ -21,7 +21,7 @@ class Factory {
     }
     async discovery() {
         const locator = new core_1.Locator('streams', 'realtime');
-        return await this.boot.remote(locator);
+        return await this.boot.remote(locator, { service: 'realtime' });
     }
 }
 exports.Factory = Factory;

package/transpiled/Factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;AAAA,uCAAuE;AACvE,yCAAqC;AACrC,+CAA2C;AAC3C,qCAAiC;AAEjC,MAAa,OAAO;IACD,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAClC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAEhD,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE7B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,MAAM,OAAO,GAAG,IAAI,cAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAElD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC;CACF;AAxBD,0BAwBC"}
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;AAAA,uCAAuE;AACvE,yCAAqC;AACrC,+CAA2C;AAC3C,qCAAiC;AAEjC,MAAa,OAAO;IACD,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAClC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QAEhD,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACxB,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE7B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,MAAM,OAAO,GAAG,IAAI,cAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAElD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;IACjE,CAAC;CACF;AAxBD,0BAwBC"}

package/transpiled/Realtime.d.ts

@@ -7,4 +7,5 @@ export declare class Realtime extends Connector {
     protected open(): Promise<void>;
     protected dispose(): void;
     private push;
+    private deliver;
 }

package/transpiled/Realtime.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Realtime = void 0;
+const openspan_1 = require("openspan");
 const core_1 = require("@toa.io/core");
 class Realtime extends core_1.Connector {
     discovery;
@@ -14,13 +15,38 @@ class Realtime extends core_1.Connector {
         this.streams = await this.discovery;
         this.depends(this.streams);
         await this.streams.connect();
-        console.log('Realtime has started.');
+        openspan_1.console.info('Realtime service started');
     }
     dispose() {
-        console.log('Realtime shutdown complete.');
+        openspan_1.console.info('Realtime service shutdown complete');
     }
-    push(event) {
-        void this.streams?.invoke('push', { input: event });
+    push({ telemetry, ...event }) {
+        const processing = telemetry === null
+            ? this.deliver(event)
+            : (0, openspan_1.run)(telemetry, async () => await this.deliver(event));
+        void processing.catch((error) => openspan_1.console.error('Realtime push failed', error));
+    }
+    async deliver(event) {
+        /*
+         * The delivery span is created on behalf of the messaging destination
+         * (same as the core Receiver), so that service graphs display the fan-out:
+         * producer -> destination -> realtime
+         */
+        const delivery = {
+            name: `${event.event} deliver`,
+            kind: 'producer',
+            service: event.event,
+            attributes: { 'messaging.destination.name': event.event }
+        };
+        const options = {
+            name: `${event.event} push`,
+            kind: 'consumer',
+            service: 'realtime',
+            attributes: { 'messaging.destination.name': event.event }
+        };
+        await openspan_1.console.span(delivery, async () => await openspan_1.console.span(options, async () => {
+            await this.streams?.invoke('push', { input: event });
+        }));
     }
 }
 exports.Realtime = Realtime;

package/transpiled/Realtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"Realtime.js","sourceRoot":"","sources":["../source/Realtime.ts"],"names":[],"mappings":";;;AAAA,uCAAwD;AAGxD,MAAa,QAAS,SAAQ,gBAAS;IACpB,SAAS,CAAoB;IACtC,OAAO,GAAqB,IAAI,CAAA;IAExC,YAAoB,MAAc,EAAE,SAA6B;QAC/D,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAChD,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAE1B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QAE5B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;IACtC,CAAC;IAEkB,OAAO;QACxB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;IAC5C,CAAC;IAEO,IAAI,CAAE,KAAY;QACxB,KAAK,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACrD,CAAC;CACF;AA5BD,4BA4BC"}
+{"version":3,"file":"Realtime.js","sourceRoot":"","sources":["../source/Realtime.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AACvC,uCAAwD;AAIxD,MAAa,QAAS,SAAQ,gBAAS;IACpB,SAAS,CAAoB;IACtC,OAAO,GAAqB,IAAI,CAAA;IAExC,YAAoB,MAAc,EAAE,SAA6B;QAC/D,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAChD,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAE1B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;QAE5B,kBAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IAC1C,CAAC;IAEkB,OAAO;QACxB,kBAAO,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAA;IACpD,CAAC;IAEO,IAAI,CAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAQ;QACzC,MAAM,UAAU,GAAG,SAAS,KAAK,IAAI;YACnC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,CAAC,CAAC,IAAA,cAAG,EAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;QAEzD,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAA;IAChF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAE,KAA8B;QACnD;;;;WAIG;QACH,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,UAAU;YAC9B,IAAI,EAAE,UAAmB;YACzB,OAAO,EAAE,KAAK,CAAC,KAAK;YACpB,UAAU,EAAE,EAAE,4BAA4B,EAAE,KAAK,CAAC,KAAK,EAAE;SAC1D,CAAA;QAED,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,OAAO;YAC3B,IAAI,EAAE,UAAmB;YACzB,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,EAAE,4BAA4B,EAAE,KAAK,CAAC,KAAK,EAAE;SAC1D,CAAA;QAED,MAAM,kBAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,kBAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YAC9E,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACtD,CAAC,CAAC,CAAC,CAAA;IACL,CAAC;CACF;AAzDD,4BAyDC"}

package/transpiled/Receiver.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="node" />
+import { Connector, type Message } from '@toa.io/core';
+import type { SpanContext } from 'openspan';
+import type { Readable } from 'node:stream';
+export declare class Receiver extends Connector {
+    private readonly event;
+    private readonly properties;
+    private readonly expose?;
+    private readonly stream;
+    constructor({ event, properties, stream, expose }: {
+        event: string;
+        properties: string[];
+        stream: Readable;
+        expose?: string[];
+    });
+    receive(message: Message<Record<string, string>>): void;
+    private process;
+    private fit;
+    private push;
+}
+export interface Push {
+    key: string;
+    event: string;
+    data: Record<string, string>;
+    telemetry: SpanContext | null;
+}

package/transpiled/Receiver.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Receiver = void 0;
+const openspan_1 = require("openspan");
+const core_1 = require("@toa.io/core");
+class Receiver extends core_1.Connector {
+    event;
+    properties;
+    expose;
+    stream;
+    constructor({ event, properties, stream, expose }) {
+        super();
+        this.event = event;
+        this.properties = properties;
+        this.expose = expose;
+        this.stream = stream;
+    }
+    receive(message) {
+        // the push continues the trace from the producer
+        const telemetry = message.telemetry === undefined ? null : (0, openspan_1.decode)(message.telemetry);
+        if (telemetry === null)
+            this.process(message, telemetry);
+        else
+            (0, openspan_1.run)(telemetry, () => this.process(message, telemetry));
+    }
+    process(message, telemetry) {
+        const data = this.fit(message.payload);
+        for (const property of this.properties) {
+            const key = message.payload[property];
+            if (key === undefined) {
+                openspan_1.console.debug('Event does not contain key property', { property, event: this.event });
+                continue;
+            }
+            if (Array.isArray(key))
+                // eslint-disable-next-line max-depth
+                for (const k of key)
+                    this.push(k, data, telemetry);
+            else
+                this.push(key, data, telemetry);
+        }
+    }
+    fit(payload) {
+        if (this.expose === undefined)
+            return payload;
+        const entries = Object.entries(payload)
+            .filter(([key]) => this.expose.includes(key));
+        return Object.fromEntries(entries);
+    }
+    push(key, data, telemetry) {
+        if (key === null || typeof key === 'undefined') {
+            openspan_1.console.debug('Key is null or undefined, skipping', { key, event: this.event });
+            return;
+        }
+        openspan_1.console.debug('Pushing event to stream', { key, event: this.event, data });
+        this.stream.push({ key, event: this.event, data, telemetry });
+    }
+}
+exports.Receiver = Receiver;
+//# sourceMappingURL=Receiver.js.map

package/transpiled/Receiver.js.map

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

package/transpiled/Routes.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="node" />
 import { Readable } from 'node:stream';
 import { Connector } from '@toa.io/core';
-import { type Bootloader } from './Factory';
+import type { Route } from './extension';
+import type { Bootloader } from './Factory';
 export declare class Routes extends Connector {
     events: Events;
     private readonly boot;
@@ -9,14 +10,9 @@ export declare class Routes extends Connector {
     private static read;
     open(): Promise<void>;
     close(): Promise<void>;
-    private getReceiver;
 }
 declare class Events extends Readable {
     constructor();
     _read(): void;
 }
-export interface Route {
-    event: string;
-    properties: string[];
-}
-export {};
+export type { Route };

package/transpiled/Routes.js

@@ -2,8 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Routes = void 0;
 const node_stream_1 = require("node:stream");
+const openspan_1 = require("openspan");
 const core_1 = require("@toa.io/core");
 const generic_1 = require("@toa.io/generic");
+const Receiver_1 = require("./Receiver");
 class Routes extends core_1.Connector {
     events = new Events();
     boot;
@@ -19,8 +21,8 @@ class Routes extends core_1.Connector {
     async open() {
         const routes = Routes.read();
         const creating = [];
-        for (const { event, properties } of routes) {
-            const consumer = this.boot.receive(event, this.getReceiver(event, properties));
+        for (const { event, properties, expose } of routes) {
+            const consumer = this.boot.receive(event, new Receiver_1.Receiver({ event, properties, stream: this.events, expose }));
             creating.push(consumer);
         }
         const consumers = await Promise.all(creating);
@@ -28,24 +30,10 @@ class Routes extends core_1.Connector {
         const connecting = consumers.map((consumer) => consumer.connect());
         await Promise.all(connecting);
         this.depends(consumers);
-        console.log(`Event sources (${creating.length}) connected.`);
+        openspan_1.console.info('Event sources connected', { count: creating.length });
     }
     async close() {
-        console.log('Event sources disconnected.');
-    }
-    getReceiver(event, properties) {
-        return {
-            receive: (message) => {
-                for (const property of properties) {
-                    const key = message.payload[property];
-                    if (key === undefined) {
-                        console.error(`Event '${event}' does not contain the '${property}' property.`);
-                        return;
-                    }
-                    this.events.push({ key, event, data: message.payload });
-                }
-            }
-        };
+        openspan_1.console.info('Event sources disconnected');
     }
 }
 exports.Routes = Routes;

package/transpiled/Routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"Routes.js","sourceRoot":"","sources":["../source/Routes.ts"],"names":[],"mappings":";;;AAAA,6CAAsC;AACtC,uCAAsD;AACtD,6CAAwC;AAGxC,MAAa,MAAO,SAAQ,gBAAS;IAC5B,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA;IAEX,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEO,MAAM,CAAC,IAAI;QACjB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS;YACxC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAEhD,OAAO,IAAA,gBAAM,EAAU,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAClD,CAAC;IAEe,KAAK,CAAC,IAAI;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;QAC5B,MAAM,QAAQ,GAAG,EAAE,CAAA;QAEnB,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,MAAM,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;YAE9E,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzB,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE7C,qEAAqE;QACrE,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QAElE,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAEvB,OAAO,CAAC,GAAG,CAAC,kBAAkB,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAA;IAC9D,CAAC;IAEe,KAAK,CAAC,KAAK;QACzB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;IAC5C,CAAC;IAEO,WAAW,CAAE,KAAa,EAAE,UAAoB;QACtD,OAAO;YACL,OAAO,EAAE,CAAC,OAAwC,EAAE,EAAE;gBACpD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;oBAClC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;oBAErC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;wBACtB,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,2BAA2B,QAAQ,aAAa,CAAC,CAAA;wBAE9E,OAAM;oBACR,CAAC;oBAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;gBACzD,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;CACF;AA5DD,wBA4DC;AAED,MAAM,MAAO,SAAQ,sBAAQ;IAC3B;QACE,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC;IAEe,KAAK;IACrB,CAAC;CACF"}
+{"version":3,"file":"Routes.js","sourceRoot":"","sources":["../source/Routes.ts"],"names":[],"mappings":";;;AAAA,6CAAsC;AACtC,uCAAkC;AAClC,uCAAwC;AACxC,6CAAwC;AACxC,yCAAqC;AAIrC,MAAa,MAAO,SAAQ,gBAAS;IAC5B,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA;IAEX,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEO,MAAM,CAAC,IAAI;QACjB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS;YACxC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAEhD,OAAO,IAAA,gBAAM,EAAU,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAClD,CAAC;IAEe,KAAK,CAAC,IAAI;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;QAC5B,MAAM,QAAQ,GAAG,EAAE,CAAA;QAEnB,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,mBAAQ,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YAE3G,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzB,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE7C,qEAAqE;QACrE,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QAElE,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAEvB,kBAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACrE,CAAC;IAEe,KAAK,CAAC,KAAK;QACzB,kBAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;IAC5C,CAAC;CACF;AA1CD,wBA0CC;AAED,MAAM,MAAO,SAAQ,sBAAQ;IAC3B;QACE,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7B,CAAC;IAEe,KAAK;IACrB,CAAC;CACF"}

package/transpiled/extension.d.ts

@@ -0,0 +1,19 @@
+import type { Dependency, Instances, Resources } from '@toa.io/operations';
+export declare const standalone = true;
+export { components } from './Composition';
+export declare function deployment(instances: Instances<Declaration>, annotation?: Declaration & Annotation): Dependency;
+export declare function parse(declaration: Declaration): Route[];
+export type Entry = string | string[] | RouteDeclaration;
+export type Declaration = Record<string, Entry>;
+export interface RouteDeclaration {
+    key: string | string[];
+    expose?: string[];
+}
+export interface Route {
+    event: string;
+    properties: string[];
+    expose?: string[];
+}
+interface Annotation {
+    resources?: Resources;
+}

package/transpiled/extension.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = exports.deployment = exports.components = exports.standalone = void 0;
+const generic_1 = require("@toa.io/generic");
+const Composition_1 = require("./Composition");
+exports.standalone = true;
+var Composition_2 = require("./Composition");
+Object.defineProperty(exports, "components", { enumerable: true, get: function () { return Composition_2.components; } });
+function deployment(instances, annotation) {
+    const routes = [];
+    const { resources, ...annotatedRoutes } = annotation ?? {};
+    const labels = (0, Composition_1.components)().labels;
+    if (annotatedRoutes !== undefined)
+        routes.push(...parse(annotatedRoutes));
+    for (const instance of instances) {
+        const completed = {};
+        for (const [key, value] of Object.entries(instance.manifest)) {
+            const event = instance.locator.id + '.' + key;
+            completed[event] = value;
+        }
+        routes.push(...parse(completed));
+    }
+    const service = {
+        group: 'realtime',
+        name: 'streams',
+        version: require('../package.json').version,
+        components: labels,
+        resources,
+        variables: [{
+                name: 'TOA_REALTIME',
+                value: (0, generic_1.encode)(routes)
+            }]
+    };
+    return { services: [service] };
+}
+exports.deployment = deployment;
+function parse(declaration) {
+    const routes = [];
+    for (const [event, value] of Object.entries(declaration))
+        if (isObject(value)) {
+            const properties = Array.isArray(value.key) ? value.key : [value.key];
+            routes.push({ event, properties, expose: value.expose });
+        }
+        else {
+            const properties = Array.isArray(value) ? value : [value];
+            routes.push({ event, properties });
+        }
+    return routes;
+}
+exports.parse = parse;
+function isObject(value) {
+    return typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=extension.js.map

package/transpiled/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../source/extension.ts"],"names":[],"mappings":";;;AAAA,6CAAwC;AACxC,+CAA0C;AAG7B,QAAA,UAAU,GAAG,IAAI,CAAA;AAC9B,6CAA0C;AAAjC,yGAAA,UAAU,OAAA;AAEnB,SAAgB,UAAU,CAAE,SAAiC,EAAE,UAAqC;IAClG,MAAM,MAAM,GAAG,EAAE,CAAA;IACjB,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,GAAG,UAAU,IAAI,EAAE,CAAA;IAC1D,MAAM,MAAM,GAAG,IAAA,wBAAU,GAAE,CAAC,MAAM,CAAA;IAElC,IAAI,eAAe,KAAK,SAAS;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAA;IAExC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAgB,EAAE,CAAA;QAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,CAAA;YAE7C,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;QAC1B,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,SAAS;QAEf,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO;QAC3C,UAAU,EAAE,MAAM;QAClB,SAAS;QACT,SAAS,EAAE,CAAC;gBACV,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,IAAA,gBAAM,EAAC,MAAM,CAAC;aACtB,CAAC;KACH,CAAA;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAA;AAChC,CAAC;AAlCD,gCAkCC;AAED,SAAgB,KAAK,CAAE,WAAwB;IAC7C,MAAM,MAAM,GAAY,EAAE,CAAA;IAE1B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QACtD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAErE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;YAEzD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;QACpC,CAAC;IAEH,OAAO,MAAM,CAAA;AACf,CAAC;AAfD,sBAeC;AAED,SAAS,QAAQ,CAAE,KAAY;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC3D,CAAC"}

package/transpiled/index.d.ts

@@ -1 +1,2 @@
 export { Factory } from './Factory';
+export * from './extension';

package/transpiled/index.js

@@ -1,6 +1,21 @@
 "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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Factory = void 0;
 var Factory_1 = require("./Factory");
 Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
+__exportStar(require("./extension"), exports);
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAChB,8CAA2B"}