@forgecharts/sdk 1.1.28 → 1.1.30

package/dist/datafeed/DatafeedConnector.js

@@ -1,268 +0,0 @@
-import { CandleEngine } from '../engine/CandleEngine';
-/** Strip engine-only fields so the value is a plain OHLCV the chart series accepts. */
-function toOHLCV(bar) {
-    return { time: bar.time, open: bar.open, high: bar.high, low: bar.low, close: bar.close, volume: bar.volume };
-}
-/**
- * Initial history window per timeframe — controls how much data the chart
- * requests on first connect.
- *
- * TWO-LAYER ARCHITECTURE — these two concerns are independent:
- *  • CLIENT (this table): how many bars are fetched and held in memory for the
- *    initial view + scroll buffer.  Larger = more data in the browser.
- *  • SERVER DB fill (bars.ts MAX_DB_SECONDS): the server always fills a full
- *    12 months of 1m data (and all available daily history) into the DB cache
- *    in the background, regardless of the client window size.  This means
- *    scroll-left lazy-loading hits the DB, not the upstream TV API.
- *
- * For sub-hour timeframes a large display window is impractical:
- *   12 months of 1m = 525 600 bars — impossible to render, slow to transfer.
- * For 4h and above, 12 months is a manageable bar count so we load it all
- * upfront; the server will have it cached or will fill it synchronously.
- */
-const HISTORY_WINDOWS = {
-    // Sub-hour: small display window; DB fills 12 months in background for scrollback.
-    '1m': 3 * 24 * 3600, //   3 days  → ~4 320 bars
-    '3m': 7 * 24 * 3600, //   7 days  → ~3 360 bars
-    '5m': 10 * 24 * 3600, //  10 days  → ~2 880 bars
-    '15m': 30 * 24 * 3600, //  30 days  → ~2 880 bars
-    '30m': 60 * 24 * 3600, //  60 days  → ~2 880 bars
-    '1h': 90 * 24 * 3600, //  90 days  → ~2 160 bars
-    // 4h and above: 12 months — bar counts are small enough to load in full.
-    '2h': 365 * 86400, // 12 months → ~4 380 bars
-    '4h': 365 * 86400, // 12 months → ~2 190 bars
-    '6h': 365 * 86400, // 12 months → ~1 460 bars
-    '12h': 365 * 86400, // 12 months →   ~730 bars
-    '1d': 365 * 86400, // 12 months →   ~365 bars
-    '3d': 365 * 86400, // 12 months →   ~122 bars
-    '1w': 365 * 86400, // 12 months →    ~52 bars
-    '1M': 365 * 86400, // 12 months →    ~12 bars
-};
-const DEFAULT_HISTORY_WINDOW = 90 * 24 * 3600; // 90-day fallback (~200 bars at 1h)
-/**
- * How many seconds of history to fetch per lazy-load page (~500 candles).
- * Used by `loadMoreHistory()` when the user pans past the oldest loaded bar.
- */
-const PAGE_SIZES = {
-    '1m': 500 * 60,
-    '5m': 500 * 300,
-    '15m': 500 * 900,
-    '30m': 500 * 1800,
-    '1h': 500 * 3600,
-    '4h': 500 * 4 * 3600,
-    '1d': 500 * 86400,
-    '1w': 500 * 7 * 86400,
-    '1M': 500 * 30 * 86400,
-};
-const DEFAULT_PAGE_SIZE = 500 * 3600;
-/** Monotonic counter so every subscriber UID is unique within the process. */
-let _uidCounter = 0;
-// ─── DatafeedConnector ────────────────────────────────────────────────────────
-/**
- * DatafeedConnector wires an {@link IDatafeed} to an {@link ISeries}.
- *
- * Responsibilities:
- * - Generates stable, unique subscriber UIDs (`forgecharts-<symbol>-<tf>-<n>`).
- * - Calls `getHistoricalBars` and pushes the result into `series.setData()`.
- * - Calls `subscribeBars` so real-time ticks flow into `series.update()`.
- * - Guards against stale async responses after a reconnect or destroy.
- * - Tears down the active subscription cleanly on `disconnect()` / `destroy()`.
- *
- * @example
- * ```ts
- * const connector = new DatafeedConnector(datafeed, series, {
- *   onLoading: (s, tf) => console.log('loading', s, tf),
- *   onLoaded:  (s, tf, n) => console.log('loaded', n, 'bars'),
- *   onError:   (s, tf, e) => console.error(e),
- * });
- *
- * connector.connect('BTCUSDT', '1h');
- * // ...later, on symbol change:
- * connector.reconnect('ETHUSDT', '1h');
- * // ...on unmount:
- * connector.destroy();
- * ```
- */
-export class DatafeedConnector {
-    _datafeed;
-    _series;
-    _cb;
-    /**
-     * UID of the outstanding subscription.
-     * `null` means nothing is subscribed / all responses for older UIDs are stale.
-     */
-    _activeUID = null;
-    _activeEngine = null;
-    _destroyed = false;
-    /** True while an async `loadMoreHistory()` request is in-flight. */
-    _isLoadingMore = false;
-    /** True once the datafeed returned 0 bars for a backwards page — no point fetching older. */
-    _noMoreHistory = false;
-    constructor(datafeed, series, callbacks) {
-        this._datafeed = datafeed;
-        this._series = series;
-        this._cb = callbacks;
-    }
-    // ─── Public API ───────────────────────────────────────────────────────────────
-    /**
-     * Loads historical bars then subscribes for real-time updates.
-     * Safe to call while a previous subscription is still active — it will be
-     * cancelled first (same as calling `disconnect()` then `connect()`).
-     */
-    connect(symbol, timeframe) {
-        if (this._destroyed)
-            return;
-        // Cancel any in-flight request / active subscription before starting fresh
-        this._cancelActive();
-        const uid = `forgecharts-${symbol}-${timeframe}-${++_uidCounter}`;
-        this._activeUID = uid;
-        this._cb.onLoading(symbol, timeframe);
-        const to = Math.floor(Date.now() / 1000);
-        const from = to - (HISTORY_WINDOWS[timeframe] ?? DEFAULT_HISTORY_WINDOW);
-        // Build the engine for this subscription. Close over `uid` for stale-guard.
-        const engine = new CandleEngine({
-            // Every live tick mutates the engine's bar array and the chart series.
-            onBarUpdated: (bar) => {
-                if (this._activeUID !== uid)
-                    return;
-                const ohlcv = toOHLCV(bar);
-                this._series.update(ohlcv);
-                this._cb.onUpdate?.(ohlcv);
-            },
-            // When a gap is detected, fetch the missing range from REST and backfill.
-            // backfillGap() will call onResync which re-syncs the full chart series.
-            onGapDetected: (gapInfo) => {
-                if (this._activeUID !== uid)
-                    return;
-                const gapFrom = Math.floor(gapInfo.fromTimeMs / 1000);
-                const gapTo = Math.ceil(gapInfo.toTimeMs / 1000);
-                this._datafeed.getHistoricalBars(symbol, timeframe, gapFrom, gapTo)
-                    .then(({ bars }) => {
-                    if (this._activeUID !== uid)
-                        return;
-                    engine.backfillGap(bars);
-                })
-                    .catch(() => {
-                    // Gap backfill errors are non-fatal — chart continues with live data
-                });
-            },
-            // Full re-paint after gap fill or reconnect reconciliation.
-            onResync: (bars) => {
-                if (this._activeUID !== uid)
-                    return;
-                this._series.setData(bars.map(toOHLCV));
-            },
-        });
-        this._activeEngine = engine;
-        this._datafeed
-            .getHistoricalBars(symbol, timeframe, from, to)
-            .then((result) => {
-            // Guard: another connect() / destroy() may have superseded this request
-            if (this._activeUID !== uid)
-                return;
-            engine.initialize(result.bars, timeframe);
-            this._series.setData(engine.getBars().map(toOHLCV));
-            this._cb.onLoaded(symbol, timeframe, engine.getBars().length);
-            // Double-check still active before subscribing (setData callback could
-            // have triggered a synchronous reconnect in pathological code)
-            if (this._activeUID !== uid)
-                return;
-            this._datafeed.subscribeBars(symbol, timeframe, (bar) => {
-                if (this._activeUID === uid) {
-                    engine.applyLiveUpdate(bar);
-                }
-            }, uid);
-        })
-            .catch((err) => {
-            if (this._activeUID !== uid)
-                return;
-            const message = err instanceof Error ? err.message : String(err);
-            this._cb.onError(symbol, timeframe, message);
-        });
-    }
-    /**
-     * Cancels the active subscription without starting a new one.
-     * Historical-bar `Promise` results arriving after this call are silently
-     * discarded via the UID guard.
-     */
-    disconnect() {
-        this._cancelActive();
-    }
-    /**
-     * Convenience shorthand: `disconnect()` then `connect()`.
-     * Use this for symbol or timeframe changes.
-     */
-    reconnect(symbol, timeframe) {
-        this.disconnect();
-        this.connect(symbol, timeframe);
-    }
-    /**
-     * Permanently deactivates the connector.
-     * Any subscription or in-flight request is cancelled; subsequent calls to
-     * `connect()` / `reconnect()` are no-ops.
-     */
-    destroy() {
-        this._cancelActive();
-        this._destroyed = true;
-    }
-    // ─── Private ─────────────────────────────────────────────────────────────────
-    /**
-     * Fetches a page of older history (up to ~500 candles) and prepends it to
-     * the loaded dataset. Safe to call on every pan event — it is internally
-     * debounced by the `_isLoadingMore` flag and stops permanently once the
-     * datafeed signals no more history (`_noMoreHistory = true`).
-     *
-     * The series is updated automatically via the engine's `onResync` callback.
-     */
-    loadMoreHistory(symbol, timeframe) {
-        if (this._destroyed || this._isLoadingMore || this._noMoreHistory)
-            return;
-        if (!this._activeEngine || !this._activeUID)
-            return;
-        const engine = this._activeEngine;
-        const oldest = engine.getBars()[0];
-        if (!oldest)
-            return;
-        const uid = this._activeUID;
-        const to = Math.floor(oldest.timeMs / 1000);
-        const page = PAGE_SIZES[timeframe] ?? DEFAULT_PAGE_SIZE;
-        const from = to - page;
-        this._isLoadingMore = true;
-        this._datafeed.getHistoricalBars(symbol, timeframe, from, to - 1)
-            .then(({ bars }) => {
-            if (this._activeUID !== uid)
-                return;
-            if (bars.length === 0) {
-                this._noMoreHistory = true;
-            }
-            else {
-                engine.prependHistory(bars);
-            }
-        })
-            .catch(() => {
-            // Non-fatal — user can scroll again to retry
-        })
-            .finally(() => {
-            if (this._activeUID === uid)
-                this._isLoadingMore = false;
-        });
-    }
-    _cancelActive() {
-        if (this._activeUID !== null) {
-            try {
-                this._datafeed.unsubscribeBars(this._activeUID);
-            }
-            catch {
-                // Best-effort teardown — datafeed may already be closed
-            }
-            this._activeUID = null;
-        }
-        if (this._activeEngine !== null) {
-            this._activeEngine.reset();
-            this._activeEngine = null;
-        }
-        this._isLoadingMore = false;
-        this._noMoreHistory = false;
-    }
-}
-//# sourceMappingURL=DatafeedConnector.js.map

package/dist/datafeed/DatafeedConnector.js.map

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

package/dist/engine/CandleEngine.js

@@ -1,318 +0,0 @@
-/**
- * CandleEngine — the single source of truth for live candle data.
- *
- * Architecture:
- *
- *   WebSocket feed
- *       ↓
- *   Market Data Normalizer  (normalizeOhlcv — handles strings, ms vs s)
- *       ↓
- *   CandleEngine            (applyCandleUpdate — O(1) update path)
- *       ↓
- *   Chart Update Adapter    (onBarUpdated / onResync callbacks)
- *       ↓
- *   Chart Library           (series.update / series.setData)
- *
- * Guarantees:
- *   - open  is never overwritten on an existing live candle
- *   - high  can only increase within a candle
- *   - low   can only decrease within a candle
- *   - close updates on every tick
- *   - out-of-order ticks are silently discarded
- *   - gaps are detected and reported for async REST backfill
- *   - the engine is framework-agnostic (no DOM, React, or chart-lib imports)
- */
-import { timeframeToMs, getCalendarBucketStart } from './timeframeUtils';
-import { getMissingBarCount, mergeBars } from './mergeUtils';
-import { assertOhlcRelationships, assertBucketAlignment, assertNotFinalized, assertOpenImmutability, assertNoDuplicateAppend, assertFinalizedUnchanged, } from './candleInvariants';
-// ─── Internal normalizer ─────────────────────────────────────────────────────
-/**
- * Normalise a raw OHLCV object into a CandleBar.
- *
- * - Coerces all fields to `number` (handles numeric strings from the feed).
- * - Auto-detects ms vs s timestamps: values > 1e12 are treated as milliseconds.
- * - Aligns `timeMs` to the correct candle-open boundary, with calendar
- *   alignment for `1w` (Monday) and `1M` (first of month).
- *
- * Never use `Date.now()` for candle time — always use the feed-provided value.
- */
-function normalizeOhlcv(raw, intervalMs, tf) {
-    const rawTime = Number(raw.time);
-    // Auto-detect: Unix ms timestamps are > 1e12 (year 2001+).
-    // If the value is smaller, treat it as seconds and convert.
-    const timeMs = rawTime > 1e12 ? rawTime : rawTime * 1000;
-    // Calendar-aware bucket alignment (handles 1w/1M specially)
-    const bucketMs = getCalendarBucketStart(timeMs, tf);
-    const timeSec = Math.floor(bucketMs / 1000);
-    return {
-        timeMs: bucketMs,
-        time: timeSec,
-        open: Number(raw.open),
-        high: Number(raw.high),
-        low: Number(raw.low),
-        close: Number(raw.close),
-        volume: Number(raw.volume ?? 0),
-        isClosed: raw.isClosed ?? false,
-    };
-}
-// ─── CandleEngine ─────────────────────────────────────────────────────────────
-export class CandleEngine {
-    /** Authoritative ordered bar array. Only the rightmost bar may be open. */
-    _bars = [];
-    _timeframe = '1m';
-    _intervalMs = 60_000;
-    _opts;
-    constructor(options = {}) {
-        this._opts = options;
-    }
-    // ── Initialisation ──────────────────────────────────────────────────────────
-    /**
-     * Seed the engine with historical bars and set the active timeframe.
-     * All existing bars are replaced.
-     *
-     * Historical bars loaded from REST are assumed closed, except possibly
-     * the last one (which may represent the still-forming candle).
-     *
-     * @param history   Raw bars from a REST endpoint (oldest → newest).
-     * @param timeframe The active timeframe label (e.g. '1m', '1h').
-     */
-    initialize(history, timeframe) {
-        this._timeframe = timeframe;
-        this._intervalMs = timeframeToMs(timeframe);
-        // Normalise, deduplicate by timeMs (latest entry wins), sort newest-last
-        const seen = new Map();
-        for (const raw of history) {
-            const bar = normalizeOhlcv(raw, this._intervalMs, this._timeframe);
-            seen.set(bar.timeMs, bar);
-        }
-        this._bars = Array.from(seen.values()).sort((a, b) => a.timeMs - b.timeMs);
-        // Mark all bars except the last as closed
-        for (let i = 0; i < this._bars.length - 1; i++) {
-            this._bars[i].isClosed = true;
-        }
-        this._debugLog('initialize', {
-            timeframe,
-            intervalMs: this._intervalMs,
-            barCount: this._bars.length,
-            firstTime: this._bars[0]?.timeMs,
-            lastTime: this._bars[this._bars.length - 1]?.timeMs,
-        });
-    }
-    // ── Live updates ────────────────────────────────────────────────────────────
-    /**
-     * Process a single live OHLCV tick from the WebSocket feed.
-     *
-     * Algorithm (mirrors TradingView / Binance candle engine behaviour):
-     *
-     *  1. Normalise: coerce strings to numbers, detect ms vs s, align to bucket.
-     *  2. Empty array → append as first bar.
-     *  3. incoming.timeMs === last.timeMs  → SAME CANDLE (update in-place):
-     *       open   = unchanged               (first tick's open is authoritative)
-     *       high   = max(last.high, inc.high, inc.close)
-     *       low    = min(last.low,  inc.low,  inc.close)
-     *       close  = inc.close
-     *       volume = inc.volume
-     *  4. incoming.timeMs  > last.timeMs  → NEW CANDLE:
-     *       - Detect and report any gap (missing buckets between last and incoming).
-     *       - Mark last bar as closed, fire onBarClosed.
-     *       - Append incoming as a fresh live candle.
-     *  5. incoming.timeMs  < last.timeMs  → OUT-OF-ORDER: discard silently.
-     *
-     * @returns UpdateResult indicating what was done — the chart adapter uses
-     *   this to choose between series.update() and series.setData().
-     */
-    applyLiveUpdate(raw) {
-        const incoming = normalizeOhlcv(raw, this._intervalMs, this._timeframe);
-        // Invariant: incoming bar must be bucket-aligned and OHLC-valid
-        assertBucketAlignment(incoming, this._timeframe, 'applyLiveUpdate:normalize');
-        assertOhlcRelationships(incoming, 'applyLiveUpdate:normalize');
-        // ── First bar ever ─────────────────────────────────────────────────────
-        if (this._bars.length === 0) {
-            this._bars.push(incoming);
-            const result = { type: 'append', bar: incoming, previousBarClosed: false };
-            this._debugLog('append:first', incoming);
-            this._opts.onBarUpdated?.(incoming, result);
-            return result;
-        }
-        const last = this._bars[this._bars.length - 1];
-        // ── Same candle: update in-place (O(1)) ────────────────────────────────
-        if (incoming.timeMs === last.timeMs) {
-            // Invariant: must not mutate a finalized candle
-            assertNotFinalized(last, 'applyLiveUpdate:same-bucket');
-            const prevOpen = last.open;
-            const prevCount = this._bars.length;
-            // open is intentionally not updated — the first tick's open is correct
-            last.high = Math.max(last.high, incoming.high, incoming.close);
-            last.low = Math.min(last.low, incoming.low, incoming.close);
-            last.close = incoming.close;
-            last.volume = incoming.volume;
-            // Invariant: open must be unchanged, no spurious append must have occurred
-            assertOpenImmutability(prevOpen, last, 'applyLiveUpdate:same-bucket');
-            assertOhlcRelationships(last, 'applyLiveUpdate:same-bucket');
-            assertNoDuplicateAppend(prevCount, this._bars.length, 'applyLiveUpdate:same-bucket');
-            const result = { type: 'update', bar: last };
-            this._debugLog('update', last);
-            this._opts.onBarUpdated?.(last, result);
-            return result;
-        }
-        // ── Out-of-order: older than the current live candle ──────────────────
-        if (incoming.timeMs < last.timeMs) {
-            this._debugLog('ignore', {
-                incomingTimeMs: incoming.timeMs,
-                lastTimeMs: last.timeMs,
-                delta: last.timeMs - incoming.timeMs,
-            });
-            return { type: 'ignore' };
-        }
-        // ── New candle (incoming.timeMs > last.timeMs) ─────────────────────────
-        // Gap detection: how many candle buckets are missing between last and new?
-        const missingCount = getMissingBarCount(last.timeMs, incoming.timeMs, this._intervalMs);
-        if (missingCount > 0) {
-            const gapInfo = { fromTimeMs: last.timeMs, toTimeMs: incoming.timeMs, missingCount };
-            this._debugLog('gap', gapInfo);
-            this._opts.onGapDetected?.(gapInfo);
-        }
-        // Finalise the previous live candle
-        const prevLastBar = { ...last }; // snapshot for post-append invariant check
-        last.isClosed = true;
-        this._opts.onBarClosed?.(last);
-        // Append the new candle
-        this._bars.push(incoming);
-        // Invariant: previous bar must be closed and not mutated after the append
-        assertFinalizedUnchanged(prevLastBar, this._bars, 'applyLiveUpdate:new-bucket');
-        assertOhlcRelationships(incoming, 'applyLiveUpdate:new-bucket');
-        const result = missingCount > 0
-            ? { type: 'gap', bar: incoming, missingCount }
-            : { type: 'append', bar: incoming, previousBarClosed: true };
-        this._debugLog(result.type, incoming);
-        this._opts.onBarUpdated?.(incoming, result);
-        return result;
-    }
-    // ── Gap backfill ────────────────────────────────────────────────────────────
-    /**
-     * Merge REST-fetched bars into the engine to fill a detected gap.
-     *
-     * Incoming bars are treated as authoritative closed candles.
-     * The current live candle is preserved if present.
-     *
-     * After calling this, `onResync` fires — the chart adapter must call
-     * `series.setData(engine.getBars())` to fully resync the chart.
-     *
-     * @param rawBars  Historical bars from the REST endpoint covering the gap.
-     */
-    backfillGap(rawBars) {
-        const incoming = rawBars.map(r => {
-            const bar = normalizeOhlcv(r, this._intervalMs, this._timeframe);
-            bar.isClosed = true; // REST bars are closed and authoritative
-            return bar;
-        });
-        // Preserve the live candle's open state after merge
-        const liveBefore = this._bars[this._bars.length - 1];
-        this._bars = mergeBars(this._bars, incoming);
-        // Re-apply live candle's isClosed=false if it survived the merge
-        if (liveBefore && !liveBefore.isClosed) {
-            const last = this._bars[this._bars.length - 1];
-            if (last && last.timeMs === liveBefore.timeMs) {
-                last.isClosed = false;
-            }
-        }
-        this._debugLog('backfillGap', { filled: rawBars.length, totalBars: this._bars.length });
-        this._opts.onResync?.(this._bars);
-    }
-    // ── Reconnect reconciliation ────────────────────────────────────────────────
-    /**
-     * Reconcile after a WebSocket reconnect.
-     *
-     * Fetch a rolling overlap window from REST (e.g. last 50 bars or 2 hours)
-     * and pass them here. The engine merges them with the existing bar array,
-     * correcting any candles that were missed or corrupted during the outage.
-     *
-     * After reconciliation, `onResync` fires so the chart adapter can resync
-     * the chart series with `series.setData(engine.getBars())`.
-     *
-     * @param recentBars  REST bars covering the reconnect overlap window.
-     */
-    handleReconnect(recentBars) {
-        const incoming = recentBars.map(r => normalizeOhlcv(r, this._intervalMs, this._timeframe));
-        this._bars = mergeBars(this._bars, incoming);
-        this._debugLog('handleReconnect', { count: recentBars.length, totalBars: this._bars.length });
-        this._opts.onResync?.(this._bars);
-    }
-    // ── Trade-tick stub ─────────────────────────────────────────────────────────
-    /**
-     * Stub for future tick/trade-based candle construction.
-     *
-     * When implemented, this will:
-     *   - Assign the trade to its bucket using `getBucketStart(timeMs, intervalMs)`.
-     *   - Create a new candle if the bucket is absent.
-     *   - Update OHLCV: open/close from trade price, high/low expanded, volume summed.
-     *
-     * Not yet implemented — structure is in place for future extension.
-     */
-    applyTradeTick(_trade) {
-        // TODO: implement tick-based candle construction
-    }
-    // ── Read access ─────────────────────────────────────────────────────────────
-    /**
-     * Returns a readonly view of the authoritative bar array.
-     * Do not mutate — call `applyLiveUpdate`, `backfillGap`, etc. instead.
-     */
-    getBars() {
-        return this._bars;
-    }
-    /** Returns the most recent (possibly still live) bar, or null if empty. */
-    getLastBar() {
-        return this._bars[this._bars.length - 1] ?? null;
-    }
-    /**
-     * Prepend older historical bars fetched during a lazy scroll-left page load.
-     * Only bars older than the current oldest bar are accepted; duplicates and
-     * out-of-range bars are silently dropped.
-     * Fires `onResync` so the chart adapter updates the series with `setData`.
-     *
-     * @param rawBars  Historical bars from the REST endpoint, oldest → newest.
-     */
-    prependHistory(rawBars) {
-        const oldest = this._bars[0];
-        const cutoff = oldest ? oldest.timeMs : Infinity;
-        const incoming = rawBars
-            .map(r => {
-            const bar = normalizeOhlcv(r, this._intervalMs, this._timeframe);
-            bar.isClosed = true;
-            return bar;
-        })
-            .filter(bar => bar.timeMs < cutoff);
-        if (incoming.length === 0)
-            return;
-        incoming.sort((a, b) => a.timeMs - b.timeMs);
-        this._bars = [...incoming, ...this._bars];
-        this._debugLog('prependHistory', {
-            prepended: incoming.length,
-            firstTime: this._bars[0]?.timeMs,
-        });
-        this._opts.onResync?.(this._bars);
-    }
-    /**
-     * Clear all state.
-     * Call before switching symbol or timeframe, or on a hard disconnect.
-     */
-    reset() {
-        this._bars = [];
-        this._debugLog('reset', { timeframe: this._timeframe });
-    }
-    // ── Private helpers ──────────────────────────────────────────────────────────
-    _debugLog(action, data) {
-        if (!this._opts.debug)
-            return;
-        console.debug('[CANDLE_ENGINE]', {
-            action,
-            timeframe: this._timeframe,
-            barCount: this._bars.length,
-            liveBar: this._bars[this._bars.length - 1]
-                ? { open: this._bars[this._bars.length - 1].open, high: this._bars[this._bars.length - 1].high, low: this._bars[this._bars.length - 1].low, close: this._bars[this._bars.length - 1].close }
-                : null,
-            ...data,
-        });
-    }
-}
-//# sourceMappingURL=CandleEngine.js.map

package/dist/engine/CandleEngine.js.map

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