@forgecharts/sdk 1.1.23 → 1.1.28

package/dist/trading/__tests__/TradingOverlayStore.test.js

@@ -0,0 +1,267 @@
+/**
+ * TradingOverlayStore — unit tests
+ *
+ * Covers:
+ *   - Orders: set, upsert, remove, getByGroup
+ *   - Positions: set, upsert, remove
+ *   - Fills: push, getFills, getFillsByOrder
+ *   - clear() resets everything
+ *   - snapshot() reflects current state
+ *   - onChange subscriber fires on every mutation
+ *   - Both unmanaged and managed pathways can write into the same store
+ *   - groupId-based linked orders coexist correctly
+ *   - TP / SL / entry roles are stored verbatim
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { TradingOverlayStore } from '../TradingOverlayStore';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeOrder(id, overrides = {}) {
+    return {
+        id,
+        role: 'entry',
+        side: 'buy',
+        status: 'open',
+        price: 100,
+        qty: 1,
+        ...overrides,
+    };
+}
+function makePosition(id, overrides = {}) {
+    return {
+        id,
+        side: 'long',
+        status: 'open',
+        entryPrice: 100,
+        qty: 1,
+        ...overrides,
+    };
+}
+function makeFill(id, orderId) {
+    return {
+        id,
+        side: 'buy',
+        price: 100,
+        qty: 1,
+        timestamp: Date.now(),
+        ...(orderId !== undefined ? { orderId } : {}),
+    };
+}
+// ─── Orders ───────────────────────────────────────────────────────────────────
+describe('TradingOverlayStore — orders', () => {
+    let store;
+    beforeEach(() => { store = new TradingOverlayStore(); });
+    it('starts empty', () => {
+        expect(store.getOrders()).toHaveLength(0);
+    });
+    it('setOrders replaces the entire set', () => {
+        store.setOrders([makeOrder('a'), makeOrder('b')]);
+        expect(store.getOrders()).toHaveLength(2);
+        store.setOrders([makeOrder('c')]);
+        expect(store.getOrders()).toHaveLength(1);
+        expect(store.getOrders()[0].id).toBe('c');
+    });
+    it('upsertOrder inserts a new order', () => {
+        store.upsertOrder(makeOrder('o1'));
+        expect(store.getOrders()).toHaveLength(1);
+        expect(store.getOrders()[0].id).toBe('o1');
+    });
+    it('upsertOrder replaces an existing order by id', () => {
+        store.upsertOrder(makeOrder('o1', { price: 100 }));
+        store.upsertOrder(makeOrder('o1', { price: 200 }));
+        expect(store.getOrders()).toHaveLength(1);
+        expect(store.getOrders()[0].price).toBe(200);
+    });
+    it('removeOrder removes by id', () => {
+        store.upsertOrder(makeOrder('o1'));
+        store.upsertOrder(makeOrder('o2'));
+        store.removeOrder('o1');
+        expect(store.getOrders()).toHaveLength(1);
+        expect(store.getOrders()[0].id).toBe('o2');
+    });
+    it('removeOrder is a silent no-op for unknown id', () => {
+        store.upsertOrder(makeOrder('o1'));
+        store.removeOrder('nonexistent');
+        expect(store.getOrders()).toHaveLength(1);
+    });
+    it('getOrdersByGroup filters correctly', () => {
+        store.setOrders([
+            makeOrder('entry', { groupId: 'bracket1', role: 'entry' }),
+            makeOrder('sl', { groupId: 'bracket1', role: 'stop_loss' }),
+            makeOrder('tp', { groupId: 'bracket1', role: 'take_profit' }),
+            makeOrder('lone', { role: 'limit' }), // no groupId
+        ]);
+        const group = store.getOrdersByGroup('bracket1');
+        expect(group).toHaveLength(3);
+        const roles = group.map(o => o.role).sort();
+        expect(roles).toEqual(['entry', 'stop_loss', 'take_profit']);
+    });
+    it('getOrdersByGroup returns [] for unknown groupId', () => {
+        store.upsertOrder(makeOrder('o1', { groupId: 'g1' }));
+        expect(store.getOrdersByGroup('g2')).toHaveLength(0);
+    });
+});
+// ─── Positions ────────────────────────────────────────────────────────────────
+describe('TradingOverlayStore — positions', () => {
+    let store;
+    beforeEach(() => { store = new TradingOverlayStore(); });
+    it('starts empty', () => {
+        expect(store.getPositions()).toHaveLength(0);
+    });
+    it('setPositions replaces the entire set', () => {
+        store.setPositions([makePosition('p1'), makePosition('p2')]);
+        expect(store.getPositions()).toHaveLength(2);
+        store.setPositions([]);
+        expect(store.getPositions()).toHaveLength(0);
+    });
+    it('upsertPosition inserts when missing', () => {
+        store.upsertPosition(makePosition('p1'));
+        expect(store.getPositions()).toHaveLength(1);
+    });
+    it('upsertPosition updates when id matches', () => {
+        store.upsertPosition(makePosition('p1', { qty: 1 }));
+        store.upsertPosition(makePosition('p1', { qty: 5 }));
+        expect(store.getPositions()).toHaveLength(1);
+        expect(store.getPositions()[0].qty).toBe(5);
+    });
+    it('removePosition removes by id', () => {
+        store.upsertPosition(makePosition('p1'));
+        store.removePosition('p1');
+        expect(store.getPositions()).toHaveLength(0);
+    });
+    it('removePosition is a silent no-op for unknown id', () => {
+        expect(() => store.removePosition('ghost')).not.toThrow();
+    });
+});
+// ─── Fills ────────────────────────────────────────────────────────────────────
+describe('TradingOverlayStore — fills', () => {
+    let store;
+    beforeEach(() => { store = new TradingOverlayStore(); });
+    it('starts empty', () => {
+        expect(store.getFills()).toHaveLength(0);
+    });
+    it('pushExecution appends fills in order', () => {
+        store.pushExecution(makeFill('f1'));
+        store.pushExecution(makeFill('f2'));
+        expect(store.getFills()).toHaveLength(2);
+        expect(store.getFills()[0].id).toBe('f1');
+        expect(store.getFills()[1].id).toBe('f2');
+    });
+    it('getFillsByOrder filters by orderId', () => {
+        store.pushExecution(makeFill('f1', 'orderA'));
+        store.pushExecution(makeFill('f2', 'orderB'));
+        store.pushExecution(makeFill('f3', 'orderA'));
+        const fills = store.getFillsByOrder('orderA');
+        expect(fills).toHaveLength(2);
+        expect(fills.map(f => f.id)).toEqual(['f1', 'f3']);
+    });
+    it('getFillsByOrder returns [] for unknown orderId', () => {
+        store.pushExecution(makeFill('f1', 'o1'));
+        expect(store.getFillsByOrder('unknown')).toHaveLength(0);
+    });
+});
+// ─── clear & snapshot ─────────────────────────────────────────────────────────
+describe('TradingOverlayStore — clear and snapshot', () => {
+    let store;
+    beforeEach(() => { store = new TradingOverlayStore(); });
+    it('clear() removes all state', () => {
+        store.upsertOrder(makeOrder('o1'));
+        store.upsertPosition(makePosition('p1'));
+        store.pushExecution(makeFill('f1'));
+        store.clear();
+        expect(store.getOrders()).toHaveLength(0);
+        expect(store.getPositions()).toHaveLength(0);
+        expect(store.getFills()).toHaveLength(0);
+    });
+    it('snapshot() reflects the current state', () => {
+        store.upsertOrder(makeOrder('o1'));
+        store.upsertPosition(makePosition('p1'));
+        store.pushExecution(makeFill('f1'));
+        const snap = store.snapshot();
+        expect(snap.orders).toHaveLength(1);
+        expect(snap.positions).toHaveLength(1);
+        expect(snap.fills).toHaveLength(1);
+    });
+});
+// ─── onChange subscription ────────────────────────────────────────────────────
+describe('TradingOverlayStore — onChange notifications', () => {
+    let store;
+    beforeEach(() => { store = new TradingOverlayStore(); });
+    function countCalls(fn) {
+        const spy = vi.fn();
+        const unsub = store.onChange(spy);
+        fn();
+        unsub();
+        return spy.mock.calls.length;
+    }
+    it('fires on setOrders', () => {
+        expect(countCalls(() => store.setOrders([makeOrder('o1')]))).toBe(1);
+    });
+    it('fires on upsertOrder', () => {
+        expect(countCalls(() => store.upsertOrder(makeOrder('o1')))).toBe(1);
+    });
+    it('fires on removeOrder (when item exists)', () => {
+        store.upsertOrder(makeOrder('o1'));
+        expect(countCalls(() => store.removeOrder('o1'))).toBe(1);
+    });
+    it('does NOT fire on removeOrder for unknown id', () => {
+        expect(countCalls(() => store.removeOrder('ghost'))).toBe(0);
+    });
+    it('fires on setPositions', () => {
+        expect(countCalls(() => store.setPositions([makePosition('p1')]))).toBe(1);
+    });
+    it('fires on upsertPosition', () => {
+        expect(countCalls(() => store.upsertPosition(makePosition('p1')))).toBe(1);
+    });
+    it('fires on pushExecution', () => {
+        expect(countCalls(() => store.pushExecution(makeFill('f1')))).toBe(1);
+    });
+    it('fires on clear', () => {
+        expect(countCalls(() => store.clear())).toBe(1);
+    });
+    it('unsubscribe stops future notifications', () => {
+        const spy = vi.fn();
+        const unsub = store.onChange(spy);
+        unsub();
+        store.upsertOrder(makeOrder('o1'));
+        expect(spy).not.toHaveBeenCalled();
+    });
+});
+// ─── Shared overlay: both modes write into the same store ─────────────────────
+describe('TradingOverlayStore — shared between unmanaged and managed pathways', () => {
+    it('unmanaged push and managed push coexist in the same store', () => {
+        const store = new TradingOverlayStore();
+        // Simulate unmanaged host pushing an external position
+        store.upsertPosition(makePosition('ext-pos', { qty: 2 }));
+        // Simulate managed controller pushing an order (e.g. bracket entry)
+        store.upsertOrder(makeOrder('mgd-entry', { groupId: 'brk1', role: 'entry' }));
+        store.upsertOrder(makeOrder('mgd-sl', { groupId: 'brk1', role: 'stop_loss', price: 90 }));
+        store.upsertOrder(makeOrder('mgd-tp', { groupId: 'brk1', role: 'take_profit', price: 115 }));
+        expect(store.getPositions()).toHaveLength(1);
+        expect(store.getOrders()).toHaveLength(3);
+        expect(store.getOrdersByGroup('brk1')).toHaveLength(3);
+    });
+    it('groupId-based bracket legs can coexist alongside unlinked orders', () => {
+        const store = new TradingOverlayStore();
+        store.upsertOrder(makeOrder('solo', { role: 'limit' }));
+        store.upsertOrder(makeOrder('b1-ent', { groupId: 'brk-A', role: 'entry' }));
+        store.upsertOrder(makeOrder('b1-sl', { groupId: 'brk-A', role: 'stop_loss' }));
+        store.upsertOrder(makeOrder('b1-tp', { groupId: 'brk-A', role: 'take_profit' }));
+        store.upsertOrder(makeOrder('b2-ent', { groupId: 'brk-B', role: 'entry' }));
+        store.upsertOrder(makeOrder('b2-sl', { groupId: 'brk-B', role: 'stop_loss' }));
+        expect(store.getOrders()).toHaveLength(6);
+        expect(store.getOrdersByGroup('brk-A')).toHaveLength(3);
+        expect(store.getOrdersByGroup('brk-B')).toHaveLength(2);
+    });
+    it('TP / SL / entry roles are stored verbatim', () => {
+        const store = new TradingOverlayStore();
+        const entry = makeOrder('entry-1', { role: 'entry', price: 100 });
+        const sl = makeOrder('sl-1', { role: 'stop_loss', price: 90 });
+        const tp = makeOrder('tp-1', { role: 'take_profit', price: 115 });
+        store.setOrders([entry, sl, tp]);
+        const orders = store.getOrders();
+        expect(orders.find(o => o.id === 'entry-1').role).toBe('entry');
+        expect(orders.find(o => o.id === 'sl-1').role).toBe('stop_loss');
+        expect(orders.find(o => o.id === 'tp-1').role).toBe('take_profit');
+    });
+});
+//# sourceMappingURL=TradingOverlayStore.test.js.map

package/dist/trading/__tests__/TradingOverlayStore.test.js.map

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

package/dist/trading/__tests__/UnmanagedIngestion.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * UnmanagedIngestion — unit tests
+ *
+ * Covers:
+ *   - setHistory loads bars in ascending order
+ *   - pushCandle appends a new bar
+ *   - pushCandle updates the current bar when same bucket
+ *   - getLatestBar returns correct data
+ *   - getBars() returns the full bar array
+ *   - setTimeframe clears bars and resets engine
+ *   - reset() wipes all bars
+ *   - Throws when called in managed mode
+ *   - onBarUpdated / onResync callbacks fire correctly
+ */
+export {};
+//# sourceMappingURL=UnmanagedIngestion.test.d.ts.map

package/dist/trading/__tests__/UnmanagedIngestion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnmanagedIngestion.test.d.ts","sourceRoot":"","sources":["../../../src/trading/__tests__/UnmanagedIngestion.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/trading/__tests__/UnmanagedIngestion.test.js

@@ -0,0 +1,170 @@
+/**
+ * UnmanagedIngestion — unit tests
+ *
+ * Covers:
+ *   - setHistory loads bars in ascending order
+ *   - pushCandle appends a new bar
+ *   - pushCandle updates the current bar when same bucket
+ *   - getLatestBar returns correct data
+ *   - getBars() returns the full bar array
+ *   - setTimeframe clears bars and resets engine
+ *   - reset() wipes all bars
+ *   - Throws when called in managed mode
+ *   - onBarUpdated / onResync callbacks fire correctly
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { LicenseManager } from '../../licensing/LicenseManager';
+import { UnmanagedIngestion } from '../UnmanagedIngestion';
+// ─── License helpers ──────────────────────────────────────────────────────────
+function installUnmanaged() {
+    LicenseManager.getInstance().loadLicense({ licenseKey: 'u', mode: 'unmanaged' });
+}
+function installManaged() {
+    LicenseManager.getInstance().loadLicense({ licenseKey: 'm', mode: 'managed' });
+}
+function clearLicense() {
+    LicenseManager.getInstance().clear();
+}
+// ─── Bar builders ─────────────────────────────────────────────────────────────
+// 2024-01-02 00:00:00 UTC in seconds
+const BASE_SEC = 1_704_153_600;
+const MIN = 60; // seconds per minute
+function bar(offsetMinutes, close = 100, extra) {
+    return {
+        time: BASE_SEC + offsetMinutes * MIN,
+        open: 100,
+        high: 105,
+        low: 95,
+        close,
+        ...extra,
+    };
+}
+// ─── Mode gate ────────────────────────────────────────────────────────────────
+describe('UnmanagedIngestion — mode gate', () => {
+    afterEach(clearLicense);
+    it('setHistory() throws in managed mode', () => {
+        installManaged();
+        const ing = new UnmanagedIngestion('1m');
+        expect(() => ing.setHistory([bar(0)])).toThrow(/unmanaged/i);
+    });
+    it('pushCandle() throws in managed mode', () => {
+        installManaged();
+        const ing = new UnmanagedIngestion('1m');
+        expect(() => ing.pushCandle(bar(0))).toThrow(/unmanaged/i);
+    });
+    it('setHistory() works when no license is installed (defaults to unmanaged)', () => {
+        clearLicense();
+        const ing = new UnmanagedIngestion('1m');
+        expect(() => ing.setHistory([bar(0)])).not.toThrow();
+    });
+    it('pushCandle() works when no license is installed', () => {
+        clearLicense();
+        const ing = new UnmanagedIngestion('1m');
+        expect(() => ing.pushCandle(bar(0))).not.toThrow();
+    });
+});
+// ─── setHistory ───────────────────────────────────────────────────────────────
+describe('UnmanagedIngestion — setHistory', () => {
+    beforeEach(installUnmanaged);
+    afterEach(clearLicense);
+    it('loads bars and getBars() returns them', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0), bar(1), bar(2)]);
+        expect(ing.getBars()).toHaveLength(3);
+    });
+    it('sorts bars ascending by time (even if fed out of order)', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(2), bar(0), bar(1)]);
+        const times = ing.getBars().map(b => b.time);
+        expect(times).toEqual([...times].sort((a, b) => a - b));
+    });
+    it('replaces previous history on second call', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0), bar(1), bar(2)]);
+        ing.setHistory([bar(5), bar(6)]);
+        expect(ing.getBars()).toHaveLength(2);
+    });
+    it('getLatestBar() returns the newest bar after loading', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0, 100), bar(1, 200), bar(2, 300)]);
+        expect(ing.getLatestBar().close).toBe(300);
+    });
+    it('fires onResync with the loaded bars', () => {
+        const onResync = vi.fn();
+        const ing = new UnmanagedIngestion('1m', { onResync });
+        ing.setHistory([bar(0), bar(1)]);
+        expect(onResync).toHaveBeenCalledTimes(1);
+        const passed = onResync.mock.calls[0][0];
+        expect(passed).toHaveLength(2);
+    });
+});
+// ─── pushCandle ───────────────────────────────────────────────────────────────
+describe('UnmanagedIngestion — pushCandle', () => {
+    beforeEach(installUnmanaged);
+    afterEach(clearLicense);
+    it('appends a new bar when pushing beyond current candle', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0), bar(1)]);
+        const result = ing.pushCandle(bar(2));
+        expect(result.type).toBe('append');
+        expect(ing.getBars()).toHaveLength(3);
+    });
+    it('updates the current bar when pushing same bucket', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0)]);
+        ing.pushCandle(bar(0, 110)); // same timestamp, new close
+        expect(ing.getBars()).toHaveLength(1);
+        expect(ing.getLatestBar().close).toBe(110);
+    });
+    it('high is never lowered within a candle', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.pushCandle(bar(0, 100, { high: 120 }));
+        ing.pushCandle(bar(0, 90, { high: 80 })); // high 80 < 120
+        expect(ing.getLatestBar().high).toBe(120);
+    });
+    it('low is never raised within a candle', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.pushCandle(bar(0, 100, { low: 80 }));
+        ing.pushCandle(bar(0, 95, { low: 90 })); // low 90 > 80
+        expect(ing.getLatestBar().low).toBe(80);
+    });
+    it('fires onBarUpdated for every push', () => {
+        const onBarUpdated = vi.fn();
+        const ing = new UnmanagedIngestion('1m', { onBarUpdated });
+        ing.pushCandle(bar(0));
+        ing.pushCandle(bar(0, 110));
+        ing.pushCandle(bar(1));
+        expect(onBarUpdated).toHaveBeenCalledTimes(3);
+    });
+    it('getLatestBar() returns null before any data', () => {
+        const ing = new UnmanagedIngestion('1m');
+        expect(ing.getLatestBar()).toBeNull();
+    });
+});
+// ─── setTimeframe & reset ─────────────────────────────────────────────────────
+describe('UnmanagedIngestion — setTimeframe and reset', () => {
+    beforeEach(installUnmanaged);
+    afterEach(clearLicense);
+    it('setTimeframe clears all existing bars', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0), bar(1), bar(2)]);
+        ing.setTimeframe('5m');
+        expect(ing.getBars()).toHaveLength(0);
+    });
+    it('reset() clears all bars', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0), bar(1)]);
+        ing.reset();
+        expect(ing.getBars()).toHaveLength(0);
+        expect(ing.getLatestBar()).toBeNull();
+    });
+    it('new history can be loaded after setTimeframe', () => {
+        const ing = new UnmanagedIngestion('1m');
+        ing.setHistory([bar(0), bar(1)]);
+        ing.setTimeframe('5m');
+        // 5-minute bars (offset in multiples of 5)
+        ing.setHistory([bar(0), bar(5)]);
+        expect(ing.getBars()).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=UnmanagedIngestion.test.js.map

package/dist/trading/__tests__/UnmanagedIngestion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnmanagedIngestion.test.js","sourceRoot":"","sources":["../../../src/trading/__tests__/UnmanagedIngestion.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D,iFAAiF;AAEjF,SAAS,gBAAgB;IACvB,cAAc,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,cAAc;IACrB,cAAc,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,YAAY;IACnB,cAAc,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,iFAAiF;AAEjF,qCAAqC;AACrC,MAAM,QAAQ,GAAG,aAAa,CAAC;AAC/B,MAAM,GAAG,GAAQ,EAAE,CAAC,CAAC,qBAAqB;AAE1C,SAAS,GAAG,CAAC,aAAqB,EAAE,KAAK,GAAG,GAAG,EAAE,KAA4B;IAC3E,OAAO;QACL,IAAI,EAAG,QAAQ,GAAG,aAAa,GAAG,GAAG;QACrC,IAAI,EAAG,GAAG;QACV,IAAI,EAAG,GAAG;QACV,GAAG,EAAI,EAAE;QACT,KAAK;QACL,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,SAAS,CAAC,YAAY,CAAC,CAAC;IAExB,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,cAAc,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,cAAc,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,YAAY,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,YAAY,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7B,SAAS,CAAC,YAAY,CAAC,CAAC;IAExB,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,YAAY,EAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAwC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7B,SAAS,CAAC,YAAY,CAAC,CAAC;IAExB,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,4BAA4B;QAC1D,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAG,EAAE,IAAI,EAAE,EAAE,EAAG,CAAC,CAAC,CAAC,CAAE,gBAAgB;QAC7D,MAAM,CAAC,GAAG,CAAC,YAAY,EAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAE,cAAc;QACzD,MAAM,CAAC,GAAG,CAAC,YAAY,EAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAkD,CAAC;QAC7E,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IAC3D,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7B,SAAS,CAAC,YAAY,CAAC,CAAC;IAExB,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvB,2CAA2C;QAC3C,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/trading/managed/ManagedTradingController.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ManagedTradingController
+ *
+ * The single managed-mode entry point for order routing.
+ *
+ * Responsibilities:
+ *  1. Enforce license/capability gates before any action.
+ *  2. Delegate execution to the registered IExecutionProvider.
+ *  3. Write results (orders, fills, positions) into the shared TradingOverlayStore
+ *     so managed and unmanaged modes share one visual layer.
+ *
+ * STUB STATUS
+ * ──────────────────────────────────────────────────────────────────────────────
+ * All execution methods are implemented as stubs that:
+ *   a) enforce license gates (will throw today if called without managed mode)
+ *   b) throw NotImplementedError when no provider is registered
+ *   c) are annotated with TODO markers for the implementation phase
+ *
+ * To implement a real provider, create a class implementing IExecutionProvider
+ * and call:
+ *   controller.registerProvider(new MyBrokerProvider(...));
+ *
+ * The controller will then delegate to it automatically.
+ * ──────────────────────────────────────────────────────────────────────────────
+ */
+import type { TradingOverlayStore } from '../TradingOverlayStore';
+import type { ExecutionFill } from '../tradingTypes';
+import type { IExecutionProvider, PlaceOrderInput, ModifyOrderInput, PlaceBracketOrderInput, OrderAck, BracketOrderAck } from './managedTypes';
+export declare class ManagedTradingController {
+    private _provider;
+    private readonly _store;
+    constructor(store: TradingOverlayStore);
+    /**
+     * Register the execution provider that will handle order routing.
+     *
+     * Call this before any order placement methods.  Only one provider may be
+     * active at a time — calling this again replaces the previous provider.
+     *
+     * @example
+     * ```ts
+     * import { RithmicProvider } from '@forgecharts/rithmic';
+     * controller.registerProvider(new RithmicProvider(credentials));
+     * ```
+     */
+    registerProvider(provider: IExecutionProvider): void;
+    /** Returns the id of the currently registered provider, or null if none. */
+    getProviderId(): string | null;
+    /** True when a provider is registered and managed trading is licensed. */
+    isReady(): boolean;
+    /**
+     * Place a single order via the registered execution provider.
+     *
+     * On success:
+     *   - Upserts a ChartOrder into the overlay store (status: 'pending' → 'open').
+     *   - Returns the provider acknowledgement.
+     *
+     * @throws If not in managed mode, orderEntry feature is off, or no provider.
+     *
+     * TODO: After provider.placeOrder resolves, subscribe to order status updates
+     *       (provider event stream) and call _store.upsertOrder() as status changes.
+     */
+    placeOrder(input: PlaceOrderInput): Promise<OrderAck>;
+    /**
+     * Cancel a working order by its provider-assigned id.
+     *
+     * On success:
+     *   - Updates the order status in the overlay store to 'cancelled'.
+     *
+     * @throws If not in managed mode, orderEntry feature is off, or no provider.
+     *
+     * TODO: Remove the overlay entry after a configurable delay (so the line
+     *       visually fades out rather than disappearing instantly).
+     */
+    cancelOrder(orderId: string): Promise<void>;
+    /**
+     * Modify a working order in place.
+     *
+     * On success:
+     *   - Updates the ChartOrder price/qty in the overlay store.
+     *
+     * @throws If not in managed mode, orderEntry feature is off, or no provider.
+     *
+     * TODO: Validate that the modified price is within instrument tick constraints
+     *       before forwarding to the provider.
+     */
+    modifyOrder(orderId: string, updates: ModifyOrderInput): Promise<OrderAck>;
+    /**
+     * Place a bracket order: entry + stop-loss + optional take-profit.
+     *
+     * On success:
+     *   - Upserts all bracket legs as ChartOrders sharing the same groupId.
+     *   - Returns acknowledgements for each leg.
+     *
+     * @throws If not in managed mode, bracketOrders feature is off, or no provider.
+     *
+     * TODO: Expose drag handles for each bracket leg in the chart overlay so
+     *       users can adjust prices before confirming.
+     */
+    placeBracketOrder(input: PlaceBracketOrderInput): Promise<BracketOrderAck>;
+    /**
+     * Report an execution fill received from the provider's event stream.
+     *
+     * Writes the fill into the overlay store and updates the parent order status.
+     * Called by the provider adapter whenever a fill notification arrives.
+     *
+     * TODO: Also update the related ChartPosition (create new or update qty/avgPrice).
+     */
+    reportFill(fill: ExecutionFill): void;
+}
+//# sourceMappingURL=ManagedTradingController.d.ts.map

package/dist/trading/managed/ManagedTradingController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedTradingController.d.ts","sourceRoot":"","sources":["../../../src/trading/managed/ManagedTradingController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,QAAQ,EACR,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAsBxB,qBAAa,wBAAwB;IAEnC,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAEjC,KAAK,EAAE,mBAAmB;IAMtC;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAKpD,4EAA4E;IAC5E,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,0EAA0E;IAC1E,OAAO,IAAI,OAAO;IAMlB;;;;;;;;;;;OAWG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqC3D;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajD;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoBhF;;;;;;;;;;;OAWG;IACG,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuDhF;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;CAetC"}