@toa.io/bindings.http 0.20.0-dev.8 → 1.0.0-alpha.312

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@toa.io/bindings.http",
-  "version": "0.20.0-dev.8",
+  "version": "1.0.0-alpha.312",
+  "type": "module",
   "description": "Toa HTTP Binding",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
-  "main": "src/index.js",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/toa-io/toa.git"
@@ -15,15 +15,22 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "test": "echo \"Error: run tests from root\" && exit 1"
-  },
+  "files": [
+    "transpiled",
+    "readme.md",
+    "!**/tsconfig.tsbuildinfo",
+    "!**/*.test.*"
+  ],
+  "main": "transpiled/index.js",
+  "types": "transpiled/index.d.ts",
   "dependencies": {
-    "@toa.io/console": "0.20.0-dev.8",
-    "@toa.io/core": "0.20.0-dev.8",
-    "agentkeepalive": "4.2.1",
-    "express": "4.18.1",
-    "node-fetch": "2.6.7"
+    "@toa.io/core": "1.0.0-alpha.312",
+    "@toa.io/definitions": "1.0.0-alpha.312",
+    "@toa.io/generic": "1.0.0-alpha.311",
+    "openspan": "1.0.0-alpha.305"
+  },
+  "scripts": {
+    "transpile": "tsc"
   },
-  "gitHead": "d8c08ec7def70ad93de06541af497cce8c4c1b50"
+  "gitHead": "3cdff9b9779eeb6ae83913fefc0b502a10a0236a"
 }

package/readme.md

@@ -0,0 +1,40 @@
+# Toa HTTP binding
+
+Carries [streamed calls](/documentation/streams.md) — a call whose input holds a stream, which no
+other binding can carry. It declines everything else, so ordinary calls, tasks, events and addressed
+calls go over the binding beside it.
+
+A call is made to a component, not to a process: whichever replica answers at the component's
+address takes it, over a connection opened for that call and closed when it ends. A connection kept
+for the next call would send it to the same replica, so none is kept: a call in flight costs a
+socket at each end, and a call that is neither large nor long costs more than it saves. See
+[what it costs](/documentation/streams.md#what-it-costs).
+
+## Annotation
+
+An address per component, as the context has it:
+
+```yaml
+# context.toa.yaml
+http:
+  media.videos: http://media-videos:8005
+```
+
+Absent, a component is addressed at the `Service` deployment renders for it — its label, on port
+`8005` — which is what a deployment normally leaves unsaid. What a key states is used for a
+component and for the components under it: `.` is every component of the context.
+
+A process reads the same map for the other side of it: it listens on the port in the address of each
+component it serves. Where several components in one process name several ports, it listens on each.
+
+Keys are folded by environment like every other key of a context, which is where a development
+machine states the ports its processes take:
+
+```yaml
+http@local:
+  media.videos: http://127.0.0.1:31006
+  media.files: http://127.0.0.1:31007
+```
+
+Components composed in one process call each other without any of this: a stream is passed as it is
+where there is nothing in between.

package/transpiled/Consumer.d.ts

@@ -0,0 +1,15 @@
+import { Connector } from '@toa.io/core';
+import type { Readable } from 'node:stream';
+import type { Locator } from '@toa.io/core';
+import type { bindings, Reply, Request } from '@toa.io/core/types';
+/**
+ * Carries a call that holds a stream, and nothing else: what a call without one is answered with
+ * is `false`, and the transmission goes on to the binding beside this one.
+ */
+export declare class Consumer extends Connector {
+    private readonly locator;
+    private readonly endpoint;
+    constructor(locator: Locator, endpoint: string);
+    request(request: Request, terms?: bindings.Terms): Promise<Reply | Readable | false>;
+    private send;
+}

package/transpiled/Consumer.js

@@ -0,0 +1,73 @@
+import * as http from 'node:http';
+import { Connector, exceptions } from '@toa.io/core';
+import { address } from './address.js';
+import { HEADER, PATH, detach } from './envelope.js';
+import { read } from './reply.js';
+import { path } from './Producer.js';
+/**
+ * Carries a call that holds a stream, and nothing else: what a call without one is answered with
+ * is `false`, and the transmission goes on to the binding beside this one.
+ */
+export class Consumer extends Connector {
+    locator;
+    endpoint;
+    constructor(locator, endpoint) {
+        super();
+        this.locator = locator;
+        this.endpoint = endpoint;
+    }
+    async request(request, terms) {
+        const carried = detach(request);
+        if (carried === undefined)
+            return false;
+        const url = new URL(path(this.locator, this.endpoint), address(this.locator));
+        return await this.send(url, carried.envelope, carried.path, carried.stream, terms);
+    }
+    // eslint-disable-next-line max-params
+    async send(url, envelope, property, stream, terms) {
+        const message = await new Promise((resolve, reject) => {
+            const request = http.request(url, {
+                method: 'POST',
+                // a connection kept for the next call would send it where this one went
+                agent: false,
+                signal: terms?.signal,
+                headers: {
+                    [HEADER]: JSON.stringify(envelope),
+                    [PATH]: property,
+                    'content-type': 'application/octet-stream'
+                }
+            }, resolve);
+            request.on('error', reject);
+            stream.pipe(request);
+        }).catch((error) => {
+            throw unreachable(url, error);
+        });
+        // nothing at that address serves this endpoint: a replica of another version, or another
+        // process that has taken the address since
+        if (message.statusCode === 404)
+            throw new exceptions.UnreachableException(`Nothing at '${url.host}' serves '${this.locator.id}.${this.endpoint}'`);
+        if (message.statusCode !== 200)
+            throw new exceptions.SystemException(new Error(`'${url.host}' answered ${message.statusCode} to a streamed call`));
+        return read(message);
+    }
+}
+/**
+ * A replica that is starting, restarting or being deployed is one that answers in a moment. What
+ * failed for any other reason — a caller that stopped waiting, a stream of its own that broke — is
+ * its own failure, and is handed on as it is.
+ */
+function unreachable(url, error) {
+    const code = error.code;
+    if (code === undefined || !DIAL.has(code))
+        return error;
+    return new exceptions.UnreachableException(`Nothing answered at '${url.host}' (${code})`, error);
+}
+const DIAL = new Set([
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'ETIMEDOUT',
+    'EAI_AGAIN'
+]);
+//# sourceMappingURL=Consumer.js.map

package/transpiled/Consumer.js.map

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

package/transpiled/Factory.d.ts

@@ -0,0 +1,12 @@
+import { Consumer } from './Consumer.ts';
+import type { Component, Connector, Locator } from '@toa.io/core';
+/**
+ * A server per port the components of this process are addressed at — one, where they share an
+ * address, and one each where a development machine gives them their own.
+ */
+export declare class Factory {
+    private readonly servers;
+    producer(locator: Locator, endpoints: string[], component: Component, _stateful?: string[], streamed?: string[]): Connector;
+    consumer(locator: Locator, endpoint: string): Consumer;
+    private server;
+}

package/transpiled/Factory.js

@@ -0,0 +1,29 @@
+import { Consumer } from './Consumer.js';
+import { Producer } from './Producer.js';
+import { Server } from './Server.js';
+import { port } from './address.js';
+/**
+ * A server per port the components of this process are addressed at — one, where they share an
+ * address, and one each where a development machine gives them their own.
+ */
+export class Factory {
+    servers = new Map();
+    // eslint-disable-next-line max-params
+    producer(locator, endpoints, component, _stateful, streamed = []) {
+        // this binding carries a call that holds a stream, so it serves the endpoints that take one
+        const carried = endpoints.filter((endpoint) => streamed.includes(endpoint));
+        return new Producer(this.server(port(locator)), locator, carried, component);
+    }
+    consumer(locator, endpoint) {
+        return new Consumer(locator, endpoint);
+    }
+    server(number) {
+        let server = this.servers.get(number);
+        if (server === undefined) {
+            server = new Server(number);
+            this.servers.set(number, server);
+        }
+        return server;
+    }
+}
+//# 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,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAGnC;;;GAGG;AACH,MAAM,OAAO,OAAO;IACD,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEpD,sCAAsC;IAC/B,QAAQ,CACb,OAAgB,EAChB,SAAmB,EACnB,SAAoB,EACpB,SAAoB,EACpB,QAAQ,GAAa,EAAE;QAEvB,4FAA4F;QAC5F,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QAE3E,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAC9E,CAAC;IAEM,QAAQ,CAAC,OAAgB,EAAE,QAAgB;QAChD,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IAEO,MAAM,CAAC,MAAc;QAC3B,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAErC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAA;YAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/transpiled/Producer.d.ts

@@ -0,0 +1,21 @@
+import { Connector } from '@toa.io/core';
+import type { Component, Locator } from '@toa.io/core';
+import type { Server } from './Server.ts';
+/** Serves the endpoints of one component that take a stream, on the server of its own port. */
+export declare class Producer extends Connector {
+    private readonly server;
+    private readonly locator;
+    private readonly endpoints;
+    private readonly component;
+    private readonly pending;
+    constructor(server: Server, locator: Locator, endpoints: string[], component: Component);
+    protected open(): Promise<void>;
+    /**
+     * Takes no new call before the component it calls is taken apart, and waits for the calls it
+     * holds: the component is a dependency, and is disconnected only once this has returned.
+     */
+    protected close(): Promise<void>;
+    private invoke;
+}
+/** What a call to an endpoint is addressed to, which is what a caller writes on the request. */
+export declare function path(locator: Locator, endpoint: string): string;

package/transpiled/Producer.js

@@ -0,0 +1,49 @@
+import { Connector, deliveries } from '@toa.io/core';
+/** Serves the endpoints of one component that take a stream, on the server of its own port. */
+export class Producer extends Connector {
+    server;
+    locator;
+    endpoints;
+    component;
+    pending = new Set();
+    // eslint-disable-next-line max-params
+    constructor(server, locator, endpoints, component) {
+        super();
+        this.server = server;
+        this.locator = locator;
+        this.endpoints = endpoints;
+        this.component = component;
+        this.depends(server);
+        this.depends(component);
+    }
+    async open() {
+        for (const endpoint of this.endpoints)
+            this.server.route(path(this.locator, endpoint), async (request) => await this.invoke(endpoint, request));
+    }
+    /**
+     * Takes no new call before the component it calls is taken apart, and waits for the calls it
+     * holds: the component is a dependency, and is disconnected only once this has returned.
+     */
+    async close() {
+        for (const endpoint of this.endpoints)
+            this.server.unroute(path(this.locator, endpoint));
+        await Promise.allSettled(this.pending);
+    }
+    async invoke(endpoint, request) {
+        const promise = this.component.invoke(endpoint, request);
+        this.pending.add(promise);
+        deliveries.taken();
+        try {
+            return (await promise);
+        }
+        finally {
+            this.pending.delete(promise);
+            deliveries.done();
+        }
+    }
+}
+/** What a call to an endpoint is addressed to, which is what a caller writes on the request. */
+export function path(locator, endpoint) {
+    return `/${locator.namespace}/${locator.name}/${endpoint}`;
+}
+//# sourceMappingURL=Producer.js.map

package/transpiled/Producer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Producer.js","sourceRoot":"","sources":["../source/Producer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAMpD,+FAA+F;AAC/F,MAAM,OAAO,QAAS,SAAQ,SAAS;IACpB,MAAM,CAAQ;IACd,OAAO,CAAS;IAChB,SAAS,CAAU;IACnB,SAAS,CAAW;IACpB,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEtD,sCAAsC;IACtC,YACE,MAAc,EACd,OAAgB,EAChB,SAAmB,EACnB,SAAoB;QAEpB,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACpB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5B,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CACxD,CAAA;IACL,CAAC;IAED;;;OAGG;IACgB,KAAK,CAAC,KAAK;QAC5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;QAExF,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAAgB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAExD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACzB,UAAU,CAAC,KAAK,EAAE,CAAA;QAElB,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,OAAO,CAAqB,CAAA;QAC5C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC5B,UAAU,CAAC,IAAI,EAAE,CAAA;QACnB,CAAC;IACH,CAAC;CACF;AAED,gGAAgG;AAChG,MAAM,UAAU,IAAI,CAAC,OAAgB,EAAE,QAAgB;IACrD,OAAO,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAA;AAC5D,CAAC"}

package/transpiled/Server.d.ts

@@ -0,0 +1,19 @@
+import { Connector } from '@toa.io/core';
+import type { Readable } from 'node:stream';
+import type { Reply, Request } from '@toa.io/core/types';
+export type Invoke = (request: Request) => Promise<Reply | Readable>;
+/**
+ * What answers streamed calls on one port, for every component of this process whose address
+ * names that port.
+ */
+export declare class Server extends Connector {
+    private readonly port;
+    private readonly routes;
+    private readonly server;
+    constructor(port: number);
+    route(path: string, invoke: Invoke): void;
+    unroute(path: string): void;
+    protected open(): Promise<void>;
+    protected close(): Promise<void>;
+    private listener;
+}

package/transpiled/Server.js

@@ -0,0 +1,70 @@
+import * as http from 'node:http';
+import { Connector } from '@toa.io/core';
+import { console } from 'openspan';
+import { HEADER, PATH, attach } from './envelope.js';
+import { write } from './reply.js';
+/**
+ * What answers streamed calls on one port, for every component of this process whose address
+ * names that port.
+ */
+export class Server extends Connector {
+    port;
+    routes = new Map();
+    server;
+    constructor(port) {
+        super();
+        this.port = port;
+        this.server = http.createServer(this.listener.bind(this));
+    }
+    route(path, invoke) {
+        if (this.routes.has(path))
+            throw new Error(`Endpoint '${path}' is already served`);
+        this.routes.set(path, invoke);
+    }
+    unroute(path) {
+        this.routes.delete(path);
+    }
+    async open() {
+        await new Promise((resolve, reject) => {
+            this.server.on('error', reject);
+            this.server.listen(this.port, () => {
+                this.server.off('error', reject);
+                console.info('Streamed calls are served', { port: this.port });
+                resolve();
+            });
+        });
+    }
+    async close() {
+        await new Promise((resolve) => {
+            // a call in flight holds its connection, and is waited for; nothing else is kept
+            this.server.closeIdleConnections();
+            this.server.close(() => resolve());
+        });
+    }
+    listener(request, response) {
+        const invoke = request.method === 'POST' ? this.routes.get(request.url ?? '') : undefined;
+        if (invoke === undefined) {
+            response.writeHead(404);
+            response.end();
+            return;
+        }
+        const header = request.headers[HEADER];
+        const path = request.headers[PATH];
+        if (typeof header !== 'string' || typeof path !== 'string') {
+            response.writeHead(400);
+            response.end();
+            return;
+        }
+        const envelope = JSON.parse(header);
+        attach(envelope, path, request);
+        invoke(envelope)
+            .then(async (reply) => await write(response, reply))
+            .catch((error) => {
+            console.error('Streamed call failed', { error });
+            if (!response.headersSent)
+                response.writeHead(500);
+            response.end();
+        });
+    }
+}
+//# sourceMappingURL=Server.js.map

package/transpiled/Server.js.map

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

package/transpiled/address.d.ts

@@ -0,0 +1,11 @@
+import type { Locator } from '@toa.io/core';
+/**
+ * Where a component answers a streamed call: what the context states for it, or the service a
+ * deployment renders for it, which is what an unstated address resolves to.
+ */
+export declare function address(locator: Locator): URL;
+/**
+ * The port a process serving this component listens on, which is the one in the component's own
+ * address: one line says where a component is, and both sides read it.
+ */
+export declare function port(locator: Locator): number;

package/transpiled/address.js

@@ -0,0 +1,28 @@
+import { environment } from '@toa.io/generic';
+import { PORT, VARIABLE } from '@toa.io/definitions/bindings.http';
+/**
+ * Where a component answers a streamed call: what the context states for it, or the service a
+ * deployment renders for it, which is what an unstated address resolves to.
+ */
+export function address(locator) {
+    return new URL(stated(locator) ?? `http://${locator.hostname()}:${PORT}`);
+}
+/**
+ * The port a process serving this component listens on, which is the one in the component's own
+ * address: one line says where a component is, and both sides read it.
+ */
+export function port(locator) {
+    const url = address(locator);
+    return url.port === '' ? PORT : Number(url.port);
+}
+/** The deepest key that names this component, as a context states one for all of them. */
+function stated(locator) {
+    const value = environment.get(VARIABLE);
+    if (value === undefined)
+        return undefined;
+    const map = JSON.parse(value);
+    const namespace = locator.namespace;
+    const broader = namespace === undefined ? undefined : map[namespace];
+    return map[locator.id] ?? broader ?? map['.'];
+}
+//# sourceMappingURL=address.js.map

package/transpiled/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../source/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAGlE;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,OAAgB;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE5B,OAAO,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAClD,CAAC;AAED,0FAA0F;AAC1F,SAAS,MAAM,CAAC,OAAgB;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEvC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA2B,CAAA;IACvD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IAEnC,MAAM,OAAO,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAEpE,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;AAC/C,CAAC"}

package/transpiled/envelope.d.ts

@@ -0,0 +1,21 @@
+import { Readable } from 'node:stream';
+import type { Request } from '@toa.io/core/types';
+/** The header a call travels in, beside the stream it carries as the body. */
+export declare const HEADER = "toa-request";
+/** Where in the input the stream was taken from, so that it is put back where it was. */
+export declare const PATH = "toa-stream";
+export interface Carried {
+    /** the input property the stream was taken from, and its `stream` member where it has one */
+    path: string;
+    stream: Readable;
+    /** what is left of the call once the stream is out of it */
+    envelope: Request;
+}
+/**
+ * The stream a call carries, taken out of the input it was put in — the property itself where its
+ * caller said nothing about it, and the property's `stream` where a route filled one. What is
+ * handed back is a copy: the input belongs to whoever made the call.
+ */
+export declare function detach(request: Request): Carried | undefined;
+/** Puts a stream back where the call carried it, on the side that serves the call. */
+export declare function attach(request: Request, path: string, stream: Readable): void;

package/transpiled/envelope.js

@@ -0,0 +1,52 @@
+import { Readable } from 'node:stream';
+/** The header a call travels in, beside the stream it carries as the body. */
+export const HEADER = 'toa-request';
+/** Where in the input the stream was taken from, so that it is put back where it was. */
+export const PATH = 'toa-stream';
+/**
+ * The stream a call carries, taken out of the input it was put in — the property itself where its
+ * caller said nothing about it, and the property's `stream` where a route filled one. What is
+ * handed back is a copy: the input belongs to whoever made the call.
+ */
+export function detach(request) {
+    const input = request.input;
+    if (input === null || typeof input !== 'object')
+        return undefined;
+    for (const [key, value] of Object.entries(input)) {
+        if (value instanceof Readable)
+            return { path: key, stream: value, envelope: without(request, key) };
+        if (value !== null && typeof value === 'object' && 'stream' in value) {
+            const property = value;
+            const stream = property.stream;
+            if (stream instanceof Readable) {
+                const rest = { ...property };
+                delete rest.stream;
+                return { path: key + '.stream', stream, envelope: without(request, key, rest) };
+            }
+        }
+    }
+    return undefined;
+}
+/** Puts a stream back where the call carried it, on the side that serves the call. */
+export function attach(request, path, stream) {
+    const input = (request.input ?? {});
+    const [key, nested] = path.split('.');
+    if (nested === undefined)
+        input[key] = stream;
+    else {
+        const property = (input[key] ?? {});
+        property[nested] = stream;
+        input[key] = property;
+    }
+    request.input = input;
+}
+/** What is left of a call once the stream is out of it. The input belongs to whoever made it. */
+function without(request, key, rest) {
+    const copy = { ...request.input };
+    if (rest === undefined)
+        delete copy[key];
+    else
+        copy[key] = rest;
+    return { ...request, input: copy };
+}
+//# sourceMappingURL=envelope.js.map

package/transpiled/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../source/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAA;AAEnC,yFAAyF;AACzF,MAAM,CAAC,MAAM,IAAI,GAAG,YAAY,CAAA;AAUhC;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,OAAgB;IACrC,MAAM,KAAK,GAAY,OAAO,CAAC,KAAK,CAAA;IAEpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAEjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,YAAY,QAAQ;YAC3B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAA;QAEtE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;YACrE,MAAM,QAAQ,GAAG,KAAgC,CAAA;YACjD,MAAM,MAAM,GAAY,QAAQ,CAAC,MAAM,CAAA;YAEvC,IAAI,MAAM,YAAY,QAAQ,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAA;gBAE5B,OAAO,IAAI,CAAC,MAAM,CAAA;gBAElB,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAA;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,MAAM,CAAC,OAAgB,EAAE,IAAY,EAAE,MAAgB;IACrE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAA;IAC9D,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAErC,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;SACxC,CAAC;QACJ,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAA;QAE9D,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;QACzB,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAA;IACvB,CAAC;IAED,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;AACvB,CAAC;AAED,iGAAiG;AACjG,SAAS,OAAO,CAAC,OAAgB,EAAE,GAAW,EAAE,IAAa;IAC3D,MAAM,IAAI,GAA4B,EAAE,GAAI,OAAO,CAAC,KAAgB,EAAE,CAAA;IAEtE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;;QACnC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IAErB,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACpC,CAAC"}

package/transpiled/index.d.ts

@@ -0,0 +1 @@
+export { Factory } from './Factory.ts';

package/transpiled/index.js

@@ -0,0 +1,2 @@
+export { Factory } from './Factory.js';
+//# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/reply.d.ts

@@ -0,0 +1,16 @@
+import { Readable } from 'node:stream';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Reply } from '@toa.io/core/types';
+export declare const JSON_TYPE = "application/json";
+export declare const BYTES_TYPE = "application/octet-stream";
+export declare const VALUES_TYPE = "application/x-ndjson";
+/** How a stream ended, said once it is too late to say it in a status. */
+export declare const STATUS = "toa-status";
+/**
+ * A value is the envelope, a stream is the body — bytes as they are, values newline-delimited —
+ * and how the stream ended is a trailer, so a body that stops without one is a stream that was
+ * cut rather than one that finished.
+ */
+export declare function write(response: ServerResponse, reply: Reply | Readable): Promise<void>;
+/** What a caller is handed: the envelope a value came back as, or the stream a stream did. */
+export declare function read(message: IncomingMessage): Promise<Reply> | Readable;

package/transpiled/reply.js

@@ -0,0 +1,128 @@
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+export const JSON_TYPE = 'application/json';
+export const BYTES_TYPE = 'application/octet-stream';
+export const VALUES_TYPE = 'application/x-ndjson';
+/** How a stream ended, said once it is too late to say it in a status. */
+export const STATUS = 'toa-status';
+const OK = 'ok';
+/**
+ * A value is the envelope, a stream is the body — bytes as they are, values newline-delimited —
+ * and how the stream ended is a trailer, so a body that stops without one is a stream that was
+ * cut rather than one that finished.
+ */
+export async function write(response, reply) {
+    if (!(reply instanceof Readable)) {
+        const body = JSON.stringify(reply ?? null);
+        response.writeHead(200, { 'content-type': JSON_TYPE });
+        response.end(body);
+        return;
+    }
+    await stream(response, reply);
+}
+async function stream(response, source) {
+    // one iterator throughout: taking the first chunk with a `for await` that breaks would close
+    // the stream it was read from
+    const iterator = source[Symbol.asyncIterator]();
+    const first = await iterator.next();
+    // `Readable.from` makes every generator an object mode stream, whatever it yields, so what the
+    // body is, is settled by what came out of it rather than by how it was made
+    const bytes = !source.readableObjectMode || Buffer.isBuffer(first.value);
+    response.writeHead(200, {
+        'content-type': bytes ? BYTES_TYPE : VALUES_TYPE,
+        trailer: STATUS
+    });
+    try {
+        await pipeline(frames(first, iterator, bytes), response, { end: false });
+        response.addTrailers({ [STATUS]: OK });
+    }
+    catch (error) {
+        // the status is written, so what failed is said where it still can be
+        response.addTrailers({ [STATUS]: JSON.stringify(reason(error)) });
+    }
+    response.end();
+}
+async function* frames(first, rest, bytes) {
+    if (first.done !== true)
+        yield frame(first.value, bytes);
+    for (;;) {
+        const next = await rest.next();
+        if (next.done === true)
+            return;
+        yield frame(next.value, bytes);
+    }
+}
+/** What a caller is told of a stream that failed after it had started. */
+function reason(error) {
+    const carried = error;
+    return carried?.exception ?? carried?.message ?? null;
+}
+function frame(chunk, bytes) {
+    if (bytes) {
+        if (Buffer.isBuffer(chunk))
+            return chunk;
+        if (typeof chunk === 'string')
+            return Buffer.from(chunk);
+        throw new Error('A stream carries bytes and values, and is served as neither');
+    }
+    if (Buffer.isBuffer(chunk))
+        throw new Error('A stream carries bytes and values, and is served as neither');
+    return Buffer.from(JSON.stringify(chunk) + '\n');
+}
+/** What a caller is handed: the envelope a value came back as, or the stream a stream did. */
+export function read(message) {
+    const type = message.headers['content-type'];
+    if (type === BYTES_TYPE)
+        return checked(message, message);
+    if (type === VALUES_TYPE)
+        return checked(message, values(message));
+    return envelope(message);
+}
+async function envelope(message) {
+    const chunks = [];
+    for await (const chunk of message)
+        chunks.push(chunk);
+    const body = Buffer.concat(chunks).toString();
+    return body === '' ? null : JSON.parse(body);
+}
+function values(message) {
+    return Readable.from(lines(message), { objectMode: true });
+}
+async function* lines(message) {
+    let rest = '';
+    for await (const chunk of message) {
+        const text = rest + chunk.toString();
+        const parts = text.split('\n');
+        rest = parts.pop() ?? '';
+        for (const part of parts)
+            if (part !== '')
+                yield JSON.parse(part);
+    }
+    if (rest !== '')
+        yield JSON.parse(rest);
+}
+/**
+ * A stream is whole only where its trailer says so: a body that ends without one was cut, and one
+ * whose trailer carries an exception failed after it had started.
+ *
+ * Pulled rather than piped, so that what arrived before a failure is read before the failure is
+ * raised: a chunk that got through is never dropped for the sake of reporting the one that did not.
+ */
+function checked(message, source) {
+    return Readable.from(pull(message, source), { objectMode: source.readableObjectMode });
+}
+async function* pull(message, source) {
+    for await (const chunk of source)
+        yield chunk;
+    const status = message.trailers[STATUS];
+    if (status !== OK)
+        throw failure(status);
+}
+function failure(status) {
+    if (status === undefined)
+        return new Error('The reply stream ended without saying that it was whole');
+    const error = new Error('The reply stream failed');
+    error.cause = JSON.parse(status);
+    return error;
+}
+//# sourceMappingURL=reply.js.map

package/transpiled/reply.js.map

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

package/src/consumer.js

@@ -1,49 +0,0 @@
-'use strict'
-
-const fetch = require('node-fetch')
-const { Connector } = require('@toa.io/core')
-
-const resource = require('./resource')
-
-class Consumer extends Connector {
-  #agent
-  #locator
-  #endpoint
-  #url
-
-  constructor (agent, locator, endpoint) {
-    super()
-
-    this.#agent = agent
-    this.#locator = locator
-    this.#endpoint = endpoint
-  }
-
-  async open () {
-    this.#url = Consumer.#locate(this.#locator, this.#endpoint)
-  }
-
-  async request (request) {
-    const method = resource.method
-
-    const reply = await fetch(this.#url, {
-      method,
-      body: JSON.stringify(request),
-      headers: { 'Content-Type': 'application/json' },
-      agent: this.#agent
-    })
-
-    return reply.json()
-  }
-
-  static #locate (locator, endpoint) {
-    const host = locator.hostname()
-    const path = resource.path(locator, endpoint)
-
-    return `http://${host}:${PORT}${path}`
-  }
-}
-
-const PORT = 3000
-
-exports.Consumer = Consumer

package/src/factory.js

@@ -1,32 +0,0 @@
-'use strict'
-
-const Agent = require('agentkeepalive')
-
-const { Consumer } = require('./consumer')
-const { Producer } = require('./producer')
-const { Server } = require('./server')
-
-class Factory {
-  #server
-  #agents = {}
-
-  constructor () {
-    this.#server = new Server()
-  }
-
-  producer (locator, endpoints, target) {
-    return new Producer(this.#server, locator, endpoints, target)
-  }
-
-  consumer (locator, endpoint) {
-    const id = locator.id
-
-    if (!this.#agents[id]) this.#agents[id] = new Agent(AGENT_OPTIONS)
-
-    return new Consumer(this.#agents[id], locator, endpoint)
-  }
-}
-
-const AGENT_OPTIONS = { keepAlive: true }
-
-exports.Factory = Factory

package/src/index.js

@@ -1,6 +0,0 @@
-'use strict'
-
-const { Factory } = require('./factory')
-
-exports.Factory = Factory
-exports.properties = { async: false }

package/src/producer.js

@@ -1,39 +0,0 @@
-'use strict'
-
-const { Connector } = require('@toa.io/core')
-
-const resource = require('./resource')
-
-class Producer extends Connector {
-  #server
-  #locator
-  #endpoints
-  #producer
-
-  constructor (server, locator, endpoints, producer) {
-    super()
-
-    this.#server = server
-    this.#locator = locator
-    this.#endpoints = endpoints
-    this.#producer = producer
-
-    this.#bind()
-
-    this.depends(server)
-    this.depends(producer)
-  }
-
-  #bind () {
-    this.#endpoints.map((endpoint) => this.#endpoint(endpoint))
-  }
-
-  #endpoint (endpoint) {
-    const method = resource.method
-    const path = resource.path(this.#locator, endpoint)
-
-    this.#server.reply(method, path, async (request) => this.#producer.invoke(endpoint, request))
-  }
-}
-
-exports.Producer = Producer

package/src/resource.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const path = (locator, endpoint) => ['', locator.namespace, locator.name, endpoint].join('/')
-const method = 'POST'
-
-exports.path = path
-exports.method = method

package/src/server.js

@@ -1,61 +0,0 @@
-'use strict'
-
-const express = require('express')
-
-const { Connector } = require('@toa.io/core')
-const { console } = require('@toa.io/console')
-
-class Server extends Connector {
-  #app
-  #server
-
-  #port
-
-  constructor () {
-    super()
-
-    this.#app = express()
-    this.#app.disable('x-powered-by')
-    this.#app.use(express.json())
-
-    this.#port = PORT
-  }
-
-  reply (verb, route, invocation) {
-    this.#app[verb.toLowerCase()](route, async (req, res) => {
-      const reply = await invocation(req.body)
-
-      res.json(reply)
-    })
-  }
-
-  async open () {
-    return new Promise((resolve, reject) => {
-      this.#server = this.#app.listen(this.#port, () => {
-        console.info(`HTTP server started at :${this.#port}`)
-
-        this.#server.off('error', reject)
-        resolve()
-      })
-
-      this.#server.on('error', reject)
-    })
-  }
-
-  async close () {
-    return new Promise((resolve, reject) => {
-      this.#server.close(() => {
-        console.info(`HTTP server at :${this.#port} stopped`)
-
-        this.#server.off('error', reject)
-        resolve()
-      })
-
-      this.#server.on('error', reject)
-    })
-  }
-}
-
-const PORT = 3000
-
-exports.Server = Server