@m4ike1/ion-server 0.1.0

package/dist/testing/host.d.ts

@@ -0,0 +1,57 @@
+import type { JsonValue, ServiceCall } from "@m4ike1/chord";
+import type { Context, Session, SessionMetadata } from "@m4ike1/ion-agent-core";
+import { MemorySessionRepo } from "@m4ike1/ion-agent-core";
+import type { RoutedServerServiceHost, RoutedSessionHandle, ServerHost } from "../types.ts";
+export declare class Deferred<T> {
+    readonly promise: Promise<T>;
+    private resolvePromise;
+    constructor();
+    resolve(value: T): void;
+}
+interface OpenGate {
+    entered: Deferred<void>;
+    release: Deferred<void>;
+}
+export declare class TestHarness {
+    #private;
+    readonly session: Session;
+    readonly closed: Deferred<void>;
+    readonly terminated: Promise<Error | undefined>;
+    attachedClients: number;
+    attachmentReleaseCount: number;
+    closeCount: number;
+    readonly serviceCalls: ServiceCall[];
+    failAttachmentRelease?: Error;
+    failClose?: Error;
+    nextServiceError?: Error;
+    nextServiceResult: JsonValue | undefined;
+    private nextCloseGate?;
+    private nextServiceGate?;
+    constructor(session: Session);
+    attachClient(_context: Context): {
+        invokeService: TestHarness["invokeService"];
+        release(context: Context): void;
+    };
+    invokeService(call: ServiceCall): Promise<JsonValue | undefined>;
+    close(context: Context): Promise<void>;
+    terminate(error: Error): Promise<void>;
+    gateNextClose(): OpenGate;
+    gateNextServiceCall(): OpenGate;
+}
+export declare function createTestServerServices(): RoutedServerServiceHost;
+export declare class TestServerHost implements ServerHost {
+    readonly serverServices: RoutedServerServiceHost;
+    readonly repo: MemorySessionRepo;
+    readonly harnesses: Map<string, TestHarness[]>;
+    openSessionCount: number;
+    nextOpenSessionError?: Error;
+    nextHarnessCloseError?: Error;
+    private nextOpenSessionGate?;
+    resolveSession(sessionId: string, context: Context): Promise<SessionMetadata>;
+    openSession(metadata: SessionMetadata, context: Context): Promise<RoutedSessionHandle>;
+    seed(id?: string, parentSessionId?: string): Promise<SessionMetadata>;
+    gateNextOpenSession(): OpenGate;
+    latestHarness(id: string): TestHarness;
+}
+export {};
+//# sourceMappingURL=host.d.ts.map

package/dist/testing/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/testing/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5F,qBAAa,QAAQ,CAAC,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,cAAc,CAAsB;IAE5C,cAIC;IAED,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAEtB;CACD;AAED,UAAU,QAAQ;IACjB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,WAAW;;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,iBAAwB;IAEvC,QAAQ,CAAC,UAAU,6BAA6B;IAChD,eAAe,SAAK;IACpB,sBAAsB,SAAK;IAC3B,UAAU,SAAK;IACf,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,CAAM;IAC1C,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,iBAAiB,EAAE,SAAS,GAAG,SAAS,CAAgB;IACxD,OAAO,CAAC,aAAa,CAAC,CAAW;IACjC,OAAO,CAAC,eAAe,CAAC,CAAW;IAEnC,YAAY,OAAO,EAAE,OAAO,EAE3B;IAED,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG;QAChC,aAAa,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;QAC5C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;KAChC,CAaA;IAEK,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAgBrE;IAEK,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3C;IAEK,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3C;IAED,aAAa,IAAI,QAAQ,CAIxB;IAED,mBAAmB,IAAI,QAAQ,CAI9B;CACD;AAED,wBAAgB,wBAAwB,IAAI,uBAAuB,CA8BlE;AAED,qBAAa,cAAe,YAAW,UAAU;IAChD,QAAQ,CAAC,cAAc,0BAA8B;IACrD,QAAQ,CAAC,IAAI,oBAA2C;IACxD,QAAQ,CAAC,SAAS,6BAAoC;IACtD,gBAAgB,SAAK;IACrB,oBAAoB,CAAC,EAAE,KAAK,CAAC;IAC7B,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,OAAO,CAAC,mBAAmB,CAAC,CAAW;IAEjC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAKlF;IAEK,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4B3F;IAEK,IAAI,CAAC,EAAE,SAAc,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAK/E;IAED,mBAAmB,IAAI,QAAQ,CAI9B;IAED,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAIrC;CACD","sourcesContent":["import type { JsonValue, ServiceCall } from \"@m4ike1/chord\";\nimport type { Context, Session, SessionMetadata } from \"@m4ike1/ion-agent-core\";\nimport { BACKGROUND_CONTEXT, MemorySessionRepo } from \"@m4ike1/ion-agent-core\";\nimport { SessionAmbiguousError, SessionNotFoundError } from \"../errors.ts\";\nimport type { RoutedServerServiceHost, RoutedSessionHandle, ServerHost } from \"../types.ts\";\n\nexport class Deferred<T> {\n\treadonly promise: Promise<T>;\n\tprivate resolvePromise!: (value: T) => void;\n\n\tconstructor() {\n\t\tthis.promise = new Promise<T>((resolve) => {\n\t\t\tthis.resolvePromise = resolve;\n\t\t});\n\t}\n\n\tresolve(value: T): void {\n\t\tthis.resolvePromise(value);\n\t}\n}\n\ninterface OpenGate {\n\tentered: Deferred<void>;\n\trelease: Deferred<void>;\n}\n\nexport class TestHarness {\n\treadonly session: Session;\n\treadonly closed = new Deferred<void>();\n\treadonly #termination = new Deferred<Error | undefined>();\n\treadonly terminated = this.#termination.promise;\n\tattachedClients = 0;\n\tattachmentReleaseCount = 0;\n\tcloseCount = 0;\n\treadonly serviceCalls: ServiceCall[] = [];\n\tfailAttachmentRelease?: Error;\n\tfailClose?: Error;\n\tnextServiceError?: Error;\n\tnextServiceResult: JsonValue | undefined = { ok: true };\n\tprivate nextCloseGate?: OpenGate;\n\tprivate nextServiceGate?: OpenGate;\n\n\tconstructor(session: Session) {\n\t\tthis.session = session;\n\t}\n\n\tattachClient(_context: Context): {\n\t\tinvokeService: TestHarness[\"invokeService\"];\n\t\trelease(context: Context): void;\n\t} {\n\t\tthis.attachedClients += 1;\n\t\tlet released = false;\n\t\treturn {\n\t\t\tinvokeService: (call) => this.invokeService(call),\n\t\t\trelease: (_context) => {\n\t\t\t\tif (released) return;\n\t\t\t\tthis.attachmentReleaseCount += 1;\n\t\t\t\tif (this.failAttachmentRelease) throw this.failAttachmentRelease;\n\t\t\t\treleased = true;\n\t\t\t\tthis.attachedClients -= 1;\n\t\t\t},\n\t\t};\n\t}\n\n\tasync invokeService(call: ServiceCall): Promise<JsonValue | undefined> {\n\t\tthis.serviceCalls.push(call);\n\t\tif (this.nextServiceError) {\n\t\t\tconst error = this.nextServiceError;\n\t\t\tthis.nextServiceError = undefined;\n\t\t\tthrow error;\n\t\t}\n\t\tconst gate = this.nextServiceGate;\n\t\tif (gate) {\n\t\t\tthis.nextServiceGate = undefined;\n\t\t\tgate.entered.resolve(undefined);\n\t\t\tawait gate.release.promise;\n\t\t}\n\t\tconst result = this.nextServiceResult;\n\t\tthis.nextServiceResult = { ok: true };\n\t\treturn result;\n\t}\n\n\tasync close(context: Context): Promise<void> {\n\t\tthis.closeCount += 1;\n\t\tconst gate = this.nextCloseGate;\n\t\tif (gate) {\n\t\t\tthis.nextCloseGate = undefined;\n\t\t\tgate.entered.resolve(undefined);\n\t\t\tawait gate.release.promise;\n\t\t}\n\t\tif (this.failClose) {\n\t\t\tconst error = this.failClose;\n\t\t\tthis.failClose = undefined;\n\t\t\tthrow error;\n\t\t}\n\t\tawait this.session.close(context);\n\t\tthis.closed.resolve(undefined);\n\t\tthis.#termination.resolve(undefined);\n\t}\n\n\tasync terminate(error: Error): Promise<void> {\n\t\tawait this.session.close(BACKGROUND_CONTEXT);\n\t\tthis.#termination.resolve(error);\n\t}\n\n\tgateNextClose(): OpenGate {\n\t\tconst gate = { entered: new Deferred<void>(), release: new Deferred<void>() };\n\t\tthis.nextCloseGate = gate;\n\t\treturn gate;\n\t}\n\n\tgateNextServiceCall(): OpenGate {\n\t\tconst gate = { entered: new Deferred<void>(), release: new Deferred<void>() };\n\t\tthis.nextServiceGate = gate;\n\t\treturn gate;\n\t}\n}\n\nexport function createTestServerServices(): RoutedServerServiceHost {\n\treturn {\n\t\tattachClient(presentation) {\n\t\t\treturn {\n\t\t\t\tasync invokeService(call, _publish, context) {\n\t\t\t\t\tif (\n\t\t\t\t\t\tcall.instance === undefined &&\n\t\t\t\t\t\tcall.serviceId === \"ion.session-management\" &&\n\t\t\t\t\t\tcall.member === \"attach\" &&\n\t\t\t\t\t\tcall.args.length === 1 &&\n\t\t\t\t\t\ttypeof call.args[0] === \"string\"\n\t\t\t\t\t) {\n\t\t\t\t\t\tawait presentation.attachSession(call.args[0], context);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tcall.instance === undefined &&\n\t\t\t\t\t\tcall.serviceId === \"ion.session-management\" &&\n\t\t\t\t\t\tcall.member === \"detach\" &&\n\t\t\t\t\t\tcall.args.length === 0\n\t\t\t\t\t) {\n\t\t\t\t\t\tawait presentation.detachSession(context);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t}\n\t\t\t\t\tthrow new Error(`Unsupported test server service ${call.serviceId}.${call.member}`);\n\t\t\t\t},\n\t\t\t\trelease() {},\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport class TestServerHost implements ServerHost {\n\treadonly serverServices = createTestServerServices();\n\treadonly repo = new MemorySessionRepo({ now: () => 1 });\n\treadonly harnesses = new Map<string, TestHarness[]>();\n\topenSessionCount = 0;\n\tnextOpenSessionError?: Error;\n\tnextHarnessCloseError?: Error;\n\tprivate nextOpenSessionGate?: OpenGate;\n\n\tasync resolveSession(sessionId: string, context: Context): Promise<SessionMetadata> {\n\t\tconst matches = (await this.repo.list(undefined, context)).filter(({ id }) => id === sessionId);\n\t\tif (matches.length === 0) throw new SessionNotFoundError(`Unknown session: ${sessionId}`);\n\t\tif (matches.length > 1) throw new SessionAmbiguousError();\n\t\treturn matches[0]!;\n\t}\n\n\tasync openSession(metadata: SessionMetadata, context: Context): Promise<RoutedSessionHandle> {\n\t\tthis.openSessionCount += 1;\n\t\tconst gate = this.nextOpenSessionGate;\n\t\tif (gate) {\n\t\t\tthis.nextOpenSessionGate = undefined;\n\t\t\tgate.entered.resolve(undefined);\n\t\t\tawait gate.release.promise;\n\t\t}\n\t\tconst session = await this.repo.open(metadata, context);\n\t\ttry {\n\t\t\tif (this.nextOpenSessionError) {\n\t\t\t\tconst error = this.nextOpenSessionError;\n\t\t\t\tthis.nextOpenSessionError = undefined;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst harness = new TestHarness(session);\n\t\t\tif (this.nextHarnessCloseError) {\n\t\t\t\tharness.failClose = this.nextHarnessCloseError;\n\t\t\t\tthis.nextHarnessCloseError = undefined;\n\t\t\t}\n\t\t\tconst harnesses = this.harnesses.get(metadata.id) ?? [];\n\t\t\tharnesses.push(harness);\n\t\t\tthis.harnesses.set(metadata.id, harnesses);\n\t\t\treturn harness;\n\t\t} catch (error) {\n\t\t\tawait session.close(context);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync seed(id = \"session-1\", parentSessionId?: string): Promise<SessionMetadata> {\n\t\tconst session = await this.repo.create({ id, parentSessionId }, BACKGROUND_CONTEXT);\n\t\tconst metadata = session.metadata;\n\t\tawait session.close(BACKGROUND_CONTEXT);\n\t\treturn metadata;\n\t}\n\n\tgateNextOpenSession(): OpenGate {\n\t\tconst gate = { entered: new Deferred<void>(), release: new Deferred<void>() };\n\t\tthis.nextOpenSessionGate = gate;\n\t\treturn gate;\n\t}\n\n\tlatestHarness(id: string): TestHarness {\n\t\tconst harnesses = this.harnesses.get(id);\n\t\tif (!harnesses?.length) throw new Error(`No harness for ${id}`);\n\t\treturn harnesses.at(-1)!;\n\t}\n}\n"]}

package/dist/testing/host.js

@@ -0,0 +1,189 @@
+import { BACKGROUND_CONTEXT, MemorySessionRepo } from "@m4ike1/ion-agent-core";
+import { SessionAmbiguousError, SessionNotFoundError } from "../errors.js";
+export class Deferred {
+    promise;
+    resolvePromise;
+    constructor() {
+        this.promise = new Promise((resolve) => {
+            this.resolvePromise = resolve;
+        });
+    }
+    resolve(value) {
+        this.resolvePromise(value);
+    }
+}
+export class TestHarness {
+    session;
+    closed = new Deferred();
+    #termination = new Deferred();
+    terminated = this.#termination.promise;
+    attachedClients = 0;
+    attachmentReleaseCount = 0;
+    closeCount = 0;
+    serviceCalls = [];
+    failAttachmentRelease;
+    failClose;
+    nextServiceError;
+    nextServiceResult = { ok: true };
+    nextCloseGate;
+    nextServiceGate;
+    constructor(session) {
+        this.session = session;
+    }
+    attachClient(_context) {
+        this.attachedClients += 1;
+        let released = false;
+        return {
+            invokeService: (call) => this.invokeService(call),
+            release: (_context) => {
+                if (released)
+                    return;
+                this.attachmentReleaseCount += 1;
+                if (this.failAttachmentRelease)
+                    throw this.failAttachmentRelease;
+                released = true;
+                this.attachedClients -= 1;
+            },
+        };
+    }
+    async invokeService(call) {
+        this.serviceCalls.push(call);
+        if (this.nextServiceError) {
+            const error = this.nextServiceError;
+            this.nextServiceError = undefined;
+            throw error;
+        }
+        const gate = this.nextServiceGate;
+        if (gate) {
+            this.nextServiceGate = undefined;
+            gate.entered.resolve(undefined);
+            await gate.release.promise;
+        }
+        const result = this.nextServiceResult;
+        this.nextServiceResult = { ok: true };
+        return result;
+    }
+    async close(context) {
+        this.closeCount += 1;
+        const gate = this.nextCloseGate;
+        if (gate) {
+            this.nextCloseGate = undefined;
+            gate.entered.resolve(undefined);
+            await gate.release.promise;
+        }
+        if (this.failClose) {
+            const error = this.failClose;
+            this.failClose = undefined;
+            throw error;
+        }
+        await this.session.close(context);
+        this.closed.resolve(undefined);
+        this.#termination.resolve(undefined);
+    }
+    async terminate(error) {
+        await this.session.close(BACKGROUND_CONTEXT);
+        this.#termination.resolve(error);
+    }
+    gateNextClose() {
+        const gate = { entered: new Deferred(), release: new Deferred() };
+        this.nextCloseGate = gate;
+        return gate;
+    }
+    gateNextServiceCall() {
+        const gate = { entered: new Deferred(), release: new Deferred() };
+        this.nextServiceGate = gate;
+        return gate;
+    }
+}
+export function createTestServerServices() {
+    return {
+        attachClient(presentation) {
+            return {
+                async invokeService(call, _publish, context) {
+                    if (call.instance === undefined &&
+                        call.serviceId === "ion.session-management" &&
+                        call.member === "attach" &&
+                        call.args.length === 1 &&
+                        typeof call.args[0] === "string") {
+                        await presentation.attachSession(call.args[0], context);
+                        return null;
+                    }
+                    if (call.instance === undefined &&
+                        call.serviceId === "ion.session-management" &&
+                        call.member === "detach" &&
+                        call.args.length === 0) {
+                        await presentation.detachSession(context);
+                        return null;
+                    }
+                    throw new Error(`Unsupported test server service ${call.serviceId}.${call.member}`);
+                },
+                release() { },
+            };
+        },
+    };
+}
+export class TestServerHost {
+    serverServices = createTestServerServices();
+    repo = new MemorySessionRepo({ now: () => 1 });
+    harnesses = new Map();
+    openSessionCount = 0;
+    nextOpenSessionError;
+    nextHarnessCloseError;
+    nextOpenSessionGate;
+    async resolveSession(sessionId, context) {
+        const matches = (await this.repo.list(undefined, context)).filter(({ id }) => id === sessionId);
+        if (matches.length === 0)
+            throw new SessionNotFoundError(`Unknown session: ${sessionId}`);
+        if (matches.length > 1)
+            throw new SessionAmbiguousError();
+        return matches[0];
+    }
+    async openSession(metadata, context) {
+        this.openSessionCount += 1;
+        const gate = this.nextOpenSessionGate;
+        if (gate) {
+            this.nextOpenSessionGate = undefined;
+            gate.entered.resolve(undefined);
+            await gate.release.promise;
+        }
+        const session = await this.repo.open(metadata, context);
+        try {
+            if (this.nextOpenSessionError) {
+                const error = this.nextOpenSessionError;
+                this.nextOpenSessionError = undefined;
+                throw error;
+            }
+            const harness = new TestHarness(session);
+            if (this.nextHarnessCloseError) {
+                harness.failClose = this.nextHarnessCloseError;
+                this.nextHarnessCloseError = undefined;
+            }
+            const harnesses = this.harnesses.get(metadata.id) ?? [];
+            harnesses.push(harness);
+            this.harnesses.set(metadata.id, harnesses);
+            return harness;
+        }
+        catch (error) {
+            await session.close(context);
+            throw error;
+        }
+    }
+    async seed(id = "session-1", parentSessionId) {
+        const session = await this.repo.create({ id, parentSessionId }, BACKGROUND_CONTEXT);
+        const metadata = session.metadata;
+        await session.close(BACKGROUND_CONTEXT);
+        return metadata;
+    }
+    gateNextOpenSession() {
+        const gate = { entered: new Deferred(), release: new Deferred() };
+        this.nextOpenSessionGate = gate;
+        return gate;
+    }
+    latestHarness(id) {
+        const harnesses = this.harnesses.get(id);
+        if (!harnesses?.length)
+            throw new Error(`No harness for ${id}`);
+        return harnesses.at(-1);
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/testing/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/testing/host.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonValue, ServiceCall } from \"@m4ike1/chord\";\nimport type { Context, Session, SessionMetadata } from \"@m4ike1/ion-agent-core\";\nimport { BACKGROUND_CONTEXT, MemorySessionRepo } from \"@m4ike1/ion-agent-core\";\nimport { SessionAmbiguousError, SessionNotFoundError } from \"../errors.ts\";\nimport type { RoutedServerServiceHost, RoutedSessionHandle, ServerHost } from \"../types.ts\";\n\nexport class Deferred<T> {\n\treadonly promise: Promise<T>;\n\tprivate resolvePromise!: (value: T) => void;\n\n\tconstructor() {\n\t\tthis.promise = new Promise<T>((resolve) => {\n\t\t\tthis.resolvePromise = resolve;\n\t\t});\n\t}\n\n\tresolve(value: T): void {\n\t\tthis.resolvePromise(value);\n\t}\n}\n\ninterface OpenGate {\n\tentered: Deferred<void>;\n\trelease: Deferred<void>;\n}\n\nexport class TestHarness {\n\treadonly session: Session;\n\treadonly closed = new Deferred<void>();\n\treadonly #termination = new Deferred<Error | undefined>();\n\treadonly terminated = this.#termination.promise;\n\tattachedClients = 0;\n\tattachmentReleaseCount = 0;\n\tcloseCount = 0;\n\treadonly serviceCalls: ServiceCall[] = [];\n\tfailAttachmentRelease?: Error;\n\tfailClose?: Error;\n\tnextServiceError?: Error;\n\tnextServiceResult: JsonValue | undefined = { ok: true };\n\tprivate nextCloseGate?: OpenGate;\n\tprivate nextServiceGate?: OpenGate;\n\n\tconstructor(session: Session) {\n\t\tthis.session = session;\n\t}\n\n\tattachClient(_context: Context): {\n\t\tinvokeService: TestHarness[\"invokeService\"];\n\t\trelease(context: Context): void;\n\t} {\n\t\tthis.attachedClients += 1;\n\t\tlet released = false;\n\t\treturn {\n\t\t\tinvokeService: (call) => this.invokeService(call),\n\t\t\trelease: (_context) => {\n\t\t\t\tif (released) return;\n\t\t\t\tthis.attachmentReleaseCount += 1;\n\t\t\t\tif (this.failAttachmentRelease) throw this.failAttachmentRelease;\n\t\t\t\treleased = true;\n\t\t\t\tthis.attachedClients -= 1;\n\t\t\t},\n\t\t};\n\t}\n\n\tasync invokeService(call: ServiceCall): Promise<JsonValue | undefined> {\n\t\tthis.serviceCalls.push(call);\n\t\tif (this.nextServiceError) {\n\t\t\tconst error = this.nextServiceError;\n\t\t\tthis.nextServiceError = undefined;\n\t\t\tthrow error;\n\t\t}\n\t\tconst gate = this.nextServiceGate;\n\t\tif (gate) {\n\t\t\tthis.nextServiceGate = undefined;\n\t\t\tgate.entered.resolve(undefined);\n\t\t\tawait gate.release.promise;\n\t\t}\n\t\tconst result = this.nextServiceResult;\n\t\tthis.nextServiceResult = { ok: true };\n\t\treturn result;\n\t}\n\n\tasync close(context: Context): Promise<void> {\n\t\tthis.closeCount += 1;\n\t\tconst gate = this.nextCloseGate;\n\t\tif (gate) {\n\t\t\tthis.nextCloseGate = undefined;\n\t\t\tgate.entered.resolve(undefined);\n\t\t\tawait gate.release.promise;\n\t\t}\n\t\tif (this.failClose) {\n\t\t\tconst error = this.failClose;\n\t\t\tthis.failClose = undefined;\n\t\t\tthrow error;\n\t\t}\n\t\tawait this.session.close(context);\n\t\tthis.closed.resolve(undefined);\n\t\tthis.#termination.resolve(undefined);\n\t}\n\n\tasync terminate(error: Error): Promise<void> {\n\t\tawait this.session.close(BACKGROUND_CONTEXT);\n\t\tthis.#termination.resolve(error);\n\t}\n\n\tgateNextClose(): OpenGate {\n\t\tconst gate = { entered: new Deferred<void>(), release: new Deferred<void>() };\n\t\tthis.nextCloseGate = gate;\n\t\treturn gate;\n\t}\n\n\tgateNextServiceCall(): OpenGate {\n\t\tconst gate = { entered: new Deferred<void>(), release: new Deferred<void>() };\n\t\tthis.nextServiceGate = gate;\n\t\treturn gate;\n\t}\n}\n\nexport function createTestServerServices(): RoutedServerServiceHost {\n\treturn {\n\t\tattachClient(presentation) {\n\t\t\treturn {\n\t\t\t\tasync invokeService(call, _publish, context) {\n\t\t\t\t\tif (\n\t\t\t\t\t\tcall.instance === undefined &&\n\t\t\t\t\t\tcall.serviceId === \"ion.session-management\" &&\n\t\t\t\t\t\tcall.member === \"attach\" &&\n\t\t\t\t\t\tcall.args.length === 1 &&\n\t\t\t\t\t\ttypeof call.args[0] === \"string\"\n\t\t\t\t\t) {\n\t\t\t\t\t\tawait presentation.attachSession(call.args[0], context);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t}\n\t\t\t\t\tif (\n\t\t\t\t\t\tcall.instance === undefined &&\n\t\t\t\t\t\tcall.serviceId === \"ion.session-management\" &&\n\t\t\t\t\t\tcall.member === \"detach\" &&\n\t\t\t\t\t\tcall.args.length === 0\n\t\t\t\t\t) {\n\t\t\t\t\t\tawait presentation.detachSession(context);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t}\n\t\t\t\t\tthrow new Error(`Unsupported test server service ${call.serviceId}.${call.member}`);\n\t\t\t\t},\n\t\t\t\trelease() {},\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport class TestServerHost implements ServerHost {\n\treadonly serverServices = createTestServerServices();\n\treadonly repo = new MemorySessionRepo({ now: () => 1 });\n\treadonly harnesses = new Map<string, TestHarness[]>();\n\topenSessionCount = 0;\n\tnextOpenSessionError?: Error;\n\tnextHarnessCloseError?: Error;\n\tprivate nextOpenSessionGate?: OpenGate;\n\n\tasync resolveSession(sessionId: string, context: Context): Promise<SessionMetadata> {\n\t\tconst matches = (await this.repo.list(undefined, context)).filter(({ id }) => id === sessionId);\n\t\tif (matches.length === 0) throw new SessionNotFoundError(`Unknown session: ${sessionId}`);\n\t\tif (matches.length > 1) throw new SessionAmbiguousError();\n\t\treturn matches[0]!;\n\t}\n\n\tasync openSession(metadata: SessionMetadata, context: Context): Promise<RoutedSessionHandle> {\n\t\tthis.openSessionCount += 1;\n\t\tconst gate = this.nextOpenSessionGate;\n\t\tif (gate) {\n\t\t\tthis.nextOpenSessionGate = undefined;\n\t\t\tgate.entered.resolve(undefined);\n\t\t\tawait gate.release.promise;\n\t\t}\n\t\tconst session = await this.repo.open(metadata, context);\n\t\ttry {\n\t\t\tif (this.nextOpenSessionError) {\n\t\t\t\tconst error = this.nextOpenSessionError;\n\t\t\t\tthis.nextOpenSessionError = undefined;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst harness = new TestHarness(session);\n\t\t\tif (this.nextHarnessCloseError) {\n\t\t\t\tharness.failClose = this.nextHarnessCloseError;\n\t\t\t\tthis.nextHarnessCloseError = undefined;\n\t\t\t}\n\t\t\tconst harnesses = this.harnesses.get(metadata.id) ?? [];\n\t\t\tharnesses.push(harness);\n\t\t\tthis.harnesses.set(metadata.id, harnesses);\n\t\t\treturn harness;\n\t\t} catch (error) {\n\t\t\tawait session.close(context);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync seed(id = \"session-1\", parentSessionId?: string): Promise<SessionMetadata> {\n\t\tconst session = await this.repo.create({ id, parentSessionId }, BACKGROUND_CONTEXT);\n\t\tconst metadata = session.metadata;\n\t\tawait session.close(BACKGROUND_CONTEXT);\n\t\treturn metadata;\n\t}\n\n\tgateNextOpenSession(): OpenGate {\n\t\tconst gate = { entered: new Deferred<void>(), release: new Deferred<void>() };\n\t\tthis.nextOpenSessionGate = gate;\n\t\treturn gate;\n\t}\n\n\tlatestHarness(id: string): TestHarness {\n\t\tconst harnesses = this.harnesses.get(id);\n\t\tif (!harnesses?.length) throw new Error(`No harness for ${id}`);\n\t\treturn harnesses.at(-1)!;\n\t}\n}\n"]}

package/dist/testing/index.d.ts

@@ -0,0 +1,6 @@
+export type { WireChannel } from "./client.ts";
+export { connectUnixTestClient, ProtocolTestClient } from "./client.ts";
+export { createTestServerServices, Deferred, TestHarness, TestServerHost } from "./host.ts";
+export type { TestServer, TestServerOptions } from "./server.ts";
+export { createTestServer } from "./server.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5F,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export type { WireChannel } from \"./client.ts\";\nexport { connectUnixTestClient, ProtocolTestClient } from \"./client.ts\";\nexport { createTestServerServices, Deferred, TestHarness, TestServerHost } from \"./host.ts\";\nexport type { TestServer, TestServerOptions } from \"./server.ts\";\nexport { createTestServer } from \"./server.ts\";\n"]}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+export { connectUnixTestClient, ProtocolTestClient } from "./client.js";
+export { createTestServerServices, Deferred, TestHarness, TestServerHost } from "./host.js";
+export { createTestServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export type { WireChannel } from \"./client.ts\";\nexport { connectUnixTestClient, ProtocolTestClient } from \"./client.ts\";\nexport { createTestServerServices, Deferred, TestHarness, TestServerHost } from \"./host.ts\";\nexport type { TestServer, TestServerOptions } from \"./server.ts\";\nexport { createTestServer } from \"./server.ts\";\n"]}

package/dist/testing/server.d.ts

@@ -0,0 +1,13 @@
+import { Server } from "../server.ts";
+import type { ServerHost, ServerOptions } from "../types.ts";
+export interface TestServerOptions extends Omit<ServerOptions, "serverId"> {
+    host?: ServerHost;
+    serverId?: string;
+}
+export interface TestServer {
+    server: Server;
+    host: ServerHost;
+}
+/** Create an unstarted Server with deterministic defaults for transport conformance tests. */
+export declare function createTestServer(options: TestServerOptions): TestServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/testing/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/testing/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;IACzE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CACjB;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAYvE","sourcesContent":["import { Server } from \"../server.ts\";\nimport type { ServerHost, ServerOptions } from \"../types.ts\";\nimport { TestServerHost } from \"./host.ts\";\n\nexport interface TestServerOptions extends Omit<ServerOptions, \"serverId\"> {\n\thost?: ServerHost;\n\tserverId?: string;\n}\n\nexport interface TestServer {\n\tserver: Server;\n\thost: ServerHost;\n}\n\n/** Create an unstarted Server with deterministic defaults for transport conformance tests. */\nexport function createTestServer(options: TestServerOptions): TestServer {\n\tconst host = options.host ?? new TestServerHost();\n\treturn {\n\t\tserver: new Server(host, {\n\t\t\tlisteners: options.listeners,\n\t\t\tmaxFrameLength: options.maxFrameLength,\n\t\t\thandshakeTimeoutMs: options.handshakeTimeoutMs,\n\t\t\tserverId: options.serverId ?? \"00000000-0000-4000-8000-000000000001\",\n\t\t\tonError: options.onError,\n\t\t}),\n\t\thost,\n\t};\n}\n"]}

package/dist/testing/server.js

@@ -0,0 +1,17 @@
+import { Server } from "../server.js";
+import { TestServerHost } from "./host.js";
+/** Create an unstarted Server with deterministic defaults for transport conformance tests. */
+export function createTestServer(options) {
+    const host = options.host ?? new TestServerHost();
+    return {
+        server: new Server(host, {
+            listeners: options.listeners,
+            maxFrameLength: options.maxFrameLength,
+            handshakeTimeoutMs: options.handshakeTimeoutMs,
+            serverId: options.serverId ?? "00000000-0000-4000-8000-000000000001",
+            onError: options.onError,
+        }),
+        host,
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/testing/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/testing/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAY3C,8FAA8F;AAC9F,MAAM,UAAU,gBAAgB,CAAC,OAA0B,EAAc;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,cAAc,EAAE,CAAC;IAClD,OAAO;QACN,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,sCAAsC;YACpE,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC;QACF,IAAI;KACJ,CAAC;AAAA,CACF","sourcesContent":["import { Server } from \"../server.ts\";\nimport type { ServerHost, ServerOptions } from \"../types.ts\";\nimport { TestServerHost } from \"./host.ts\";\n\nexport interface TestServerOptions extends Omit<ServerOptions, \"serverId\"> {\n\thost?: ServerHost;\n\tserverId?: string;\n}\n\nexport interface TestServer {\n\tserver: Server;\n\thost: ServerHost;\n}\n\n/** Create an unstarted Server with deterministic defaults for transport conformance tests. */\nexport function createTestServer(options: TestServerOptions): TestServer {\n\tconst host = options.host ?? new TestServerHost();\n\treturn {\n\t\tserver: new Server(host, {\n\t\t\tlisteners: options.listeners,\n\t\t\tmaxFrameLength: options.maxFrameLength,\n\t\t\thandshakeTimeoutMs: options.handshakeTimeoutMs,\n\t\t\tserverId: options.serverId ?? \"00000000-0000-4000-8000-000000000001\",\n\t\t\tonError: options.onError,\n\t\t}),\n\t\thost,\n\t};\n}\n"]}

package/dist/transports/unix/address.d.ts

@@ -0,0 +1,3 @@
+/** Derive the local Unix socket path for one logical server identity. */
+export declare function getUnixSocketPath(serverId: string, serverDirectory: string): string;
+//# sourceMappingURL=address.d.ts.map

package/dist/transports/unix/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../../src/transports/unix/address.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAKnF","sourcesContent":["import { join } from \"node:path\";\n\n/** Derive the local Unix socket path for one logical server identity. */\nexport function getUnixSocketPath(serverId: string, serverDirectory: string): string {\n\tif (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(serverId)) {\n\t\tthrow new TypeError(\"Unix serverId must be a canonical lowercase UUIDv4\");\n\t}\n\treturn join(serverDirectory, `${serverId}.sock`);\n}\n"]}

package/dist/transports/unix/address.js

@@ -0,0 +1,9 @@
+import { join } from "node:path";
+/** Derive the local Unix socket path for one logical server identity. */
+export function getUnixSocketPath(serverId, serverDirectory) {
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(serverId)) {
+        throw new TypeError("Unix serverId must be a canonical lowercase UUIDv4");
+    }
+    return join(serverDirectory, `${serverId}.sock`);
+}
+//# sourceMappingURL=address.js.map

package/dist/transports/unix/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/transports/unix/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,eAAuB,EAAU;IACpF,IAAI,CAAC,uEAAuE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC,eAAe,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;AAAA,CACjD","sourcesContent":["import { join } from \"node:path\";\n\n/** Derive the local Unix socket path for one logical server identity. */\nexport function getUnixSocketPath(serverId: string, serverDirectory: string): string {\n\tif (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(serverId)) {\n\t\tthrow new TypeError(\"Unix serverId must be a canonical lowercase UUIDv4\");\n\t}\n\treturn join(serverDirectory, `${serverId}.sock`);\n}\n"]}

package/dist/transports/unix/index.d.ts

@@ -0,0 +1,5 @@
+export { getUnixSocketPath } from "./address.ts";
+export { createUnixListener } from "./listener.ts";
+export { createUnixServer } from "./preset.ts";
+export type { UnixListenerOptions, UnixServerOptions } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/transports/unix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transports/unix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { getUnixSocketPath } from \"./address.ts\";\nexport { createUnixListener } from \"./listener.ts\";\nexport { createUnixServer } from \"./preset.ts\";\nexport type { UnixListenerOptions, UnixServerOptions } from \"./types.ts\";\n"]}

package/dist/transports/unix/index.js

@@ -0,0 +1,4 @@
+export { getUnixSocketPath } from "./address.js";
+export { createUnixListener } from "./listener.js";
+export { createUnixServer } from "./preset.js";
+//# sourceMappingURL=index.js.map

package/dist/transports/unix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transports/unix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export { getUnixSocketPath } from \"./address.ts\";\nexport { createUnixListener } from \"./listener.ts\";\nexport { createUnixServer } from \"./preset.ts\";\nexport type { UnixListenerOptions, UnixServerOptions } from \"./types.ts\";\n"]}

package/dist/transports/unix/listener.d.ts

@@ -0,0 +1,24 @@
+import { type Socket } from "node:net";
+import type { ByteConnection } from "../../connection.ts";
+import type { ServerListener } from "../../listener.ts";
+import type { UnixListenerOptions } from "./types.ts";
+/** @internal Exported only for transport-level verification. */
+export declare class UnixByteConnection implements ByteConnection {
+    private readonly socket;
+    private readonly gracefulCloseTimeoutMs;
+    private readonly maxPendingBytes;
+    private pendingBytes;
+    private closedValue;
+    private closing;
+    private writeTail;
+    private closePromise?;
+    private resolveClose?;
+    constructor(socket: Socket, gracefulCloseTimeoutMs: number, maxPendingBytes: number);
+    get closed(): boolean;
+    send(chunk: Uint8Array): Promise<void>;
+    close(finalChunk?: Uint8Array): Promise<void>;
+    markClosed(): void;
+    private write;
+}
+export declare function createUnixListener(options: UnixListenerOptions): ServerListener;
+//# sourceMappingURL=listener.d.ts.map

package/dist/transports/unix/listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../src/transports/unix/listener.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+C,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAGpF,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAqLtD,gEAAgE;AAChE,qBAAa,kBAAmB,YAAW,cAAc;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAa;IAElC,YAAY,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAIlF;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrC;IAED,KAAK,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5C;IAED,UAAU,IAAI,IAAI,CAMjB;IAED,OAAO,CAAC,KAAK;CAsBb;AAgGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAE/E","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport type { Stats } from \"node:fs\";\nimport { chmod, link, lstat, mkdir, rename, unlink } from \"node:fs/promises\";\nimport { createConnection, createServer, type Server, type Socket } from \"node:net\";\nimport { dirname, join } from \"node:path\";\nimport { DEFAULT_MAX_FRAME_LENGTH } from \"@m4ike1/ion-protocol\";\nimport type { ByteConnection, ByteConnectionAcceptor } from \"../../connection.ts\";\nimport type { ServerListener } from \"../../listener.ts\";\nimport type { UnixListenerOptions } from \"./types.ts\";\n\nconst DEFAULT_SOCKET_MODE = 0o600;\nconst DEFAULT_GRACEFUL_CLOSE_TIMEOUT_MS = 5_000;\nconst MAX_UINT32 = 0xffff_ffff;\nconst MAX_TIMER_DELAY_MS = 2_147_483_647;\nconst SOCKET_PROBE_TIMEOUT_MS = 1_000;\n\ninterface ResolvedUnixListenerOptions {\n\tpath: string;\n\tmode: number;\n\tgracefulCloseTimeoutMs: number;\n\tmaxPendingBytes: number;\n\tonError?: (error: Error) => void;\n}\n\ninterface FileIdentity {\n\tdev: number;\n\tino: number;\n}\nclass UnixListener implements ServerListener {\n\tprivate readonly options: ResolvedUnixListenerOptions;\n\tprivate readonly path: string;\n\tprivate readonly mode: number;\n\tprivate readonly connections = new Set<UnixByteConnection>();\n\tprivate server?: Server;\n\tprivate socketIdentity?: FileIdentity;\n\tprivate ownedBindPath?: string;\n\tprivate closing = false;\n\tprivate closePromise?: Promise<void>;\n\tprivate accept?: ByteConnectionAcceptor;\n\n\tconstructor(options: UnixListenerOptions) {\n\t\tthis.options = resolveUnixListenerOptions(options);\n\t\tthis.path = this.options.path;\n\t\tthis.mode = this.options.mode;\n\t}\n\n\tasync start(accept: ByteConnectionAcceptor): Promise<void> {\n\t\tif (this.server) throw new Error(\"Unix listener is already started\");\n\t\tif (this.closing) throw new Error(\"Unix listener is closing or closed\");\n\t\tthis.accept = accept;\n\n\t\tconst ownedBindPath = getOwnedBindPath(this.path);\n\t\tawait mkdir(dirname(this.path), { recursive: true, mode: 0o700 });\n\t\tawait removeStaleSocket(this.path);\n\t\tawait removeStaleSocket(ownedBindPath);\n\t\tthis.ownedBindPath = ownedBindPath;\n\t\tconst server = createServer((socket) => this.acceptSocket(socket));\n\t\tserver.on(\"error\", (error) => this.reportError(error));\n\t\tthis.server = server;\n\t\ttry {\n\t\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t\tconst onError = (error: Error): void => {\n\t\t\t\t\tserver.off(\"listening\", onListening);\n\t\t\t\t\treject(error);\n\t\t\t\t};\n\t\t\t\tconst onListening = (): void => {\n\t\t\t\t\tserver.off(\"error\", onError);\n\t\t\t\t\tresolve();\n\t\t\t\t};\n\t\t\t\tserver.once(\"error\", onError);\n\t\t\t\tserver.once(\"listening\", onListening);\n\t\t\t\tserver.listen(ownedBindPath);\n\t\t\t});\n\t\t\tconst stats = await lstat(ownedBindPath);\n\t\t\tif (!stats.isSocket()) throw new Error(`Unix listener path is not a socket after binding: ${ownedBindPath}`);\n\t\t\tthis.socketIdentity = { dev: stats.dev, ino: stats.ino };\n\t\t\tawait link(ownedBindPath, this.path);\n\t\t\tawait setSocketMode(this.path, this.mode);\n\t\t\tawait removePath(ownedBindPath);\n\t\t\tthis.ownedBindPath = undefined;\n\t\t} catch (error) {\n\t\t\tawait this.closeServerAndCleanup(server);\n\t\t\tthis.server = undefined;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this.closePromise) return this.closePromise;\n\t\tthis.closing = true;\n\t\tthis.closePromise = this.closeInternal();\n\t\treturn this.closePromise;\n\t}\n\n\tprivate acceptSocket(socket: Socket): void {\n\t\tif (this.closing) {\n\t\t\tsocket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tconst connection = new UnixByteConnection(\n\t\t\tsocket,\n\t\t\tthis.options.gracefulCloseTimeoutMs,\n\t\t\tthis.options.maxPendingBytes,\n\t\t);\n\t\tthis.connections.add(connection);\n\t\tconst accept = this.accept;\n\t\tif (!accept) {\n\t\t\tsocket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tconst handler = accept(connection);\n\t\tsocket.on(\"data\", (chunk) => {\n\t\t\thandler.onData(new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength));\n\t\t});\n\t\tsocket.on(\"error\", (error) => {\n\t\t\thandler.onError(error);\n\t\t\tsocket.destroy();\n\t\t});\n\t\tsocket.once(\"close\", () => {\n\t\t\tconnection.markClosed();\n\t\t\tthis.connections.delete(connection);\n\t\t\thandler.onClose();\n\t\t});\n\t}\n\n\tprivate async closeInternal(): Promise<void> {\n\t\tconst serverClosed = this.server ? this.closeServerAndCleanup(this.server) : this.cleanupOwnedSocket();\n\t\tawait Promise.all([...this.connections].map((connection) => connection.close()));\n\t\tawait serverClosed;\n\t\tif (this.ownedBindPath) await removePath(this.ownedBindPath);\n\t\tthis.ownedBindPath = undefined;\n\t\tthis.connections.clear();\n\t\tthis.server = undefined;\n\t}\n\n\tprivate async closeServerAndCleanup(server: Server): Promise<void> {\n\t\ttry {\n\t\t\tawait closeNetServer(server, (error) => this.reportError(error));\n\t\t} finally {\n\t\t\t// Remove an unpublished startup bind path before the public route.\n\t\t\tif (this.ownedBindPath) await removePath(this.ownedBindPath);\n\t\t\tthis.ownedBindPath = undefined;\n\t\t\tawait this.cleanupOwnedSocket();\n\t\t}\n\t}\n\n\tprivate async cleanupOwnedSocket(): Promise<void> {\n\t\tconst identity = this.socketIdentity;\n\t\tthis.socketIdentity = undefined;\n\t\tif (!identity) return;\n\t\tlet current: Stats;\n\t\ttry {\n\t\t\tcurrent = await lstat(this.path);\n\t\t} catch (error) {\n\t\t\tif (isErrorCode(error, \"ENOENT\")) return;\n\t\t\tthrow error;\n\t\t}\n\t\tif (!current.isSocket() || current.dev !== identity.dev || current.ino !== identity.ino) return;\n\n\t\tconst preserved = join(dirname(this.path), `cleanup-${randomUUID().slice(0, 6)}`);\n\t\ttry {\n\t\t\tawait rename(this.path, preserved);\n\t\t} catch (error) {\n\t\t\tif (isErrorCode(error, \"ENOENT\")) return;\n\t\t\tthrow error;\n\t\t}\n\t\tconst moved = await lstat(preserved);\n\t\tif (moved.isSocket() && moved.dev === identity.dev && moved.ino === identity.ino) {\n\t\t\tawait removePath(preserved);\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tawait lstat(this.path);\n\t\t} catch (error) {\n\t\t\tif (isErrorCode(error, \"ENOENT\")) await rename(preserved, this.path);\n\t\t\telse throw error;\n\t\t}\n\t\tthrow new Error(`Unix listener path changed during cleanup; preserved replacement at ${preserved}`);\n\t}\n\n\tprivate reportError(error: unknown): void {\n\t\ttry {\n\t\t\tthis.options.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t} catch {\n\t\t\t// Error observers cannot affect listener state.\n\t\t}\n\t}\n}\n\n/** @internal Exported only for transport-level verification. */\nexport class UnixByteConnection implements ByteConnection {\n\tprivate readonly socket: Socket;\n\tprivate readonly gracefulCloseTimeoutMs: number;\n\tprivate readonly maxPendingBytes: number;\n\tprivate pendingBytes = 0;\n\tprivate closedValue = false;\n\tprivate closing = false;\n\tprivate writeTail: Promise<void> = Promise.resolve();\n\tprivate closePromise?: Promise<void>;\n\tprivate resolveClose?: () => void;\n\n\tconstructor(socket: Socket, gracefulCloseTimeoutMs: number, maxPendingBytes: number) {\n\t\tthis.socket = socket;\n\t\tthis.gracefulCloseTimeoutMs = gracefulCloseTimeoutMs;\n\t\tthis.maxPendingBytes = maxPendingBytes;\n\t}\n\n\tget closed(): boolean {\n\t\treturn this.closedValue;\n\t}\n\n\tsend(chunk: Uint8Array): Promise<void> {\n\t\tif (!(chunk instanceof Uint8Array)) {\n\t\t\treturn Promise.reject(new TypeError(\"Unix connection chunks must be Uint8Array\"));\n\t\t}\n\t\tif (this.closedValue || this.closing) return Promise.reject(new Error(\"Unix connection is closed\"));\n\t\tif (this.pendingBytes + chunk.byteLength > this.maxPendingBytes) {\n\t\t\treturn Promise.reject(new Error(\"Unix connection exceeded its pending byte limit\"));\n\t\t}\n\t\tthis.pendingBytes += chunk.byteLength;\n\t\tconst bytes = chunk.slice();\n\t\tconst write = this.writeTail.then(() => this.write(bytes));\n\t\tconst tracked = write.finally(() => {\n\t\t\tthis.pendingBytes -= bytes.byteLength;\n\t\t});\n\t\tthis.writeTail = tracked.catch(() => {});\n\t\treturn tracked;\n\t}\n\n\tclose(finalChunk?: Uint8Array): Promise<void> {\n\t\tif (this.closedValue || this.socket.destroyed) {\n\t\t\tthis.markClosed();\n\t\t\treturn Promise.resolve();\n\t\t}\n\t\tif (this.closePromise) return this.closePromise;\n\t\tthis.closing = true;\n\t\tconst finalBytes = finalChunk?.slice();\n\t\tthis.closePromise = new Promise<void>((resolve) => {\n\t\t\tthis.resolveClose = resolve;\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tif (!this.socket.destroyed) this.socket.destroy();\n\t\t\t\tthis.markClosed();\n\t\t\t}, this.gracefulCloseTimeoutMs);\n\t\t\ttimer.unref();\n\t\t\tthis.socket.once(\"close\", () => clearTimeout(timer));\n\t\t\tvoid this.writeTail.then(() => {\n\t\t\t\tif (this.socket.destroyed) {\n\t\t\t\t\tthis.markClosed();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tif (finalBytes) this.socket.end(finalBytes);\n\t\t\t\t\telse this.socket.end();\n\t\t\t\t} catch {\n\t\t\t\t\tthis.socket.destroy();\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t\treturn this.closePromise;\n\t}\n\n\tmarkClosed(): void {\n\t\tif (this.closedValue) return;\n\t\tthis.closedValue = true;\n\t\tthis.closing = true;\n\t\tthis.resolveClose?.();\n\t\tthis.resolveClose = undefined;\n\t}\n\n\tprivate write(chunk: Uint8Array): Promise<void> {\n\t\tif (this.closedValue || this.closing || !this.socket.writable) {\n\t\t\treturn Promise.reject(new Error(\"Unix connection is closed\"));\n\t\t}\n\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\tlet settled = false;\n\t\t\tconst onClose = (): void => finish(new Error(\"Unix connection closed during write\"));\n\t\t\tconst finish = (error?: Error | null): void => {\n\t\t\t\tif (settled) return;\n\t\t\t\tsettled = true;\n\t\t\t\tthis.socket.off(\"close\", onClose);\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve();\n\t\t\t};\n\t\t\tthis.socket.once(\"close\", onClose);\n\t\t\ttry {\n\t\t\t\tthis.socket.write(chunk, finish);\n\t\t\t} catch (error) {\n\t\t\t\tfinish(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t});\n\t}\n}\n\nfunction getOwnedBindPath(path: string): string {\n\tconst suffix = createHash(\"sha256\").update(path).digest(\"hex\").slice(0, 8);\n\treturn join(dirname(path), `bind-${suffix}`);\n}\n\nasync function removeStaleSocket(path: string): Promise<void> {\n\tlet original: Stats;\n\ttry {\n\t\toriginal = await lstat(path);\n\t} catch (error) {\n\t\tif (isErrorCode(error, \"ENOENT\")) return;\n\t\tthrow error;\n\t}\n\tif (!original.isSocket()) throw new Error(`Refusing to remove non-socket Unix listener path: ${path}`);\n\tif (await isSocketLive(path)) throw new Error(`Unix listener is already running: ${path}`);\n\n\tconst preserved = join(dirname(path), `stale-${randomUUID().slice(0, 6)}`);\n\ttry {\n\t\tawait rename(path, preserved);\n\t} catch (error) {\n\t\tif (isErrorCode(error, \"ENOENT\")) return;\n\t\tthrow error;\n\t}\n\tconst current = await lstat(preserved);\n\tif (!current.isSocket() || current.dev !== original.dev || current.ino !== original.ino) {\n\t\ttry {\n\t\t\tawait lstat(path);\n\t\t} catch (error) {\n\t\t\tif (isErrorCode(error, \"ENOENT\")) await rename(preserved, path);\n\t\t\telse throw error;\n\t\t}\n\t\tthrow new Error(`Unix listener path changed while checking for a stale socket: ${path}`);\n\t}\n\tawait removePath(preserved);\n}\n\nasync function removePath(path: string): Promise<void> {\n\ttry {\n\t\tawait unlink(path);\n\t} catch (error) {\n\t\tif (!isErrorCode(error, \"ENOENT\")) throw error;\n\t}\n}\n\nfunction isSocketLive(path: string): Promise<boolean> {\n\treturn new Promise<boolean>((resolve, reject) => {\n\t\tconst socket = createConnection(path);\n\t\tlet settled = false;\n\t\tlet timer: NodeJS.Timeout | undefined;\n\t\tconst finish = (result: boolean, error?: Error): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\tsocket.removeAllListeners();\n\t\t\tsocket.destroy();\n\t\t\tif (error) reject(error);\n\t\t\telse resolve(result);\n\t\t};\n\t\tsocket.once(\"connect\", () => finish(true));\n\t\tsocket.once(\"error\", (error: NodeJS.ErrnoException) => {\n\t\t\tif ([\"ECONNREFUSED\", \"ENOENT\", \"EPIPE\", \"ECONNRESET\"].includes(error.code ?? \"\")) {\n\t\t\t\tfinish(false);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfinish(false, error);\n\t\t});\n\t\ttimer = setTimeout(() => finish(true), SOCKET_PROBE_TIMEOUT_MS);\n\t\ttimer.unref();\n\t});\n}\n\nasync function setSocketMode(path: string, mode: number): Promise<void> {\n\tif (process.platform === \"win32\") return;\n\ttry {\n\t\tawait chmod(path, mode);\n\t} catch (error) {\n\t\tif (!isErrorCode(error, \"ENOSYS\") && !isErrorCode(error, \"ENOTSUP\")) throw error;\n\t}\n}\n\nfunction closeNetServer(server: Server, reportError: (error: Error) => void): Promise<void> {\n\tif (!server.listening) return Promise.resolve();\n\treturn new Promise<void>((resolve) => {\n\t\tserver.close((error) => {\n\t\t\tif (error) reportError(error);\n\t\t\tresolve();\n\t\t});\n\t});\n}\n\nfunction isErrorCode(error: unknown, code: string): boolean {\n\treturn error instanceof Error && \"code\" in error && error.code === code;\n}\n\nexport function createUnixListener(options: UnixListenerOptions): ServerListener {\n\treturn new UnixListener(options);\n}\n\nfunction resolveUnixListenerOptions(options: UnixListenerOptions): ResolvedUnixListenerOptions {\n\tif (!options.path) throw new TypeError(\"Server Unix socket path must not be empty\");\n\tconst mode = options.mode ?? DEFAULT_SOCKET_MODE;\n\tif (!Number.isInteger(mode) || mode < 0 || mode > 0o777) {\n\t\tthrow new TypeError(\"Server Unix socket mode must be an integer between 0 and 0o777\");\n\t}\n\tconst maxFrameLength = options.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\tif (!Number.isSafeInteger(maxFrameLength) || maxFrameLength <= 0 || maxFrameLength > MAX_UINT32) {\n\t\tthrow new TypeError(`Server maxFrameLength must be an integer between 1 and ${MAX_UINT32}`);\n\t}\n\tconst maxPendingBytes = options.maxPendingBytes ?? maxFrameLength * 4;\n\tif (!Number.isSafeInteger(maxPendingBytes) || maxPendingBytes < maxFrameLength + 4) {\n\t\tthrow new TypeError(\"Server maxPendingBytes must be a safe integer at least maxFrameLength + 4\");\n\t}\n\tconst gracefulCloseTimeoutMs = options.gracefulCloseTimeoutMs ?? DEFAULT_GRACEFUL_CLOSE_TIMEOUT_MS;\n\tif (\n\t\t!Number.isSafeInteger(gracefulCloseTimeoutMs) ||\n\t\tgracefulCloseTimeoutMs <= 0 ||\n\t\tgracefulCloseTimeoutMs > MAX_TIMER_DELAY_MS\n\t) {\n\t\tthrow new TypeError(`Server gracefulCloseTimeoutMs must be an integer between 1 and ${MAX_TIMER_DELAY_MS}`);\n\t}\n\treturn {\n\t\tpath: options.path,\n\t\tmode,\n\t\tmaxPendingBytes,\n\t\tgracefulCloseTimeoutMs,\n\t\tonError: options.onError,\n\t};\n}\n"]}