@fern-api/fdr-sdk 1.2.165-800b1938f3 → 1.2.166-e8ae898b4d

package/dist/types/docs-ledger/buildLedgerManifest.d.ts

@@ -0,0 +1,80 @@
+import type { LedgerManifest, LedgerSiblingSite } from "../orpc-client/index.js";
+import type { TransformResult } from "./docsPublishTransform.js";
+import type { ArtifactInput, InlineTranslationParams, PublishParams } from "./inputTypes.js";
+export interface BuildLedgerManifestArgs {
+    /** Base-locale entities + deployment/site identity (canonical fern URL). */
+    params: PublishParams;
+    /** Base-locale transform result (carries config + file dimensions). */
+    baseResult: TransformResult;
+    /** Additional-locale entities, persisted in the same deployment. */
+    inlineTranslations: InlineTranslationParams[];
+    /**
+     * pageId → bare `fullPath`s of the files each page embeds, merged across all
+     * locales (ADR 0016, "File metadata on the render path"). Used to pack each
+     * route shard's `files` identity map and to prune the relocated files from
+     * the pointer's global `files` map. Empty ⇒ no shard-side files; the pointer
+     * keeps every file (graceful when the publishing CLI predates the field).
+     */
+    referencedFilesByPageId: Record<string, string[]>;
+    deploymentId: string;
+    siteId: string;
+    deploymentHash: string;
+    orgId: string;
+    /** Canonical fern domain (the per-URL manifest is written once per URL by the caller). */
+    domain: string;
+    /**
+     * Domain used for file anchoring (S3 keys + manifest `files[].domain`).
+     * When set, overrides `params.site.domain` so preview publishes anchor
+     * files on the canonical production domain (ADR 0010).
+     */
+    fileDomain?: string;
+    basepath: string;
+    isPreview: boolean;
+    isPrivate: boolean;
+    /** FAI Ask AI enablement for this URL; omitted when it could not be resolved. */
+    askAiEnabled?: boolean;
+    /** Live sites on this host; only for basepath-aware production publishes. */
+    siblingSites?: LedgerSiblingSite[];
+    /** ISO-8601 — request time the publish became live. */
+    assignedAt: string;
+    assignedBy: string | null;
+    /** artifact hash → ISO-8601 `created_at` from `docs_ledger_artifacts`. */
+    artifactHashToCreatedAt?: Map<string, string>;
+}
+export interface LedgerReadModelBlob {
+    hash: string;
+    bytes: Buffer;
+    contentType: string;
+}
+export interface BuildLedgerReadModelResult {
+    pointer: LedgerManifest;
+    blobs: LedgerReadModelBlob[];
+}
+/**
+ * Overlay CAS content `created_at` onto the artifact-keyed `createdAt` map
+ * used for manifest route entries (sitemap `<lastmod>`). Artifact hashes are
+ * salted with `FDR_VERSION`, so their rows are re-minted on the first publish
+ * after every FDR deploy; the unsalted content row survives deploys and
+ * reflects when the page bytes first appeared. Content-less artifacts (links,
+ * files) keep the artifact row's timestamp.
+ */
+export declare function overlayContentCreatedAt({ artifacts, artifactHashToCreatedAt, contentHashToCreatedAt }: {
+    artifacts: ReadonlyArray<Pick<ArtifactInput, "hash" | "contentHash">>;
+    artifactHashToCreatedAt: ReadonlyMap<string, string>;
+    contentHashToCreatedAt: ReadonlyMap<string, string>;
+}): Map<string, string>;
+/**
+ * Assemble the pointer + immutable CAS read model (ADR 0016) from the
+ * in-memory transform result the DAO just persisted. No DB read-back: every
+ * field comes from `params` / `baseResult` / `inlineTranslations`, and segment /
+ * artifact ids are content hashes (the S3-only reader never correlates against
+ * postgres).
+ *
+ * Leaf content (page markdown, API definitions) is referenced by CAS hash only
+ * — the bundle fetches those blobs directly. Hot-path chrome text
+ * (header/footer/css.inline/js.inline) is re-inlined into the pointer so page
+ * renders do not pay extra CAS reads for site chrome.
+ */
+export declare function buildLedgerReadModel(args: BuildLedgerManifestArgs): BuildLedgerReadModelResult;
+export declare function buildLedgerManifest(args: BuildLedgerManifestArgs): LedgerManifest;
+//# sourceMappingURL=buildLedgerManifest.d.ts.map

package/dist/types/docs-ledger/buildLedgerManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildLedgerManifest.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/buildLedgerManifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAMR,cAAc,EAKd,iBAAiB,EAUpB,MAAM,yBAAyB,CAAC;AAWjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EACR,aAAa,EACb,uBAAuB,EACvB,aAAa,EAGhB,MAAM,iBAAiB,CAAC;AA8JzB,MAAM,WAAW,uBAAuB;IACpC,4EAA4E;IAC5E,MAAM,EAAE,aAAa,CAAC;IACtB,uEAAuE;IACvE,UAAU,EAAE,eAAe,CAAC;IAC5B,oEAAoE;IACpE,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C;;;;;;OAMG;IACH,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0EAA0E;IAC1E,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,SAAS,EACT,uBAAuB,EACvB,sBAAsB,EACzB,EAAE;IACC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IACtE,uBAAuB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,uBAAuB,GAAG,0BAA0B,CA2uB9F;AA0CD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,cAAc,CAEjF"}

package/dist/types/docs-ledger/docsLedgerHash.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Deterministic hash computation for docs-ledger entities.
+ *
+ * Server-internal — these functions are NOT shared with the client.
+ * The server is the sole authority for structural hash computation.
+ *
+ * All hashes use SHA-256 over {@link stableStringify}, which produces
+ * deterministic JSON by sorting object keys during serialization.
+ * `JSON.stringify`'s replacer runs after `toJSON()`, so Dates and custom
+ * serializers are handled by the engine — no special cases needed.
+ */
+import type { DocsPublishInput, LedgerSegmentDetailMetadata, LedgerSegmentMetadata } from "../orpc-client/index.js";
+export { stableStringify } from "./stableHash.js";
+/**
+ * The FDR release version, injected as an env var by the CDK deploy stack.
+ * Included in deployment, segment, and artifact hashes so that every FDR
+ * deploy invalidates cached structural rows — even when the publish input
+ * is byte-identical.
+ *
+ * Falls back to "local" for local development (where no env var is set),
+ * ensuring hashes are still deterministic within a single server instance.
+ */
+export declare const FDR_VERSION: string;
+/**
+ * Compute the deployment hash directly from the publish input.
+ *
+ * Since the server-side transform is deterministic, identical inputs always
+ * produce identical deployments. This lets us:
+ * - Return a real deployment hash from register (before the transform runs)
+ * - Short-circuit finish when the deployment hash matches the current one
+ *
+ * The hash covers everything that affects the deployment's content:
+ * nav tree, page content hashes, API manifest hash, global blob hashes, locale,
+ * and the {@link FDR_VERSION} salt.
+ */
+export declare function hashDeploymentInput(input: DocsPublishInput): string;
+export interface SegmentDetailHashInput {
+    type: string;
+    displayName: string;
+    icon?: string | null;
+    sortOrder: number;
+    metadata: LedgerSegmentDetailMetadata;
+    hidden: boolean;
+    viewers: string[];
+    orphaned: boolean;
+    featureFlags: string[];
+}
+export declare function hashSegmentDetail(input: SegmentDetailHashInput): string;
+export interface ArtifactHashInput {
+    type: string;
+    hidden: boolean;
+    metadata: Record<string, unknown>;
+    /** CAS content hash. Null for content-less artifacts (links). */
+    contentHash: string | null;
+}
+export declare function hashArtifact(input: ArtifactHashInput): string;
+export interface SegmentHashInput {
+    locale: string;
+    productHash?: string;
+    versionHash?: string;
+    variantHash?: string;
+    tabHash?: string;
+    section: string;
+    metadata: LedgerSegmentMetadata;
+    hidden: boolean;
+    /** Artifact hashes included in this segment — sorted internally for determinism. */
+    artifactHashes: string[];
+    /** Sidebar ordering: artifact hash + display position. Sorted by displaySortOrder for determinism. */
+    displaySortOrder: Array<{
+        artifactHash: string;
+        displaySortOrder: number;
+    }>;
+    /** Route entries — sorted by fullPath internally for determinism. */
+    routes: Array<{
+        fullPath: string;
+        artifactHash: string;
+    }>;
+}
+export declare function hashSegment(input: SegmentHashInput): string;
+//# sourceMappingURL=docsLedgerHash.d.ts.map

package/dist/types/docs-ledger/docsLedgerHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsLedgerHash.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/docsLedgerHash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAIpH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAUlD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,MAA2C,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAOnE;AAuCD,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAavE;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE7D;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sGAAsG;IACtG,gBAAgB,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,qEAAqE;IACrE,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAyB3D"}

package/dist/types/docs-ledger/docsPublishTransform.d.ts

@@ -0,0 +1,178 @@
+import type { ApiDefinition } from "../api-definition/index.js";
+import type { BlobRef, LedgerConfig, LocaleEntry } from "../orpc-client/index.js";
+import type { ArtifactInput, DeploymentApiDefinitionInput, DeploymentSegmentInput, DocsSiteProduct, NavInput, SegmentDetailInput, SegmentInput } from "./inputTypes.js";
+/**
+ * Input type for `transformPublishInput`. A single locale's content fields
+ * plus the deployment-scoped `domain` (needed for file-artifact S3 key
+ * construction).
+ */
+export type TransformInput = LocaleEntry & {
+    domain: string;
+    /**
+     * Override for the file-anchoring domain (S3 keys). When set, files
+     * are keyed under this domain instead of `domain`, so preview
+     * publishes can anchor on the canonical fern domain (ADR 0010).
+     */
+    fileDomain?: string;
+};
+/**
+ * A fileManifest entry collected during the transform. Carries everything
+ * the register/finish handlers need to route uploads to the correct S3
+ * bucket and upsert `docs_ledger_file` rows. The asset domain is the
+ * canonical `DocsPublishInput.domain`; custom domains share that namespace.
+ * The bucket is determined by the handler (not the transform) from the
+ * site's auth config.
+ */
+export interface TransformFileEntry {
+    fullPath: string;
+    hash: string;
+    contentType: string;
+    contentLength: number;
+    filename: string;
+    width?: number;
+    height?: number;
+    blurDataURL?: string;
+}
+/**
+ * Parsed API manifest: full API definitions keyed by apiDefinitionId.
+ * The finish handler fetches the manifest blob from S3 and parses it.
+ */
+export type ApiManifest = Record<string, ApiDefinition>;
+/**
+ * A BlobRef whose bytes were generated server-side (pruned API content, link metadata).
+ * The router must upload these to CAS before persisting the deployment.
+ */
+export interface GeneratedBlob {
+    ref: BlobRef;
+    bytes: Buffer;
+}
+/**
+ * Transform result: hashed entities ready for the DAO, plus content
+ * references and server-generated blobs for CAS upload.
+ */
+export interface TransformResult {
+    segmentDetails: SegmentDetailInput[];
+    artifacts: ArtifactInput[];
+    segments: SegmentInput[];
+    nav: NavInput[];
+    deploymentSegments: DeploymentSegmentInput[];
+    apiDefinitions: DeploymentApiDefinitionInput[];
+    /** Visible top-level products in switcher order, snapshotted for sibling sites on the same host. */
+    siteProducts: DocsSiteProduct[];
+    jsFilesHash: string | undefined;
+    /**
+     * ADR 0009: structural config (everything except `header`, `footer`,
+     * `css.inline`, `js.inline`) ready to be written into
+     * `docs_ledger_deployments.config_json` as JSONB. The four extracted
+     * variable-length pieces are content-addressed via the `*Hash` fields
+     * below.
+     */
+    configJson: unknown | undefined;
+    /** CAS hash for the extracted `config.header` blob, or undefined. */
+    headerHash: string | undefined;
+    /** CAS hash for the extracted `config.footer` blob, or undefined. */
+    footerHash: string | undefined;
+    /**
+     * CAS hash for the extracted `config.css.inline` blob (joined with
+     * `\n`), or undefined.
+     */
+    cssInlineHash: string | undefined;
+    /**
+     * CAS hash for the extracted `config.js.inline` blob (joined with
+     * `\n`), or undefined.
+     */
+    jsInlineHash: string | undefined;
+    domain: string;
+    /**
+     * The domain files are anchored on (defaults to `domain` when omitted
+     * in the input). Forwarded so callers can key S3 operations and
+     * manifest entries on the canonical domain for preview publishes.
+     */
+    fileDomain: string;
+    version?: string | null;
+    repo?: string | null;
+    /**
+     * Git provenance pulled straight off the publish input (ADR 0012 /
+     * FER-10489). Forwarded to {@link DeploymentInput} so the deployment
+     * row captures the repo/branch/sha used by the read path to
+     * synthesise `editThisPageUrl`.
+     */
+    git?: {
+        repoUrl: string;
+        branch: string;
+        commitSha?: string;
+    };
+    /** All content blobs referenced by this deployment (artifact content, globals, generated). */
+    contentRefs: Map<string, BlobRef>;
+    /** Blobs generated by the transform (pruned API defs). Must be uploaded to CAS. */
+    generatedBlobs: Map<string, GeneratedBlob>;
+    /**
+     * File manifest entries (images, fonts, pdfs). Tracked separately from
+     * `contentRefs` because file bytes land in the public/private docs bucket
+     * (key `{assetDomain}/{hash}/{fullPath}`), not in CAS. The register handler
+     * routes their uploads accordingly; the finish handler upserts a
+     * `docs_ledger_file` row per entry and resolves the resulting IDs onto
+     * file/image artifacts.
+     */
+    fileEntries: TransformFileEntry[];
+    /**
+     * pageId → bare `fullPath`s of the files that page's markdown embeds (ADR
+     * 0014, "File metadata on the render path"). Copied straight off the publish
+     * input's `pages[pageId].referencedFiles` (captured CLI-side). Lets the read
+     * model materialise the page→file join into each route shard. Empty for
+     * pages with no embedded files or from CLIs that predate the field.
+     */
+    referencedFilesByPageId: Record<string, string[]>;
+}
+/**
+ * Transform a single locale's content into hash-addressed entities ready for persistence.
+ *
+ * @param input - One locale entry (content fields) plus the deployment's `domain`.
+ * @param apiManifest - Parsed API definitions (fetched from CAS by the caller).
+ *   Pass an empty object if there are no API references in the nav tree.
+ */
+export declare function transformPublishInput(input: TransformInput, apiManifest?: ApiManifest): TransformResult;
+/**
+ * Result of {@link splitConfig}: the structural `stripped` config (written
+ * inline as JSONB on the deployment row) plus the four extracted CAS blobs.
+ */
+export interface SplitConfigResult {
+    /**
+     * `config` with `header`, `footer`, `css.inline`, `js.inline` removed.
+     * `css` / `js` are dropped entirely if `inline` was their only key.
+     */
+    stripped: Omit<LedgerConfig, "header" | "footer" | "css" | "js"> & {
+        css?: Omit<NonNullable<LedgerConfig["css"]>, "inline">;
+        js?: Omit<NonNullable<LedgerConfig["js"]>, "inline">;
+    };
+    header: string | undefined;
+    footer: string | undefined;
+    cssInline: string | undefined;
+    jsInline: string | undefined;
+}
+/**
+ * Split a {@link LedgerConfig} into the structural portion (to be written
+ * inline as JSONB) and the four variable-length fields that are extracted
+ * to their own CAS blobs (ADR 0009).
+ *
+ * - `header`, `footer`: returned as the raw strings if non-empty.
+ * - `css.inline`, `js.inline`: arrays of strings, joined with `\n` into a
+ *   single text blob if non-empty. The `inline` key is removed from `css`
+ *   and `js` in the stripped config; any other sibling fields (`js.files`,
+ *   `js.remote`) are preserved. `css.inline` is currently the only field
+ *   on `css`, so `stripped.css` is dropped in practice — the empty-keys
+ *   check is kept for symmetry with `js` and to stay correct if the
+ *   schema grows new `css` siblings.
+ *
+ * The returned `stripped` object is a shallow-cloned subset of `config` so
+ * that callers can safely mutate it without affecting the original.
+ *
+ * The input has already been validated against `LedgerConfigSchema` by
+ * Zod upstream — no runtime shape checks are needed here.
+ *
+ * Exported for testing.
+ *
+ * @internal
+ */
+export declare function splitConfig(config: LedgerConfig): SplitConfigResult;
+//# sourceMappingURL=docsPublishTransform.d.ts.map

package/dist/types/docs-ledger/docsPublishTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsPublishTransform.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/docsPublishTransform.ts"],"names":[],"mappings":"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"}

package/dist/types/docs-ledger/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ledger publish transform — the pure (no DB, no S3) half of a docs publish.
+ *
+ * `transformPublishInput` turns a `DocsPublishInput` locale into hashed
+ * content-addressed entities, and `buildLedgerReadModel` assembles the pointer
+ * manifest + route shards the Astro renderer reads. FDR runs these on publish;
+ * the Fern CLI runs the same code to render a local project without a server.
+ */
+export * from "./buildLedgerManifest.js";
+export * from "./docsLedgerHash.js";
+export * from "./docsPublishTransform.js";
+export * from "./inputTypes.js";
+export { sha256Hex, stableHash } from "./stableHash.js";
+export * from "./toBasepathRelative.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/docs-ledger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc,yBAAyB,CAAC"}

package/dist/types/docs-ledger/inputTypes.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Content-addressed input entities produced by the ledger publish transform
+ * (`transformPublishInput`) and consumed by both FDR's `DocsLedgerDao` and the
+ * read-model builder (`buildLedgerReadModel`). Pure data types — no DB or
+ * runtime coupling — so the CLI can run the same transform for local preview.
+ */
+import type { LedgerArtifactTypeMetadata, LedgerSegmentDetailMetadata, LedgerSegmentMetadata } from "../orpc-client/index.js";
+/** Content-addressed segment detail (product/version/tab/variant metadata). */
+export interface SegmentDetailInput {
+    hash: string;
+    type: string;
+    displayName: string;
+    icon?: string | null;
+    sortOrder: number;
+    metadata: LedgerSegmentDetailMetadata;
+    hidden: boolean;
+    viewers: string[];
+    orphaned: boolean;
+    featureFlags: string[];
+}
+/** Content-addressed artifact (page/endpoint/link/redirect/file/image). */
+export type ArtifactInput = LedgerArtifactTypeMetadata & {
+    hash: string;
+    hidden: boolean;
+    /**
+     * CAS content hash. Set for pages, API defs, redirects, jsFiles, etc.
+     * Null for link artifacts and for file/image artifacts (those resolve via
+     * `fileKey` instead — see {@link FileEntryInput} and the `docs_ledger_file`
+     * table). The DAO resolves this to `content_id`.
+     */
+    contentHash: string | null;
+    /**
+     * File identity for file/image artifacts. Set on type=`file`/`image`,
+     * null otherwise. The DAO resolves this to `docs_ledger_file_id` via
+     * (assetDomain, hash, fullPath) — the asset domain is the canonical site
+     * domain passed to {@link DocsLedgerDao.persistDeployment}, while
+     * additional custom-domain site rows share the same uploaded file rows.
+     *
+     * Mutually exclusive with `contentHash` for content-bearing artifacts.
+     */
+    fileKey: {
+        hash: string;
+        fullPath: string;
+    } | null;
+};
+/**
+ * A file (image/font/etc.) tracked in `docs_ledger_file`.
+ *
+ * The publish handler determines `bucket` from the site's auth model
+ * before calling {@link DocsLedgerDao.persistDeployment} — the DAO upserts
+ * one row per unique `(domain, hash, full_path)` and resolves the resulting
+ * IDs onto file/image artifacts. Custom domains do not get duplicate file
+ * rows; they resolve to the canonical site's uploaded asset namespace.
+ */
+export interface FileEntryInput {
+    fullPath: string;
+    hash: string;
+    contentType: string;
+    /** Which S3 bucket the bytes were uploaded to. */
+    bucket: "public_docs" | "private_docs";
+}
+/**
+ * Content-addressed segment.
+ * References segment details by hash (resolved to database IDs during publish).
+ */
+export interface SegmentInput {
+    hash: string;
+    locale: string;
+    productHash?: string;
+    versionHash?: string;
+    variantHash?: string;
+    tabHash?: string;
+    section: string;
+    metadata: LedgerSegmentMetadata;
+    hidden: boolean;
+}
+/**
+ * Unified nav entry: routing + sidebar ordering in one row.
+ * - fullPath non-null = routable (path lookup)
+ * - displaySortOrder non-null = shows in sidebar
+ * - Both non-null = canonical route (routable + in sidebar)
+ * - fullPath null = sidebar-only (external links, folders)
+ * - displaySortOrder null = route-only (non-canonical aliases)
+ */
+export interface NavInput {
+    segmentHash: string;
+    artifactHash: string;
+    fullPath?: string;
+    displaySortOrder?: number;
+}
+/** Immutable deployment snapshot. */
+export interface DeploymentInput {
+    id: string;
+    hash: string;
+    version?: string;
+    repo?: string;
+    jsFilesHash?: string;
+    /**
+     * Structural config (stripped of `header`, `footer`, `css.inline`,
+     * `js.inline`) to be written inline into `config_json`. The four
+     * extracted variable-length pieces are content-addressed below.
+     */
+    configJson?: unknown;
+    /** CAS hash for the extracted `config.header` blob. */
+    headerHash?: string;
+    /** CAS hash for the extracted `config.footer` blob. */
+    footerHash?: string;
+    /** CAS hash for the extracted joined `config.css.inline` blob. */
+    cssInlineHash?: string;
+    /** CAS hash for the extracted joined `config.js.inline` blob. */
+    jsInlineHash?: string;
+    createdBy?: string;
+    /**
+     * Git provenance (ADR 0012 / FER-10489). Captured from the CLI publish
+     * input so the read path can synthesise `editThisPageUrl`. All optional —
+     * CLIs that omit `git` map to NULL columns.
+     */
+    gitRepoUrl?: string;
+    gitBranch?: string;
+    gitCommitSha?: string;
+    /** Default locale for this deployment (extracted from config_json.translations). */
+    defaultLocale?: string;
+    /** All locales supported by this deployment (including the default). */
+    translations?: string[];
+    /** FDR server version that produced this deployment (for cache-busting diagnostics). */
+    fdrVersion?: string;
+    /** Fern CLI version that produced this deployment (from X-CLI-Version header). */
+    cliVersion?: string;
+}
+/** Deployment → segment join entry (referenced by segment hash). */
+export interface DeploymentSegmentInput {
+    segmentHash: string;
+    sortOrder: number;
+}
+/** Deployment → API definition join entry. */
+export interface DeploymentApiDefinitionInput {
+    apiDefinitionId: string;
+    apiName: string | null;
+    contentHash: string;
+}
+/** New site row in the append-only site log. */
+export interface SiteInput {
+    id: string;
+    orgId: string;
+    domain: string;
+    basepath: string;
+    previewId?: string;
+    assignedBy?: string;
+}
+/** Parameters for adding translation segments to an existing deployment. */
+export interface TranslationSegmentParams {
+    deploymentId: string;
+    /** Owning org — CAS content/artifacts/segments are org-scoped (ADR 0008). */
+    orgId: string;
+    domain: string;
+    segmentDetails: SegmentDetailInput[];
+    artifacts: ArtifactInput[];
+    segments: SegmentInput[];
+    nav: NavInput[];
+    deploymentSegments: DeploymentSegmentInput[];
+    files: FileEntryInput[];
+}
+/**
+ * Translation segment params without `deploymentId` — the ID is determined
+ * inside the `persistDeployment` transaction and injected automatically.
+ */
+export type InlineTranslationParams = Omit<TranslationSegmentParams, "deploymentId"> & {
+    locale: string;
+    /** Locale's structural config (translation overlay applied). Read-model only; not persisted to postgres. */
+    configJson?: unknown;
+};
+/** A product of a published site as stored in `docs_sites.products` (JSON). */
+export type DocsSiteProduct = {
+    title: string;
+    /** Absolute href on the host (`/{basepath}/{slug}/`) or an external URL for product links. */
+    href: string;
+    subtitle?: string;
+};
+/** Everything needed to atomically publish a deployment. */
+export interface PublishParams {
+    segmentDetails: SegmentDetailInput[];
+    artifacts: ArtifactInput[];
+    segments: SegmentInput[];
+    nav: NavInput[];
+    deployment: DeploymentInput;
+    deploymentSegments: DeploymentSegmentInput[];
+    apiDefinitions: DeploymentApiDefinitionInput[];
+    /**
+     * Canonical (fern URL) site row. Always inserted into `docs_ledger_site`,
+     * and serves as the anchor for `docs_ledger_file` rows (file bytes live
+     * at `{site.domain}/{hash}/{fullPath}` regardless of how many extra
+     * domains the deployment is served from — see ADR 0010).
+     */
+    site: SiteInput;
+    /**
+     * Additional site rows for custom domains attached to the same
+     * deployment (ADR 0010). One row per (domain, basepath) pair, all
+     * pointing at the same `deployment_id`. No file rows fan out — the
+     * fern site (above) is the file-row anchor.
+     */
+    additionalSites?: SiteInput[];
+    /**
+     * Files referenced by file/image artifacts. The DAO upserts one
+     * `docs_ledger_file` row per `(domain, hash, full_path)` inside the
+     * publish transaction, then resolves each file/image artifact's
+     * `docs_ledger_file_id` from its `fileKey`.
+     *
+     * The domain is taken from `site.domain` (the canonical fern URL) —
+     * file rows are anchored on the fern domain even for multi-domain
+     * publishes, per ADR 0010.
+     */
+    files: FileEntryInput[];
+    /**
+     * Domain used for file anchoring (S3 keys + `docs_ledger_file` rows).
+     * When set, overrides `site.domain` for file operations so that
+     * preview publishes anchor files on the canonical fern domain
+     * (ADR 0010) instead of the ephemeral preview hostname.
+     */
+    fileDomain?: string;
+    /**
+     * Optional inline translations to persist atomically with the base
+     * deployment. When provided, translation segments are inserted inside
+     * the same DB transaction as the base deployment — fully atomic.
+     */
+    inlineTranslations?: InlineTranslationParams[];
+}
+/** Metadata stored on file/image artifacts. */
+export type FileArtifactMetadata = {
+    contentType: string;
+    contentLength?: number;
+    filename: string;
+    width?: number;
+    height?: number;
+    blurDataURL?: string;
+};
+//# sourceMappingURL=inputTypes.d.ts.map

package/dist/types/docs-ledger/inputTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputTypes.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/inputTypes.ts"],"names":[],"mappings":"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"}

package/dist/types/docs-ledger/stableHash.d.ts

@@ -0,0 +1,7 @@
+import { stableStringify } from "../orpc-client/index.js";
+export { stableStringify };
+/** SHA-256 hex digest of the input string. */
+export declare function sha256Hex(input: string): string;
+/** Convenience: stable JSON + sha256 in one call. */
+export declare function stableHash(value: unknown): string;
+//# sourceMappingURL=stableHash.d.ts.map

package/dist/types/docs-ledger/stableHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableHash.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/stableHash.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK1D,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/types/docs-ledger/toBasepathRelative.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Strip exactly one leading `${basePrefix}/` (or a bare `basePrefix`) from
+ * `fullPath`, yielding the basepath-RELATIVE remainder.
+ *
+ * Lives in its own leaf module because both `docsPublishTransform` and
+ * `buildLedgerManifest` need it but cannot share a value import with each
+ * other (`buildLedgerManifest` already imports `docsPublishTransform`'s
+ * types).
+ *
+ * Write side (`buildLedgerManifest`): every fullPath the transform produces
+ * is basepath-rooted, so stripping the first segment is unambiguous — even
+ * for the pathological `docs/docs` page (the second segment is the page's
+ * own slug). Only `navBySegment` keys are made relative; `routes`, `routing`,
+ * `versionFirstRoute`, and `pages` keys stay ABSOLUTE.
+ *
+ * Transform side (`docsPublishTransform`): normalises a reconstructed
+ * link-redirect parent slug before it is re-prefixed with the basepath. Most
+ * products yield a basepath-relative parent slug (`astro`), but the root/home
+ * product (`slug: /`) has an accumulated V1 slug that already equals the
+ * basepath (`docs`) — `extractSlugSegment` cannot strip it, so the product
+ * slug leaks the basepath. Normalising here makes the subsequent single
+ * prefix idempotent and prevents a `docs/docs/...` key.
+ */
+export declare function toBasepathRelative(fullPath: string, basePrefix: string): string;
+//# sourceMappingURL=toBasepathRelative.d.ts.map

package/dist/types/docs-ledger/toBasepathRelative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toBasepathRelative.d.ts","sourceRoot":"","sources":["../../../src/docs-ledger/toBasepathRelative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAS/E"}