ctrader-x 0.1.0

package/dist/client/spotware-client.d.ts

@@ -0,0 +1,56 @@
+import { SpotwareOAuthClient, type ISpotwareOAuthToken } from '../auth';
+import { TypedEventEmitter, type EventMap } from '../shared/typed-event-emitter';
+import { ProtoMessage } from '../types';
+import type { SpotwareTransport } from '../transport';
+export interface ISpotwareClientOptions {
+    transport: SpotwareTransport;
+    oauthClient: SpotwareOAuthClient;
+    clientId: string;
+    clientSecret: string;
+    ctidTraderAccountId: number;
+    token: ISpotwareOAuthToken;
+    requestTimeoutMs?: number;
+    tokenRefreshBufferMs?: number;
+}
+export interface ISpotwareClientEvents extends EventMap {
+    authenticated: [];
+    tokenRefreshed: [token: ISpotwareOAuthToken];
+    message: [message: ProtoMessage];
+    error: [error: Error];
+}
+/**
+ * Request/response correlation on top of transport + auth: `send()` tags each request with a
+ * clientMsgId and resolves once the matching response arrives, refreshing the access token
+ * first if it's close to expiry. Re-runs the app/account auth handshake on every transport
+ * 'connected' event, including reconnects, since a fresh TCP connection has no socket-level
+ * auth state. Doesn't know what an order or a price is — every unsolicited message (spot
+ * events, etc.) is just forwarded as-is via the 'message' event for market-data/trading to
+ * interpret.
+ */
+export declare class SpotwareClient extends TypedEventEmitter<ISpotwareClientEvents> {
+    private readonly transport;
+    private readonly oauthClient;
+    private readonly authenticator;
+    private readonly clientId;
+    private readonly clientSecret;
+    private readonly _ctidTraderAccountId;
+    private readonly requestTimeoutMs;
+    private readonly tokenRefreshBufferMs;
+    private readonly pendingRequests;
+    private token;
+    private tokenIssuedAt;
+    private tokenRefreshInFlight;
+    private authenticationInFlight;
+    constructor(options: ISpotwareClientOptions);
+    get ctidTraderAccountId(): number;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(payloadType: number, payload: Uint8Array): Promise<ProtoMessage>;
+    private handleConnected;
+    private authenticate;
+    private handleMessage;
+    private rejectPendingRequests;
+    private ensureValidToken;
+    private refreshToken;
+}
+//# sourceMappingURL=spotware-client.d.ts.map

package/dist/client/spotware-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-client.d.ts","sourceRoot":"","sources":["../../src/client/spotware-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAA+B,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAiB,YAAY,EAAiF,MAAM,UAAU,CAAC;AACtI,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWtD,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qBAAsB,SAAQ,QAAQ;IACnD,aAAa,EAAE,EAAE,CAAC;IAClB,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC7C,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,iBAAiB,CAAC,qBAAqB,CAAC;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAE9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IACtE,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,sBAAsB,CAA4B;gBAE9C,OAAO,EAAE,sBAAsB;IAqB3C,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IA4C3E,OAAO,CAAC,eAAe;YAST,YAAY;IAO1B,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,qBAAqB;YAQf,gBAAgB;YAmBhB,YAAY;CAK7B"}

package/dist/client/spotware-client.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotwareClient = void 0;
+const node_crypto_1 = require("node:crypto");
+const auth_1 = require("../auth");
+const typed_event_emitter_1 = require("../shared/typed-event-emitter");
+const types_1 = require("../types");
+const spotware_request_error_1 = require("./spotware-request-error");
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+const DEFAULT_TOKEN_REFRESH_BUFFER_MS = 5 * 60_000;
+/**
+ * Request/response correlation on top of transport + auth: `send()` tags each request with a
+ * clientMsgId and resolves once the matching response arrives, refreshing the access token
+ * first if it's close to expiry. Re-runs the app/account auth handshake on every transport
+ * 'connected' event, including reconnects, since a fresh TCP connection has no socket-level
+ * auth state. Doesn't know what an order or a price is — every unsolicited message (spot
+ * events, etc.) is just forwarded as-is via the 'message' event for market-data/trading to
+ * interpret.
+ */
+class SpotwareClient extends typed_event_emitter_1.TypedEventEmitter {
+    transport;
+    oauthClient;
+    authenticator;
+    clientId;
+    clientSecret;
+    _ctidTraderAccountId;
+    requestTimeoutMs;
+    tokenRefreshBufferMs;
+    pendingRequests = new Map();
+    token;
+    tokenIssuedAt = Date.now();
+    tokenRefreshInFlight;
+    authenticationInFlight;
+    constructor(options) {
+        super();
+        this.transport = options.transport;
+        this.oauthClient = options.oauthClient;
+        this.clientId = options.clientId;
+        this.clientSecret = options.clientSecret;
+        this._ctidTraderAccountId = options.ctidTraderAccountId;
+        this.token = options.token;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.tokenRefreshBufferMs = options.tokenRefreshBufferMs ?? DEFAULT_TOKEN_REFRESH_BUFFER_MS;
+        this.authenticator = new auth_1.SpotwareSocketAuthenticator(this.transport, { responseTimeoutMs: this.requestTimeoutMs });
+        this.transport.on('connected', () => this.handleConnected());
+        this.transport.on('message', (message) => this.handleMessage(message));
+        this.transport.on('error', (error) => this.emit('error', error));
+        this.transport.on('disconnected', (reason) => {
+            const message = reason === 'manual' ? 'The connection was closed' : 'The connection was lost';
+            this.rejectPendingRequests(new spotware_request_error_1.SpotwareRequestError(`${message} while waiting for a response`));
+        });
+    }
+    get ctidTraderAccountId() {
+        return this._ctidTraderAccountId;
+    }
+    async connect() {
+        await this.transport.connect();
+        await this.authenticationInFlight;
+    }
+    disconnect() {
+        return this.transport.disconnect();
+    }
+    async send(payloadType, payload) {
+        if (this.authenticationInFlight) {
+            await this.authenticationInFlight;
+        }
+        await this.ensureValidToken();
+        const clientMsgId = (0, node_crypto_1.randomUUID)();
+        return new Promise((resolve, reject) => {
+            let timeout;
+            const settle = (pending) => {
+                this.pendingRequests.set(clientMsgId, pending);
+            };
+            const cleanup = () => {
+                clearTimeout(timeout);
+                this.pendingRequests.delete(clientMsgId);
+            };
+            settle({
+                resolve: (message) => {
+                    cleanup();
+                    resolve(message);
+                },
+                reject: (error) => {
+                    cleanup();
+                    reject(error);
+                }
+            });
+            timeout = setTimeout(() => {
+                this.pendingRequests.get(clientMsgId)?.reject(new spotware_request_error_1.SpotwareRequestError(`Timed out waiting for a response to "${clientMsgId}"`));
+            }, this.requestTimeoutMs);
+            this.transport.send(types_1.ProtoMessage.fromPartial({ payloadType, payload, clientMsgId })).catch((error) => {
+                this.pendingRequests.get(clientMsgId)?.reject(error);
+            });
+        });
+    }
+    // Fires on the first connect and on every auto-reconnect: a new TCP connection has no
+    // socket-level auth state, so this re-establishes it every time, not just once.
+    handleConnected() {
+        // Left set after settling rather than cleared: awaiting an already-settled promise
+        // is a harmless no-op, and clearing it here would race connect()'s own await below
+        // on an unrealistically fast (but not impossible) authentication.
+        const attempt = this.authenticate();
+        this.authenticationInFlight = attempt;
+        attempt.catch((error) => this.emit('error', error));
+    }
+    async authenticate() {
+        await this.ensureValidToken();
+        await this.authenticator.authenticateApplication(this.clientId, this.clientSecret);
+        await this.authenticator.authenticateAccount(this._ctidTraderAccountId, this.token.accessToken);
+        this.emit('authenticated');
+    }
+    handleMessage(message) {
+        this.emit('message', message);
+        const pending = message.clientMsgId ? this.pendingRequests.get(message.clientMsgId) : undefined;
+        if (!pending) {
+            return;
+        }
+        if (message.payloadType === types_1.ProtoOAPayloadType.PROTO_OA_ERROR_RES) {
+            const error = types_1.ProtoOAErrorRes.decode(message.payload ?? new Uint8Array());
+            pending.reject(new spotware_request_error_1.SpotwareRequestError(error.description ?? error.errorCode, error.errorCode));
+            return;
+        }
+        if (message.payloadType === types_1.ProtoPayloadType.ERROR_RES) {
+            const error = types_1.ProtoErrorRes.decode(message.payload ?? new Uint8Array());
+            pending.reject(new spotware_request_error_1.SpotwareRequestError(error.description ?? error.errorCode, error.errorCode));
+            return;
+        }
+        // Order mutations (new/amend/cancel/close) have no dedicated _Res message: the outcome
+        // arrives as an ExecutionEvent (success) or this event (failure), both carrying the
+        // same clientMsgId. Without this, a rejected order would resolve as if it succeeded.
+        if (message.payloadType === types_1.ProtoOAPayloadType.PROTO_OA_ORDER_ERROR_EVENT) {
+            const error = types_1.ProtoOAOrderErrorEvent.decode(message.payload ?? new Uint8Array());
+            pending.reject(new spotware_request_error_1.SpotwareRequestError(error.description ?? error.errorCode, error.errorCode));
+            return;
+        }
+        pending.resolve(message);
+    }
+    // Called when the transport disconnects for any reason, so in-flight requests fail
+    // immediately with a clear cause instead of each waiting out its own full timeout for
+    // a response that can no longer arrive.
+    rejectPendingRequests(error) {
+        for (const pending of [...this.pendingRequests.values()]) {
+            pending.reject(error);
+        }
+    }
+    // Refresh tokens are single-use: concurrent callers must await the same in-flight
+    // refresh rather than each requesting their own, which would invalidate the others.
+    async ensureValidToken() {
+        if (this.tokenRefreshInFlight) {
+            await this.tokenRefreshInFlight;
+            return;
+        }
+        const expiresAt = this.tokenIssuedAt + this.token.expiresIn * 1000;
+        if (Date.now() < expiresAt - this.tokenRefreshBufferMs) {
+            return;
+        }
+        this.tokenRefreshInFlight = this.refreshToken();
+        try {
+            await this.tokenRefreshInFlight;
+        }
+        finally {
+            this.tokenRefreshInFlight = undefined;
+        }
+    }
+    async refreshToken() {
+        this.token = await this.oauthClient.refreshAccessToken({ refreshToken: this.token.refreshToken });
+        this.tokenIssuedAt = Date.now();
+        this.emit('tokenRefreshed', this.token);
+    }
+}
+exports.SpotwareClient = SpotwareClient;
+//# sourceMappingURL=spotware-client.js.map

package/dist/client/spotware-client.js.map

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

package/dist/client/spotware-request-error.d.ts

@@ -0,0 +1,5 @@
+export declare class SpotwareRequestError extends Error {
+    readonly errorCode?: string | undefined;
+    constructor(message: string, errorCode?: string | undefined);
+}
+//# sourceMappingURL=spotware-request-error.d.ts.map

package/dist/client/spotware-request-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-request-error.d.ts","sourceRoot":"","sources":["../../src/client/spotware-request-error.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;aAGvB,SAAS,CAAC,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,MAAM,YAAA;CAKzC"}

package/dist/client/spotware-request-error.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotwareRequestError = void 0;
+class SpotwareRequestError extends Error {
+    errorCode;
+    constructor(message, errorCode) {
+        super(message);
+        this.errorCode = errorCode;
+        this.name = 'SpotwareRequestError';
+    }
+}
+exports.SpotwareRequestError = SpotwareRequestError;
+//# sourceMappingURL=spotware-request-error.js.map

package/dist/client/spotware-request-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-request-error.js","sourceRoot":"","sources":["../../src/client/spotware-request-error.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAqB,SAAQ,KAAK;IAGvB;IAFpB,YACI,OAAe,EACC,SAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,cAAS,GAAT,SAAS,CAAS;QAGlC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AARD,oDAQC"}

package/dist/example/example.d.ts

@@ -0,0 +1,2 @@
+import 'dotenv/config';
+//# sourceMappingURL=example.d.ts.map

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

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

package/dist/example/example.js

@@ -0,0 +1,187 @@
+"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 });
+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 types_1 = require("../types");
+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;
+}
+async function main() {
+    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();
+    console.log('\nSending PROTO_OA_VERSION_REQ through SpotwareClient to confirm request/response correlation works end to end...');
+    const response = await client.send(types_1.ProtoOAPayloadType.PROTO_OA_VERSION_REQ, types_1.ProtoOAVersionReq.encode(types_1.ProtoOAVersionReq.fromPartial({})).finish());
+    const version = types_1.ProtoOAVersionRes.decode(response.payload ?? new Uint8Array());
+    console.log(`Server version: ${version.version}`);
+    // This intentionally runs indefinitely so that the user can test the reconnection
+    // mechanism, by switching the wifi on/off, and wait for the reconnection logs
+    // to appear before turning it back on.
+    setInterval(async () => {
+        console.log('*'.repeat(50));
+        try {
+            const response = await client.send(types_1.ProtoOAPayloadType.PROTO_OA_VERSION_REQ, types_1.ProtoOAVersionReq.encode(types_1.ProtoOAVersionReq.fromPartial({})).finish());
+            const version = types_1.ProtoOAVersionRes.decode(response.payload ?? new Uint8Array());
+            console.log(`Server version: ${version.version}`);
+        }
+        catch (error) {
+            console.log(`Error getting server version: ${error}`);
+        }
+    }, 1000 * 5);
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=example.js.map

package/dist/example/example.js.map

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

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

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

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

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

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const market_data_1 = require("../market-data");
+const create_authenticated_client_1 = require("./shared/create-authenticated-client");
+const SYMBOL_NAME = process.argv[2] ?? 'EURUSD';
+const LISTEN_DURATION_MS = 60_000;
+async function main() {
+    const client = await (0, create_authenticated_client_1.createAuthenticatedClient)();
+    const marketData = new market_data_1.SpotwareMarketData(client);
+    marketData.on('error', (error) => console.error('Market data error:', error.message));
+    marketData.on('price', (update) => {
+        const bid = update.bid?.toFixed(5) ?? '-';
+        const ask = update.ask?.toFixed(5) ?? '-';
+        console.log(`[${update.symbolId}] bid=${bid} ask=${ask}`);
+    });
+    const symbol = await marketData.symbols.findByName(SYMBOL_NAME);
+    if (!symbol) {
+        throw new Error(`Symbol "${SYMBOL_NAME}" was not found for this account`);
+    }
+    console.log(`\nSubscribing to ${symbol.symbolName} (symbolId ${symbol.symbolId})...`);
+    await marketData.subscribe(symbol.symbolId);
+    console.log(`Listening for price updates for ${LISTEN_DURATION_MS / 1000}s (Ctrl+C to stop earlier)...\n`);
+    await new Promise((resolve) => setTimeout(resolve, LISTEN_DURATION_MS));
+    console.log(`\nUnsubscribing and disconnecting...`);
+    await marketData.unsubscribe(symbol.symbolId);
+    await client.disconnect();
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=market-data-example.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"market-data-example.js","sourceRoot":"","sources":["../../src/example/market-data-example.ts"],"names":[],"mappings":";;AAAA,gDAAoD;AACpD,sFAAiF;AAEjF,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;AAChD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,MAAM,IAAA,uDAAyB,GAAE,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,gCAAkB,CAAC,MAAM,CAAC,CAAC;IAClD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,SAAS,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,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,oBAAoB,MAAM,CAAC,UAAU,cAAc,MAAM,CAAC,QAAQ,MAAM,CAAC,CAAC;IACtF,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5C,OAAO,CAAC,GAAG,CAAC,mCAAmC,kBAAkB,GAAG,IAAI,iCAAiC,CAAC,CAAC;IAC3G,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAExE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,MAAM,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,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/example/shared/create-authenticated-client.d.ts

@@ -0,0 +1,9 @@
+import 'dotenv/config';
+import { SpotwareClient } from '../../client';
+/**
+ * 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.
+ */
+export declare function createAuthenticatedClient(): Promise<SpotwareClient>;
+//# sourceMappingURL=create-authenticated-client.d.ts.map

package/dist/example/shared/create-authenticated-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-authenticated-client.d.ts","sourceRoot":"","sources":["../../../src/example/shared/create-authenticated-client.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAMvB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA4G9C;;;;GAIG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,cAAc,CAAC,CAuBzE"}