ctrader-ts 0.1.10 → 1.0.0

package/dist/src/{connection.d.ts → core/connection.d.ts}

@@ -9,20 +9,29 @@
  *   - When a heartbeat is received from the server, immediately echo one back
  *   - If no heartbeat received from server for HEARTBEAT_TIMEOUT_MS, close
  */
-import type { ConnectionState } from "./types.js";
+import type { ConnectionState } from "../protocol/types.js";
 type PayloadHandler = (payload: Record<string, unknown>) => void;
 export type ConnectionEvent = "stateChange" | "error" | "message";
 type ConnectionEventHandler = (data: unknown) => void;
 export interface CTraderConnectionConfig {
-    /** Hostname, e.g. "demo.ctraderapi.com" */
+    /** Hostname or IP address, e.g., "demo.ctraderapi.com" */
     host: string;
-    /** Port — default 5035 */
+    /** Port number — default 5035 for cTrader Open API over TLS/TCP */
     port?: number;
+    /** Maximum number of reconnection attempts (0 = unlimited) */
     maxReconnectAttempts?: number;
+    /** Timeout in milliseconds for individual requests (default 15000ms) */
     requestTimeoutMs?: number;
-    /** Called after TCP reconnects (not initial connect). Use for re-auth + subscription restore. */
+    /** Called after TLS/TCP reconnects (not initial connect). Use for re-auth + subscription restore. */
     onReconnect?: () => Promise<void>;
 }
+/**
+ * Low-level TLS/TCP connection to the cTrader Open API (port 5035).
+ * Handles connect/disconnect, heartbeat, automatic reconnection,
+ * request/response matching, and payload-based event dispatch.
+ *
+ * Most users should use {@link CTrader} (via `connect()`) instead of this class directly.
+ */
 export declare class CTraderConnection {
     private socket;
     private readonly host;
@@ -44,16 +53,56 @@ export declare class CTraderConnection {
     private readonly pending;
     private readonly payloadHandlers;
     private readonly eventHandlers;
+    /** Request throttle queue */
+    private readonly requestQueue;
+    private inFlightRequests;
+    private lastRequestSentAt;
     constructor(config: CTraderConnectionConfig);
+    /** Current connection lifecycle state. */
     get state(): ConnectionState;
+    /** True when the TLS/TCP socket is established and ready for messages. */
     get isConnected(): boolean;
+    /**
+     * Establish a TLS/TCP connection to the cTrader API.
+     * Resolves when the connection is established, rejects on failure.
+     */
     connect(): Promise<void>;
+    /**
+     * Close the TLS/TCP connection and stop automatic reconnection.
+     * All pending requests are rejected.
+     */
     disconnect(): void;
+    /**
+     * Send a one-way message (fire-and-forget) over the TLS/TCP connection.
+     * Returns the generated clientMsgId for tracking.
+     */
     send(payloadType: number, payload?: Record<string, unknown>): string;
+    private static readonly MAX_RETRIES;
+    private static readonly INITIAL_RETRY_DELAY_MS;
+    /**
+     * Send a request and wait for the matching response.
+     * Automatically retries on rate-limit errors with exponential backoff.
+     * Rejects on timeout, non-retryable API error, or max retries exceeded.
+     */
     request(payloadType: number, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Internal: send a single request without retry.
+     */
+    private requestOnce;
+    private drainQueue;
+    /**
+     * Subscribe to a specific payload type.
+     * Returns an unsubscribe function.
+     */
     on(payloadType: number, handler: PayloadHandler): () => void;
+    /** Remove a specific handler for a payload type. */
     off(payloadType: number, handler: PayloadHandler): void;
+    /**
+     * Subscribe to connection lifecycle events (stateChange, error, message).
+     * Returns an unsubscribe function.
+     */
     onEvent(event: ConnectionEvent, handler: ConnectionEventHandler): () => void;
+    /** Remove a specific connection event handler. */
     offEvent(event: ConnectionEvent, handler: ConnectionEventHandler): void;
     private handleData;
     private handleMessage;

package/dist/src/core/connection.d.ts.map

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

package/dist/src/{connection.js → core/connection.js}

@@ -10,15 +10,29 @@
  *   - If no heartbeat received from server for HEARTBEAT_TIMEOUT_MS, close
  */
 import * as tls from "node:tls";
-import { CTraderError, NotConnectedError, RequestTimeoutError, } from "./errors.js";
-import { PayloadType } from "./enums.js";
-import { encodeMessage, encodeHeartbeat, decodeMessage, } from "./codec.js";
+import { decodeMessage, encodeHeartbeat, encodeMessage, } from "../protocol/codec.js";
+import { PayloadType } from "../protocol/enums.js";
+import { CTraderError, NotConnectedError, RequestTimeoutError } from "./errors.js";
 const REQUEST_TIMEOUT_MS = 15_000;
 const HEARTBEAT_CHECK_MS = 1_000;
 const HEARTBEAT_IDLE_MS = 10_000;
 const HEARTBEAT_TIMEOUT_MS = 60_000;
 const INITIAL_RECONNECT_DELAY_MS = 2_000;
 const MAX_RECONNECT_DELAY_MS = 60_000;
+/**
+ * Throttle settings to avoid REQUEST_FREQUENCY_EXCEEDED errors.
+ * The cTrader Open API has an undocumented rate limit (~50 req/s).
+ * We limit concurrency and add a small gap between sends.
+ */
+const MAX_CONCURRENT_REQUESTS = 5;
+const REQUEST_GAP_MS = 50;
+/**
+ * Low-level TLS/TCP connection to the cTrader Open API (port 5035).
+ * Handles connect/disconnect, heartbeat, automatic reconnection,
+ * request/response matching, and payload-based event dispatch.
+ *
+ * Most users should use {@link CTrader} (via `connect()`) instead of this class directly.
+ */
 export class CTraderConnection {
     socket = null;
     host;
@@ -40,6 +54,10 @@ export class CTraderConnection {
     pending = new Map();
     payloadHandlers = new Map();
     eventHandlers = new Map();
+    /** Request throttle queue */
+    requestQueue = [];
+    inFlightRequests = 0;
+    lastRequestSentAt = 0;
     constructor(config) {
         this.host = config.host;
         this.port = config.port ?? 5035;
@@ -47,17 +65,22 @@ export class CTraderConnection {
         this.requestTimeoutMs = config.requestTimeoutMs ?? REQUEST_TIMEOUT_MS;
         this.onReconnect = config.onReconnect;
     }
+    /** Current connection lifecycle state. */
     get state() {
         return this._state;
     }
+    /** True when the TLS/TCP socket is established and ready for messages. */
     get isConnected() {
         return this._state.status === "connected" || this._state.status === "ready";
     }
     // ─── Connect ────────────────────────────────────────────────────────────
+    /**
+     * Establish a TLS/TCP connection to the cTrader API.
+     * Resolves when the connection is established, rejects on failure.
+     */
     connect() {
         return new Promise((resolve, reject) => {
-            if (this._state.status === "connected" ||
-                this._state.status === "ready") {
+            if (this._state.status === "connected" || this._state.status === "ready") {
                 resolve();
                 return;
             }
@@ -97,6 +120,10 @@ export class CTraderConnection {
             });
         });
     }
+    /**
+     * Close the TLS/TCP connection and stop automatic reconnection.
+     * All pending requests are rejected.
+     */
     disconnect() {
         this.shouldReconnect = false;
         if (this.reconnectTimer !== null) {
@@ -112,6 +139,10 @@ export class CTraderConnection {
         this.setState({ status: "disconnected" });
     }
     // ─── Send ───────────────────────────────────────────────────────────────
+    /**
+     * Send a one-way message (fire-and-forget) over the TLS/TCP connection.
+     * Returns the generated clientMsgId for tracking.
+     */
     send(payloadType, payload) {
         if (this.socket === null || this.socket.destroyed) {
             throw new NotConnectedError();
@@ -122,17 +153,105 @@ export class CTraderConnection {
         this.lastSendAt = Date.now();
         return clientMsgId;
     }
-    request(payloadType, payload) {
+    static MAX_RETRIES = 3;
+    static INITIAL_RETRY_DELAY_MS = 1_000;
+    /**
+     * Send a request and wait for the matching response.
+     * Automatically retries on rate-limit errors with exponential backoff.
+     * Rejects on timeout, non-retryable API error, or max retries exceeded.
+     */
+    async request(payloadType, payload) {
+        let lastError;
+        for (let attempt = 0; attempt <= CTraderConnection.MAX_RETRIES; attempt++) {
+            try {
+                return await this.requestOnce(payloadType, payload);
+            }
+            catch (err) {
+                if (err instanceof CTraderError &&
+                    err.isRateLimit &&
+                    attempt < CTraderConnection.MAX_RETRIES) {
+                    lastError = err;
+                    const delay = err.retryAfter ?? CTraderConnection.INITIAL_RETRY_DELAY_MS * 2 ** attempt;
+                    await new Promise((r) => setTimeout(r, delay));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastError ?? new Error("Max retries exceeded");
+    }
+    /**
+     * Internal: send a single request without retry.
+     */
+    requestOnce(payloadType, payload) {
         return new Promise((resolve, reject) => {
-            const clientMsgId = this.send(payloadType, payload);
-            const timeout = setTimeout(() => {
-                this.pending.delete(clientMsgId);
-                reject(new RequestTimeoutError(payloadType, clientMsgId, this.requestTimeoutMs));
-            }, this.requestTimeoutMs);
-            this.pending.set(clientMsgId, { resolve, reject, timeout });
+            const execute = () => {
+                this.inFlightRequests++;
+                this.lastRequestSentAt = Date.now();
+                let clientMsgId;
+                try {
+                    clientMsgId = this.send(payloadType, payload);
+                }
+                catch (err) {
+                    this.inFlightRequests--;
+                    this.drainQueue();
+                    reject(err instanceof Error ? err : new Error(String(err)));
+                    return;
+                }
+                const onComplete = () => {
+                    this.inFlightRequests--;
+                    this.drainQueue();
+                };
+                const timeout = setTimeout(() => {
+                    this.pending.delete(clientMsgId);
+                    onComplete();
+                    reject(new RequestTimeoutError(payloadType, clientMsgId, this.requestTimeoutMs));
+                }, this.requestTimeoutMs);
+                this.pending.set(clientMsgId, {
+                    resolve: (result) => {
+                        onComplete();
+                        resolve(result);
+                    },
+                    reject: (err) => {
+                        onComplete();
+                        reject(err);
+                    },
+                    timeout,
+                });
+            };
+            // Queue if at concurrency limit or need gap between sends
+            if (this.inFlightRequests >= MAX_CONCURRENT_REQUESTS) {
+                this.requestQueue.push(execute);
+            }
+            else {
+                const elapsed = Date.now() - this.lastRequestSentAt;
+                if (elapsed < REQUEST_GAP_MS) {
+                    setTimeout(execute, REQUEST_GAP_MS - elapsed);
+                }
+                else {
+                    execute();
+                }
+            }
         });
     }
+    drainQueue() {
+        if (this.requestQueue.length === 0 || this.inFlightRequests >= MAX_CONCURRENT_REQUESTS) {
+            return;
+        }
+        const next = this.requestQueue.shift();
+        const elapsed = Date.now() - this.lastRequestSentAt;
+        if (elapsed < REQUEST_GAP_MS) {
+            setTimeout(next, REQUEST_GAP_MS - elapsed);
+        }
+        else {
+            next();
+        }
+    }
     // ─── Event handlers ─────────────────────────────────────────────────────
+    /**
+     * Subscribe to a specific payload type.
+     * Returns an unsubscribe function.
+     */
     on(payloadType, handler) {
         let handlers = this.payloadHandlers.get(payloadType);
         if (handlers === undefined) {
@@ -142,9 +261,14 @@ export class CTraderConnection {
         handlers.add(handler);
         return () => this.off(payloadType, handler);
     }
+    /** Remove a specific handler for a payload type. */
     off(payloadType, handler) {
         this.payloadHandlers.get(payloadType)?.delete(handler);
     }
+    /**
+     * Subscribe to connection lifecycle events (stateChange, error, message).
+     * Returns an unsubscribe function.
+     */
     onEvent(event, handler) {
         let handlers = this.eventHandlers.get(event);
         if (handlers === undefined) {
@@ -154,6 +278,7 @@ export class CTraderConnection {
         handlers.add(handler);
         return () => this.offEvent(event, handler);
     }
+    /** Remove a specific connection event handler. */
     offEvent(event, handler) {
         this.eventHandlers.get(event)?.delete(handler);
     }
@@ -194,8 +319,7 @@ export class CTraderConnection {
             const req = this.pending.get(clientMsgId);
             this.pending.delete(clientMsgId);
             clearTimeout(req.timeout);
-            if (payloadType === PayloadType.ERROR_RES ||
-                payloadType === PayloadType.OA_ERROR_RES) {
+            if (payloadType === PayloadType.ERROR_RES || payloadType === PayloadType.OA_ERROR_RES) {
                 req.reject(this.makeError(payload));
                 return;
             }
@@ -203,8 +327,7 @@ export class CTraderConnection {
             return;
         }
         // Unsolicited error
-        if (payloadType === PayloadType.ERROR_RES ||
-            payloadType === PayloadType.OA_ERROR_RES) {
+        if (payloadType === PayloadType.ERROR_RES || payloadType === PayloadType.OA_ERROR_RES) {
             this.emit("error", this.makeError(payload));
             return;
         }
@@ -264,8 +387,7 @@ export class CTraderConnection {
         if (!this.shouldReconnect)
             return;
         this.reconnectAttempt++;
-        if (this.maxReconnectAttempts > 0 &&
-            this.reconnectAttempt > this.maxReconnectAttempts) {
+        if (this.maxReconnectAttempts > 0 && this.reconnectAttempt > this.maxReconnectAttempts) {
             this.setState({ status: "disconnected" });
             return;
         }
@@ -329,6 +451,18 @@ export class CTraderConnection {
             req.reject(error);
         }
         this.pending.clear();
+        // Reset throttle state — all in-flight requests are now dead
+        this.inFlightRequests = 0;
+        // Reject queued requests too — they'll fail on a dead socket
+        const queued = this.requestQueue.splice(0);
+        for (const fn of queued) {
+            try {
+                fn();
+            }
+            catch {
+                // Will throw NotConnectedError — caught by caller
+            }
+        }
     }
     makeError(err) {
         const opts = {

package/dist/src/core/connection.js.map

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

package/dist/src/{errors.d.ts → core/errors.d.ts}

@@ -1,3 +1,4 @@
+/** Error returned by the cTrader Open API — includes a machine-readable code and human description. */
 export declare class CTraderError extends Error {
     readonly code: string;
     readonly description: string;
@@ -9,15 +10,19 @@ export declare class CTraderError extends Error {
         retryAfter?: number;
         maintenanceEndTimestamp?: number;
     });
+    /** Actionable recovery hint for this error, or undefined for unknown error codes */
+    get hint(): string | undefined;
     get isAuthError(): boolean;
     get isRateLimit(): boolean;
     get isMaintenance(): boolean;
 }
+/** Thrown when a request does not receive a response within the configured timeout. */
 export declare class RequestTimeoutError extends Error {
     readonly payloadType: number;
     readonly clientMsgId: string;
     constructor(payloadType: number, clientMsgId: string, timeoutMs: number);
 }
+/** Thrown when an operation is attempted while the WebSocket is not connected. */
 export declare class NotConnectedError extends Error {
     constructor();
 }

package/dist/src/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AA6CA,uGAAuG;AACvG,qBAAa,YAAa,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;gBAE9B,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,uBAAuB,CAAC,EAAE,MAAM,CAAC;KACjC;IAcD,oFAAoF;IACpF,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,IAAI,WAAW,IAAI,OAAO,CASzB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;CACD;AAED,uFAAuF;AACvF,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAQvE;AAED,kFAAkF;AAClF,qBAAa,iBAAkB,SAAQ,KAAK;;CAO3C"}

package/dist/src/core/errors.js

@@ -0,0 +1,85 @@
+/** Actionable hint map: maps error codes to user-friendly recovery instructions */
+const ERROR_HINTS = {
+    // Auth errors
+    OA_AUTH_TOKEN_EXPIRED: "Your access token has expired. Run `ctrader-ts auth` to re-authenticate.",
+    ACCOUNT_NOT_AUTHORIZED: "This account isn't authorized. Run `ctrader-ts auth` and select the correct account.",
+    CH_CLIENT_AUTH_FAILURE: "Client authentication failed. Check your clientId and clientSecret in config.",
+    CH_CLIENT_NOT_AUTHENTICATED: "You must authenticate before making requests. Call connect() which handles this automatically.",
+    CH_ACCESS_TOKEN_INVALID: "Invalid access token. Run `ctrader-ts auth` to get a fresh token.",
+    OAUTH_TOKEN_INVALIDATED: "Token was invalidated (possibly revoked or used from another location). Run `ctrader-ts auth`.",
+    // Rate limiting
+    REQUEST_FREQUENCY_EXCEEDED: "Too many requests. Wait and retry — consider adding delays between rapid API calls.",
+    BLOCKED_PAYLOAD_TYPE: "This request type is temporarily blocked due to rate limiting. Wait before retrying.",
+    // Maintenance
+    SERVER_IS_UNDER_MAINTENANCE: "Server is under maintenance. Check maintenanceEndTimestamp for expected end time.",
+    // Trading errors
+    NOT_ENOUGH_MONEY: "Insufficient free margin. Reduce position size or close existing positions to free up margin.",
+    SYMBOL_NOT_FOUND: "Symbol not found. Check available symbols with getSymbols() or `ctrader-ts symbols`.",
+    INVALID_VOLUME: "Invalid volume. Ensure lots >= minVolume and is a multiple of stepVolume. Use getSymbolInfo() to check limits.",
+    MARKET_CLOSED: "Market is closed for this symbol. Check trading hours with getSymbolInfo().",
+    TRADING_BAD_VOLUME: "Volume out of range. Use getSymbolInfo() to check minVolume, maxVolume, and stepVolume.",
+    TRADING_BAD_STOPS: "Invalid SL/TP distance. Some brokers require minimum distances — use getSymbolInfo() to check slDistance/tpDistance.",
+    POSITION_NOT_FOUND: "Position not found. It may have been closed or the ID is incorrect.",
+    ORDER_NOT_FOUND: "Order not found. It may have been filled, expired, or cancelled.",
+    NO_MORE_ACCOUNTS_AVAILABLE: "No more accounts available. Check your cTrader ID has linked broker accounts.",
+    CONNECTIONS_LIMIT_EXCEEDED: "Too many connections from this app. Close other sessions or wait for them to expire.",
+    TRADING_DISABLED: "Trading is disabled on this account. Contact your broker.",
+};
+/** Error returned by the cTrader Open API — includes a machine-readable code and human description. */
+export class CTraderError extends Error {
+    code;
+    description;
+    retryAfter;
+    maintenanceEndTimestamp;
+    constructor(opts) {
+        const hint = ERROR_HINTS[opts.code];
+        const message = hint
+            ? `[${opts.code}] ${opts.description} — ${hint}`
+            : `[${opts.code}] ${opts.description}`;
+        super(message);
+        this.name = "CTraderError";
+        this.code = opts.code;
+        this.description = opts.description;
+        if (opts.retryAfter !== undefined)
+            this.retryAfter = opts.retryAfter;
+        if (opts.maintenanceEndTimestamp !== undefined)
+            this.maintenanceEndTimestamp = opts.maintenanceEndTimestamp;
+    }
+    /** Actionable recovery hint for this error, or undefined for unknown error codes */
+    get hint() {
+        return ERROR_HINTS[this.code];
+    }
+    get isAuthError() {
+        return (this.code === "OA_AUTH_TOKEN_EXPIRED" ||
+            this.code === "ACCOUNT_NOT_AUTHORIZED" ||
+            this.code === "CH_CLIENT_AUTH_FAILURE" ||
+            this.code === "CH_CLIENT_NOT_AUTHENTICATED" ||
+            this.code === "CH_ACCESS_TOKEN_INVALID" ||
+            this.code === "OAUTH_TOKEN_INVALIDATED");
+    }
+    get isRateLimit() {
+        return this.code === "REQUEST_FREQUENCY_EXCEEDED" || this.code === "BLOCKED_PAYLOAD_TYPE";
+    }
+    get isMaintenance() {
+        return this.code === "SERVER_IS_UNDER_MAINTENANCE";
+    }
+}
+/** Thrown when a request does not receive a response within the configured timeout. */
+export class RequestTimeoutError extends Error {
+    payloadType;
+    clientMsgId;
+    constructor(payloadType, clientMsgId, timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms (payloadType: ${payloadType}, id: ${clientMsgId}). Check your network connection or try increasing requestTimeoutMs.`);
+        this.name = "RequestTimeoutError";
+        this.payloadType = payloadType;
+        this.clientMsgId = clientMsgId;
+    }
+}
+/** Thrown when an operation is attempted while the WebSocket is not connected. */
+export class NotConnectedError extends Error {
+    constructor() {
+        super("Not connected to cTrader API. Call connect() first, or check that the connection hasn't been dropped.");
+        this.name = "NotConnectedError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/core/errors.js.map

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

package/dist/src/{helpers.d.ts → core/helpers.d.ts}

@@ -1,7 +1,7 @@
-import type { CTraderAccount } from "./modules/account.js";
-import type { CTraderMarket } from "./modules/market.js";
+import type { CTraderAccount } from "../modules/account.js";
+import type { CTraderMarket } from "../modules/market.js";
+import type { SlTpSpec } from "../protocol/types.js";
 import type { SymbolCache } from "./symbol-cache.js";
-import type { SlTpSpec } from "./types.js";
 export type { SlTpSpec };
 interface SlTpContext {
     account: CTraderAccount;

package/dist/src/core/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/core/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAc,QAAQ,EAAa,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,UAAU,WAAW;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,YAAY;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,QAAQ,GAAG,SAAS,EACxB,EAAE,EAAE,QAAQ,GAAG,SAAS,GACtB,OAAO,CAAC,YAAY,CAAC,CAmBvB"}

package/dist/src/{helpers.js → core/helpers.js}

@@ -3,7 +3,7 @@
  * Formula: pips * 10^(5 - pipPosition)
  */
 export function pipsToRelative(pips, pipPosition = 4) {
-    return Math.round(pips * Math.pow(10, 5 - pipPosition));
+    return Math.round(pips * 10 ** (5 - pipPosition));
 }
 /**
  * Resolve human-friendly SlTpSpec (pips / dollars / equity) into protocol-level
@@ -31,7 +31,7 @@ async function specToPips(cache, spec, volumeInUnits) {
     if ("pips" in spec)
         return spec.pips;
     const sym = await cache.getSymbolDetails();
-    const pipSize = Math.pow(10, -sym.pipPosition);
+    const pipSize = 10 ** -sym.pipPosition;
     const lotSize = sym.lotSize ?? 100_000;
     const lots = volumeInUnits / 100_000;
     // pipValue = pipSize * lotSize * quoteToAccountRate (assumed 1:1 for USD accounts)
@@ -63,9 +63,7 @@ class RequestCache {
     }
     getSymbolDetails() {
         if (this.symbolPromise === null) {
-            this.symbolPromise = this.ctx.market
-                .getSymbolsById([this.ctx.symbolId])
-                .then((symbols) => {
+            this.symbolPromise = this.ctx.market.getSymbolsById([this.ctx.symbolId]).then((symbols) => {
                 const sym = symbols[0];
                 if (sym === undefined) {
                     throw new Error(`Symbol details not found for id ${this.ctx.symbolId}`);
@@ -91,14 +89,18 @@ class RequestCache {
         return new Promise((resolve, reject) => {
             const timeout = setTimeout(() => {
                 unsub();
-                void this.ctx.market.unsubscribeSpots([this.ctx.symbolId]).catch(() => { });
+                void this.ctx.market.unsubscribeSpots([this.ctx.symbolId]).catch(() => {
+                    /* fire-and-forget cleanup */
+                });
                 reject(new Error(`Timed out waiting for spot price on symbol ${this.ctx.symbolId}`));
             }, 10_000);
             const unsub = this.ctx.market.onSpot((event) => {
                 if (event.symbolId === this.ctx.symbolId) {
                     clearTimeout(timeout);
                     unsub();
-                    void this.ctx.market.unsubscribeSpots([this.ctx.symbolId]).catch(() => { });
+                    void this.ctx.market.unsubscribeSpots([this.ctx.symbolId]).catch(() => {
+                        /* fire-and-forget cleanup */
+                    });
                     resolve(event);
                 }
             });

package/dist/src/core/helpers.js.map

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

package/dist/src/{symbol-cache.d.ts → core/symbol-cache.d.ts}

@@ -1,5 +1,5 @@
-import type { CTraderMarket } from "./modules/market.js";
-import type { LightSymbol } from "./types.js";
+import type { CTraderMarket } from "../modules/market.js";
+import type { LightSymbol } from "../protocol/types.js";
 export declare class SymbolCache {
     private readonly market;
     private nameToId;

package/dist/src/core/symbol-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-cache.d.ts","sourceRoot":"","sources":["../../../src/core/symbol-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,UAAU,CAAyC;gBAE/C,MAAM,EAAE,aAAa;IAI3B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAMhB,WAAW;YAKX,aAAa;CAI3B"}

package/dist/src/core/symbol-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-cache.js","sourceRoot":"","sources":["../../../src/core/symbol-cache.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,WAAW;IACN,MAAM,CAAgB;IAC/B,QAAQ,GAA+B,IAAI,CAAC;IAC5C,UAAU,GAAoC,IAAI,CAAC;IAE3D,YAAY,MAAqB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAA2B;QAC1C,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,OAAO,UAAU,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,SAAS;YACnB,MAAM,IAAI,KAAK,CACd,sBAAsB,UAAU,sDAAsD,CACtF,CAAC;QACH,OAAO,EAAE,CAAC;IACX,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAA2B;QAC1C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,WAAW;QACxB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,QAAS,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,aAAa;QAC1B,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,UAAW,CAAC;IACzB,CAAC;CACD"}