/**
 * CrawlSource — the `url-inspection` + `link-graph` `SeoDataSource` adapter
 * over `CrawlEngine` (spec-20260717-seo-improver-builder, Sprint 7; ADR-6,
 * ADR-8).
 *
 * Wraps the Sprint-6 `DamcrawlerCrawlEngine` (which self-guards the
 * `site-crawl` egress axis, the optional-dependency load, the F2
 * engine-boundary SSRF check, and F1 title/url/body sanitization). This
 * adapter adds two things on top:
 *
 *   1. The GSC url-inspection LEDGER GATE (ADR-6): every crawl call books
 *      against the SAME `governor.admit({ source:"gsc",
 *      capability:"url-inspection", estRows:pageBudget })` ceiling the
 *      live GSC adapter uses (2,000 queries/day/property) — crawling is
 *      free (`estCostUsd:0`, ADR-9) but is NOT free of the daily-quantity
 *      ceiling, so a crawl that would exceed it abstains instead of
 *      over-crawling (sc-7-2). `admit()` gates BEFORE the engine is ever
 *      called; `record()` runs ONLY after the engine returns `data`.
 *   2. DEFENSE-IN-DEPTH row sanitization (sc-7-3): this adapter holds its
 *      OWN `ContentSanitizer` and cleans every free-text field it emits
 *      (url-inspection `url`; link-graph `fromUrl`/`toUrl`/`anchor`) even
 *      though the engine already sanitizes what it controls — an injected
 *      test double standing in for a future/alternate `CrawlEngine`
 *      implementation might not.
 *
 * Serves ONLY `url-inspection` and `link-graph` (sc-7-1); every other
 * capability is `{ kind: "disabled" }` unconditionally. Precedence between
 * this source and `GscAdapter` for `url-inspection` (when both `site-crawl`
 * and `search-console` are on) is the router's job (ADR-8, Sprint 9,
 * nonGoal here) — this class is not wired into `selectSource` this sprint.
 */
import type { SeoQuotaGovernor } from "../quota-governor.js";
import type { CrawlEngine } from "../crawl-engine.js";
import type { ContentSanitizer } from "../content-sanitizer.js";
import type { SeoDataSource, SeoCapability, SearchAnalyticsQuery, SearchAnalyticsRow, UrlInspectionQuery, UrlInspectionRow, SerpQuery, SerpRow, KeywordQuery, KeywordRow, BacklinkQuery, BacklinkRow, AiVisibilityQuery, AiVisibilityRow, LinkGraphQuery, LinkGraphRow } from "../data-source.js";
import type { DataOutcome } from "../types.js";
export declare class CrawlSource implements SeoDataSource {
    private readonly governor;
    private readonly engine;
    private readonly sanitizer;
    constructor(governor: SeoQuotaGovernor, engine: CrawlEngine, sanitizer: ContentSanitizer);
    capabilities(): SeoCapability[];
    /**
     * URL indexability via `CrawlEngine.urlVisibility` (damcrawler
     * `probeVisibility`). Ledger-gated (sc-7-2), then defense-in-depth
     * sanitized (sc-7-3) before it reaches the caller/analyzer.
     */
    urlInspection(q: UrlInspectionQuery): Promise<DataOutcome<UrlInspectionRow[]>>;
    /**
     * Internal link graph via `CrawlEngine.linkGraph`. Ledger-gated against
     * the SAME url-inspection ceiling (ADR-6 — the crawl consumes the same
     * ledger counter regardless of which capability it serves), then
     * defense-in-depth sanitized.
     */
    linkGraph(q: LinkGraphQuery): Promise<DataOutcome<LinkGraphRow[]>>;
    searchAnalytics(_q: SearchAnalyticsQuery): Promise<DataOutcome<SearchAnalyticsRow[]>>;
    serp(_q: SerpQuery): Promise<DataOutcome<SerpRow[]>>;
    keywords(_q: KeywordQuery): Promise<DataOutcome<KeywordRow[]>>;
    backlinks(_q: BacklinkQuery): Promise<DataOutcome<BacklinkRow[]>>;
    aiVisibility(_q: AiVisibilityQuery): Promise<DataOutcome<AiVisibilityRow[]>>;
}
//# sourceMappingURL=crawl-source.d.ts.map