/** One file to write: a bare filename (e.g. `sitemap.xml`, `sitemap-products.xml`) + its content. */ export interface SitemapFile { name: string; content: string; } /** Persisted generation metadata (cache sidecar, never web-served). */ export interface SitemapMeta { fingerprint: string; generatedAt: string; files: string[]; urlCount: number; } export interface SitemapStorage { writeFiles(files: SitemapFile[]): Promise; readFile(name: string): Promise; fileExists(name: string): Promise; readMeta(): Promise; writeMeta(meta: SitemapMeta): Promise; pruneOrphans(keep: string[]): Promise; } /** * Local-disk storage. Output files land flat in the project `public/` folder (served by * `publicStatic` at `/sitemap.xml`, `/sitemap-*.xml` — root-level per Google's directory-scope * rule, design §12/C4). Metadata lives in the non-web-served cache dir. Writes are atomic * (tmp + rename, pid-scoped tmp name so concurrent processes don't clash). Dirs injectable for tests. */ export declare function createLocalSitemapStorage(options?: { publicDir?: string; cacheDir?: string; }): SitemapStorage; /** Default local storage (project `public/` + `.evershop/sitemap/`). */ export declare const localSitemapStorage: SitemapStorage; /** * The active storage, resolved through the registry so an extension (e.g. S3) can redirect output * by registering a `sitemapStorage` processor. Defaults to local disk (design §9). */ export declare function getSitemapStorage(): SitemapStorage;