ctrader-x 0.1.0

package/dist/shared/typed-event-emitter.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedEventEmitter = void 0;
+const node_events_1 = require("node:events");
+/**
+ * Wraps Node's EventEmitter instead of extending it, so `emit` stays protected:
+ * consumers can only listen, only the owning class can trigger events.
+ */
+class TypedEventEmitter {
+    emitter = new node_events_1.EventEmitter();
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    emit(event, ...args) {
+        return this.emitter.emit(event, ...args);
+    }
+}
+exports.TypedEventEmitter = TypedEventEmitter;
+//# sourceMappingURL=typed-event-emitter.js.map

package/dist/shared/typed-event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-event-emitter.js","sourceRoot":"","sources":["../../src/shared/typed-event-emitter.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAI3C;;;GAGG;AACH,MAAa,iBAAiB;IACT,OAAO,GAAG,IAAI,0BAAY,EAAE,CAAC;IAE9C,EAAE,CAAwC,KAAa,EAAE,QAA4C;QACjG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAwC,KAAa,EAAE,QAA4C;QACnG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,GAAG,CAAwC,KAAa,EAAE,QAA4C;QAClG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC;IAChB,CAAC;IAES,IAAI,CAAwC,KAAa,EAAE,GAAG,IAAqB;QACzF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;CACJ;AArBD,8CAqBC"}

package/dist/trading/index.d.ts

@@ -0,0 +1,2 @@
+export * from './spotware-trading';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/trading/index.js

@@ -0,0 +1,18 @@
+"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-trading"), exports);
+//# sourceMappingURL=index.js.map

package/dist/trading/index.js.map

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

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

@@ -0,0 +1,59 @@
+import type { SpotwareClient } from '../client';
+import { ProtoOAExecutionEvent, ProtoOAOrder, ProtoOAPosition, ProtoOATimeInForce, ProtoOATradeSide } from '../types';
+export interface IPlaceMarketOrderParams {
+    symbolId: number;
+    tradeSide: ProtoOATradeSide;
+    /** In units (e.g. 1000 for 1000 units) — converted internally, not the wire's cents form. */
+    volume: number;
+    /** Absolute price (e.g. 1.23456), not scaled. */
+    stopLoss?: number;
+    /** Absolute price (e.g. 1.23456), not scaled. */
+    takeProfit?: number;
+    comment?: string;
+    label?: string;
+}
+export interface IPlaceLimitOrderParams extends IPlaceMarketOrderParams {
+    /** Absolute price (e.g. 1.23456), not scaled. */
+    limitPrice: number;
+    timeInForce?: ProtoOATimeInForce;
+    expirationTimestamp?: number;
+}
+export interface IAmendOrderParams {
+    orderId: number;
+    /** In units — converted internally, not the wire's cents form. */
+    volume?: number;
+    limitPrice?: number;
+    stopPrice?: number;
+    stopLoss?: number;
+    takeProfit?: number;
+    expirationTimestamp?: number;
+}
+export interface IClosePositionParams {
+    positionId: number;
+    /** In units — converted internally, not the wire's cents form. */
+    volume: number;
+}
+export interface IOpenPositionsAndOrders {
+    positions: ProtoOAPosition[];
+    orders: ProtoOAOrder[];
+}
+/**
+ * Places/modifies/cancels orders and closes positions, via `client`. Knows nothing about
+ * market data streaming. Order mutations have no dedicated response message: the outcome
+ * arrives as a ProtoOAExecutionEvent on success, or rejects via ProtoOAOrderErrorEvent (which
+ * `client` already treats as an error) on failure. Volume here is in units, not the wire's
+ * cents representation; prices other than relative SL/TP stay plain decimals, matching the
+ * protocol's own convention (confirmed against Spotware's official SDK, not assumed).
+ */
+export declare class SpotwareTrading {
+    private readonly client;
+    constructor(client: SpotwareClient);
+    placeMarketOrder(params: IPlaceMarketOrderParams): Promise<ProtoOAExecutionEvent>;
+    placeLimitOrder(params: IPlaceLimitOrderParams): Promise<ProtoOAExecutionEvent>;
+    amendOrder(params: IAmendOrderParams): Promise<ProtoOAExecutionEvent>;
+    cancelOrder(orderId: number): Promise<ProtoOAExecutionEvent>;
+    closePosition(params: IClosePositionParams): Promise<ProtoOAExecutionEvent>;
+    getOpenPositionsAndOrders(): Promise<IOpenPositionsAndOrders>;
+    private placeOrder;
+}
+//# sourceMappingURL=spotware-trading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-trading.d.ts","sourceRoot":"","sources":["../../src/trading/spotware-trading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAIH,qBAAqB,EAErB,YAAY,EAGZ,eAAe,EAGf,kBAAkB,EAClB,gBAAgB,EACnB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACnE,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAEnD,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIjF,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIzE,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiBrE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAO5D,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAe3E,yBAAyB,IAAI,OAAO,CAAC,uBAAuB,CAAC;YAQrD,UAAU;CAsB3B"}

package/dist/trading/spotware-trading.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotwareTrading = void 0;
+const spotware_scale_1 = require("../shared/spotware-scale");
+const types_1 = require("../types");
+/**
+ * Places/modifies/cancels orders and closes positions, via `client`. Knows nothing about
+ * market data streaming. Order mutations have no dedicated response message: the outcome
+ * arrives as a ProtoOAExecutionEvent on success, or rejects via ProtoOAOrderErrorEvent (which
+ * `client` already treats as an error) on failure. Volume here is in units, not the wire's
+ * cents representation; prices other than relative SL/TP stay plain decimals, matching the
+ * protocol's own convention (confirmed against Spotware's official SDK, not assumed).
+ */
+class SpotwareTrading {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    placeMarketOrder(params) {
+        return this.placeOrder({ ...params, orderType: types_1.ProtoOAOrderType.MARKET });
+    }
+    placeLimitOrder(params) {
+        return this.placeOrder({ ...params, orderType: types_1.ProtoOAOrderType.LIMIT });
+    }
+    async amendOrder(params) {
+        const request = types_1.ProtoOAAmendOrderReq.fromPartial({
+            ctidTraderAccountId: this.client.ctidTraderAccountId,
+            orderId: params.orderId,
+            volume: params.volume === undefined ? undefined : params.volume * spotware_scale_1.SPOTWARE_VOLUME_SCALE,
+            limitPrice: params.limitPrice,
+            stopPrice: params.stopPrice,
+            stopLoss: params.stopLoss,
+            takeProfit: params.takeProfit,
+            expirationTimestamp: params.expirationTimestamp
+        });
+        const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_AMEND_ORDER_REQ, types_1.ProtoOAAmendOrderReq.encode(request).finish());
+        return types_1.ProtoOAExecutionEvent.decode(response.payload ?? new Uint8Array());
+    }
+    async cancelOrder(orderId) {
+        const request = types_1.ProtoOACancelOrderReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId, orderId });
+        const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_CANCEL_ORDER_REQ, types_1.ProtoOACancelOrderReq.encode(request).finish());
+        return types_1.ProtoOAExecutionEvent.decode(response.payload ?? new Uint8Array());
+    }
+    async closePosition(params) {
+        const request = types_1.ProtoOAClosePositionReq.fromPartial({
+            ctidTraderAccountId: this.client.ctidTraderAccountId,
+            positionId: params.positionId,
+            volume: params.volume * spotware_scale_1.SPOTWARE_VOLUME_SCALE
+        });
+        const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_CLOSE_POSITION_REQ, types_1.ProtoOAClosePositionReq.encode(request).finish());
+        return types_1.ProtoOAExecutionEvent.decode(response.payload ?? new Uint8Array());
+    }
+    async getOpenPositionsAndOrders() {
+        const request = types_1.ProtoOAReconcileReq.fromPartial({ ctidTraderAccountId: this.client.ctidTraderAccountId });
+        const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_RECONCILE_REQ, types_1.ProtoOAReconcileReq.encode(request).finish());
+        const reconcile = types_1.ProtoOAReconcileRes.decode(response.payload ?? new Uint8Array());
+        return { positions: reconcile.position, orders: reconcile.order };
+    }
+    async placeOrder(params) {
+        const request = types_1.ProtoOANewOrderReq.fromPartial({
+            ctidTraderAccountId: this.client.ctidTraderAccountId,
+            symbolId: params.symbolId,
+            orderType: params.orderType,
+            tradeSide: params.tradeSide,
+            volume: params.volume * spotware_scale_1.SPOTWARE_VOLUME_SCALE,
+            limitPrice: 'limitPrice' in params ? params.limitPrice : undefined,
+            timeInForce: 'timeInForce' in params ? params.timeInForce : undefined,
+            expirationTimestamp: 'expirationTimestamp' in params ? params.expirationTimestamp : undefined,
+            stopLoss: params.stopLoss,
+            takeProfit: params.takeProfit,
+            comment: params.comment,
+            label: params.label
+        });
+        const response = await this.client.send(types_1.ProtoOAPayloadType.PROTO_OA_NEW_ORDER_REQ, encodeNewOrderReq(request));
+        return types_1.ProtoOAExecutionEvent.decode(response.payload ?? new Uint8Array());
+    }
+}
+exports.SpotwareTrading = SpotwareTrading;
+// ts-proto skips a required field on the wire whenever its value equals the field's implicit
+// proto2 default — for an enum with no explicit `[default = ...]` annotation, that's always its
+// first declared member. orderType and tradeSide have no such annotation, so MARKET (1) and BUY
+// (1) — the two most common choices — get silently dropped, and cTrader's server rejects the
+// message as missing them. Confirmed this isn't fixable via ts-proto's codegen flags
+// (disableProto2DefaultValues only affects fields with an explicit default). Field order doesn't
+// matter on the wire, so appending the dropped ones after the normal encode is a safe, minimal
+// fix that doesn't require hand-editing generated code.
+function encodeNewOrderReq(request) {
+    const writer = types_1.ProtoOANewOrderReq.encode(request);
+    if (request.orderType === types_1.ProtoOAOrderType.MARKET) {
+        writer.uint32(32).int32(request.orderType);
+    }
+    if (request.tradeSide === types_1.ProtoOATradeSide.BUY) {
+        writer.uint32(40).int32(request.tradeSide);
+    }
+    return writer.finish();
+}
+//# sourceMappingURL=spotware-trading.js.map

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

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

package/dist/transport/frame-codec.d.ts

@@ -0,0 +1,6 @@
+export declare function encodeFrame(payload: Uint8Array): Buffer;
+export declare class FrameDecoder {
+    private buffer;
+    push(chunk: Buffer): Buffer[];
+}
+//# sourceMappingURL=frame-codec.d.ts.map

package/dist/transport/frame-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-codec.d.ts","sourceRoot":"","sources":["../../src/transport/frame-codec.ts"],"names":[],"mappings":"AAMA,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAKvD;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAA2B;IAEzC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAsBhC"}

package/dist/transport/frame-codec.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameDecoder = void 0;
+exports.encodeFrame = encodeFrame;
+const LENGTH_PREFIX_BYTES = 4;
+// cTrader closes the socket well before a legitimate message gets anywhere near this size;
+// a length past it means the stream desynced (e.g. a framing bug), not a big message.
+const MAX_FRAME_BYTES = 16 * 1024 * 1024;
+function encodeFrame(payload) {
+    const length = Buffer.alloc(LENGTH_PREFIX_BYTES);
+    length.writeUInt32BE(payload.byteLength);
+    return Buffer.concat([length, payload]);
+}
+class FrameDecoder {
+    buffer = Buffer.alloc(0);
+    push(chunk) {
+        this.buffer = this.buffer.byteLength === 0 ? chunk : Buffer.concat([this.buffer, chunk]);
+        const frames = [];
+        while (this.buffer.byteLength >= LENGTH_PREFIX_BYTES) {
+            const frameLength = this.buffer.readUInt32BE(0);
+            if (frameLength > MAX_FRAME_BYTES) {
+                throw new Error(`Frame length ${frameLength} exceeds the ${MAX_FRAME_BYTES} byte limit; stream is desynced`);
+            }
+            const frameEnd = LENGTH_PREFIX_BYTES + frameLength;
+            if (this.buffer.byteLength < frameEnd) {
+                break;
+            }
+            frames.push(this.buffer.subarray(LENGTH_PREFIX_BYTES, frameEnd));
+            this.buffer = this.buffer.subarray(frameEnd);
+        }
+        return frames;
+    }
+}
+exports.FrameDecoder = FrameDecoder;
+//# sourceMappingURL=frame-codec.js.map

package/dist/transport/frame-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-codec.js","sourceRoot":"","sources":["../../src/transport/frame-codec.ts"],"names":[],"mappings":";;;AAMA,kCAKC;AAXD,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,2FAA2F;AAC3F,sFAAsF;AACtF,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzC,SAAgB,WAAW,CAAC,OAAmB;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACjD,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAa,YAAY;IACb,MAAM,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzC,IAAI,CAAC,KAAa;QACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAEzF,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,mBAAmB,EAAE,CAAC;YACnD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,IAAI,WAAW,GAAG,eAAe,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,gBAAgB,WAAW,gBAAgB,eAAe,iCAAiC,CAAC,CAAC;YACjH,CAAC;YAED,MAAM,QAAQ,GAAG,mBAAmB,GAAG,WAAW,CAAC;YACnD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,QAAQ,EAAE,CAAC;gBACpC,MAAM;YACV,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AAzBD,oCAyBC"}

package/dist/transport/index.d.ts

@@ -0,0 +1,4 @@
+export * from './reconnect-backoff';
+export * from './spotware-host.enum';
+export * from './spotware-transport';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,20 @@
+"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("./reconnect-backoff"), exports);
+__exportStar(require("./spotware-host.enum"), exports);
+__exportStar(require("./spotware-transport"), exports);
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,uDAAqC;AACrC,uDAAqC"}

package/dist/transport/rate-limiter.d.ts

@@ -0,0 +1,11 @@
+export declare class RateLimiter {
+    private readonly intervalMs;
+    private readonly queue;
+    private lastRunAt;
+    private timer;
+    constructor(intervalMs: number);
+    schedule(): Promise<void>;
+    dispose(): void;
+    private ensureTimerRunning;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/transport/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/transport/rate-limiter.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IAKR,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,KAAK,CAA6B;gBAEb,UAAU,EAAE,MAAM;IAE/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAezB,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,kBAAkB;CAiB7B"}

package/dist/transport/rate-limiter.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+class RateLimiter {
+    intervalMs;
+    queue = [];
+    lastRunAt = 0;
+    timer;
+    constructor(intervalMs) {
+        this.intervalMs = intervalMs;
+    }
+    schedule() {
+        return new Promise((resolve) => {
+            const elapsedSinceLastRun = Date.now() - this.lastRunAt;
+            if (!this.timer && elapsedSinceLastRun >= this.intervalMs) {
+                this.lastRunAt = Date.now();
+                resolve();
+                return;
+            }
+            this.queue.push(resolve);
+            this.ensureTimerRunning();
+        });
+    }
+    dispose() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        this.queue.length = 0;
+    }
+    ensureTimerRunning() {
+        if (this.timer) {
+            return;
+        }
+        this.timer = setInterval(() => {
+            const next = this.queue.shift();
+            if (!next) {
+                clearInterval(this.timer);
+                this.timer = undefined;
+                return;
+            }
+            this.lastRunAt = Date.now();
+            next();
+        }, this.intervalMs);
+    }
+}
+exports.RateLimiter = RateLimiter;
+//# sourceMappingURL=rate-limiter.js.map

package/dist/transport/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/transport/rate-limiter.ts"],"names":[],"mappings":";;;AAAA,MAAa,WAAW;IAKS;IAJZ,KAAK,GAAsB,EAAE,CAAC;IACvC,SAAS,GAAG,CAAC,CAAC;IACd,KAAK,CAA6B;IAE1C,YAA6B,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IAAG,CAAC;IAEnD,QAAQ;QACJ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YAExD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,mBAAmB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAC;gBACV,OAAO;YACX,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEO,kBAAkB;QACtB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO;QACX,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;gBACvB,OAAO;YACX,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC;QACX,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;CACJ;AA/CD,kCA+CC"}

package/dist/transport/reconnect-backoff.d.ts

@@ -0,0 +1,12 @@
+export interface IReconnectBackoffOptions {
+    baseDelayMs: number;
+    maxDelayMs: number;
+    factor: number;
+}
+export declare const DEFAULT_RECONNECT_BACKOFF_OPTIONS: IReconnectBackoffOptions;
+/**
+ * Equal jitter: half the capped exponential delay is fixed, half is randomized,
+ * so retries stay spread out under load instead of synchronizing into bursts.
+ */
+export declare function calculateReconnectDelayMs(attempt: number, options?: IReconnectBackoffOptions): number;
+//# sourceMappingURL=reconnect-backoff.d.ts.map

package/dist/transport/reconnect-backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-backoff.d.ts","sourceRoot":"","sources":["../../src/transport/reconnect-backoff.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,iCAAiC,EAAE,wBAI/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA4D,GAAG,MAAM,CAMxI"}

package/dist/transport/reconnect-backoff.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RECONNECT_BACKOFF_OPTIONS = void 0;
+exports.calculateReconnectDelayMs = calculateReconnectDelayMs;
+exports.DEFAULT_RECONNECT_BACKOFF_OPTIONS = {
+    baseDelayMs: 500,
+    maxDelayMs: 30_000,
+    factor: 2
+};
+/**
+ * Equal jitter: half the capped exponential delay is fixed, half is randomized,
+ * so retries stay spread out under load instead of synchronizing into bursts.
+ */
+function calculateReconnectDelayMs(attempt, options = exports.DEFAULT_RECONNECT_BACKOFF_OPTIONS) {
+    const exponentialDelay = options.baseDelayMs * options.factor ** attempt;
+    const cappedDelay = Math.min(exponentialDelay, options.maxDelayMs);
+    const guaranteedDelay = cappedDelay / 2;
+    return Math.round(guaranteedDelay + Math.random() * guaranteedDelay);
+}
+//# sourceMappingURL=reconnect-backoff.js.map

package/dist/transport/reconnect-backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-backoff.js","sourceRoot":"","sources":["../../src/transport/reconnect-backoff.ts"],"names":[],"mappings":";;;AAgBA,8DAMC;AAhBY,QAAA,iCAAiC,GAA6B;IACvE,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,SAAgB,yBAAyB,CAAC,OAAe,EAAE,UAAoC,yCAAiC;IAC5H,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC;IAExC,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC,CAAC;AACzE,CAAC"}

package/dist/transport/spotware-host.enum.d.ts

@@ -0,0 +1,6 @@
+export declare enum SpotwareHost {
+    DEMO = "demo.ctraderapi.com",
+    LIVE = "live.ctraderapi.com"
+}
+export declare const SPOTWARE_PORT = 5035;
+//# sourceMappingURL=spotware-host.enum.d.ts.map

package/dist/transport/spotware-host.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-host.enum.d.ts","sourceRoot":"","sources":["../../src/transport/spotware-host.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY;IACpB,IAAI,wBAAwB;IAC5B,IAAI,wBAAwB;CAC/B;AAED,eAAO,MAAM,aAAa,OAAO,CAAC"}

package/dist/transport/spotware-host.enum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPOTWARE_PORT = exports.SpotwareHost = void 0;
+var SpotwareHost;
+(function (SpotwareHost) {
+    SpotwareHost["DEMO"] = "demo.ctraderapi.com";
+    SpotwareHost["LIVE"] = "live.ctraderapi.com";
+})(SpotwareHost || (exports.SpotwareHost = SpotwareHost = {}));
+exports.SPOTWARE_PORT = 5035;
+//# sourceMappingURL=spotware-host.enum.js.map

package/dist/transport/spotware-host.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-host.enum.js","sourceRoot":"","sources":["../../src/transport/spotware-host.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAGX;AAHD,WAAY,YAAY;IACpB,4CAA4B,CAAA;IAC5B,4CAA4B,CAAA;AAChC,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAEY,QAAA,aAAa,GAAG,IAAI,CAAC"}

package/dist/transport/spotware-rate-limiter.d.ts

@@ -0,0 +1,8 @@
+import { ProtoOAPayloadType } from '../types';
+export declare class SpotwareRateLimiter {
+    private readonly fivePerSecond;
+    private readonly fiftyPerSecond;
+    throttle(payloadType: ProtoOAPayloadType): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=spotware-rate-limiter.d.ts.map

package/dist/transport/spotware-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-rate-limiter.d.ts","sourceRoot":"","sources":["../../src/transport/spotware-rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAe9C,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiD;IAE1E,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,OAAO,IAAI,IAAI;CAIlB"}

package/dist/transport/spotware-rate-limiter.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpotwareRateLimiter = void 0;
+const types_1 = require("../types");
+const rate_limiter_1 = require("./rate-limiter");
+// Spotware limits these to 5/sec and everything else to 50/sec.
+// Intervals are set just above the theoretical minimum to stay clear of the limit.
+// https://connect.spotware.com/docs/frequently-asked-questions
+const FIVE_PER_SECOND_INTERVAL_MS = 210;
+const FIFTY_PER_SECOND_INTERVAL_MS = 21;
+const FIVE_PER_SECOND_PAYLOAD_TYPES = new Set([
+    types_1.ProtoOAPayloadType.PROTO_OA_GET_TRENDBARS_REQ,
+    types_1.ProtoOAPayloadType.PROTO_OA_GET_TICKDATA_REQ,
+    types_1.ProtoOAPayloadType.PROTO_OA_DEAL_LIST_REQ
+]);
+class SpotwareRateLimiter {
+    fivePerSecond = new rate_limiter_1.RateLimiter(FIVE_PER_SECOND_INTERVAL_MS);
+    fiftyPerSecond = new rate_limiter_1.RateLimiter(FIFTY_PER_SECOND_INTERVAL_MS);
+    async throttle(payloadType) {
+        const limiter = FIVE_PER_SECOND_PAYLOAD_TYPES.has(payloadType) ? this.fivePerSecond : this.fiftyPerSecond;
+        await limiter.schedule();
+    }
+    dispose() {
+        this.fivePerSecond.dispose();
+        this.fiftyPerSecond.dispose();
+    }
+}
+exports.SpotwareRateLimiter = SpotwareRateLimiter;
+//# sourceMappingURL=spotware-rate-limiter.js.map

package/dist/transport/spotware-rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-rate-limiter.js","sourceRoot":"","sources":["../../src/transport/spotware-rate-limiter.ts"],"names":[],"mappings":";;;AAAA,oCAA8C;AAC9C,iDAA6C;AAE7C,gEAAgE;AAChE,mFAAmF;AACnF,+DAA+D;AAC/D,MAAM,2BAA2B,GAAG,GAAG,CAAC;AACxC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAExC,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAqB;IAC9D,0BAAkB,CAAC,0BAA0B;IAC7C,0BAAkB,CAAC,yBAAyB;IAC5C,0BAAkB,CAAC,sBAAsB;CAC5C,CAAC,CAAC;AAEH,MAAa,mBAAmB;IACX,aAAa,GAAG,IAAI,0BAAW,CAAC,2BAA2B,CAAC,CAAC;IAC7D,cAAc,GAAG,IAAI,0BAAW,CAAC,4BAA4B,CAAC,CAAC;IAEhF,KAAK,CAAC,QAAQ,CAAC,WAA+B;QAC1C,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;QAC1G,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO;QACH,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;CACJ;AAbD,kDAaC"}

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

@@ -0,0 +1,63 @@
+import type { Duplex } from 'node:stream';
+import { TypedEventEmitter, type EventMap } from '../shared/typed-event-emitter';
+import { ProtoMessage } from '../types';
+import { type IReconnectBackoffOptions } from './reconnect-backoff';
+import { SpotwareHost } from './spotware-host.enum';
+export type SpotwareDisconnectReason = 'manual' | 'dropped';
+/**
+ * Resolves once the connection is fully ready to use (e.g. after the TLS handshake).
+ * Lets tests substitute a plain local TCP server without touching any transport logic.
+ */
+export type SpotwareSocketFactory = (port: number, host: string) => Promise<Duplex>;
+export interface ISpotwareTransportEvents extends EventMap {
+    connected: [];
+    disconnected: [reason: SpotwareDisconnectReason];
+    reconnecting: [attempt: number, delayMs: number];
+    message: [message: ProtoMessage];
+    error: [error: Error];
+}
+export interface ISpotwareTransportOptions {
+    host: SpotwareHost;
+    port?: number;
+    reconnectBackoff?: IReconnectBackoffOptions;
+    socketFactory?: SpotwareSocketFactory;
+    staleConnectionTimeoutMs?: number;
+}
+/**
+ * Opens the TCP/TLS connection to a cTrader host, frames Protobuf messages on the wire,
+ * and auto-reconnects with backoff on any drop that wasn't requested via disconnect().
+ * Knows nothing about auth or trading: messages are passed through as the raw ProtoMessage
+ * envelope, undecoded, for the client module to interpret.
+ */
+export declare class SpotwareTransport extends TypedEventEmitter<ISpotwareTransportEvents> {
+    private readonly host;
+    private readonly port;
+    private readonly reconnectBackoffOptions;
+    private readonly socketFactory;
+    private readonly staleConnectionTimeoutMs;
+    private readonly livenessCheckIntervalMs;
+    private readonly rateLimiter;
+    private socket;
+    private heartbeatTimer;
+    private livenessTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private disconnectRequested;
+    private lastMessageReceivedAt;
+    private hasConnectedOnce;
+    constructor(options: ISpotwareTransportOptions);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: ProtoMessage): Promise<void>;
+    private attemptConnection;
+    private handleData;
+    private handleClose;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private startHeartbeat;
+    private startLivenessWatchdog;
+    private stopLivenessWatchdog;
+    private stopHeartbeat;
+    private buildHeartbeatMessage;
+}
+//# sourceMappingURL=spotware-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spotware-transport.d.ts","sourceRoot":"","sources":["../../src/transport/spotware-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAuB,YAAY,EAAoB,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAgE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAElI,OAAO,EAAiB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAanE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAqBpF,MAAM,WAAW,wBAAyB,SAAQ,QAAQ;IACtD,SAAS,EAAE,EAAE,CAAC;IACd,YAAY,EAAE,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IACjD,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB,CAAC,wBAAwB,CAAC;IAC9E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2B;IACnE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,qBAAqB,CAAK;IAKlC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,EAAE,yBAAyB;IAU9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAelC,iBAAiB;IA+B/B,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,qBAAqB;CAMhC"}