@superblocksteam/shared 0.9618.1 → 0.9619.0

package/dist-esm/socket/socketWithClientAuth.js

@@ -1,57 +0,0 @@
-import { createISocketClient } from './socket.js';
-import { TracedSocket } from './tracedSocket.js';
-import { connectWebSocket } from './util.js';
-// a subclass of ISocket that sends an auth token on the first request
-// this is useful for client-side sockets that need to authenticate
-export class ISocketWithClientAuth extends TracedSocket {
-    authorization;
-    authorizationVersion = 0;
-    authorizationRequestVersion = 0;
-    getAuthorization;
-    hasSentAuth = false;
-    constructor(ws, authorization, requestHandlers, globalMiddlewares, tracer, options) {
-        super(ws, requestHandlers, globalMiddlewares, tracer, options);
-        this.authorization = authorization;
-        this.getAuthorization = options.getAuthorization;
-    }
-    // override `request` from the base class to send `authorization` when appropriate
-    async request(method, params) {
-        if (this.getAuthorization) {
-            const requestVersion = ++this.authorizationRequestVersion;
-            const authorizationVersion = this.authorizationVersion;
-            const authorization = await this.getAuthorization();
-            if (requestVersion === this.authorizationRequestVersion &&
-                authorizationVersion === this.authorizationVersion &&
-                authorization !== this.authorization)
-                this.setAuthorization(authorization);
-        }
-        const authorizationVersion = this.authorizationVersion;
-        const authorization = this.hasSentAuth ? undefined : this.authorization;
-        const result = await super.request(method, params, authorization);
-        if (this.authorizationVersion === authorizationVersion) {
-            this.hasSentAuth = true;
-        }
-        return result;
-    }
-    /**
-     * Updates the authorization token for this socket.
-     * This is useful for long-lived connections where the token may expire and need to be refreshed.
-     *
-     * @param newAuthorization - The new authorization token (e.g., "Bearer <token>") or undefined to clear it
-     */
-    setAuthorization(newAuthorization) {
-        this.authorization = newAuthorization;
-        this.authorizationVersion++;
-        this.hasSentAuth = false;
-    }
-}
-/**
- * Creates a new socket for a set of operations, without any retry behavior
- * If the requests fail, the promise will reject.
- */
-export async function connectSingleUseISocket(wsUrl, authorization, requestHandlers, globalMiddlewares, tracer, options) {
-    const ws = await connectWebSocket(wsUrl);
-    const isocket = new ISocketWithClientAuth(ws, authorization, requestHandlers, globalMiddlewares, tracer, options);
-    return createISocketClient(isocket);
-}
-//# sourceMappingURL=socketWithClientAuth.js.map

package/dist-esm/socket/socketWithClientAuth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"socketWithClientAuth.js","sourceRoot":"","sources":["../../src/socket/socketWithClientAuth.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,sEAAsE;AACtE,mEAAmE;AACnE,MAAM,OAAO,qBAAsG,SAAQ,YAI1H;IACS,aAAa,CAAU;IACvB,oBAAoB,GAAG,CAAC,CAAC;IACzB,2BAA2B,GAAG,CAAC,CAAC;IACvB,gBAAgB,CAAyB;IAClD,WAAW,GAAG,KAAK,CAAC;IAE5B,YACE,EAAa,EACb,aAAiC,EACjC,eAAoF,EACpF,iBAAuE,EACvE,MAAc,EACd,OAMC;QAED,KAAK,CAAC,EAAE,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,OAAO,CAAiB,MAAc,EAAE,MAAc;QAC1D,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,EAAE,IAAI,CAAC,2BAA2B,CAAC;YAC1D,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;YACvD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpD,IACE,cAAc,KAAK,IAAI,CAAC,2BAA2B;gBACnD,oBAAoB,KAAK,IAAI,CAAC,oBAAoB;gBAClD,aAAa,KAAK,IAAI,CAAC,aAAa;gBAEpC,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACvD,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAiB,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,oBAAoB,KAAK,oBAAoB,EAAE,CAAC;YACvD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,gBAAoC;QACnD,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC;QACtC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAK3C,KAAa,EACb,aAAiC,EACjC,eAAoF,EACpF,iBAAuE,EACvE,MAAc,EACd,OAIC;IAED,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,EAAE,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClH,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist-esm/socket/socketWithClientAuth.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=socketWithClientAuth.test.d.ts.map

package/dist-esm/socket/socketWithClientAuth.test.d.ts.map

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

package/dist-esm/socket/socketWithClientAuth.test.js

@@ -1,101 +0,0 @@
-import { once } from 'node:events';
-import { trace } from '@opentelemetry/api';
-import WebSocket from 'isomorphic-ws';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { ISocketWithClientAuth } from './socketWithClientAuth.js';
-import { connectWebSocket } from './util.js';
-describe('socket request authorization', () => {
-    const servers = [];
-    const authorizations = [];
-    async function connect(options) {
-        const server = new WebSocket.Server({ host: '127.0.0.1', port: 0 });
-        servers.push(server);
-        server.on('connection', (ws) => {
-            ws.on('message', (data) => {
-                const message = JSON.parse(data.toString());
-                if (!message.request)
-                    throw new Error('Expected a socket request');
-                authorizations.push(message.request.setAuthorization);
-                ws.send(JSON.stringify({ response: { error: null, id: message.request.id, payload: 'ok' } }));
-            });
-        });
-        await once(server, 'listening');
-        const address = server.address();
-        if (!address || typeof address === 'string')
-            throw new Error('Expected a TCP test server');
-        const ws = await connectWebSocket(`ws://127.0.0.1:${address.port}`);
-        return new ISocketWithClientAuth(ws, options.authorization, {}, [], trace.getTracer('socket-auth-test'), {
-            getAuthorization: options.getAuthorization,
-            onClose: () => undefined
-        });
-    }
-    afterEach(async () => {
-        authorizations.length = 0;
-        for (const server of servers.splice(0)) {
-            for (const client of server.clients)
-                client.terminate();
-            await new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())));
-        }
-    });
-    it('refreshes authorization before each request and sends only changed credentials', async () => {
-        let authorization = 'Bearer first-token';
-        const socket = await connect({ authorization: 'Bearer expired-token', getAuthorization: async () => authorization });
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        authorization = 'Bearer second-token';
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        expect(authorizations).toEqual(['Bearer first-token', undefined, 'Bearer second-token']);
-        socket.close();
-    });
-    it('does not restore stale authorization when refreshes resolve out of order', async () => {
-        let resolveFirst;
-        const first = new Promise((resolve) => {
-            resolveFirst = resolve;
-        });
-        const getAuthorization = vi.fn().mockReturnValueOnce(first).mockResolvedValueOnce('Bearer new-token');
-        const socket = await connect({ getAuthorization });
-        const olderRequest = socket.request('test.read', {});
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        resolveFirst('Bearer old-token');
-        await expect(olderRequest).resolves.toBe('ok');
-        expect(authorizations).toEqual(['Bearer new-token', undefined]);
-        socket.close();
-    });
-    it('does not overwrite a manual account switch while refresh is pending', async () => {
-        let resolveRefresh;
-        const refreshing = new Promise((resolve) => {
-            resolveRefresh = resolve;
-        });
-        const socket = await connect({ getAuthorization: () => refreshing });
-        const pending = socket.request('test.read', {});
-        socket.setAuthorization('Bearer switched-token');
-        resolveRefresh('Bearer stale-token');
-        await expect(pending).resolves.toBe('ok');
-        expect(authorizations).toEqual(['Bearer switched-token']);
-        socket.close();
-    });
-    it('sends no request when refreshing authorization fails and allows a later retry', async () => {
-        let refreshFailed = true;
-        const socket = await connect({
-            authorization: 'Bearer expired-token',
-            getAuthorization: async () => {
-                if (refreshFailed)
-                    throw new Error('Refresh unavailable');
-                return 'Bearer refreshed-token';
-            }
-        });
-        await expect(socket.request('test.read', {})).rejects.toThrow('Refresh unavailable');
-        refreshFailed = false;
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        expect(authorizations).toEqual(['Bearer refreshed-token']);
-        socket.close();
-    });
-    it('preserves static authorization when no provider is supplied', async () => {
-        const socket = await connect({ authorization: 'Bearer personal-token' });
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        await expect(socket.request('test.read', {})).resolves.toBe('ok');
-        expect(authorizations).toEqual(['Bearer personal-token', undefined]);
-        socket.close();
-    });
-});
-//# sourceMappingURL=socketWithClientAuth.test.js.map

package/dist-esm/socket/socketWithClientAuth.test.js.map

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

package/dist-esm/socket/tracedSocket.d.ts

@@ -1,65 +0,0 @@
-import { Tracer } from '@opentelemetry/api';
-import WebSocket from 'isomorphic-ws';
-import { ISocket, SocketError, SocketMessage } from './socket.js';
-import { GenericMiddleware, ISocketClient, MethodHandler, MethodHandlers, RequestContextBase, SocketTimeouts } from './types.js';
-/**
- * @deprecated Use `TracedSocket` from `@superblocksteam/telemetry` instead.
- * This class will be removed in a future version.
- *
- * Migration:
- * ```typescript
- * // Before
- * import { TracedSocket } from '@superblocksteam/shared';
- *
- * // After
- * import { TracedSocket, getTelemetryInstance } from '@superblocksteam/telemetry';
- * const { policyEvaluator } = getTelemetryInstance();
- * new TracedSocket(ws, handlers, middlewares, { requestHeaders, policyEvaluator }, options);
- * ```
- */
-export declare class TracedSocket<ImplementedMethods, CallableMethods, RequestContext extends RequestContextBase> extends ISocket<ImplementedMethods, CallableMethods, RequestContext> {
-    /**
-     * The TracedSocket class extends the ISocket class to add tracing capabilities for each connection. It manages
-     * spans for handler calls to provide detailed tracing information.
-     *
-     * Unlike Express, the ISocket handler call chain is fully recursive. This recursion makes it challenging to determine
-     * when to create and end spans for specific handlers, as handlers may call other handlers before returning a result.
-     *
-     * An example span for recursive call
-     * Main span ----------------------------------------------------------------------------------
-     * Handler1     ----------------------------------------------------------------------------
-     * Handler2           ----------------------------------------------------------------------
-     *
-     * To manage this, we keep a reference to the most recently created span and complete that span when we go one step deeper into the recursion.
-     * This approach works for now since we don't support much parallelism, but it will need to be updated when we start handling requests concurrently.
-     *
-     * An example span for recursive call after the above fixes
-     * Main span ----------------------------------------------------------------------------------
-     * Handler1     -----------------------------
-     * Handler2                                  ------------------------------------------------
-     *
-     */
-    private activeSpanByRequestId;
-    private middlewareSpanByReqId;
-    private lastActiveSpan;
-    private tracer;
-    constructor(ws: WebSocket, requestHandlers: MethodHandlers<ImplementedMethods, CallableMethods, RequestContext>, globalMiddlewares: GenericMiddleware<CallableMethods, RequestContext>[], tracer: Tracer, options: {
-        onClose: (event: WebSocket.CloseEvent) => void;
-        timeouts?: SocketTimeouts;
-        logger?: {
-            error: (message?: string) => void;
-            info: (message?: string) => void;
-            warn: (message?: string) => void;
-        };
-        getAbortSignal?: () => AbortSignal | undefined;
-    });
-    protected callHandler<Params, Result, CallableMethods, RequestContext extends RequestContextBase>(handler: MethodHandler<Params, Result, CallableMethods, RequestContext>, params: Params, ctx: RequestContext, client: ISocketClient<CallableMethods>, next: () => Promise<Result>): Promise<Result>;
-    protected handleMessage(message: SocketMessage): Promise<void>;
-    request<Params, Result>(method: string, params: Params, authorization?: string): Promise<Result>;
-    protected decorateToSend(message: SocketMessage): SocketMessage;
-    protected respond<Result>(requestId: number, result: Result): void;
-    protected respondError(requestId: number, error: SocketError, exception?: Error): void;
-    private addEvent;
-    close(reason?: string): void;
-}
-//# sourceMappingURL=tracedSocket.d.ts.map

package/dist-esm/socket/tracedSocket.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracedSocket.d.ts","sourceRoot":"","sources":["../../src/socket/tracedSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,MAAM,EAEP,MAAM,oBAAoB,CAAC;AAE5B,OAAO,SAAS,MAAM,eAAe,CAAC;AAYtC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmCjI;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY,CAAC,kBAAkB,EAAE,eAAe,EAAE,cAAc,SAAS,kBAAkB,CAAE,SAAQ,OAAO,CACvH,kBAAkB,EAClB,eAAe,EACf,cAAc,CACf;IACC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,qBAAqB,CAA2B;IACxD,OAAO,CAAC,qBAAqB,CAA2B;IACxD,OAAO,CAAC,cAAc,CAAmB;IACzC,OAAO,CAAC,MAAM,CAAS;gBAGrB,EAAE,EAAE,SAAS,EACb,eAAe,EAAE,cAAc,CAAC,kBAAkB,EAAE,eAAe,EAAE,cAAc,CAAC,EACpF,iBAAiB,EAAE,iBAAiB,CAAC,eAAe,EAAE,cAAc,CAAC,EAAE,EACvE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QACP,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,KAAK,IAAI,CAAC;QAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,MAAM,CAAC,EAAE;YAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAC;QACnH,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;KAChD;cAMa,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,SAAS,kBAAkB,EACpG,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,CAAC,EACvE,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC;cAkCF,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASvG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa;IAc/D,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKlE,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI;IAStF,OAAO,CAAC,QAAQ;IAQT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAQpC"}

package/dist-esm/socket/tracedSocket.js

@@ -1,189 +0,0 @@
-import { ROOT_CONTEXT, SpanKind, SpanStatusCode, context as otelCtx, propagation, trace } from '@opentelemetry/api';
-import { SEMATTRS_MESSAGING_DESTINATION_KIND, SEMATTRS_MESSAGING_SYSTEM } from '@opentelemetry/semantic-conventions';
-import { OBS_SOCKET_STATUS_CODE, OBS_TAG_API_ID, OBS_TAG_APPLICATION_ID, OBS_TAG_BRANCH, OBS_TAG_COMMIT_ID, OBS_TAG_HTTP_ROUTE, OBS_TAG_HTTP_STATUS_CODE } from '../observability/index.js';
-import { sanitizeError } from '../tracing/errorSanitizer.js';
-import { ISocket } from './socket.js';
-function isPromise(obj) {
-    return obj !== null && typeof obj === 'object' && typeof obj.then === 'function';
-}
-// Taken from https://github.com/gadget-inc/opentelemetry-instrumentations/blob/main/packages/opentelemetry-instrumentation-ws/src/index.ts#L21
-const endSpan = (traced, span) => {
-    try {
-        const result = traced();
-        if (isPromise(result)) {
-            return Promise.resolve(result)
-                .catch((err) => {
-                setHttpStatusFromError(span, typeof err === 'string' ? new Error(err) : err);
-                throw err;
-            })
-                .finally(() => span.end());
-        }
-        else {
-            span.end();
-            return result;
-        }
-    }
-    catch (error) {
-        setHttpStatusFromError(span, error);
-        span.end();
-        throw error;
-    }
-};
-function setHttpStatusFromError(span, error) {
-    // Simplified error handling without server-side dependencies
-    span.setAttribute(OBS_TAG_HTTP_STATUS_CODE, 500);
-    span.recordException(sanitizeError(error));
-    span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
-}
-/**
- * @deprecated Use `TracedSocket` from `@superblocksteam/telemetry` instead.
- * This class will be removed in a future version.
- *
- * Migration:
- * ```typescript
- * // Before
- * import { TracedSocket } from '@superblocksteam/shared';
- *
- * // After
- * import { TracedSocket, getTelemetryInstance } from '@superblocksteam/telemetry';
- * const { policyEvaluator } = getTelemetryInstance();
- * new TracedSocket(ws, handlers, middlewares, { requestHeaders, policyEvaluator }, options);
- * ```
- */
-export class TracedSocket extends ISocket {
-    /**
-     * The TracedSocket class extends the ISocket class to add tracing capabilities for each connection. It manages
-     * spans for handler calls to provide detailed tracing information.
-     *
-     * Unlike Express, the ISocket handler call chain is fully recursive. This recursion makes it challenging to determine
-     * when to create and end spans for specific handlers, as handlers may call other handlers before returning a result.
-     *
-     * An example span for recursive call
-     * Main span ----------------------------------------------------------------------------------
-     * Handler1     ----------------------------------------------------------------------------
-     * Handler2           ----------------------------------------------------------------------
-     *
-     * To manage this, we keep a reference to the most recently created span and complete that span when we go one step deeper into the recursion.
-     * This approach works for now since we don't support much parallelism, but it will need to be updated when we start handling requests concurrently.
-     *
-     * An example span for recursive call after the above fixes
-     * Main span ----------------------------------------------------------------------------------
-     * Handler1     -----------------------------
-     * Handler2                                  ------------------------------------------------
-     *
-     */
-    activeSpanByRequestId = new Map();
-    middlewareSpanByReqId = new Map();
-    lastActiveSpan;
-    tracer;
-    constructor(ws, requestHandlers, globalMiddlewares, tracer, options) {
-        super(ws, requestHandlers, globalMiddlewares, options);
-        this.tracer = tracer;
-    }
-    async callHandler(handler, params, ctx, client, next) {
-        let currentContext = otelCtx.active();
-        const middleWareSpan = this.middlewareSpanByReqId.get(ctx.requestId);
-        const activeSpan = this.activeSpanByRequestId.get(ctx.requestId);
-        // We need to end the middleware span since callHandler is called recursively
-        // Otherwise spans will be nested which is not representing actual time taken to execute a middleware
-        // Since we are ending the span here, it won't capture error state of nested handlers
-        if (middleWareSpan) {
-            middleWareSpan.end();
-            if (activeSpan) {
-                currentContext = trace.setSpan(otelCtx.active(), activeSpan);
-            }
-        }
-        let result;
-        await otelCtx.with(currentContext, async () => {
-            await this.tracer.startActiveSpan(`WS HANDLER ${handler.name === '' ? ctx.method : handler.name}`, {
-                attributes: {
-                    [SEMATTRS_MESSAGING_SYSTEM]: 'ws',
-                    [SEMATTRS_MESSAGING_DESTINATION_KIND]: 'websocket'
-                },
-                kind: SpanKind.SERVER
-            }, async (span) => {
-                this.middlewareSpanByReqId.set(ctx.requestId, span);
-                result = await endSpan(() => super.callHandler(handler, params, ctx, client, next), span);
-                this.middlewareSpanByReqId.delete(ctx.requestId);
-            });
-        });
-        return result;
-    }
-    async handleMessage(message) {
-        if (message.request) {
-            const spanName = message.request.method;
-            const requestId = message.request.id;
-            const payload = message.request.payload;
-            await otelCtx.with(propagation.extract(ROOT_CONTEXT, message.request), async () => await this.tracer.startActiveSpan(`WS SERVER ${spanName}`, {
-                attributes: {
-                    [SEMATTRS_MESSAGING_SYSTEM]: 'ws',
-                    [SEMATTRS_MESSAGING_DESTINATION_KIND]: 'websocket',
-                    [OBS_TAG_HTTP_ROUTE]: spanName,
-                    [OBS_TAG_APPLICATION_ID]: payload?.['applicationId'],
-                    [OBS_TAG_API_ID]: payload?.['apiId'],
-                    [OBS_TAG_BRANCH]: payload?.['branch'] ?? payload?.['branchName'],
-                    [OBS_TAG_COMMIT_ID]: payload?.['commitId']
-                },
-                kind: SpanKind.SERVER
-            }, async (span) => {
-                this.lastActiveSpan = span;
-                this.activeSpanByRequestId.set(requestId, span);
-                const result = await endSpan(() => super.handleMessage(message), span);
-                this.activeSpanByRequestId.delete(requestId);
-                return result;
-            }));
-        }
-        else if (message.response) {
-            this.addEvent('ws.received-response', { ['ws.response.id']: message.response.id });
-            return await super.handleMessage(message);
-        }
-    }
-    request(method, params, authorization) {
-        return this.tracer.startActiveSpan(`WS CLIENT ${method}`, (span) => {
-            this.addEvent('ws.send-request', { ['ws.request.method']: method, ['ws.request.id']: this.nxtRequestId });
-            const result = super.request(method, params, authorization);
-            span.end();
-            return result;
-        });
-    }
-    decorateToSend(message) {
-        // TODO testing this out
-        // Use explicit tracing headers if already provided in the request
-        if (message.request?.traceparent || message.request?.tracestate) {
-            // Headers already provided - no need to inject from context
-            return message;
-        }
-        // Fallback to context.active() injection for backwards compatibility
-        // TODO end
-        propagation.inject(otelCtx.active(), message.request);
-        return message;
-    }
-    respond(requestId, result) {
-        this.addEvent('ws.send-response', { ['ws.response.id']: requestId });
-        return super.respond(requestId, result);
-    }
-    respondError(requestId, error, exception) {
-        this.addEvent('ws.send-error', { ['ws.response.id']: requestId });
-        if (this.lastActiveSpan) {
-            setHttpStatusFromError(this.lastActiveSpan, exception ?? new Error(error.message));
-            this.lastActiveSpan.setAttribute(OBS_SOCKET_STATUS_CODE, error.code);
-        }
-        return super.respondError(requestId, error, exception);
-    }
-    addEvent(eventName, attributes) {
-        // Since we do not have parent requestId in all the methods, we are assuming latest created span is the only active span
-        // This assumption can be broken if we start sending multiple request through the same connection.
-        if (this.lastActiveSpan) {
-            this.lastActiveSpan.addEvent(eventName, attributes, new Date());
-        }
-    }
-    close(reason) {
-        for (const span of this.activeSpanByRequestId.values()) {
-            span.end();
-        }
-        this.activeSpanByRequestId = new Map();
-        this.lastActiveSpan = undefined;
-        super.close(reason);
-    }
-}
-//# sourceMappingURL=tracedSocket.js.map

package/dist-esm/socket/tracedSocket.js.map

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

package/dist-esm/socket/types.d.ts

@@ -1,36 +0,0 @@
-export interface RequestContextBase {
-    peerAuthorization?: string;
-    method: string;
-    requestId: number;
-}
-export type MethodHandler<Params, Result, PeerMethods, RequestContext> = (params: Params, ctx: RequestContext, peer: ISocketClient<PeerMethods>, next: () => Promise<Result>) => Promise<Result>;
-export type GenericMiddleware<PeerMethods, RequestContext> = MethodHandler<any, any, PeerMethods, RequestContext>;
-type NonEmptyArray<T> = [...T[], T];
-export type MethodHandlers<Methods, PeerMethods, RequestContext> = {
-    [Key in keyof Methods]: Methods[Key] extends (params: infer Params) => Promise<infer Result> ? NonEmptyArray<MethodHandler<Params, Result, PeerMethods, RequestContext>> : Methods[Key] extends Record<string, unknown> ? MethodHandlers<Methods[Key], PeerMethods, RequestContext> : never;
-};
-type ISocketClientMethodCall<Methods> = {
-    [Key in keyof Methods]: Methods[Key] extends (params: infer P) => Promise<infer R> ? (params: P) => Promise<R> : Methods[Key] extends Record<string, unknown> ? ISocketClientMethodCall<Methods[Key]> : never;
-};
-export type ISocketClient<Methods> = {
-    close: (reason?: string) => void;
-    closeAndRejectPendingRequests: (reason?: string) => void;
-    call: ISocketClientMethodCall<Methods>;
-    requestWithTracing: <Params, Result>(method: string, params: Params, tracingHeaders: {
-        traceparent?: string;
-        tracestate?: string;
-    }, authorization?: string) => Promise<Result>;
-};
-export type MethodSchema<Params, Response> = (params: Params) => Promise<Response>;
-/** The exception type can be thrown to cause the default error handler to write a raw error response to the socket */
-export declare class SocketErrorException extends Error {
-    readonly code: number;
-    readonly message: string;
-    constructor(code: number, message: string);
-}
-export type SocketTimeouts = {
-    noResponseTimeoutInSeconds?: number;
-    connectionTimeoutInSeconds?: number;
-};
-export {};
-//# sourceMappingURL=types.d.ts.map

package/dist-esm/socket/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/socket/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,IAAI,CACvE,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,EAChC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,KACxB,OAAO,CAAC,MAAM,CAAC,CAAC;AAIrB,MAAM,MAAM,iBAAiB,CAAC,WAAW,EAAE,cAAc,IAAI,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAElH,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEpC,MAAM,MAAM,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,IAAI;KAChE,GAAG,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,MAAM,KAAK,OAAO,CAAC,MAAM,MAAM,CAAC,GACxF,aAAa,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,GACzE,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,GACzD,KAAK;CACZ,CAAC;AAEF,KAAK,uBAAuB,CAAC,OAAO,IAAI;KACrC,GAAG,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAC9E,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,uBAAuB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GACrC,KAAK;CACZ,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,OAAO,IAAI;IACnC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,6BAA6B,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,IAAI,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7D,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnF,sHAAsH;AACtH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC"}

package/dist-esm/socket/types.js

@@ -1,11 +0,0 @@
-/** The exception type can be thrown to cause the default error handler to write a raw error response to the socket */
-export class SocketErrorException extends Error {
-    code;
-    message;
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-        this.message = message;
-    }
-}
-//# sourceMappingURL=types.js.map

package/dist-esm/socket/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/socket/types.ts"],"names":[],"mappings":"AAiDA,sHAAsH;AACtH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAAS;IACb,OAAO,CAAS;IAEzB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist-esm/socket/util.d.ts

@@ -1,39 +0,0 @@
-import WebSocket from 'isomorphic-ws';
-/**
- * Maximum websocket frame size, in bytes, for sockets on both ends of the
- * editor <-> dev server connection. 100 MiB matches the `ws` library default;
- * it is set explicitly so the limit is a deliberate choice rather than an
- * inherited default. Inbound frames over the limit make `ws` close that
- * single socket with 1009 (Message Too Big).
- *
- * Only applies where `ws` is the implementation (Node). Browsers ignore the
- * option and don't enforce a receive limit.
- */
-export declare const MAX_SOCKET_PAYLOAD_BYTES: number;
-/**
- * Default User-Agent for Node-originated WebSocket handshakes. The `ws` client
- * sends no User-Agent by default (unlike browsers, axios, or undici's fetch),
- * and AWS WAF's managed common rule set blocks UA-less requests
- * (`NoUserAgent_HEADER`) with a 403 at the ALB. A non-empty UA keeps the
- * handshake from being rejected; callers may override with a more specific,
- * versioned identity. Ignored by browsers (native WebSocket sets its own UA).
- */
-export declare const DEFAULT_WEBSOCKET_USER_AGENT = "superblocks-client";
-/**
- * Build a client User-Agent of the form `component/version`, or bare `component`
- * when no version is supplied. Single source of truth for the identity strings
- * Node WebSocket clients (CLI, dev server, ...) send on the handshake.
- */
-export declare function buildClientUserAgent(component: string, version?: string): string;
-export interface ConnectWebSocketOptions {
-    protocol?: string | string[];
-    timeout?: number;
-    /** Extra handshake headers (Node only; ignored by browsers). Overrides the default User-Agent. */
-    headers?: Record<string, string>;
-}
-/**
- * If the connection is not established within the timeout, the promise will be rejected.
- * This can happen with bad network conditions, but is very rare.
- */
-export declare function connectWebSocket(wsUrl: string, options?: ConnectWebSocketOptions): Promise<WebSocket>;
-//# sourceMappingURL=util.d.ts.map

package/dist-esm/socket/util.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/socket/util.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,eAAe,CAAC;AAEtC;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,QAAoB,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,SAAS,CAAC,CAwCzG"}

package/dist-esm/socket/util.js

@@ -1,72 +0,0 @@
-import WebSocket from 'isomorphic-ws';
-/**
- * Maximum websocket frame size, in bytes, for sockets on both ends of the
- * editor <-> dev server connection. 100 MiB matches the `ws` library default;
- * it is set explicitly so the limit is a deliberate choice rather than an
- * inherited default. Inbound frames over the limit make `ws` close that
- * single socket with 1009 (Message Too Big).
- *
- * Only applies where `ws` is the implementation (Node). Browsers ignore the
- * option and don't enforce a receive limit.
- */
-export const MAX_SOCKET_PAYLOAD_BYTES = 100 * 1024 * 1024;
-/**
- * Default User-Agent for Node-originated WebSocket handshakes. The `ws` client
- * sends no User-Agent by default (unlike browsers, axios, or undici's fetch),
- * and AWS WAF's managed common rule set blocks UA-less requests
- * (`NoUserAgent_HEADER`) with a 403 at the ALB. A non-empty UA keeps the
- * handshake from being rejected; callers may override with a more specific,
- * versioned identity. Ignored by browsers (native WebSocket sets its own UA).
- */
-export const DEFAULT_WEBSOCKET_USER_AGENT = 'superblocks-client';
-/**
- * Build a client User-Agent of the form `component/version`, or bare `component`
- * when no version is supplied. Single source of truth for the identity strings
- * Node WebSocket clients (CLI, dev server, ...) send on the handshake.
- */
-export function buildClientUserAgent(component, version) {
-    return version ? `${component}/${version}` : component;
-}
-/**
- * If the connection is not established within the timeout, the promise will be rejected.
- * This can happen with bad network conditions, but is very rare.
- */
-export function connectWebSocket(wsUrl, options = {}) {
-    const { protocol, timeout = 30_000, headers } = options;
-    return new Promise((resolve, reject) => {
-        // `protocol ?? []` normalizes "no role asked for" to the empty list. It is
-        // defensive only: both runtimes this reaches already collapse an explicit
-        // `undefined` to the same thing, so neither offers a subprotocol that was
-        // never requested. A browser applies the WebIDL default (`protocols` is
-        // optional with default `[]`, and an explicit `undefined` selects it), and
-        // isomorphic-ws hands browsers the native WebSocket. Node takes `ws`, which
-        // maps `undefined` to `[]` before building the header (websocket.js: `if
-        // (protocols === undefined) protocols = []`).
-        //
-        // What does break a handshake is a *string* naming a role the server does
-        // not implement: it answers without echoing a subprotocol, the client fails
-        // the handshake, and it reads as a dead dev server rather than a bad offer.
-        // `??` cannot catch that - a string is not nullish - so a caller that
-        // stringifies its own value still offers the bogus role.
-        const ws = new WebSocket(wsUrl, protocol ?? [], {
-            maxPayload: MAX_SOCKET_PAYLOAD_BYTES,
-            headers: { 'User-Agent': DEFAULT_WEBSOCKET_USER_AGENT, ...headers }
-        });
-        const timeoutId = setTimeout(() => {
-            reject(new Error('[internal] WebSocket connection timeout'));
-        }, timeout);
-        ws.addEventListener('open', () => {
-            clearTimeout(timeoutId);
-            // Resolve the promise with the WebSocket instance when the connection is open
-            resolve(ws);
-        });
-        ws.addEventListener('error', (event) => {
-            clearTimeout(timeoutId);
-            // Wrap browser WebSocket errors with [internal] tag so they can be filtered
-            // from Clark's context (raw browser errors don't have useful stack traces)
-            const message = 'message' in event && typeof event.message === 'string' ? event.message : 'WebSocket connection failed';
-            reject(new Error(`[internal] ${message}`));
-        });
-    });
-}
-//# sourceMappingURL=util.js.map