Utility class for managing dictionary persistence.
Features:
Storage layout: ./dump/dictionary/<signalId>/<dictionaryName>.json
Used by DictionaryPersistInstance for crash-safe dictionary persistence.
constructor();
PersistDictionaryInstanceCtor: any
Constructor used to create per-context dictionary instances. Replaceable via usePersistDictionaryAdapter() / useJson() / useDummy().
getDictionaryStorage: any
Memoized factory creating one IPersistDictionaryInstance per (signalId, dictionaryName) pair.
waitForInit: (signalId: string, dictionaryName: string, initial: boolean) => Promise<void>
Initializes the dictionary storage for the given context.
Skips initialization when initial is false (used to gate first-time setup).
readDictionaryData: (signalId: string, dictionaryName: string) => Promise<DictionaryData>
Reads persisted dictionary snapshot for the given context. Lazily initializes the instance on first access.
writeDictionaryData: (data: DictionaryData, signalId: string, dictionaryName: string, when: Date) => Promise<void>
Writes dictionary snapshot for the given context. Lazily initializes the instance on first access.
useDummy: () => void
Switches to PersistDictionaryDummyInstance (all operations are no-ops).
useJson: () => void
Switches to the default file-based PersistDictionaryInstance.
clear: () => void
Clears the memoized instance cache. Call when process.cwd() changes between strategy iterations.
dispose: (signalId: string, dictionaryName: string) => void
Drops the memoized instance for the given context. Call when a signal is removed to clean up its associated storage entry.
usePersistDictionaryAdapter(Ctor: TPersistDictionaryInstanceCtor): void;
Registers a custom IPersistDictionaryInstance constructor. Clears the memoization cache so subsequent calls use the new adapter.