@enbox/local-node 0.0.1

package/dist/esm/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env bun
+import { AllowOriginPairingBroker, LocalNode, TtyPairingBroker } from './index.js';
+function parseArgs(args) {
+    const options = {
+        allowedOrigins: [],
+        help: false,
+        webSocketSupport: true,
+    };
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+        }
+        else if (arg === '--allow-origin') {
+            options.allowedOrigins.push(readValue(args, i, arg));
+            i += 1;
+        }
+        else if (arg === '--host') {
+            options.hostname = readValue(args, i, arg);
+            i += 1;
+        }
+        else if (arg === '--no-ws') {
+            options.webSocketSupport = false;
+        }
+        else if (arg === '--port') {
+            options.port = parsePort(readValue(args, i, arg));
+            i += 1;
+        }
+        else if (arg === '--storage-url') {
+            options.storageUrl = readValue(args, i, arg);
+            i += 1;
+        }
+        else {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+    }
+    return options;
+}
+function readValue(args, index, flag) {
+    const value = args[index + 1];
+    if (value === undefined || value.startsWith('-')) {
+        throw new Error(`${flag} requires a value.`);
+    }
+    return value;
+}
+function parsePort(value) {
+    const port = Number.parseInt(value, 10);
+    if (!Number.isInteger(port) || port <= 0 || port > 65_535) {
+        throw new Error(`Invalid port: ${value}`);
+    }
+    return port;
+}
+function printHelp() {
+    console.log(`Usage: enbox-local-node [options]
+
+Options:
+  --allow-origin <origin>  Auto-approve a browser origin for dev/CI. Repeatable.
+  --host <hostname>        Loopback bind hostname. Defaults to 127.0.0.1.
+  --port <port>            Bind a single port instead of the shared candidate list.
+  --storage-url <url>      DWN Level/SQL storage URL. Defaults to dwn-server config.
+  --no-ws                  Disable WebSocket support.
+  -h, --help               Show this help text.
+`);
+}
+async function run() {
+    const options = parseArgs(process.argv.slice(2));
+    if (options.help) {
+        printHelp();
+        return;
+    }
+    const node = new LocalNode({
+        allowedOrigins: options.allowedOrigins,
+        hostname: options.hostname,
+        pairingBroker: new AllowOriginPairingBroker(options.allowedOrigins, new TtyPairingBroker()),
+        portCandidates: options.port === undefined ? undefined : [options.port],
+        storageUrl: options.storageUrl,
+        webSocketSupport: options.webSocketSupport,
+    });
+    const result = await node.start();
+    console.log(`Enbox local node listening on ${result.endpoint}`);
+    console.log(`Discovery file: ${result.discoveryFilePath}`);
+    const shutdown = async () => {
+        await node.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => {
+        void shutdown();
+    });
+    process.on('SIGTERM', () => {
+        void shutdown();
+    });
+    await new Promise(() => { });
+}
+try {
+    await run();
+}
+catch (error) {
+    console.error(error);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/esm/cli.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+export * from './local-node.js';
+export * from './local-node-config.js';
+export * from './pairing-session-store.js';
+export * from './pairing-broker.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}

package/dist/esm/local-node-config.js

@@ -0,0 +1,33 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { defaultDwnServerConfig } from '@enbox/dwn-server';
+export const defaultLocalNodeHostname = '127.0.0.1';
+export const defaultLocalNodeStorageUrl = pathToFileURL(join(homedir(), '.enbox', 'dwn')).href.replace('file:', 'level:');
+export function createLocalNodeDwnServerConfig(options) {
+    const hostname = options.hostname ?? defaultLocalNodeHostname;
+    const storageUrl = options.storageUrl ?? process.env.DWN_STORAGE ?? defaultLocalNodeStorageUrl;
+    return {
+        ...defaultDwnServerConfig,
+        baseUrl: options.baseUrl ?? `http://${hostname}:${options.port}`,
+        dataStore: options.dataStore ?? process.env.DWN_STORAGE_DATA ?? storageUrl,
+        deliveryEnabled: options.deliveryEnabled ?? true,
+        eventBusPluginPath: options.eventBusPluginPath ?? defaultDwnServerConfig.eventBusPluginPath,
+        forwardingEnabled: options.forwardingEnabled ?? true,
+        hostname,
+        localNodeAllowedOrigins: options.allowedOrigins ?? [],
+        localNodeProfileEnabled: true,
+        logLevel: options.logLevel ?? defaultDwnServerConfig.logLevel,
+        maxRecordDataSize: options.maxRecordDataSize ?? 1_073_741_824,
+        messageStore: options.messageStore ?? process.env.DWN_STORAGE_MESSAGES ?? storageUrl,
+        packageJsonPath: options.packageJsonPath ?? defaultDwnServerConfig.packageJsonPath,
+        port: options.port,
+        registrationStoreUrl: options.registrationStoreUrl ?? defaultDwnServerConfig.registrationStoreUrl,
+        resumableTaskStore: options.resumableTaskStore ?? process.env.DWN_STORAGE_RESUMABLE_TASKS ?? storageUrl,
+        serverName: options.serverName ?? defaultDwnServerConfig.serverName,
+        termsOfServiceFilePath: options.termsOfServiceFilePath ?? defaultDwnServerConfig.termsOfServiceFilePath,
+        ttlCacheUrl: options.ttlCacheUrl ?? defaultDwnServerConfig.ttlCacheUrl,
+        webSocketSupport: options.webSocketSupport ?? defaultDwnServerConfig.webSocketSupport,
+    };
+}
+//# sourceMappingURL=local-node-config.js.map

package/dist/esm/local-node-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-node-config.js","sourceRoot":"","sources":["../../src/local-node-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAwB3D,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC;AACpD,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE1H,MAAM,UAAU,8BAA8B,CAAC,OAAqC;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,wBAAwB,CAAC;IAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,0BAA0B,CAAC;IAE/F,OAAO;QACL,GAAG,sBAAsB;QACzB,OAAO,EAAmB,OAAO,CAAC,OAAO,IAAI,UAAU,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE;QACjF,SAAS,EAAiB,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,UAAU;QACzF,eAAe,EAAW,OAAO,CAAC,eAAe,IAAI,IAAI;QACzD,kBAAkB,EAAQ,OAAO,CAAC,kBAAkB,IAAI,sBAAsB,CAAC,kBAAkB;QACjG,iBAAiB,EAAS,OAAO,CAAC,iBAAiB,IAAI,IAAI;QAC3D,QAAQ;QACR,uBAAuB,EAAG,OAAO,CAAC,cAAc,IAAI,EAAE;QACtD,uBAAuB,EAAG,IAAI;QAC9B,QAAQ,EAAkB,OAAO,CAAC,QAAQ,IAAI,sBAAsB,CAAC,QAAQ;QAC7E,iBAAiB,EAAS,OAAO,CAAC,iBAAiB,IAAI,aAAa;QACpE,YAAY,EAAc,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,UAAU;QAChG,eAAe,EAAW,OAAO,CAAC,eAAe,IAAI,sBAAsB,CAAC,eAAe;QAC3F,IAAI,EAAsB,OAAO,CAAC,IAAI;QACtC,oBAAoB,EAAM,OAAO,CAAC,oBAAoB,IAAI,sBAAsB,CAAC,oBAAoB;QACrG,kBAAkB,EAAQ,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,UAAU;QAC7G,UAAU,EAAgB,OAAO,CAAC,UAAU,IAAI,sBAAsB,CAAC,UAAU;QACjF,sBAAsB,EAAI,OAAO,CAAC,sBAAsB,IAAI,sBAAsB,CAAC,sBAAsB;QACzG,WAAW,EAAe,OAAO,CAAC,WAAW,IAAI,sBAAsB,CAAC,WAAW;QACnF,gBAAgB,EAAU,OAAO,CAAC,gBAAgB,IAAI,sBAAsB,CAAC,gBAAgB;KAC9F,CAAC;AACJ,CAAC"}

package/dist/esm/local-node.js

@@ -0,0 +1,395 @@
+var _a;
+import { DwnDiscoveryFile as DefaultDwnDiscoveryFile, localDwnPortCandidates, localDwnServerName, } from '@enbox/agent';
+import { LocalNodePairingManager as DefaultLocalNodePairingManager, DwnServer } from '@enbox/dwn-server';
+import { createLocalNodeDwnServerConfig } from './local-node-config.js';
+import { LocalNodePairingSessionFile } from './pairing-session-store.js';
+export class LocalNodeAlreadyRunningError extends Error {
+    endpoint;
+    pid;
+    constructor(existingNode) {
+        super(`LocalNode: local node is already running at ${existingNode.endpoint}.`);
+        this.name = 'LocalNodeAlreadyRunningError';
+        this.endpoint = existingNode.endpoint;
+        this.pid = existingNode.pid;
+    }
+}
+export class LocalNode {
+    #allowedOrigins;
+    #configOptions;
+    #createServer;
+    #discoveryFile;
+    #fetch;
+    #pairingBroker;
+    #pairingManager;
+    #pairingPollIntervalMs;
+    #pairingSessionStore;
+    #pid;
+    #portCandidates;
+    #endpoint;
+    #localNodeToken;
+    #pairingBrokerLoopFailure;
+    #pairingBrokerProcessing;
+    #pairingBrokerTimer;
+    #pairingSessionChangeUnsubscribe;
+    #pairingSessionWriteFailure;
+    #pairingSessionWriteQueue = Promise.resolve();
+    #port;
+    #server;
+    #state = 'stopped';
+    constructor(options = {}) {
+        this.#allowedOrigins = options.allowedOrigins ?? [];
+        this.#configOptions = {
+            baseUrl: options.baseUrl,
+            dataStore: options.dataStore,
+            deliveryEnabled: options.deliveryEnabled,
+            eventBusPluginPath: options.eventBusPluginPath,
+            forwardingEnabled: options.forwardingEnabled,
+            hostname: options.hostname,
+            logLevel: options.logLevel,
+            maxRecordDataSize: options.maxRecordDataSize,
+            messageStore: options.messageStore,
+            packageJsonPath: options.packageJsonPath,
+            registrationStoreUrl: options.registrationStoreUrl,
+            resumableTaskStore: options.resumableTaskStore,
+            serverName: options.serverName,
+            storageUrl: options.storageUrl,
+            termsOfServiceFilePath: options.termsOfServiceFilePath,
+            ttlCacheUrl: options.ttlCacheUrl,
+            webSocketSupport: options.webSocketSupport,
+        };
+        this.#createServer = options.createServer ?? _a.#createDwnServer;
+        this.#discoveryFile = options.discoveryFile ?? new DefaultDwnDiscoveryFile();
+        this.#fetch = options.fetch ?? fetch;
+        this.#pairingBroker = options.pairingBroker;
+        this.#pairingManager = options.pairingManager ?? new DefaultLocalNodePairingManager();
+        this.#pairingPollIntervalMs = options.pairingPollIntervalMs ?? 500;
+        this.#pairingSessionStore = options.pairingSessionStore ?? new LocalNodePairingSessionFile();
+        this.#pid = options.pid ?? process.pid;
+        this.#portCandidates = options.portCandidates ?? localDwnPortCandidates;
+    }
+    get discoveryFilePath() {
+        return this.#discoveryFile.path;
+    }
+    get endpoint() {
+        return this.#endpoint;
+    }
+    get pairingManager() {
+        return this.#pairingManager;
+    }
+    get state() {
+        return this.#state;
+    }
+    async start() {
+        if (this.#state === 'running') {
+            return this.#getStartResult();
+        }
+        const existingNode = await this.findExistingNode();
+        if (existingNode !== undefined) {
+            throw new LocalNodeAlreadyRunningError(existingNode);
+        }
+        await this.#loadPairingSessions();
+        const localNodeToken = this.#pairingManager.createSession(undefined);
+        this.#subscribeToPairingSessionChanges();
+        try {
+            const startResult = await this.#startFirstAvailableServer();
+            this.#server = startResult.server;
+            this.#port = startResult.port;
+            this.#endpoint = startResult.endpoint;
+            this.#localNodeToken = localNodeToken;
+            this.#state = 'running';
+            await this.#writeDiscoveryFile();
+            this.#startPairingBrokerLoop();
+        }
+        catch (error) {
+            await this.#cleanupStartedServer();
+            throw error;
+        }
+        return this.#getStartResult();
+    }
+    async stop() {
+        if (this.#state === 'stopped') {
+            return;
+        }
+        this.#stopPairingBrokerLoop();
+        let stopFailure;
+        try {
+            await this.#discoveryFile.remove();
+        }
+        catch (error) {
+            stopFailure = { error };
+        }
+        try {
+            await this.#server?.stop();
+        }
+        catch (error) {
+            stopFailure ??= { error };
+        }
+        this.#unsubscribeFromPairingSessionChanges();
+        try {
+            await this.#flushPairingSessionWrites();
+        }
+        catch (error) {
+            stopFailure ??= { error };
+        }
+        stopFailure ??= this.#pairingBrokerLoopFailure;
+        this.#endpoint = undefined;
+        this.#localNodeToken = undefined;
+        this.#pairingBrokerLoopFailure = undefined;
+        this.#port = undefined;
+        this.#server = undefined;
+        this.#state = 'stopped';
+        if (stopFailure !== undefined) {
+            throw stopFailure.error;
+        }
+    }
+    async findExistingNode() {
+        const record = await this.#discoveryFile.read();
+        if (record === undefined) {
+            return undefined;
+        }
+        const isLive = await this.#isLiveLocalNode(record.endpoint);
+        if (!isLive) {
+            await this.#discoveryFile.remove();
+            return undefined;
+        }
+        return {
+            endpoint: record.endpoint,
+            pid: record.pid,
+        };
+    }
+    getStatus() {
+        return {
+            discoveryFilePath: this.#discoveryFile.path,
+            endpoint: this.#endpoint,
+            localNodeToken: this.#localNodeToken,
+            pendingPairingRequests: this.#pairingManager.listPendingRequests(),
+            pid: this.#pid,
+            port: this.#port,
+            state: this.#state,
+            webSocketSupport: this.#configOptions.webSocketSupport ?? true,
+        };
+    }
+    async revokePairingToken(token) {
+        const revoked = this.#server?.revokeLocalNodePairingToken !== undefined
+            ? await this.#server.revokeLocalNodePairingToken(token)
+            : this.#pairingManager.revokeToken(token);
+        if (!revoked) {
+            return false;
+        }
+        await this.#flushPairingSessionWrites();
+        return true;
+    }
+    async processPendingPairingRequests() {
+        if (this.#pairingBroker === undefined) {
+            return;
+        }
+        if (this.#pairingBrokerProcessing !== undefined) {
+            await this.#pairingBrokerProcessing;
+            return;
+        }
+        const processing = this.#processPendingPairingRequests();
+        this.#pairingBrokerProcessing = processing;
+        try {
+            await processing;
+        }
+        finally {
+            this.#pairingBrokerProcessing = undefined;
+        }
+    }
+    async #processPendingPairingRequests() {
+        const pendingRequests = this.#pairingManager.listPendingRequests();
+        for (const request of pendingRequests) {
+            await this.#processPairingRequest(request);
+        }
+    }
+    static #createDwnServer(config, pairingManager) {
+        return new DwnServer({
+            config,
+            localNodePairingManager: pairingManager,
+        });
+    }
+    async #startFirstAvailableServer() {
+        for (const port of this.#portCandidates) {
+            const config = createLocalNodeDwnServerConfig({
+                ...this.#configOptions,
+                allowedOrigins: this.#allowedOrigins,
+                port,
+            });
+            const server = this.#createServer(config, this.#pairingManager);
+            try {
+                await server.start();
+                return {
+                    endpoint: config.baseUrl,
+                    port,
+                    server,
+                };
+            }
+            catch (error) {
+                await _a.#closeFailedServer(server);
+                if (!isAddressInUseError(error) || this.#portCandidates.length === 1) {
+                    throw error;
+                }
+            }
+        }
+        throw new Error(`LocalNode: no available port found in ${Array.from(this.#portCandidates).join(', ')}.`);
+    }
+    async #writeDiscoveryFile() {
+        if (this.#endpoint === undefined || this.#localNodeToken === undefined) {
+            throw new Error('LocalNode: cannot write discovery file before the node has started.');
+        }
+        const capabilities = this.#configOptions.webSocketSupport === false ? ['http'] : ['http', 'ws'];
+        const record = {
+            capabilities,
+            endpoint: this.#endpoint,
+            localNodeToken: this.#localNodeToken,
+            pid: this.#pid,
+        };
+        await this.#discoveryFile.write(record);
+    }
+    #startPairingBrokerLoop() {
+        if (this.#pairingBroker === undefined || this.#pairingBrokerTimer !== undefined) {
+            return;
+        }
+        void this.processPendingPairingRequests().catch((error) => {
+            this.#pairingBrokerLoopFailure ??= { error };
+        });
+        this.#pairingBrokerTimer = setInterval(() => {
+            void this.processPendingPairingRequests().catch((error) => {
+                this.#pairingBrokerLoopFailure ??= { error };
+            });
+        }, this.#pairingPollIntervalMs);
+    }
+    #stopPairingBrokerLoop() {
+        if (this.#pairingBrokerTimer === undefined) {
+            return;
+        }
+        clearInterval(this.#pairingBrokerTimer);
+        this.#pairingBrokerTimer = undefined;
+    }
+    async #processPairingRequest(request) {
+        const decision = await this.#pairingBroker.decidePairingRequest(request);
+        if (decision === 'approve') {
+            const approved = this.#pairingManager.approveRequest(request.id);
+            if (approved) {
+                await this.#flushPairingSessionWrites();
+            }
+        }
+        else {
+            this.#pairingManager.denyRequest(request.id);
+        }
+    }
+    async #isLiveLocalNode(endpoint) {
+        try {
+            const endpointWithTrailingSlash = endpoint.endsWith('/') ? endpoint : `${endpoint}/`;
+            const response = await this.#fetch(new URL('info', endpointWithTrailingSlash).toString());
+            if (!response.ok) {
+                return false;
+            }
+            const serverInfo = await response.json();
+            return serverInfo.server === localDwnServerName && serverInfo.localNode === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async #loadPairingSessions() {
+        const sessions = await this.#pairingSessionStore.read();
+        this.#pairingManager.importSessions(sessions);
+    }
+    #subscribeToPairingSessionChanges() {
+        this.#pairingSessionChangeUnsubscribe = this.#pairingManager.onSessionsChanged((sessions) => {
+            const browserSessions = sessions
+                .filter((session) => session.origin !== undefined);
+            this.#pairingSessionWriteQueue = this.#pairingSessionWriteQueue.then(async () => {
+                try {
+                    await this.#pairingSessionStore.write(browserSessions);
+                }
+                catch (error) {
+                    this.#pairingSessionWriteFailure ??= { error };
+                }
+            });
+        });
+    }
+    #unsubscribeFromPairingSessionChanges() {
+        this.#pairingSessionChangeUnsubscribe?.();
+        this.#pairingSessionChangeUnsubscribe = undefined;
+    }
+    async #flushPairingSessionWrites() {
+        let pendingWrites;
+        do {
+            pendingWrites = this.#pairingSessionWriteQueue;
+            await pendingWrites;
+        } while (pendingWrites !== this.#pairingSessionWriteQueue);
+        const failure = this.#pairingSessionWriteFailure;
+        this.#pairingSessionWriteFailure = undefined;
+        if (failure !== undefined) {
+            throw failure.error;
+        }
+    }
+    async #waitForPairingSessionWrites() {
+        let pendingWrites;
+        do {
+            pendingWrites = this.#pairingSessionWriteQueue;
+            await pendingWrites;
+        } while (pendingWrites !== this.#pairingSessionWriteQueue);
+    }
+    #getStartResult() {
+        if (this.#endpoint === undefined || this.#localNodeToken === undefined || this.#port === undefined) {
+            throw new Error('LocalNode: node is not running.');
+        }
+        return {
+            discoveryFilePath: this.#discoveryFile.path,
+            endpoint: this.#endpoint,
+            localNodeToken: this.#localNodeToken,
+            pid: this.#pid,
+            port: this.#port,
+        };
+    }
+    static async #closeFailedServer(server) {
+        try {
+            await server.stop();
+        }
+        catch {
+            // Best-effort cleanup for partially-started servers.
+        }
+        try {
+            await server.dwn?.close();
+        }
+        catch {
+            // Best-effort cleanup for partially-created DWN instances.
+        }
+    }
+    async #cleanupStartedServer() {
+        this.#stopPairingBrokerLoop();
+        try {
+            await this.#server?.stop();
+        }
+        finally {
+            this.#unsubscribeFromPairingSessionChanges();
+            await this.#waitForPairingSessionWrites();
+            this.#endpoint = undefined;
+            this.#localNodeToken = undefined;
+            this.#pairingBrokerLoopFailure = undefined;
+            this.#port = undefined;
+            this.#server = undefined;
+            this.#state = 'stopped';
+        }
+    }
+}
+_a = LocalNode;
+function isAddressInUseError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const maybeCode = error.code;
+    if (maybeCode === 'EADDRINUSE') {
+        return true;
+    }
+    const maybeMessage = error.message;
+    if (typeof maybeMessage === 'string' && maybeMessage.toLowerCase().includes('address already in use')) {
+        return true;
+    }
+    const maybeCause = error.cause;
+    return isAddressInUseError(maybeCause);
+}
+//# sourceMappingURL=local-node.js.map

package/dist/esm/local-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-node.js","sourceRoot":"","sources":["../../src/local-node.ts"],"names":[],"mappings":";AAWA,OAAO,EACL,gBAAgB,IAAI,uBAAuB,EAC3C,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,IAAI,8BAA8B,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEzG,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAqDzE,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrC,QAAQ,CAAS;IACjB,GAAG,CAAS;IAE5B,YAAmB,YAA+B;QAChD,KAAK,CAAC,+CAA+C,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACX,eAAe,CAAW;IAC1B,cAAc,CAAgE;IAC9E,aAAa,CAA2F;IACxG,cAAc,CAAmB;IACjC,MAAM,CAAe;IACrB,cAAc,CAA4B;IAC1C,eAAe,CAA0B;IACzC,sBAAsB,CAAS;IAC/B,oBAAoB,CAA+B;IACnD,IAAI,CAAS;IACb,eAAe,CAAoB;IAE5C,SAAS,CAAqB;IAC9B,eAAe,CAAqB;IACpC,yBAAyB,CAAiC;IAC1D,wBAAwB,CAA4B;IACpD,mBAAmB,CAA6C;IAChE,gCAAgC,CAA2B;IAC3D,2BAA2B,CAAiC;IAC5D,yBAAyB,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7D,KAAK,CAAqB;IAC1B,OAAO,CAAiC;IACxC,MAAM,GAAmB,SAAS,CAAC;IAEnC,YAAmB,UAA4B,EAAE;QAC/C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,cAAc,GAAG;YACpB,OAAO,EAAkB,OAAO,CAAC,OAAO;YACxC,SAAS,EAAgB,OAAO,CAAC,SAAS;YAC1C,eAAe,EAAU,OAAO,CAAC,eAAe;YAChD,kBAAkB,EAAO,OAAO,CAAC,kBAAkB;YACnD,iBAAiB,EAAQ,OAAO,CAAC,iBAAiB;YAClD,QAAQ,EAAiB,OAAO,CAAC,QAAQ;YACzC,QAAQ,EAAiB,OAAO,CAAC,QAAQ;YACzC,iBAAiB,EAAQ,OAAO,CAAC,iBAAiB;YAClD,YAAY,EAAa,OAAO,CAAC,YAAY;YAC7C,eAAe,EAAU,OAAO,CAAC,eAAe;YAChD,oBAAoB,EAAK,OAAO,CAAC,oBAAoB;YACrD,kBAAkB,EAAO,OAAO,CAAC,kBAAkB;YACnD,UAAU,EAAe,OAAO,CAAC,UAAU;YAC3C,UAAU,EAAe,OAAO,CAAC,UAAU;YAC3C,sBAAsB,EAAG,OAAO,CAAC,sBAAsB;YACvD,WAAW,EAAc,OAAO,CAAC,WAAW;YAC5C,gBAAgB,EAAS,OAAO,CAAC,gBAAgB;SAClD,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,EAAS,CAAC,gBAAgB,CAAC;QACxE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,uBAAuB,EAAE,CAAC;QAC7E,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,8BAA8B,EAAE,CAAC;QACtF,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,IAAI,GAAG,CAAC;QACnE,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,IAAI,IAAI,2BAA2B,EAAE,CAAC;QAC7F,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,IAAI,sBAAsB,CAAC;IAC1E,CAAC;IAED,IAAW,iBAAiB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACnD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,4BAA4B,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,iCAAiC,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC;YAC5D,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;YAClC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC;YACtC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;YACtC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YAExB,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACjC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACnC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,IAAI,WAA2C,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,GAAG,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,KAAK,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,qCAAqC,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,KAAK,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,WAAW,KAAK,IAAI,CAAC,yBAAyB,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,IAAI,CAAC,yBAAyB,GAAG,SAAS,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAExB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,WAAW,CAAC,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,QAAQ,EAAG,MAAM,CAAC,QAAQ;YAC1B,GAAG,EAAQ,MAAM,CAAC,GAAG;SACtB,CAAC;IACJ,CAAC;IAEM,SAAS;QACd,OAAO;YACL,iBAAiB,EAAQ,IAAI,CAAC,cAAc,CAAC,IAAI;YACjD,QAAQ,EAAiB,IAAI,CAAC,SAAS;YACvC,cAAc,EAAW,IAAI,CAAC,eAAe;YAC7C,sBAAsB,EAAG,IAAI,CAAC,eAAe,CAAC,mBAAmB,EAAE;YACnE,GAAG,EAAsB,IAAI,CAAC,IAAI;YAClC,IAAI,EAAqB,IAAI,CAAC,KAAK;YACnC,KAAK,EAAoB,IAAI,CAAC,MAAM;YACpC,gBAAgB,EAAS,IAAI,CAAC,cAAc,CAAC,gBAAgB,IAAI,IAAI;SACtE,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAAC,KAAa;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,2BAA2B,KAAK,SAAS;YACrE,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,KAAK,CAAC;YACvD,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,6BAA6B;QACxC,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,CAAC,wBAAwB,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,8BAA8B,EAAE,CAAC;QACzD,IAAI,CAAC,wBAAwB,GAAG,UAAU,CAAC;QAE3C,IAAI,CAAC;YACH,MAAM,UAAU,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,wBAAwB,GAAG,SAAS,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,8BAA8B;QAClC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,mBAAmB,EAAE,CAAC;QACnE,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,MAAuB,EAAE,cAAuC;QACtF,OAAO,IAAI,SAAS,CAAC;YACnB,MAAM;YACN,uBAAuB,EAAE,cAAc;SACxC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,0BAA0B;QAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,8BAA8B,CAAC;gBAC5C,GAAG,IAAI,CAAC,cAAc;gBACtB,cAAc,EAAE,IAAI,CAAC,eAAe;gBACpC,IAAI;aACL,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAEhE,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO;oBACL,QAAQ,EAAE,MAAM,CAAC,OAAO;oBACxB,IAAI;oBACJ,MAAM;iBACP,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,EAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBAC3C,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACrE,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3G,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChG,MAAM,MAAM,GAAuB;YACjC,YAAY;YACZ,QAAQ,EAAS,IAAI,CAAC,SAAS;YAC/B,cAAc,EAAG,IAAI,CAAC,eAAe;YACrC,GAAG,EAAc,IAAI,CAAC,IAAI;SAC3B,CAAC;QAEF,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,uBAAuB;QACrB,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAChF,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,6BAA6B,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAQ,EAAE;YACvE,IAAI,CAAC,yBAAyB,KAAK,EAAE,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC,GAAS,EAAE;YAChD,KAAK,IAAI,CAAC,6BAA6B,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAQ,EAAE;gBACvE,IAAI,CAAC,yBAAyB,KAAK,EAAE,KAAK,EAAE,CAAC;YAC/C,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAClC,CAAC;IAED,sBAAsB;QACpB,IAAI,IAAI,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAC,OAAoC;QAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAe,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC;YAC1C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,IAAI,CAAC;YACH,MAAM,yBAAyB,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;YACrF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1F,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA2B,CAAC;YAClE,OAAO,UAAU,CAAC,MAAM,KAAK,kBAAkB,IAAI,UAAU,CAAC,SAAS,KAAK,IAAI,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,iCAAiC;QAC/B,IAAI,CAAC,gCAAgC,GAAG,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAC5E,CAAC,QAAyC,EAAQ,EAAE;YAClD,MAAM,eAAe,GAAG,QAAQ;iBAC7B,MAAM,CAAC,CAAC,OAAsC,EAAW,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;YAE7F,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,IAAmB,EAAE;gBAC7F,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBACzD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,2BAA2B,KAAK,EAAE,KAAK,EAAE,CAAC;gBACjD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;IAED,qCAAqC;QACnC,IAAI,CAAC,gCAAgC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,gCAAgC,GAAG,SAAS,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,0BAA0B;QAC9B,IAAI,aAA4B,CAAC;QACjC,GAAG,CAAC;YACF,aAAa,GAAG,IAAI,CAAC,yBAAyB,CAAC;YAC/C,MAAM,aAAa,CAAC;QACtB,CAAC,QAAQ,aAAa,KAAK,IAAI,CAAC,yBAAyB,EAAE;QAE3D,MAAM,OAAO,GAAG,IAAI,CAAC,2BAA2B,CAAC;QACjD,IAAI,CAAC,2BAA2B,GAAG,SAAS,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,CAAC,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,4BAA4B;QAChC,IAAI,aAA4B,CAAC;QACjC,GAAG,CAAC;YACF,aAAa,GAAG,IAAI,CAAC,yBAAyB,CAAC;YAC/C,MAAM,aAAa,CAAC;QACtB,CAAC,QAAQ,aAAa,KAAK,IAAI,CAAC,yBAAyB,EAAE;IAC7D,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnG,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,iBAAiB,EAAG,IAAI,CAAC,cAAc,CAAC,IAAI;YAC5C,QAAQ,EAAY,IAAI,CAAC,SAAS;YAClC,cAAc,EAAM,IAAI,CAAC,eAAe;YACxC,GAAG,EAAiB,IAAI,CAAC,IAAI;YAC7B,IAAI,EAAgB,IAAI,CAAC,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAA0B;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,qCAAqC,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,4BAA4B,EAAE,CAAC;YAC1C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YACjC,IAAI,CAAC,yBAAyB,GAAG,SAAS,CAAC;YAC3C,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAI,KAA4B,CAAC,IAAI,CAAC;IACrD,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAI,KAA+B,CAAC,OAAO,CAAC;IAC9D,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACtG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAI,KAA6B,CAAC,KAAK,CAAC;IACxD,OAAO,mBAAmB,CAAC,UAAU,CAAC,CAAC;AACzC,CAAC"}

package/dist/esm/pairing-broker.js

@@ -0,0 +1,44 @@
+import { createInterface } from 'node:readline/promises';
+import { stdin as defaultInput, stdout as defaultOutput } from 'node:process';
+export class AllowOriginPairingBroker {
+    #allowedOrigins;
+    #fallback;
+    constructor(allowedOrigins = [], fallback) {
+        this.#allowedOrigins = new Set(allowedOrigins);
+        this.#fallback = fallback;
+    }
+    async decidePairingRequest(request) {
+        if (this.#allowedOrigins.has(request.origin)) {
+            return 'approve';
+        }
+        if (this.#fallback !== undefined) {
+            return this.#fallback.decidePairingRequest(request);
+        }
+        return 'deny';
+    }
+}
+export class TtyPairingBroker {
+    #input;
+    #output;
+    constructor(options = {}) {
+        this.#input = options.input ?? defaultInput;
+        this.#output = options.output ?? defaultOutput;
+    }
+    async decidePairingRequest(request) {
+        if (this.#input.isTTY !== true || this.#output.isTTY !== true) {
+            return 'deny';
+        }
+        const readline = createInterface({
+            input: this.#input,
+            output: this.#output,
+        });
+        try {
+            const answer = await readline.question(`Approve local DWN pairing for ${request.origin}? [y/N] `);
+            return /^(?:y|yes)$/i.test(answer.trim()) ? 'approve' : 'deny';
+        }
+        finally {
+            readline.close();
+        }
+    }
+}
+//# sourceMappingURL=pairing-broker.js.map

package/dist/esm/pairing-broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-broker.js","sourceRoot":"","sources":["../../src/pairing-broker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,cAAc,CAAC;AAW9E,MAAM,OAAO,wBAAwB;IAC1B,eAAe,CAAc;IAC7B,SAAS,CAA4B;IAE9C,YAAmB,iBAA2B,EAAE,EAAE,QAAwB;QACxE,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAAC,OAAoC;QACpE,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,MAAM,OAAO,gBAAgB;IAClB,MAAM,CAAc;IACpB,OAAO,CAAc;IAE9B,YAAmB,UAAyD,EAAE;QAC5E,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAAC,OAAoC;QACpE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC;YAC/B,KAAK,EAAI,IAAI,CAAC,MAAM;YACpB,MAAM,EAAG,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,iCAAiC,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;YAClG,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QACjE,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}