@superblocksteam/library-shared 1.99.99-next.3 → 2.0.0-SNAPSHOT.295fc0b43e332060

package/dist/testing/fake-editor-channel/index.d.ts

@@ -0,0 +1,115 @@
+import type { ISocketClient, RequestContextBase } from "@superblocksteam/shared";
+import { EDITOR_CLIENT_METHOD_NAMES, SERVER_EDITOR_METHOD_NAMES } from "../../types/socket-method-names.js";
+import type { EditorClientMethods, ServerMethods } from "../../types/socket.js";
+export { EDITOR_CLIENT_METHOD_NAMES, SERVER_EDITOR_METHOD_NAMES };
+export { FakeArtifact, type FakeArtifactState } from "./fake-artifact.js";
+type FakeHandler<Method> = Method extends (params: infer Params) => Promise<infer Result> ? (params: Params, context: RequestContextBase, peer: ISocketClient<ServerMethods>, next: () => Promise<Result>) => Result | Promise<Result> : never;
+export type FakeEditorClientHandlers = Partial<{
+    [Method in keyof EditorClientMethods]: readonly FakeHandler<EditorClientMethods[Method]>[];
+}>;
+export type FakeServerEditorHandlers = Partial<{
+    [Method in keyof ServerMethods["editor"]]: ServerMethods["editor"][Method];
+}>;
+export interface FakeEditorChannelRequest {
+    direction: "editor-to-server" | "server-to-editor";
+    generation: number;
+    method: keyof EditorClientMethods | keyof ServerMethods["editor"];
+    params: unknown;
+    transportSeq: number;
+}
+export interface FakeEditorChannelPeer extends ISocketClient<EditorClientMethods> {
+    readonly connectionGeneration: number;
+    readonly isConnected: boolean;
+    invalidateConnection(generation: number): void;
+    whenConnected(timeoutMs: number): Promise<boolean>;
+    whenConnectedAfter(generation: number, timeoutMs: number): Promise<boolean>;
+}
+/**
+ * In-memory editor Channel Adapter for contract and surface tests.
+ *
+ * Calls from an editor into `ServerMethods.editor` are recorded by `call`.
+ * Calls from the server into `EditorClientMethods` are initiated through
+ * `push` and delivered to the handlers bound for the current connection.
+ * Editor handlers are connection-scoped: `dropConnection` clears them, so a
+ * `reconnect` without replacement handlers starts the new generation with
+ * none bound. Within a live connection, `bindEditorHandlers` merges across
+ * distinct methods but is last-write-wins per method key: re-binding a
+ * method replaces its whole handler chain rather than appending to it. The
+ * handlers passed to `reconnect` replace the entire bound set.
+ *
+ * Error behavior mirrors the real transport (`ISocket`) for the codes this
+ * fake models: 2, 5, and 10. Unknown method names reject with a plain
+ * `{ code: 2, message }` object and `next()` past the last handler rejects
+ * with a plain `{ code: 5, message, stack }` object; like the real remote
+ * error path, neither is an Error instance. Calls on a dropped connection
+ * reject with an actual `SocketErrorException` (code 10), matching the real
+ * local closed-socket path. Codes 4, 6, 7, 8, and 9 are not modeled; in
+ * particular, an in-flight push during a real mid-connection drop rejects
+ * with code 8, which this fake cannot produce because `dropConnection` does
+ * not reject in-flight work.
+ *
+ * A peer's `close`/`closeAndRejectPendingRequests` is terminal: it resolves
+ * pending connection waiters `false` immediately (matching StablePeer), while
+ * `dropConnection` is transient and leaves them pending for `reconnect`.
+ * StablePeer's disconnected-call queueing and replay (dispatch/flush) is not
+ * modeled: calls on a dropped connection reject rather than queue.
+ *
+ * By default (`strict: true`) a valid method with no handler bound also
+ * rejects with code 2, matching production; pass `strict: false` to resolve
+ * `undefined` instead for recording-only tests. In strict mode a
+ * valid-but-unhandled request IS recorded in `requests` before rejecting,
+ * while an unknown method name is NOT recorded.
+ */
+export declare class FakeEditorChannel {
+    readonly call: ISocketClient<ServerMethods>["call"];
+    readonly editorPeer: FakeEditorChannelPeer;
+    readonly push: ISocketClient<EditorClientMethods>["call"];
+    readonly requests: FakeEditorChannelRequest[];
+    private connected;
+    private editorHandlers;
+    private generation;
+    private nextTransportSeq;
+    private readonly serverHandlers;
+    private readonly strict;
+    private readonly waiters;
+    constructor(options?: {
+        editorHandlers?: FakeEditorClientHandlers;
+        serverHandlers?: FakeServerEditorHandlers;
+        /**
+         * When true (the default), a valid method with no handler bound rejects
+         * with a plain `{ code: 2, message }` object like the real transport.
+         * Pass false to resolve `undefined` instead for recording-only tests.
+         */
+        strict?: boolean;
+    });
+    get connectionGeneration(): number;
+    get isConnected(): boolean;
+    bindEditorHandlers(handlers: FakeEditorClientHandlers): void;
+    dropConnection(): void;
+    /**
+     * Terminal close, as invoked through a peer's `close` or
+     * `closeAndRejectPendingRequests`. On top of `dropConnection`, settles
+     * every pending connection waiter with `false` immediately (matching
+     * StablePeer's rejectPendingConnectionState); `dropConnection` alone
+     * leaves waiters pending so a later `reconnect` can resolve them `true`.
+     */
+    private closeConnection;
+    reconnect(handlers?: FakeEditorClientHandlers): void;
+    invalidateConnection(generation: number): void;
+    /**
+     * The editor-path correlation ID (the per-turn `requestId` string inside
+     * editor-to-server payloads) of the most recent editor call that carried
+     * one. Distinct from `transportSeq`, the fake's per-message counter, and
+     * from A2A task ids, which belong to the gateway path.
+     */
+    lastEditorPathCorrelationId(): string | undefined;
+    whenConnected(timeoutMs: number): Promise<boolean>;
+    whenConnectedAfter(generation: number, timeoutMs: number): Promise<boolean>;
+    private record;
+    private receiveEditorCall;
+    private pushToEditor;
+    private callingPeer;
+    private assertConnected;
+    private waitForConnection;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/fake-editor-channel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/fake-editor-channel/index.ts"],"names":[],"mappings":"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"}

package/dist/testing/fake-editor-channel/index.js

@@ -0,0 +1,292 @@
+import { SocketErrorException } from "@superblocksteam/shared";
+import { EDITOR_CLIENT_METHOD_NAMES, SERVER_EDITOR_METHOD_NAMES, editorClientMethodSet, serverEditorMethodSet, } from "../../types/socket-method-names.js";
+// Re-exported for existing importers of the testing subpath; the canonical,
+// production-consumable home is `../../types/socket-method-names.js`
+// (`@superblocksteam/library-shared/types/socket-method-names`).
+export { EDITOR_CLIENT_METHOD_NAMES, SERVER_EDITOR_METHOD_NAMES };
+export { FakeArtifact } from "./fake-artifact.js";
+/**
+ * The remote-error shape the real transport delivers for an unknown method:
+ * `ISocket.handleMessage` builds `{ code: 2, message }` directly (no stack)
+ * and `respondError` JSON-serializes it, so the caller's promise rejects with
+ * a parsed plain object, never an Error instance.
+ */
+const unknownMethodError = (message) => ({
+    code: 2,
+    message,
+});
+/**
+ * Strict-mode rejection for a valid method with no handler bound. Same plain
+ * `{ code: 2, message }` shape and code as the real transport's unknown-method
+ * rejection, but the message names the missing binding so a failure points at
+ * the absent stub instead of a nonexistent typo in the method name.
+ */
+const strictUnboundError = (method) => ({
+    code: 2,
+    message: `no handler bound for ${method} (strict mode - bind a handler or construct with strict: false)`,
+});
+/**
+ * The remote-error shape the real transport delivers when a handler chain
+ * throws: `ISocket.handleMessage` catches the `SocketErrorException` and
+ * serializes `{ code, message, stack }`, so the caller's promise rejects with
+ * a parsed plain object carrying a stack string, never an Error instance.
+ */
+const remoteHandlerError = (code, message) => {
+    const exception = new SocketErrorException(code, message);
+    return {
+        code: exception.code,
+        message: exception.message,
+        stack: exception.stack,
+    };
+};
+/**
+ * In-memory editor Channel Adapter for contract and surface tests.
+ *
+ * Calls from an editor into `ServerMethods.editor` are recorded by `call`.
+ * Calls from the server into `EditorClientMethods` are initiated through
+ * `push` and delivered to the handlers bound for the current connection.
+ * Editor handlers are connection-scoped: `dropConnection` clears them, so a
+ * `reconnect` without replacement handlers starts the new generation with
+ * none bound. Within a live connection, `bindEditorHandlers` merges across
+ * distinct methods but is last-write-wins per method key: re-binding a
+ * method replaces its whole handler chain rather than appending to it. The
+ * handlers passed to `reconnect` replace the entire bound set.
+ *
+ * Error behavior mirrors the real transport (`ISocket`) for the codes this
+ * fake models: 2, 5, and 10. Unknown method names reject with a plain
+ * `{ code: 2, message }` object and `next()` past the last handler rejects
+ * with a plain `{ code: 5, message, stack }` object; like the real remote
+ * error path, neither is an Error instance. Calls on a dropped connection
+ * reject with an actual `SocketErrorException` (code 10), matching the real
+ * local closed-socket path. Codes 4, 6, 7, 8, and 9 are not modeled; in
+ * particular, an in-flight push during a real mid-connection drop rejects
+ * with code 8, which this fake cannot produce because `dropConnection` does
+ * not reject in-flight work.
+ *
+ * A peer's `close`/`closeAndRejectPendingRequests` is terminal: it resolves
+ * pending connection waiters `false` immediately (matching StablePeer), while
+ * `dropConnection` is transient and leaves them pending for `reconnect`.
+ * StablePeer's disconnected-call queueing and replay (dispatch/flush) is not
+ * modeled: calls on a dropped connection reject rather than queue.
+ *
+ * By default (`strict: true`) a valid method with no handler bound also
+ * rejects with code 2, matching production; pass `strict: false` to resolve
+ * `undefined` instead for recording-only tests. In strict mode a
+ * valid-but-unhandled request IS recorded in `requests` before rejecting,
+ * while an unknown method name is NOT recorded.
+ */
+export class FakeEditorChannel {
+    call;
+    editorPeer;
+    push;
+    requests = [];
+    connected = true;
+    editorHandlers = {};
+    generation = 1;
+    nextTransportSeq = 1;
+    serverHandlers;
+    strict;
+    waiters = new Set();
+    constructor(options = {}) {
+        this.serverHandlers = options.serverHandlers ?? {};
+        this.strict = options.strict ?? true;
+        this.bindEditorHandlers(options.editorHandlers ?? {});
+        const editorCalls = Object.fromEntries(SERVER_EDITOR_METHOD_NAMES.map((method) => [
+            method,
+            (params) => this.receiveEditorCall(method, params),
+        ]));
+        this.call = { editor: editorCalls };
+        this.push = Object.fromEntries(EDITOR_CLIENT_METHOD_NAMES.map((method) => [
+            method,
+            (params) => this.pushToEditor(method, params),
+        ]));
+        const getConnectionGeneration = () => this.connectionGeneration;
+        const getIsConnected = () => this.isConnected;
+        this.editorPeer = {
+            get connectionGeneration() {
+                return getConnectionGeneration();
+            },
+            get isConnected() {
+                return getIsConnected();
+            },
+            call: this.push,
+            close: () => this.closeConnection(),
+            closeAndRejectPendingRequests: () => this.closeConnection(),
+            invalidateConnection: (generation) => this.invalidateConnection(generation),
+            requestWithTracing: (method, params) => this.pushToEditor(method, params),
+            whenConnected: (timeoutMs) => this.whenConnected(timeoutMs),
+            whenConnectedAfter: (generation, timeoutMs) => this.whenConnectedAfter(generation, timeoutMs),
+        };
+    }
+    get connectionGeneration() {
+        return this.generation;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    bindEditorHandlers(handlers) {
+        this.editorHandlers = { ...this.editorHandlers, ...handlers };
+    }
+    dropConnection() {
+        this.connected = false;
+        this.editorHandlers = {};
+    }
+    /**
+     * Terminal close, as invoked through a peer's `close` or
+     * `closeAndRejectPendingRequests`. On top of `dropConnection`, settles
+     * every pending connection waiter with `false` immediately (matching
+     * StablePeer's rejectPendingConnectionState); `dropConnection` alone
+     * leaves waiters pending so a later `reconnect` can resolve them `true`.
+     */
+    closeConnection() {
+        this.dropConnection();
+        for (const waiter of this.waiters) {
+            clearTimeout(waiter.timer);
+            waiter.resolve(false);
+        }
+        this.waiters.clear();
+    }
+    reconnect(handlers) {
+        if (handlers) {
+            this.editorHandlers = handlers;
+        }
+        this.connected = true;
+        this.generation += 1;
+        for (const waiter of this.waiters) {
+            if (this.generation > waiter.afterGeneration) {
+                clearTimeout(waiter.timer);
+                waiter.resolve(true);
+                this.waiters.delete(waiter);
+            }
+        }
+    }
+    invalidateConnection(generation) {
+        if (generation === this.generation) {
+            this.dropConnection();
+        }
+    }
+    /**
+     * The editor-path correlation ID (the per-turn `requestId` string inside
+     * editor-to-server payloads) of the most recent editor call that carried
+     * one. Distinct from `transportSeq`, the fake's per-message counter, and
+     * from A2A task ids, which belong to the gateway path.
+     */
+    lastEditorPathCorrelationId() {
+        for (let index = this.requests.length - 1; index >= 0; index -= 1) {
+            const request = this.requests[index];
+            if (request?.direction !== "editor-to-server") {
+                continue;
+            }
+            const params = request.params;
+            if (params && typeof params === "object" && "requestId" in params) {
+                const requestId = params.requestId;
+                if (typeof requestId === "string") {
+                    return requestId;
+                }
+            }
+        }
+        return undefined;
+    }
+    whenConnected(timeoutMs) {
+        if (this.connected) {
+            return Promise.resolve(true);
+        }
+        return this.waitForConnection(this.generation - 1, timeoutMs);
+    }
+    whenConnectedAfter(generation, timeoutMs) {
+        if (this.connected && this.generation > generation) {
+            return Promise.resolve(true);
+        }
+        return this.waitForConnection(generation, timeoutMs);
+    }
+    record(direction, method, params) {
+        const transportSeq = this.nextTransportSeq;
+        this.nextTransportSeq += 1;
+        this.requests.push({
+            direction,
+            generation: this.generation,
+            method,
+            params,
+            transportSeq,
+        });
+        return { method: String(method), requestId: transportSeq };
+    }
+    async receiveEditorCall(method, params) {
+        this.assertConnected();
+        // Object.hasOwn, not `in`: the `in` operator walks the prototype chain,
+        // so an Object.prototype name like "hasOwnProperty" would pass the guard.
+        if (!Object.hasOwn(serverEditorMethodSet, method)) {
+            return Promise.reject(unknownMethodError(`unknown method editor.${String(method)}`));
+        }
+        this.record("editor-to-server", method, params);
+        const handler = Object.hasOwn(this.serverHandlers, method)
+            ? this.serverHandlers[method]
+            : undefined;
+        if (!handler) {
+            if (this.strict) {
+                return Promise.reject(strictUnboundError(`editor.${String(method)}`));
+            }
+            return undefined;
+        }
+        return handler(params);
+    }
+    async pushToEditor(method, params) {
+        this.assertConnected();
+        // Object.hasOwn, not `in`: the `in` operator walks the prototype chain,
+        // so an Object.prototype name like "hasOwnProperty" would pass the guard.
+        if (!Object.hasOwn(editorClientMethodSet, method)) {
+            return Promise.reject(unknownMethodError(`unknown method ${String(method)}`));
+        }
+        const context = this.record("server-to-editor", method, params);
+        const handlers = Object.hasOwn(this.editorHandlers, method)
+            ? this.editorHandlers[method]
+            : undefined;
+        if (!handlers?.length) {
+            if (this.strict) {
+                return Promise.reject(strictUnboundError(String(method)));
+            }
+            return undefined;
+        }
+        const invoke = (index) => {
+            const handler = handlers[index];
+            if (!handler) {
+                return Promise.reject(remoteHandlerError(5, "cannot call past the last handler in the chain"));
+            }
+            return Promise.resolve(handler(params, context, this.callingPeer(), () => invoke(index + 1)));
+        };
+        return invoke(0);
+    }
+    callingPeer() {
+        return {
+            call: this.call,
+            close: () => this.closeConnection(),
+            closeAndRejectPendingRequests: () => this.closeConnection(),
+            requestWithTracing: (method, params) => {
+                const editorPrefix = "editor.";
+                const editorMethod = method.startsWith(editorPrefix)
+                    ? method.slice(editorPrefix.length)
+                    : method;
+                return this.receiveEditorCall(editorMethod, params);
+            },
+        };
+    }
+    assertConnected() {
+        if (!this.connected) {
+            throw new SocketErrorException(10, "[internal] Connection closed");
+        }
+    }
+    waitForConnection(afterGeneration, timeoutMs) {
+        return new Promise((resolve) => {
+            const waiter = {
+                afterGeneration,
+                resolve,
+                timer: setTimeout(() => {
+                    this.waiters.delete(waiter);
+                    resolve(false);
+                }, timeoutMs),
+            };
+            this.waiters.add(waiter);
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/fake-editor-channel/index.js.map

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

package/dist/testing/fake-editor-channel/type-pins.d.ts

@@ -0,0 +1,13 @@
+import type { MethodSchema } from "@superblocksteam/shared";
+import type { IsVoidMethodResult } from "../../types/socket-method-names.js";
+import type { FakeEditorClientHandlers } from "./index.js";
+type BoundHandler<Method extends keyof FakeEditorClientHandlers> = NonNullable<FakeEditorClientHandlers[Method]>[number];
+export declare const aiPushMessageHandlerPin: BoundHandler<"aiPushMessage">;
+export declare const aiCaptureScreenshotHandlerPin: BoundHandler<"aiCaptureScreenshot">;
+type ClassifiedMethodResult<Method extends MethodSchema<never, unknown>> = IsVoidMethodResult<Awaited<ReturnType<Method>>>;
+export declare const anyResultClassifiesNonVoidPin: ClassifiedMethodResult<MethodSchema<void, any>>;
+export declare const neverResultClassifiesNonVoidPin: ClassifiedMethodResult<MethodSchema<void, never>>;
+export declare const voidResultClassifiesVoidPin: ClassifiedMethodResult<MethodSchema<void, void>>;
+export declare const unionWithVoidClassifiesNonVoidPin: ClassifiedMethodResult<MethodSchema<void, string | void>>;
+export {};
+//# sourceMappingURL=type-pins.d.ts.map

package/dist/testing/fake-editor-channel/type-pins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-pins.d.ts","sourceRoot":"","sources":["../../../src/testing/fake-editor-channel/type-pins.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,KAAK,YAAY,CAAC,MAAM,SAAS,MAAM,wBAAwB,IAAI,WAAW,CAC5E,wBAAwB,CAAC,MAAM,CAAC,CACjC,CAAC,MAAM,CAAC,CAAC;AAIV,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAChD,eAAe,CACC,CAAC;AAEnB,eAAO,MAAM,6BAA6B,EAAE,YAAY,CACtD,qBAAqB,CACH,CAAC;AAOrB,KAAK,sBAAsB,CAAC,MAAM,SAAS,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,IACrE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAGlD,eAAO,MAAM,6BAA6B,EAAE,sBAAsB,CAChE,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAChB,CAAC;AAGV,eAAO,MAAM,+BAA+B,EAAE,sBAAsB,CAClE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAClB,CAAC;AAGV,eAAO,MAAM,2BAA2B,EAAE,sBAAsB,CAC9D,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAClB,CAAC;AAGT,eAAO,MAAM,iCAAiC,EAAE,sBAAsB,CACpE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAC1B,CAAC"}

package/dist/testing/fake-editor-channel/type-pins.js

@@ -0,0 +1,13 @@
+// Each assignment errors if the FakeHandler conditional resolves to never,
+// because no function is assignable to never.
+export const aiPushMessageHandlerPin = async () => { };
+export const aiCaptureScreenshotHandlerPin = async () => ({});
+// An `any` result must classify non-void.
+export const anyResultClassifiesNonVoidPin = false;
+// A `never` result must classify non-void.
+export const neverResultClassifiesNonVoidPin = false;
+// A genuine void result stays void.
+export const voidResultClassifiesVoidPin = true;
+// A union containing void still promises a real result, so non-void.
+export const unionWithVoidClassifiesNonVoidPin = false;
+//# sourceMappingURL=type-pins.js.map

package/dist/testing/fake-editor-channel/type-pins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-pins.js","sourceRoot":"","sources":["../../../src/testing/fake-editor-channel/type-pins.ts"],"names":[],"mappings":"AAYA,2EAA2E;AAC3E,8CAA8C;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAEhC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;AAEnB,MAAM,CAAC,MAAM,6BAA6B,GAEtC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAUrB,0CAA0C;AAC1C,MAAM,CAAC,MAAM,6BAA6B,GAEtC,KAAK,CAAC;AAEV,2CAA2C;AAC3C,MAAM,CAAC,MAAM,+BAA+B,GAExC,KAAK,CAAC;AAEV,oCAAoC;AACpC,MAAM,CAAC,MAAM,2BAA2B,GAEpC,IAAI,CAAC;AAET,qEAAqE;AACrE,MAAM,CAAC,MAAM,iCAAiC,GAE1C,KAAK,CAAC"}