Class TitleNormalizationCacheWarmer

Service for warming title normalization caches off-thread. Maintains canonical caches on the main thread and applies worker deltas.

Index

Constructors

Methods

warmupCachesInBackground cancel getNormalizedTitle getNormalizedTitlesForAlgorithm preloadTitles

Constructors

constructor

new TitleNormalizationCacheWarmer(): TitleNormalizationCacheWarmer
Returns TitleNormalizationCacheWarmer

Methods

warmupCachesInBackground

warmupCachesInBackground(
    titles: string[],
    algorithms?: WorkerNormalizationAlgorithm[],
    progressCallback?: NormalizationProgressCallback,
): Promise<string>
Start background cache warmup for title normalization. Schedules warmup to run when idle for better UX.
Parameters
- titles: string[]
  List of titles to normalize
- algorithms: WorkerNormalizationAlgorithm[] = ...
  Algorithms to apply
- OptionalprogressCallback: NormalizationProgressCallback
  Optional progress callback for UI updates
Returns Promise<string>
Task ID for tracking/cancellation
- Defined in src/api/matching/normalization/cache-warmer.ts:44

cancel

cancel(): void
Cancel the current cache warmup operation.

Returns void
- Defined in src/api/matching/normalization/cache-warmer.ts:189

getNormalizedTitle

getNormalizedTitle(
    title: string,
    algorithm: CacheNormalizationKey,
    normalizer: (title: string) => string,
): string
Get normalized title from cache. Falls back to main-thread normalization if not cached.
Parameters
- title: string
  Title to lookup
- algorithm: CacheNormalizationKey
  Normalization algorithm to use
- normalizer: (title: string) => string
  Fallback normalizer function
Returns string
Normalized title
- Defined in src/api/matching/normalization/cache-warmer.ts:208

getNormalizedTitlesForAlgorithm

getNormalizedTitlesForAlgorithm(
algorithm: CacheNormalizationKey,
): null | Record<string, string>
Get all normalized titles for an algorithm.
Parameters
- algorithm: CacheNormalizationKey
  Algorithm to retrieve
Returns null | Record<string, string>
Map of original to normalized titles
- Defined in src/api/matching/normalization/cache-warmer.ts:234

preloadTitles

preloadTitles(
    titles: string[],
    algorithm: CacheNormalizationKey,
    normalizer: (title: string) => string,
): void
Preload a batch of titles into the cache synchronously. Stores directly to cache without worker processing.
Parameters
- titles: string[]
  Titles to preload
- algorithm: CacheNormalizationKey
  Algorithm to use for preload
- normalizer: (title: string) => string
  Normalizer function
Returns void
- Defined in src/api/matching/normalization/cache-warmer.ts:256