@hyperfrontend/features 0.1.0 → 0.2.0

package/_shared/shared/request/index.cjs.js

@@ -0,0 +1,91 @@
+'use strict';
+
+const { ControlType } = require('../control/index.cjs.js');
+const index_cjs_js$5 = require('../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/timers/index.cjs.js');
+const index_cjs_js$7 = require('../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.cjs.js');
+const index_cjs_js$3 = require('../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
+const index_cjs_js = require('../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.cjs.js');
+
+const DEFAULT_TIMEOUT_MS = 30000;
+function createRequestPeer(origin, send) {
+    let pending = {};
+    const handlers = {};
+    let nextCorrelation = 0;
+    const take = (correlationId) => {
+        const entry = pending[correlationId];
+        if (entry) {
+            index_cjs_js$5.clearTimeout(entry.timer);
+            delete pending[correlationId];
+        }
+        return entry;
+    };
+    const respond = (request, outcome) => send(ControlType.Response, { correlationId: request.correlationId, from: origin, innerType: request.innerType, ...outcome });
+    const answer = (request) => {
+        const handler = handlers[request.innerType];
+        if (!handler) {
+            respond(request, { ok: false, error: `No handler is registered for '${request.innerType}'.` });
+            return;
+        }
+        index_cjs_js$7.promiseResolve()
+            .then(() => handler(request.payload))
+            .then((payload) => respond(request, { ok: true, payload }), (error) => respond(request, { ok: false, error: error instanceof Error ? error.message : `${error}` }));
+    };
+    const settle = (response) => {
+        const entry = take(response.correlationId);
+        if (!entry) {
+            return;
+        }
+        if (response.ok) {
+            entry.resolve(response.payload);
+            return;
+        }
+        entry.reject(index_cjs_js$3.createError(response.error ?? `Request '${response.innerType}' failed.`));
+    };
+    const dispatch = (type, data) => {
+        const envelope = (typeof data === 'object' ? data : null);
+        // why: The channel echoes each side's outbound messages back to its own subscribers, so a peer must discard envelopes stamped with its own origin or it would answer its own requests.
+        if (!envelope || envelope.from === origin) {
+            return;
+        }
+        if (type === ControlType.Request) {
+            answer(envelope);
+            return;
+        }
+        if (type === ControlType.Response) {
+            settle(envelope);
+        }
+    };
+    const request = (type, data, options) => index_cjs_js$7.createPromise((resolve, reject) => {
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const correlationId = `${origin}-${(nextCorrelation += 1)}`;
+        const timer = index_cjs_js$5.setTimeout(() => {
+            delete pending[correlationId];
+            reject(index_cjs_js$3.createError(`Request '${type}' timed out after ${timeoutMs}ms.`));
+        }, timeoutMs);
+        pending[correlationId] = { resolve, reject, timer };
+        send(ControlType.Request, { correlationId, from: origin, innerType: type, payload: data });
+    });
+    const handle = (type, handler) => {
+        if (handlers[type]) {
+            throw index_cjs_js$3.createError(`A handler for '${type}' is already registered.`);
+        }
+        handlers[type] = handler;
+        return () => {
+            if (handlers[type] === handler) {
+                delete handlers[type];
+            }
+        };
+    };
+    const rejectAll = (reason) => {
+        const failed = index_cjs_js.values(pending);
+        pending = {};
+        for (const entry of failed) {
+            index_cjs_js$5.clearTimeout(entry.timer);
+            entry.reject(index_cjs_js$3.createError(reason));
+        }
+    };
+    return index_cjs_js.freeze({ request, handle, dispatch, rejectAll });
+}
+
+exports.DEFAULT_TIMEOUT_MS = DEFAULT_TIMEOUT_MS;
+exports.createRequestPeer = createRequestPeer;

package/_shared/shared/request/index.esm.js

@@ -0,0 +1,88 @@
+import { ControlType } from '../control/index.esm.js';
+import { createError } from '../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.esm.js';
+import { values, freeze } from '../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.esm.js';
+import { promiseResolve, createPromise } from '../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.esm.js';
+import { clearTimeout, setTimeout } from '../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/timers/index.esm.js';
+
+const DEFAULT_TIMEOUT_MS = 30000;
+function createRequestPeer(origin, send) {
+    let pending = {};
+    const handlers = {};
+    let nextCorrelation = 0;
+    const take = (correlationId) => {
+        const entry = pending[correlationId];
+        if (entry) {
+            clearTimeout(entry.timer);
+            delete pending[correlationId];
+        }
+        return entry;
+    };
+    const respond = (request, outcome) => send(ControlType.Response, { correlationId: request.correlationId, from: origin, innerType: request.innerType, ...outcome });
+    const answer = (request) => {
+        const handler = handlers[request.innerType];
+        if (!handler) {
+            respond(request, { ok: false, error: `No handler is registered for '${request.innerType}'.` });
+            return;
+        }
+        promiseResolve()
+            .then(() => handler(request.payload))
+            .then((payload) => respond(request, { ok: true, payload }), (error) => respond(request, { ok: false, error: error instanceof Error ? error.message : `${error}` }));
+    };
+    const settle = (response) => {
+        const entry = take(response.correlationId);
+        if (!entry) {
+            return;
+        }
+        if (response.ok) {
+            entry.resolve(response.payload);
+            return;
+        }
+        entry.reject(createError(response.error ?? `Request '${response.innerType}' failed.`));
+    };
+    const dispatch = (type, data) => {
+        const envelope = (typeof data === 'object' ? data : null);
+        // why: The channel echoes each side's outbound messages back to its own subscribers, so a peer must discard envelopes stamped with its own origin or it would answer its own requests.
+        if (!envelope || envelope.from === origin) {
+            return;
+        }
+        if (type === ControlType.Request) {
+            answer(envelope);
+            return;
+        }
+        if (type === ControlType.Response) {
+            settle(envelope);
+        }
+    };
+    const request = (type, data, options) => createPromise((resolve, reject) => {
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const correlationId = `${origin}-${(nextCorrelation += 1)}`;
+        const timer = setTimeout(() => {
+            delete pending[correlationId];
+            reject(createError(`Request '${type}' timed out after ${timeoutMs}ms.`));
+        }, timeoutMs);
+        pending[correlationId] = { resolve, reject, timer };
+        send(ControlType.Request, { correlationId, from: origin, innerType: type, payload: data });
+    });
+    const handle = (type, handler) => {
+        if (handlers[type]) {
+            throw createError(`A handler for '${type}' is already registered.`);
+        }
+        handlers[type] = handler;
+        return () => {
+            if (handlers[type] === handler) {
+                delete handlers[type];
+            }
+        };
+    };
+    const rejectAll = (reason) => {
+        const failed = values(pending);
+        pending = {};
+        for (const entry of failed) {
+            clearTimeout(entry.timer);
+            entry.reject(createError(reason));
+        }
+    };
+    return freeze({ request, handle, dispatch, rejectAll });
+}
+
+export { DEFAULT_TIMEOUT_MS, createRequestPeer };

package/_shared/shared/shutdown/index.esm.js

@@ -0,0 +1,12 @@
+import { createPromise } from '../../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.esm.js';
+import { resolve } from 'node:path';
+
+function waitForShutdown() {
+    return createPromise((resolve) => {
+        for (const signal of ['SIGINT', 'SIGTERM']) {
+            process.once(signal, () => resolve());
+        }
+    });
+}
+
+export { waitForShutdown };