mirror of
https://github.com/bookorbit/bookorbit.git
synced 2026-11-03 08:21:39 -06:00
neon
b0f0e36d30
Probe equally ranked comic runs within the existing search budget to prevent reprints from hiding original issues. Require an unambiguous result for automatic matching while preserving manual selection and saved-ID refreshes. Add regression coverage for the reported Generation X match, padded issue numbers, competing runs, provider failures, deadlines, and cache isolation. Fixes #1238
35 lines
1.6 KiB
TypeScript
35 lines
1.6 KiB
TypeScript
import { canonicalJson } from '../../../common/provider-cache/canonicalize';
|
|
import type { ProviderCacheContext } from '../../../common/provider-cache/provider-cache-spec';
|
|
import { MetadataSearchParams } from './metadata-search-params';
|
|
import { allowsAudiobookProviders } from './provider-utils';
|
|
|
|
/**
|
|
* Shared pieces of each provider's cache declaration. Keep key inputs conservative: every value the
|
|
* provider reads must be here, because a missing one lets one request's answer serve another.
|
|
*/
|
|
|
|
export function providerCacheContext(available: boolean, fingerprint: Record<string, unknown> = {}): ProviderCacheContext {
|
|
return { available, fingerprint: canonicalJson(fingerprint) };
|
|
}
|
|
|
|
type SearchField =
|
|
'title' | 'author' | 'isbn' | 'seriesName' | 'seriesIndex' | 'titleIsExplicitQuery' | 'hardcoverEditionId' | 'requireUnambiguousMatch';
|
|
|
|
export function pickSearchInputs(params: MetadataSearchParams, fields: readonly SearchField[]): Record<string, unknown> {
|
|
const inputs: Record<string, unknown> = {};
|
|
for (const field of fields) inputs[field] = params[field];
|
|
return inputs;
|
|
}
|
|
|
|
/** Audiobook-only providers answer nothing unless asked for audiobooks, so the gate is part of the key. */
|
|
export function audiobookGate(params: MetadataSearchParams): boolean {
|
|
return allowsAudiobookProviders(params);
|
|
}
|
|
|
|
/** Absent means the provider's own default (its largest), matching how providers read the cap. */
|
|
export function requestedMax(params: MetadataSearchParams): number | null {
|
|
const value = params.maxCandidatesPerProvider;
|
|
if (value === undefined || !Number.isFinite(value)) return null;
|
|
return Math.max(1, Math.floor(value));
|
|
}
|