OpenCoreDev Launches Domain SDK 0.2.0 to Streamline Custom Domain Management Across Multiple Platforms

OpenCoreDev has announced the release of Domain SDK 0.2.0, a TypeScript client aimed at standardizing the management of custom domains across various hosting platforms. This new version, which quickly followed its initial release, provides a unified API for developers to handle the full lifecycle of custom domains on services such as Vercel, Cloudflare for SaaS, Railway, Render, and Netlify.

Custom domains are a critical feature for Software-as-a-Service (SaaS) applications, allowing businesses to brand their services with their own web addresses. However, each hosting provider typically exposes its own unique API for domain operations, leading to fragmented development efforts. Domain SDK 0.2.0 addresses this challenge by normalizing the processes of adding, verifying, and removing customer domains through a single, consistent interface.

Key Features and Functionality

The Domain SDK 0.2.0 simplifies the workflow for developers by abstracting away the platform-specific complexities. Developers can add a hostname, retrieve the exact DNS records required for setup, and then track the domain’s status until it becomes active. The SDK does not manage domain registration, DNS hosting, application deployment, traffic proxying, or tenant data storage. Instead, it focuses solely on the custom domain lifecycle, with the hosting provider remaining the authoritative source of truth for domain status.

The package is designed for server-side use, ensuring that sensitive credentials never reach client-side browser code. It requires Node.js version 20 or higher and supports Bun, operating exclusively as an ESM (ECMAScript Module) with a single runtime dependency: `tldts`.

API Structure and Status Modeling

The API is compact, centering around the `createDomainClient()` function, which returns a stateless client with seven core methods: `add`, `get`, `refresh`, `list`, `verify`, `remove`, and `waitUntilActive`. All methods support `AbortSignal` for cancellation, and `add` and `remove` operations are idempotent, allowing for safe retries.

The SDK introduces a robust `DomainStatus` model with eight possible values: `pending`, `pending_dns`, `pending_verification`, `pending_certificate`, `active`, `misconfigured`, `failed`, and `unknown`. It also separately tracks verification status (`pending`, `verified`, `failed`, `unknown`) and certificate status (`pending`, `active`, `expiring`, `failed`, `unknown`), alongside an array of issues with codes, messages, optional records, and a `retryable` flag. DNS records are similarly typed, detailing `type`, `name`, `value`, `ttl`, `purpose`, `required`, `status`, and `description`.

Adapter-Based Flexibility

The SDK uses an adapter pattern, with each supported platform having its own entry point (e.g., `./vercel`, `./cloudflare`). This design allows developers to switch between platforms by simply changing the import statement, maintaining the same underlying domain management workflow. While the SDK normalizes the lifecycle, it acknowledges that platform-specific limitations persist. For instance, Cloudflare for SaaS requires a CNAME target and does not support apex domains through its adapter, and Render is noted as the only platform accepting wildcard hostnames. Developers can query `client.capabilities` at runtime to understand each adapter’s specific features, such as `list`, `explicitVerification`, `managedCertificates`, `apexDomains`, and `wildcardDomains`.

Use Cases and Impact for Developers

The Domain SDK 0.2.0 is particularly beneficial for developers building multi-tenant SaaS applications. It simplifies the process of allowing customers to map their own domains, providing clear instructions for required DNS records and live status updates on a settings page. It also aids in managing custom hostnames at scale for platforms like Cloudflare for SaaS and facilitates provider migrations by allowing developers to swap adapters while retaining the same lifecycle calls. Developers can also manage tenant subdomains they own, with features to block reserved labels like `www`, `api`, and `admin`.

Key facts:
| Feature | Description |
|—|—|
| API Type | TypeScript client |
| Supported Platforms | Vercel, Cloudflare for SaaS, Railway, Render, Netlify |
| Core Functionality | Add, verify, remove custom domains |
| Server-Side Only | Credentials never reach browser code |

Source: MarkTechPost, OpenCoreDev Releases Domain SDK 0.2.0: One TypeScript API to Add, Verify, and Remove Customer Domains Across Five Platforms, https://www.marktechpost.com/2026/07/14/opencoredev-releases-domain-sdk-0-2-0-one-typescript-api-to-add-verify-and-remove-customer-domains-across-five-platforms/

Datos clave

Punto	Detalle
Fuente	MarkTechPost
Fecha	2026-07-14T20:16:51+00:00
Tema	OpenCoreDev Releases Domain SDK 0.2.0: One TypeScript API to Add, Verify, and Remove Customer Domains Across Five Platfo