backtest-kit 5.9.0 → 5.10.0

package/package.json

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

package/types.d.ts

@@ -2938,7 +2938,7 @@ interface IStrategy {
      * @param candles - Array of historical candle data
      * @returns Promise resolving to closed result (always completes signal)
      */
-    backtest: (symbol: string, strategyName: StrategyName, candles: ICandleData[]) => Promise<IStrategyBacktestResult>;
+    backtest: (symbol: string, strategyName: StrategyName, candles: ICandleData[], frameEndTime: number) => Promise<IStrategyBacktestResult>;
     /**
      * Stops the strategy from generating new signals.
      *
@@ -8417,6 +8417,7 @@ declare function writeMemory<T extends object = object>(dto: {
     bucketName: string;
     memoryId: string;
     value: T;
+    description: string;
 }): Promise<void>;
 /**
  * Reads a value from memory scoped to the current signal.
@@ -18458,9 +18459,9 @@ interface IMemoryInstance {
      * Write a value to memory.
      * @param memoryId - Unique entry identifier
      * @param value - Value to store
-     * @param index - Optional BM25 index string; defaults to JSON.stringify(value)
+     * @param description - Optional BM25 index string; defaults to JSON.stringify(value)
      */
-    writeMemory<T extends object = object>(memoryId: string, value: T, index?: string): Promise<void>;
+    writeMemory<T extends object = object>(memoryId: string, value: T, description: string): Promise<void>;
     /**
      * Search memory using BM25 full-text scoring.
      * @param query - Search query string
@@ -18541,14 +18542,14 @@ declare class MemoryAdapter implements TMemoryInstance {
      * @param dto.value - Value to store
      * @param dto.signalId - Signal identifier
      * @param dto.bucketName - Bucket name
-     * @param dto.index - Optional BM25 index string; defaults to JSON.stringify(value)
+     * @param dto.description - Optional BM25 index string; defaults to JSON.stringify(value)
      */
     writeMemory: <T extends object = object>(dto: {
         memoryId: string;
         value: T;
         signalId: string;
         bucketName: string;
-        index?: string;
+        description: string;
     }) => Promise<void>;
     /**
      * Search memory using BM25 full-text scoring.
@@ -21069,6 +21070,21 @@ interface IBroker {
     /** Called when a DCA (average-buy) entry is committed. */
     onAverageBuyCommit(payload: BrokerAverageBuyPayload): Promise<void>;
 }
+/**
+ * Constructor type for a broker adapter class.
+ *
+ * Used by `BrokerAdapter.useBrokerAdapter` to accept a class (not an instance).
+ * All `IBroker` methods are optional — implement only what the adapter needs.
+ *
+ * @example
+ * ```typescript
+ * class MyBroker implements Partial<IBroker> {
+ *   async onSignalOpenCommit(payload: BrokerSignalOpenPayload) { ... }
+ * }
+ *
+ * Broker.useBrokerAdapter(MyBroker); // MyBroker satisfies TBrokerCtor
+ * ```
+ */
 type TBrokerCtor = new () => Partial<IBroker>;
 /**
  * Facade for broker integration — intercepts all commit* operations before DI-core mutations.
@@ -23650,7 +23666,7 @@ declare class StrategyConnectionService implements TStrategy$1 {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }, candles: ICandleData[]) => Promise<IStrategyTickResultClosed | IStrategyTickResultCancelled | IStrategyTickResultActive>;
+    }, candles: ICandleData[], frameEndTime: number) => Promise<IStrategyTickResultClosed | IStrategyTickResultCancelled | IStrategyTickResultActive>;
     /**
      * Stops the specified strategy from generating new signals.
      *
@@ -25046,7 +25062,7 @@ declare class StrategyCoreService implements TStrategy {
      * @param context - Execution context with strategyName, exchangeName, frameName
      * @returns Closed signal result with PNL
      */
-    backtest: (symbol: string, candles: ICandleData[], when: Date, backtest: boolean, context: {
+    backtest: (symbol: string, candles: ICandleData[], frameEndTime: number, when: Date, backtest: boolean, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;