@homaiohq/napi-quickfix 0.1.0 → 0.3.0

package/dist/cjs/group.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Ergonomic wrapper around the native `FIX::Group`: one entry of a repeating
+ * group.
+ */
+import { type NativeGroup } from './native.js';
+/**
+ * One entry of a FIX repeating group.
+ *
+ * A group is identified by its **count tag** (`field`, e.g. `453 NoPartyIDs`)
+ * and its **delimiter** (`delim`, the first tag of every entry, e.g.
+ * `448 PartyID`). Build an entry, fill its fields, then
+ * {@link Message.addGroup} it; QuickFIX maintains the count field for you.
+ *
+ * Field values are accepted as `string | number` on input (numbers are written
+ * without exponent notation) and always returned as `string`, exactly as on
+ * {@link Message}. Groups nest: an entry can carry its own repeating groups
+ * through the same `addGroup` / `getGroup` API.
+ *
+ * Entries read back with `getGroup` are **snapshot copies**: mutating one does
+ * not change the message it came from. Write it back with
+ * {@link Message.replaceGroup}.
+ *
+ * Group indices are **1-based**, as in QuickFIX.
+ *
+ * @example
+ * ```ts
+ * import { Group, Message, FIELD } from '@homaiohq/napi-quickfix';
+ *
+ * const party = new Group(FIELD.NoPartyIDs, FIELD.PartyID)
+ *   .setField(FIELD.PartyID, 'TRADER-1')
+ *   .setField(FIELD.PartyIDSource, 'D')
+ *   .setField(FIELD.PartyRole, 11);
+ * order.addGroup(party);
+ *
+ * order.groupCount(FIELD.NoPartyIDs);           // 1
+ * order.getGroup(1, FIELD.NoPartyIDs).getField(FIELD.PartyID); // 'TRADER-1'
+ * ```
+ */
+export declare class Group {
+    #private;
+    /**
+     * Create an empty group entry.
+     *
+     * @param field The group's count tag (e.g. `FIELD.NoPartyIDs`), or an
+     *   existing native handle to adopt (internal).
+     * @param delim The delimiter: the first tag of every entry (e.g.
+     *   `FIELD.PartyID`).
+     * @param order Optional complete field order of an entry, delimiter first
+     *   (e.g. `[448, 447, 452]`). Fields not listed sort after the listed ones by
+     *   tag number. Without it, fields sort delimiter-first then by tag number,
+     *   which already matches the standard dictionaries for most groups.
+     */
+    constructor(field: number | NativeGroup, delim?: number, order?: readonly number[]);
+    /** @internal Wrap an existing native group handle. */
+    static fromNative(handle: NativeGroup): Group;
+    /** @internal The native handle backing this group. */
+    get nativeHandle(): NativeGroup;
+    /** The group's count tag (e.g. `453` for `NoPartyIDs`). */
+    get field(): number;
+    /** The delimiter: the first tag of every entry (e.g. `448` for `PartyID`). */
+    get delim(): number;
+    /**
+     * Read a field by tag.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) if absent.
+     */
+    getField(tag: number): string;
+    /** Set a field. Returns `this` for chaining. */
+    setField(tag: number, value: string | number): this;
+    /** Whether a field is present. */
+    isSetField(tag: number): boolean;
+    /** Remove a field (no-op if absent). Returns `this` for chaining. */
+    removeField(tag: number): this;
+    /** Read a field by tag, or `undefined` if absent. */
+    getFieldIfSet(tag: number): string | undefined;
+    /** The number of fields, including every field of every nested group entry. */
+    totalFields(): number;
+    /** Whether the entry has no fields of its own. */
+    isEmpty(): boolean;
+    /** Remove every field and nested group. Returns `this` for chaining. */
+    clear(): this;
+    /** The entry's own fields, in wire order, as `[tag, value]` pairs. */
+    fields(): [number, string][];
+    /** Iterates the entry's own fields as `[tag, value]` pairs (see {@link Group.fields}). */
+    [Symbol.iterator](): IterableIterator<[number, string]>;
+    /**
+     * Append a nested group entry under its own count tag (a copy is stored; the
+     * count field is updated). Returns `this` for chaining.
+     * @throws `TypeError` when `group.delim` differs from the delimiter of the
+     *   entries already stored under `group.field`.
+     */
+    addGroup(group: Group): this;
+    /**
+     * A snapshot copy of the `index`-th entry (1-based) of the nested group `tag`.
+     * Mutations do not affect this entry; write them back with
+     * {@link Group.replaceGroup}.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) when the tag
+     *   has no entries or `index` is out of range.
+     */
+    getGroup(index: number, tag: number): Group;
+    /**
+     * Overwrite the `index`-th entry (1-based) under `group.field` with a copy of
+     * `group`. Returns `this` for chaining.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) when that
+     *   entry does not exist.
+     * @throws `TypeError` when `group.delim` differs from the stored entry's
+     *   delimiter.
+     */
+    replaceGroup(index: number, group: Group): this;
+    /**
+     * Remove every entry of the nested group `tag` (and its count field), or
+     * only the `index`-th entry (1-based). Returns `this`.
+     *
+     * Removing every entry of a tag that has none is a no-op.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) when the
+     *   `index`-th entry does not exist.
+     */
+    removeGroup(tag: number): this;
+    removeGroup(index: number, tag: number): this;
+    /** Whether the nested group `tag` has any entry, or has an `index`-th entry (1-based). */
+    hasGroup(tag: number): boolean;
+    hasGroup(index: number, tag: number): boolean;
+    /** The number of entries of the nested group `tag` (0 if none). */
+    groupCount(tag: number): number;
+    /** The entry's fields (and nested groups) as a SOH-delimited string, in wire order. */
+    toString(): string;
+}

package/dist/cjs/group.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Group = void 0;
+/**
+ * Ergonomic wrapper around the native `FIX::Group`: one entry of a repeating
+ * group.
+ */
+const native_js_1 = require("./native.js");
+const field_value_js_1 = require("./field-value.js");
+/**
+ * One entry of a FIX repeating group.
+ *
+ * A group is identified by its **count tag** (`field`, e.g. `453 NoPartyIDs`)
+ * and its **delimiter** (`delim`, the first tag of every entry, e.g.
+ * `448 PartyID`). Build an entry, fill its fields, then
+ * {@link Message.addGroup} it; QuickFIX maintains the count field for you.
+ *
+ * Field values are accepted as `string | number` on input (numbers are written
+ * without exponent notation) and always returned as `string`, exactly as on
+ * {@link Message}. Groups nest: an entry can carry its own repeating groups
+ * through the same `addGroup` / `getGroup` API.
+ *
+ * Entries read back with `getGroup` are **snapshot copies**: mutating one does
+ * not change the message it came from. Write it back with
+ * {@link Message.replaceGroup}.
+ *
+ * Group indices are **1-based**, as in QuickFIX.
+ *
+ * @example
+ * ```ts
+ * import { Group, Message, FIELD } from '@homaiohq/napi-quickfix';
+ *
+ * const party = new Group(FIELD.NoPartyIDs, FIELD.PartyID)
+ *   .setField(FIELD.PartyID, 'TRADER-1')
+ *   .setField(FIELD.PartyIDSource, 'D')
+ *   .setField(FIELD.PartyRole, 11);
+ * order.addGroup(party);
+ *
+ * order.groupCount(FIELD.NoPartyIDs);           // 1
+ * order.getGroup(1, FIELD.NoPartyIDs).getField(FIELD.PartyID); // 'TRADER-1'
+ * ```
+ */
+class Group {
+    /** @internal Underlying native handle. */
+    #native;
+    /**
+     * Create an empty group entry.
+     *
+     * @param field The group's count tag (e.g. `FIELD.NoPartyIDs`), or an
+     *   existing native handle to adopt (internal).
+     * @param delim The delimiter: the first tag of every entry (e.g.
+     *   `FIELD.PartyID`).
+     * @param order Optional complete field order of an entry, delimiter first
+     *   (e.g. `[448, 447, 452]`). Fields not listed sort after the listed ones by
+     *   tag number. Without it, fields sort delimiter-first then by tag number,
+     *   which already matches the standard dictionaries for most groups.
+     */
+    constructor(field, delim, order) {
+        if (typeof field !== 'number') {
+            // Adopt an existing native handle (getGroup path).
+            this.#native = field;
+        }
+        else {
+            if (typeof delim !== 'number') {
+                throw new TypeError('new Group(field: number, delim: number, order?: number[])');
+            }
+            this.#native = new native_js_1.native.GroupWrap(field, delim, order);
+        }
+    }
+    /** @internal Wrap an existing native group handle. */
+    static fromNative(handle) {
+        return new Group(handle);
+    }
+    /** @internal The native handle backing this group. */
+    get nativeHandle() {
+        return this.#native;
+    }
+    /** The group's count tag (e.g. `453` for `NoPartyIDs`). */
+    get field() {
+        return this.#native.field();
+    }
+    /** The delimiter: the first tag of every entry (e.g. `448` for `PartyID`). */
+    get delim() {
+        return this.#native.delim();
+    }
+    /**
+     * Read a field by tag.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) if absent.
+     */
+    getField(tag) {
+        return this.#native.getField(tag);
+    }
+    /** Set a field. Returns `this` for chaining. */
+    setField(tag, value) {
+        this.#native.setField(tag, (0, field_value_js_1.formatFieldValue)(value));
+        return this;
+    }
+    /** Whether a field is present. */
+    isSetField(tag) {
+        return this.#native.isSetField(tag);
+    }
+    /** Remove a field (no-op if absent). Returns `this` for chaining. */
+    removeField(tag) {
+        this.#native.removeField(tag);
+        return this;
+    }
+    /** Read a field by tag, or `undefined` if absent. */
+    getFieldIfSet(tag) {
+        return this.#native.getFieldIfSet(tag);
+    }
+    /** The number of fields, including every field of every nested group entry. */
+    totalFields() {
+        return this.#native.totalFields();
+    }
+    /** Whether the entry has no fields of its own. */
+    isEmpty() {
+        return this.#native.isEmpty();
+    }
+    /** Remove every field and nested group. Returns `this` for chaining. */
+    clear() {
+        this.#native.clear();
+        return this;
+    }
+    /** The entry's own fields, in wire order, as `[tag, value]` pairs. */
+    fields() {
+        return this.#native.fields();
+    }
+    /** Iterates the entry's own fields as `[tag, value]` pairs (see {@link Group.fields}). */
+    [Symbol.iterator]() {
+        return this.fields()[Symbol.iterator]();
+    }
+    /**
+     * Append a nested group entry under its own count tag (a copy is stored; the
+     * count field is updated). Returns `this` for chaining.
+     * @throws `TypeError` when `group.delim` differs from the delimiter of the
+     *   entries already stored under `group.field`.
+     */
+    addGroup(group) {
+        this.#native.addGroup(group.nativeHandle);
+        return this;
+    }
+    /**
+     * A snapshot copy of the `index`-th entry (1-based) of the nested group `tag`.
+     * Mutations do not affect this entry; write them back with
+     * {@link Group.replaceGroup}.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) when the tag
+     *   has no entries or `index` is out of range.
+     */
+    getGroup(index, tag) {
+        return Group.fromNative(this.#native.getGroup(index, tag));
+    }
+    /**
+     * Overwrite the `index`-th entry (1-based) under `group.field` with a copy of
+     * `group`. Returns `this` for chaining.
+     * @throws A `QuickFixError` (`fixErrorName: 'FieldNotFound'`) when that
+     *   entry does not exist.
+     * @throws `TypeError` when `group.delim` differs from the stored entry's
+     *   delimiter.
+     */
+    replaceGroup(index, group) {
+        this.#native.replaceGroup(index, group.nativeHandle);
+        return this;
+    }
+    removeGroup(a, b) {
+        if (b === undefined) {
+            this.#native.removeGroup(a);
+        }
+        else {
+            this.#native.removeGroup(a, b);
+        }
+        return this;
+    }
+    hasGroup(a, b) {
+        return b === undefined ? this.#native.hasGroup(a) : this.#native.hasGroup(a, b);
+    }
+    /** The number of entries of the nested group `tag` (0 if none). */
+    groupCount(tag) {
+        return this.#native.groupCount(tag);
+    }
+    /** The entry's fields (and nested groups) as a SOH-delimited string, in wire order. */
+    toString() {
+        return this.#native.toString();
+    }
+}
+exports.Group = Group;

package/dist/cjs/index.d.ts

@@ -1,7 +1,8 @@
 import type { Message } from './message.js';
-import type { SessionID } from './session-id.js';
+import { type SessionID } from './session-id.js';
 export { Message, createMessage, parseMessage } from './message.js';
 export type { MessageParseOptions, MessageJSON } from './message.js';
+export { Group } from './group.js';
 export { SessionID } from './session-id.js';
 export { SessionSettings } from './session-settings.js';
 export { DataDictionary } from './data-dictionary.js';
@@ -9,11 +10,14 @@ export { Initiator } from './initiator.js';
 export { Acceptor } from './acceptor.js';
 export { Engine } from './engine.js';
 export type { EngineOptions, EngineEvents } from './engine.js';
+export { Session, lookupSession, doesSessionExist, getSessions, numSessions } from './session.js';
 export { FixReject, fixReject } from './application.js';
 export type { ApplicationHandlers, FixRejectKind } from './application.js';
 export type { QuickFixError } from './native.js';
-export { enums, FIELD, MsgType, Side } from './enums.js';
-export type { Enums, EnumGroup, FieldName } from './enums.js';
+export { createTlsTunnel } from './tls-tunnel.js';
+export type { TlsTunnel, TlsTunnelOptions, TlsTunnelEvents, TlsTunnelSecureConnectInfo, } from './tls-tunnel.js';
+export { enums, FIELD, VALUES, MsgType, Side, OrdType, TimeInForce } from './enums.js';
+export type { Enums, EnumGroup, FieldName, ValueGroups, ValueGroupName } from './enums.js';
 /**
  * Send a message to the target session identified by `sessionID`.
  *
@@ -23,11 +27,17 @@ export type { Enums, EnumGroup, FieldName } from './enums.js';
  * Runs off the main thread and resolves once the engine has accepted (or
  * rejected) the message, so the event loop stays free for callbacks. On a
  * missing session the returned Promise rejects with a
- * {@link QuickFixError} (`fixErrorName: 'SessionNotFound'`).
+ * {@link QuickFixError} (`fixErrorName: 'SessionNotFound'`). The send is
+ * bound to the engine that owns the session when it is called: if that
+ * engine is stopped before the send reaches its session, the Promise rejects
+ * with `SessionNotFound` rather than running through an engine created later
+ * with the same id.
  *
  * @param message The message to send.
  * @param sessionID The destination session.
  * @returns A Promise resolving to `true` if the message was accepted for sending.
+ * @throws {TypeError} synchronously if `sessionID` is neither a {@link SessionID}
+ *   nor a qualifier string (it is not routed by the header instead).
  *
  * @example
  * ```ts
@@ -37,6 +47,20 @@ export type { Enums, EnumGroup, FieldName } from './enums.js';
  * ```
  */
 export declare function sendToTarget(message: Message, sessionID: SessionID): Promise<boolean>;
+/**
+ * Send a message to the session identified by the message's **own header**
+ * (`BeginString`, `SenderCompID`, `TargetCompID`) plus an optional session
+ * qualifier.
+ *
+ * Wraps the `FIX::Session::sendToTarget(message, qualifier)` overload. Same
+ * threading and error behaviour as the SessionID form; a message whose header
+ * does not identify an existing session rejects with
+ * `fixErrorName: 'SessionNotFound'`.
+ *
+ * @param message The message to send; its header must carry tags 8, 49 and 56.
+ * @param qualifier Optional session qualifier (`SessionQualifier` in the settings).
+ */
+export declare function sendToTarget(message: Message, qualifier?: string): Promise<boolean>;
 /** The QuickFIX engine / addon version string. */
 export declare const version: () => string;
 /**
@@ -44,4 +68,3 @@ export declare const version: () => string;
  * prefer {@link Message.parse} + {@link Message.getMsgType} for general use.
  */
 export declare const quickfixParseMsgType: (raw: string) => string;
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.quickfixParseMsgType = exports.version = exports.Side = exports.MsgType = exports.FIELD = exports.enums = exports.fixReject = exports.FixReject = exports.Engine = exports.Acceptor = exports.Initiator = exports.DataDictionary = exports.SessionSettings = exports.SessionID = exports.parseMessage = exports.createMessage = exports.Message = void 0;
+exports.quickfixParseMsgType = exports.version = exports.TimeInForce = exports.OrdType = exports.Side = exports.MsgType = exports.VALUES = exports.FIELD = exports.enums = exports.createTlsTunnel = exports.fixReject = exports.FixReject = exports.numSessions = exports.getSessions = exports.doesSessionExist = exports.lookupSession = exports.Session = exports.Engine = exports.Acceptor = exports.Initiator = exports.DataDictionary = exports.SessionSettings = exports.SessionID = exports.Group = exports.parseMessage = exports.createMessage = exports.Message = void 0;
 exports.sendToTarget = sendToTarget;
 /**
  * `@homaiohq/napi-quickfix` — a modern Node-API binding for the QuickFIX C++
@@ -9,13 +9,16 @@ exports.sendToTarget = sendToTarget;
  * @packageDocumentation
  */
 const native_js_1 = require("./native.js");
+const session_id_js_1 = require("./session-id.js");
 // --- Pure layer -----------------------------------------------------------
 var message_js_1 = require("./message.js");
 Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return message_js_1.Message; } });
 Object.defineProperty(exports, "createMessage", { enumerable: true, get: function () { return message_js_1.createMessage; } });
 Object.defineProperty(exports, "parseMessage", { enumerable: true, get: function () { return message_js_1.parseMessage; } });
-var session_id_js_1 = require("./session-id.js");
-Object.defineProperty(exports, "SessionID", { enumerable: true, get: function () { return session_id_js_1.SessionID; } });
+var group_js_1 = require("./group.js");
+Object.defineProperty(exports, "Group", { enumerable: true, get: function () { return group_js_1.Group; } });
+var session_id_js_2 = require("./session-id.js");
+Object.defineProperty(exports, "SessionID", { enumerable: true, get: function () { return session_id_js_2.SessionID; } });
 var session_settings_js_1 = require("./session-settings.js");
 Object.defineProperty(exports, "SessionSettings", { enumerable: true, get: function () { return session_settings_js_1.SessionSettings; } });
 var data_dictionary_js_1 = require("./data-dictionary.js");
@@ -27,39 +30,39 @@ var acceptor_js_1 = require("./acceptor.js");
 Object.defineProperty(exports, "Acceptor", { enumerable: true, get: function () { return acceptor_js_1.Acceptor; } });
 var engine_js_1 = require("./engine.js");
 Object.defineProperty(exports, "Engine", { enumerable: true, get: function () { return engine_js_1.Engine; } });
+var session_js_1 = require("./session.js");
+Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return session_js_1.Session; } });
+Object.defineProperty(exports, "lookupSession", { enumerable: true, get: function () { return session_js_1.lookupSession; } });
+Object.defineProperty(exports, "doesSessionExist", { enumerable: true, get: function () { return session_js_1.doesSessionExist; } });
+Object.defineProperty(exports, "getSessions", { enumerable: true, get: function () { return session_js_1.getSessions; } });
+Object.defineProperty(exports, "numSessions", { enumerable: true, get: function () { return session_js_1.numSessions; } });
 var application_js_1 = require("./application.js");
 Object.defineProperty(exports, "FixReject", { enumerable: true, get: function () { return application_js_1.FixReject; } });
 Object.defineProperty(exports, "fixReject", { enumerable: true, get: function () { return application_js_1.fixReject; } });
+var tls_tunnel_js_1 = require("./tls-tunnel.js");
+Object.defineProperty(exports, "createTlsTunnel", { enumerable: true, get: function () { return tls_tunnel_js_1.createTlsTunnel; } });
 // --- Enums / constants ----------------------------------------------------
+// Every other value group (ExecType, OrdStatus, SecurityType, ...) is reachable
+// as `enums.<Field>` / `VALUES.<Field>`, or by name from the
+// `@homaiohq/napi-quickfix/values` subpath, which keeps this namespace small.
 var enums_js_1 = require("./enums.js");
 Object.defineProperty(exports, "enums", { enumerable: true, get: function () { return enums_js_1.enums; } });
 Object.defineProperty(exports, "FIELD", { enumerable: true, get: function () { return enums_js_1.FIELD; } });
+Object.defineProperty(exports, "VALUES", { enumerable: true, get: function () { return enums_js_1.VALUES; } });
 Object.defineProperty(exports, "MsgType", { enumerable: true, get: function () { return enums_js_1.MsgType; } });
 Object.defineProperty(exports, "Side", { enumerable: true, get: function () { return enums_js_1.Side; } });
-/**
- * Send a message to the target session identified by `sessionID`.
- *
- * Wraps `FIX::Session::sendToTarget`. The session must exist and be logged on
- * for delivery; otherwise the engine queues or drops per its configuration.
- *
- * Runs off the main thread and resolves once the engine has accepted (or
- * rejected) the message, so the event loop stays free for callbacks. On a
- * missing session the returned Promise rejects with a
- * {@link QuickFixError} (`fixErrorName: 'SessionNotFound'`).
- *
- * @param message The message to send.
- * @param sessionID The destination session.
- * @returns A Promise resolving to `true` if the message was accepted for sending.
- *
- * @example
- * ```ts
- * import { sendToTarget, createMessage, SessionID, FIELD, MsgType } from '@homaiohq/napi-quickfix';
- * const order = createMessage({ [FIELD.MsgType]: MsgType.NewOrderSingle });
- * await sendToTarget(order, new SessionID('FIX.4.4', 'CLIENT', 'BROKER'));
- * ```
- */
-function sendToTarget(message, sessionID) {
-    return native_js_1.native.sendToTarget(message.nativeHandle, sessionID.nativeHandle);
+Object.defineProperty(exports, "OrdType", { enumerable: true, get: function () { return enums_js_1.OrdType; } });
+Object.defineProperty(exports, "TimeInForce", { enumerable: true, get: function () { return enums_js_1.TimeInForce; } });
+function sendToTarget(message, sessionIDOrQualifier) {
+    // Dispatch on the primitive, not `instanceof SessionID`: this package ships
+    // ESM and CJS builds, and a SessionID created by the other build is a
+    // different class with the same shape (see toNativeSessionID). Anything
+    // else is a TypeError here rather than an `undefined` target the native
+    // layer would read as "route by the message header".
+    const target = typeof sessionIDOrQualifier === 'string' || sessionIDOrQualifier === undefined
+        ? sessionIDOrQualifier
+        : (0, session_id_js_1.toNativeSessionID)(sessionIDOrQualifier, 'sessionID');
+    return native_js_1.native.sendToTarget(message.nativeHandle, target);
 }
 /** The QuickFIX engine / addon version string. */
 const version = () => native_js_1.native.version();
@@ -70,4 +73,3 @@ exports.version = version;
  */
 const quickfixParseMsgType = (raw) => native_js_1.native.quickfixParseMsgType(raw);
 exports.quickfixParseMsgType = quickfixParseMsgType;
-//# sourceMappingURL=index.js.map

package/dist/cjs/initiator.d.ts

@@ -27,4 +27,3 @@ export declare class Initiator extends Engine {
     /** @param options Engine options. */
     constructor(options: EngineOptions);
 }
-//# sourceMappingURL=initiator.d.ts.map

package/dist/cjs/initiator.js

@@ -36,4 +36,3 @@ class Initiator extends engine_js_1.Engine {
     }
 }
 exports.Initiator = Initiator;
-//# sourceMappingURL=initiator.js.map