import { TenantCtx } from "@gscdump/contracts";
export declare function inspectionIndexKey(ctx: TenantCtx): string;
export declare function emptyTypesKey(ctx: TenantCtx): string;
export declare function inspectionParquetKey(ctx: TenantCtx): string;
export declare function inspectionEventsPrefix(ctx: TenantCtx): string;
export declare function inspectionEventKey(ctx: TenantCtx, yearMonth: string, batchId: string): string;
export declare function inspectionBaseKey(ctx: TenantCtx): string;
/**
 * Append-only record of URL-inspection STATE CHANGES, partitioned by month.
 *
 * Distinct from `events/`, which compaction deletes. Google exposes no API for
 * historical index-coverage state, so a verdict change observed once is gone
 * the moment the event file folds — this is the only durable record that a URL
 * ever left (or entered) the index.
 */
export declare function inspectionTransitionsPrefix(ctx: TenantCtx): string;
/** One file per calendar month (`YYYY-MM`), rewritten in place as it fills. */
export declare function inspectionTransitionsMonthKey(ctx: TenantCtx, yearMonth: string): string;
export declare function inspectionHistoryPrefix(ctx: TenantCtx, yearMonth: string): string;
export declare function inspectionHistoryShardKey(ctx: TenantCtx, yearMonth: string, batchId: string): string;
/** Stable, URL-safe FNV-1a hash used for entity keys. */
export declare function hashUrl(url: string): string;
export declare function sitemapUrlsPrefix(ctx: TenantCtx): string;
export interface SitemapGenerationKey {
  id: string;
  observedAt: number;
}
export declare function sitemapUrlsEventsPrefix(ctx: TenantCtx): string;
export declare function sitemapUrlsEventKey(ctx: TenantCtx, feedpathHash: string, generation: SitemapGenerationKey): string;
export declare function sitemapSiteManifestKey(ctx: TenantCtx): string;
export declare function sitemapSiteManifestsPrefix(ctx: TenantCtx): string;
export declare function sitemapSiteGenerationManifestKey(ctx: TenantCtx, generation: SitemapGenerationKey): string;
export declare function sitemapStagedGenerationPrefix(ctx: TenantCtx, generation: SitemapGenerationKey): string;
export declare function sitemapStagedFeedKey(ctx: TenantCtx, generation: SitemapGenerationKey, feedpathHash: string): string;
export declare function sitemapImmutableBaseKey(ctx: TenantCtx, generation: SitemapGenerationKey, feedpathHash: string): string;
export declare function sitemapLegacyImportKey(ctx: TenantCtx): string;
/** WHATWG-serialized HTTP(S) feed identity with the fragment removed. */
export type SitemapFeedIdentityResult = {
  _tag: 'ok';
  url: string;
} | {
  _tag: 'invalid';
  reason: 'credentials' | 'empty' | 'invalid_url' | 'unsupported_protocol';
};
export declare function parseSitemapFeedIdentity(input: string): SitemapFeedIdentityResult;
/** Versioned exact payload hash. Lastmod-only changes are intentionally visible. */
export declare function sitemapPayloadHashV1(urls: readonly {
  loc: string;
  lastmod?: string;
}[]): string;
export declare function indexingMetadataIndexKey(ctx: TenantCtx): string;
export declare function queryDimParquetKey(ctx: TenantCtx): string;
export declare function queryDimMetaKey(ctx: TenantCtx): string;