@huskly/ibkr-client 0.2.0

package/dist/ibkr/ibkrApiTypes.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Raw IBKR Client Portal Web API response shapes (only the fields we read).
+ * The `ibkr-client` `request()` method returns `any`; these types let us cast
+ * once at the boundary and stay typed everywhere else.
+ *
+ * See: https://www.interactivebrokers.com/campus/ibkr-api-page/webapi-ref/
+ */
+export interface IbkrAuthStatus {
+    authenticated?: boolean;
+    competing?: boolean;
+    connected?: boolean;
+}
+export interface IbkrPortfolioAccount {
+    accountId: string;
+    type?: string;
+    currency?: string;
+}
+/** A single field in the `portfolio/{accountId}/summary` response. */
+export interface IbkrSummaryField {
+    amount?: number;
+    currency?: string;
+}
+export type IbkrPortfolioSummary = Record<string, IbkrSummaryField | undefined>;
+/** A row from `portfolio/{accountId}/positions/{page}`. */
+export interface IbkrPosition {
+    conid?: number;
+    contractDesc?: string;
+    assetClass?: string;
+    position?: number;
+    avgPrice?: number;
+    mktPrice?: number;
+    mktValue?: number;
+    multiplier?: number;
+    unrealizedPnl?: number;
+}
+/** A row from `iserver/marketdata/snapshot`. Fields are numbered strings. */
+export type IbkrMarketDataSnapshot = Record<string, string | number | undefined> & {
+    conid?: number;
+};
+/** A contract under a listing in the `trsrv/stocks` response. */
+export interface IbkrStockContract {
+    conid?: number;
+    exchange?: string;
+    isUS?: boolean;
+}
+/** A listing (one per company) in the `trsrv/stocks` response. */
+export interface IbkrStockListing {
+    name?: string;
+    assetClass?: string;
+    contracts?: IbkrStockContract[];
+}
+/** `trsrv/stocks` response: keyed by the requested symbol. */
+export type IbkrStocksResponse = Record<string, IbkrStockListing[] | undefined>;
+/** One OHLCV bar from `iserver/marketdata/history`. */
+export interface IbkrMarketDataHistoryBar {
+    o?: number;
+    c?: number;
+    h?: number;
+    l?: number;
+    v?: number;
+    t?: number;
+}
+/** `iserver/marketdata/history` response. */
+export interface IbkrMarketDataHistoryResponse {
+    symbol?: string;
+    text?: string;
+    volumeFactor?: number;
+    data?: IbkrMarketDataHistoryBar[];
+}
+//# sourceMappingURL=ibkrApiTypes.d.ts.map

package/dist/ibkr/ibkrApiTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibkrApiTypes.d.ts","sourceRoot":"","sources":["../../src/ibkr/ibkrApiTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAEhF,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC,CAAC;AAEhF,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACvC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,6CAA6C;AAC7C,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACnC"}

package/dist/ibkr/ibkrApiTypes.js

@@ -0,0 +1,9 @@
+/**
+ * Raw IBKR Client Portal Web API response shapes (only the fields we read).
+ * The `ibkr-client` `request()` method returns `any`; these types let us cast
+ * once at the boundary and stay typed everywhere else.
+ *
+ * See: https://www.interactivebrokers.com/campus/ibkr-api-page/webapi-ref/
+ */
+export {};
+//# sourceMappingURL=ibkrApiTypes.js.map

package/dist/ibkr/ibkrApiTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibkrApiTypes.js","sourceRoot":"","sources":["../../src/ibkr/ibkrApiTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/ibkr/ibkrClient.d.ts

@@ -0,0 +1,44 @@
+import type { IbkrOauth1Config } from "./oauthConfig.js";
+import type { AccountBalances, AuthStatus, BrokerClient, BrokerPosition, BrokerQuote } from "../types.js";
+/**
+ * Typed IBKR Web API client implementing the broker-neutral {@link BrokerClient}.
+ * Wraps the `ibkr-client` npm package, which performs the OAuth 1.0a
+ * live-session-token handshake. Ports the data access from the Python PoC
+ * (main.py): account summary, positions paging, and day-P/L snapshots.
+ */
+export declare class IbkrClient implements BrokerClient {
+    private readonly raw;
+    private initPromise?;
+    private accountIdPromise?;
+    constructor(config: IbkrOauth1Config);
+    /** Obtain the live session token (idempotent — safe to await repeatedly). */
+    init(): Promise<void>;
+    getAuthStatus(): Promise<AuthStatus>;
+    getAccountId(): Promise<string>;
+    getAccountBalances(): Promise<AccountBalances>;
+    getPositions(symbol?: string): Promise<BrokerPosition[]>;
+    /** Page through the positions endpoint until it stops returning rows. */
+    private fetchAllPositions;
+    /** Return { conid: day P&L }. Snapshots need a warm-up call before data lands. */
+    private fetchDayPnl;
+    private normalizePosition;
+    getQuotes(symbols: string[]): Promise<Record<string, BrokerQuote>>;
+    /** Resolve equity/ETF symbols to IBKR contracts via `trsrv/stocks`. */
+    private searchInstruments;
+    private normalizeStockListing;
+    private normalizeStockContract;
+    private resolveQuoteContract;
+    private fetchQuoteHistory;
+    private normalizeQuote;
+    private latestHistoryBar;
+    private previousHistoryBar;
+    private historyVolume;
+    private snapshotString;
+    private snapshotNumber;
+    private snapshotHasPrefix;
+    private snapshotPercent;
+    private snapshotVolume;
+    /** Typed wrapper around the raw client's untyped `request()`. */
+    private req;
+}
+//# sourceMappingURL=ibkrClient.d.ts.map

package/dist/ibkr/ibkrClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibkrClient.d.ts","sourceRoot":"","sources":["../../src/ibkr/ibkrClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,YAAY,EAEZ,cAAc,EACd,WAAW,EACZ,MAAM,aAAa,CAAC;AAsDrB;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,gBAAgB,CAAC,CAAkB;gBAE/B,MAAM,EAAE,gBAAgB;IAIpC,6EAA6E;IAC7E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASf,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAWpC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAY/B,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAc9C,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAa9D,yEAAyE;YAC3D,iBAAiB;IAc/B,kFAAkF;YACpE,WAAW;IAqBzB,OAAO,CAAC,iBAAiB;IAgBnB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAyCxE,uEAAuE;YACzD,iBAAiB;IAY/B,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,sBAAsB;YAehB,oBAAoB;YAgBpB,iBAAiB;IAkB/B,OAAO,CAAC,cAAc;IAoDtB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAmBtB,iEAAiE;YACnD,GAAG;CAQlB"}

package/dist/ibkr/ibkrClient.js

@@ -0,0 +1,351 @@
+import { createRequire } from "node:module";
+import { ASSET_CLASS_LABELS, toNumber } from "../helpers.js";
+// `ibkr-client`'s published ESM build is broken: its `import` condition points
+// at files that use extensionless relative imports, which Node's strict ESM
+// resolver rejects. Its CJS build is fine, so we deliberately load that via
+// createRequire. This is the one intentional createRequire in the package —
+// everything else imports natively as ESM. Revisit if upstream fixes their ESM.
+const require = createRequire(import.meta.url);
+const { IbkrClient: RawIbkrClientCtor } = require("ibkr-client");
+/** Live market-data snapshot field 78 = position's P&L for the current day. */
+const DAY_PNL_FIELD = "78";
+const QUOTE_FIELDS = [
+    "31", // Last
+    "55", // Symbol
+    "58", // Text
+    "70", // High
+    "71", // Low
+    "82", // Change
+    "83", // Change %
+    "84", // Bid
+    "86", // Ask
+    "87", // Formatted volume
+    "6004", // Exchange
+    "6509", // Market data availability
+    "7762", // Unformatted volume
+].join(",");
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Typed IBKR Web API client implementing the broker-neutral {@link BrokerClient}.
+ * Wraps the `ibkr-client` npm package, which performs the OAuth 1.0a
+ * live-session-token handshake. Ports the data access from the Python PoC
+ * (main.py): account summary, positions paging, and day-P/L snapshots.
+ */
+export class IbkrClient {
+    raw;
+    initPromise;
+    accountIdPromise;
+    constructor(config) {
+        this.raw = new RawIbkrClientCtor(config);
+    }
+    /** Obtain the live session token (idempotent — safe to await repeatedly). */
+    init() {
+        this.initPromise ??= (async () => {
+            await this.raw.init();
+            // IBKR is slow right after init; give the session a moment to settle.
+            await sleep(1000);
+        })();
+        return this.initPromise;
+    }
+    async getAuthStatus() {
+        const status = await this.req({
+            path: "iserver/auth/status",
+            method: "POST",
+        });
+        return {
+            authenticated: status.authenticated ?? false,
+            competing: status.competing ?? false,
+        };
+    }
+    async getAccountId() {
+        this.accountIdPromise ??= (async () => {
+            const override = process.env["IBKR_ACCOUNT_ID"];
+            if (override)
+                return override;
+            const accounts = await this.req({ path: "portfolio/accounts" });
+            const first = accounts[0];
+            if (!first)
+                throw new Error("No portfolio accounts returned by IBKR");
+            return first.accountId;
+        })();
+        return this.accountIdPromise;
+    }
+    async getAccountBalances() {
+        const accountId = await this.getAccountId();
+        const summary = await this.req({
+            path: `portfolio/${accountId}/summary`,
+        });
+        const amount = (key) => toNumber(summary[key]?.amount);
+        return {
+            netLiquidation: amount("netliquidation"),
+            availableFunds: amount("availablefunds"),
+            buyingPower: amount("buyingpower"),
+            cashBalance: amount("totalcashvalue"),
+        };
+    }
+    async getPositions(symbol) {
+        const accountId = await this.getAccountId();
+        const rows = await this.fetchAllPositions(accountId);
+        const dayPnl = await this.fetchDayPnl(rows.map((p) => String(p.conid)).filter(Boolean));
+        let positions = rows.map((p) => this.normalizePosition(p, dayPnl));
+        if (symbol) {
+            const upper = symbol.toUpperCase();
+            positions = positions.filter((p) => p.symbol.toUpperCase().includes(upper));
+        }
+        return positions;
+    }
+    /** Page through the positions endpoint until it stops returning rows. */
+    async fetchAllPositions(accountId) {
+        const out = [];
+        let page = 0;
+        for (;;) {
+            const rows = await this.req({
+                path: `portfolio/${accountId}/positions/${String(page)}`,
+            });
+            if (!rows.length)
+                break;
+            out.push(...rows);
+            page += 1;
+        }
+        return out;
+    }
+    /** Return { conid: day P&L }. Snapshots need a warm-up call before data lands. */
+    async fetchDayPnl(conids) {
+        const result = new Map();
+        if (!conids.length)
+            return result;
+        const params = { conids: conids.join(","), fields: DAY_PNL_FIELD };
+        await this.req({ path: "iserver/marketdata/snapshot", params }); // warm up
+        await sleep(2000);
+        const snapshot = await this.req({
+            path: "iserver/marketdata/snapshot",
+            params,
+        });
+        for (const row of snapshot) {
+            const raw = row[DAY_PNL_FIELD];
+            if (raw !== undefined && row.conid !== undefined) {
+                result.set(row.conid, toNumber(raw));
+            }
+        }
+        return result;
+    }
+    normalizePosition(p, dayPnl) {
+        const qty = p.position ?? 0;
+        const assetClass = p.assetClass ?? "";
+        return {
+            symbol: p.contractDesc ?? String(p.conid ?? "-"),
+            assetType: ASSET_CLASS_LABELS[assetClass] ?? (assetClass || "-"),
+            longQuantity: qty > 0 ? qty : 0,
+            shortQuantity: qty < 0 ? Math.abs(qty) : 0,
+            averagePrice: toNumber(p.avgPrice),
+            marketPrice: toNumber(p.mktPrice),
+            marketValue: toNumber(p.mktValue),
+            currentDayProfitLoss: p.conid !== undefined ? (dayPnl.get(p.conid) ?? 0) : 0,
+            openProfitLoss: toNumber(p.unrealizedPnl),
+        };
+    }
+    async getQuotes(symbols) {
+        const contracts = await Promise.all(symbols.map((symbol) => this.resolveQuoteContract(symbol)));
+        const resolvedContracts = contracts.filter((contract) => contract !== undefined);
+        if (!resolvedContracts.length)
+            return {};
+        const conids = resolvedContracts.map((contract) => contract.conid).join(",");
+        const params = { conids, fields: QUOTE_FIELDS };
+        await this.req({ path: "iserver/marketdata/snapshot", params }); // warm up
+        await sleep(2000);
+        const snapshots = await this.req({
+            path: "iserver/marketdata/snapshot",
+            params,
+        });
+        const snapshotByConid = new Map(snapshots
+            .filter((snapshot) => snapshot.conid !== undefined)
+            .map((snapshot) => [snapshot.conid, snapshot]));
+        const histories = await Promise.all(resolvedContracts.map((contract) => this.fetchQuoteHistory(contract.conid)));
+        const quotes = {};
+        for (const [index, contract] of resolvedContracts.entries()) {
+            const snapshot = snapshotByConid.get(contract.conid);
+            if (snapshot === undefined)
+                continue;
+            const history = histories[index];
+            const quote = this.normalizeQuote(contract, snapshot, history);
+            quotes[contract.requestedSymbol] = quote;
+            quotes[contract.symbol] = quote;
+        }
+        return quotes;
+    }
+    /** Resolve equity/ETF symbols to IBKR contracts via `trsrv/stocks`. */
+    async searchInstruments(symbol) {
+        const query = symbol.trim().toUpperCase();
+        if (!query)
+            return [];
+        const response = await this.req({
+            path: "trsrv/stocks",
+            params: { symbols: query },
+        });
+        return (response[query] ?? []).flatMap((listing) => this.normalizeStockListing(query, listing));
+    }
+    normalizeStockListing(symbol, listing) {
+        const assetType = listing.assetClass === "STK" ? "EQUITY" : listing.assetClass;
+        const contracts = listing.contracts ?? [];
+        if (!contracts.length) {
+            return [
+                {
+                    symbol,
+                    ...(listing.name !== undefined ? { description: listing.name } : {}),
+                    ...(assetType !== undefined ? { assetType } : {}),
+                },
+            ];
+        }
+        return contracts.map((contract) => this.normalizeStockContract(symbol, listing, contract));
+    }
+    normalizeStockContract(symbol, listing, contract) {
+        const assetType = listing.assetClass === "STK" ? "EQUITY" : listing.assetClass;
+        return {
+            symbol,
+            ...(listing.name !== undefined ? { description: listing.name } : {}),
+            ...(contract.exchange !== undefined ? { exchange: contract.exchange } : {}),
+            ...(assetType !== undefined ? { assetType } : {}),
+            ...(contract.conid !== undefined ? { brokerId: String(contract.conid) } : {}),
+        };
+    }
+    async resolveQuoteContract(symbol) {
+        const instruments = await this.searchInstruments(symbol);
+        const instrument = instruments.find((item) => item.brokerId !== undefined);
+        if (instrument?.brokerId === undefined)
+            return undefined;
+        const conid = parseInt(instrument.brokerId, 10);
+        if (Number.isNaN(conid))
+            return undefined;
+        return {
+            requestedSymbol: symbol,
+            symbol: instrument.symbol ?? symbol.toUpperCase(),
+            conid,
+            ...(instrument.description !== undefined ? { description: instrument.description } : {}),
+            ...(instrument.exchange !== undefined ? { exchange: instrument.exchange } : {}),
+        };
+    }
+    async fetchQuoteHistory(conid) {
+        try {
+            return await this.req({
+                path: "iserver/marketdata/history",
+                params: {
+                    conid: String(conid),
+                    period: "5d",
+                    bar: "1d",
+                    outsideRth: true,
+                },
+            });
+        }
+        catch {
+            return undefined;
+        }
+    }
+    normalizeQuote(contract, snapshot, history) {
+        const symbol = this.snapshotString(snapshot, "55") ?? contract.symbol;
+        const description = this.snapshotString(snapshot, "58") ?? history?.text ?? contract.description;
+        const exchange = this.snapshotString(snapshot, "6004") ?? contract.exchange;
+        const latestBar = this.latestHistoryBar(history);
+        const previousBar = this.previousHistoryBar(history);
+        const snapshotLastPrice = this.snapshotNumber(snapshot, "31");
+        const lastPrice = this.snapshotHasPrefix(snapshot, "31", "C")
+            ? (latestBar?.c ?? snapshotLastPrice)
+            : (snapshotLastPrice ?? latestBar?.c);
+        const bidPrice = this.snapshotNumber(snapshot, "84");
+        const askPrice = this.snapshotNumber(snapshot, "86");
+        const closePrice = previousBar?.c;
+        const highPrice = this.snapshotNumber(snapshot, "70") ?? latestBar?.h;
+        const lowPrice = this.snapshotNumber(snapshot, "71") ?? latestBar?.l;
+        const openPrice = latestBar?.o;
+        const netChange = this.snapshotNumber(snapshot, "82") ??
+            (lastPrice !== undefined && closePrice !== undefined ? lastPrice - closePrice : undefined);
+        const netPercentChange = this.snapshotPercent(snapshot, "83") ??
+            (netChange !== undefined && closePrice !== undefined && closePrice !== 0
+                ? (netChange / closePrice) * 100
+                : undefined);
+        const totalVolume = this.snapshotVolume(snapshot) ?? this.historyVolume(history, latestBar);
+        return {
+            symbol,
+            reference: {
+                ...(description !== undefined ? { description } : {}),
+                ...(exchange !== undefined ? { exchange, exchangeName: exchange } : {}),
+            },
+            quote: {
+                ...(lastPrice !== undefined ? { lastPrice } : {}),
+                ...(bidPrice !== undefined ? { bidPrice } : {}),
+                ...(askPrice !== undefined ? { askPrice } : {}),
+                ...(closePrice !== undefined ? { closePrice } : {}),
+                ...(highPrice !== undefined ? { highPrice } : {}),
+                ...(lowPrice !== undefined ? { lowPrice } : {}),
+                ...(openPrice !== undefined ? { openPrice } : {}),
+                ...(netChange !== undefined ? { netChange } : {}),
+                ...(netPercentChange !== undefined ? { netPercentChange } : {}),
+                ...(totalVolume !== undefined ? { totalVolume } : {}),
+            },
+        };
+    }
+    latestHistoryBar(history) {
+        return history?.data?.at(-1);
+    }
+    previousHistoryBar(history) {
+        return history?.data?.at(-2);
+    }
+    historyVolume(history, bar) {
+        if (bar?.v === undefined)
+            return undefined;
+        return bar.v * (history?.volumeFactor ?? 1);
+    }
+    snapshotString(snapshot, field) {
+        const value = snapshot[field];
+        if (value === undefined)
+            return undefined;
+        const stringValue = String(value).trim();
+        return stringValue ? stringValue : undefined;
+    }
+    snapshotNumber(snapshot, field) {
+        const value = this.snapshotString(snapshot, field);
+        if (value === undefined)
+            return undefined;
+        const cleaned = value.replace(/^[A-Z]\s*/i, "").replace(/,/g, "");
+        const parsed = parseFloat(cleaned);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    snapshotHasPrefix(snapshot, field, prefix) {
+        return this.snapshotString(snapshot, field)?.toUpperCase().startsWith(prefix) ?? false;
+    }
+    snapshotPercent(snapshot, field) {
+        const value = this.snapshotString(snapshot, field);
+        if (value === undefined)
+            return undefined;
+        const cleaned = value.replace(/[%+,]/g, "");
+        const parsed = parseFloat(cleaned);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    snapshotVolume(snapshot) {
+        const unformatted = this.snapshotNumber(snapshot, "7762");
+        if (unformatted !== undefined)
+            return unformatted;
+        const value = this.snapshotString(snapshot, "87");
+        if (value === undefined)
+            return undefined;
+        const match = /^(?<amount>[\d,.]+)\s*(?<suffix>[KMB])?$/i.exec(value);
+        const amount = match?.groups?.["amount"];
+        if (amount === undefined)
+            return undefined;
+        const parsed = parseFloat(amount.replace(/,/g, ""));
+        if (Number.isNaN(parsed))
+            return undefined;
+        const suffix = match?.groups?.["suffix"]?.toUpperCase();
+        if (suffix === "B")
+            return parsed * 1_000_000_000;
+        if (suffix === "M")
+            return parsed * 1_000_000;
+        if (suffix === "K")
+            return parsed * 1_000;
+        return parsed;
+    }
+    /** Typed wrapper around the raw client's untyped `request()`. */
+    async req(input) {
+        return (await this.raw.request(input));
+    }
+}
+//# sourceMappingURL=ibkrClient.js.map

package/dist/ibkr/ibkrClient.js.map

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

package/dist/ibkr/oauthConfig.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shape of the OAuth 1.0a config consumed by `ibkr-client`'s `IbkrClient`
+ * constructor. The package does not re-export this type, so we mirror it here.
+ */
+export interface IbkrOauth1Config {
+    accessTokenSecret: string;
+    accessToken: string;
+    consumerKey: string;
+    encryption: string;
+    signature: string;
+    dhPrime: string;
+    realm: string;
+}
+export declare function buildOauthConfig(): IbkrOauth1Config;
+//# sourceMappingURL=oauthConfig.d.ts.map

package/dist/ibkr/oauthConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthConfig.d.ts","sourceRoot":"","sources":["../../src/ibkr/oauthConfig.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAuBD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAwBnD"}

package/dist/ibkr/oauthConfig.js

@@ -0,0 +1,44 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { config as loadEnv } from "dotenv";
+import { extractDhPrime } from "./dhPrime.js";
+/**
+ * Assemble the `ibkr-client` OAuth 1.0a config from local PEM files + env vars.
+ * Ports build_client() from the Python PoC (main.py).
+ *
+ * The cryptographic material (private keys + DH params) lives as PEM files in
+ * the keys directory; the account-specific secrets come from the environment
+ * (or a local .env). `ibkr-client` expects the DH prime as a hex string, so we
+ * extract it from dhparam.pem via {@link extractDhPrime} (a pure-TS port of
+ * dh_prime.py — no openssl subprocess).
+ *
+ * The standard individual self-service OAuth flow uses the `limited_poa` realm;
+ * institutional consumers override it via IBIND_OAUTH1A_REALM.
+ */
+const DEFAULT_REALM = "limited_poa";
+const REQUIRED_ENV = [
+    "IBIND_OAUTH1A_CONSUMER_KEY",
+    "IBIND_OAUTH1A_ACCESS_TOKEN",
+    "IBIND_OAUTH1A_ACCESS_TOKEN_SECRET",
+];
+export function buildOauthConfig() {
+    loadEnv();
+    const missing = REQUIRED_ENV.filter((name) => !process.env[name]);
+    if (missing.length > 0) {
+        throw new Error(`Missing required environment variables:\n  ${missing.join("\n  ")}\n\n` +
+            "Copy .env.example to .env and fill them in (or export them).");
+    }
+    // Where the PEM key files live (defaults to the current working directory).
+    const keysDir = process.env["IBKR_KEYS_DIR"] ?? process.cwd();
+    const readPem = (file) => readFileSync(resolve(keysDir, file), "utf8");
+    return {
+        consumerKey: process.env["IBIND_OAUTH1A_CONSUMER_KEY"] ?? "",
+        accessToken: process.env["IBIND_OAUTH1A_ACCESS_TOKEN"] ?? "",
+        accessTokenSecret: process.env["IBIND_OAUTH1A_ACCESS_TOKEN_SECRET"] ?? "",
+        signature: readPem("private_signature.pem"),
+        encryption: readPem("private_encryption.pem"),
+        dhPrime: extractDhPrime(readPem("dhparam.pem")),
+        realm: process.env["IBIND_OAUTH1A_REALM"] ?? DEFAULT_REALM,
+    };
+}
+//# sourceMappingURL=oauthConfig.js.map

package/dist/ibkr/oauthConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthConfig.js","sourceRoot":"","sources":["../../src/ibkr/oauthConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgB9C;;;;;;;;;;;;GAYG;AACH,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,MAAM,YAAY,GAAG;IACnB,4BAA4B;IAC5B,4BAA4B;IAC5B,mCAAmC;CAC3B,CAAC;AAEX,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,CAAC;IAEV,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,8CAA8C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YACtE,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9D,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAEvF,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,EAAE;QAC5D,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,EAAE;QAC5D,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,IAAI,EAAE;QACzE,SAAS,EAAE,OAAO,CAAC,uBAAuB,CAAC;QAC3C,UAAU,EAAE,OAAO,CAAC,wBAAwB,CAAC;QAC7C,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC/C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,aAAa;KAC3D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/** Package entry point — the broker-neutral types and the IBKR client. */
+export { IbkrClient } from "./ibkr/ibkrClient.js";
+export { buildOauthConfig } from "./ibkr/oauthConfig.js";
+export type { AccountBalances, AuthStatus, BrokerClient, BrokerInstrument, BrokerName, BrokerPosition, BrokerQuote, BrokerQuoteData, BrokerQuoteReference, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,eAAe,EACf,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+/** Package entry point — the broker-neutral types and the IBKR client. */
+export { IbkrClient } from "./ibkr/ibkrClient.js";
+export { buildOauthConfig } from "./ibkr/oauthConfig.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}