backtest-kit 15.0.0 → 15.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backtest-kit",
-  "version": "15.0.0",
+  "version": "15.2.0",
   "description": "A TypeScript library for trading system backtest",
   "author": {
     "name": "Petr Tripolsky",
@@ -78,7 +78,7 @@
     "di-scoped": "^1.0.21",
     "di-singleton": "^1.0.5",
     "functools-kit": "^4.0.0",
-    "get-moment-stamp": "^2.0.0"
+    "get-moment-stamp": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"

package/types.d.ts

@@ -32129,7 +32129,9 @@ declare class ClientExchange implements IExchange {
      * @param symbol - Trading pair symbol
      * @param interval - Candle interval
      * @param limit - Number of candles to fetch
-     * @returns Promise resolving to array of candles
+     * @returns Promise resolving to array of candles; an EMPTY array when the
+     *          requested range extends beyond Date.now() (those candles have not
+     *          closed yet in the real world — the caller decides how to proceed)
      * @throws Error if trying to fetch future candles in live mode
      */
     getNextCandles(symbol: string, interval: CandleInterval, limit: number): Promise<ICandleData[]>;
@@ -32470,10 +32472,20 @@ declare class ClientRisk implements IRisk {
     readonly params: IRiskParams;
     /**
      * Map of active positions tracked across all strategies.
-     * Key: `${strategyName}:${exchangeName}:${symbol}`
+     * Key: `${strategyName}_${exchangeName}_${symbol}` (see CREATE_NAME_FN)
      * Starts as POSITION_NEED_FETCH symbol, gets initialized on first use.
      */
     _activePositions: RiskMap | typeof POSITION_NEED_FETCH;
+    /**
+     * Keys of transient reservation placeholders (checkSignalAndReserve) still
+     * awaiting their finalizing addSignal / releasing removeSignal. Excluded from
+     * persisted snapshots in _updatePositions: a reservation is process-transient,
+     * but a CONCURRENT strategy's addSignal persists the whole shared map — flushed
+     * to disk that placeholder would survive a crash as a phantom position and
+     * block the shared concurrency limit for the whole signal lifetime (forever
+     * for minuteEstimatedTime: Infinity, which the expiry pruning never removes).
+     */
+    _reservedKeys: Set<string>;
     constructor(params: IRiskParams);
     /**
      * Initializes active positions by loading from persistence.
@@ -35089,6 +35101,12 @@ declare class ClientAction implements IAction {
      * Starts as null, gets initialized on first use.
      */
     _handlerInstance: ActionProxy | null;
+    /**
+     * Terminal flag set by dispose(). Once true, all event methods become no-ops:
+     * the handler will not be recreated (waitForInit is singleshot), so late
+     * events must not reach the schema callbacks either.
+     */
+    _isDisposed: boolean;
     /**
      * Creates a new ClientAction instance.
      *