@sanity/ailf 0.1.0

package/dist/adapters/doc-fetchers/sanity-doc-fetcher.d.ts

@@ -0,0 +1,76 @@
+/**
+ * SanityDocFetcher — full adapter for the DocFetcher port.
+ *
+ * Fetches documentation from the Sanity Content Lake with support for:
+ * - Basic slug-based fetching (GROQ → Portable Text → Markdown)
+ * - Perspective-aware fetching (content release diffing)
+ * - Document overlays (replace/append canonical docs by document ID)
+ * - Direct URL fetching (markdown endpoints + content negotiation)
+ * - Custom HTTP headers
+ * - Document manifest (traceability: _id, _rev, slug, title)
+ * - Release impact metadata (added/modified/removed/unchanged)
+ *
+ * The pipeline step (FetchDocsStep) calls ctx.docFetcher.fetch() and
+ * writes the returned metadata to disk for downstream consumption.
+ */
+import { type DocFetcher, type DocSourceConfig, type FetchResult, type TaskDefinition } from "../../_vendor/ailf-core/index.d.ts";
+export declare class SanityDocFetcher implements DocFetcher {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    fetch(tasks: TaskDefinition[], source?: DocSourceConfig): Promise<FetchResult>;
+    private fetchManifest;
+    /**
+     * Batch-resolve document ID refs to their article slugs.
+     *
+     * This bridges IdDocRef entries into the slug-based fetch pipeline.
+     * Articles are queried by _id and their slugs are returned for use
+     * in the existing slug-based content map.
+     */
+    private resolveIdRefsToSlugs;
+    /**
+     * Resolve path-based canonical doc references to their article slugs.
+     *
+     * Handles two path formats:
+     * - Simple path: "webhooks" → resolves as slug lookup
+     * - Section-qualified path: "content-lake/webhooks" → matches section + slug
+     *
+     * @see docs/design-docs/canonical-doc-resolution.md
+     */
+    private resolvePathRefsToSlugs;
+    /**
+     * Expand perspective canonical doc refs to the article slugs within
+     * each content release.
+     *
+     * Each perspective ref resolves to ALL article documents versioned in
+     * that release. This is the one-to-many expansion described in the
+     * canonical-doc-resolution design doc.
+     *
+     * The perspective value from the ref is used as both the release ID
+     * for the versioned document query AND the client perspective for
+     * fetching content. If a source-level perspective is also set, the
+     * ref-level perspective takes precedence for its own resolution.
+     *
+     * @see docs/design-docs/canonical-doc-resolution.md
+     */
+    private resolvePerspectiveRefsToSlugs;
+    private identifyAffectedDocs;
+    private resolveDocumentOverlay;
+    private fetchArticleById;
+    private fetchArticleBySlug;
+    private fetchArticleBySlugWithPerspective;
+    private fetchCanonicalDocs;
+    /**
+     * Generate feature-area context files (one per GROQ feature area query).
+     *
+     * This is NOT part of the DocFetcher port — it's an opt-in CLI feature
+     * used by `ailf fetch-docs --include-feature-areas`.
+     */
+    fetchFeatureAreaContexts(source?: DocSourceConfig): Promise<void>;
+    /**
+     * Generate a full corpus context file (all articles in one markdown file).
+     *
+     * This is NOT part of the DocFetcher port — it's an opt-in CLI feature
+     * used by `ailf fetch-docs --include-corpus`.
+     */
+    fetchFullCorpus(source?: DocSourceConfig): Promise<void>;
+}