Custom Domain SDK

Custom Domain SDK

A production-grade TypeScript SDK for managing custom domains using Cloudflare like Custom Hostnames. This SDK is framework-agnostic, database-agnostic, and implements a strict domain lifecycle state machine.

Domain Lifecycle

The SDK enforces the following state transitions:

1. created: Internal record created.
2. pending_verification: Waiting for TXT record verification.
3. verified: TXT record matched.
4. pending_dns: Waiting for CNAME/A record to point to our edge.
5. provisioning_ssl: Calling Cloudflare to issue certificates.
6. active: Domain is live.
7. failed: Terminating state for any step.

Why this exists

Every platform that lets you bring your own domain, the way Vercel or Webflow map a custom domain onto your account, builds this flow internally, and none of them ship it as a package. Custom domains look trivial until you actually do it: DNS propagation, TLS provisioning, and provider-specific quirks turn it into a painful thing to debug. I wanted to understand that flow end to end and leave behind a reusable version, so this SDK makes the logic explicit, deterministic, and both framework and database agnostic.