PersistRecentUtils

Utility class for managing recent signal persistence.

Features:

• Memoized storage instances per (symbol, strategyName, exchangeName, frameName) context
• Custom adapter support
• Atomic read/write operations
• Crash-safe recent signal state management

Used by RecentPersistBacktestUtils/RecentPersistLiveUtils for recent signal persistence.

Constructor

constructor();
Copy

Properties

PersistRecentInstanceCtor

PersistRecentInstanceCtor: any
Copy

Constructor used to create per-context recent signal instances. Replaceable via usePersistRecentAdapter() / useJson() / useDummy().

createKey

createKey: any
Copy

Builds the composite memoization key for a recent signal context. Includes optional frameName and the backtest/live mode flag.

getStorage

getStorage: any
Copy

Memoized factory creating one IPersistRecentInstance per context tuple.

readRecentData

readRecentData: (symbol: string, strategyName: string, exchangeName: string, frameName: string, backtest: boolean) => Promise<IPublicSignalRow>
Copy

Reads the latest recent signal for the given context. Lazily initializes the instance on first access.

writeRecentData

writeRecentData: (signalRow: IPublicSignalRow, symbol: string, strategyName: string, exchangeName: string, frameName: string, backtest: boolean, when: Date) => Promise<void>
Copy

Writes the latest recent signal for the given context. Lazily initializes the instance on first access.

Methods

usePersistRecentAdapter

usePersistRecentAdapter(Ctor: TPersistRecentInstanceCtor): void;
Copy

Registers a custom IPersistRecentInstance constructor. Clears the memoization cache so subsequent calls use the new adapter.

clear

clear(): void;
Copy

Clears the memoized instance cache. Call when process.cwd() changes between strategy iterations.

useJson

useJson(): void;
Copy

Switches to the default file-based PersistRecentInstance.

useDummy

useDummy(): void;
Copy

Switches to PersistRecentDummyInstance (all operations are no-ops).