@homaiohq/napi-quickfix 0.1.0 → 0.3.0

package/dist/esm/enums.d.ts

@@ -1,22 +1,56 @@
+/**
+ * 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.
+ * - value groups such as {@link MsgType} and {@link Side} (e.g.
+ *   `MsgType.Logon === 'A'`, `Side.Buy === '1'`) — one per field, generated from
+ *   QuickFIX's `FixValues.h` (see `src/generated/values.ts`), so every
+ *   `FIX::<Field>_<VALUE>` constant is here. {@link VALUES} holds all of them
+ *   keyed by field name, and each group is also importable from
+ *   `@homaiohq/napi-quickfix/values` without loading the native addon.
+ *
+ * Everything carries literal types and is frozen, so a misspelt name is a
+ * compile error and 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 { type ValueGroups } from './generated/values.js';
 export { FIELD, type FieldName } from './generated/fields.js';
-/** A single group of FIX constants (name → value). */
+export { VALUES, MsgType, Side, OrdType, TimeInForce, type ValueGroups, type ValueGroupName, } from './generated/values.js';
+/**
+ * A single group of FIX constants widened to a string-indexed map (name → value).
+ *
+ * Every value group and {@link FIELD} is assignable to it, so use it where a group
+ * is looked up by a `string` key the compiler cannot narrow (a name read from
+ * configuration, say) instead of the literally-typed group itself:
+ *
+ * @example
+ * ```ts
+ * const group: EnumGroup = enums[name as ValueGroupName];
+ * const code = group[valueName];
+ * ```
+ */
 export type EnumGroup = Readonly<Record<string, number | string>>;
-/** The full, frozen tree of FIX constants. */
-export type Enums = Readonly<Record<string, EnumGroup>>;
+/**
+ * The full, frozen tree of FIX constants: every value group of {@link ValueGroups}
+ * plus the {@link FIELD} tag table.
+ */
+export type Enums = ValueGroups & {
+    readonly FIELD: typeof FIELD;
+};
 /**
  * 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.
+ * `enums.FIELD` is the same table as {@link FIELD}; every other member is the
+ * same object as the corresponding {@link VALUES} group.
  */
 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.js

@@ -3,13 +3,16 @@
  *
  * - {@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'`).
+ *   so it carries every `FIX::FIELD::*` name the bundled engine knows.
+ * - value groups such as {@link MsgType} and {@link Side} (e.g.
+ *   `MsgType.Logon === 'A'`, `Side.Buy === '1'`) — one per field, generated from
+ *   QuickFIX's `FixValues.h` (see `src/generated/values.ts`), so every
+ *   `FIX::<Field>_<VALUE>` constant is here. {@link VALUES} holds all of them
+ *   keyed by field name, and each group is also importable from
+ *   `@homaiohq/napi-quickfix/values` without loading the native addon.
  *
- * Everything is frozen at the TS layer so consumers cannot mutate the shared
- * constant tables.
+ * Everything carries literal types and is frozen, so a misspelt name is a
+ * compile error and consumers cannot mutate the shared constant tables.
  *
  * @example
  * ```ts
@@ -19,27 +22,14 @@
  * ```
  */
 import { FIELD } from './generated/fields.js';
-import { native } from './native.js';
+import { VALUES } from './generated/values.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);
-}
+export { VALUES, MsgType, Side, OrdType, TimeInForce, } from './generated/values.js';
 /**
  * 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.
+ * `enums.FIELD` is the same table as {@link FIELD}; every other member is the
+ * same object as the corresponding {@link VALUES} group.
  */
-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
+export const enums = /* @__PURE__ */ Object.freeze({ ...VALUES, FIELD });

package/dist/esm/field-value.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wire formatting of the `string | number` field values `Message` and `Group`
+ * accept.
+ */
+/**
+ * A field value as FIX text. Strings pass through. A number keeps its shortest
+ * round-trip digits but is written without exponent notation, which FIX numeric
+ * fields do not allow (`1e-7` → `'0.0000001'`, `1e21` →
+ * `'1000000000000000000000'`, where `String` gives `'1e-7'` and `'1e+21'`).
+ * @throws `RangeError` for `NaN` and `±Infinity`, which have no FIX form.
+ */
+export declare function formatFieldValue(value: string | number): string;

package/dist/esm/field-value.js

@@ -0,0 +1,37 @@
+/**
+ * Wire formatting of the `string | number` field values `Message` and `Group`
+ * accept.
+ */
+/**
+ * A field value as FIX text. Strings pass through. A number keeps its shortest
+ * round-trip digits but is written without exponent notation, which FIX numeric
+ * fields do not allow (`1e-7` → `'0.0000001'`, `1e21` →
+ * `'1000000000000000000000'`, where `String` gives `'1e-7'` and `'1e+21'`).
+ * @throws `RangeError` for `NaN` and `±Infinity`, which have no FIX form.
+ */
+export function formatFieldValue(value) {
+    if (typeof value !== 'number') {
+        return String(value);
+    }
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`field value must be a finite number, got ${value}`);
+    }
+    const text = String(value);
+    const e = text.indexOf('e');
+    if (e === -1) {
+        return text;
+    }
+    // `[-]d[.ddd]e±n`: move the decimal point of the mantissa n places.
+    const sign = value < 0 ? '-' : '';
+    const mantissa = text.slice(sign.length, e);
+    const point = mantissa.indexOf('.');
+    const digits = mantissa.replace('.', '');
+    const at = (point === -1 ? mantissa.length : point) + Number(text.slice(e + 1));
+    if (at <= 0) {
+        return `${sign}0.${'0'.repeat(-at)}${digits}`;
+    }
+    if (at >= digits.length) {
+        return `${sign}${digits}${'0'.repeat(at - digits.length)}`;
+    }
+    return `${sign}${digits.slice(0, at)}.${digits.slice(at)}`;
+}

package/dist/esm/generated/fields.d.ts

@@ -6120,4 +6120,3 @@ export declare const FIELD: Readonly<{
 }>;
 /** Every field name known to the bundled QuickFIX, e.g. `"MsgType"`. */
 export type FieldName = keyof typeof FIELD;
-//# sourceMappingURL=fields.d.ts.map

package/dist/esm/generated/fields.js

@@ -6122,4 +6122,3 @@ export const FIELD = /* @__PURE__ */ Object.freeze({
     BatchTotalMessages: 50001,
     BatchProcessMode: 50002,
 });
-//# sourceMappingURL=fields.js.map