@huskly/ibkr-client 0.2.0

package/README.md

@@ -0,0 +1,112 @@
+# IBKR CLI (`@huskly/ibkr-client`)
+
+A terminal trading CLI for the **Interactive Brokers Web API**, authenticating
+over **OAuth 1.0a** (no Client Portal Gateway required). Built to mirror the
+architecture of [huskly-cli](https://github.com/felipecsl/huskly-cli) so the two
+can merge into a single multi-broker CLI (IBKR + Schwab) over time.
+
+The OAuth 1.0a live-session-token handshake is performed by the
+[`ibkr-client`](https://github.com/art1c0/ibkr-client) package. See the
+[`ibind` OAuth 1.0a wiki](https://github.com/Voyz/ibind/wiki/OAuth-1.0a) for how
+the keys below are generated and registered in the IBKR self-service portal.
+
+## Layout
+
+The repo is split into a reusable **library** and a thin **CLI**, mirroring
+huskly-cli's `@huskly/schwab-client` + CLI split:
+
+| Path                     | Purpose                                                                  |
+| ------------------------ | ------------------------------------------------------------------------ |
+| `src/types.ts`           | Broker-neutral `BrokerClient` interface + domain types (the merge contract) |
+| `src/ibkr/ibkrClient.ts` | `IbkrClient` — typed wrapper over `ibkr-client` implementing `BrokerClient` |
+| `src/ibkr/oauthConfig.ts`| Builds the OAuth config from `.pem` files + env vars                      |
+| `src/ibkr/dhPrime.ts`    | Extracts the DH prime (hex) from `dhparam.pem`                            |
+| `src/cli/`               | `commander` program, `--broker` flag, and command handlers               |
+
+The `*.pem` files (`private_signature.pem`, `private_encryption.pem`,
+`dhparam.pem`, plus the public keys) are the cryptographic material from the
+wiki setup step and are git-ignored.
+
+## Setup
+
+```bash
+npm install
+```
+
+Provide the account-specific secrets, either by copying the template:
+
+```bash
+cp .env.example .env
+# then edit .env
+```
+
+or by exporting them in your shell:
+
+```bash
+export IBIND_OAUTH1A_CONSUMER_KEY=...        # 9-char consumer key from IBKR
+export IBIND_OAUTH1A_ACCESS_TOKEN=...        # access token from the portal
+export IBIND_OAUTH1A_ACCESS_TOKEN_SECRET=... # access token secret from the portal
+```
+
+Optional environment variables:
+
+- `IBIND_OAUTH1A_REALM` — OAuth realm (defaults to `limited_poa` for the
+  individual self-service flow).
+- `IBKR_KEYS_DIR` — directory holding the `.pem` files (defaults to the current
+  working directory).
+- `IBKR_ACCOUNT_ID` — target a specific account (otherwise the first is used).
+
+## Usage
+
+Run in development (via `tsx`, no build step):
+
+```bash
+npm run dev -- account
+npm run dev -- positions
+npm run dev -- positions AAPL          # filter by symbol
+npm run dev -- positions --type EQUITY # filter by asset type
+npm run dev -- positions --csv         # CSV instead of a table
+```
+
+Or build and use the `ibkr-cli` binary:
+
+```bash
+npm run build
+node dist/cli/index.js account
+```
+
+A global `--broker <ibkr|schwab>` flag (default `ibkr`) selects the broker.
+Only IBKR is implemented today; `schwab` is reserved for the huskly-cli merge.
+
+Example output:
+
+```
+💰 Account Summary
+
+Authenticated: yes   Competing: no
+Account:       U********
+──────────────────────────────────────────────────
+Net Liquidation:  $123,456.78
+Available Funds:  $...
+...
+```
+
+## Development
+
+```bash
+npm run lint          # eslint
+npm run format        # prettier --write
+npm run typecheck     # tsc --noEmit
+npm run build         # tsc -> dist/
+npm run check         # lint + format:check + typecheck
+```
+
+CI (`.github/workflows/ci.yml`) runs lint, format check, typecheck, and build on
+every push and pull request, plus [gitleaks](https://github.com/gitleaks/gitleaks)
+to guard against committed secrets.
+
+## Security notes
+
+- The private keys and `.env` are git-ignored — do not commit them.
+- Credentials are read from the environment, never hardcoded.
+- CI scans every change with gitleaks to catch accidentally committed secrets.

package/dist/cli/account.d.ts

@@ -0,0 +1,7 @@
+import type { BrokerName } from "../types.js";
+/**
+ * Show auth status and account balances.
+ * Ports the account-summary portion of main.py's main().
+ */
+export declare function handleAccount(broker: BrokerName): Promise<void>;
+//# sourceMappingURL=account.d.ts.map

package/dist/cli/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/cli/account.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrE"}

package/dist/cli/account.js

@@ -0,0 +1,27 @@
+import chalk from "chalk";
+import { apiClient } from "./shared.js";
+import { fmtMoney } from "../format.js";
+/**
+ * Show auth status and account balances.
+ * Ports the account-summary portion of main.py's main().
+ */
+export async function handleAccount(broker) {
+    const api = await apiClient(broker);
+    const auth = await api.getAuthStatus();
+    const accountId = await api.getAccountId();
+    const balances = await api.getAccountBalances();
+    console.log(chalk.bold("\n💰 Account Summary\n"));
+    console.log(chalk.gray("Authenticated: ") +
+        (auth.authenticated ? chalk.green("yes") : chalk.red("no")) +
+        chalk.gray("   Competing: ") +
+        (auth.competing ? chalk.red("yes") : chalk.green("no")));
+    console.log(chalk.gray("Account:       ") + chalk.cyan(accountId));
+    console.log(chalk.gray("─".repeat(50)));
+    console.log(`Net Liquidation:  ${chalk.green(fmtMoney(balances.netLiquidation))}`);
+    console.log(`Available Funds:  ${chalk.blue(fmtMoney(balances.availableFunds))}`);
+    console.log(`Buying Power:     ${chalk.magenta(fmtMoney(balances.buyingPower))}`);
+    console.log(`Cash Balance:     ${chalk.yellow(fmtMoney(balances.cashBalance))}`);
+    console.log(chalk.gray("─".repeat(50)));
+    console.log();
+}
+//# sourceMappingURL=account.js.map

package/dist/cli/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/cli/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAkB;IACpD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,kBAAkB,EAAE,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC3B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC5B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import { handleAccount } from "./account.js";
+import { handlePositions } from "./positions.js";
+import { handleQuote } from "./quote.js";
+import { handleOrders } from "./orders.js";
+import { resolveBroker } from "./shared.js";
+const program = new Command();
+program
+    .name("ibkr-cli")
+    .description("Terminal-based trading tools for Interactive Brokers (and, later, Schwab)")
+    .version("0.1.0")
+    .option("--broker <name>", "Broker to use: ibkr or schwab", "ibkr");
+/** The resolved broker from the global --broker option. */
+const broker = () => resolveBroker(program.opts().broker);
+program
+    .command("account")
+    .description("Show account balances and authentication status")
+    .action(async () => {
+    await handleAccount(broker());
+});
+program
+    .command("positions")
+    .description("Show account positions, optionally filtered by symbol or type")
+    .argument("[symbol]", "Optional symbol to filter positions")
+    .option("-t, --type <type>", "Filter by asset type (e.g., OPTION, EQUITY)")
+    .option("--csv", "Output in CSV format instead of table")
+    .action(async (symbol, options) => {
+    await handlePositions(broker(), symbol, options);
+});
+program
+    .command("quote")
+    .description("Get current price quotes for one or more symbols (not implemented yet)")
+    .argument("<symbols...>", "Symbols to quote")
+    .action((symbols) => {
+    handleQuote(broker(), symbols);
+});
+program
+    .command("orders")
+    .description("List account orders (not implemented yet)")
+    .action(() => {
+    handleOrders(broker());
+});
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(chalk.red("Error:"), message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,2EAA2E,CAAC;KACxF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,CAAC,CAAC;AAEtE,2DAA2D;AAC3D,MAAM,MAAM,GAAG,GAAqC,EAAE,CACpD,aAAa,CAAC,OAAO,CAAC,IAAI,EAAuB,CAAC,MAAM,CAAC,CAAC;AAE5D,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,QAAQ,CAAC,UAAU,EAAE,qCAAqC,CAAC;KAC3D,MAAM,CAAC,mBAAmB,EAAE,6CAA6C,CAAC;KAC1E,MAAM,CAAC,OAAO,EAAE,uCAAuC,CAAC;KACxD,MAAM,CAAC,KAAK,EAAE,MAA0B,EAAE,OAAyC,EAAE,EAAE;IACtF,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,wEAAwE,CAAC;KACrF,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;KAC5C,MAAM,CAAC,CAAC,OAAiB,EAAE,EAAE;IAC5B,WAAW,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,GAAG,EAAE;IACX,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/orders.d.ts

@@ -0,0 +1,4 @@
+import type { BrokerName } from "../types.js";
+/** Stub — order history is not implemented for IBKR yet. */
+export declare function handleOrders(_broker: BrokerName): void;
+//# sourceMappingURL=orders.d.ts.map

package/dist/cli/orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/cli/orders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEtD"}

package/dist/cli/orders.js

@@ -0,0 +1,5 @@
+/** Stub — order history is not implemented for IBKR yet. */
+export function handleOrders(_broker) {
+    throw new Error("`orders` is not implemented yet for IBKR.");
+}
+//# sourceMappingURL=orders.js.map

package/dist/cli/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../src/cli/orders.ts"],"names":[],"mappings":"AAEA,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,OAAmB;IAC9C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AAC/D,CAAC"}

package/dist/cli/positions.d.ts

@@ -0,0 +1,12 @@
+import type { BrokerName } from "../types.js";
+interface PositionsOptions {
+    type?: string;
+    csv?: boolean;
+}
+/**
+ * Show account positions as a table (or CSV).
+ * Ports render_positions() from main.py.
+ */
+export declare function handlePositions(broker: BrokerName, symbol: string | undefined, options: PositionsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=positions.d.ts.map

package/dist/cli/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../src/cli/positions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAE9D,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AA6BD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/cli/positions.js

@@ -0,0 +1,106 @@
+import chalk from "chalk";
+import { apiClient } from "./shared.js";
+import { fmtMoney, fmtPct, pad, pnlColor } from "../format.js";
+const HEADERS = [
+    "Symbol",
+    "Type",
+    "Long",
+    "Short",
+    "Avg Price",
+    "Cur Price",
+    "Mkt Value",
+    "Day P/L",
+    "P/L Open",
+    "P/L %",
+];
+/** Columns 0 (Symbol) and 1 (Type) are left-aligned; the rest right-aligned. */
+const LEFT_ALIGNED = new Set([0, 1]);
+/** Open P/L as a fraction of cost basis (marketValue net of open P/L). */
+function plPercent(pos) {
+    const costBasis = pos.marketValue - pos.openProfitLoss;
+    return costBasis ? (pos.openProfitLoss / costBasis) * 100 : null;
+}
+/** Escape a value for CSV output. */
+function escapeCsv(value) {
+    return /[",\n]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+/**
+ * Show account positions as a table (or CSV).
+ * Ports render_positions() from main.py.
+ */
+export async function handlePositions(broker, symbol, options) {
+    const api = await apiClient(broker);
+    let positions = await api.getPositions(symbol);
+    if (options.type) {
+        const upper = options.type.toUpperCase();
+        positions = positions.filter((p) => p.assetType.toUpperCase() === upper);
+    }
+    positions = positions.sort((a, b) => a.symbol.localeCompare(b.symbol));
+    if (options.csv) {
+        renderCsv(positions);
+        return;
+    }
+    renderTable(symbol, options.type, positions);
+}
+function renderCsv(positions) {
+    if (positions.length === 0)
+        return;
+    console.log(HEADERS.join(","));
+    for (const p of positions) {
+        const pct = plPercent(p);
+        console.log([
+            escapeCsv(p.symbol),
+            escapeCsv(p.assetType),
+            p.longQuantity || "",
+            p.shortQuantity || "",
+            p.averagePrice.toFixed(2),
+            p.marketPrice.toFixed(2),
+            p.marketValue.toFixed(2),
+            p.currentDayProfitLoss.toFixed(2),
+            p.openProfitLoss.toFixed(2),
+            pct === null ? "" : pct.toFixed(2),
+        ].join(","));
+    }
+}
+function renderTable(symbol, type, positions) {
+    const filters = [symbol?.toUpperCase(), type?.toUpperCase()].filter(Boolean);
+    const filterText = filters.length ? `: ${filters.join(", ")}` : "";
+    console.log(chalk.bold(`\nAccount Positions${filterText}\n`));
+    if (positions.length === 0) {
+        console.log(chalk.yellow("  (no open positions)"));
+        return;
+    }
+    // Each cell is [text, colorFn]; colorize after width is measured on raw text.
+    const rows = positions.map((p) => {
+        const pct = plPercent(p);
+        return [
+            [p.symbol, chalk.cyan],
+            [p.assetType, chalk.white],
+            [p.longQuantity > 0 ? String(p.longQuantity) : "-", chalk.green],
+            [p.shortQuantity > 0 ? String(p.shortQuantity) : "-", chalk.red],
+            [fmtMoney(p.averagePrice), chalk.white],
+            [fmtMoney(p.marketPrice), chalk.white],
+            [fmtMoney(p.marketValue), pnlColor(p.marketValue)],
+            [fmtMoney(p.currentDayProfitLoss, true), pnlColor(p.currentDayProfitLoss)],
+            [fmtMoney(p.openProfitLoss, true), pnlColor(p.openProfitLoss)],
+            [fmtPct(pct), pnlColor(pct)],
+        ];
+    });
+    const widths = HEADERS.map((h) => h.length);
+    for (const row of rows) {
+        row.forEach(([text], i) => {
+            widths[i] = Math.max(widths[i] ?? 0, text.length);
+        });
+    }
+    const align = (i) => (LEFT_ALIGNED.has(i) ? "left" : "right");
+    const gap = "  ";
+    const headerLine = HEADERS.map((h, i) => chalk.dim(pad(h, widths[i] ?? 0, align(i)))).join(gap);
+    const totalWidth = widths.reduce((sum, w) => sum + w, 0) + gap.length * (widths.length - 1);
+    console.log(headerLine);
+    console.log(chalk.dim("-".repeat(totalWidth)));
+    for (const row of rows) {
+        console.log(row.map(([text, color], i) => color(pad(text, widths[i] ?? 0, align(i)))).join(gap));
+    }
+    console.log();
+}
+//# sourceMappingURL=positions.js.map

package/dist/cli/positions.js.map

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

package/dist/cli/quote.d.ts

@@ -0,0 +1,4 @@
+import type { BrokerName } from "../types.js";
+/** Stub — market-data quotes are not implemented for IBKR yet. */
+export declare function handleQuote(_broker: BrokerName, _symbols: string[]): void;
+//# sourceMappingURL=quote.d.ts.map

package/dist/cli/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../src/cli/quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAEzE"}

package/dist/cli/quote.js

@@ -0,0 +1,5 @@
+/** Stub — market-data quotes are not implemented for IBKR yet. */
+export function handleQuote(_broker, _symbols) {
+    throw new Error("`quote` is not implemented yet for IBKR.");
+}
+//# sourceMappingURL=quote.js.map

package/dist/cli/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../src/cli/quote.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,OAAmB,EAAE,QAAkB;IACjE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC9D,CAAC"}

package/dist/cli/shared.d.ts

@@ -0,0 +1,12 @@
+import type { BrokerClient, BrokerName } from "../types.js";
+/**
+ * Resolve an authenticated {@link BrokerClient} for the requested broker.
+ *
+ * Today only IBKR is implemented. The `schwab` branch is intentionally a
+ * placeholder: when this is merged into huskly-cli it will return a thin
+ * adapter over huskly's existing `SchwabClient`, satisfying the same interface.
+ */
+export declare function apiClient(broker?: BrokerName): Promise<BrokerClient>;
+/** Resolve the broker from a Commander option, validating the value. */
+export declare function resolveBroker(value: string | undefined): BrokerName;
+//# sourceMappingURL=shared.d.ts.map

package/dist/cli/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/cli/shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,MAAM,GAAE,UAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAclF;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAMnE"}

package/dist/cli/shared.js

@@ -0,0 +1,31 @@
+import { IbkrClient } from "../ibkr/ibkrClient.js";
+import { buildOauthConfig } from "../ibkr/oauthConfig.js";
+/**
+ * Resolve an authenticated {@link BrokerClient} for the requested broker.
+ *
+ * Today only IBKR is implemented. The `schwab` branch is intentionally a
+ * placeholder: when this is merged into huskly-cli it will return a thin
+ * adapter over huskly's existing `SchwabClient`, satisfying the same interface.
+ */
+export async function apiClient(broker = "ibkr") {
+    switch (broker) {
+        case "ibkr": {
+            const client = new IbkrClient(buildOauthConfig());
+            await client.init();
+            return client;
+        }
+        case "schwab":
+            throw new Error("Broker 'schwab' is not supported yet. It will be wired up when this CLI is merged into huskly-cli.");
+        default:
+            throw new Error(`Unknown broker: ${String(broker)}`);
+    }
+}
+/** Resolve the broker from a Commander option, validating the value. */
+export function resolveBroker(value) {
+    const broker = (value ?? "ibkr").toLowerCase();
+    if (broker !== "ibkr" && broker !== "schwab") {
+        throw new Error(`Invalid --broker '${broker}'. Expected 'ibkr' or 'schwab'.`);
+    }
+    return broker;
+}
+//# sourceMappingURL=shared.js.map

package/dist/cli/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/cli/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAqB,MAAM;IACzD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAClD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,QAAQ;YACX,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,MAAM,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,iCAAiC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Terminal formatting helpers, ported from main.py (fmt_money / fmt_pct /
+ * P&L coloring), using chalk instead of raw ANSI codes.
+ */
+/** Format a dollar amount. `signed` forces a leading +/- (for P&L). */
+export declare function fmtMoney(value: number | null | undefined, signed?: boolean): string;
+/** Format a percentage with an explicit +/- sign. */
+export declare function fmtPct(value: number | null | undefined): string;
+/** Green for non-negative P&L, red for losses. */
+export declare function pnlColor(value: number | null | undefined): (text: string) => string;
+/** Pad `text` into `width`, left- or right-aligned. */
+export declare function pad(text: string, width: number, align?: "left" | "right"): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,UAAQ,GAAG,MAAM,CAQjF;AAED,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAI/D;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAEnF;AAED,uDAAuD;AACvD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,OAAgB,GAAG,MAAM,CAEzF"}

package/dist/format.js

@@ -0,0 +1,32 @@
+import chalk from "chalk";
+/**
+ * Terminal formatting helpers, ported from main.py (fmt_money / fmt_pct /
+ * P&L coloring), using chalk instead of raw ANSI codes.
+ */
+/** Format a dollar amount. `signed` forces a leading +/- (for P&L). */
+export function fmtMoney(value, signed = false) {
+    if (value === null || value === undefined)
+        return "-";
+    const sign = value < 0 ? "-" : signed ? "+" : "";
+    const abs = Math.abs(value).toLocaleString("en-US", {
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    });
+    return `${sign}$${abs}`;
+}
+/** Format a percentage with an explicit +/- sign. */
+export function fmtPct(value) {
+    if (value === null || value === undefined)
+        return "-";
+    const sign = value < 0 ? "-" : "+";
+    return `${sign}${Math.abs(value).toFixed(2)}%`;
+}
+/** Green for non-negative P&L, red for losses. */
+export function pnlColor(value) {
+    return (value ?? 0) < 0 ? chalk.red : chalk.green;
+}
+/** Pad `text` into `width`, left- or right-aligned. */
+export function pad(text, width, align = "left") {
+    return align === "right" ? text.padStart(width) : text.padEnd(width);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AAEH,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,KAAgC,EAAE,MAAM,GAAG,KAAK;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACtD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE;QAClD,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,MAAM,CAAC,KAAgC;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACtD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACnC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACjD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,KAAgC;IACvD,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,QAA0B,MAAM;IAC/E,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,11 @@
+/** Small shared utilities. */
+/** Throw if a value is null/undefined, otherwise narrow it to non-nullable. */
+export declare function ensure<T>(value: T | null | undefined, message?: string): T;
+/**
+ * IBKR asset-class codes -> human-readable type labels.
+ * Ported from main.py's ASSET_CLASS_LABELS.
+ */
+export declare const ASSET_CLASS_LABELS: Record<string, string>;
+/** Coerce an unknown (string | number | null) into a number, defaulting to 0. */
+export declare function toNumber(value: unknown): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,+EAA+E;AAC/E,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAK1E;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUrD,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO/C"}

package/dist/helpers.js

@@ -0,0 +1,34 @@
+/** Small shared utilities. */
+/** Throw if a value is null/undefined, otherwise narrow it to non-nullable. */
+export function ensure(value, message) {
+    if (value === null || value === undefined) {
+        throw new Error(message ?? "Expected value to be non-null/non-undefined");
+    }
+    return value;
+}
+/**
+ * IBKR asset-class codes -> human-readable type labels.
+ * Ported from main.py's ASSET_CLASS_LABELS.
+ */
+export const ASSET_CLASS_LABELS = {
+    STK: "EQUITY",
+    OPT: "OPTION",
+    FOP: "FUTURES OPTION",
+    FUT: "FUTURE",
+    FUND: "COLLECTIVE_INVESTMENT",
+    BOND: "BOND",
+    WAR: "WARRANT",
+    CASH: "FOREX",
+    CFD: "CFD",
+};
+/** Coerce an unknown (string | number | null) into a number, defaulting to 0. */
+export function toNumber(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "string") {
+        const n = parseFloat(value);
+        return Number.isNaN(n) ? 0 : n;
+    }
+    return 0;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,+EAA+E;AAC/E,MAAM,UAAU,MAAM,CAAI,KAA2B,EAAE,OAAgB;IACrE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,6CAA6C,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/ibkr/dhPrime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extract the Diffie-Hellman prime (hex) from a dhparam.pem.
+ *
+ * IBKR's OAuth 1.0a live-session-token exchange (via `ibkr-client`) needs the DH
+ * prime as a continuous hex string — it does `BigInt('0x' + dhPrime)`. Ports
+ * dh_prime.py from the Python PoC, but parses the PEM's ASN.1 DER directly
+ * instead of shelling out to `openssl`.
+ *
+ * A DH parameters structure is: SEQUENCE { INTEGER prime, INTEGER generator }.
+ * We read the first INTEGER and return it as lowercase hex.
+ */
+export declare function extractDhPrime(pem: string): string;
+//# sourceMappingURL=dhPrime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dhPrime.d.ts","sourceRoot":"","sources":["../../src/ibkr/dhPrime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBlD"}

package/dist/ibkr/dhPrime.js

@@ -0,0 +1,44 @@
+/**
+ * Extract the Diffie-Hellman prime (hex) from a dhparam.pem.
+ *
+ * IBKR's OAuth 1.0a live-session-token exchange (via `ibkr-client`) needs the DH
+ * prime as a continuous hex string — it does `BigInt('0x' + dhPrime)`. Ports
+ * dh_prime.py from the Python PoC, but parses the PEM's ASN.1 DER directly
+ * instead of shelling out to `openssl`.
+ *
+ * A DH parameters structure is: SEQUENCE { INTEGER prime, INTEGER generator }.
+ * We read the first INTEGER and return it as lowercase hex.
+ */
+/** Read an ASN.1 DER length field at `offset`. Returns the value length and header size. */
+function readLength(der, offset) {
+    const first = der[offset] ?? 0;
+    if (first < 0x80)
+        return { length: first, headerLen: 1 };
+    const numBytes = first & 0x7f;
+    let length = 0;
+    for (let i = 1; i <= numBytes; i++) {
+        length = (length << 8) | (der[offset + i] ?? 0);
+    }
+    return { length, headerLen: 1 + numBytes };
+}
+export function extractDhPrime(pem) {
+    const base64 = pem.replace(/-----[^-]+-----/g, "").replace(/\s+/g, "");
+    const der = Buffer.from(base64, "base64");
+    let offset = 0;
+    if (der[offset] !== 0x30) {
+        throw new Error("Invalid dhparam.pem: expected an ASN.1 SEQUENCE");
+    }
+    offset += 1 + readLength(der, offset + 1).headerLen; // skip SEQUENCE tag + length
+    if (der[offset] !== 0x02) {
+        throw new Error("Invalid dhparam.pem: expected an INTEGER (the prime)");
+    }
+    offset += 1;
+    const { length, headerLen } = readLength(der, offset);
+    offset += headerLen;
+    let prime = der.subarray(offset, offset + length);
+    // Strip the leading sign byte DER adds to keep the integer positive.
+    if (prime[0] === 0x00)
+        prime = prime.subarray(1);
+    return prime.toString("hex");
+}
+//# sourceMappingURL=dhPrime.js.map

package/dist/ibkr/dhPrime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dhPrime.js","sourceRoot":"","sources":["../../src/ibkr/dhPrime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,4FAA4F;AAC5F,SAAS,UAAU,CAAC,GAAW,EAAE,MAAc;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;IAC9B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE1C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,6BAA6B;IAElF,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,CAAC,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,IAAI,SAAS,CAAC;IAEpB,IAAI,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAClD,qEAAqE;IACrE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}