@enbox/local-node 0.0.1

package/dist/esm/pairing-session-store.js

@@ -0,0 +1,98 @@
+import { homedir } from 'node:os';
+import { chmod, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export const LOCAL_NODE_PAIRING_SESSIONS_FILENAME = 'local-node-sessions.json';
+const localNodePairingSessionsVersion = 1;
+export class LocalNodePairingSessionFile {
+    #filePath;
+    constructor(filePath) {
+        this.#filePath = filePath ?? join(homedir(), '.enbox', LOCAL_NODE_PAIRING_SESSIONS_FILENAME);
+    }
+    get path() {
+        return this.#filePath;
+    }
+    async read() {
+        let raw;
+        try {
+            raw = await readFile(this.#filePath, 'utf-8');
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return [];
+            }
+            throw error;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            await this.remove();
+            return [];
+        }
+        if (!isValidPairingSessionsFile(parsed)) {
+            await this.remove();
+            return [];
+        }
+        return parsed.sessions.map((session) => ({
+            createdAt: session.createdAt,
+            origin: session.origin,
+            token: session.token,
+        }));
+    }
+    async write(sessions) {
+        const browserSessions = sessions.filter((session) => session.origin !== undefined);
+        const serialized = {
+            sessions: browserSessions,
+            version: localNodePairingSessionsVersion,
+        };
+        const json = JSON.stringify(serialized, null, 2);
+        const tempPath = `${this.#filePath}.${process.pid}.tmp`;
+        await mkdir(dirname(this.#filePath), { recursive: true });
+        await writeFile(tempPath, json, { encoding: 'utf-8', mode: 0o600 });
+        await rename(tempPath, this.#filePath);
+        await chmod(this.#filePath, 0o600);
+    }
+    async remove() {
+        await rm(this.#filePath, { force: true });
+    }
+}
+function isMissingFileError(error) {
+    return Boolean(error)
+        && typeof error === 'object'
+        && error.code === 'ENOENT';
+}
+function isValidPairingSessionsFile(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const file = value;
+    return file.version === localNodePairingSessionsVersion
+        && Array.isArray(file.sessions)
+        && file.sessions.every(isValidPairingSession);
+}
+function isValidPairingSession(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const session = value;
+    const createdAt = session.createdAt;
+    return typeof createdAt === 'number'
+        && Number.isInteger(createdAt)
+        && createdAt > 0
+        && typeof session.token === 'string'
+        && session.token.length > 0
+        && typeof session.origin === 'string'
+        && isValidHttpOrigin(session.origin);
+}
+function isValidHttpOrigin(origin) {
+    try {
+        const url = new URL(origin);
+        return (url.protocol === 'http:' || url.protocol === 'https:')
+            && url.origin === origin;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=pairing-session-store.js.map

package/dist/esm/pairing-session-store.js.map

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

package/dist/types/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/types/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -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.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/types/local-node-config.d.ts

@@ -0,0 +1,26 @@
+import type { DwnServerConfig } from '@enbox/dwn-server';
+export type LocalNodeServerConfigOptions = {
+    allowedOrigins?: string[];
+    baseUrl?: string;
+    dataStore?: string;
+    deliveryEnabled?: boolean;
+    eventBusPluginPath?: string;
+    forwardingEnabled?: boolean;
+    hostname?: string;
+    logLevel?: string;
+    maxRecordDataSize?: number;
+    messageStore?: string;
+    packageJsonPath?: string;
+    port: number;
+    registrationStoreUrl?: string;
+    resumableTaskStore?: string;
+    serverName?: string;
+    storageUrl?: string;
+    termsOfServiceFilePath?: string;
+    ttlCacheUrl?: string;
+    webSocketSupport?: boolean;
+};
+export declare const defaultLocalNodeHostname = "127.0.0.1";
+export declare const defaultLocalNodeStorageUrl: string;
+export declare function createLocalNodeDwnServerConfig(options: LocalNodeServerConfigOptions): DwnServerConfig;
+//# sourceMappingURL=local-node-config.d.ts.map

package/dist/types/local-node-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-node-config.d.ts","sourceRoot":"","sources":["../../src/local-node-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQzD,MAAM,MAAM,4BAA4B,GAAG;IACzC,cAAc,CAAC,EAAG,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAG,MAAM,CAAC;IAClB,SAAS,CAAC,EAAG,MAAM,CAAC;IACpB,eAAe,CAAC,EAAG,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAG,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAG,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAG,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAG,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,eAAe,CAAC,EAAG,MAAM,CAAC;IAC1B,IAAI,EAAG,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAG,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAG,MAAM,CAAC;IACjC,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAG,OAAO,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,wBAAwB,cAAc,CAAC;AACpD,eAAO,MAAM,0BAA0B,QAAkF,CAAC;AAE1H,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,4BAA4B,GAAG,eAAe,CA0BrG"}

package/dist/types/local-node.d.ts

@@ -0,0 +1,67 @@
+import type { LocalNodePairingSessionStore } from './pairing-session-store.js';
+import type { LocalNodeServerConfigOptions } from './local-node-config.js';
+import type { PairingBroker } from './pairing-broker.js';
+import type { DwnDiscoveryFile } from '@enbox/agent';
+import type { DwnServerConfig, LocalNodePairingManager, LocalNodePairingRequestView } from '@enbox/dwn-server';
+export type LocalNodeState = 'stopped' | 'running';
+export type LocalNodeDwnServer = {
+    dwn?: {
+        close(): Promise<void>;
+    };
+    localNodePairingManager: LocalNodePairingManager;
+    revokeLocalNodePairingToken?(token: string): Promise<boolean>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+};
+export type LocalNodeStartResult = {
+    discoveryFilePath: string;
+    endpoint: string;
+    localNodeToken: string;
+    pid: number;
+    port: number;
+};
+export type LocalNodeStatus = {
+    discoveryFilePath: string;
+    endpoint?: string;
+    localNodeToken?: string;
+    pendingPairingRequests: LocalNodePairingRequestView[];
+    pid: number;
+    port?: number;
+    state: LocalNodeState;
+    webSocketSupport: boolean;
+};
+export type ExistingLocalNode = {
+    endpoint: string;
+    pid: number;
+};
+export type LocalNodeOptions = Omit<LocalNodeServerConfigOptions, 'port'> & {
+    createServer?: (config: DwnServerConfig, pairingManager: LocalNodePairingManager) => LocalNodeDwnServer;
+    discoveryFile?: DwnDiscoveryFile;
+    fetch?: typeof fetch;
+    pairingBroker?: PairingBroker;
+    pairingPollIntervalMs?: number;
+    pairingManager?: LocalNodePairingManager;
+    pairingSessionStore?: LocalNodePairingSessionStore;
+    pid?: number;
+    portCandidates?: readonly number[];
+};
+export declare class LocalNodeAlreadyRunningError extends Error {
+    readonly endpoint: string;
+    readonly pid: number;
+    constructor(existingNode: ExistingLocalNode);
+}
+export declare class LocalNode {
+    #private;
+    constructor(options?: LocalNodeOptions);
+    get discoveryFilePath(): string;
+    get endpoint(): string | undefined;
+    get pairingManager(): LocalNodePairingManager;
+    get state(): LocalNodeState;
+    start(): Promise<LocalNodeStartResult>;
+    stop(): Promise<void>;
+    findExistingNode(): Promise<ExistingLocalNode | undefined>;
+    getStatus(): LocalNodeStatus;
+    revokePairingToken(token: string): Promise<boolean>;
+    processPendingPairingRequests(): Promise<void>;
+}
+//# sourceMappingURL=local-node.d.ts.map

package/dist/types/local-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-node.d.ts","sourceRoot":"","sources":["../../src/local-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAE5B,MAAM,mBAAmB,CAAC;AAY3B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACjC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,2BAA2B,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB,EAAG,MAAM,CAAC;IAC3B,QAAQ,EAAG,MAAM,CAAC;IAClB,cAAc,EAAG,MAAM,CAAC;IACxB,GAAG,EAAG,MAAM,CAAC;IACb,IAAI,EAAG,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,iBAAiB,EAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAG,MAAM,CAAC;IACnB,cAAc,CAAC,EAAG,MAAM,CAAC;IACzB,sBAAsB,EAAG,2BAA2B,EAAE,CAAC;IACvD,GAAG,EAAG,MAAM,CAAC;IACb,IAAI,CAAC,EAAG,MAAM,CAAC;IACf,KAAK,EAAG,cAAc,CAAC;IACvB,gBAAgB,EAAG,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAG,MAAM,CAAC;IAClB,GAAG,EAAG,MAAM,CAAC;CACd,CAAC;AAOF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,4BAA4B,EAAE,MAAM,CAAC,GAAG;IAC1E,YAAY,CAAC,EAAG,CAAC,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,KAAK,kBAAkB,CAAC;IACzG,aAAa,CAAC,EAAG,gBAAgB,CAAC;IAClC,KAAK,CAAC,EAAG,OAAO,KAAK,CAAC;IACtB,aAAa,CAAC,EAAG,aAAa,CAAC;IAC/B,qBAAqB,CAAC,EAAG,MAAM,CAAC;IAChC,cAAc,CAAC,EAAG,uBAAuB,CAAC;IAC1C,mBAAmB,CAAC,EAAG,4BAA4B,CAAC;IACpD,GAAG,CAAC,EAAG,MAAM,CAAC;IACd,cAAc,CAAC,EAAG,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAET,YAAY,EAAE,iBAAiB;CAMnD;AAED,qBAAa,SAAS;;gBAyBD,OAAO,GAAE,gBAAqB;IAgCjD,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,IAAW,cAAc,IAAI,uBAAuB,CAEnD;IAED,IAAW,KAAK,IAAI,cAAc,CAEjC;IAEY,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAgCtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCrB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAkBhE,SAAS,IAAI,eAAe;IAatB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnD,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;CA6N5D"}

package/dist/types/pairing-broker.d.ts

@@ -0,0 +1,27 @@
+import type { LocalNodePairingRequestView } from '@enbox/dwn-server';
+import type { Readable, Writable } from 'node:stream';
+type TtyReadable = Readable & {
+    isTTY?: boolean;
+};
+type TtyWritable = Writable & {
+    isTTY?: boolean;
+};
+export type PairingDecision = 'approve' | 'deny';
+export interface PairingBroker {
+    decidePairingRequest(request: LocalNodePairingRequestView): Promise<PairingDecision>;
+}
+export declare class AllowOriginPairingBroker implements PairingBroker {
+    #private;
+    constructor(allowedOrigins?: string[], fallback?: PairingBroker);
+    decidePairingRequest(request: LocalNodePairingRequestView): Promise<PairingDecision>;
+}
+export declare class TtyPairingBroker implements PairingBroker {
+    #private;
+    constructor(options?: {
+        input?: TtyReadable;
+        output?: TtyWritable;
+    });
+    decidePairingRequest(request: LocalNodePairingRequestView): Promise<PairingDecision>;
+}
+export {};
+//# sourceMappingURL=pairing-broker.d.ts.map

package/dist/types/pairing-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-broker.d.ts","sourceRoot":"","sources":["../../src/pairing-broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKtD,KAAK,WAAW,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAClD,KAAK,WAAW,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACtF;AAED,qBAAa,wBAAyB,YAAW,aAAa;;gBAIzC,cAAc,GAAE,MAAM,EAAO,EAAE,QAAQ,CAAC,EAAE,aAAa;IAK7D,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;CAWlG;AAED,qBAAa,gBAAiB,YAAW,aAAa;;gBAIjC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO;IAKjE,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;CAiBlG"}

package/dist/types/pairing-session-store.d.ts

@@ -0,0 +1,17 @@
+import type { LocalNodePairingSessionRecord } from '@enbox/dwn-server';
+export declare const LOCAL_NODE_PAIRING_SESSIONS_FILENAME = "local-node-sessions.json";
+export interface LocalNodePairingSessionStore {
+    readonly path: string;
+    read(): Promise<LocalNodePairingSessionRecord[]>;
+    remove(): Promise<void>;
+    write(sessions: LocalNodePairingSessionRecord[]): Promise<void>;
+}
+export declare class LocalNodePairingSessionFile implements LocalNodePairingSessionStore {
+    #private;
+    constructor(filePath?: string);
+    get path(): string;
+    read(): Promise<LocalNodePairingSessionRecord[]>;
+    write(sessions: LocalNodePairingSessionRecord[]): Promise<void>;
+    remove(): Promise<void>;
+}
+//# sourceMappingURL=pairing-session-store.d.ts.map

package/dist/types/pairing-session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-session-store.d.ts","sourceRoot":"","sources":["../../src/pairing-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAMvE,eAAO,MAAM,oCAAoC,6BAA6B,CAAC;AAI/E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,CAAC,QAAQ,EAAE,6BAA6B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,qBAAa,2BAA4B,YAAW,4BAA4B;;gBAG3D,QAAQ,CAAC,EAAE,MAAM;IAIpC,IAAW,IAAI,IAAI,MAAM,CAExB;IAEY,IAAI,IAAI,OAAO,CAAC,6BAA6B,EAAE,CAAC;IA+BhD,KAAK,CAAC,QAAQ,EAAE,6BAA6B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@enbox/local-node",
+  "version": "0.0.1",
+  "description": "Shell-agnostic local DWN node runtime for Enbox",
+  "type": "module",
+  "main": "./dist/esm/index.js",
+  "module": "./dist/esm/index.js",
+  "sideEffects": false,
+  "types": "./dist/types/index.d.ts",
+  "bin": {
+    "enbox-local-node": "./dist/esm/cli.js"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build:esm": "rm -rf dist/esm dist/types && bun tsc -p tsconfig.json",
+    "build": "bun run clean && bun run build:esm",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "test:node": "bun test --timeout 10000 .spec.ts",
+    "test:node:coverage": "bun test --coverage --coverage-reporter=text --coverage-reporter=lcov --coverage-dir=coverage .spec.ts"
+  },
+  "homepage": "https://github.com/enboxorg/enbox/tree/main/packages/local-node#readme",
+  "bugs": "https://github.com/enboxorg/enbox/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/enboxorg/enbox.git",
+    "directory": "packages/local-node"
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "dependencies": {
+    "@enbox/agent": "0.8.15",
+    "@enbox/dwn-server": "0.1.20"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.15",
+    "@typescript-eslint/eslint-plugin": "8.32.1",
+    "@typescript-eslint/parser": "8.32.1",
+    "bun-types": "1.3.14",
+    "eslint": "9.7.0",
+    "typescript": "5.9.3"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,116 @@
+#!/usr/bin/env bun
+
+import { AllowOriginPairingBroker, LocalNode, TtyPairingBroker } from './index.js';
+
+type CliOptions = {
+  allowedOrigins : string[];
+  help : boolean;
+  hostname? : string;
+  port? : number;
+  storageUrl? : string;
+  webSocketSupport : boolean;
+};
+
+function parseArgs(args: string[]): CliOptions {
+  const options: CliOptions = {
+    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: string[], index: number, flag: string): string {
+  const value = args[index + 1];
+  if (value === undefined || value.startsWith('-')) {
+    throw new Error(`${flag} requires a value.`);
+  }
+  return value;
+}
+
+function parsePort(value: string): number {
+  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(): void {
+  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(): Promise<void> {
+  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 (): Promise<void> => {
+    await node.stop();
+    process.exit(0);
+  };
+
+  process.on('SIGINT', () => {
+    void shutdown();
+  });
+  process.on('SIGTERM', () => {
+    void shutdown();
+  });
+
+  await new Promise((): void => {});
+}
+
+try {
+  await run();
+} catch (error: unknown) {
+  console.error(error);
+  process.exit(1);
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './local-node.js';
+export * from './local-node-config.js';
+export * from './pairing-session-store.js';
+export * from './pairing-broker.js';

package/src/local-node-config.ts

@@ -0,0 +1,60 @@
+import type { DwnServerConfig } from '@enbox/dwn-server';
+
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { defaultDwnServerConfig } from '@enbox/dwn-server';
+
+export type LocalNodeServerConfigOptions = {
+  allowedOrigins? : string[];
+  baseUrl? : string;
+  dataStore? : string;
+  deliveryEnabled? : boolean;
+  eventBusPluginPath? : string;
+  forwardingEnabled? : boolean;
+  hostname? : string;
+  logLevel? : string;
+  maxRecordDataSize? : number;
+  messageStore? : string;
+  packageJsonPath? : string;
+  port : number;
+  registrationStoreUrl? : string;
+  resumableTaskStore? : string;
+  serverName? : string;
+  storageUrl? : string;
+  termsOfServiceFilePath? : string;
+  ttlCacheUrl? : string;
+  webSocketSupport? : boolean;
+};
+
+export const defaultLocalNodeHostname = '127.0.0.1';
+export const defaultLocalNodeStorageUrl = pathToFileURL(join(homedir(), '.enbox', 'dwn')).href.replace('file:', 'level:');
+
+export function createLocalNodeDwnServerConfig(options: LocalNodeServerConfigOptions): DwnServerConfig {
+  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,
+  };
+}