backtest-kit 1.6.3 → 1.6.5

package/README.md

@@ -2,7 +2,7 @@
 
 # 🧿 Backtest Kit
 
-> A TypeScript framework for backtesting and live trading strategies on multi-asset, crypto or forex, with crash-safe persistence, signal validation, and AI optimization.
+> A TypeScript framework for backtesting and live trading strategies on multi-asset, crypto, forex or [DEX (peer-to-peer marketplace)](https://en.wikipedia.org/wiki/Decentralized_finance#Decentralized_exchanges) with crash-safe persistence, signal validation, and AI optimization.
 
 ![future](./assets/prophet.png)
 

package/build/index.cjs

@@ -3734,11 +3734,22 @@ class RiskUtils {
  */
 const Risk = new RiskUtils();
 
+/**
+ * No-operation IRisk implementation.
+ * Always allows signals and performs no actions.
+ */
 const NOOP_RISK = {
     checkSignal: () => Promise.resolve(true),
     addSignal: () => Promise.resolve(),
     removeSignal: () => Promise.resolve(),
 };
+/**
+ * Determines the appropriate IRisk instance based on provided riskName and riskList.
+ * @param dto - Object containing riskName and riskList
+ * @param backtest - Whether running in backtest mode
+ * @param self - Reference to StrategyConnectionService instance
+ * @returns Configured IRisk instance (single or merged)
+ */
 const GET_RISK_FN = (dto, backtest, self) => {
     const hasRiskName = !!dto.riskName;
     const hasRiskList = !!dto.riskList?.length;
@@ -3760,6 +3771,15 @@ const GET_RISK_FN = (dto, backtest, self) => {
         ...dto.riskList.map((riskName) => self.riskConnectionService.getRisk(riskName, backtest)),
     ]);
 };
+/**
+ * Creates a unique key for memoizing ClientStrategy instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$9 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Callback function for emitting ping events to pingSubject.
  *
@@ -3820,7 +3840,7 @@ class StrategyConnectionService {
          * @param strategyName - Name of registered strategy schema
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, (symbol, strategyName, backtest) => {
+        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, backtest), (symbol, strategyName, backtest) => {
             const { riskName = "", riskList = [], getSignal, interval, callbacks, } = this.strategySchemaService.get(strategyName);
             return new ClientStrategy({
                 symbol,
@@ -3987,7 +4007,7 @@ class StrategyConnectionService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$9(ctx.symbol, ctx.strategyName, backtest);
                 this.getStrategy.clear(key);
             }
             else {
@@ -4590,6 +4610,14 @@ class ClientRisk {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ClientRisk instances.
+ * Key format: "riskName:backtest" or "riskName:live"
+ * @param riskName - Name of the risk schema
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$8 = (riskName, backtest) => `${riskName}:${backtest ? "backtest" : "live"}`;
 /**
  * Callback function for emitting risk rejection events to riskSubject.
  *
@@ -4661,7 +4689,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = functoolsKit.memoize(([riskName, backtest]) => `${riskName}:${backtest ? "backtest" : "live"}`, (riskName, backtest) => {
+        this.getRisk = functoolsKit.memoize(([riskName, backtest]) => CREATE_KEY_FN$8(riskName, backtest), (riskName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -4719,15 +4747,21 @@ class RiskConnectionService {
         /**
          * Clears the cached ClientRisk instance for the given risk name.
          *
-         * @param riskName - Name of the risk schema to clear from cache
+         * @param backtest - Whether running in backtest mode
+         * @param ctx - Optional context with riskName (clears all if not provided)
          */
-        this.clear = async (backtest, riskName) => {
+        this.clear = async (backtest, ctx) => {
             this.loggerService.log("riskConnectionService clear", {
-                riskName,
+                ctx,
                 backtest,
             });
-            const key = `${riskName}:${backtest ? "backtest" : "live"}`;
-            this.getRisk.clear(key);
+            if (ctx) {
+                const key = CREATE_KEY_FN$8(ctx.riskName, backtest);
+                this.getRisk.clear(key);
+            }
+            else {
+                this.getRisk.clear();
+            }
         };
     }
 }
@@ -4955,9 +4989,6 @@ class StrategyCoreService {
                 symbol,
                 strategyName,
             });
-            if (!MethodContextService.hasContext()) {
-                throw new Error("strategyCoreService getPendingSignal requires a method context");
-            }
             await this.validate(symbol, strategyName);
             return await this.strategyConnectionService.getPendingSignal(backtest, symbol, strategyName);
         };
@@ -4975,9 +5006,6 @@ class StrategyCoreService {
                 symbol,
                 strategyName,
             });
-            if (!MethodContextService.hasContext()) {
-                throw new Error("strategyCoreService getScheduledSignal requires a method context");
-            }
             await this.validate(symbol, strategyName);
             return await this.strategyConnectionService.getScheduledSignal(backtest, symbol, strategyName);
         };
@@ -4997,9 +5025,6 @@ class StrategyCoreService {
                 strategyName,
                 backtest,
             });
-            if (!MethodContextService.hasContext()) {
-                throw new Error("strategyCoreService getStopped requires a method context");
-            }
             await this.validate(symbol, strategyName);
             return await this.strategyConnectionService.getStopped(backtest, symbol, strategyName);
         };
@@ -5256,19 +5281,20 @@ class RiskGlobalService {
         };
         /**
          * Clears risk data.
-         * If riskName is provided, clears data for that specific risk instance.
-         * If no riskName is provided, clears all risk data.
-         * @param riskName - Optional name of the risk instance to clear
+         * If ctx is provided, clears data for that specific risk instance.
+         * If no ctx is provided, clears all risk data.
+         * @param backtest - Whether running in backtest mode
+         * @param ctx - Optional context with riskName (clears all if not provided)
          */
-        this.clear = async (backtest, riskName) => {
+        this.clear = async (backtest, ctx) => {
             this.loggerService.log("riskGlobalService clear", {
-                riskName,
+                ctx,
                 backtest,
             });
-            if (riskName) {
-                await this.validate(riskName);
+            if (ctx) {
+                await this.validate(ctx.riskName);
             }
-            return await this.riskConnectionService.clear(backtest, riskName);
+            return await this.riskConnectionService.clear(backtest, ctx);
         };
     }
 }
@@ -7761,6 +7787,15 @@ const COLUMN_CONFIG = {
  */
 const DEFAULT_COLUMNS = Object.freeze({ ...COLUMN_CONFIG });
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$7 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Checks if a value is unsafe for display (not a number, NaN, or Infinity).
  *
@@ -7969,7 +8004,7 @@ class BacktestMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$5());
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$7(symbol, strategyName, backtest), () => new ReportStorage$5());
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from IStrategyCallbacks.onTick.
@@ -8107,7 +8142,7 @@ class BacktestMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$7(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -8132,6 +8167,15 @@ class BacktestMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$6 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Checks if a value is unsafe for display (not a number, NaN, or Infinity).
  *
@@ -8461,7 +8505,7 @@ class LiveMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$4());
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$6(symbol, strategyName, backtest), () => new ReportStorage$4());
         /**
          * Processes tick events and accumulates all event types.
          * Should be called from IStrategyCallbacks.onTick.
@@ -8609,7 +8653,7 @@ class LiveMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$6(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -8634,6 +8678,15 @@ class LiveMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$5 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /** Maximum number of events to store in schedule reports */
 const MAX_EVENTS$4 = 250;
 /**
@@ -8869,7 +8922,7 @@ class ScheduleMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$3());
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, backtest), () => new ReportStorage$3());
         /**
          * Processes tick events and accumulates scheduled/opened/cancelled events.
          * Should be called from signalEmitter subscription.
@@ -9011,7 +9064,7 @@ class ScheduleMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$5(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -9036,6 +9089,15 @@ class ScheduleMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing PerformanceStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$4 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Calculates percentile value from sorted array.
  */
@@ -9253,7 +9315,7 @@ class PerformanceMarkdownService {
          * Memoized function to get or create PerformanceStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new PerformanceStorage());
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$4(symbol, strategyName, backtest), () => new PerformanceStorage());
         /**
          * Processes performance events and accumulates metrics.
          * Should be called from performance tracking code.
@@ -9358,7 +9420,7 @@ class PerformanceMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$4(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -9785,6 +9847,14 @@ class WalkerMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing HeatmapStorage instances.
+ * Key format: "strategyName:backtest" or "strategyName:live"
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$3 = (strategyName, backtest) => `${strategyName}:${backtest ? "backtest" : "live"}`;
 const HEATMAP_METHOD_NAME_GET_DATA = "HeatMarkdownService.getData";
 const HEATMAP_METHOD_NAME_GET_REPORT = "HeatMarkdownService.getReport";
 const HEATMAP_METHOD_NAME_DUMP = "HeatMarkdownService.dump";
@@ -10128,7 +10198,7 @@ class HeatMarkdownService {
          * Memoized function to get or create HeatmapStorage for a strategy and backtest mode.
          * Each strategy + backtest mode combination gets its own isolated heatmap storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([strategyName, backtest]) => `${strategyName}:${backtest ? "backtest" : "live"}`, () => new HeatmapStorage());
+        this.getStorage = functoolsKit.memoize(([strategyName, backtest]) => CREATE_KEY_FN$3(strategyName, backtest), () => new HeatmapStorage());
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from signal emitter subscription.
@@ -10264,7 +10334,7 @@ class HeatMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$3(ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -12474,6 +12544,15 @@ class ClientPartial {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ClientPartial instances.
+ * Key format: "signalId:backtest" or "signalId:live"
+ *
+ * @param signalId - Signal ID
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$2 = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Callback function for emitting profit events to partialProfitSubject.
  *
@@ -12571,7 +12650,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => `${signalId}:${backtest ? "backtest" : "live"}`, (signalId, backtest) => {
+        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$2(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -12661,12 +12740,19 @@ class PartialConnectionService {
             const partial = this.getPartial(data.id, backtest);
             await partial.waitForInit(symbol, data.strategyName);
             await partial.clear(symbol, data, priceClose, backtest);
-            const key = `${data.id}:${backtest ? "backtest" : "live"}`;
+            const key = CREATE_KEY_FN$2(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param param0 - Tuple of symbol, strategyName and backtest boolean
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$1 = ([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /** Maximum number of events to store in partial reports */
 const MAX_EVENTS$1 = 250;
 /**
@@ -12841,7 +12927,7 @@ class PartialMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$1());
+        this.getStorage = functoolsKit.memoize(CREATE_KEY_FN$1, () => new ReportStorage$1());
         /**
          * Processes profit events and accumulates them.
          * Should be called from partialProfitSubject subscription.
@@ -12988,7 +13074,7 @@ class PartialMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$1([ctx.symbol, ctx.strategyName, backtest]);
                 this.getStorage.clear(key);
             }
             else {
@@ -13423,6 +13509,15 @@ class ConfigValidationService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /** Maximum number of events to store in risk reports */
 const MAX_EVENTS = 250;
 /**
@@ -13567,7 +13662,7 @@ class RiskMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage());
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN(symbol, strategyName, backtest), () => new ReportStorage());
         /**
          * Processes risk rejection events and accumulates them.
          * Should be called from riskSubject subscription.
@@ -13695,7 +13790,7 @@ class RiskMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -16407,8 +16502,8 @@ class BacktestInstance {
             }
             {
                 const { riskName, riskList } = backtest$1.strategySchemaService.get(context.strategyName);
-                riskName && backtest$1.riskGlobalService.clear(true, riskName);
-                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, riskName));
+                riskName && backtest$1.riskGlobalService.clear(true, { riskName });
+                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, { riskName }));
             }
             return backtest$1.backtestCommandService.run(symbol, context);
         };
@@ -17081,8 +17176,8 @@ class LiveInstance {
             }
             {
                 const { riskName, riskList } = backtest$1.strategySchemaService.get(context.strategyName);
-                riskName && backtest$1.riskGlobalService.clear(false, riskName);
-                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(false, riskName));
+                riskName && backtest$1.riskGlobalService.clear(false, { riskName });
+                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(false, { riskName }));
             }
             return backtest$1.liveCommandService.run(symbol, context);
         };
@@ -18033,9 +18128,9 @@ class WalkerInstance {
                 }
                 {
                     const { riskName, riskList } = backtest$1.strategySchemaService.get(strategyName);
-                    riskName && backtest$1.riskGlobalService.clear(true, riskName);
+                    riskName && backtest$1.riskGlobalService.clear(true, { riskName });
                     riskList &&
-                        riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, riskName));
+                        riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, { riskName }));
                 }
             }
             return backtest$1.walkerCommandService.run(symbol, {

package/build/index.mjs

@@ -3732,11 +3732,22 @@ class RiskUtils {
  */
 const Risk = new RiskUtils();
 
+/**
+ * No-operation IRisk implementation.
+ * Always allows signals and performs no actions.
+ */
 const NOOP_RISK = {
     checkSignal: () => Promise.resolve(true),
     addSignal: () => Promise.resolve(),
     removeSignal: () => Promise.resolve(),
 };
+/**
+ * Determines the appropriate IRisk instance based on provided riskName and riskList.
+ * @param dto - Object containing riskName and riskList
+ * @param backtest - Whether running in backtest mode
+ * @param self - Reference to StrategyConnectionService instance
+ * @returns Configured IRisk instance (single or merged)
+ */
 const GET_RISK_FN = (dto, backtest, self) => {
     const hasRiskName = !!dto.riskName;
     const hasRiskList = !!dto.riskList?.length;
@@ -3758,6 +3769,15 @@ const GET_RISK_FN = (dto, backtest, self) => {
         ...dto.riskList.map((riskName) => self.riskConnectionService.getRisk(riskName, backtest)),
     ]);
 };
+/**
+ * Creates a unique key for memoizing ClientStrategy instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$9 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Callback function for emitting ping events to pingSubject.
  *
@@ -3818,7 +3838,7 @@ class StrategyConnectionService {
          * @param strategyName - Name of registered strategy schema
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, (symbol, strategyName, backtest) => {
+        this.getStrategy = memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, backtest), (symbol, strategyName, backtest) => {
             const { riskName = "", riskList = [], getSignal, interval, callbacks, } = this.strategySchemaService.get(strategyName);
             return new ClientStrategy({
                 symbol,
@@ -3985,7 +4005,7 @@ class StrategyConnectionService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$9(ctx.symbol, ctx.strategyName, backtest);
                 this.getStrategy.clear(key);
             }
             else {
@@ -4588,6 +4608,14 @@ class ClientRisk {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ClientRisk instances.
+ * Key format: "riskName:backtest" or "riskName:live"
+ * @param riskName - Name of the risk schema
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$8 = (riskName, backtest) => `${riskName}:${backtest ? "backtest" : "live"}`;
 /**
  * Callback function for emitting risk rejection events to riskSubject.
  *
@@ -4659,7 +4687,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = memoize(([riskName, backtest]) => `${riskName}:${backtest ? "backtest" : "live"}`, (riskName, backtest) => {
+        this.getRisk = memoize(([riskName, backtest]) => CREATE_KEY_FN$8(riskName, backtest), (riskName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -4717,15 +4745,21 @@ class RiskConnectionService {
         /**
          * Clears the cached ClientRisk instance for the given risk name.
          *
-         * @param riskName - Name of the risk schema to clear from cache
+         * @param backtest - Whether running in backtest mode
+         * @param ctx - Optional context with riskName (clears all if not provided)
          */
-        this.clear = async (backtest, riskName) => {
+        this.clear = async (backtest, ctx) => {
             this.loggerService.log("riskConnectionService clear", {
-                riskName,
+                ctx,
                 backtest,
             });
-            const key = `${riskName}:${backtest ? "backtest" : "live"}`;
-            this.getRisk.clear(key);
+            if (ctx) {
+                const key = CREATE_KEY_FN$8(ctx.riskName, backtest);
+                this.getRisk.clear(key);
+            }
+            else {
+                this.getRisk.clear();
+            }
         };
     }
 }
@@ -4953,9 +4987,6 @@ class StrategyCoreService {
                 symbol,
                 strategyName,
             });
-            if (!MethodContextService.hasContext()) {
-                throw new Error("strategyCoreService getPendingSignal requires a method context");
-            }
             await this.validate(symbol, strategyName);
             return await this.strategyConnectionService.getPendingSignal(backtest, symbol, strategyName);
         };
@@ -4973,9 +5004,6 @@ class StrategyCoreService {
                 symbol,
                 strategyName,
             });
-            if (!MethodContextService.hasContext()) {
-                throw new Error("strategyCoreService getScheduledSignal requires a method context");
-            }
             await this.validate(symbol, strategyName);
             return await this.strategyConnectionService.getScheduledSignal(backtest, symbol, strategyName);
         };
@@ -4995,9 +5023,6 @@ class StrategyCoreService {
                 strategyName,
                 backtest,
             });
-            if (!MethodContextService.hasContext()) {
-                throw new Error("strategyCoreService getStopped requires a method context");
-            }
             await this.validate(symbol, strategyName);
             return await this.strategyConnectionService.getStopped(backtest, symbol, strategyName);
         };
@@ -5254,19 +5279,20 @@ class RiskGlobalService {
         };
         /**
          * Clears risk data.
-         * If riskName is provided, clears data for that specific risk instance.
-         * If no riskName is provided, clears all risk data.
-         * @param riskName - Optional name of the risk instance to clear
+         * If ctx is provided, clears data for that specific risk instance.
+         * If no ctx is provided, clears all risk data.
+         * @param backtest - Whether running in backtest mode
+         * @param ctx - Optional context with riskName (clears all if not provided)
          */
-        this.clear = async (backtest, riskName) => {
+        this.clear = async (backtest, ctx) => {
             this.loggerService.log("riskGlobalService clear", {
-                riskName,
+                ctx,
                 backtest,
             });
-            if (riskName) {
-                await this.validate(riskName);
+            if (ctx) {
+                await this.validate(ctx.riskName);
             }
-            return await this.riskConnectionService.clear(backtest, riskName);
+            return await this.riskConnectionService.clear(backtest, ctx);
         };
     }
 }
@@ -7759,6 +7785,15 @@ const COLUMN_CONFIG = {
  */
 const DEFAULT_COLUMNS = Object.freeze({ ...COLUMN_CONFIG });
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$7 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Checks if a value is unsafe for display (not a number, NaN, or Infinity).
  *
@@ -7967,7 +8002,7 @@ class BacktestMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$5());
+        this.getStorage = memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$7(symbol, strategyName, backtest), () => new ReportStorage$5());
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from IStrategyCallbacks.onTick.
@@ -8105,7 +8140,7 @@ class BacktestMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$7(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -8130,6 +8165,15 @@ class BacktestMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$6 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Checks if a value is unsafe for display (not a number, NaN, or Infinity).
  *
@@ -8459,7 +8503,7 @@ class LiveMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$4());
+        this.getStorage = memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$6(symbol, strategyName, backtest), () => new ReportStorage$4());
         /**
          * Processes tick events and accumulates all event types.
          * Should be called from IStrategyCallbacks.onTick.
@@ -8607,7 +8651,7 @@ class LiveMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$6(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -8632,6 +8676,15 @@ class LiveMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$5 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /** Maximum number of events to store in schedule reports */
 const MAX_EVENTS$4 = 250;
 /**
@@ -8867,7 +8920,7 @@ class ScheduleMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$3());
+        this.getStorage = memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, backtest), () => new ReportStorage$3());
         /**
          * Processes tick events and accumulates scheduled/opened/cancelled events.
          * Should be called from signalEmitter subscription.
@@ -9009,7 +9062,7 @@ class ScheduleMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$5(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -9034,6 +9087,15 @@ class ScheduleMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing PerformanceStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$4 = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /**
  * Calculates percentile value from sorted array.
  */
@@ -9251,7 +9313,7 @@ class PerformanceMarkdownService {
          * Memoized function to get or create PerformanceStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new PerformanceStorage());
+        this.getStorage = memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN$4(symbol, strategyName, backtest), () => new PerformanceStorage());
         /**
          * Processes performance events and accumulates metrics.
          * Should be called from performance tracking code.
@@ -9356,7 +9418,7 @@ class PerformanceMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$4(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -9783,6 +9845,14 @@ class WalkerMarkdownService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing HeatmapStorage instances.
+ * Key format: "strategyName:backtest" or "strategyName:live"
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$3 = (strategyName, backtest) => `${strategyName}:${backtest ? "backtest" : "live"}`;
 const HEATMAP_METHOD_NAME_GET_DATA = "HeatMarkdownService.getData";
 const HEATMAP_METHOD_NAME_GET_REPORT = "HeatMarkdownService.getReport";
 const HEATMAP_METHOD_NAME_DUMP = "HeatMarkdownService.dump";
@@ -10126,7 +10196,7 @@ class HeatMarkdownService {
          * Memoized function to get or create HeatmapStorage for a strategy and backtest mode.
          * Each strategy + backtest mode combination gets its own isolated heatmap storage instance.
          */
-        this.getStorage = memoize(([strategyName, backtest]) => `${strategyName}:${backtest ? "backtest" : "live"}`, () => new HeatmapStorage());
+        this.getStorage = memoize(([strategyName, backtest]) => CREATE_KEY_FN$3(strategyName, backtest), () => new HeatmapStorage());
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from signal emitter subscription.
@@ -10262,7 +10332,7 @@ class HeatMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$3(ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -12472,6 +12542,15 @@ class ClientPartial {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ClientPartial instances.
+ * Key format: "signalId:backtest" or "signalId:live"
+ *
+ * @param signalId - Signal ID
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$2 = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Callback function for emitting profit events to partialProfitSubject.
  *
@@ -12569,7 +12648,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = memoize(([signalId, backtest]) => `${signalId}:${backtest ? "backtest" : "live"}`, (signalId, backtest) => {
+        this.getPartial = memoize(([signalId, backtest]) => CREATE_KEY_FN$2(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -12659,12 +12738,19 @@ class PartialConnectionService {
             const partial = this.getPartial(data.id, backtest);
             await partial.waitForInit(symbol, data.strategyName);
             await partial.clear(symbol, data, priceClose, backtest);
-            const key = `${data.id}:${backtest ? "backtest" : "live"}`;
+            const key = CREATE_KEY_FN$2(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param param0 - Tuple of symbol, strategyName and backtest boolean
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$1 = ([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /** Maximum number of events to store in partial reports */
 const MAX_EVENTS$1 = 250;
 /**
@@ -12839,7 +12925,7 @@ class PartialMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage$1());
+        this.getStorage = memoize(CREATE_KEY_FN$1, () => new ReportStorage$1());
         /**
          * Processes profit events and accumulates them.
          * Should be called from partialProfitSubject subscription.
@@ -12986,7 +13072,7 @@ class PartialMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN$1([ctx.symbol, ctx.strategyName, backtest]);
                 this.getStorage.clear(key);
             }
             else {
@@ -13421,6 +13507,15 @@ class ConfigValidationService {
     }
 }
 
+/**
+ * Creates a unique key for memoizing ReportStorage instances.
+ * Key format: "symbol:strategyName:backtest" or "symbol:strategyName:live"
+ * @param symbol - Trading pair symbol
+ * @param strategyName - Name of the strategy
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN = (symbol, strategyName, backtest) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`;
 /** Maximum number of events to store in risk reports */
 const MAX_EVENTS = 250;
 /**
@@ -13565,7 +13660,7 @@ class RiskMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-backtest triple.
          * Each symbol-strategy-backtest combination gets its own isolated storage instance.
          */
-        this.getStorage = memoize(([symbol, strategyName, backtest]) => `${symbol}:${strategyName}:${backtest ? "backtest" : "live"}`, () => new ReportStorage());
+        this.getStorage = memoize(([symbol, strategyName, backtest]) => CREATE_KEY_FN(symbol, strategyName, backtest), () => new ReportStorage());
         /**
          * Processes risk rejection events and accumulates them.
          * Should be called from riskSubject subscription.
@@ -13693,7 +13788,7 @@ class RiskMarkdownService {
                 ctx,
             });
             if (ctx) {
-                const key = `${ctx.symbol}:${ctx.strategyName}:${backtest ? "backtest" : "live"}`;
+                const key = CREATE_KEY_FN(ctx.symbol, ctx.strategyName, backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -16405,8 +16500,8 @@ class BacktestInstance {
             }
             {
                 const { riskName, riskList } = backtest$1.strategySchemaService.get(context.strategyName);
-                riskName && backtest$1.riskGlobalService.clear(true, riskName);
-                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, riskName));
+                riskName && backtest$1.riskGlobalService.clear(true, { riskName });
+                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, { riskName }));
             }
             return backtest$1.backtestCommandService.run(symbol, context);
         };
@@ -17079,8 +17174,8 @@ class LiveInstance {
             }
             {
                 const { riskName, riskList } = backtest$1.strategySchemaService.get(context.strategyName);
-                riskName && backtest$1.riskGlobalService.clear(false, riskName);
-                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(false, riskName));
+                riskName && backtest$1.riskGlobalService.clear(false, { riskName });
+                riskList && riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(false, { riskName }));
             }
             return backtest$1.liveCommandService.run(symbol, context);
         };
@@ -18031,9 +18126,9 @@ class WalkerInstance {
                 }
                 {
                     const { riskName, riskList } = backtest$1.strategySchemaService.get(strategyName);
-                    riskName && backtest$1.riskGlobalService.clear(true, riskName);
+                    riskName && backtest$1.riskGlobalService.clear(true, { riskName });
                     riskList &&
-                        riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, riskName));
+                        riskList.forEach((riskName) => backtest$1.riskGlobalService.clear(true, { riskName }));
                 }
             }
             return backtest$1.walkerCommandService.run(symbol, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backtest-kit",
-  "version": "1.6.3",
+  "version": "1.6.5",
   "description": "A TypeScript library for trading system backtest",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -8937,7 +8937,7 @@ declare class RiskConnectionService {
      * @param backtest - True if backtest mode, false if live mode
      * @returns Configured ClientRisk instance
      */
-    getRisk: ((riskName: RiskName, backtest: boolean) => ClientRisk) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, ClientRisk>;
+    getRisk: ((riskName: RiskName, backtest: boolean) => ClientRisk) & functools_kit.IClearableMemoize<`${string}:backtest` | `${string}:live`> & functools_kit.IControlMemoize<`${string}:backtest` | `${string}:live`, ClientRisk>;
     /**
      * Checks if a signal should be allowed based on risk limits.
      *
@@ -8980,9 +8980,12 @@ declare class RiskConnectionService {
     /**
      * Clears the cached ClientRisk instance for the given risk name.
      *
-     * @param riskName - Name of the risk schema to clear from cache
+     * @param backtest - Whether running in backtest mode
+     * @param ctx - Optional context with riskName (clears all if not provided)
      */
-    clear: (backtest: boolean, riskName?: RiskName) => Promise<void>;
+    clear: (backtest: boolean, ctx?: {
+        riskName: RiskName;
+    }) => Promise<void>;
 }
 
 /**
@@ -9674,11 +9677,14 @@ declare class RiskGlobalService {
     }) => Promise<void>;
     /**
      * Clears risk data.
-     * If riskName is provided, clears data for that specific risk instance.
-     * If no riskName is provided, clears all risk data.
-     * @param riskName - Optional name of the risk instance to clear
+     * If ctx is provided, clears data for that specific risk instance.
+     * If no ctx is provided, clears all risk data.
+     * @param backtest - Whether running in backtest mode
+     * @param ctx - Optional context with riskName (clears all if not provided)
      */
-    clear: (backtest: boolean, riskName?: RiskName) => Promise<void>;
+    clear: (backtest: boolean, ctx?: {
+        riskName: RiskName;
+    }) => Promise<void>;
 }
 
 /**