@homaiohq/napi-quickfix 0.0.0-stage → 0.1.0

package/dist/esm/engine.js

@@ -0,0 +1,134 @@
+/**
+ * Shared implementation for {@link Initiator} and {@link Acceptor}.
+ *
+ * Both are thin subclasses of {@link Engine} that differ only in which native
+ * constructor they instantiate.
+ */
+import { EventEmitter } from 'node:events';
+import { Message } from './message.js';
+import { SessionID } from './session-id.js';
+/**
+ * Base class for the FIX session engines.
+ *
+ * Extends Node's {@link EventEmitter}: in addition to invoking your `handlers`,
+ * the engine emits an observe-only event for each callback
+ * (`'create' | 'logon' | 'logout' | 'toAdmin' | 'fromAdmin' | 'toApp' | 'fromApp'`).
+ *
+ * **Important:** mutation of outbound messages and rejection of inbound ones
+ * MUST be done in `handlers` (which run synchronously and can throw); event
+ * listeners run after and cannot affect the message or reject it.
+ */
+export class Engine extends EventEmitter {
+    /** @internal Underlying native engine handle. */
+    #native;
+    /**
+     * @param Native The native engine constructor (`InitiatorWrap`/`AcceptorWrap`).
+     * @param options Engine options.
+     */
+    constructor(Native, options) {
+        super();
+        const userHandlers = options.handlers ?? {};
+        // Bridge native handlers: wrap native handles into TS classes, invoke the
+        // user's handler (preserving mutate/throw semantics — exceptions propagate
+        // to the native bridge, which maps them to FIX exceptions), then emit the
+        // observe-only event.
+        const nativeHandlers = {
+            onCreate: (id) => {
+                const sid = SessionID.fromNative(id);
+                userHandlers.onCreate?.(sid);
+                this.emit('create', sid);
+            },
+            onLogon: (id) => {
+                const sid = SessionID.fromNative(id);
+                userHandlers.onLogon?.(sid);
+                this.emit('logon', sid);
+            },
+            onLogout: (id) => {
+                const sid = SessionID.fromNative(id);
+                userHandlers.onLogout?.(sid);
+                this.emit('logout', sid);
+            },
+            toAdmin: (m, id) => {
+                const msg = Message.fromNative(m);
+                const sid = SessionID.fromNative(id);
+                // Handler may mutate `msg` (writes go straight to the native handle).
+                userHandlers.toAdmin?.(msg, sid);
+                this.emit('toAdmin', msg, sid);
+            },
+            toApp: (m, id) => {
+                const msg = Message.fromNative(m);
+                const sid = SessionID.fromNative(id);
+                // May mutate or throw FixReject('DoNotSend') — do NOT swallow.
+                userHandlers.toApp?.(msg, sid);
+                this.emit('toApp', msg, sid);
+            },
+            fromAdmin: (m, id) => {
+                const msg = Message.fromNative(m);
+                const sid = SessionID.fromNative(id);
+                // May throw FixReject('RejectLogon', ...) — do NOT swallow.
+                userHandlers.fromAdmin?.(msg, sid);
+                this.emit('fromAdmin', msg, sid);
+            },
+            fromApp: (m, id) => {
+                const msg = Message.fromNative(m);
+                const sid = SessionID.fromNative(id);
+                // May throw FixReject('UnsupportedMessageType', ...) — do NOT swallow.
+                userHandlers.fromApp?.(msg, sid);
+                this.emit('fromApp', msg, sid);
+            },
+        };
+        this.#native = new Native({
+            settings: options.settings.nativeHandle,
+            handlers: nativeHandlers,
+            store: options.store,
+            log: options.log,
+        });
+    }
+    /**
+     * Start the engine (begins connecting / listening).
+     *
+     * Runs off the main thread, so the Node.js event loop stays free to service
+     * the application callbacks/events the engine fires. The returned Promise
+     * resolves once startup completes.
+     *
+     * @example
+     * ```ts
+     * await initiator.start();
+     * ```
+     */
+    start() {
+        return this.#native.start();
+    }
+    /**
+     * Stop the engine.
+     *
+     * Runs off the main thread and resolves once shutdown completes, keeping the
+     * event loop free for any in-flight callbacks.
+     *
+     * @param force When `true`, aborts immediately instead of draining gracefully.
+     *
+     * @example
+     * ```ts
+     * await initiator.stop();
+     * ```
+     */
+    stop(force) {
+        return this.#native.stop(force);
+    }
+    /** Whether any session is currently logged on. */
+    isLoggedOn() {
+        return this.#native.isLoggedOn();
+    }
+    /**
+     * Keep the Node.js event loop alive while the engine is running (default once
+     * started). Pair with {@link Engine.unref} to let a short script exit.
+     */
+    ref() {
+        this.#native.ref();
+    }
+    /** Allow the process to exit even while the engine is running. */
+    unref() {
+        this.#native.unref();
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/esm/engine.js.map

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

package/dist/esm/enums.d.ts

@@ -0,0 +1,22 @@
+export { FIELD, type FieldName } from './generated/fields.js';
+/** A single group of FIX constants (name → value). */
+export type EnumGroup = Readonly<Record<string, number | string>>;
+/** The full, frozen tree of FIX constants. */
+export type Enums = Readonly<Record<string, EnumGroup>>;
+/**
+ * The complete tree of FIX constants (frozen), e.g. `enums.FIELD.MsgType`,
+ * `enums.MsgType.Logon`, `enums.Side.Buy`.
+ *
+ * `enums.FIELD` is the same table as {@link FIELD}; the value groups come from
+ * the native engine.
+ */
+export declare const enums: Enums;
+/** A group of numeric FIX constants (name → number). */
+export type NumericEnumGroup = Readonly<Record<string, number>>;
+/** A group of string-valued FIX constants (name → string), e.g. {@link MsgType}. */
+export type StringEnumGroup = Readonly<Record<string, string>>;
+/** MsgType values (strings), e.g. `MsgType.Logon === 'A'`. */
+export declare const MsgType: StringEnumGroup;
+/** Side values (strings), e.g. `Side.Buy === '1'`. */
+export declare const Side: StringEnumGroup;
+//# sourceMappingURL=enums.d.ts.map

package/dist/esm/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE9D,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAElE,8CAA8C;AAC9C,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAYxD;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE,KAEnB,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,8DAA8D;AAC9D,eAAO,MAAM,OAAO,EAAE,eAAyE,CAAC;AAEhG,sDAAsD;AACtD,eAAO,MAAM,IAAI,EAAE,eAAsE,CAAC"}

package/dist/esm/enums.js

@@ -0,0 +1,45 @@
+/**
+ * FIX constants.
+ *
+ * - {@link FIELD} — field-name → tag-number (e.g. `FIELD.MsgType === 35`).
+ *   Generated from QuickFIX's `FixFieldNumbers.h` (see `src/generated/fields.ts`),
+ *   so it carries every `FIX::FIELD::*` name the bundled engine knows, with
+ *   literal types.
+ * - value groups exported by the native engine such as {@link MsgType} and
+ *   {@link Side} (e.g. `MsgType.Logon === 'A'`, `Side.Buy === '1'`).
+ *
+ * Everything is frozen at the TS layer so consumers cannot mutate the shared
+ * constant tables.
+ *
+ * @example
+ * ```ts
+ * import { FIELD, MsgType, enums } from '@homaiohq/napi-quickfix';
+ * msg.setField(FIELD.MsgType, MsgType.Logon);
+ * const side = enums.Side.Buy;
+ * ```
+ */
+import { FIELD } from './generated/fields.js';
+import { native } from './native.js';
+export { FIELD } from './generated/fields.js';
+function deepFreeze(source) {
+    const out = {};
+    for (const key of Object.keys(source)) {
+        out[key] = Object.freeze({ ...source[key] });
+    }
+    // FIELD is already frozen (generated); reuse it rather than copying 6000+ keys.
+    out.FIELD = FIELD;
+    return Object.freeze(out);
+}
+/**
+ * The complete tree of FIX constants (frozen), e.g. `enums.FIELD.MsgType`,
+ * `enums.MsgType.Logon`, `enums.Side.Buy`.
+ *
+ * `enums.FIELD` is the same table as {@link FIELD}; the value groups come from
+ * the native engine.
+ */
+export const enums = deepFreeze((native.enums ?? {}));
+/** MsgType values (strings), e.g. `MsgType.Logon === 'A'`. */
+export const MsgType = (enums.MsgType ?? Object.freeze({}));
+/** Side values (strings), e.g. `Side.Buy === '1'`. */
+export const Side = (enums.Side ?? Object.freeze({}));
+//# sourceMappingURL=enums.js.map

package/dist/esm/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,KAAK,EAAkB,MAAM,uBAAuB,CAAC;AAQ9D,SAAS,UAAU,CAAC,MAAuD;IACzE,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,gFAAgF;IAChF,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IAClB,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAU,UAAU,CACpC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAA+D,CACnF,CAAC;AAQF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAoB,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAoB,CAAC;AAEhG,sDAAsD;AACtD,MAAM,CAAC,MAAM,IAAI,GAAoB,CAAC,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAoB,CAAC"}