@garydevenay/emporion 0.0.1

package/dist/src/storage.d.ts

@@ -0,0 +1,36 @@
+import Hyperbee from "hyperbee";
+import Hypercore from "hypercore";
+import type { Logger } from "./logger.js";
+import type { ReplicationDescriptor } from "./types.js";
+type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare class TransportStorage {
+    private readonly store;
+    private readonly logger;
+    private readonly feedNamespace;
+    private readonly indexNamespace;
+    private readonly localDescriptors;
+    private readonly feeds;
+    private readonly indexes;
+    private readonly remoteFeeds;
+    private readonly remoteIndexes;
+    private constructor();
+    static create(dataDir: string, primaryKey: Buffer, logger: Logger): Promise<TransportStorage>;
+    initializeDefaults(): Promise<{
+        controlFeed: Hypercore<JsonValue>;
+        eventsFeed: Hypercore<JsonValue>;
+        controlDescriptor: ReplicationDescriptor;
+        eventsDescriptor: ReplicationDescriptor;
+    }>;
+    openFeed(name: string): Promise<Hypercore<JsonValue>>;
+    openIndex(name: string): Promise<Hyperbee<string, JsonValue>>;
+    getReplicationDescriptors(): ReplicationDescriptor[];
+    getLocalFeedKey(name: string): string;
+    trackRemoteDescriptors(descriptors: ReplicationDescriptor[]): Promise<void>;
+    getRemoteFeed(key: string): Hypercore<JsonValue> | undefined;
+    replicate(connection: NodeJS.ReadWriteStream): NodeJS.ReadWriteStream;
+    close(): Promise<void>;
+    private mustGetLocalDescriptor;
+}
+export {};

package/dist/src/storage.js

@@ -0,0 +1,156 @@
+import { mkdir } from "node:fs/promises";
+import path from "node:path";
+import Corestore from "corestore";
+import Hyperbee from "hyperbee";
+import { StorageError } from "./errors.js";
+function isNonEmptyString(value, fieldName) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new StorageError(`${fieldName} must not be blank`);
+    }
+    return trimmed;
+}
+export class TransportStorage {
+    store;
+    logger;
+    feedNamespace;
+    indexNamespace;
+    localDescriptors = new Map();
+    feeds = new Map();
+    indexes = new Map();
+    remoteFeeds = new Map();
+    remoteIndexes = new Map();
+    constructor(store, logger) {
+        this.store = store;
+        this.logger = logger;
+        this.feedNamespace = store.namespace("feeds");
+        this.indexNamespace = store.namespace("indexes");
+    }
+    static async create(dataDir, primaryKey, logger) {
+        const storageDir = path.join(dataDir, "store");
+        await mkdir(storageDir, { recursive: true });
+        // We intentionally derive the store primary key from the persisted agent root seed
+        // so named cores remain stable across restarts.
+        const store = new Corestore(storageDir, { primaryKey, unsafe: true });
+        await store.ready();
+        return new TransportStorage(store, logger);
+    }
+    async initializeDefaults() {
+        const controlFeed = await this.openFeed("control");
+        const eventsFeed = await this.openFeed("events");
+        return {
+            controlFeed,
+            eventsFeed,
+            controlDescriptor: this.mustGetLocalDescriptor("control"),
+            eventsDescriptor: this.mustGetLocalDescriptor("events")
+        };
+    }
+    async openFeed(name) {
+        const normalizedName = isNonEmptyString(name, "Feed name");
+        const existing = this.feeds.get(normalizedName);
+        if (existing) {
+            return existing.core;
+        }
+        const core = this.feedNamespace.get({
+            name: normalizedName,
+            valueEncoding: "json"
+        });
+        await core.ready();
+        const descriptor = {
+            name: normalizedName,
+            key: core.key.toString("hex"),
+            kind: "feed"
+        };
+        this.localDescriptors.set(normalizedName, descriptor);
+        this.feeds.set(normalizedName, { core, descriptor });
+        this.logger.debug("Opened local feed", { ...descriptor });
+        return core;
+    }
+    async openIndex(name) {
+        const normalizedName = isNonEmptyString(name, "Index name");
+        const existing = this.indexes.get(normalizedName);
+        if (existing) {
+            return existing.bee;
+        }
+        const core = this.indexNamespace.get({
+            name: normalizedName
+        });
+        await core.ready();
+        const bee = new Hyperbee(core, {
+            keyEncoding: "utf-8",
+            valueEncoding: "json"
+        });
+        await bee.ready();
+        const descriptor = {
+            name: normalizedName,
+            key: core.key.toString("hex"),
+            kind: "index"
+        };
+        this.localDescriptors.set(normalizedName, descriptor);
+        this.indexes.set(normalizedName, { bee, descriptor });
+        this.logger.debug("Opened local index", { ...descriptor });
+        return bee;
+    }
+    getReplicationDescriptors() {
+        return [...this.localDescriptors.values()].sort((left, right) => left.name.localeCompare(right.name));
+    }
+    getLocalFeedKey(name) {
+        return this.mustGetLocalDescriptor(name).key;
+    }
+    async trackRemoteDescriptors(descriptors) {
+        for (const descriptor of descriptors) {
+            if (descriptor.kind === "feed") {
+                if (this.remoteFeeds.has(descriptor.key)) {
+                    continue;
+                }
+                const core = this.store.get({
+                    key: Buffer.from(descriptor.key, "hex"),
+                    valueEncoding: "json"
+                });
+                await core.ready();
+                const liveDownload = core.download({ start: 0, end: -1, linear: true });
+                this.remoteFeeds.set(descriptor.key, { core, liveDownload });
+                this.logger.debug("Tracked remote feed", { ...descriptor });
+                continue;
+            }
+            if (this.remoteIndexes.has(descriptor.key)) {
+                continue;
+            }
+            const core = this.store.get({
+                key: Buffer.from(descriptor.key, "hex")
+            });
+            await core.ready();
+            const bee = new Hyperbee(core, {
+                keyEncoding: "utf-8",
+                valueEncoding: "json"
+            });
+            await bee.ready();
+            const liveDownload = core.download({ start: 0, end: -1, linear: true });
+            this.remoteIndexes.set(descriptor.key, { bee, liveDownload });
+            this.logger.debug("Tracked remote index", { ...descriptor });
+        }
+    }
+    getRemoteFeed(key) {
+        return this.remoteFeeds.get(key)?.core;
+    }
+    replicate(connection) {
+        return this.store.replicate(connection);
+    }
+    async close() {
+        for (const record of this.remoteFeeds.values()) {
+            record.liveDownload.destroy();
+        }
+        for (const record of this.remoteIndexes.values()) {
+            record.liveDownload.destroy();
+        }
+        await this.store.close();
+    }
+    mustGetLocalDescriptor(name) {
+        const descriptor = this.localDescriptors.get(name);
+        if (!descriptor) {
+            throw new StorageError(`Local descriptor not found for ${name}`);
+        }
+        return descriptor;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/storage.js.map

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

package/dist/src/topics.d.ts

@@ -0,0 +1,3 @@
+import type { TopicRef } from "./types.js";
+export declare function topicRefToCanonicalString(ref: TopicRef): string;
+export declare function topicRefToDiscoveryKey(ref: TopicRef): Buffer;

package/dist/src/topics.js

@@ -0,0 +1,27 @@
+import { createHash } from "node:crypto";
+import { TopicValidationError } from "./errors.js";
+function assertIdentifier(value, fieldName) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new TopicValidationError(`${fieldName} must not be blank`);
+    }
+    if (!/^[a-zA-Z0-9:._-]+$/.test(trimmed)) {
+        throw new TopicValidationError(`${fieldName} contains unsupported characters`);
+    }
+    return trimmed;
+}
+export function topicRefToCanonicalString(ref) {
+    switch (ref.kind) {
+        case "agent":
+            return `agent:${assertIdentifier(ref.agentDid, "TopicRef.agentDid")}`;
+        case "company":
+            return `company:${assertIdentifier(ref.companyId, "TopicRef.companyId")}`;
+        case "marketplace":
+            return `marketplace:${assertIdentifier(ref.marketplaceId, "TopicRef.marketplaceId")}`;
+    }
+}
+export function topicRefToDiscoveryKey(ref) {
+    const canonical = topicRefToCanonicalString(ref);
+    return createHash("sha256").update(`emporion-topic:${canonical}`, "utf8").digest();
+}
+//# sourceMappingURL=topics.js.map

package/dist/src/topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/topics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,SAAS,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,oBAAoB,CAAC,GAAG,SAAS,oBAAoB,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAAC,GAAG,SAAS,kCAAkC,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAa;IACrD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,SAAS,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACxE,KAAK,SAAS;YACZ,OAAO,WAAW,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAC5E,KAAK,aAAa;YAChB,OAAO,eAAe,gBAAgB,CAAC,GAAG,CAAC,aAAa,EAAE,wBAAwB,CAAC,EAAE,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAa;IAClD,MAAM,SAAS,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;AACrF,CAAC"}

package/dist/src/transport.d.ts

@@ -0,0 +1,114 @@
+import type { AgentIdentity, PeerHello, ReplicationDescriptor, TopicJoinOptions, TopicRef, TransportConfig } from "./types.js";
+export interface PeerSession {
+    remoteDid: string;
+    remoteNoisePublicKey: string;
+    remoteControlFeedKey: string;
+    source: string;
+    supportedProtocols: PeerHello["supportedProtocols"];
+    replication: ReplicationDescriptor[];
+}
+export declare class AgentTransport {
+    static create(config: TransportConfig): Promise<AgentTransport>;
+    readonly identity: AgentIdentity;
+    private readonly logger;
+    private readonly storage;
+    private readonly identityMaterial;
+    private readonly dht;
+    private readonly swarm;
+    private readonly config;
+    private readonly joinedTopics;
+    private readonly activeSockets;
+    private readonly activePeerSessions;
+    private started;
+    private stopping;
+    private destroyed;
+    private constructor();
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    suspend(): Promise<void>;
+    resume(): Promise<void>;
+    joinTopic(ref: TopicRef, options?: TopicJoinOptions): Promise<void>;
+    leaveTopic(ref: TopicRef): Promise<void>;
+    connectToDid(did: string): Promise<void>;
+    connectToNoiseKey(publicKeyHex: string): Promise<void>;
+    openFeed(name: string): Promise<import("hypercore").default<string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | {
+        [key: string]: string | number | boolean | /*elided*/ any | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null>>;
+    openIndex(name: string): Promise<import("hyperbee").default<string, string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | {
+        [key: string]: string | number | boolean | /*elided*/ any | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null>>;
+    getPeerSessions(): ReadonlyMap<string, PeerSession>;
+    getRemoteFeed(key: string): import("hypercore").default<string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | {
+        [key: string]: string | number | boolean | /*elided*/ any | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null)[] | {
+        [key: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null)[] | /*elided*/ any | null;
+    } | null> | undefined;
+    private handleSocket;
+    private buildLocalHello;
+    private validateRemoteHello;
+    private ensureStarted;
+}