@toa.io/extensions.exposition 1.0.0-alpha.32 → 1.0.0-alpha.320

package/transpiled/exceptions.js

@@ -1,45 +1,42 @@
-"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.rethrow = void 0;
-const matchacho_1 = require("matchacho");
-const http = __importStar(require("./HTTP"));
-const HTTP_1 = require("./HTTP");
-function rethrow(exception) {
-    if (exception instanceof HTTP_1.Exception)
+import { match } from 'matchacho';
+import { console } from 'openspan';
+import * as http from './HTTP/index.js';
+import { Exception as HTTPException } from './HTTP/index.js';
+export function rethrow(exception) {
+    if (exception instanceof HTTPException)
         throw exception;
     // see /runtime/core/src/exceptions.js
-    throw (0, matchacho_1.match)(exception.code, badRequest, () => new http.BadRequest(exception.message), 302, NOT_FOUND, 303, PRECONDITION_FAILED, 306, () => new http.Conflict(), () => {
-        console.error(exception);
+    throw match(exception.code, badRequest, () => new http.BadRequest(exception.message), CORE_EXCEPTIONS.StateNotFound, NOT_FOUND, CORE_EXCEPTIONS.StatePrecondition, PRECONDITION_FAILED, 
+    // a stream token names a point the storage no longer holds
+    CORE_EXCEPTIONS.StateHistory, GONE, CORE_EXCEPTIONS.Duplicate, CONFLICT, CORE_EXCEPTIONS.StateConcurrency, CONFLICT, CORE_EXCEPTIONS.EntityGuard, CONFLICT, 
+    // nothing holds the name the route carried
+    CORE_EXCEPTIONS.Addressee, NOT_FOUND, 
+    // the process holding it did not answer in time
+    CORE_EXCEPTIONS.Abandoned, GATEWAY_TIMEOUT, 
+    // nothing answered at the address of the component a streamed call was made to
+    CORE_EXCEPTIONS.Unreachable, SERVICE_UNAVAILABLE, () => {
+        console.error('Request processing exception', exception);
         return exception;
     });
 }
-exports.rethrow = rethrow;
 function badRequest(code) {
     return (code >= 200 && code < 210) || code === 221;
 }
 const NOT_FOUND = new http.NotFound();
 const PRECONDITION_FAILED = new http.PreconditionFailed();
+const GONE = new http.Gone();
+const CONFLICT = new http.Conflict();
+const GATEWAY_TIMEOUT = new http.GatewayTimeout();
+const SERVICE_UNAVAILABLE = new http.ServiceUnavailable();
+const CORE_EXCEPTIONS = {
+    StateNotFound: 302,
+    StatePrecondition: 303,
+    StateHistory: 308,
+    StateConcurrency: 304,
+    EntityGuard: 213,
+    Duplicate: 306,
+    Addressee: 403,
+    Abandoned: 404,
+    Unreachable: 407
+};
 //# sourceMappingURL=exceptions.js.map

package/transpiled/exceptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../source/exceptions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAAiC;AACjC,6CAA8B;AAC9B,iCAAmD;AAGnD,SAAgB,OAAO,CAAE,SAAoC;IAC3D,IAAI,SAAS,YAAY,gBAAa;QACpC,MAAM,SAAS,CAAA;IAEjB,sCAAsC;IACtC,MAAM,IAAA,iBAAK,EAAC,SAAS,CAAC,IAAI,EACxB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,EACxD,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,mBAAmB,EACxB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,EAC9B,GAAG,EAAE;QACH,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAExB,OAAO,SAAS,CAAA;IAClB,CAAC,CAAC,CAAA;AACN,CAAC;AAfD,0BAeC;AAED,SAAS,UAAU,CAAE,IAAY;IAC/B,OAAO,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,CAAA;AACpD,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;AACrC,MAAM,mBAAmB,GAAG,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../source/exceptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG5D,MAAM,UAAU,OAAO,CAAC,SAAoC;IAC1D,IAAI,SAAS,YAAY,aAAa;QAAE,MAAM,SAAS,CAAA;IAEvD,sCAAsC;IACtC,MAAM,KAAK,CACT,SAAS,CAAC,IAAI,EACd,UAAU,EACV,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,EAC5C,eAAe,CAAC,aAAa,EAC7B,SAAS,EACT,eAAe,CAAC,iBAAiB,EACjC,mBAAmB;IACnB,2DAA2D;IAC3D,eAAe,CAAC,YAAY,EAC5B,IAAI,EACJ,eAAe,CAAC,SAAS,EACzB,QAAQ,EACR,eAAe,CAAC,gBAAgB,EAChC,QAAQ,EACR,eAAe,CAAC,WAAW,EAC3B,QAAQ;IACR,2CAA2C;IAC3C,eAAe,CAAC,SAAS,EACzB,SAAS;IACT,gDAAgD;IAChD,eAAe,CAAC,SAAS,EACzB,eAAe;IACf,+EAA+E;IAC/E,eAAe,CAAC,WAAW,EAC3B,mBAAmB,EACnB,GAAG,EAAE;QACH,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,SAAS,CAAC,CAAA;QAExD,OAAO,SAAS,CAAA;IAClB,CAAC,CACF,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,CAAA;AACpD,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;AACrC,MAAM,mBAAmB,GAAG,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAA;AACzD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;AAC5B,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;AACpC,MAAM,eAAe,GAAG,IAAI,IAAI,CAAC,cAAc,EAAE,CAAA;AACjD,MAAM,mBAAmB,GAAG,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAA;AAEzD,MAAM,eAAe,GAAG;IACtB,aAAa,EAAE,GAAG;IAClB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;IACjB,gBAAgB,EAAE,GAAG;IACrB,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,GAAG;CACjB,CAAA"}

package/transpiled/index.d.ts

@@ -1,5 +1,5 @@
-export { manifest } from './manifest';
-export { deployment } from './deployment';
-export { components } from './Composition';
-export { Factory } from './Factory';
-export type { Remotes } from './Remotes';
+export { components } from './Composition.ts';
+export { Factory } from './Factory.ts';
+export type { Remotes } from './Remotes.ts';
+export type { Claims, Identity } from './userland.ts';
+export type * as octets from './octets.d.ts';

package/transpiled/index.js

@@ -1,12 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Factory = exports.components = exports.deployment = exports.manifest = void 0;
-var manifest_1 = require("./manifest");
-Object.defineProperty(exports, "manifest", { enumerable: true, get: function () { return manifest_1.manifest; } });
-var deployment_1 = require("./deployment");
-Object.defineProperty(exports, "deployment", { enumerable: true, get: function () { return deployment_1.deployment; } });
-var Composition_1 = require("./Composition");
-Object.defineProperty(exports, "components", { enumerable: true, get: function () { return Composition_1.components; } });
-var Factory_1 = require("./Factory");
-Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
+export { components } from './Composition.js';
+export { Factory } from './Factory.js';
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;AAAA,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AACnB,6CAA0C;AAAjC,yGAAA,UAAU,OAAA;AACnB,qCAAmC;AAA1B,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/io.d.ts

@@ -1,3 +1,3 @@
-import type { Context, OutgoingMessage } from './HTTP';
+import type { Context, OutgoingMessage } from './HTTP/index.ts';
 export type Input = Context;
 export type Output = OutgoingMessage | null;

package/transpiled/io.js

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

package/transpiled/measurements.d.ts

@@ -0,0 +1,22 @@
+import type { Measure } from 'openspan';
+/** What a request that matched no route is labelled, so a flood of them is one series. */
+export declare const NONE = "none";
+/**
+ * The labels are the request's own object, filled in when the route is known — which is after the
+ * span opens and before it completes, since routing happens inside it.
+ */
+export declare function request(method?: string): Measure & {
+    labels: Labels;
+};
+/**
+ * The status is written onto the request's own labels rather than into a copy of them: the
+ * object is the request's and dies with it, and the histogram that carries it reads the two
+ * labels it declared and nothing else.
+ */
+export declare function answered(labels: Labels, status: number): void;
+export interface Labels extends Record<string, unknown> {
+    method: string;
+    route: string;
+    /** written when the reply is answered, which is after the histogram has read the rest */
+    status?: number;
+}

package/transpiled/measurements.js

@@ -0,0 +1,37 @@
+import { registry } from 'openspan';
+/**
+ * What the gateway measures.
+ *
+ * `status` is on the counter and not on the histogram: routes by methods by statuses is the widest
+ * label product in a deployment, and a histogram multiplies whatever it is given by its buckets.
+ * Latency per route and per method is read; latency per status almost never is, while the count
+ * per status is read constantly.
+ */
+const meters = registry();
+/** A request answered over the network, so the ladder is a web request's. */
+const DURATIONS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+const duration = meters.histogram('toa.exposition.request.duration', { buckets: DURATIONS, unit: 's' }, { method: null, route: null });
+const responses = meters.counter('toa.exposition.responses', {
+    method: null,
+    route: null,
+    status: null
+});
+/** What a request that matched no route is labelled, so a flood of them is one series. */
+export const NONE = 'none';
+/**
+ * The labels are the request's own object, filled in when the route is known — which is after the
+ * span opens and before it completes, since routing happens inside it.
+ */
+export function request(method = 'GET') {
+    return { histogram: duration, labels: { method, route: NONE } };
+}
+/**
+ * The status is written onto the request's own labels rather than into a copy of them: the
+ * object is the request's and dies with it, and the histogram that carries it reads the two
+ * labels it declared and nothing else.
+ */
+export function answered(labels, status) {
+    labels.status = status;
+    responses.add(1, labels);
+}
+//# sourceMappingURL=measurements.js.map

package/transpiled/measurements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurements.js","sourceRoot":"","sources":["../source/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGnC;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAA;AAEzB,6EAA6E;AAC7E,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;AAE3E,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAC/B,iCAAiC,EACjC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EACjC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAC9B,CAAA;AAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,0BAA0B,EAAE;IAC3D,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;CACb,CAAC,CAAA;AAEF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAA;AAE1B;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAM,GAAG,KAAK;IACpC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAA;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,MAAc;IACrD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IAEtB,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AAC1B,CAAC"}

package/transpiled/realtime/Destination.d.ts

@@ -0,0 +1,24 @@
+import { Connector, type Locator } from '@toa.io/core';
+import type { Route } from '@toa.io/definitions/extensions.exposition/realtime';
+import type { outbox } from '@toa.io/core/types';
+/**
+ * Where a component's routed events go: the stream of each of their keys, and its channel. Each
+ * event of a row is rendered by the component's own condition and payload, fitted to what its
+ * route exposes, and written in one call per Redis its keys are kept on — to the streams of them
+ * that exist, which are the ones that are consumed.
+ *
+ * At least once: a row written again by the pump is written to the streams again.
+ */
+export declare class Destination extends Connector implements outbox.Destination {
+    readonly name = "realtime";
+    readonly renders: string[];
+    rendering?: outbox.Rendering;
+    private readonly locator;
+    private readonly routes;
+    private shards;
+    constructor(locator: Locator, routes: Route[]);
+    emit(row: outbox.Row): Promise<void>;
+    protected open(): Promise<void>;
+    protected close(): Promise<void>;
+    private route;
+}

package/transpiled/realtime/Destination.js

@@ -0,0 +1,83 @@
+import { console } from 'openspan';
+import { Connector } from '@toa.io/core';
+import { APPEND, MAXLEN, Shards, shard } from './redis.js';
+import * as measure from './measurements.js';
+/**
+ * Where a component's routed events go: the stream of each of their keys, and its channel. Each
+ * event of a row is rendered by the component's own condition and payload, fitted to what its
+ * route exposes, and written in one call per Redis its keys are kept on — to the streams of them
+ * that exist, which are the ones that are consumed.
+ *
+ * At least once: a row written again by the pump is written to the streams again.
+ */
+export class Destination extends Connector {
+    name = 'realtime';
+    renders;
+    rendering;
+    locator;
+    routes;
+    shards = null;
+    constructor(locator, routes) {
+        super();
+        this.locator = locator;
+        this.routes = routes;
+        this.renders = [...new Set(routes.map(({ event }) => event))];
+    }
+    async emit(row) {
+        const writes = this.routes.map(async (route) => await this.route(route, row));
+        await Promise.all(writes);
+    }
+    async open() {
+        const shards = new Shards();
+        for (const redis of shards.connections) {
+            // it reconnects on its own; a write while it is away fails, and the outbox writes it again
+            redis.on('error', (error) => console.debug('Realtime streams unreachable', {
+                error: error.code ?? error.message
+            }));
+            redis.defineCommand('append', { lua: APPEND });
+        }
+        this.shards = shards;
+        await shards.connect();
+    }
+    async close() {
+        this.shards?.disconnect();
+        this.shards = null;
+    }
+    async route(route, row) {
+        const raised = await this.rendering.render(route.event, row);
+        if (raised === null)
+            return;
+        const payload = raised.payload;
+        const keys = keysOf(payload, route.properties);
+        if (keys.length === 0)
+            return;
+        const event = `${this.locator.id}.${route.event}`;
+        const data = JSON.stringify(fit(payload, route.expose));
+        const connections = this.shards.connections;
+        const byShard = new Map();
+        for (const key of keys) {
+            const i = shard(key, connections.length);
+            byShard.set(i, [...(byShard.get(i) ?? []), key]);
+        }
+        const writes = [...byShard].map(async ([i, keys]) => await connections[i].append(keys.length, ...keys, event, data, MAXLEN));
+        await Promise.all(writes);
+        measure.route(event);
+    }
+}
+/** The values of the key properties: each a key, or a list of them. */
+function keysOf(payload, properties) {
+    const keys = new Set();
+    for (const property of properties) {
+        const value = payload?.[property];
+        const values = Array.isArray(value) ? value : [value];
+        for (const key of values)
+            if (typeof key === 'string')
+                keys.add(key);
+    }
+    return [...keys];
+}
+/** What the route names of the payload, and nothing else. */
+function fit(payload, expose) {
+    return Object.fromEntries(Object.entries(payload).filter(([key]) => expose.includes(key)));
+}
+//# sourceMappingURL=Destination.js.map

package/transpiled/realtime/Destination.js.map

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

package/transpiled/realtime/Factory.d.ts

@@ -0,0 +1,11 @@
+import { type Declaration } from '@toa.io/definitions/extensions.exposition/realtime';
+import { Destination } from './Destination.ts';
+import type { Locator } from '@toa.io/core';
+import type { extensions } from '@toa.io/core/types';
+/**
+ * What `@toa.io/extensions.exposition#realtime` is to a component that declares routes: the
+ * destination its routed events are written by.
+ */
+export declare class Realtime implements extensions.Factory {
+    destination(locator: Locator, declaration: Declaration | null): Destination | undefined;
+}

package/transpiled/realtime/Factory.js

@@ -0,0 +1,15 @@
+import { parse } from '@toa.io/definitions/extensions.exposition/realtime';
+import { Destination } from './Destination.js';
+/**
+ * What `@toa.io/extensions.exposition#realtime` is to a component that declares routes: the
+ * destination its routed events are written by.
+ */
+export class Realtime {
+    destination(locator, declaration) {
+        const routes = declaration === null || declaration === undefined ? [] : parse(declaration);
+        if (routes.length === 0)
+            return undefined;
+        return new Destination(locator, routes);
+    }
+}
+//# sourceMappingURL=Factory.js.map

package/transpiled/realtime/Factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../../source/realtime/Factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAEN,MAAM,oDAAoD,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAI9C;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACZ,WAAW,CAChB,OAAgB,EAChB,WAA+B;QAE/B,MAAM,MAAM,GACV,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAE7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QAEzC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACzC,CAAC;CACF"}

package/transpiled/realtime/measurements.d.ts

@@ -0,0 +1 @@
+export declare function route(event: string): void;

package/transpiled/realtime/measurements.js

@@ -0,0 +1,11 @@
+import { registry } from 'openspan';
+/**
+ * Counted where a component writes an event to the streams of its keys, whether or not any of
+ * them is read. Against `toa.realtime.delivered`, which the gateway counts, it says what arrived.
+ */
+const meters = registry();
+const routed = meters.counter('toa.realtime.routed', { event: null });
+export function route(event) {
+    routed.add(1, { event });
+}
+//# sourceMappingURL=measurements.js.map

package/transpiled/realtime/measurements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurements.js","sourceRoot":"","sources":["../../source/realtime/measurements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC;;;GAGG;AACH,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAA;AAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAErE,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;AAC1B,CAAC"}

package/transpiled/realtime/redis.d.ts

@@ -0,0 +1,36 @@
+import { Redis } from 'ioredis';
+/**
+ * The Redis the streams are kept in, as the components that write them and the gateway that reads
+ * them both reach it: the addresses the `realtime` annotation names, one connection to each. A
+ * key is kept by the one its hash falls to, so every process finds it on the same one.
+ */
+export declare class Shards {
+    readonly connections: Redis[];
+    constructor();
+    /** The connection a key is kept on. */
+    of(key: string): Redis;
+    connect(): Promise<void>;
+    disconnect(): void;
+}
+/** Whether the streams have anywhere to be kept: the `realtime` annotation names it. */
+export declare function configured(): boolean;
+/** What a key is stored and published under: the scope, so contexts sharing a Redis do not meet. */
+export declare function prefix(): string;
+/** Seconds a stream outlives its last reader: the window a reader reconnects in. */
+export declare function expire(): number;
+/**
+ * FNV-1a over the key's UTF-16 code units: the same number in every process, and cheap enough to
+ * take for every event.
+ */
+export declare function shard(key: string, n: number): number;
+/**
+ * Appends an event to the streams of its keys, and publishes it on their channels — only to a
+ * stream that exists, which is one that is consumed. One call per Redis, whatever the keys it
+ * keeps: they are all on it.
+ *
+ * `KEYS` are the streams; `ARGV` is the event, its payload as JSON, and the length a stream is
+ * trimmed to. What is published is `[id, event, data]`, `data` the JSON it was given.
+ */
+export declare const APPEND = "\nfor _, key in ipairs(KEYS) do\n  if redis.call('EXISTS', key) == 1 then\n    local id = redis.call('XADD', key, 'MAXLEN', '~', ARGV[3], '*', 'type', ARGV[1], 'data', ARGV[2])\n    redis.call('SPUBLISH', key, cjson.encode({ id, ARGV[1], ARGV[2] }))\n  end\nend\n";
+/** How many entries a stream keeps: what a reader that reconnects can be given at most. */
+export declare const MAXLEN = 1000;

package/transpiled/realtime/redis.js

@@ -0,0 +1,83 @@
+import { Redis } from 'ioredis';
+import { environment } from '@toa.io/generic';
+import { EXPIRE, STREAMS } from '@toa.io/definitions/extensions.exposition/realtime';
+/**
+ * The Redis the streams are kept in, as the components that write them and the gateway that reads
+ * them both reach it: the addresses the `realtime` annotation names, one connection to each. A
+ * key is kept by the one its hash falls to, so every process finds it on the same one.
+ */
+export class Shards {
+    connections;
+    constructor() {
+        // a key's, and its channel's: the prefix applies to a sharded channel as to a key
+        const keyPrefix = prefix();
+        this.connections = addresses().map((address) => new Redis(address, { keyPrefix, lazyConnect: true }));
+    }
+    /** The connection a key is kept on. */
+    of(key) {
+        return this.connections[shard(key, this.connections.length)];
+    }
+    async connect() {
+        await Promise.all(this.connections.map(async (connection) => await connection.connect()));
+    }
+    disconnect() {
+        for (const connection of this.connections)
+            connection.disconnect();
+    }
+}
+/** Whether the streams have anywhere to be kept: the `realtime` annotation names it. */
+export function configured() {
+    return environment.get('TOA_DEV') === '1' || environment.has(STREAMS);
+}
+/** What a key is stored and published under: the scope, so contexts sharing a Redis do not meet. */
+export function prefix() {
+    return `${environment.scope()}:realtime:`;
+}
+/** Seconds a stream outlives its last reader: the window a reader reconnects in. */
+export function expire() {
+    const value = Number(environment.get(EXPIRE));
+    return Number.isNaN(value) || value <= 0 ? DEFAULT_EXPIRE : value;
+}
+/**
+ * FNV-1a over the key's UTF-16 code units: the same number in every process, and cheap enough to
+ * take for every event.
+ */
+export function shard(key, n) {
+    if (n === 1)
+        return 0;
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < key.length; i++) {
+        hash ^= key.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0) % n;
+}
+function addresses() {
+    const value = environment.get(STREAMS);
+    // Toa's own development stack is not on the conventional ports. See CONTRIBUTING.md.
+    if (value === undefined && environment.get('TOA_DEV') === '1')
+        return ['redis://localhost:31040'];
+    if (value === undefined)
+        throw new Error(`${STREAMS} is not set: the context has no realtime`);
+    return value.split(' ').filter(Boolean);
+}
+/**
+ * Appends an event to the streams of its keys, and publishes it on their channels — only to a
+ * stream that exists, which is one that is consumed. One call per Redis, whatever the keys it
+ * keeps: they are all on it.
+ *
+ * `KEYS` are the streams; `ARGV` is the event, its payload as JSON, and the length a stream is
+ * trimmed to. What is published is `[id, event, data]`, `data` the JSON it was given.
+ */
+export const APPEND = `
+for _, key in ipairs(KEYS) do
+  if redis.call('EXISTS', key) == 1 then
+    local id = redis.call('XADD', key, 'MAXLEN', '~', ARGV[3], '*', 'type', ARGV[1], 'data', ARGV[2])
+    redis.call('SPUBLISH', key, cjson.encode({ id, ARGV[1], ARGV[2] }))
+  end
+end
+`;
+/** How many entries a stream keeps: what a reader that reconnects can be given at most. */
+export const MAXLEN = 1000;
+const DEFAULT_EXPIRE = 300;
+//# sourceMappingURL=redis.js.map

package/transpiled/realtime/redis.js.map

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

package/transpiled/root.d.ts

@@ -1,2 +1,2 @@
-import { syntax } from './RTD';
+import { syntax } from './RTD/index.ts';
 export declare function resolve(): syntax.Node;

package/transpiled/root.js

@@ -1,15 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolve = void 0;
-const generic_1 = require("@toa.io/generic");
-const RTD_1 = require("./RTD");
-function resolve() {
-    const value = process.env.TOA_EXPOSITION;
-    const root = value !== undefined ? (0, generic_1.decode)(value) : RTD_1.syntax.createNode();
-    (0, generic_1.merge)(root, PREDEFINED);
+import { environment, merge } from '@toa.io/generic';
+import { syntax } from './RTD/index.js';
+export function resolve() {
+    const value = environment.get('TOA_EXPOSITION');
+    const root = value !== undefined ? JSON.parse(value) : syntax.createNode();
+    merge(root, PREDEFINED);
     return root;
 }
-exports.resolve = resolve;
 const PREDEFINED = {
     routes: [
         {
@@ -21,21 +17,51 @@ const PREDEFINED = {
                     {
                         verb: 'GET',
                         directives: [
+                            {
+                                family: 'io',
+                                name: 'output',
+                                value: ['id', 'roles']
+                            },
                             {
                                 family: 'auth',
                                 name: 'echo',
                                 value: null
-                            },
+                            }
+                        ]
+                    },
+                    {
+                        verb: 'POST',
+                        directives: [
                             {
                                 family: 'io',
                                 name: 'output',
                                 value: ['id', 'roles']
+                            },
+                            {
+                                family: 'auth',
+                                name: 'incept',
+                                value: null
                             }
                         ]
                     }
                 ],
                 directives: []
             }
+        },
+        {
+            // an identity's own stream, which it reads whatever the application declares
+            path: '/realtime/:id',
+            node: {
+                isolated: true,
+                routes: [],
+                methods: [
+                    {
+                        verb: 'GET',
+                        directives: [{ family: 'realtime', name: 'stream', value: 'id' }]
+                    }
+                ],
+                directives: [{ family: 'auth', name: 'id', value: 'id' }]
+            }
         }
     ],
     methods: [],

package/transpiled/root.js.map

@@ -1 +1 @@
-{"version":3,"file":"root.js","sourceRoot":"","sources":["../source/root.ts"],"names":[],"mappings":";;;AAAA,6CAA+C;AAC/C,+BAA8B;AAE9B,SAAgB,OAAO;IACrB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IACxC,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAM,EAAc,KAAK,CAAC,CAAC,CAAC,CAAC,YAAM,CAAC,UAAU,EAAE,CAAA;IAEnF,IAAA,eAAK,EAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAEvB,OAAO,IAAI,CAAA;AACb,CAAC;AAPD,0BAOC;AAED,MAAM,UAAU,GAAgB;IAC9B,MAAM,EAAE;QACN;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,KAAK;wBACX,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,MAAM;gCACZ,KAAK,EAAE,IAAI;6BACZ;4BACD;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;yBACF;qBACF;iBACF;gBACD,UAAU,EAAE,EAAE;aACf;SACF;KACF;IACD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;CACf,CAAA"}
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../source/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC,MAAM,UAAU,OAAO;IACrB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC/C,MAAM,IAAI,GACR,KAAK,KAAK,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;IAEhF,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAEvB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,GAAgB;IAC9B,MAAM,EAAE;QACN;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,KAAK;wBACX,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;4BACD;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,MAAM;gCACZ,KAAK,EAAE,IAAI;6BACZ;yBACF;qBACF;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,UAAU,EAAE;4BACV;gCACE,MAAM,EAAE,IAAI;gCACZ,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC;6BACvB;4BACD;gCACE,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE,IAAI;6BACZ;yBACF;qBACF;iBACF;gBACD,UAAU,EAAE,EAAE;aACf;SACF;QACD;YACE,6EAA6E;YAC7E,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,KAAK;wBACX,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;qBAClE;iBACF;gBACD,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aAC1D;SACF;KACF;IACD,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;CACf,CAAA"}

package/transpiled/service.d.ts

@@ -0,0 +1,7 @@
+import type { Connector } from '@toa.io/core';
+import type { Host } from './Factory.ts';
+/**
+ * The gateway. A composition loads this extension for its tenants alone, so what the
+ * gateway is made of is reached from here and nowhere the factory imports.
+ */
+export declare function service(host: Host): Promise<Connector | null>;