@homaiohq/napi-quickfix 0.0.0-stage → 0.1.0

package/dist/cjs/message.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Ergonomic wrapper around the native `FIX::Message`.
+ */
+import { type NativeMessage } from './native.js';
+/** Options controlling how a raw FIX string is parsed into a {@link Message}. */
+export interface MessageParseOptions {
+    /**
+     * When `true`, the engine validates the message structure during parsing
+     * (e.g. checksum / body-length). Defaults to `false` (lenient parse), matching
+     * QuickFIX behaviour where validation is normally applied via a
+     * {@link DataDictionary} instead.
+     */
+    validate?: boolean;
+}
+/** A structured, best-effort view of a parsed message returned by {@link Message.toJSON}. */
+export interface MessageJSON {
+    /** The MsgType (tag 35) if resolvable, otherwise omitted. */
+    msgType?: string;
+    /** The raw FIX wire string (SOH-delimited). */
+    raw: string;
+}
+/**
+ * A FIX message.
+ *
+ * Field values are accepted as `string | number` on input (numbers are
+ * stringified, since FIX is string-on-the-wire) and always returned as `string`.
+ *
+ * @example
+ * ```ts
+ * import { Message, FIELD, MsgType } from '@homaiohq/napi-quickfix';
+ *
+ * const msg = new Message();
+ * msg.setField(FIELD.MsgType, MsgType.NewOrderSingle)
+ *    .setField(FIELD.ClOrdID, 'order-1')
+ *    .setField(FIELD.OrderQty, 100);
+ *
+ * const parsed = Message.parse(msg.toString());
+ * console.log(parsed.getMsgType());
+ * ```
+ */
+export declare class Message {
+    #private;
+    /**
+     * Create a message. With no argument, creates an empty message. With a raw
+     * FIX string, parses it.
+     *
+     * Advanced: passing an existing {@link NativeMessage} handle adopts it (used
+     * internally by the engine bridge to wrap inbound/outbound native messages).
+     *
+     * @param raw Optional raw FIX wire string (SOH-delimited) to parse, or an
+     *   existing native handle to adopt.
+     * @param opts Optional parse options.
+     */
+    constructor(raw?: string | NativeMessage, opts?: MessageParseOptions);
+    /**
+     * Parse a raw FIX wire string into a {@link Message}.
+     *
+     * @param raw Raw FIX wire string (SOH-delimited).
+     * @param opts Optional parse options.
+     */
+    static parse(raw: string, opts?: MessageParseOptions): Message;
+    /** @internal Wrap an existing native message handle (used by the engine bridge). */
+    static fromNative(handle: NativeMessage): Message;
+    /** @internal The native handle backing this message (for the engine / sendToTarget / validation). */
+    get nativeHandle(): NativeMessage;
+    /**
+     * Read a body field by tag.
+     * @throws A `QuickFixError` (`fixError: 'FieldNotFound'`) if absent.
+     */
+    getField(tag: number): string;
+    /** Set a body field. Returns `this` for chaining. */
+    setField(tag: number, value: string | number): this;
+    /**
+     * Read a header field by tag.
+     * @throws A `QuickFixError` (`fixError: 'FieldNotFound'`) if absent.
+     */
+    getHeaderField(tag: number): string;
+    /** Set a header field. Returns `this` for chaining. */
+    setHeaderField(tag: number, value: string | number): this;
+    /**
+     * Read a trailer field by tag.
+     * @throws A `QuickFixError` (`fixError: 'FieldNotFound'`) if absent.
+     */
+    getTrailerField(tag: number): string;
+    /** Set a trailer field. Returns `this` for chaining. */
+    setTrailerField(tag: number, value: string | number): this;
+    /** The message type (tag 35), e.g. `'A'` for Logon. */
+    getMsgType(): string;
+    /** The raw FIX wire string (SOH-delimited). */
+    toString(): string;
+    /** A human-readable, pretty-printed rendering of the message. */
+    toPretty(): string;
+    /**
+     * A best-effort structured view. Always includes `raw`; includes `msgType`
+     * when resolvable.
+     */
+    toJSON(): MessageJSON;
+}
+/**
+ * Create a message, optionally pre-populating body fields.
+ *
+ * @param fields Map of tag → value to set on the message body.
+ *
+ * @example
+ * ```ts
+ * const msg = createMessage({ [FIELD.MsgType]: MsgType.Logon, [FIELD.HeartBtInt]: 30 });
+ * ```
+ */
+export declare function createMessage(fields?: Record<number, string | number>): Message;
+/**
+ * Parse a raw FIX wire string into a {@link Message}. Alias of {@link Message.parse}.
+ */
+export declare function parseMessage(raw: string, opts?: MessageParseOptions): Message;
+//# sourceMappingURL=message.d.ts.map

package/dist/cjs/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OAAO;;IAIlB;;;;;;;;;;OAUG;IACH,YAAY,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,IAAI,CAAC,EAAE,mBAAmB,EASnE;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAE7D;IAED,oFAAoF;IACpF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEhD;IAED,qGAAqG;IACrG,IAAI,YAAY,IAAI,aAAa,CAEhC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5B;IAED,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlD;IAED;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElC;IAED,uDAAuD;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;IAED;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnC;IAED,wDAAwD;IACxD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;IAED,uDAAuD;IACvD,UAAU,IAAI,MAAM,CAEnB;IAED,+CAA+C;IAC/C,QAAQ,IAAI,MAAM,CAEjB;IAED,iEAAiE;IACjE,QAAQ,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,MAAM,IAAI,WAAW,CASpB;CACF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAQ/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAE7E"}

package/dist/cjs/message.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Message = void 0;
+exports.createMessage = createMessage;
+exports.parseMessage = parseMessage;
+/**
+ * Ergonomic wrapper around the native `FIX::Message`.
+ */
+const native_js_1 = require("./native.js");
+/**
+ * A FIX message.
+ *
+ * Field values are accepted as `string | number` on input (numbers are
+ * stringified, since FIX is string-on-the-wire) and always returned as `string`.
+ *
+ * @example
+ * ```ts
+ * import { Message, FIELD, MsgType } from '@homaiohq/napi-quickfix';
+ *
+ * const msg = new Message();
+ * msg.setField(FIELD.MsgType, MsgType.NewOrderSingle)
+ *    .setField(FIELD.ClOrdID, 'order-1')
+ *    .setField(FIELD.OrderQty, 100);
+ *
+ * const parsed = Message.parse(msg.toString());
+ * console.log(parsed.getMsgType());
+ * ```
+ */
+class Message {
+    /** @internal Underlying native handle. */
+    #native;
+    /**
+     * Create a message. With no argument, creates an empty message. With a raw
+     * FIX string, parses it.
+     *
+     * Advanced: passing an existing {@link NativeMessage} handle adopts it (used
+     * internally by the engine bridge to wrap inbound/outbound native messages).
+     *
+     * @param raw Optional raw FIX wire string (SOH-delimited) to parse, or an
+     *   existing native handle to adopt.
+     * @param opts Optional parse options.
+     */
+    constructor(raw, opts) {
+        if (raw === undefined) {
+            this.#native = new native_js_1.native.MessageWrap();
+        }
+        else if (typeof raw === 'string') {
+            this.#native = new native_js_1.native.MessageWrap(raw, opts?.validate ?? false);
+        }
+        else {
+            // Adopt an existing native handle (bridge path).
+            this.#native = raw;
+        }
+    }
+    /**
+     * Parse a raw FIX wire string into a {@link Message}.
+     *
+     * @param raw Raw FIX wire string (SOH-delimited).
+     * @param opts Optional parse options.
+     */
+    static parse(raw, opts) {
+        return new Message(raw, opts);
+    }
+    /** @internal Wrap an existing native message handle (used by the engine bridge). */
+    static fromNative(handle) {
+        return new Message(handle);
+    }
+    /** @internal The native handle backing this message (for the engine / sendToTarget / validation). */
+    get nativeHandle() {
+        return this.#native;
+    }
+    /**
+     * Read a body field by tag.
+     * @throws A `QuickFixError` (`fixError: 'FieldNotFound'`) if absent.
+     */
+    getField(tag) {
+        return this.#native.getField(tag);
+    }
+    /** Set a body field. Returns `this` for chaining. */
+    setField(tag, value) {
+        this.#native.setField(tag, String(value));
+        return this;
+    }
+    /**
+     * Read a header field by tag.
+     * @throws A `QuickFixError` (`fixError: 'FieldNotFound'`) if absent.
+     */
+    getHeaderField(tag) {
+        return this.#native.getHeaderField(tag);
+    }
+    /** Set a header field. Returns `this` for chaining. */
+    setHeaderField(tag, value) {
+        this.#native.setHeaderField(tag, String(value));
+        return this;
+    }
+    /**
+     * Read a trailer field by tag.
+     * @throws A `QuickFixError` (`fixError: 'FieldNotFound'`) if absent.
+     */
+    getTrailerField(tag) {
+        return this.#native.getTrailerField(tag);
+    }
+    /** Set a trailer field. Returns `this` for chaining. */
+    setTrailerField(tag, value) {
+        this.#native.setTrailerField(tag, String(value));
+        return this;
+    }
+    /** The message type (tag 35), e.g. `'A'` for Logon. */
+    getMsgType() {
+        return this.#native.getMsgType();
+    }
+    /** The raw FIX wire string (SOH-delimited). */
+    toString() {
+        return this.#native.toString();
+    }
+    /** A human-readable, pretty-printed rendering of the message. */
+    toPretty() {
+        return this.#native.toPretty();
+    }
+    /**
+     * A best-effort structured view. Always includes `raw`; includes `msgType`
+     * when resolvable.
+     */
+    toJSON() {
+        const raw = this.toString();
+        let msgType;
+        try {
+            msgType = this.getMsgType();
+        }
+        catch {
+            msgType = undefined;
+        }
+        return msgType === undefined ? { raw } : { msgType, raw };
+    }
+}
+exports.Message = Message;
+/**
+ * Create a message, optionally pre-populating body fields.
+ *
+ * @param fields Map of tag → value to set on the message body.
+ *
+ * @example
+ * ```ts
+ * const msg = createMessage({ [FIELD.MsgType]: MsgType.Logon, [FIELD.HeartBtInt]: 30 });
+ * ```
+ */
+function createMessage(fields) {
+    const msg = new Message();
+    if (fields) {
+        for (const [tag, value] of Object.entries(fields)) {
+            msg.setField(Number(tag), value);
+        }
+    }
+    return msg;
+}
+/**
+ * Parse a raw FIX wire string into a {@link Message}. Alias of {@link Message.parse}.
+ */
+function parseMessage(raw, opts) {
+    return Message.parse(raw, opts);
+}
+//# sourceMappingURL=message.js.map

package/dist/cjs/message.js.map

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

package/dist/cjs/native.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Native `FIX::Message` wrapper. FIX is string-on-the-wire, so every field
+ * value crosses the boundary as a string.
+ */
+export interface NativeMessage {
+    getField(tag: number): string;
+    setField(tag: number, value: string): void;
+    getHeaderField(tag: number): string;
+    setHeaderField(tag: number, value: string): void;
+    getTrailerField(tag: number): string;
+    setTrailerField(tag: number, value: string): void;
+    getMsgType(): string;
+    toString(): string;
+    toPretty(): string;
+}
+/** Constructor shape for the native `MessageWrap` class. */
+export interface NativeMessageConstructor {
+    new (): NativeMessage;
+    new (raw: string, validate?: boolean): NativeMessage;
+}
+/** Native `FIX::SessionID` wrapper. */
+export interface NativeSessionID {
+    getBeginString(): string;
+    getSenderCompID(): string;
+    getTargetCompID(): string;
+    getSessionQualifier(): string;
+    toString(): string;
+}
+/** Constructor shape for the native `SessionIDWrap` class. */
+export interface NativeSessionIDConstructor {
+    new (beginString: string, senderCompID: string, targetCompID: string, qualifier?: string): NativeSessionID;
+}
+/** Native `FIX::SessionSettings` wrapper. */
+export interface NativeSessionSettings {
+    getSessions(): NativeSessionID[];
+}
+/**
+ * Constructor shape for the native `SessionSettingsWrap` class. `fromString` /
+ * `fromFile` MAY appear here as statics (see the module-level equivalents on
+ * {@link NativeModule}); we resolve defensively at runtime.
+ */
+export interface NativeSessionSettingsConstructor {
+    new (): NativeSessionSettings;
+    fromString?(cfg: string): NativeSessionSettings;
+    fromFile?(path: string): NativeSessionSettings;
+}
+/**
+ * Error shape thrown across the native bridge (e.g. from
+ * {@link NativeDataDictionary.validate}, message getters, or engine ops).
+ *
+ * Carries TWO error identifiers:
+ * - {@link QuickFixError.fixError} — the QuickFIX runtime exception type as
+ *   reported by the C++ engine. This is a human-facing string that MAY contain
+ *   spaces (e.g. `'Session Not Found'`, `'Field not found'`).
+ * - {@link QuickFixError.fixErrorName} — a stable, space-free discriminator
+ *   suitable for `switch`/equality checks (e.g. `'SessionNotFound'`,
+ *   `'FieldNotFound'`). Prefer this for programmatic branching.
+ */
+export interface QuickFixError extends Error {
+    /** Always `'QuickFixError'` for errors originating in the native bridge. */
+    name: string;
+    /** Human-readable message. */
+    message: string;
+    /**
+     * QuickFIX runtime exception type string (may contain spaces), e.g.
+     * `'Session Not Found'`. This is the value the native bridge reads when
+     * mapping a thrown rejection back to a FIX exception.
+     */
+    fixError?: string;
+    /**
+     * Stable, space-free discriminator, e.g. `'SessionNotFound'`. Use this for
+     * programmatic checks; it is not subject to QuickFIX's human-facing wording.
+     */
+    fixErrorName?: string;
+    /** Optional extra detail forwarded from the engine where available. */
+    detail?: string;
+}
+/** Native `FIX::DataDictionary` wrapper. */
+export interface NativeDataDictionary {
+    /** Throws a {@link QuickFixError} if the message is invalid. */
+    validate(message: NativeMessage): void;
+}
+/**
+ * Constructor shape for the native `DataDictionaryWrap` class. `fromString` /
+ * `fromFile` MAY appear here as statics (see module-level equivalents on
+ * {@link NativeModule}); we resolve defensively at runtime.
+ */
+export interface NativeDataDictionaryConstructor {
+    new (): NativeDataDictionary;
+    fromString?(xml: string): NativeDataDictionary;
+    fromFile?(path: string): NativeDataDictionary;
+}
+/**
+ * The handlers object handed to the native engine constructor. Each callback
+ * receives raw native handles (the TS layer re-wraps them). Mutation happens by
+ * mutating the passed {@link NativeMessage}; rejection happens by throwing.
+ */
+export interface NativeApplicationHandlers {
+    onCreate?(sessionID: NativeSessionID): void;
+    onLogon?(sessionID: NativeSessionID): void;
+    onLogout?(sessionID: NativeSessionID): void;
+    toAdmin?(message: NativeMessage, sessionID: NativeSessionID): void;
+    toApp?(message: NativeMessage, sessionID: NativeSessionID): void;
+    fromAdmin?(message: NativeMessage, sessionID: NativeSessionID): void;
+    fromApp?(message: NativeMessage, sessionID: NativeSessionID): void;
+}
+/** Options passed to the native `InitiatorWrap` / `AcceptorWrap` constructors. */
+export interface NativeEngineOptions {
+    settings: NativeSessionSettings;
+    handlers?: NativeApplicationHandlers;
+    store?: 'file' | 'memory';
+    log?: 'screen' | 'file' | 'none';
+}
+/**
+ * Native engine (SocketInitiator / SocketAcceptor) wrapper.
+ *
+ * `start`/`stop` run OFF the main thread and resolve a Promise when the engine
+ * has finished (re)configuring its sockets, so the Node.js event loop stays free
+ * to service the application callbacks the engine fires. `isLoggedOn`/`ref`/
+ * `unref` remain synchronous.
+ */
+export interface NativeEngine {
+    start(): Promise<void>;
+    stop(force?: boolean): Promise<void>;
+    isLoggedOn(): boolean;
+    ref(): void;
+    unref(): void;
+}
+/** Constructor shape for the native `InitiatorWrap` / `AcceptorWrap` classes. */
+export interface NativeEngineConstructor {
+    new (options: NativeEngineOptions): NativeEngine;
+}
+/**
+ * The nested FIX-constants object exported by the addon, e.g.
+ * `enums.MsgType.Logon`, `enums.Side.Buy`. Field tags (`FIELD`) are not exported
+ * by the addon; they are generated on the TS side (`src/generated/fields.ts`).
+ */
+export type NativeEnums = Readonly<Record<string, Readonly<Record<string, number | string>>>>;
+/** The full surface of the native addon exported by `load-native.cjs`. */
+export interface NativeModule {
+    version(): string;
+    quickfixParseMsgType(raw: string): string;
+    /** Runs off the main thread; resolves `true` if accepted for sending. */
+    sendToTarget(message: NativeMessage, sessionID: NativeSessionID): Promise<boolean>;
+    enums: NativeEnums;
+    MessageWrap: NativeMessageConstructor;
+    SessionIDWrap: NativeSessionIDConstructor;
+    SessionSettingsWrap: NativeSessionSettingsConstructor;
+    DataDictionaryWrap: NativeDataDictionaryConstructor;
+    InitiatorWrap: NativeEngineConstructor;
+    AcceptorWrap: NativeEngineConstructor;
+    sessionSettingsFromString?(cfg: string): NativeSessionSettings;
+    sessionSettingsFromFile?(path: string): NativeSessionSettings;
+    dataDictionaryFromString?(xml: string): NativeDataDictionary;
+    dataDictionaryFromFile?(path: string): NativeDataDictionary;
+}
+/**
+ * The loaded native addon, typed against the {@link NativeModule} contract.
+ * The default import is an `unknown` (per node-gyp-build's declaration); we
+ * assert it to the contract here — the single localized cast in the codebase.
+ */
+export declare const native: NativeModule;
+//# sourceMappingURL=native.d.ts.map

package/dist/cjs/native.d.ts.map

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

package/dist/cjs/native.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.native = void 0;
+// Loads the compiled native addon. The actual `require('node-gyp-build')(root)`
+// lives in the authored load-native.cjs, which build:ts:copy places next to the
+// compiled output in both dist/esm and dist/cjs. We import it here; the ESM and
+// CJS TS builds each emit the correct interop for pulling in a CommonJS module,
+// so this single source works for both output formats.
+//
+// A plain default import compiles under BOTH tsconfigs (NodeNext ESM and
+// CommonJS/Bundler). We intentionally avoid `import.meta` / `createRequire`
+// here because `import.meta` is not permitted under the CommonJS tsconfig.
+const load_native_cjs_1 = __importDefault(require("./load-native.cjs"));
+/**
+ * The loaded native addon, typed against the {@link NativeModule} contract.
+ * The default import is an `unknown` (per node-gyp-build's declaration); we
+ * assert it to the contract here — the single localized cast in the codebase.
+ */
+exports.native = load_native_cjs_1.default;
+//# sourceMappingURL=native.js.map

package/dist/cjs/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/native.ts"],"names":[],"mappings":";;;;;;AAAA,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,uDAAuD;AACvD,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,wEAA6C;AAgM7C;;;;GAIG;AACU,QAAA,MAAM,GAAG,yBAAuC,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/session-id.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Ergonomic wrapper around the native `FIX::SessionID`.
+ */
+import { type NativeSessionID } from './native.js';
+/**
+ * Identifies a FIX session by its `BeginString`, `SenderCompID`,
+ * `TargetCompID`, and an optional qualifier.
+ *
+ * @example
+ * ```ts
+ * const id = new SessionID('FIX.4.4', 'CLIENT', 'BROKER');
+ * console.log(id.toString()); // FIX.4.4:CLIENT->BROKER
+ * ```
+ */
+export declare class SessionID {
+    #private;
+    /**
+     * @param beginString FIX version, e.g. `'FIX.4.4'`, or an existing native
+     *   handle to adopt (bridge path).
+     * @param senderCompID The sender's CompID.
+     * @param targetCompID The target's CompID.
+     * @param qualifier Optional session qualifier.
+     */
+    constructor(beginString: string | NativeSessionID, senderCompID?: string, targetCompID?: string, qualifier?: string);
+    /** @internal Wrap an existing native session-id handle (used by the engine bridge). */
+    static fromNative(handle: NativeSessionID): SessionID;
+    /** @internal The native handle backing this session id. */
+    get nativeHandle(): NativeSessionID;
+    /** FIX version, e.g. `'FIX.4.4'`. */
+    get beginString(): string;
+    /** The sender's CompID. */
+    get senderCompID(): string;
+    /** The target's CompID. */
+    get targetCompID(): string;
+    /** The session qualifier (empty string if none). */
+    get sessionQualifier(): string;
+    /** The canonical string form, e.g. `FIX.4.4:CLIENT->BROKER`. */
+    toString(): string;
+}
+//# sourceMappingURL=session-id.d.ts.map

package/dist/cjs/session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.d.ts","sourceRoot":"","sources":["../../src/session-id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,SAAS;;IAIpB;;;;;;OAMG;IACH,YACE,WAAW,EAAE,MAAM,GAAG,eAAe,EACrC,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,EAanB;IAED,uFAAuF;IACvF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAEpD;IAED,2DAA2D;IAC3D,IAAI,YAAY,IAAI,eAAe,CAElC;IAED,qCAAqC;IACrC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,2BAA2B;IAC3B,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,2BAA2B;IAC3B,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oDAAoD;IACpD,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,gEAAgE;IAChE,QAAQ,IAAI,MAAM,CAEjB;CACF"}

package/dist/cjs/session-id.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionID = void 0;
+/**
+ * Ergonomic wrapper around the native `FIX::SessionID`.
+ */
+const native_js_1 = require("./native.js");
+/**
+ * Identifies a FIX session by its `BeginString`, `SenderCompID`,
+ * `TargetCompID`, and an optional qualifier.
+ *
+ * @example
+ * ```ts
+ * const id = new SessionID('FIX.4.4', 'CLIENT', 'BROKER');
+ * console.log(id.toString()); // FIX.4.4:CLIENT->BROKER
+ * ```
+ */
+class SessionID {
+    /** @internal Underlying native handle. */
+    #native;
+    /**
+     * @param beginString FIX version, e.g. `'FIX.4.4'`, or an existing native
+     *   handle to adopt (bridge path).
+     * @param senderCompID The sender's CompID.
+     * @param targetCompID The target's CompID.
+     * @param qualifier Optional session qualifier.
+     */
+    constructor(beginString, senderCompID, targetCompID, qualifier) {
+        if (typeof beginString !== 'string') {
+            // Adopt an existing native handle (bridge path).
+            this.#native = beginString;
+        }
+        else {
+            this.#native = new native_js_1.native.SessionIDWrap(beginString, senderCompID ?? '', targetCompID ?? '', qualifier);
+        }
+    }
+    /** @internal Wrap an existing native session-id handle (used by the engine bridge). */
+    static fromNative(handle) {
+        return new SessionID(handle);
+    }
+    /** @internal The native handle backing this session id. */
+    get nativeHandle() {
+        return this.#native;
+    }
+    /** FIX version, e.g. `'FIX.4.4'`. */
+    get beginString() {
+        return this.#native.getBeginString();
+    }
+    /** The sender's CompID. */
+    get senderCompID() {
+        return this.#native.getSenderCompID();
+    }
+    /** The target's CompID. */
+    get targetCompID() {
+        return this.#native.getTargetCompID();
+    }
+    /** The session qualifier (empty string if none). */
+    get sessionQualifier() {
+        return this.#native.getSessionQualifier();
+    }
+    /** The canonical string form, e.g. `FIX.4.4:CLIENT->BROKER`. */
+    toString() {
+        return this.#native.toString();
+    }
+}
+exports.SessionID = SessionID;
+//# sourceMappingURL=session-id.js.map

package/dist/cjs/session-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../../src/session-id.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,2CAA2D;AAE3D;;;;;;;;;GASG;AACH;IACE,0CAA0C;IACjC,OAAO,CAAkB;IAElC;;;;;;OAMG;IACH,YACE,WAAqC,EACrC,YAAqB,EACrB,YAAqB,EACrB,SAAkB;QAElB,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,iDAAiD;YACjD,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAM,CAAC,aAAa,CACrC,WAAW,EACX,YAAY,IAAI,EAAE,EAClB,YAAY,IAAI,EAAE,EAClB,SAAS,CACV,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uFAAuF;IACvF,MAAM,CAAC,UAAU,CAAC,MAAuB;QACvC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,2DAA2D;IAC3D,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,qCAAqC;IACrC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACvC,CAAC;IAED,2BAA2B;IAC3B,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,2BAA2B;IAC3B,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,oDAAoD;IACpD,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAC5C,CAAC;IAED,gEAAgE;IAChE,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/cjs/session-settings.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Ergonomic wrapper around the native `FIX::SessionSettings`.
+ */
+import { type NativeSessionSettings } from './native.js';
+import { SessionID } from './session-id.js';
+/**
+ * Parsed QuickFIX session settings (the `.cfg` configuration).
+ *
+ * Construct via {@link SessionSettings.fromString} or
+ * {@link SessionSettings.fromFile}; direct construction is not supported.
+ *
+ * @example
+ * ```ts
+ * const settings = SessionSettings.fromString(`
+ * [DEFAULT]
+ * ConnectionType=initiator
+ * ...
+ * `);
+ * for (const id of settings.getSessions()) console.log(id.toString());
+ * ```
+ */
+export declare class SessionSettings {
+    #private;
+    /** @internal Use {@link SessionSettings.fromString} / {@link SessionSettings.fromFile}. */
+    private constructor();
+    /**
+     * Parse settings from an in-memory config string.
+     *
+     * @param cfg The QuickFIX `.cfg` contents.
+     * @throws A `QuickFixError` (`fixError: 'ConfigError'`) on invalid config.
+     */
+    static fromString(cfg: string): SessionSettings;
+    /**
+     * Load settings from a `.cfg` file on disk.
+     *
+     * @param path Path to the QuickFIX `.cfg` file.
+     * @throws A `QuickFixError` (`fixError: 'ConfigError'`) on invalid config.
+     */
+    static fromFile(path: string): SessionSettings;
+    /** @internal Wrap an existing native handle. */
+    static fromNative(handle: NativeSessionSettings): SessionSettings;
+    /** @internal The native handle backing these settings. */
+    get nativeHandle(): NativeSessionSettings;
+    /** The sessions declared by this configuration. */
+    getSessions(): SessionID[];
+}
+//# sourceMappingURL=session-settings.d.ts.map

package/dist/cjs/session-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-settings.d.ts","sourceRoot":"","sources":["../../src/session-settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAU,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;;IAI1B,2FAA2F;IAC3F,OAAO,eAEN;IAED;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAU9C;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAQ7C;IAED,gDAAgD;IAChD,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAEhE;IAED,0DAA0D;IAC1D,IAAI,YAAY,IAAI,qBAAqB,CAExC;IAED,mDAAmD;IACnD,WAAW,IAAI,SAAS,EAAE,CAEzB;CACF"}