@procwire/transport 1.0.0

package/dist/protocol/simple.js

@@ -0,0 +1,297 @@
+import { ProtocolError } from "../utils/errors.js";
+/**
+ * Minimal protocol implementation with no JSON-RPC overhead.
+ *
+ * Provides a lightweight request/response/notification protocol
+ * suitable for high-performance or custom IPC scenarios.
+ *
+ * Message format:
+ * - Request: `{ type: 'request', id, method, params? }`
+ * - Response: `{ type: 'response', id, result?, error? }`
+ * - Notification: `{ type: 'notification', method, params? }`
+ *
+ * @example
+ * ```ts
+ * const protocol = new SimpleProtocol();
+ * const req = protocol.createRequest('getUser', { id: 42 });
+ * const res = protocol.createResponse(req.id, { name: 'Alice' });
+ * ```
+ */
+export class SimpleProtocol {
+    name = "simple";
+    version = "1.0";
+    idCounter = 0;
+    /**
+     * Creates a simple protocol request message.
+     *
+     * @param method - Method name (must be non-empty string)
+     * @param params - Optional parameters
+     * @param id - Optional request ID (auto-generated if not provided)
+     * @returns Simple request object
+     * @throws {ProtocolError} if method is invalid
+     */
+    createRequest(method, params, id) {
+        if (typeof method !== "string" || method.length === 0) {
+            throw new ProtocolError("Method must be a non-empty string");
+        }
+        const requestId = id ?? this.generateId();
+        const request = {
+            type: "request",
+            id: requestId,
+            method,
+        };
+        if (params !== undefined) {
+            request.params = params;
+        }
+        return request;
+    }
+    /**
+     * Creates a simple protocol success response message.
+     *
+     * @param id - Request ID
+     * @param result - Response result
+     * @returns Simple response object
+     */
+    createResponse(id, result) {
+        return {
+            type: "response",
+            id,
+            result,
+        };
+    }
+    /**
+     * Creates a simple protocol error response message.
+     *
+     * @param id - Request ID
+     * @param error - Error details
+     * @returns Simple error response object
+     */
+    createErrorResponse(id, error) {
+        return {
+            type: "response",
+            id,
+            error,
+        };
+    }
+    /**
+     * Creates a simple protocol notification message.
+     *
+     * @param method - Method name (must be non-empty string)
+     * @param params - Optional parameters
+     * @returns Simple notification object
+     * @throws {ProtocolError} if method is invalid
+     */
+    createNotification(method, params) {
+        if (typeof method !== "string" || method.length === 0) {
+            throw new ProtocolError("Method must be a non-empty string");
+        }
+        const notification = {
+            type: "notification",
+            method,
+        };
+        if (params !== undefined) {
+            notification.params = params;
+        }
+        return notification;
+    }
+    /**
+     * Parses incoming data as simple protocol message.
+     * Does not throw - returns 'invalid' kind for malformed messages.
+     *
+     * @param data - Raw incoming data
+     * @returns ParsedMessage discriminated union
+     */
+    parseMessage(data) {
+        // Must be an object
+        if (!isObject(data)) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Message must be an object",
+                },
+                raw: data,
+            };
+        }
+        // Must have type field
+        if (!("type" in data) || typeof data.type !== "string") {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Message must have type field",
+                },
+                raw: data,
+            };
+        }
+        switch (data.type) {
+            case "request":
+                return this.parseRequest(data);
+            case "response":
+                return this.parseResponse(data);
+            case "notification":
+                return this.parseNotification(data);
+            default:
+                return {
+                    kind: "invalid",
+                    error: {
+                        code: -1,
+                        message: `Unknown message type: ${data.type}`,
+                    },
+                    raw: data,
+                };
+        }
+    }
+    /**
+     * Type guard for request messages.
+     */
+    isRequest(msg) {
+        return msg.kind === "request";
+    }
+    /**
+     * Type guard for response messages.
+     */
+    isResponse(msg) {
+        return msg.kind === "response";
+    }
+    /**
+     * Type guard for notification messages.
+     */
+    isNotification(msg) {
+        return msg.kind === "notification";
+    }
+    /**
+     * Parses a request message.
+     */
+    parseRequest(data) {
+        // Must have id
+        if (!("id" in data)) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Request must have id",
+                },
+                raw: data,
+            };
+        }
+        // Validate id type
+        if (!isValidId(data.id)) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Request id must be string or number",
+                },
+                raw: data,
+            };
+        }
+        // Must have method
+        if (!("method" in data) || typeof data.method !== "string" || data.method.length === 0) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Request must have non-empty method string",
+                },
+                raw: data,
+            };
+        }
+        return {
+            kind: "request",
+            message: data,
+        };
+    }
+    /**
+     * Parses a response message.
+     */
+    parseResponse(data) {
+        // Must have id
+        if (!("id" in data)) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Response must have id",
+                },
+                raw: data,
+            };
+        }
+        // Validate id type
+        if (!isValidId(data.id)) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Response id must be string or number",
+                },
+                raw: data,
+            };
+        }
+        // Must have either result or error (or both is acceptable in simple protocol)
+        if (!("result" in data) && !("error" in data)) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Response must have result or error",
+                },
+                raw: data,
+            };
+        }
+        return {
+            kind: "response",
+            message: data,
+        };
+    }
+    /**
+     * Parses a notification message.
+     */
+    parseNotification(data) {
+        // Must have method
+        if (!("method" in data) || typeof data.method !== "string" || data.method.length === 0) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Notification must have non-empty method string",
+                },
+                raw: data,
+            };
+        }
+        // Must NOT have id
+        if ("id" in data) {
+            return {
+                kind: "invalid",
+                error: {
+                    code: -1,
+                    message: "Notification must not have id",
+                },
+                raw: data,
+            };
+        }
+        return {
+            kind: "notification",
+            message: data,
+        };
+    }
+    /**
+     * Generates a unique request ID.
+     */
+    generateId() {
+        return ++this.idCounter;
+    }
+}
+/**
+ * Type guard to check if value is an object (non-null).
+ */
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard to validate request ID type.
+ */
+function isValidId(value) {
+    return typeof value === "string" || typeof value === "number";
+}
+//# sourceMappingURL=simple.js.map

package/dist/protocol/simple.js.map

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

package/dist/protocol/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Request identifier (string or number).
+ */
+export type RequestId = string | number;
+/**
+ * Protocol error data structure (not the runtime error class).
+ * Used in error responses at protocol level.
+ */
+export interface ProtocolDataError {
+    /**
+     * Error code (e.g., -32600 for JSON-RPC, or custom codes).
+     */
+    code: number;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional additional error data.
+     */
+    data?: unknown;
+}
+/**
+ * Parsed message discriminated union.
+ * Represents the result of parsing an incoming protocol message.
+ */
+export type ParsedMessage<TReq = unknown, TRes = unknown, TNotif = unknown> = {
+    kind: "request";
+    message: TReq;
+} | {
+    kind: "response";
+    message: TRes;
+} | {
+    kind: "notification";
+    message: TNotif;
+} | {
+    kind: "invalid";
+    error: ProtocolDataError;
+    raw: unknown;
+};
+/**
+ * Protocol layer interface for request/response messaging.
+ * Implementations: JSON-RPC 2.0, SimpleProtocol.
+ *
+ * Generic type parameters represent the wire format of messages,
+ * not application-level data types.
+ *
+ * @template TReq - Request message type (wire format)
+ * @template TRes - Response message type (wire format)
+ * @template TNotif - Notification message type (wire format)
+ */
+export interface Protocol<TReq = unknown, TRes = unknown, TNotif = unknown> {
+    /**
+     * Protocol name identifier.
+     */
+    readonly name: string;
+    /**
+     * Protocol version.
+     */
+    readonly version: string;
+    /**
+     * Creates a request message.
+     * @param method - Method name
+     * @param params - Optional parameters
+     * @param id - Optional request ID (auto-generated if not provided)
+     * @returns Wire format request message
+     */
+    createRequest(method: string, params?: unknown, id?: RequestId): TReq;
+    /**
+     * Creates a success response message.
+     * @param id - Request ID this response corresponds to
+     * @param result - Response result data
+     * @returns Wire format response message
+     */
+    createResponse(id: RequestId, result: unknown): TRes;
+    /**
+     * Creates an error response message.
+     * @param id - Request ID this error corresponds to
+     * @param error - Error details
+     * @returns Wire format error response message
+     */
+    createErrorResponse(id: RequestId, error: ProtocolDataError): TRes;
+    /**
+     * Creates a notification message (no response expected).
+     * @param method - Method name
+     * @param params - Optional parameters
+     * @returns Wire format notification message
+     */
+    createNotification(method: string, params?: unknown): TNotif;
+    /**
+     * Parses incoming message and determines its type.
+     * Does not throw - returns 'invalid' kind for malformed messages.
+     *
+     * @param data - Raw incoming data
+     * @returns ParsedMessage discriminated union
+     */
+    parseMessage(data: unknown): ParsedMessage<TReq, TRes, TNotif>;
+    /**
+     * Type guard for request messages.
+     */
+    isRequest(msg: ParsedMessage<TReq, TRes, TNotif>): msg is Extract<ParsedMessage<TReq, TRes, TNotif>, {
+        kind: "request";
+    }>;
+    /**
+     * Type guard for response messages.
+     */
+    isResponse(msg: ParsedMessage<TReq, TRes, TNotif>): msg is Extract<ParsedMessage<TReq, TRes, TNotif>, {
+        kind: "response";
+    }>;
+    /**
+     * Type guard for notification messages.
+     */
+    isNotification(msg: ParsedMessage<TReq, TRes, TNotif>): msg is Extract<ParsedMessage<TReq, TRes, TNotif>, {
+        kind: "notification";
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,IACtE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACxE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEtE;;;;;OAKG;IACH,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAErD;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEnE;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE7D;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAE/D;;OAEG;IACH,SAAS,CACP,GAAG,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GACrC,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAE1E;;OAEG;IACH,UAAU,CACR,GAAG,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GACrC,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAE3E;;OAEG;IACH,cAAc,CACZ,GAAG,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GACrC,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;CAChF"}

package/dist/protocol/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":""}

package/dist/serialization/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./json.js";
+export * from "./raw.js";
+export * from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialization/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/serialization/index.js

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./json.js";
+export * from "./raw.js";
+export * from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/serialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serialization/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/serialization/json.d.ts

@@ -0,0 +1,66 @@
+import type { SerializationCodec } from "./types.js";
+/**
+ * Options for JSON codec configuration.
+ */
+export interface JsonCodecOptions {
+    /**
+     * Function to transform values during serialization.
+     * Applied during JSON.stringify().
+     */
+    replacer?: (key: string, value: unknown) => unknown;
+    /**
+     * Function to transform values during deserialization.
+     * Applied during JSON.parse().
+     */
+    reviver?: (key: string, value: unknown) => unknown;
+    /**
+     * Indentation for formatted JSON output.
+     * Useful for debugging. Default: undefined (compact).
+     */
+    space?: number | string;
+}
+/**
+ * JSON serialization codec with zero dependencies.
+ *
+ * Converts objects to/from UTF-8 encoded JSON buffers.
+ * Supports custom replacer/reviver functions for advanced serialization logic.
+ *
+ * @example
+ * ```ts
+ * const codec = new JsonCodec();
+ * const buffer = codec.serialize({ foo: 'bar' });
+ * const obj = codec.deserialize(buffer);
+ * ```
+ *
+ * @example With custom replacer
+ * ```ts
+ * const codec = new JsonCodec({
+ *   replacer: (key, value) => key === 'password' ? undefined : value
+ * });
+ * ```
+ */
+export declare class JsonCodec<T = unknown> implements SerializationCodec<T> {
+    readonly name = "json";
+    readonly contentType = "application/json";
+    private readonly replacer;
+    private readonly reviver;
+    private readonly space;
+    constructor(options?: JsonCodecOptions);
+    /**
+     * Serializes a value to a UTF-8 encoded JSON buffer.
+     *
+     * @param value - Value to serialize
+     * @returns Buffer containing UTF-8 encoded JSON
+     * @throws {SerializationError} if JSON.stringify fails
+     */
+    serialize(value: T): Buffer;
+    /**
+     * Deserializes a UTF-8 encoded JSON buffer to a value.
+     *
+     * @param buffer - Buffer containing UTF-8 encoded JSON
+     * @returns Deserialized value
+     * @throws {SerializationError} if JSON.parse fails
+     */
+    deserialize(buffer: Buffer): T;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/serialization/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/serialization/json.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEpD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAEnD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAClE,SAAgB,IAAI,UAAU;IAC9B,SAAgB,WAAW,sBAAsB;IAEjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;gBAExC,OAAO,GAAE,gBAAqB;IAM1C;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM;IAY3B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC;CAW/B"}

package/dist/serialization/json.js

@@ -0,0 +1,66 @@
+import { SerializationError } from "../utils/errors.js";
+/**
+ * JSON serialization codec with zero dependencies.
+ *
+ * Converts objects to/from UTF-8 encoded JSON buffers.
+ * Supports custom replacer/reviver functions for advanced serialization logic.
+ *
+ * @example
+ * ```ts
+ * const codec = new JsonCodec();
+ * const buffer = codec.serialize({ foo: 'bar' });
+ * const obj = codec.deserialize(buffer);
+ * ```
+ *
+ * @example With custom replacer
+ * ```ts
+ * const codec = new JsonCodec({
+ *   replacer: (key, value) => key === 'password' ? undefined : value
+ * });
+ * ```
+ */
+export class JsonCodec {
+    name = "json";
+    contentType = "application/json";
+    replacer;
+    reviver;
+    space;
+    constructor(options = {}) {
+        this.replacer = options.replacer;
+        this.reviver = options.reviver;
+        this.space = options.space;
+    }
+    /**
+     * Serializes a value to a UTF-8 encoded JSON buffer.
+     *
+     * @param value - Value to serialize
+     * @returns Buffer containing UTF-8 encoded JSON
+     * @throws {SerializationError} if JSON.stringify fails
+     */
+    serialize(value) {
+        try {
+            const json = JSON.stringify(value, this.replacer, this.space);
+            return Buffer.from(json, "utf8");
+        }
+        catch (error) {
+            throw new SerializationError(`Failed to serialize value to JSON: ${error instanceof Error ? error.message : String(error)}`, error);
+        }
+    }
+    /**
+     * Deserializes a UTF-8 encoded JSON buffer to a value.
+     *
+     * @param buffer - Buffer containing UTF-8 encoded JSON
+     * @returns Deserialized value
+     * @throws {SerializationError} if JSON.parse fails
+     */
+    deserialize(buffer) {
+        try {
+            const json = buffer.toString("utf8");
+            return JSON.parse(json, this.reviver);
+        }
+        catch (error) {
+            throw new SerializationError(`Failed to deserialize JSON: ${error instanceof Error ? error.message : String(error)}`, error);
+        }
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/serialization/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/serialization/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AA0BxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IACJ,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,kBAAkB,CAAC;IAEhC,QAAQ,CAAyD;IACjE,OAAO,CAAyD;IAChE,KAAK,CAA8B;IAEpD,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,KAAQ;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,QAAoD,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1G,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,MAAc;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAmD,CAAM,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACvF,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/serialization/raw.d.ts

@@ -0,0 +1,38 @@
+import type { SerializationCodec } from "./types.js";
+/**
+ * Raw binary passthrough codec (zero-copy).
+ *
+ * Performs no serialization - simply passes Buffer instances through unchanged.
+ * Useful for binary protocols or when pre-serialized data is available.
+ *
+ * **Important**: This codec does not copy buffers. Mutations to the returned
+ * buffer will affect the original data. If you need isolation, copy the buffer
+ * yourself using `Buffer.from(buffer)`.
+ *
+ * @example
+ * ```ts
+ * const codec = new RawCodec();
+ * const buffer = Buffer.from([1, 2, 3]);
+ * const serialized = codec.serialize(buffer);
+ * console.log(serialized === buffer); // true (no copy)
+ * ```
+ */
+export declare class RawCodec implements SerializationCodec<Buffer> {
+    readonly name = "raw";
+    readonly contentType = "application/octet-stream";
+    /**
+     * Returns the buffer unchanged (passthrough, no copy).
+     *
+     * @param value - Buffer to serialize
+     * @returns The same buffer instance
+     */
+    serialize(value: Buffer): Buffer;
+    /**
+     * Returns the buffer unchanged (passthrough, no copy).
+     *
+     * @param buffer - Buffer to deserialize
+     * @returns The same buffer instance
+     */
+    deserialize(buffer: Buffer): Buffer;
+}
+//# sourceMappingURL=raw.d.ts.map

package/dist/serialization/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/serialization/raw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAS,YAAW,kBAAkB,CAAC,MAAM,CAAC;IACzD,SAAgB,IAAI,SAAS;IAC7B,SAAgB,WAAW,8BAA8B;IAEzD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGpC"}

package/dist/serialization/raw.js

@@ -0,0 +1,41 @@
+/**
+ * Raw binary passthrough codec (zero-copy).
+ *
+ * Performs no serialization - simply passes Buffer instances through unchanged.
+ * Useful for binary protocols or when pre-serialized data is available.
+ *
+ * **Important**: This codec does not copy buffers. Mutations to the returned
+ * buffer will affect the original data. If you need isolation, copy the buffer
+ * yourself using `Buffer.from(buffer)`.
+ *
+ * @example
+ * ```ts
+ * const codec = new RawCodec();
+ * const buffer = Buffer.from([1, 2, 3]);
+ * const serialized = codec.serialize(buffer);
+ * console.log(serialized === buffer); // true (no copy)
+ * ```
+ */
+export class RawCodec {
+    name = "raw";
+    contentType = "application/octet-stream";
+    /**
+     * Returns the buffer unchanged (passthrough, no copy).
+     *
+     * @param value - Buffer to serialize
+     * @returns The same buffer instance
+     */
+    serialize(value) {
+        return value;
+    }
+    /**
+     * Returns the buffer unchanged (passthrough, no copy).
+     *
+     * @param buffer - Buffer to deserialize
+     * @returns The same buffer instance
+     */
+    deserialize(buffer) {
+        return buffer;
+    }
+}
+//# sourceMappingURL=raw.js.map