ctrader-x 0.1.0

package/dist/example/shared/create-authenticated-client.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuthenticatedClient = createAuthenticatedClient;
+require("dotenv/config");
+const fs = __importStar(require("node:fs/promises"));
+const http = __importStar(require("node:http"));
+const path = __importStar(require("node:path"));
+const auth_1 = require("../../auth");
+const client_1 = require("../../client");
+const transport_1 = require("../../transport");
+const TOKEN_FILE_PATH = path.resolve(__dirname, '../../../.spotware-token.json');
+const REDIRECT_PORT = Number(process.env.SPOTWARE__OAUTH_REDIRECT_PORT ?? 3939);
+const REDIRECT_URI = `http://localhost:${REDIRECT_PORT}/callback`;
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required environment variable "${name}"`);
+    }
+    return value;
+}
+async function readStoredToken() {
+    try {
+        return JSON.parse(await fs.readFile(TOKEN_FILE_PATH, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeStoredToken(token) {
+    await fs.writeFile(TOKEN_FILE_PATH, JSON.stringify(token, null, 4), 'utf8');
+}
+// The authorization code only lives for ~1 minute, so this listener must already be
+// up before the user is sent to the browser, not started after.
+function waitForAuthorizationCode(port) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((request, response) => {
+            const url = new URL(request.url ?? '/', `http://localhost:${port}`);
+            const code = url.searchParams.get('code');
+            const errorParam = url.searchParams.get('error');
+            response.writeHead(200, { 'Content-Type': 'text/html' });
+            response.end(errorParam ? '<p>Authorization failed. You can close this tab.</p>' : '<p>Authorized. You can close this tab.</p>');
+            server.close();
+            if (errorParam) {
+                reject(new Error(`Authorization was denied: ${errorParam}`));
+            }
+            else if (code) {
+                resolve(code);
+            }
+            else {
+                reject(new Error('No authorization code was returned'));
+            }
+        });
+        server.listen(port);
+    });
+}
+async function obtainToken(oauthClient) {
+    const stored = await readStoredToken();
+    if (stored) {
+        console.log('Found a stored token, refreshing it (refresh tokens are single-use, so the file gets rewritten)...');
+        const refreshed = await oauthClient.refreshAccessToken({ refreshToken: stored.refreshToken });
+        await writeStoredToken(refreshed);
+        return refreshed;
+    }
+    const authorizationUrl = oauthClient.buildAuthorizationUrl({ redirectUri: REDIRECT_URI, scope: auth_1.SpotwareOAuthScope.TRADING });
+    console.log('No stored token found. Open this URL in a browser to authorize the app:\n');
+    console.log(authorizationUrl);
+    console.log(`\nWaiting for the redirect on ${REDIRECT_URI} ...`);
+    console.log(`(Make sure "${REDIRECT_URI}" is registered as a redirect URI on this app in the cTrader Open API portal.)`);
+    const code = await waitForAuthorizationCode(REDIRECT_PORT);
+    const token = await oauthClient.exchangeAuthorizationCode({ code, redirectUri: REDIRECT_URI });
+    await writeStoredToken(token);
+    return token;
+}
+// Runs on a short-lived transport just to discover which demo account is linked to this
+// token — SpotwareClient itself needs a ctidTraderAccountId up front, so this has to happen
+// before it can be constructed.
+async function discoverDemoAccountId(clientId, clientSecret, accessToken) {
+    const transport = new transport_1.SpotwareTransport({ host: transport_1.SpotwareHost.DEMO });
+    transport.on('error', (error) => console.error('Discovery transport error:', error.message));
+    await transport.connect();
+    const authenticator = new auth_1.SpotwareSocketAuthenticator(transport);
+    await authenticator.authenticateApplication(clientId, clientSecret);
+    console.log('Listing accounts linked to this token...');
+    const accounts = await authenticator.listAccounts(accessToken);
+    console.table(accounts.map((account) => ({
+        ctidTraderAccountId: account.ctidTraderAccountId,
+        isLive: account.isLive ?? false,
+        traderLogin: account.traderLogin
+    })));
+    const demoAccount = accounts.find((account) => !account.isLive);
+    if (!demoAccount) {
+        throw new Error('No demo account is linked to this token. Link a demo account via cTrader before running this script.');
+    }
+    await transport.disconnect();
+    return demoAccount.ctidTraderAccountId;
+}
+/**
+ * Runs the full one-time setup shared by every example script: OAuth (browser flow or cached
+ * token refresh), demo account discovery, and a connected, authenticated SpotwareClient. Each
+ * example script can then focus purely on the module it's demonstrating.
+ */
+async function createAuthenticatedClient() {
+    const clientId = requireEnv('SPOTWARE__CLIENT_ID');
+    const clientSecret = requireEnv('SPOTWARE__CLIENT_SECRET');
+    const oauthClient = new auth_1.SpotwareOAuthClient({ clientId, clientSecret });
+    const token = await obtainToken(oauthClient);
+    const ctidTraderAccountId = await discoverDemoAccountId(clientId, clientSecret, token.accessToken);
+    console.log(`\nConnecting SpotwareClient for demo account ${ctidTraderAccountId}...`);
+    const transport = new transport_1.SpotwareTransport({ host: transport_1.SpotwareHost.DEMO });
+    const client = new client_1.SpotwareClient({ transport, oauthClient, clientId, clientSecret, ctidTraderAccountId, token });
+    transport.on('reconnecting', (attempt, delayMs) => console.log(`Reconnecting (attempt ${attempt}) in ${delayMs}ms...`));
+    client.on('authenticated', () => console.log('Authenticated (application + account).'));
+    client.on('tokenRefreshed', (refreshed) => {
+        console.log('Access token refreshed.');
+        void writeStoredToken(refreshed);
+    });
+    client.on('error', (error) => console.error('Client error:', error.message));
+    await client.connect();
+    return client;
+}
+//# sourceMappingURL=create-authenticated-client.js.map

package/dist/example/shared/create-authenticated-client.js.map

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

package/dist/example/trading-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trading-example.d.ts.map

package/dist/example/trading-example.d.ts.map

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

package/dist/example/trading-example.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const market_data_1 = require("../market-data");
+const trading_1 = require("../trading");
+const types_1 = require("../types");
+const create_authenticated_client_1 = require("./shared/create-authenticated-client");
+const SYMBOL_NAME = process.argv[2] ?? 'EURUSD';
+// Small enough to be a plausible minimum size on a demo account, without assuming a specific
+// broker's actual minimum — if it's rejected, the OrderErrorEvent rejection prints clearly.
+const ORDER_VOLUME_UNITS = 1_000;
+function waitForBid(marketData, symbolId) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            marketData.off('price', onPrice);
+            reject(new Error('Timed out waiting for a price update'));
+        }, 10_000);
+        const onPrice = (update) => {
+            if (update.symbolId !== symbolId || update.bid === undefined) {
+                return;
+            }
+            clearTimeout(timeout);
+            marketData.off('price', onPrice);
+            resolve(update.bid);
+        };
+        marketData.on('price', onPrice);
+    });
+}
+async function main() {
+    const client = await (0, create_authenticated_client_1.createAuthenticatedClient)();
+    const trading = new trading_1.SpotwareTrading(client);
+    // Only need the symbol catalog here, not price streaming for its own sake — this is the
+    // same public SpotwareSymbolCatalog a consumer could use standalone.
+    const marketData = new market_data_1.SpotwareMarketData(client);
+    console.log('\nOpen positions:');
+    const { positions, orders } = await trading.getOpenPositionsAndOrders();
+    console.table(positions.map((position) => ({
+        positionId: position.positionId,
+        symbolId: position.tradeData?.symbolId,
+        side: position.tradeData?.tradeSide,
+        volume: position.tradeData?.volume
+    })));
+    console.log('Pending orders:');
+    console.table(orders.map((order) => ({ orderId: order.orderId, status: order.orderStatus, type: order.orderType })));
+    const symbol = await marketData.symbols.findByName(SYMBOL_NAME);
+    if (!symbol) {
+        throw new Error(`Symbol "${SYMBOL_NAME}" was not found for this account`);
+    }
+    console.log(`\nFetching a reference price for ${symbol.symbolName}...`);
+    const bidPromise = waitForBid(marketData, symbol.symbolId);
+    await marketData.subscribe(symbol.symbolId);
+    const bid = await bidPromise;
+    await marketData.unsubscribe(symbol.symbolId);
+    // 10% below the current bid: a BUY limit there is virtually guaranteed to stay pending
+    // rather than fill, so placing and cancelling it is safe to run against a real demo account.
+    const limitPrice = Number((bid * 0.9).toFixed(5));
+    console.log(`Current bid: ${bid}. Placing a BUY limit order at ${limitPrice} (won't fill)...`);
+    const execution = await trading.placeLimitOrder({
+        symbolId: symbol.symbolId,
+        tradeSide: types_1.ProtoOATradeSide.BUY,
+        volume: ORDER_VOLUME_UNITS,
+        limitPrice,
+        comment: 'ctrader-x trading example — safe to cancel'
+    });
+    const orderId = execution.order?.orderId;
+    console.log(`Order placed (executionType=${execution.executionType}), orderId=${orderId}`);
+    if (orderId === undefined) {
+        throw new Error('No orderId was returned for the placed order');
+    }
+    console.log('Cancelling it...');
+    const cancellation = await trading.cancelOrder(orderId);
+    console.log(`Cancelled (executionType=${cancellation.executionType}).`);
+    await client.disconnect();
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=trading-example.js.map

package/dist/example/trading-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-example.js","sourceRoot":"","sources":["../../src/example/trading-example.ts"],"names":[],"mappings":";;AAAA,gDAA+E;AAC/E,wCAA6C;AAC7C,oCAA4C;AAC5C,sFAAiF;AAEjF,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;AAChD,6FAA6F;AAC7F,4FAA4F;AAC5F,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC,SAAS,UAAU,CAAC,UAA8B,EAAE,QAAgB;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjC,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAC9D,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,MAAM,OAAO,GAAG,CAAC,MAA4B,EAAE,EAAE;YAC7C,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3D,OAAO;YACX,CAAC;YACD,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,MAAM,IAAA,uDAAyB,GAAE,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,yBAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,wFAAwF;IACxF,qEAAqE;IACrE,MAAM,UAAU,GAAG,IAAI,gCAAkB,CAAC,MAAM,CAAC,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,yBAAyB,EAAE,CAAC;IACxE,OAAO,CAAC,KAAK,CACT,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ;QACtC,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS;QACnC,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM;KACrC,CAAC,CAAC,CACN,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAErH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,kCAAkC,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oCAAoC,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC;IAC7B,MAAM,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE9C,uFAAuF;IACvF,6FAA6F;IAC7F,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,kCAAkC,UAAU,kBAAkB,CAAC,CAAC;IAE/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;QAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,wBAAgB,CAAC,GAAG;QAC/B,MAAM,EAAE,kBAAkB;QAC1B,UAAU;QACV,OAAO,EAAE,4CAA4C;KACxD,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,CAAC,aAAa,cAAc,OAAO,EAAE,CAAC,CAAC;IAE3F,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,4BAA4B,YAAY,CAAC,aAAa,IAAI,CAAC,CAAC;IAExE,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './auth';
+export * from './client';
+export * from './market-data';
+export * from './trading';
+export * from './transport';
+export * from './types';
+//# 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,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./market-data"), exports);
+__exportStar(require("./trading"), exports);
+__exportStar(require("./transport"), exports);
+__exportStar(require("./types"), exports);
+//# 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,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B;AAC5B,0CAAwB"}

package/dist/market-data/index.d.ts

@@ -0,0 +1,3 @@
+export * from './spotware-market-data';
+export * from './spotware-symbol-catalog';
+//# sourceMappingURL=index.d.ts.map

package/dist/market-data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/market-data/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/dist/market-data/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./spotware-market-data"), exports);
+__exportStar(require("./spotware-symbol-catalog"), exports);
+//# sourceMappingURL=index.js.map

package/dist/market-data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/market-data/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,4DAA0C"}

package/dist/market-data/spotware-market-data.d.ts

@@ -0,0 +1,31 @@
+import type { SpotwareClient } from '../client';
+import { TypedEventEmitter, type EventMap } from '../shared/typed-event-emitter';
+import { SpotwareSymbolCatalog } from './spotware-symbol-catalog';
+export interface ISpotwarePriceUpdate {
+    symbolId: number;
+    bid?: number;
+    ask?: number;
+    timestamp?: number;
+}
+export interface ISpotwareMarketDataEvents extends EventMap {
+    price: [update: ISpotwarePriceUpdate];
+    error: [error: Error];
+}
+/**
+ * Subscribes to spot prices via `client` and exposes them as a clean 'price' event, decimal
+ * bid/ask already converted. Re-subscribes to everything currently subscribed whenever
+ * `client` re-authenticates (including after a reconnect), since a fresh TCP connection has
+ * no memory of prior subscriptions.
+ */
+export declare class SpotwareMarketData extends TypedEventEmitter<ISpotwareMarketDataEvents> {
+    readonly symbols: SpotwareSymbolCatalog;
+    private readonly client;
+    private readonly subscribedSymbolIds;
+    constructor(client: SpotwareClient, symbolCatalog?: SpotwareSymbolCatalog);
+    subscribe(symbol: number | string): Promise<void>;
+    unsubscribe(symbol: number | string): Promise<void>;
+    private resolveSymbolId;
+    private handleMessage;
+    private resubscribeAll;
+}
+//# sourceMappingURL=spotware-market-data.d.ts.map

package/dist/market-data/spotware-market-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-market-data.d.ts","sourceRoot":"","sources":["../../src/market-data/spotware-market-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,QAAQ;IACvD,KAAK,EAAE,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB,CAAC,yBAAyB,CAAC;IAChF,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;gBAE7C,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,EAAE,qBAAqB;IASnE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,eAAe;IAa7B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;CAgBzB"}

package/dist/market-data/spotware-market-data.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotwareMarketData = void 0;
+const spotware_scale_1 = require("../shared/spotware-scale");
+const typed_event_emitter_1 = require("../shared/typed-event-emitter");
+const types_1 = require("../types");
+const spotware_symbol_catalog_1 = require("./spotware-symbol-catalog");
+/**
+ * Subscribes to spot prices via `client` and exposes them as a clean 'price' event, decimal
+ * bid/ask already converted. Re-subscribes to everything currently subscribed whenever
+ * `client` re-authenticates (including after a reconnect), since a fresh TCP connection has
+ * no memory of prior subscriptions.
+ */
+class SpotwareMarketData extends typed_event_emitter_1.TypedEventEmitter {
+    symbols;
+    client;
+    subscribedSymbolIds = new Set();
+    constructor(client, symbolCatalog) {
+        super();
+        this.client = client;
+        this.symbols = symbolCatalog ?? new spotware_symbol_catalog_1.SpotwareSymbolCatalog(client);
+        this.client.on('message', (message) => this.handleMessage(message));
+        this.client.on('authenticated', () => this.resubscribeAll());
+    }
+    async subscribe(symbol) {
+        const symbolId = await this.resolveSymbolId(symbol);
+        await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_SUBSCRIBE_SPOTS_REQ, types_1.ProtoOASubscribeSpotsReq.encode(types_1.ProtoOASubscribeSpotsReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId, symbolId: [symbolId] })).finish());
+        this.subscribedSymbolIds.add(symbolId);
+    }
+    async unsubscribe(symbol) {
+        const symbolId = await this.resolveSymbolId(symbol);
+        await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_UNSUBSCRIBE_SPOTS_REQ, types_1.ProtoOAUnsubscribeSpotsReq.encode(types_1.ProtoOAUnsubscribeSpotsReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId, symbolId: [symbolId] })).finish());
+        this.subscribedSymbolIds.delete(symbolId);
+    }
+    async resolveSymbolId(symbol) {
+        if (typeof symbol === 'number') {
+            return symbol;
+        }
+        const found = await this.symbols.findByName(symbol);
+        if (!found) {
+            throw new Error(`Unknown symbol "${symbol}"`);
+        }
+        return found.symbolId;
+    }
+    handleMessage(message) {
+        if (message.payloadType !== types_1.ProtoOAPayloadType.PROTO_OA_SPOT_EVENT) {
+            return;
+        }
+        const event = types_1.ProtoOASpotEvent.decode(message.payload ?? new Uint8Array());
+        this.emit('price', {
+            symbolId: event.symbolId,
+            bid: event.bid === undefined ? undefined : event.bid / spotware_scale_1.SPOTWARE_PRICE_SCALE,
+            ask: event.ask === undefined ? undefined : event.ask / spotware_scale_1.SPOTWARE_PRICE_SCALE,
+            timestamp: event.timestamp
+        });
+    }
+    resubscribeAll() {
+        if (this.subscribedSymbolIds.size === 0) {
+            return;
+        }
+        const symbolId = [...this.subscribedSymbolIds];
+        this.client
+            .send(types_1.ProtoOAPayloadType.PROTO_OA_SUBSCRIBE_SPOTS_REQ, types_1.ProtoOASubscribeSpotsReq.encode(types_1.ProtoOASubscribeSpotsReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId, symbolId })).finish())
+            .catch((error) => this.emit('error', error));
+    }
+}
+exports.SpotwareMarketData = SpotwareMarketData;
+//# sourceMappingURL=spotware-market-data.js.map

package/dist/market-data/spotware-market-data.js.map

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

package/dist/market-data/spotware-symbol-catalog.d.ts

@@ -0,0 +1,19 @@
+import type { SpotwareClient } from '../client';
+import { ProtoOALightSymbol } from '../types';
+/**
+ * Fetches and caches the account's symbol list, and resolves a ticker name (e.g. "EURUSD")
+ * to the numeric symbolId every other request actually needs. Public on its own — trading
+ * will want the same lookups later — and used internally by SpotwareMarketData so callers
+ * can subscribe by name without touching this class directly.
+ */
+export declare class SpotwareSymbolCatalog {
+    private readonly client;
+    private symbolsPromise;
+    constructor(client: SpotwareClient);
+    getAll(): Promise<ProtoOALightSymbol[]>;
+    findByName(symbolName: string): Promise<ProtoOALightSymbol | undefined>;
+    findById(symbolId: number): Promise<ProtoOALightSymbol | undefined>;
+    refresh(): Promise<ProtoOALightSymbol[]>;
+    private fetchSymbols;
+}
+//# sourceMappingURL=spotware-symbol-catalog.d.ts.map

package/dist/market-data/spotware-symbol-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-symbol-catalog.d.ts","sourceRoot":"","sources":["../../src/market-data/spotware-symbol-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAoE,MAAM,UAAU,CAAC;AAEhH;;;;;GAKG;AACH,qBAAa,qBAAqB;IAGlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,cAAc,CAA4C;gBAErC,MAAM,EAAE,cAAc;IAE7C,MAAM,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQvC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAOvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAOzE,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAM1B,YAAY;CAgB7B"}

package/dist/market-data/spotware-symbol-catalog.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotwareSymbolCatalog = void 0;
+const types_1 = require("../types");
+/**
+ * Fetches and caches the account's symbol list, and resolves a ticker name (e.g. "EURUSD")
+ * to the numeric symbolId every other request actually needs. Public on its own — trading
+ * will want the same lookups later — and used internally by SpotwareMarketData so callers
+ * can subscribe by name without touching this class directly.
+ */
+class SpotwareSymbolCatalog {
+    client;
+    symbolsPromise;
+    constructor(client) {
+        this.client = client;
+    }
+    async getAll() {
+        if (!this.symbolsPromise) {
+            this.symbolsPromise = this.fetchSymbols();
+        }
+        return this.symbolsPromise;
+    }
+    async findByName(symbolName) {
+        const normalized = symbolName.trim().toUpperCase();
+        const symbols = await this.getAll();
+        return symbols.find((symbol) => symbol.symbolName?.toUpperCase() === normalized);
+    }
+    async findById(symbolId) {
+        const symbols = await this.getAll();
+        return symbols.find((symbol) => symbol.symbolId === symbolId);
+    }
+    // Forces a re-fetch, e.g. if symbols were added or archived since the last load.
+    refresh() {
+        this.symbolsPromise = this.fetchSymbols();
+        return this.symbolsPromise;
+    }
+    async fetchSymbols() {
+        try {
+            const request = types_1.ProtoOASymbolsListReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId });
+            const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_SYMBOLS_LIST_REQ, types_1.ProtoOASymbolsListReq.encode(request).finish());
+            return types_1.ProtoOASymbolsListRes.decode(response.payload ?? new Uint8Array()).symbol;
+        }
+        catch (error) {
+            // Don't cache a failure — the next call should retry instead of returning a
+            // permanently broken rejected promise.
+            this.symbolsPromise = undefined;
+            throw error;
+        }
+    }
+}
+exports.SpotwareSymbolCatalog = SpotwareSymbolCatalog;
+//# sourceMappingURL=spotware-symbol-catalog.js.map

package/dist/market-data/spotware-symbol-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-symbol-catalog.js","sourceRoot":"","sources":["../../src/market-data/spotware-symbol-catalog.ts"],"names":[],"mappings":";;;AACA,oCAAgH;AAEhH;;;;;GAKG;AACH,MAAa,qBAAqB;IAGD;IAFrB,cAAc,CAA4C;IAElE,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC9C,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB;QAC/B,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAEpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAEpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,iFAAiF;IACjF,OAAO;QACH,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,YAAY;QACtB,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,6BAAqB,CAAC,WAAW,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAC5G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,0BAAkB,CAAC,yBAAyB,EAC5C,6BAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CACjD,CAAC;YAEF,OAAO,6BAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,4EAA4E;YAC5E,uCAAuC;YACvC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ;AAjDD,sDAiDC"}

package/dist/shared/sleep.d.ts

@@ -0,0 +1,5 @@
+export declare class Sleep {
+    static s(time: number): Promise<void>;
+    static ms(time: number): Promise<void>;
+}
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/shared/sleep.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IACd,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM;IAIrB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM;CAOzB"}

package/dist/shared/sleep.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sleep = void 0;
+class Sleep {
+    static s(time) {
+        return this.ms(time * 1000);
+    }
+    static ms(time) {
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                resolve();
+            }, time);
+        });
+    }
+}
+exports.Sleep = Sleep;
+//# sourceMappingURL=sleep.js.map

package/dist/shared/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/shared/sleep.ts"],"names":[],"mappings":";;;AAAA,MAAa,KAAK;IACd,MAAM,CAAC,CAAC,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,IAAY;QAClB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACjC,UAAU,CAAC,GAAG,EAAE;gBACZ,OAAO,EAAE,CAAC;YACd,CAAC,EAAE,IAAI,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAZD,sBAYC"}

package/dist/shared/spotware-scale.d.ts

@@ -0,0 +1,3 @@
+export declare const SPOTWARE_PRICE_SCALE = 100000;
+export declare const SPOTWARE_VOLUME_SCALE = 100;
+//# sourceMappingURL=spotware-scale.d.ts.map

package/dist/shared/spotware-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-scale.d.ts","sourceRoot":"","sources":["../../src/shared/spotware-scale.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAG5C,eAAO,MAAM,qBAAqB,MAAM,CAAC"}

package/dist/shared/spotware-scale.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPOTWARE_VOLUME_SCALE = exports.SPOTWARE_PRICE_SCALE = void 0;
+// Spot prices (bid/ask/sessionClose) and relative stop-loss/take-profit are transmitted as
+// fixed-point integers: 123000 means 1.23. Not every price field uses this scale — order-level
+// absolute prices (limitPrice, stopPrice, stopLoss, takeProfit) are plain decimals instead, per
+// their own doc comments in the generated types. Confirmed against Spotware's own OpenApiPy
+// sample, which assigns a plain float to limitPrice with no conversion.
+exports.SPOTWARE_PRICE_SCALE = 100_000;
+// Volumes are transmitted in cents of a unit: 1000 means 10.00 units.
+exports.SPOTWARE_VOLUME_SCALE = 100;
+//# sourceMappingURL=spotware-scale.js.map

package/dist/shared/spotware-scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-scale.js","sourceRoot":"","sources":["../../src/shared/spotware-scale.ts"],"names":[],"mappings":";;;AAAA,2FAA2F;AAC3F,+FAA+F;AAC/F,gGAAgG;AAChG,4FAA4F;AAC5F,wEAAwE;AAC3D,QAAA,oBAAoB,GAAG,OAAO,CAAC;AAE5C,sEAAsE;AACzD,QAAA,qBAAqB,GAAG,GAAG,CAAC"}

package/dist/shared/typed-event-emitter.d.ts

@@ -0,0 +1,13 @@
+export type EventMap = Record<string, unknown[]>;
+/**
+ * Wraps Node's EventEmitter instead of extending it, so `emit` stays protected:
+ * consumers can only listen, only the owning class can trigger events.
+ */
+export declare class TypedEventEmitter<TEvents extends EventMap> {
+    private readonly emitter;
+    on<TEvent extends keyof TEvents & string>(event: TEvent, listener: (...args: TEvents[TEvent]) => void): this;
+    once<TEvent extends keyof TEvents & string>(event: TEvent, listener: (...args: TEvents[TEvent]) => void): this;
+    off<TEvent extends keyof TEvents & string>(event: TEvent, listener: (...args: TEvents[TEvent]) => void): this;
+    protected emit<TEvent extends keyof TEvents & string>(event: TEvent, ...args: TEvents[TEvent]): boolean;
+}
+//# sourceMappingURL=typed-event-emitter.d.ts.map

package/dist/shared/typed-event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-event-emitter.d.ts","sourceRoot":"","sources":["../../src/shared/typed-event-emitter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAEjD;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,OAAO,SAAS,QAAQ;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,EAAE,CAAC,MAAM,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI;IAK5G,IAAI,CAAC,MAAM,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI;IAK9G,GAAG,CAAC,MAAM,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI;IAK7G,SAAS,CAAC,IAAI,CAAC,MAAM,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO;CAG1G"}