backtest-kit 7.6.0 → 7.7.0

package/build/index.cjs

@@ -47978,6 +47978,7 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @returns Promise resolving to current state value, or initialValue if no signal
@@ -47997,16 +47998,16 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
  * }
  * ```
  */
-async function getSignalState(dto) {
+async function getSignalState(symbol, dto) {
     const { bucketName, initialValue } = dto;
-    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { bucketName });
+    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { symbol, bucketName });
     if (!ExecutionContextService.hasContext()) {
         throw new Error("getSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("getSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -48042,6 +48043,7 @@ async function getSignalState(dto) {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @param dto.dispatch - New value or updater function receiving current value
@@ -48065,7 +48067,7 @@ async function getSignalState(dto) {
  * );
  * ```
  */
-async function setSignalState(dispatch, dto) {
+async function setSignalState(symbol, dispatch, dto) {
     const { bucketName, initialValue } = dto;
     backtest.loggerService.info(SET_SIGNAL_STATE_METHOD_NAME, { bucketName });
     if (!ExecutionContextService.hasContext()) {
@@ -48074,7 +48076,7 @@ async function setSignalState(dispatch, dto) {
     if (!MethodContextService.hasContext()) {
         throw new Error("setSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -48632,14 +48634,14 @@ async function setSessionData(symbol, value) {
 }
 
 const CREATE_SIGNAL_STATE_METHOD_NAME = "state.createSignalState";
-const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
+const CREATE_SET_STATE_FN = (params) => async (symbol, dispatch) => {
     if (!ExecutionContextService.hasContext()) {
         throw new Error("createSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("createSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -48661,14 +48663,14 @@ const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
     }
     throw new Error(`createSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${params.bucketName}`);
 };
-const CREATE_GET_STATE_FN = (params) => async () => {
+const CREATE_GET_STATE_FN = (params) => async (symbol) => {
     if (!ExecutionContextService.hasContext()) {
         throw new Error("createSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("createSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;

package/build/index.mjs

@@ -47958,6 +47958,7 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @returns Promise resolving to current state value, or initialValue if no signal
@@ -47977,16 +47978,16 @@ async function getMinutesSinceLatestSignalCreated(symbol) {
  * }
  * ```
  */
-async function getSignalState(dto) {
+async function getSignalState(symbol, dto) {
     const { bucketName, initialValue } = dto;
-    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { bucketName });
+    backtest.loggerService.info(GET_SIGNAL_STATE_METHOD_NAME, { symbol, bucketName });
     if (!ExecutionContextService.hasContext()) {
         throw new Error("getSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("getSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -48022,6 +48023,7 @@ async function getSignalState(dto) {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @param dto.dispatch - New value or updater function receiving current value
@@ -48045,7 +48047,7 @@ async function getSignalState(dto) {
  * );
  * ```
  */
-async function setSignalState(dispatch, dto) {
+async function setSignalState(symbol, dispatch, dto) {
     const { bucketName, initialValue } = dto;
     backtest.loggerService.info(SET_SIGNAL_STATE_METHOD_NAME, { bucketName });
     if (!ExecutionContextService.hasContext()) {
@@ -48054,7 +48056,7 @@ async function setSignalState(dispatch, dto) {
     if (!MethodContextService.hasContext()) {
         throw new Error("setSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -48612,14 +48614,14 @@ async function setSessionData(symbol, value) {
 }
 
 const CREATE_SIGNAL_STATE_METHOD_NAME = "state.createSignalState";
-const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
+const CREATE_SET_STATE_FN = (params) => async (symbol, dispatch) => {
     if (!ExecutionContextService.hasContext()) {
         throw new Error("createSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("createSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;
@@ -48641,14 +48643,14 @@ const CREATE_SET_STATE_FN = (params) => async (dispatch) => {
     }
     throw new Error(`createSignalState requires a pending or scheduled signal for symbol=${symbol} bucketName=${params.bucketName}`);
 };
-const CREATE_GET_STATE_FN = (params) => async () => {
+const CREATE_GET_STATE_FN = (params) => async (symbol) => {
     if (!ExecutionContextService.hasContext()) {
         throw new Error("createSignalState requires an execution context");
     }
     if (!MethodContextService.hasContext()) {
         throw new Error("createSignalState requires a method context");
     }
-    const { backtest: isBacktest, symbol } = backtest.executionContextService.context;
+    const { backtest: isBacktest } = backtest.executionContextService.context;
     const { exchangeName, frameName, strategyName } = backtest.methodContextService.context;
     const currentPrice = await backtest.exchangeConnectionService.getAveragePrice(symbol);
     let signal;

package/package.json

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

package/types.d.ts

@@ -9358,6 +9358,7 @@ declare function getMinutesSinceLatestSignalCreated(symbol: string): Promise<num
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @returns Promise resolving to current state value, or initialValue if no signal
@@ -9377,7 +9378,7 @@ declare function getMinutesSinceLatestSignalCreated(symbol: string): Promise<num
  * }
  * ```
  */
-declare function getSignalState<Value extends object = object>(dto: {
+declare function getSignalState<Value extends object = object>(symbol: string, dto: {
     bucketName: string;
     initialValue: Value;
 }): Promise<Value>;
@@ -9395,6 +9396,7 @@ declare function getSignalState<Value extends object = object>(dto: {
  * SL trades show peak < 0.15% (Feb08, Feb13) or never go positive (Feb25).
  * Rule: if minutesOpen >= N and peakPercent < threshold (e.g. 0.3%) — exit.
  *
+ * @param symbol - Trading pair symbol
  * @param dto.bucketName - State bucket name
  * @param dto.initialValue - Default value when no persisted state exists
  * @param dto.dispatch - New value or updater function receiving current value
@@ -9418,7 +9420,7 @@ declare function getSignalState<Value extends object = object>(dto: {
  * );
  * ```
  */
-declare function setSignalState<Value extends object = object>(dispatch: Value | Dispatch$1<Value>, dto: {
+declare function setSignalState<Value extends object = object>(symbol: string, dispatch: Value | Dispatch$1<Value>, dto: {
     bucketName: string;
     initialValue: Value;
 }): Promise<Value>;
@@ -9771,18 +9773,20 @@ interface IStateParams<Value extends object = object> {
 /**
  * Reads the current state value for the active pending or scheduled signal.
  * Resolved from execution context — no signalId argument required.
+ * @param symbol - Trading pair symbol
  * @returns Current state value
  * @throws Error if no pending or scheduled signal exists
  */
-type GetStateFn<Value extends object = object> = () => Promise<Value>;
+type GetStateFn<Value extends object = object> = (symbol: string) => Promise<Value>;
 /**
  * Updates the state value for the active pending or scheduled signal.
  * Resolved from execution context — no signalId argument required.
+ * @param symbol - Trading pair symbol
  * @param dispatch - New value or updater function receiving current value
  * @returns Updated state value
  * @throws Error if no pending or scheduled signal exists
  */
-type SetStateFn<Value extends object = object> = (dispatch: Value | Dispatch<Value>) => Promise<Value>;
+type SetStateFn<Value extends object = object> = (symbol: string, dispatch: Value | Dispatch<Value>) => Promise<Value>;
 /**
  * Tuple returned by createSignalState — [getState, setState] bound to the bucket.
  * Both functions resolve the active signal and backtest flag from execution context automatically.