@trigger.dev/core 0.0.0-buffer-fix-20231206151546 → 0.0.0-bun-prerelease-20260909132648

package/dist/commonjs/v3/zodIpc.js.map

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

package/dist/commonjs/v3/zodMessageHandler.d.ts

@@ -0,0 +1,78 @@
+import { z } from "zod/v4";
+import type { AnyZodSchema, ZodErrorLike, inferZodSchemaInput, inferZodSchemaOutput } from "./types/schemas.js";
+import type { StructuredLogger } from "./utils/structuredLogger.js";
+export declare class ZodSchemaParsedError extends Error {
+    error: ZodErrorLike;
+    payload: unknown;
+    constructor(error: ZodErrorLike, payload: unknown);
+}
+export type ZodMessageValueSchema<TSchema extends AnyZodSchema = AnyZodSchema> = TSchema;
+export interface ZodMessageCatalogSchema {
+    [key: string]: AnyZodSchema;
+}
+export type ZodMessageHandlers<TCatalogSchema extends ZodMessageCatalogSchema> = Partial<{
+    [K in keyof TCatalogSchema]: (payload: inferZodSchemaOutput<TCatalogSchema[K]>) => Promise<any>;
+}>;
+export type ZodMessageHandlerOptions<TMessageCatalog extends ZodMessageCatalogSchema> = {
+    schema: TMessageCatalog;
+    messages?: ZodMessageHandlers<TMessageCatalog>;
+    logger?: StructuredLogger;
+};
+export type MessageFromSchema<K extends keyof TMessageCatalog, TMessageCatalog extends ZodMessageCatalogSchema> = {
+    type: K;
+    payload: inferZodSchemaInput<TMessageCatalog[K]>;
+};
+export type MessagePayloadFromSchema<K extends keyof TMessageCatalog, TMessageCatalog extends ZodMessageCatalogSchema> = inferZodSchemaOutput<TMessageCatalog[K]>;
+export type MessageFromCatalog<TMessageCatalog extends ZodMessageCatalogSchema> = {
+    [K in keyof TMessageCatalog]: MessageFromSchema<K, TMessageCatalog>;
+}[keyof TMessageCatalog];
+export declare const ZodMessageSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<"v1">>;
+    type: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strip>;
+export interface EventEmitterLike {
+    on(eventName: string | symbol, listener: (...args: any[]) => void): this;
+}
+export declare class ZodMessageHandler<TMessageCatalog extends ZodMessageCatalogSchema> {
+    #private;
+    constructor(options: ZodMessageHandlerOptions<TMessageCatalog>);
+    handleMessage(message: unknown): Promise<{
+        success: true;
+        data: unknown;
+    } | {
+        success: false;
+        error: string;
+    }>;
+    parseMessage(message: unknown): {
+        success: true;
+        data: MessageFromCatalog<TMessageCatalog>;
+    } | {
+        success: false;
+        error: string;
+    };
+    registerHandlers(emitter: EventEmitterLike, logger?: StructuredLogger): void;
+}
+export declare function parseMessageFromCatalog<TMessageCatalog extends ZodMessageCatalogSchema>(message: unknown, schema: TMessageCatalog): MessageFromCatalog<TMessageCatalog>;
+type ZodMessageSenderCallback<TMessageCatalog extends ZodMessageCatalogSchema> = (message: {
+    type: keyof TMessageCatalog;
+    payload: inferZodSchemaOutput<TMessageCatalog[keyof TMessageCatalog]>;
+    version: "v1";
+}) => Promise<void>;
+export type ZodMessageSenderOptions<TMessageCatalog extends ZodMessageCatalogSchema> = {
+    schema: TMessageCatalog;
+    sender: ZodMessageSenderCallback<TMessageCatalog>;
+    canSendMessage?: () => Promise<boolean> | boolean;
+};
+export declare class ZodMessageSender<TMessageCatalog extends ZodMessageCatalogSchema> {
+    #private;
+    constructor(options: ZodMessageSenderOptions<TMessageCatalog>);
+    validateCanSendMessage(): Promise<boolean>;
+    send<K extends keyof TMessageCatalog>(type: K, payload: inferZodSchemaInput<TMessageCatalog[K]>): Promise<void>;
+    forwardMessage(message: unknown): Promise<void>;
+}
+export declare function sendMessageInCatalog<TMessageCatalog extends ZodMessageCatalogSchema>(catalog: TMessageCatalog, type: keyof TMessageCatalog, payload: inferZodSchemaInput<TMessageCatalog[keyof TMessageCatalog]>, sender: ZodMessageSenderCallback<TMessageCatalog>): Promise<void>;
+export type MessageCatalogToSocketIoEvents<TCatalog extends ZodMessageCatalogSchema> = {
+    [K in keyof TCatalog]: (message: inferZodSchemaOutput<TCatalog[K]>) => void;
+};
+export {};

package/dist/commonjs/v3/zodMessageHandler.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZodMessageSender = exports.ZodMessageHandler = exports.ZodMessageSchema = exports.ZodSchemaParsedError = void 0;
+exports.parseMessageFromCatalog = parseMessageFromCatalog;
+exports.sendMessageInCatalog = sendMessageInCatalog;
+const v4_1 = require("zod/v4");
+class ZodSchemaParsedError extends Error {
+    error;
+    payload;
+    constructor(error, payload) {
+        super(error.message);
+        this.error = error;
+        this.payload = payload;
+    }
+}
+exports.ZodSchemaParsedError = ZodSchemaParsedError;
+exports.ZodMessageSchema = v4_1.z.object({
+    version: v4_1.z.literal("v1").default("v1"),
+    type: v4_1.z.string(),
+    payload: v4_1.z.unknown(),
+});
+class ZodMessageHandler {
+    #schema;
+    #handlers;
+    #logger;
+    constructor(options) {
+        this.#schema = options.schema;
+        this.#handlers = options.messages;
+        this.#logger = options.logger ?? console;
+    }
+    async handleMessage(message) {
+        const parsedMessage = this.parseMessage(message);
+        if (!parsedMessage.success) {
+            this.#logger.error(parsedMessage.error, { message });
+            return {
+                success: false,
+                error: parsedMessage.error,
+            };
+        }
+        if (!this.#handlers) {
+            this.#logger.error("No handlers provided", { message });
+            return {
+                success: false,
+                error: "No handlers provided",
+            };
+        }
+        const handler = this.#handlers[parsedMessage.data.type];
+        if (!handler) {
+            const error = `No handler for message type: ${String(parsedMessage.data.type)}`;
+            this.#logger.error(error, { message });
+            return {
+                success: false,
+                error,
+            };
+        }
+        // parsedMessage.data.payload is parsed output at runtime; zod v4 distinguishes input/output
+        const ack = await handler(parsedMessage.data.payload);
+        return {
+            success: true,
+            data: ack,
+        };
+    }
+    parseMessage(message) {
+        const parsedMessage = exports.ZodMessageSchema.safeParse(message);
+        if (!parsedMessage.success) {
+            return {
+                success: false,
+                error: `Failed to parse message: ${JSON.stringify(parsedMessage.error)}`,
+            };
+        }
+        const schema = this.#schema[parsedMessage.data.type];
+        if (!schema) {
+            return {
+                success: false,
+                error: `Unknown message type: ${parsedMessage.data.type}`,
+            };
+        }
+        const parsedPayload = schema.safeParse(parsedMessage.data.payload);
+        if (!parsedPayload.success) {
+            return {
+                success: false,
+                error: `Failed to parse message payload: ${JSON.stringify(parsedPayload.error)}`,
+            };
+        }
+        return {
+            success: true,
+            data: {
+                type: parsedMessage.data.type,
+                payload: parsedPayload.data,
+            },
+        };
+    }
+    registerHandlers(emitter, logger) {
+        const log = logger ?? console;
+        if (!this.#handlers) {
+            log.info("No handlers provided");
+            return;
+        }
+        for (const eventName of Object.keys(this.#schema)) {
+            emitter.on(eventName, async (message, callback) => {
+                log.info(`handling ${eventName}`, {
+                    payload: message,
+                    hasCallback: !!callback,
+                });
+                let ack;
+                // FIXME: this only works if the message doesn't have genuine payload prop
+                if ("payload" in message) {
+                    ack = await this.handleMessage({ type: eventName, ...message });
+                }
+                else {
+                    // Handle messages not sent by ZodMessageSender
+                    const { version, ...payload } = message;
+                    ack = await this.handleMessage({ type: eventName, version, payload });
+                }
+                if (callback && typeof callback === "function") {
+                    if (!ack.success) {
+                        // We don't know the callback type, so we can't do anything else - not all callbacks may accept a success prop
+                        log.error("Failed to handle message, skipping callback", { message, error: ack.error });
+                        return;
+                    }
+                    callback(ack.data);
+                }
+            });
+        }
+    }
+}
+exports.ZodMessageHandler = ZodMessageHandler;
+function parseMessageFromCatalog(message, schema) {
+    const parsedMessage = exports.ZodMessageSchema.safeParse(message);
+    if (!parsedMessage.success) {
+        throw new Error(`Failed to parse message: ${JSON.stringify(parsedMessage.error)}`);
+    }
+    const messageSchema = schema[parsedMessage.data.type];
+    if (!messageSchema) {
+        throw new Error(`Unknown message type: ${parsedMessage.data.type}`);
+    }
+    const parsedPayload = messageSchema.safeParse(parsedMessage.data.payload);
+    if (!parsedPayload.success) {
+        throw new Error(`Failed to parse message payload: ${JSON.stringify(parsedPayload.error)}`);
+    }
+    return {
+        type: parsedMessage.data.type,
+        payload: parsedPayload.data,
+    };
+}
+class ZodMessageSender {
+    #schema;
+    #sender;
+    #canSendMessage;
+    constructor(options) {
+        this.#schema = options.schema;
+        this.#sender = options.sender;
+        this.#canSendMessage = options.canSendMessage;
+    }
+    async validateCanSendMessage() {
+        if (!this.#canSendMessage) {
+            return true;
+        }
+        return await this.#canSendMessage();
+    }
+    async send(type, payload) {
+        const schema = this.#schema[type];
+        if (!schema) {
+            throw new Error(`Unknown message type: ${type}`);
+        }
+        const parsedPayload = schema.safeParse(payload);
+        if (!parsedPayload.success) {
+            throw new ZodSchemaParsedError(parsedPayload.error, payload);
+        }
+        try {
+            // Preserve the original payload on the wire for backwards compatibility. Validation is
+            // intentionally side-effect-free here; receivers parse the payload into the schema output.
+            await this.#sender({
+                type,
+                payload: payload,
+                version: "v1",
+            });
+        }
+        catch (error) {
+            console.error("[ZodMessageSender] Failed to send message", error);
+        }
+    }
+    async forwardMessage(message) {
+        const parsedMessage = exports.ZodMessageSchema.safeParse(message);
+        if (!parsedMessage.success) {
+            throw new Error(`Failed to parse message: ${JSON.stringify(parsedMessage.error)}`);
+        }
+        const schema = this.#schema[parsedMessage.data.type];
+        if (!schema) {
+            throw new Error(`Unknown message type: ${parsedMessage.data.type}`);
+        }
+        const parsedPayload = schema.safeParse(parsedMessage.data.payload);
+        if (!parsedPayload.success) {
+            throw new Error(`Failed to parse message payload: ${JSON.stringify(parsedPayload.error)}`);
+        }
+        try {
+            await this.#sender({
+                type: parsedMessage.data.type,
+                payload: parsedPayload.data,
+                version: "v1",
+            });
+        }
+        catch (error) {
+            console.error("[ZodMessageSender] Failed to forward message", error);
+        }
+    }
+}
+exports.ZodMessageSender = ZodMessageSender;
+async function sendMessageInCatalog(catalog, type, payload, sender) {
+    const schema = catalog[type];
+    if (!schema) {
+        throw new Error(`Unknown message type: ${type}`);
+    }
+    const parsedPayload = schema.safeParse(payload);
+    if (!parsedPayload.success) {
+        throw new ZodSchemaParsedError(parsedPayload.error, payload);
+    }
+    // Preserve the original payload on the wire for backwards compatibility. Validation is
+    // intentionally side-effect-free here; receivers parse the payload into the schema output.
+    await sender({
+        type,
+        payload: payload,
+        version: "v1",
+    });
+}
+//# sourceMappingURL=zodMessageHandler.js.map

package/dist/commonjs/v3/zodMessageHandler.js.map

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

package/dist/commonjs/v3/zodSocket.d.ts

@@ -0,0 +1,93 @@
+import type { ManagerOptions, Socket, SocketOptions } from "socket.io-client";
+import type { inferZodSchemaInput, inferZodSchemaOutput } from "./types/schemas.js";
+import type { StructuredLogger } from "./utils/structuredLogger.js";
+import type { EventEmitterLike, ZodMessageValueSchema } from "./zodMessageHandler.js";
+export interface ZodSocketMessageCatalogSchema {
+    [key: string]: {
+        message: ZodMessageValueSchema<any>;
+    } | {
+        message: ZodMessageValueSchema<any>;
+        callback?: ZodMessageValueSchema<any>;
+    };
+}
+export type ZodMessageCatalogToSocketIoEvents<TCatalog extends ZodSocketMessageCatalogSchema> = {
+    [K in keyof TCatalog]: SocketMessageHasCallback<TCatalog, K> extends true ? (message: inferZodSchemaOutput<GetSocketMessageSchema<TCatalog, K>>, callback: (ack: inferZodSchemaOutput<GetSocketCallbackSchema<TCatalog, K>>) => void) => void : (message: inferZodSchemaOutput<GetSocketMessageSchema<TCatalog, K>>) => void;
+};
+export type GetSocketMessageSchema<TRPCCatalog extends ZodSocketMessageCatalogSchema, TMessageType extends keyof TRPCCatalog> = TRPCCatalog[TMessageType]["message"];
+export type InferSocketMessageSchema<TRPCCatalog extends ZodSocketMessageCatalogSchema, TMessageType extends keyof TRPCCatalog> = inferZodSchemaOutput<GetSocketMessageSchema<TRPCCatalog, TMessageType>>;
+export type GetSocketCallbackSchema<TRPCCatalog extends ZodSocketMessageCatalogSchema, TMessageType extends keyof TRPCCatalog> = TRPCCatalog[TMessageType] extends {
+    callback: any;
+} ? TRPCCatalog[TMessageType]["callback"] : never;
+export type InferSocketCallbackSchema<TRPCCatalog extends ZodSocketMessageCatalogSchema, TMessageType extends keyof TRPCCatalog> = inferZodSchemaOutput<GetSocketCallbackSchema<TRPCCatalog, TMessageType>>;
+export type SocketMessageHasCallback<TRPCCatalog extends ZodSocketMessageCatalogSchema, TMessageType extends keyof TRPCCatalog> = GetSocketCallbackSchema<TRPCCatalog, TMessageType> extends never ? false : true;
+export type ZodSocketMessageHandlers<TCatalogSchema extends ZodSocketMessageCatalogSchema> = Partial<{
+    [K in keyof TCatalogSchema]: (payload: inferZodSchemaOutput<GetSocketMessageSchema<TCatalogSchema, K>>) => Promise<SocketMessageHasCallback<TCatalogSchema, K> extends true ? inferZodSchemaInput<GetSocketCallbackSchema<TCatalogSchema, K>> : void>;
+}>;
+export type ZodSocketMessageHandlerOptions<TMessageCatalog extends ZodSocketMessageCatalogSchema> = {
+    schema: TMessageCatalog;
+    handlers?: ZodSocketMessageHandlers<TMessageCatalog>;
+    logger?: StructuredLogger;
+    logPayloads?: boolean;
+};
+type MessageFromSocketSchema<K extends keyof TMessageCatalog, TMessageCatalog extends ZodSocketMessageCatalogSchema> = {
+    type: K;
+    payload: inferZodSchemaInput<GetSocketMessageSchema<TMessageCatalog, K>>;
+};
+export type MessagesFromSocketCatalog<TMessageCatalog extends ZodSocketMessageCatalogSchema> = {
+    [K in keyof TMessageCatalog]: MessageFromSocketSchema<K, TMessageCatalog>;
+}[keyof TMessageCatalog];
+export declare class ZodSocketMessageHandler<TRPCCatalog extends ZodSocketMessageCatalogSchema> {
+    #private;
+    constructor(options: ZodSocketMessageHandlerOptions<TRPCCatalog>);
+    handleMessage(message: unknown): Promise<(SocketMessageHasCallback<TRPCCatalog, keyof TRPCCatalog> extends true ? inferZodSchemaInput<GetSocketCallbackSchema<TRPCCatalog, keyof TRPCCatalog>> : void) | undefined>;
+    private parseMessage;
+    registerHandlers(emitter: EventEmitterLike, logger?: StructuredLogger): void;
+}
+export type ZodSocketMessageSenderOptions<TMessageCatalog extends ZodSocketMessageCatalogSchema> = {
+    schema: TMessageCatalog;
+    socket: ZodSocket<any, TMessageCatalog>;
+    logger?: StructuredLogger;
+};
+export type GetSocketMessagesWithCallback<TMessageCatalog extends ZodSocketMessageCatalogSchema> = {
+    [K in keyof TMessageCatalog]: SocketMessageHasCallback<TMessageCatalog, K> extends true ? K : never;
+}[keyof TMessageCatalog];
+export type GetSocketMessagesWithoutCallback<TMessageCatalog extends ZodSocketMessageCatalogSchema> = {
+    [K in keyof TMessageCatalog]: SocketMessageHasCallback<TMessageCatalog, K> extends true ? never : K;
+}[keyof TMessageCatalog];
+export declare class ZodSocketMessageSender<TMessageCatalog extends ZodSocketMessageCatalogSchema> {
+    #private;
+    constructor(options: ZodSocketMessageSenderOptions<TMessageCatalog>);
+    send<K extends GetSocketMessagesWithoutCallback<TMessageCatalog>>(type: K, payload: inferZodSchemaInput<GetSocketMessageSchema<TMessageCatalog, K>>): void;
+    sendWithAck<K extends GetSocketMessagesWithCallback<TMessageCatalog>>(type: K, payload: inferZodSchemaInput<GetSocketMessageSchema<TMessageCatalog, K>>, timeout?: number): Promise<inferZodSchemaOutput<GetSocketCallbackSchema<TMessageCatalog, K>>>;
+}
+export type ZodSocket<TListenEvents extends ZodSocketMessageCatalogSchema, TEmitEvents extends ZodSocketMessageCatalogSchema> = Omit<Socket<ZodMessageCatalogToSocketIoEvents<TListenEvents>, ZodMessageCatalogToSocketIoEvents<TEmitEvents>>, "timeout"> & {
+    timeout: (timeout: number) => Socket<ZodMessageCatalogToSocketIoEvents<TListenEvents>, ZodMessageCatalogToSocketIoEvents<TEmitEvents>>;
+};
+interface ZodSocketConnectionOptions<TClientMessages extends ZodSocketMessageCatalogSchema, TServerMessages extends ZodSocketMessageCatalogSchema> {
+    host: string;
+    port?: number;
+    secure?: boolean;
+    namespace: string;
+    clientMessages: TClientMessages;
+    serverMessages: TServerMessages;
+    extraHeaders?: {
+        [header: string]: string;
+    };
+    handlers?: ZodSocketMessageHandlers<TServerMessages>;
+    authToken?: string;
+    ioOptions?: Partial<ManagerOptions & SocketOptions>;
+    logHandlerPayloads?: boolean;
+    onConnection?: (socket: ZodSocket<TServerMessages, TClientMessages>, handler: ZodSocketMessageHandler<TServerMessages>, sender: ZodSocketMessageSender<TClientMessages>, logger: StructuredLogger) => Promise<void>;
+    onDisconnect?: (socket: ZodSocket<TServerMessages, TClientMessages>, reason: Socket.DisconnectReason, description: any, logger: StructuredLogger) => Promise<void>;
+    onError?: (socket: ZodSocket<TServerMessages, TClientMessages>, err: Error, logger: StructuredLogger) => Promise<void>;
+}
+export declare class ZodSocketConnection<TClientMessages extends ZodSocketMessageCatalogSchema, TServerMessages extends ZodSocketMessageCatalogSchema> {
+    #private;
+    socket: ZodSocket<TServerMessages, TClientMessages>;
+    constructor(opts: ZodSocketConnectionOptions<TClientMessages, TServerMessages>);
+    close(): void;
+    connect(): void;
+    get send(): <K extends GetSocketMessagesWithoutCallback<TClientMessages>>(type: K, payload: inferZodSchemaInput<GetSocketMessageSchema<TClientMessages, K>>) => void;
+    get sendWithAck(): <K extends GetSocketMessagesWithCallback<TClientMessages>>(type: K, payload: inferZodSchemaInput<GetSocketMessageSchema<TClientMessages, K>>, timeout?: number) => Promise<inferZodSchemaOutput<GetSocketCallbackSchema<TClientMessages, K>>>;
+}
+export {};

package/dist/commonjs/v3/zodSocket.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZodSocketConnection = exports.ZodSocketMessageSender = exports.ZodSocketMessageHandler = void 0;
+const socket_io_client_1 = require("socket.io-client");
+const v4_1 = require("zod/v4");
+const v4_2 = require("zod-validation-error/v4");
+const structuredLogger_js_1 = require("./utils/structuredLogger.js");
+const messageSchema = v4_1.z.object({
+    version: v4_1.z.string(),
+    type: v4_1.z.string(),
+    payload: v4_1.z.unknown(),
+});
+class ZodSocketMessageHandler {
+    #schema;
+    #handlers;
+    #logger;
+    #logPayloads;
+    constructor(options) {
+        this.#schema = options.schema;
+        this.#handlers = options.handlers;
+        this.#logger =
+            options.logger ?? new structuredLogger_js_1.SimpleStructuredLogger("socket-message-handler", structuredLogger_js_1.LogLevel.info);
+        this.#logPayloads = options.logPayloads ?? !!process.env.LOG_SOCKET_HANDLER_PAYLOADS;
+    }
+    async handleMessage(message) {
+        const parseResult = this.parseMessage(message);
+        if (!parseResult.success) {
+            this.#logger.error("Failed to parse message, skipping handler", {
+                rawMessage: message,
+                error: parseResult.reason,
+            });
+            return;
+        }
+        if (!this.#handlers) {
+            throw new Error("No handlers provided");
+        }
+        const { type, payload } = parseResult.data;
+        const handler = this.#handlers[type];
+        if (!handler) {
+            this.#logger.error("No handler for message type", { type, payload });
+            return;
+        }
+        // payload is the parsed output at runtime; zod v4 distinguishes input/output so cast to the handler's expected arg
+        const ack = await handler(payload);
+        return ack;
+    }
+    parseMessage(message) {
+        const parsedMessage = messageSchema.safeParse(message);
+        if (!parsedMessage.success) {
+            return {
+                success: false,
+                reason: `Failed to parse message: ${(0, v4_2.fromZodError)(parsedMessage.error).toString()}`,
+            };
+        }
+        const schema = this.#schema[parsedMessage.data.type]?.["message"];
+        if (!schema) {
+            return {
+                success: false,
+                reason: `Unknown message type: ${parsedMessage.data.type}`,
+            };
+        }
+        const messageWithVersion = {
+            version: parsedMessage.data.version,
+            ...(typeof parsedMessage.data.payload === "object" ? parsedMessage.data.payload : {}),
+        };
+        const parsedPayload = schema.safeParse(messageWithVersion);
+        if (!parsedPayload.success) {
+            this.#logger.error("Failed to parse message payload", {
+                message,
+                payload: messageWithVersion,
+            });
+            return {
+                success: false,
+                reason: (0, v4_2.fromZodError)(parsedPayload.error).toString(),
+            };
+        }
+        return {
+            success: true,
+            data: {
+                type: parsedMessage.data.type,
+                payload: parsedPayload.data,
+            },
+        };
+    }
+    registerHandlers(emitter, logger) {
+        const log = logger ?? console;
+        if (!this.#handlers) {
+            log.info("No handlers provided");
+            return;
+        }
+        for (const eventName of Object.keys(this.#handlers)) {
+            emitter.on(eventName, async (message, callback) => {
+                log.info(`Incoming event ${eventName}`, {
+                    eventName,
+                    ...(this.#logPayloads ? { eventMessage: message } : {}),
+                    hasCallback: !!callback,
+                });
+                let ack;
+                try {
+                    // FIXME: this only works if the message doesn't have genuine payload prop
+                    if ("payload" in message) {
+                        ack = await this.handleMessage({ type: eventName, ...message });
+                    }
+                    else {
+                        // Handle messages not sent by ZodMessageSender
+                        const { version, ...payload } = message;
+                        ack = await this.handleMessage({ type: eventName, version, payload });
+                    }
+                }
+                catch (error) {
+                    log.error("Error while handling message", {
+                        error: error instanceof Error
+                            ? {
+                                message: error.message,
+                                stack: error.stack,
+                            }
+                            : error,
+                    });
+                    return;
+                }
+                if (callback && typeof callback === "function") {
+                    callback(ack);
+                }
+            });
+        }
+    }
+}
+exports.ZodSocketMessageHandler = ZodSocketMessageHandler;
+class ZodSocketMessageSender {
+    #schema;
+    #socket;
+    #logger;
+    constructor(options) {
+        this.#schema = options.schema;
+        this.#socket = options.socket;
+        this.#logger = options.logger ?? new structuredLogger_js_1.SimpleStructuredLogger("zod-socket-sender", structuredLogger_js_1.LogLevel.info);
+    }
+    send(type, payload) {
+        const schema = this.#schema[type]?.["message"];
+        if (!schema) {
+            throw new Error(`Unknown message type: ${type}`);
+        }
+        const parsedPayload = schema.safeParse(payload);
+        if (!parsedPayload.success) {
+            this.#logger.error("Failed to parse message payload, will not send", {
+                error: parsedPayload.error,
+            });
+            return;
+        }
+        // @ts-expect-error
+        this.#socket.emit(type, { payload, version: "v1" });
+        return;
+    }
+    async sendWithAck(type, payload, timeout) {
+        const schema = this.#schema[type]?.["message"];
+        if (!schema) {
+            throw new Error(`Unknown message type: ${type}`);
+        }
+        const parsedPayload = schema.safeParse(payload);
+        if (!parsedPayload.success) {
+            throw new Error(`Failed to parse message payload: ${JSON.stringify(parsedPayload.error)}`);
+        }
+        const socket = timeout ? this.#socket.timeout(timeout) : this.#socket;
+        // @ts-expect-error
+        const callbackResult = await socket.emitWithAck(type, { payload, version: "v1" });
+        return callbackResult;
+    }
+}
+exports.ZodSocketMessageSender = ZodSocketMessageSender;
+class ZodSocketConnection {
+    #sender;
+    socket;
+    #handler;
+    #logger;
+    constructor(opts) {
+        const uri = `${opts.secure ? "wss" : "ws"}://${opts.host}:${opts.port ?? (opts.secure ? "443" : "80")}/${opts.namespace}`;
+        const logger = new structuredLogger_js_1.SimpleStructuredLogger(`socket-${opts.namespace}`, structuredLogger_js_1.LogLevel.info, {
+            namespace: opts.namespace,
+            host: opts.host,
+            port: opts.port,
+            secure: opts.secure,
+            extraHeaders: opts.extraHeaders,
+        });
+        logger.log("new zod socket", { uri });
+        this.socket = (0, socket_io_client_1.io)(uri, {
+            transports: ["websocket"],
+            auth: {
+                token: opts.authToken,
+            },
+            extraHeaders: opts.extraHeaders,
+            reconnectionDelay: 500,
+            reconnectionDelayMax: 1000,
+            ...opts.ioOptions,
+        });
+        this.#logger = logger.child({
+            socketId: this.socket.id,
+        });
+        this.#handler = new ZodSocketMessageHandler({
+            schema: opts.serverMessages,
+            handlers: opts.handlers,
+            logPayloads: opts.logHandlerPayloads,
+        });
+        this.#handler.registerHandlers(this.socket, this.#logger);
+        this.#sender = new ZodSocketMessageSender({
+            schema: opts.clientMessages,
+            socket: this.socket,
+            logger: this.#logger,
+        });
+        this.socket.on("connect_error", async (error) => {
+            this.#logger.error(`connect_error: ${error}`);
+            if (opts.onError) {
+                await opts.onError(this.socket, error, this.#logger);
+            }
+        });
+        this.socket.on("connect", async () => {
+            this.#logger.info("connect");
+            if (opts.onConnection) {
+                await opts.onConnection(this.socket, this.#handler, this.#sender, this.#logger);
+            }
+        });
+        this.socket.on("disconnect", async (reason, description) => {
+            this.#logger.info("disconnect", { reason, description });
+            if (opts.onDisconnect) {
+                await opts.onDisconnect(this.socket, reason, description, this.#logger);
+            }
+        });
+    }
+    close() {
+        this.socket.close();
+    }
+    connect() {
+        this.socket.connect();
+    }
+    get send() {
+        return this.#sender.send.bind(this.#sender);
+    }
+    get sendWithAck() {
+        return this.#sender.sendWithAck.bind(this.#sender);
+    }
+}
+exports.ZodSocketConnection = ZodSocketConnection;
+//# sourceMappingURL=zodSocket.js.map