@glion/mllp 0.15.3 → 0.19.0

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/transport/decoder.ts"],"sourcesContent":["import { MLLP_END_BYTE_1, MLLP_END_BYTE_2, MLLP_START_BYTE } from \"./constants\";\nimport { TransportError } from \"./errors\";\nimport type { DecodedMessage, DecoderOptions } from \"./types\";\nimport { TransportErrorCode } from \"./types\";\n\n/**\n * Decode a single MLLP frame (VT ... FS CR) into a message.\n *\n * Validates framing, strips the envelope, and returns the payload as\n * both raw bytes and decoded text. Throws {@link TransportError} on\n * any structural issue.\n *\n * For streaming / chunked TCP data, use {@link createDecoderStream} instead.\n *\n * @throws TransportError with `INVALID_START_BYTE` if byte 0 is not 0x0B\n * @throws TransportError with `INVALID_END_SEQUENCE` if frame doesn't end with\n *   0x1C 0x0D\n * @throws TransportError with `MESSAGE_TOO_LARGE` if payload exceeds\n *   `maxMessageSize`\n */\nexport function decode(\n  frame: Uint8Array,\n  options?: DecoderOptions\n): DecodedMessage {\n  if (frame.length < 3) {\n    throw new TransportError(\n      TransportErrorCode.INVALID_END_SEQUENCE,\n      \"Frame too short to contain valid MLLP structure\",\n      0\n    );\n  }\n\n  const startByte = frame[0];\n  if (startByte !== MLLP_START_BYTE) {\n    throw new TransportError(\n      TransportErrorCode.INVALID_START_BYTE,\n      `Invalid start byte: expected 0x0B, got 0x${(startByte ?? 0).toString(16).padStart(2, \"0\")}`,\n      0\n    );\n  }\n\n  const len = frame.length;\n  const endByte1 = frame[len - 2];\n  const endByte2 = frame[len - 1];\n  if (endByte1 !== MLLP_END_BYTE_1 || endByte2 !== MLLP_END_BYTE_2) {\n    throw new TransportError(\n      TransportErrorCode.INVALID_END_SEQUENCE,\n      `Invalid end sequence: expected 0x1C 0x0D, got 0x${(endByte1 ?? 0).toString(16).padStart(2, \"0\")} 0x${(endByte2 ?? 0).toString(16).padStart(2, \"0\")}`,\n      len - 2\n    );\n  }\n\n  const messageLength = len - 3;\n  if (\n    options?.maxMessageSize !== undefined &&\n    messageLength > options.maxMessageSize\n  ) {\n    throw new TransportError(\n      TransportErrorCode.MESSAGE_TOO_LARGE,\n      `Message size ${messageLength} exceeds maximum ${options.maxMessageSize}`,\n      0\n    );\n  }\n\n  const data = frame.subarray(1, len - 2);\n  const text = new TextDecoder(options?.encoding ?? \"utf8\").decode(data);\n\n  return {\n    byteLength: messageLength,\n    data,\n    text,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAgB,OACd,OACA,SACgB;AAChB,KAAI,MAAM,SAAS,EACjB,OAAM,IAAI,eACR,mBAAmB,sBACnB,mDACA,EACD;CAGH,MAAM,YAAY,MAAM;AACxB,KAAI,cAAA,GACF,OAAM,IAAI,eACR,mBAAmB,oBACnB,6CAA6C,aAAa,GAAG,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,IAC1F,EACD;CAGH,MAAM,MAAM,MAAM;CAClB,MAAM,WAAW,MAAM,MAAM;CAC7B,MAAM,WAAW,MAAM,MAAM;AAC7B,KAAI,aAAA,MAAgC,aAAA,GAClC,OAAM,IAAI,eACR,mBAAmB,sBACnB,oDAAoD,YAAY,GAAG,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,YAAY,GAAG,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,IACnJ,MAAM,EACP;CAGH,MAAM,gBAAgB,MAAM;AAC5B,KACE,SAAS,mBAAmB,KAAA,KAC5B,gBAAgB,QAAQ,eAExB,OAAM,IAAI,eACR,mBAAmB,mBACnB,gBAAgB,cAAc,mBAAmB,QAAQ,kBACzD,EACD;CAGH,MAAM,OAAO,MAAM,SAAS,GAAG,MAAM,EAAE;AAGvC,QAAO;EACL,YAAY;EACZ;EACA,MALW,IAAI,YAAY,SAAS,YAAY,OAAO,CAAC,OAAO,KAAK;EAMrE"}

package/dist/transport/constants.d.ts

@@ -1,24 +0,0 @@
-/**
- * MLLP Start Byte - Vertical Tab (VT)
- * Marks the beginning of an MLLP frame
- */
-export declare const MLLP_START_BYTE = 11;
-/**
- * MLLP End Byte 1 - File Separator (FS)
- * First byte of the end sequence
- */
-export declare const MLLP_END_BYTE_1 = 28;
-/**
- * MLLP End Byte 2 - Carriage Return (CR)
- * Second byte of the end sequence
- */
-export declare const MLLP_END_BYTE_2 = 13;
-/**
- * MLLP header as a Uint8Array containing the start byte
- */
-export declare const MLLP_HEADER: Uint8Array<ArrayBuffer>;
-/**
- * MLLP trailer as a Uint8Array containing the end sequence
- */
-export declare const MLLP_TRAILER: Uint8Array<ArrayBuffer>;
-//# sourceMappingURL=constants.d.ts.map

package/dist/transport/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/transport/constants.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,eAAe,KAAO,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,eAAe,KAAO,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,eAAe,KAAO,CAAC;AAMpC;;GAEG;AACH,eAAO,MAAM,WAAW,yBAAoC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,YAAY,yBAAqD,CAAC"}

package/dist/transport/decoder-stream.d.ts

@@ -1,49 +0,0 @@
-import type { DecodedMessage, DecoderOptions } from "./types";
-/**
- * Create a `TransformStream` that extracts MLLP messages from a raw
- * byte stream.
- *
- * Pipe a TCP socket's `ReadableStream<Uint8Array>` through this stream
- * to receive one {@link DecodedMessage} per MLLP frame, regardless of
- * how the bytes are chunked on the wire.
- *
- * @example
- *   ```typescript
- *   import { createDecoderStream } from "@glion/mllp";
- *
- *   const decoder = createDecoderStream({
- *     maxMessageSize: 1024 * 1024, // 1 MB limit
- *     onError: (err) => log.warn(err), // custom error handler
- *   });
- *
- *   const messages = socket.readable.pipeThrough(decoder).getReader();
- *
- *   while (true) {
- *     const { done, value } = await messages.read();
- *     if (done) break;
- *     console.log(value.text); // HL7v2 message string
- *   }
- *   ```;
- *
- * @param options - Optional decoder settings (max size, encoding, error
- *   handler).
- * @returns A `TransformStream<Uint8Array, DecodedMessage>`.
- */
-export declare function createDecoderStream(options?: DecoderOptions): TransformStream<Uint8Array, DecodedMessage>;
-/**
- * Class-based variant of {@link createDecoderStream} for cases where
- * a reusable instance is preferred over the factory function.
- *
- * Functionally identical — both delegate to the same internal
- * transformer.
- *
- * @example
- *   ```typescript
- *   const decoder = new MLLPDecoderStream({ maxMessageSize: 512_000 });
- *   socket.readable.pipeThrough(decoder);
- *   ```;
- */
-export declare class MLLPDecoderStream extends TransformStream<Uint8Array, DecodedMessage> {
-    constructor(options?: DecoderOptions);
-}
-//# sourceMappingURL=decoder-stream.d.ts.map

package/dist/transport/decoder-stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decoder-stream.d.ts","sourceRoot":"","sources":["../../src/transport/decoder-stream.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0W9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,UAAU,EAAE,cAAc,CAAC,CAE7C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,SAAQ,eAAe,CACpD,UAAU,EACV,cAAc,CACf;gBACa,OAAO,CAAC,EAAE,cAAc;CAGrC"}

package/dist/transport/decoder.d.ts

@@ -1,18 +0,0 @@
-import type { DecodedMessage, DecoderOptions } from "./types";
-/**
- * Decode a single MLLP frame (VT ... FS CR) into a message.
- *
- * Validates framing, strips the envelope, and returns the payload as
- * both raw bytes and decoded text. Throws {@link TransportError} on
- * any structural issue.
- *
- * For streaming / chunked TCP data, use {@link createDecoderStream} instead.
- *
- * @throws TransportError with `INVALID_START_BYTE` if byte 0 is not 0x0B
- * @throws TransportError with `INVALID_END_SEQUENCE` if frame doesn't end with
- *   0x1C 0x0D
- * @throws TransportError with `MESSAGE_TOO_LARGE` if payload exceeds
- *   `maxMessageSize`
- */
-export declare function decode(frame: Uint8Array, options?: DecoderOptions): DecodedMessage;
-//# sourceMappingURL=decoder.d.ts.map

package/dist/transport/decoder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/transport/decoder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,cAAc,CAiDhB"}

package/dist/transport/dynamic-buffer.d.ts

@@ -1,28 +0,0 @@
-/**
- * A growable byte buffer with geometric capacity doubling.
- *
- * Designed for protocol decoders that accumulate bytes from arbitrarily
- * chunked TCP streams. Amortizes copy cost to O(n) total — the same
- * strategy used by pg-protocol, NATS.js, and Java's ArrayList.
- *
- * The buffer maintains a read offset so consumed bytes can be skipped
- * without shifting data. When the wasted prefix exceeds half the
- * capacity, the buffer auto-compacts by shifting remaining bytes to
- * the front.
- *
- * @internal
- */
-export declare class DynamicBuffer {
-    private _buffer;
-    private _length;
-    private _offset;
-    constructor(initialCapacity?: number);
-    get capacity(): number;
-    get available(): number;
-    append(chunk: Uint8Array): void;
-    view(): Uint8Array;
-    consume(n: number): void;
-    reset(): void;
-    private _compact;
-}
-//# sourceMappingURL=dynamic-buffer.d.ts.map

package/dist/transport/dynamic-buffer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dynamic-buffer.d.ts","sourceRoot":"","sources":["../../src/transport/dynamic-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAK;gBAER,eAAe,SAAO;IAIlC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAY/B,IAAI,IAAI,UAAU;IAIlB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAYxB,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/transport/encoder.d.ts

@@ -1,14 +0,0 @@
-import type { EncoderInput, EncoderOptions } from "./types";
-/**
- * Encode a single HL7v2 message into an MLLP frame.
- *
- * Wraps the message with MLLP framing:
- * - Start byte: 0x0B (VT)
- * - End sequence: 0x1C 0x0D (FS + CR)
- */
-export declare function encode(message: EncoderInput, _options?: EncoderOptions): Uint8Array;
-/**
- * Encode multiple HL7v2 messages into concatenated MLLP frames.
- */
-export declare function encodeMultiple(messages: EncoderInput[], options?: EncoderOptions): Uint8Array;
-//# sourceMappingURL=encoder.d.ts.map

package/dist/transport/encoder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/transport/encoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK5D;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,cAAc,GACxB,UAAU,CAWZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAaZ"}

package/dist/transport/errors.d.ts

@@ -1,13 +0,0 @@
-import { MllpError } from "../errors";
-import type { TransportErrorCode } from "./types";
-/**
- * Transport-level error for MLLP framing issues (invalid framing, incomplete
- * messages, etc.)
- */
-export declare class TransportError extends MllpError {
-    readonly code: TransportErrorCode;
-    /** Position in the data where the error occurred (if applicable) */
-    readonly position?: number;
-    constructor(code: TransportErrorCode, message: string, position?: number);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/transport/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/transport/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,SAAiB,IAAI,EAAE,kBAAkB,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;CAKzE"}

package/dist/transport/index.d.ts

@@ -1,8 +0,0 @@
-export { MLLP_END_BYTE_1, MLLP_END_BYTE_2, MLLP_HEADER, MLLP_START_BYTE, MLLP_TRAILER, } from "./constants";
-export { decode } from "./decoder";
-export { createDecoderStream, MLLPDecoderStream } from "./decoder-stream";
-export { encode, encodeMultiple } from "./encoder";
-export { TransportError } from "./errors";
-export { TransportErrorCode as ErrorCode } from "./types";
-export type { DecodedMessage, DecoderOptions, EncoderInput, EncoderOptions, } from "./types";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,kBAAkB,IAAI,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/transport/types.d.ts

@@ -1,49 +0,0 @@
-import type { TransportError } from "./errors";
-/**
- * Input types for encoding - supports both string and binary
- */
-export type EncoderInput = string | Uint8Array;
-/**
- * Decoded message result from MLLP frame
- */
-export interface DecodedMessage {
-    /** The raw message payload (without MLLP framing) */
-    data: Uint8Array;
-    /** Message decoded as string (convenience) */
-    text: string;
-    /** Byte length of the original message */
-    byteLength: number;
-}
-/**
- * Options for the MLLP encoder
- */
-export interface EncoderOptions {
-    /** Encoding for string input (default: 'utf-8') */
-    encoding?: string;
-}
-/**
- * Options for the MLLP decoder
- */
-export interface DecoderOptions {
-    /** Maximum message size in bytes (optional, no default limit) */
-    maxMessageSize?: number;
-    /** Encoding for text conversion (default: 'utf-8') */
-    encoding?: string;
-    /** Error callback for logging/handling errors */
-    onError?: (error: TransportError) => void;
-}
-/**
- * Error codes for MLLP frame-level errors
- */
-export declare const TransportErrorCode: {
-    /** Stream ended with incomplete MLLP message */
-    readonly INCOMPLETE_MESSAGE: "INCOMPLETE_MESSAGE";
-    /** Frame does not end with MLLP end sequence (0x1C 0x0D) */
-    readonly INVALID_END_SEQUENCE: "INVALID_END_SEQUENCE";
-    /** Frame does not start with MLLP start byte (0x0B) */
-    readonly INVALID_START_BYTE: "INVALID_START_BYTE";
-    /** Message exceeds configured maximum size */
-    readonly MESSAGE_TOO_LARGE: "MESSAGE_TOO_LARGE";
-};
-export type TransportErrorCode = (typeof TransportErrorCode)[keyof typeof TransportErrorCode];
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,gDAAgD;;IAEhD,4DAA4D;;IAE5D,uDAAuD;;IAEvD,8CAA8C;;CAEtC,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}