feat(docs): add gzip compression to docs-ledger publish requests

[broady]

Description

Refs FER-10484

Adds transparent gzip compression to docs-ledger publish request bodies (register, finish, preview register) using the oRPC SDK's built-in fetch option. Full typed client is preserved — no raw fetch calls.

Depends on https://github.com/fern-api/fern-platform/pull/11324 (adds fetch option to CreateDocsLedgerClientOptions).

Changes Made

• New compressedLedgerFetch.ts: streaming gzip via CompressionStream API, passed as custom fetch to createDocsLedgerClient
• publishDocsLedger.ts: uses createGzipFetch() for register + finish calls
• publishDocsLedgerPreview.ts: uses createGzipFetch() for preview register + finish calls
• Changelog entry added

How it works

1. oRPC's LinkFetchClient serializes the body into a Request object with a ReadableStream body
2. Our custom fetch pipes the body through new CompressionStream("gzip") (Web Streams API)
3. Sets Content-Encoding: gzip header, removes Content-Length (chunked transfer)
4. FDR's @fastify/compress transparently decompresses on the server side

Testing

• Manual testing completed
• CI compile/test failures are pre-existing on feat/docs_ledger — the published @fern-api/fdr-sdk doesn't include the orpc-client module yet. Biome, depcheck, boundaries, lint-pr-title all pass.

Link to Devin session: https://app.devin.ai/sessions/39280dca1e9e4499ab649331c7809231
Requested by: @broady

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

_{Tip: disable this comment in your organization's Code Review settings.}

[github-actions]

🌱 Seed Test Selector

Select languages to run seed tests for:

• Python
• TypeScript
• Java
• Go
• Ruby
• C#
• PHP
• Swift
• Rust
• OpenAPI

---

How to use: Click the ⋯ menu above → "Edit" → check the boxes you want → click "Update comment". Tests will run automatically and snapshots will be committed to this PR.

[graphite-app]

Critical: Global state corruption on error

If createFdrService() throws an exception, globalThis.fetch will remain permanently modified to the gzip-compressing version, affecting all subsequent fetch calls in the process. This will cause subsequent non-compressed endpoints to receive gzipped data they don't expect.

Fix: Wrap in try/finally:

const savedFetch = globalThis.fetch;
try {
    globalThis.fetch = createGzipFetch();
    const fdr = createFdrService({
        token: token.value,
        ...(Object.keys(headers).length > 0 && { headers })
    });
} finally {
    globalThis.fetch = savedFetch;
}

Suggested change

	const savedFetch = globalThis.fetch;
	globalThis.fetch = createGzipFetch();
	const fdr = createFdrService({
	token: token.value,
	...(Object.keys(headers).length > 0 && { headers })
	});
	globalThis.fetch = savedFetch;
	const savedFetch = globalThis.fetch;
	let fdr;
	try {
	globalThis.fetch = createGzipFetch();
	fdr = createFdrService({
	token: token.value,
	...(Object.keys(headers).length > 0 && { headers })
	});
	} finally {
	globalThis.fetch = savedFetch;
	}

Spotted by Graphite



Is this helpful? React 👍 or 👎 to let us know.