backtest-kit 9.8.0 → 9.8.1

package/build/index.mjs

@@ -37392,7 +37392,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 = singleshot(() => this._brokerFactory());
         /**
          * Forwards a signal-open event to the registered broker adapter.
          *
@@ -37426,7 +37438,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.
@@ -37464,7 +37479,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.
@@ -37500,7 +37518,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.
@@ -37536,7 +37557,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.
@@ -37572,7 +37596,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.
@@ -37608,7 +37635,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.
@@ -37645,7 +37675,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.
@@ -37681,7 +37714,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.
@@ -37705,11 +37741,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.
@@ -37736,7 +37773,8 @@ class BrokerAdapter {
          */
         this.enable = 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.");
             }
@@ -37824,7 +37862,7 @@ class BrokerAdapter {
          */
         this.clear = () => {
             backtest.loggerService.info(BROKER_METHOD_NAME_CLEAR, {});
-            this._brokerInstance = null;
+            this.getInstance.clear();
             this.enable.clear();
         };
     }
@@ -48844,8 +48882,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 = singleshot(() => this._recentBacktestFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48855,7 +48901,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.
@@ -48876,7 +48922,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.
@@ -48900,7 +48946,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;
             }
@@ -48913,7 +48959,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.
@@ -48921,7 +48968,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).
@@ -48929,14 +48977,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();
         };
     }
 }
@@ -48951,8 +49002,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 = singleshot(() => this._recentLiveFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48962,7 +49021,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.
@@ -48983,7 +49042,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.
@@ -49007,7 +49066,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;
             }
@@ -49020,7 +49079,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).
@@ -49028,7 +49088,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.
@@ -49036,14 +49097,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();
         };
     }
 }
@@ -54368,16 +54432,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 = 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 [];
         };
@@ -54388,8 +54462,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);
             }
         };
         /**
@@ -54399,8 +54474,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);
             }
         };
         /**
@@ -54410,8 +54486,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);
             }
         };
         /**
@@ -54421,8 +54498,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);
             }
         };
         /**
@@ -54432,7 +54510,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.
@@ -54440,7 +54519,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).
@@ -54448,7 +54528,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.
@@ -54456,7 +54537,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.
@@ -54466,18 +54548,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 = 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 || 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();
         };
     }
 }
@@ -58369,15 +58455,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 = 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.
@@ -58385,7 +58479,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.
@@ -58393,7 +58487,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.
@@ -58401,7 +58495,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.
@@ -58410,7 +58504,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.
@@ -58418,13 +58512,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.
@@ -58434,7 +58528,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.
@@ -58442,7 +58537,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).
@@ -58450,7 +58546,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.
@@ -58458,16 +58555,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();
         };
     }
 }
@@ -58482,15 +58580,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 = 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.
@@ -58498,7 +58604,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.
@@ -58506,7 +58612,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.
@@ -58514,7 +58620,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.
@@ -58523,7 +58629,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.
@@ -58531,13 +58637,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.
@@ -58547,7 +58653,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.
@@ -58555,7 +58662,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).
@@ -58563,7 +58671,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.
@@ -58571,16 +58680,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();
         };
     }
 }
@@ -60696,18 +60806,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 = 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.
@@ -60715,7 +60833,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.
@@ -60723,7 +60841,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.
@@ -60731,7 +60849,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.
@@ -60739,7 +60857,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).
@@ -60747,7 +60865,7 @@ class NotificationBacktestAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = trycatch(async (data) => {
-            return await this._notificationBacktestUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60757,7 +60875,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.
@@ -60765,7 +60883,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.
@@ -60773,7 +60891,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.
@@ -60781,7 +60899,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.
@@ -60789,14 +60907,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.
@@ -60806,7 +60924,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.
@@ -60814,7 +60933,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).
@@ -60822,7 +60942,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.
@@ -60830,16 +60951,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();
         };
     }
 }
@@ -60854,18 +60976,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 = 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.
@@ -60873,7 +61003,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.
@@ -60881,7 +61011,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.
@@ -60889,7 +61019,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.
@@ -60897,7 +61027,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).
@@ -60905,7 +61035,7 @@ class NotificationLiveAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = trycatch(async (data) => {
-            return await this._notificationLiveUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60915,7 +61045,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.
@@ -60923,7 +61053,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.
@@ -60931,7 +61061,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.
@@ -60939,7 +61069,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.
@@ -60947,14 +61077,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.
@@ -60964,7 +61094,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.
@@ -60972,7 +61103,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).
@@ -60980,7 +61112,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.
@@ -60988,16 +61121,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();
         };
     }
 }