@livequery/core 2.0.104 → 2.0.106

package/build/src/ApiGatewayHandler.d.ts

@@ -0,0 +1,56 @@
+import type { IncomingMessage, OutgoingHttpHeaders, ServerResponse } from 'http';
+import { UdpDiscovery, type UdpDiscoveryNode } from './UdpDiscovery.js';
+import { WebsocketGateway } from './WebsocketGateway.js';
+export type RegisterOptions = {
+    node_id: string;
+    hostname: string;
+    port: number;
+    paths: Array<{
+        method: string;
+        path: string;
+    }>;
+};
+export type ServiceApiMetadata = UdpDiscoveryNode & {
+    role: 'service' | 'gateway';
+    name: string;
+    port: number;
+    paths: Array<{
+        method: string;
+        path: string;
+    }>;
+    linked: string[];
+    target?: string;
+    ws?: {
+        path: string;
+        auth: string;
+    };
+};
+export type ServiceApiStatus = {
+    id: string;
+    online: boolean;
+    metadata?: ServiceApiMetadata;
+} | {
+    id: string;
+    online: false;
+};
+export type ApiGatewayOptions = {
+    ws?: WebsocketGateway;
+    discovery?: UdpDiscovery<ServiceApiMetadata>;
+    node_id?: string;
+};
+export declare class ApiGatewayHandler {
+    #private;
+    private options;
+    readonly restGateway: this;
+    constructor(options: ApiGatewayOptions);
+    register({ node_id, hostname, port, paths }: RegisterOptions): void;
+    deregister(node_id: string): void;
+    fetch(request: Request): Promise<Response>;
+    fetch(req: IncomingMessage & {
+        url: string;
+        method: string;
+        rawBody?: Buffer;
+    }, res: ServerResponse, extraHeaders?: OutgoingHttpHeaders): Promise<void>;
+    fetchRequest(request: Request): Promise<Response>;
+    close(): void;
+}

package/build/src/ApiGatewayHandler.js

@@ -0,0 +1,210 @@
+import { randomUUID } from 'crypto';
+import { API_GATEWAY_NAMESPACE, LIVEQUERY_API_GATEWAY_DEBUG, LIVEQUERY_MAGIC_KEY, WEBSOCKET_PATH, } from './const.js';
+import { UdpDiscovery } from './UdpDiscovery.js';
+import { nodeRequestToWebRequest } from './helpers/nodeRequestToWebRequest.js';
+import { writeWebResponse } from './helpers/writeWebResponse.js';
+function createNode() {
+    return { children: {}, paramPrefixes: [], methods: {} };
+}
+function normalizeSegment(seg) {
+    return seg.includes(':') ? seg.split(':')[0] + ':' : seg;
+}
+function isSameServiceDefinition(a, b) {
+    return a.port === b.port
+        && JSON.stringify(a.paths) === JSON.stringify(b.paths)
+        && a.ws?.path === b.ws?.path
+        && a.ws?.auth === b.ws?.auth;
+}
+export class ApiGatewayHandler {
+    options;
+    restGateway = this;
+    #root = createNode();
+    #nodeId;
+    #lws;
+    #discovery;
+    #discoverySubscription;
+    #services = new Map();
+    constructor(options) {
+        this.options = options;
+        this.#nodeId = options.node_id ?? randomUUID();
+        this.#lws = options.ws;
+        this.#discovery = options.discovery ?? new UdpDiscovery({ key: LIVEQUERY_MAGIC_KEY });
+        this.#discoverySubscription = this.#discovery.subscribe(metadata => {
+            if (metadata.role !== 'service')
+                return;
+            if (metadata.namespace !== API_GATEWAY_NAMESPACE)
+                return;
+            if (metadata.node_id === this.#nodeId)
+                return;
+            const existing = this.#services.get(metadata.node_id);
+            if (existing) {
+                if (metadata.version <= existing.metadata.version)
+                    return;
+                if (isSameServiceDefinition(existing.metadata, metadata)) {
+                    existing.metadata = { ...metadata, host: existing.host };
+                    return;
+                }
+                this.#removeService(metadata.node_id, false);
+            }
+            this.#join(metadata);
+        });
+        this.#discovery.broadcast(this.#metadata()).catch(e => console.error(e));
+    }
+    register({ node_id, hostname, port, paths }) {
+        const uri = `${hostname}:${port}`;
+        for (const { method, path } of paths) {
+            const segments = path.split('/').filter(Boolean).map(normalizeSegment);
+            let node = this.#root;
+            for (const seg of segments) {
+                if (!node.children[seg])
+                    node.children[seg] = createNode();
+                if (seg !== ':' && seg.endsWith(':')) {
+                    const prefix = seg.slice(0, -1);
+                    if (!node.paramPrefixes.includes(prefix))
+                        node.paramPrefixes.push(prefix);
+                }
+                node = node.children[seg];
+            }
+            const METHOD = method.toUpperCase();
+            if (!node.methods[METHOD])
+                node.methods[METHOD] = { hosts: [], rr_index: 0 };
+            const exists = node.methods[METHOD].hosts.some(host => host.node_id === node_id && host.uri === uri);
+            if (!exists)
+                node.methods[METHOD].hosts.push({ node_id, uri });
+        }
+    }
+    deregister(node_id) {
+        const queue = [this.#root];
+        while (queue.length > 0) {
+            const node = queue.shift();
+            for (const entry of Object.values(node.methods)) {
+                entry.hosts = entry.hosts.filter(host => host.node_id !== node_id);
+            }
+            queue.push(...Object.values(node.children));
+        }
+    }
+    async fetch(requestOrReq, res, extraHeaders) {
+        if (requestOrReq instanceof Request) {
+            const client_id = requestOrReq.headers.get('x-lcid') ?? requestOrReq.headers.get('socket_id');
+            const extraHeaders = client_id && this.options.ws ? {
+                'x-lcid': client_id,
+                'x-lgid': requestOrReq.headers.get('x-lgid') || this.options.ws?.id || this.#nodeId,
+            } : {};
+            return this.#fetchRequest(requestOrReq, extraHeaders);
+        }
+        if (!res)
+            throw new Error('ServerResponse is required for Node.js requests');
+        const response = await this.#fetchRequest(nodeRequestToWebRequest(requestOrReq, extraHeaders), extraHeaders);
+        await writeWebResponse(res, response);
+    }
+    fetchRequest(request) {
+        return this.fetch(request);
+    }
+    close() {
+        this.#discoverySubscription.unsubscribe();
+        for (const { subscription } of this.#services.values()) {
+            subscription?.unsubscribe();
+        }
+        this.#services.clear();
+        this.#discovery.close();
+    }
+    async #fetchRequest(request, extraHeaders) {
+        const url = new URL(request.url);
+        const target = this.#resolve(url.pathname, request.method);
+        if (target === undefined) {
+            return Response.json({ error: { status: 404, code: 'API_NOT_FOUND' } }, { status: 404 });
+        }
+        if (target === null) {
+            return Response.json({ error: { status: 503, code: 'API_OFFLINE' } }, { status: 503 });
+        }
+        const headers = new Headers(request.headers);
+        headers.delete('content-length');
+        headers.delete('host');
+        if (extraHeaders) {
+            new Headers(extraHeaders).forEach((value, key) => headers.set(key, value));
+        }
+        const body = request.method === 'GET' || request.method === 'HEAD' ? undefined : request.body;
+        try {
+            return await globalThis.fetch(`http://${target.uri}${url.pathname}${url.search}`, {
+                method: request.method,
+                headers,
+                body,
+                duplex: 'half',
+            });
+        }
+        catch {
+            this.deregister(target.node_id);
+            return Response.json({ error: { status: 502, code: 'SERVICE_API_OFFLINE' } }, { status: 502 });
+        }
+    }
+    #matchChild(node, segment) {
+        if (node.children[segment])
+            return node.children[segment];
+        for (const prefix of node.paramPrefixes) {
+            if (segment.startsWith(prefix))
+                return node.children[prefix + ':'];
+        }
+        return node.children[':'];
+    }
+    #resolve(path, method) {
+        const segments = path.split('?')[0].split('/').filter(Boolean);
+        let node = this.#root;
+        for (const segment of segments) {
+            node = this.#matchChild(node, segment);
+            if (!node)
+                return undefined;
+        }
+        const entry = node.methods[method.toUpperCase()];
+        if (!entry)
+            return undefined;
+        if (entry.hosts.length === 0)
+            return null;
+        const host = entry.hosts[entry.rr_index % entry.hosts.length];
+        entry.rr_index++;
+        return host;
+    }
+    #join(metadata) {
+        const { port, node_id, name, paths, ws } = metadata;
+        const host = metadata.host ?? '';
+        const subscription = ws
+            ? this.#lws?.connect(`ws://${host}:${port}${ws.path}`, ws.auth, () => this.#disconnect(node_id))
+            : undefined;
+        this.#services.set(node_id, { metadata, subscription, host });
+        this.register({ node_id, hostname: host, port, paths: paths ?? [] });
+        LIVEQUERY_API_GATEWAY_DEBUG && console.info(`[${new Date().toLocaleString()}] Service API online: ${name} at ${host}:${port}`);
+    }
+    #disconnect(id) {
+        this.#removeService(id, true);
+    }
+    #removeService(id, logOffline) {
+        const service = this.#services.get(id);
+        if (!service)
+            return;
+        const { metadata: { name, port }, subscription, host } = service;
+        subscription?.unsubscribe();
+        this.#services.delete(id);
+        this.deregister(id);
+        logOffline && LIVEQUERY_API_GATEWAY_DEBUG && console.error(`[${new Date().toLocaleString()}] Service API OFFLINE: ${name} at ${host}:${port}`);
+    }
+    #metadata() {
+        const metadata = {
+            name: 'API gateway',
+            paths: [],
+            port: 0,
+            role: 'gateway',
+            linked: [...this.#services.keys()],
+            host: '',
+            node_id: this.#nodeId,
+            namespace: API_GATEWAY_NAMESPACE,
+            version: Date.now(),
+        };
+        if (this.#lws) {
+            metadata.ws = {
+                auth: this.#lws.auth,
+                path: WEBSOCKET_PATH,
+            };
+        }
+        return metadata;
+    }
+}
+//# sourceMappingURL=ApiGatewayHandler.js.map

package/build/src/ApiGatewayHandler.js.map

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

package/build/src/ApiGatewayLinker.d.ts

@@ -0,0 +1,61 @@
+import type { IncomingMessage, OutgoingHttpHeaders, ServerResponse } from 'http';
+import type { LivequeryHandler } from './LivequeryContext.js';
+import { UdpDiscovery, type UdpDiscoveryNode } from './UdpDiscovery.js';
+import { WebsocketGateway } from './WebsocketGateway.js';
+export type RegisterOptions = {
+    node_id: string;
+    hostname: string;
+    port: number;
+    paths: Array<{
+        method: string;
+        path: string;
+    }>;
+};
+export type ServiceApiMetadata = UdpDiscoveryNode & {
+    role: 'service' | 'gateway';
+    name: string;
+    port: number;
+    paths: Array<{
+        method: string;
+        path: string;
+    }>;
+    linked: string[];
+    target?: string;
+    ws?: {
+        path: string;
+        auth: string;
+    };
+};
+export type ServiceApiStatus = {
+    id: string;
+    online: boolean;
+    metadata?: ServiceApiMetadata;
+} | {
+    id: string;
+    online: false;
+};
+export type ApiGatewayOptions<Handler extends LivequeryHandler = LivequeryHandler> = {
+    websocketGateway?: WebsocketGateway;
+    discovery?: UdpDiscovery<ServiceApiMetadata>;
+    nodeId?: string;
+    restGateway?: Handler;
+};
+export declare class ApiGateway<Handler extends LivequeryHandler = LivequeryHandler> {
+    #private;
+    readonly restGateway: this;
+    constructor(options?: ApiGatewayOptions<Handler>);
+    register({ node_id, hostname, port, paths }: RegisterOptions): void;
+    deregister(node_id: string): void;
+    fetch(request: Request): Promise<Response>;
+    fetch(req: IncomingMessage & {
+        url: string;
+        method: string;
+        rawBody?: Buffer;
+    }, res: ServerResponse, extraHeaders?: OutgoingHttpHeaders): Promise<void>;
+    fetchRequest(request: Request): Promise<Response>;
+    close(): void;
+}
+export { ApiGateway as ApiGatewayLinker };
+export { ApiGateway as FetchApiGateway };
+export { ApiGateway as SimpleApiGateway };
+export type ApiGatewayLinkerOptions<Handler extends LivequeryHandler = LivequeryHandler> = ApiGatewayOptions<Handler>;

package/build/src/ApiGatewayLinker.js

@@ -0,0 +1,229 @@
+import { randomUUID } from 'crypto';
+import { API_GATEWAY_NAMESPACE, LIVEQUERY_API_GATEWAY_DEBUG, LIVEQUERY_MAGIC_KEY, WEBSOCKET_PATH, } from './const.js';
+import { createRealtimeForwardHeaders } from './headers.js';
+import { UdpDiscovery } from './UdpDiscovery.js';
+function createNode() {
+    return { children: {}, paramPrefixes: [], methods: {} };
+}
+function normalizeSegment(seg) {
+    return seg.includes(':') ? seg.split(':')[0] + ':' : seg;
+}
+function isSameServiceDefinition(a, b) {
+    return a.port === b.port
+        && JSON.stringify(a.paths) === JSON.stringify(b.paths)
+        && a.ws?.path === b.ws?.path
+        && a.ws?.auth === b.ws?.auth;
+}
+export class ApiGateway {
+    restGateway = this;
+    #root = createNode();
+    #nodeId;
+    #lws;
+    #discovery;
+    #discoverySubscription;
+    #services = new Map();
+    constructor(options = {}) {
+        this.#nodeId = options.nodeId ?? randomUUID();
+        this.#lws = options.websocketGateway;
+        this.#discovery = options.discovery ?? new UdpDiscovery({ key: LIVEQUERY_MAGIC_KEY });
+        this.#discoverySubscription = this.#discovery.subscribe(metadata => {
+            if (metadata.role !== 'service')
+                return;
+            if (metadata.namespace !== API_GATEWAY_NAMESPACE)
+                return;
+            if (metadata.node_id === this.#nodeId)
+                return;
+            const existing = this.#services.get(metadata.node_id);
+            if (existing) {
+                if (metadata.version <= existing.metadata.version)
+                    return;
+                if (isSameServiceDefinition(existing.metadata, metadata)) {
+                    existing.metadata = { ...metadata, host: existing.host };
+                    return;
+                }
+                this.#removeService(metadata.node_id, false);
+            }
+            this.#join(metadata);
+        });
+        this.#discovery.broadcast(this.#metadata()).catch(e => console.error(e));
+    }
+    register({ node_id, hostname, port, paths }) {
+        const uri = `${hostname}:${port}`;
+        for (const { method, path } of paths) {
+            const segments = path.split('/').filter(Boolean).map(normalizeSegment);
+            let node = this.#root;
+            for (const seg of segments) {
+                if (!node.children[seg])
+                    node.children[seg] = createNode();
+                if (seg !== ':' && seg.endsWith(':')) {
+                    const prefix = seg.slice(0, -1);
+                    if (!node.paramPrefixes.includes(prefix))
+                        node.paramPrefixes.push(prefix);
+                }
+                node = node.children[seg];
+            }
+            const METHOD = method.toUpperCase();
+            if (!node.methods[METHOD])
+                node.methods[METHOD] = { hosts: [], rr_index: 0 };
+            const exists = node.methods[METHOD].hosts.some(host => host.node_id === node_id && host.uri === uri);
+            if (!exists)
+                node.methods[METHOD].hosts.push({ node_id, uri });
+        }
+    }
+    deregister(node_id) {
+        const queue = [this.#root];
+        while (queue.length > 0) {
+            const node = queue.shift();
+            for (const entry of Object.values(node.methods)) {
+                entry.hosts = entry.hosts.filter(host => host.node_id !== node_id);
+            }
+            queue.push(...Object.values(node.children));
+        }
+    }
+    async fetch(requestOrReq, res, extraHeaders) {
+        if (requestOrReq instanceof Request) {
+            return this.#fetchRequest(requestOrReq, createRealtimeForwardHeaders(requestOrReq, this.#lws?.id));
+        }
+        if (!res)
+            throw new Error('ServerResponse is required for Node.js requests');
+        const response = await this.#fetchRequest(nodeRequestToWebRequest(requestOrReq, extraHeaders), extraHeaders);
+        await writeWebResponse(res, response);
+    }
+    fetchRequest(request) {
+        return this.fetch(request);
+    }
+    close() {
+        this.#discoverySubscription.unsubscribe();
+        for (const { subscription } of this.#services.values()) {
+            subscription?.unsubscribe();
+        }
+        this.#services.clear();
+        this.#discovery.close();
+    }
+    async #fetchRequest(request, extraHeaders) {
+        const url = new URL(request.url);
+        const target = this.#resolve(url.pathname, request.method);
+        if (target === undefined) {
+            return Response.json({ error: { status: 404, code: 'API_NOT_FOUND' } }, { status: 404 });
+        }
+        if (target === null) {
+            return Response.json({ error: { status: 503, code: 'API_OFFLINE' } }, { status: 503 });
+        }
+        const headers = new Headers(request.headers);
+        headers.delete('content-length');
+        headers.delete('host');
+        if (extraHeaders) {
+            new Headers(extraHeaders).forEach((value, key) => headers.set(key, value));
+        }
+        const body = request.method === 'GET' || request.method === 'HEAD' ? undefined : request.body;
+        try {
+            return await globalThis.fetch(`http://${target.uri}${url.pathname}${url.search}`, {
+                method: request.method,
+                headers,
+                body,
+                duplex: 'half',
+            });
+        }
+        catch {
+            this.deregister(target.node_id);
+            return Response.json({ error: { status: 502, code: 'SERVICE_API_OFFLINE' } }, { status: 502 });
+        }
+    }
+    #matchChild(node, segment) {
+        if (node.children[segment])
+            return node.children[segment];
+        for (const prefix of node.paramPrefixes) {
+            if (segment.startsWith(prefix))
+                return node.children[prefix + ':'];
+        }
+        return node.children[':'];
+    }
+    #resolve(path, method) {
+        const segments = path.split('?')[0].split('/').filter(Boolean);
+        let node = this.#root;
+        for (const segment of segments) {
+            node = this.#matchChild(node, segment);
+            if (!node)
+                return undefined;
+        }
+        const entry = node.methods[method.toUpperCase()];
+        if (!entry)
+            return undefined;
+        if (entry.hosts.length === 0)
+            return null;
+        const host = entry.hosts[entry.rr_index % entry.hosts.length];
+        entry.rr_index++;
+        return host;
+    }
+    #join(metadata) {
+        const { port, node_id, name, paths, ws } = metadata;
+        const host = metadata.host ?? '';
+        const subscription = ws
+            ? this.#lws?.connect(`ws://${host}:${port}${ws.path}`, ws.auth, () => this.#disconnect(node_id))
+            : undefined;
+        this.#services.set(node_id, { metadata, subscription, host });
+        this.register({ node_id, hostname: host, port, paths: paths ?? [] });
+        LIVEQUERY_API_GATEWAY_DEBUG && console.info(`[${new Date().toLocaleString()}] Service API online: ${name} at ${host}:${port}`);
+    }
+    #disconnect(id) {
+        this.#removeService(id, true);
+    }
+    #removeService(id, logOffline) {
+        const service = this.#services.get(id);
+        if (!service)
+            return;
+        const { metadata: { name, port }, subscription, host } = service;
+        subscription?.unsubscribe();
+        this.#services.delete(id);
+        this.deregister(id);
+        logOffline && LIVEQUERY_API_GATEWAY_DEBUG && console.error(`[${new Date().toLocaleString()}] Service API OFFLINE: ${name} at ${host}:${port}`);
+    }
+    #metadata() {
+        const metadata = {
+            name: 'API gateway',
+            paths: [],
+            port: 0,
+            role: 'gateway',
+            linked: [...this.#services.keys()],
+            host: '',
+            node_id: this.#nodeId,
+            namespace: API_GATEWAY_NAMESPACE,
+            version: Date.now(),
+        };
+        if (this.#lws) {
+            metadata.ws = {
+                auth: this.#lws.auth,
+                path: WEBSOCKET_PATH,
+            };
+        }
+        return metadata;
+    }
+}
+function nodeRequestToWebRequest(req, extraHeaders) {
+    const host = req.headers.host ?? '127.0.0.1';
+    const headers = new Headers(req.headers);
+    if (extraHeaders) {
+        new Headers(extraHeaders).forEach((value, key) => headers.set(key, value));
+    }
+    const body = req.method === 'GET' || req.method === 'HEAD'
+        ? undefined
+        : req.rawBody ? new Uint8Array(req.rawBody) : undefined;
+    return new Request(`http://${host}${req.url}`, {
+        method: req.method,
+        headers,
+        body,
+        duplex: body ? 'half' : undefined,
+    });
+}
+async function writeWebResponse(res, response) {
+    const headers = {};
+    response.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    res.writeHead(response.status, headers);
+    res.end(Buffer.from(await response.arrayBuffer()));
+}
+export { ApiGateway as ApiGatewayLinker };
+export { ApiGateway as FetchApiGateway };
+export { ApiGateway as SimpleApiGateway };
+//# sourceMappingURL=ApiGatewayLinker.js.map

package/build/src/ApiGatewayLinker.js.map

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

package/build/src/ApiServiceLinker.d.ts

@@ -0,0 +1,18 @@
+import { UdpDiscovery } from './UdpDiscovery.js';
+import { WebsocketGateway } from './WebsocketGateway.js';
+import { ServiceApiMetadata } from './ApiGatewayHandler.js';
+export type ApiServiceLinkerOptions = {
+    paths: Array<{
+        method: string;
+        path: string;
+    }>;
+    ws?: WebsocketGateway;
+    discovery?: UdpDiscovery<ServiceApiMetadata>;
+    node_id?: string;
+};
+export declare class ApiServiceLinker {
+    #private;
+    constructor(options: ApiServiceLinkerOptions);
+    start(name: string, port: number): void;
+    close(): void;
+}

package/build/src/ApiServiceLinker.js

@@ -0,0 +1,61 @@
+import { randomUUID } from 'crypto';
+import { API_GATEWAY_NAMESPACE, LIVEQUERY_MAGIC_KEY, WEBSOCKET_PATH, } from './const.js';
+import { UdpDiscovery } from './UdpDiscovery.js';
+export class ApiServiceLinker {
+    #paths;
+    #nodeId;
+    #lws;
+    #discovery;
+    #subscription;
+    #metadata;
+    constructor(options) {
+        this.#paths = options.paths;
+        this.#nodeId = options.node_id ?? randomUUID();
+        this.#lws = options.ws;
+        this.#discovery = options.discovery ?? new UdpDiscovery({ key: LIVEQUERY_MAGIC_KEY });
+    }
+    start(name, port) {
+        this.#metadata = this.#createMetadata(name, port);
+        this.#subscription?.unsubscribe();
+        this.#subscription = this.#discovery.subscribe(node => {
+            if (node.role !== 'gateway')
+                return;
+            if (node.namespace !== API_GATEWAY_NAMESPACE)
+                return;
+            if (node.node_id === this.#nodeId)
+                return;
+            const metadata = this.#metadata;
+            if (metadata)
+                this.#discovery.broadcast(this.#bump(metadata)).catch(e => console.error(e));
+        });
+        this.#discovery.broadcast(this.#metadata).catch(e => console.error(e));
+    }
+    close() {
+        this.#subscription?.unsubscribe();
+        this.#discovery.close();
+    }
+    #createMetadata(name, port) {
+        return {
+            node_id: this.#nodeId,
+            host: '',
+            namespace: API_GATEWAY_NAMESPACE,
+            version: Date.now(),
+            name,
+            port,
+            role: 'service',
+            paths: this.#paths,
+            linked: [],
+            ws: this.#lws ? {
+                auth: this.#lws.auth,
+                path: WEBSOCKET_PATH,
+            } : undefined,
+        };
+    }
+    #bump(metadata) {
+        return {
+            ...metadata,
+            version: Date.now(),
+        };
+    }
+}
+//# sourceMappingURL=ApiServiceLinker.js.map