backtest-kit 9.7.0 → 9.8.1

package/build/index.cjs

@@ -36127,72 +36127,41 @@ const PRINT_PROGRESS_FN = (fetched, total, symbol, interval) => {
     }
 };
 /**
- * Checks cached candle timestamps for correct interval alignment.
- * Reads JSON files directly from persist storage without using abstractions.
+ * Checks cached candle presence via the persist adapter.
+ * Issues one ranged read; adapter-side `hasValue` covers each expected timestamp,
+ * so a single missing or unaligned candle yields a miss without loading the whole dataset.
  *
  * @param params - Validation parameters
  */
 async function checkCandles(params) {
-    const { symbol, exchangeName, interval, from, to, baseDir = "./dump/data/candle" } = params;
+    const { symbol, exchangeName, interval, from, to } = params;
     backtest.loggerService.info(CHECK_CANDLES_METHOD_NAME, params);
     const step = INTERVAL_MINUTES$3[interval];
     if (!step) {
         throw new Error(`checkCandles: unsupported interval=${interval}`);
     }
     const stepMs = step * MS_PER_MINUTE$3;
-    const dir = path.join(baseDir, exchangeName, symbol, interval);
     const fromTs = ALIGN_TO_INTERVAL_FN(from.getTime(), step);
     const toTs = ALIGN_TO_INTERVAL_FN(to.getTime(), step);
-    try {
-        await fs.stat(dir);
-    }
-    catch {
-        throw new Error(`checkCandles: cache directory not found: ${dir}`);
-    }
-    // Collect only filenames (strings) in range via async iterator — no full readdir in memory
-    const files = [];
-    for await (const entry of await fs.opendir(dir)) {
-        if (!entry.isFile() || !entry.name.endsWith(".json")) {
-            continue;
-        }
-        const ts = Number(entry.name.replace(".json", ""));
-        if (ts >= fromTs && ts < toTs) {
-            files.push(entry.name);
-        }
-    }
-    if (files.length === 0) {
-        throw new Error(`checkCandles: no cached candles in range [${fromTs}, ${toTs}) in ${dir}`);
+    const totalCandles = Math.floor((toTs - fromTs) / stepMs);
+    if (totalCandles <= 0) {
+        throw new Error(`checkCandles: empty range [${fromTs}, ${toTs}) for ${symbol} ${interval}`);
     }
-    files.sort();
-    let prevTimestamp = null;
-    let prevName = null;
-    PRINT_PROGRESS_FN(0, files.length, symbol, interval);
-    for (let i = 0; i < files.length; i++) {
-        const filePath = path.join(dir, files[i]);
-        const raw = await fs.readFile(filePath, "utf-8");
-        let candle;
-        try {
-            candle = JSON.parse(raw);
-        }
-        catch {
-            throw new Error(`checkCandles: ${files[i]} contains invalid JSON`);
-        }
-        const { timestamp } = candle;
-        const aligned = ALIGN_TO_INTERVAL_FN(timestamp, step);
-        if (timestamp !== aligned) {
-            throw new Error(`checkCandles: ${files[i]} timestamp not aligned to ${interval} boundary (actual=${timestamp}, expected=${aligned})`);
-        }
-        if (prevTimestamp !== null) {
-            const gap = timestamp - prevTimestamp;
-            if (gap !== stepMs) {
-                throw new Error(`checkCandles: gap between ${prevName} and ${files[i]} (actual=${gap}ms, expected=${stepMs}ms)`);
-            }
+    let checked = 0;
+    let currentSince = fromTs;
+    PRINT_PROGRESS_FN(checked, totalCandles, symbol, interval);
+    while (checked < totalCandles) {
+        const chunkLimit = Math.min(totalCandles - checked, GLOBAL_CONFIG.CC_MAX_CANDLES_PER_REQUEST);
+        const chunkUntil = currentSince + chunkLimit * stepMs;
+        const candles = await PersistCandleAdapter.readCandlesData(symbol, interval, exchangeName, chunkLimit, currentSince, chunkUntil);
+        if (!candles) {
+            throw new Error(`checkCandles: cache miss for ${symbol} ${interval} [${currentSince}, ${chunkUntil})`);
         }
-        prevTimestamp = timestamp;
-        prevName = files[i];
-        PRINT_PROGRESS_FN(i + 1, files.length, symbol, interval);
+        checked += chunkLimit;
+        currentSince = chunkUntil;
+        PRINT_PROGRESS_FN(checked, totalCandles, symbol, interval);
     }
-    console.log(`checkCandles: OK ${files.length} candles ${symbol} ${interval}`);
+    console.log(`checkCandles: OK ${totalCandles} candles ${symbol} ${interval}`);
 }
 /**
  * Pre-caches candles for a date range into persist storage.
@@ -37443,7 +37412,19 @@ class BrokerProxy {
  */
 class BrokerAdapter {
     constructor() {
-        this._brokerInstance = null;
+        /** Factory producing the active `BrokerProxy` instance */
+        this._brokerFactory = () => null;
+        /**
+         * Lazily constructs the `BrokerProxy` from the registered factory and
+         * memoizes the result via `singleshot`.
+         *
+         * The proxy is built on the first call and cached for all subsequent calls.
+         * Returns `null` when no adapter has been registered via `useBrokerAdapter()`.
+         *
+         * Reset via `clear()` so the next call rebuilds from the current factory
+         * (e.g. when `process.cwd()` changes between strategy iterations).
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._brokerFactory());
         /**
          * Forwards a signal-open event to the registered broker adapter.
          *
@@ -37477,7 +37458,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onSignalOpenCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onSignalOpenCommit(payload);
+            }
         };
         /**
          * Forwards a signal-close event to the registered broker adapter.
@@ -37515,7 +37499,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onSignalCloseCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onSignalCloseCommit(payload);
+            }
         };
         /**
          * Intercepts a partial-profit close before DI-core mutation.
@@ -37551,7 +37538,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onPartialProfitCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onPartialProfitCommit(payload);
+            }
         };
         /**
          * Intercepts a partial-loss close before DI-core mutation.
@@ -37587,7 +37577,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onPartialLossCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onPartialLossCommit(payload);
+            }
         };
         /**
          * Intercepts a trailing stop-loss update before DI-core mutation.
@@ -37623,7 +37616,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onTrailingStopCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onTrailingStopCommit(payload);
+            }
         };
         /**
          * Intercepts a trailing take-profit update before DI-core mutation.
@@ -37659,7 +37655,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onTrailingTakeCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onTrailingTakeCommit(payload);
+            }
         };
         /**
          * Intercepts a breakeven operation before DI-core mutation.
@@ -37696,7 +37695,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onBreakevenCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onBreakevenCommit(payload);
+            }
         };
         /**
          * Intercepts a DCA average-buy entry before DI-core mutation.
@@ -37732,7 +37734,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onAverageBuyCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onAverageBuyCommit(payload);
+            }
         };
         /**
          * Registers a broker adapter instance or constructor to receive commit* callbacks.
@@ -37756,11 +37761,12 @@ class BrokerAdapter {
         this.useBrokerAdapter = (broker) => {
             backtest.loggerService.info(BROKER_METHOD_NAME_USE_BROKER_ADAPTER, {});
             if (typeof broker === "function") {
-                const instance = Reflect.construct(broker, []);
-                this._brokerInstance = new BrokerProxy(instance);
-                return;
+                this._brokerFactory = () => new BrokerProxy(Reflect.construct(broker, []));
+            }
+            else {
+                this._brokerFactory = () => new BrokerProxy(broker);
             }
-            this._brokerInstance = new BrokerProxy(broker);
+            this.getInstance.clear();
         };
         /**
          * Activates the broker: subscribes to syncSubject for signal-open / signal-close routing.
@@ -37787,7 +37793,8 @@ class BrokerAdapter {
          */
         this.enable = functoolsKit.singleshot(() => {
             backtest.loggerService.info(BROKER_METHOD_NAME_ENABLE, {});
-            if (!this._brokerInstance) {
+            const instance = this.getInstance();
+            if (!instance) {
                 this.enable.clear();
                 throw new Error("No broker instance provided. Call Broker.useBrokerAdapter first.");
             }
@@ -37875,7 +37882,7 @@ class BrokerAdapter {
          */
         this.clear = () => {
             backtest.loggerService.info(BROKER_METHOD_NAME_CLEAR, {});
-            this._brokerInstance = null;
+            this.getInstance.clear();
             this.enable.clear();
         };
     }
@@ -48895,8 +48902,16 @@ class RecentMemoryLiveUtils {
  */
 class RecentBacktestAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+        /** Factory producing the active storage utils instance */
+        this._recentBacktestFactory = () => new RecentMemoryBacktestUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._recentBacktestFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48906,7 +48921,7 @@ class RecentBacktestAdapter {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING, {
                 signalId: event.data.id,
             });
-            return await this._recentBacktestUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         /**
          * Retrieves the latest signal for the given context.
@@ -48927,7 +48942,7 @@ class RecentBacktestAdapter {
                 frameName,
                 backtest: backtest$1,
             });
-            return await this._recentBacktestUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
+            return await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
         };
         /**
          * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
@@ -48951,7 +48966,7 @@ class RecentBacktestAdapter {
                 backtest: backtest$1,
                 timestamp,
             });
-            const signal = await this._recentBacktestUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
+            const signal = await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
             if (!signal) {
                 return null;
             }
@@ -48964,7 +48979,8 @@ class RecentBacktestAdapter {
          */
         this.useRecentAdapter = (Ctor) => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._recentBacktestUtils = Reflect.construct(Ctor, []);
+            this._recentBacktestFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter.
@@ -48972,7 +48988,8 @@ class RecentBacktestAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._recentBacktestUtils = new RecentPersistBacktestUtils();
+            this._recentBacktestFactory = () => new RecentPersistBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter (default).
@@ -48980,14 +48997,17 @@ class RecentBacktestAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+            this._recentBacktestFactory = () => new RecentMemoryBacktestUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default in-memory adapter.
+         * Clears the memoized utils instance.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
-            this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -49002,8 +49022,16 @@ class RecentBacktestAdapter {
  */
 class RecentLiveAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._recentLiveUtils = new RecentPersistLiveUtils();
+        /** Factory producing the active storage utils instance */
+        this._recentLiveFactory = () => new RecentPersistLiveUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._recentLiveFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -49013,7 +49041,7 @@ class RecentLiveAdapter {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING, {
                 signalId: event.data.id,
             });
-            return await this._recentLiveUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         /**
          * Retrieves the latest signal for the given context.
@@ -49034,7 +49062,7 @@ class RecentLiveAdapter {
                 frameName,
                 backtest: backtest$1,
             });
-            return await this._recentLiveUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
+            return await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
         };
         /**
          * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
@@ -49058,7 +49086,7 @@ class RecentLiveAdapter {
                 backtest: backtest$1,
                 timestamp,
             });
-            const signal = await this._recentLiveUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
+            const signal = await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
             if (!signal) {
                 return null;
             }
@@ -49071,7 +49099,8 @@ class RecentLiveAdapter {
          */
         this.useRecentAdapter = (Ctor) => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._recentLiveUtils = Reflect.construct(Ctor, []);
+            this._recentLiveFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter (default).
@@ -49079,7 +49108,8 @@ class RecentLiveAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._recentLiveUtils = new RecentPersistLiveUtils();
+            this._recentLiveFactory = () => new RecentPersistLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter.
@@ -49087,14 +49117,17 @@ class RecentLiveAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._recentLiveUtils = new RecentMemoryLiveUtils();
+            this._recentLiveFactory = () => new RecentMemoryLiveUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default persistent adapter.
+         * Clears the memoized utils instance.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_CLEAR);
-            this._recentLiveUtils = new RecentPersistLiveUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -54419,16 +54452,26 @@ class LogDummyUtils {
  */
 class LogAdapter {
     constructor() {
-        /** Internal log utils instance */
-        this._log = new LogMemoryUtils();
+        /** Factory producing the active log utils instance */
+        this._logFactory = () => new LogMemoryUtils();
+        /**
+         * Lazily constructs the log utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory
+         * (e.g. when `process.cwd()` changes between strategy iterations).
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._logFactory());
         /**
          * Lists all stored log entries.
          * Proxies call to the underlying log adapter.
          * @returns Array of all log entries
          */
         this.getList = async () => {
-            if (this._log.getList) {
-                return await this._log.getList();
+            const log = this.getInstance();
+            if (log.getList) {
+                return await log.getList();
             }
             return [];
         };
@@ -54439,8 +54482,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.log = (topic, ...args) => {
-            if (this._log.log) {
-                this._log.log(topic, ...args);
+            const log = this.getInstance();
+            if (log.log) {
+                log.log(topic, ...args);
             }
         };
         /**
@@ -54450,8 +54494,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.debug = (topic, ...args) => {
-            if (this._log.debug) {
-                this._log.debug(topic, ...args);
+            const log = this.getInstance();
+            if (log.debug) {
+                log.debug(topic, ...args);
             }
         };
         /**
@@ -54461,8 +54506,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.info = (topic, ...args) => {
-            if (this._log.info) {
-                this._log.info(topic, ...args);
+            const log = this.getInstance();
+            if (log.info) {
+                log.info(topic, ...args);
             }
         };
         /**
@@ -54472,8 +54518,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.warn = (topic, ...args) => {
-            if (this._log.warn) {
-                this._log.warn(topic, ...args);
+            const log = this.getInstance();
+            if (log.warn) {
+                log.warn(topic, ...args);
             }
         };
         /**
@@ -54483,7 +54530,8 @@ class LogAdapter {
          */
         this.useLogger = (Ctor) => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_LOGGER);
-            this._log = Reflect.construct(Ctor, []);
+            this._logFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent log adapter.
@@ -54491,7 +54539,8 @@ class LogAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._log = new LogPersistUtils();
+            this._logFactory = () => new LogPersistUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory log adapter (default).
@@ -54499,7 +54548,8 @@ class LogAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._log = new LogMemoryUtils();
+            this._logFactory = () => new LogMemoryUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy log adapter.
@@ -54507,7 +54557,8 @@ class LogAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._log = new LogDummyUtils();
+            this._logFactory = () => new LogDummyUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to JSONL file log adapter.
@@ -54517,18 +54568,22 @@ class LogAdapter {
          * @param fileName - Base file name without extension (default: "log")
          * @param dirName - Directory for the JSONL file (default: ./dump/log)
          */
-        this.useJsonl = (fileName = "log.jsonl", dirName = path.join(process.cwd(), "./dump/log")) => {
+        this.useJsonl = (fileName = "log.jsonl", dirName) => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_JSONL);
-            this._log = new LogJsonlUtils(fileName, dirName);
+            this._logFactory = () => {
+                const dir = dirName || path.join(process.cwd(), "./dump/log");
+                return new LogJsonlUtils(fileName, dir);
+            };
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached log instance by resetting to the default in-memory adapter.
+         * Clears the memoized log instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new adapter instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_CLEAR);
-            this._log = new LogMemoryUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -58420,15 +58475,23 @@ class StorageDummyLiveUtils {
  */
 class StorageBacktestAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+        /** Factory producing the active storage utils instance */
+        this._signalBacktestFactory = () => new StorageMemoryBacktestUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._signalBacktestFactory());
         /**
          * Handles signal opened event.
          * Proxies call to the underlying storage adapter.
          * @param tick - The opened signal tick data
          */
         this.handleOpened = async (tick) => {
-            return await this._signalBacktestUtils.handleOpened(tick);
+            return await this.getInstance().handleOpened(tick);
         };
         /**
          * Handles signal closed event.
@@ -58436,7 +58499,7 @@ class StorageBacktestAdapter {
          * @param tick - The closed signal tick data
          */
         this.handleClosed = async (tick) => {
-            return await this._signalBacktestUtils.handleClosed(tick);
+            return await this.getInstance().handleClosed(tick);
         };
         /**
          * Handles signal scheduled event.
@@ -58444,7 +58507,7 @@ class StorageBacktestAdapter {
          * @param tick - The scheduled signal tick data
          */
         this.handleScheduled = async (tick) => {
-            return await this._signalBacktestUtils.handleScheduled(tick);
+            return await this.getInstance().handleScheduled(tick);
         };
         /**
          * Handles signal cancelled event.
@@ -58452,7 +58515,7 @@ class StorageBacktestAdapter {
          * @param tick - The cancelled signal tick data
          */
         this.handleCancelled = async (tick) => {
-            return await this._signalBacktestUtils.handleCancelled(tick);
+            return await this.getInstance().handleCancelled(tick);
         };
         /**
          * Finds a signal by its ID.
@@ -58461,7 +58524,7 @@ class StorageBacktestAdapter {
          * @returns The signal row or null if not found
          */
         this.findById = async (id) => {
-            return await this._signalBacktestUtils.findById(id);
+            return await this.getInstance().findById(id);
         };
         /**
          * Lists all stored signals.
@@ -58469,13 +58532,13 @@ class StorageBacktestAdapter {
          * @returns Array of all signal rows
          */
         this.list = async () => {
-            return await this._signalBacktestUtils.list();
+            return await this.getInstance().list();
         };
         this.handleActivePing = async (event) => {
-            return await this._signalBacktestUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         this.handleSchedulePing = async (event) => {
-            return await this._signalBacktestUtils.handleSchedulePing(event);
+            return await this.getInstance().handleSchedulePing(event);
         };
         /**
          * Sets the storage adapter constructor.
@@ -58485,7 +58548,8 @@ class StorageBacktestAdapter {
          */
         this.useStorageAdapter = (Ctor) => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._signalBacktestUtils = Reflect.construct(Ctor, []);
+            this._signalBacktestFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy storage adapter.
@@ -58493,7 +58557,8 @@ class StorageBacktestAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._signalBacktestUtils = new StorageDummyBacktestUtils();
+            this._signalBacktestFactory = () => new StorageDummyBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter (default).
@@ -58501,7 +58566,8 @@ class StorageBacktestAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._signalBacktestUtils = new StoragePersistBacktestUtils();
+            this._signalBacktestFactory = () => new StoragePersistBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter.
@@ -58509,16 +58575,17 @@ class StorageBacktestAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+            this._signalBacktestFactory = () => new StorageMemoryBacktestUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default in-memory adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
-            this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -58533,15 +58600,23 @@ class StorageBacktestAdapter {
  */
 class StorageLiveAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._signalLiveUtils = new StoragePersistLiveUtils();
+        /** Factory producing the active storage utils instance */
+        this._signalLiveFactory = () => new StoragePersistLiveUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._signalLiveFactory());
         /**
          * Handles signal opened event.
          * Proxies call to the underlying storage adapter.
          * @param tick - The opened signal tick data
          */
         this.handleOpened = async (tick) => {
-            return await this._signalLiveUtils.handleOpened(tick);
+            return await this.getInstance().handleOpened(tick);
         };
         /**
          * Handles signal closed event.
@@ -58549,7 +58624,7 @@ class StorageLiveAdapter {
          * @param tick - The closed signal tick data
          */
         this.handleClosed = async (tick) => {
-            return await this._signalLiveUtils.handleClosed(tick);
+            return await this.getInstance().handleClosed(tick);
         };
         /**
          * Handles signal scheduled event.
@@ -58557,7 +58632,7 @@ class StorageLiveAdapter {
          * @param tick - The scheduled signal tick data
          */
         this.handleScheduled = async (tick) => {
-            return await this._signalLiveUtils.handleScheduled(tick);
+            return await this.getInstance().handleScheduled(tick);
         };
         /**
          * Handles signal cancelled event.
@@ -58565,7 +58640,7 @@ class StorageLiveAdapter {
          * @param tick - The cancelled signal tick data
          */
         this.handleCancelled = async (tick) => {
-            return await this._signalLiveUtils.handleCancelled(tick);
+            return await this.getInstance().handleCancelled(tick);
         };
         /**
          * Finds a signal by its ID.
@@ -58574,7 +58649,7 @@ class StorageLiveAdapter {
          * @returns The signal row or null if not found
          */
         this.findById = async (id) => {
-            return await this._signalLiveUtils.findById(id);
+            return await this.getInstance().findById(id);
         };
         /**
          * Lists all stored signals.
@@ -58582,13 +58657,13 @@ class StorageLiveAdapter {
          * @returns Array of all signal rows
          */
         this.list = async () => {
-            return await this._signalLiveUtils.list();
+            return await this.getInstance().list();
         };
         this.handleActivePing = async (event) => {
-            return await this._signalLiveUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         this.handleSchedulePing = async (event) => {
-            return await this._signalLiveUtils.handleSchedulePing(event);
+            return await this.getInstance().handleSchedulePing(event);
         };
         /**
          * Sets the storage adapter constructor.
@@ -58598,7 +58673,8 @@ class StorageLiveAdapter {
          */
         this.useStorageAdapter = (Ctor) => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._signalLiveUtils = Reflect.construct(Ctor, []);
+            this._signalLiveFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy storage adapter.
@@ -58606,7 +58682,8 @@ class StorageLiveAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._signalLiveUtils = new StorageDummyLiveUtils();
+            this._signalLiveFactory = () => new StorageDummyLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter (default).
@@ -58614,7 +58691,8 @@ class StorageLiveAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._signalLiveUtils = new StoragePersistLiveUtils();
+            this._signalLiveFactory = () => new StoragePersistLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter.
@@ -58622,16 +58700,17 @@ class StorageLiveAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._signalLiveUtils = new StorageMemoryLiveUtils();
+            this._signalLiveFactory = () => new StorageMemoryLiveUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default persistent adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_CLEAR);
-            this._signalLiveUtils = new StoragePersistLiveUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -60747,18 +60826,26 @@ class NotificationPersistLiveUtils {
  */
 class NotificationBacktestAdapter {
     constructor() {
-        /** Internal notification utils instance */
-        this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+        /** Factory producing the active notification utils instance */
+        this._notificationBacktestFactory = () => new NotificationMemoryBacktestUtils();
+        /**
+         * Lazily constructs the notification utils from the registered factory and
+         * memoizes the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._notificationBacktestFactory());
         /**
          * Handles signal events.
          * Proxies call to the underlying notification adapter.
          * @param data - The strategy tick result data
          */
         this.handleSignal = async (data) => {
-            return await this._notificationBacktestUtils.handleSignal(data);
+            return await this.getInstance().handleSignal(data);
         };
         this.handleSignalNotify = async (data) => {
-            return await this._notificationBacktestUtils.handleSignalNotify(data);
+            return await this.getInstance().handleSignalNotify(data);
         };
         /**
          * Handles partial profit availability event.
@@ -60766,7 +60853,7 @@ class NotificationBacktestAdapter {
          * @param data - The partial profit contract data
          */
         this.handlePartialProfit = async (data) => {
-            return await this._notificationBacktestUtils.handlePartialProfit(data);
+            return await this.getInstance().handlePartialProfit(data);
         };
         /**
          * Handles partial loss availability event.
@@ -60774,7 +60861,7 @@ class NotificationBacktestAdapter {
          * @param data - The partial loss contract data
          */
         this.handlePartialLoss = async (data) => {
-            return await this._notificationBacktestUtils.handlePartialLoss(data);
+            return await this.getInstance().handlePartialLoss(data);
         };
         /**
          * Handles breakeven availability event.
@@ -60782,7 +60869,7 @@ class NotificationBacktestAdapter {
          * @param data - The breakeven contract data
          */
         this.handleBreakeven = async (data) => {
-            return await this._notificationBacktestUtils.handleBreakeven(data);
+            return await this.getInstance().handleBreakeven(data);
         };
         /**
          * Handles strategy commit events.
@@ -60790,7 +60877,7 @@ class NotificationBacktestAdapter {
          * @param data - The strategy commit contract data
          */
         this.handleStrategyCommit = async (data) => {
-            return await this._notificationBacktestUtils.handleStrategyCommit(data);
+            return await this.getInstance().handleStrategyCommit(data);
         };
         /**
          * Handles signal sync events (signal-open, signal-close).
@@ -60798,7 +60885,7 @@ class NotificationBacktestAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = functoolsKit.trycatch(async (data) => {
-            return await this._notificationBacktestUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60808,7 +60895,7 @@ class NotificationBacktestAdapter {
          * @param data - The risk contract data
          */
         this.handleRisk = async (data) => {
-            return await this._notificationBacktestUtils.handleRisk(data);
+            return await this.getInstance().handleRisk(data);
         };
         /**
          * Handles error event.
@@ -60816,7 +60903,7 @@ class NotificationBacktestAdapter {
          * @param error - The error object
          */
         this.handleError = async (error) => {
-            return await this._notificationBacktestUtils.handleError(error);
+            return await this.getInstance().handleError(error);
         };
         /**
          * Handles critical error event.
@@ -60824,7 +60911,7 @@ class NotificationBacktestAdapter {
          * @param error - The error object
          */
         this.handleCriticalError = async (error) => {
-            return await this._notificationBacktestUtils.handleCriticalError(error);
+            return await this.getInstance().handleCriticalError(error);
         };
         /**
          * Handles validation error event.
@@ -60832,7 +60919,7 @@ class NotificationBacktestAdapter {
          * @param error - The error object
          */
         this.handleValidationError = async (error) => {
-            return await this._notificationBacktestUtils.handleValidationError(error);
+            return await this.getInstance().handleValidationError(error);
         };
         /**
          * Gets all stored notifications.
@@ -60840,14 +60927,14 @@ class NotificationBacktestAdapter {
          * @returns Array of all notification models
          */
         this.getData = async () => {
-            return await this._notificationBacktestUtils.getData();
+            return await this.getInstance().getData();
         };
         /**
          * Clears all stored notifications.
          * Proxies call to the underlying notification adapter.
          */
         this.dispose = async () => {
-            return await this._notificationBacktestUtils.dispose();
+            return await this.getInstance().dispose();
         };
         /**
          * Sets the notification adapter constructor.
@@ -60857,7 +60944,8 @@ class NotificationBacktestAdapter {
          */
         this.useNotificationAdapter = (Ctor) => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._notificationBacktestUtils = Reflect.construct(Ctor, []);
+            this._notificationBacktestFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy notification adapter.
@@ -60865,7 +60953,8 @@ class NotificationBacktestAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._notificationBacktestUtils = new NotificationDummyBacktestUtils();
+            this._notificationBacktestFactory = () => new NotificationDummyBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory notification adapter (default).
@@ -60873,7 +60962,8 @@ class NotificationBacktestAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+            this._notificationBacktestFactory = () => new NotificationMemoryBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent notification adapter.
@@ -60881,16 +60971,17 @@ class NotificationBacktestAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._notificationBacktestUtils = new NotificationPersistBacktestUtils();
+            this._notificationBacktestFactory = () => new NotificationPersistBacktestUtils();
+            this.getInstance.clear();
         };
         /**
-         * Resets the cached utils instance to the default in-memory adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
-            this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -60905,18 +60996,26 @@ class NotificationBacktestAdapter {
  */
 class NotificationLiveAdapter {
     constructor() {
-        /** Internal notification utils instance */
-        this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+        /** Factory producing the active notification utils instance */
+        this._notificationLiveFactory = () => new NotificationMemoryLiveUtils();
+        /**
+         * Lazily constructs the notification utils from the registered factory and
+         * memoizes the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._notificationLiveFactory());
         /**
          * Handles signal events.
          * Proxies call to the underlying notification adapter.
          * @param data - The strategy tick result data
          */
         this.handleSignal = async (data) => {
-            return await this._notificationLiveUtils.handleSignal(data);
+            return await this.getInstance().handleSignal(data);
         };
         this.handleSignalNotify = async (data) => {
-            return await this._notificationLiveUtils.handleSignalNotify(data);
+            return await this.getInstance().handleSignalNotify(data);
         };
         /**
          * Handles partial profit availability event.
@@ -60924,7 +61023,7 @@ class NotificationLiveAdapter {
          * @param data - The partial profit contract data
          */
         this.handlePartialProfit = async (data) => {
-            return await this._notificationLiveUtils.handlePartialProfit(data);
+            return await this.getInstance().handlePartialProfit(data);
         };
         /**
          * Handles partial loss availability event.
@@ -60932,7 +61031,7 @@ class NotificationLiveAdapter {
          * @param data - The partial loss contract data
          */
         this.handlePartialLoss = async (data) => {
-            return await this._notificationLiveUtils.handlePartialLoss(data);
+            return await this.getInstance().handlePartialLoss(data);
         };
         /**
          * Handles breakeven availability event.
@@ -60940,7 +61039,7 @@ class NotificationLiveAdapter {
          * @param data - The breakeven contract data
          */
         this.handleBreakeven = async (data) => {
-            return await this._notificationLiveUtils.handleBreakeven(data);
+            return await this.getInstance().handleBreakeven(data);
         };
         /**
          * Handles strategy commit events.
@@ -60948,7 +61047,7 @@ class NotificationLiveAdapter {
          * @param data - The strategy commit contract data
          */
         this.handleStrategyCommit = async (data) => {
-            return await this._notificationLiveUtils.handleStrategyCommit(data);
+            return await this.getInstance().handleStrategyCommit(data);
         };
         /**
          * Handles signal sync events (signal-open, signal-close).
@@ -60956,7 +61055,7 @@ class NotificationLiveAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = functoolsKit.trycatch(async (data) => {
-            return await this._notificationLiveUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60966,7 +61065,7 @@ class NotificationLiveAdapter {
          * @param data - The risk contract data
          */
         this.handleRisk = async (data) => {
-            return await this._notificationLiveUtils.handleRisk(data);
+            return await this.getInstance().handleRisk(data);
         };
         /**
          * Handles error event.
@@ -60974,7 +61073,7 @@ class NotificationLiveAdapter {
          * @param error - The error object
          */
         this.handleError = async (error) => {
-            return await this._notificationLiveUtils.handleError(error);
+            return await this.getInstance().handleError(error);
         };
         /**
          * Handles critical error event.
@@ -60982,7 +61081,7 @@ class NotificationLiveAdapter {
          * @param error - The error object
          */
         this.handleCriticalError = async (error) => {
-            return await this._notificationLiveUtils.handleCriticalError(error);
+            return await this.getInstance().handleCriticalError(error);
         };
         /**
          * Handles validation error event.
@@ -60990,7 +61089,7 @@ class NotificationLiveAdapter {
          * @param error - The error object
          */
         this.handleValidationError = async (error) => {
-            return await this._notificationLiveUtils.handleValidationError(error);
+            return await this.getInstance().handleValidationError(error);
         };
         /**
          * Gets all stored notifications.
@@ -60998,14 +61097,14 @@ class NotificationLiveAdapter {
          * @returns Array of all notification models
          */
         this.getData = async () => {
-            return await this._notificationLiveUtils.getData();
+            return await this.getInstance().getData();
         };
         /**
          * Clears all stored notifications.
          * Proxies call to the underlying notification adapter.
          */
         this.dispose = async () => {
-            return await this._notificationLiveUtils.dispose();
+            return await this.getInstance().dispose();
         };
         /**
          * Sets the notification adapter constructor.
@@ -61015,7 +61114,8 @@ class NotificationLiveAdapter {
          */
         this.useNotificationAdapter = (Ctor) => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._notificationLiveUtils = Reflect.construct(Ctor, []);
+            this._notificationLiveFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy notification adapter.
@@ -61023,7 +61123,8 @@ class NotificationLiveAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._notificationLiveUtils = new NotificationDummyLiveUtils();
+            this._notificationLiveFactory = () => new NotificationDummyLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory notification adapter (default).
@@ -61031,7 +61132,8 @@ class NotificationLiveAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+            this._notificationLiveFactory = () => new NotificationMemoryLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent notification adapter.
@@ -61039,16 +61141,17 @@ class NotificationLiveAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._notificationLiveUtils = new NotificationPersistLiveUtils();
+            this._notificationLiveFactory = () => new NotificationPersistLiveUtils();
+            this.getInstance.clear();
         };
         /**
-         * Resets the cached utils instance to the default in-memory adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_CLEAR);
-            this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+            this.getInstance.clear();
         };
     }
 }