@theholocron/vercel-client 1.23.0 → 1.25.0

package/dist/index.d.mts

@@ -83,6 +83,30 @@ interface VercelAddDomainResult {
   verified: boolean;
   verification?: VercelDomainVerification[];
 }
+/** One ranked CNAME/IPv4 recommendation — `rank: 1` is the preferred value. */
+interface VercelDomainConfigRecommendation<T> {
+  rank: number;
+  value: T;
+}
+/**
+ * DNS *routing* status for a domain — distinct from ownership (`verified`
+ * on `VercelDomain`/`VercelAddDomainResult`). A domain can be verified
+ * (Vercel trusts you own it) with no record actually pointing traffic at
+ * Vercel yet, e.g. re-adding a domain whose apex is already verified on
+ * this team short-circuits to `verified: true` with no `verification`
+ * challenge (`domains.add` returns 409, not a fresh challenge) — this is
+ * the only source for that domain's CNAME target in that case.
+ */
+interface VercelDomainConfig {
+  /** How Vercel currently sees the domain resolving. `null` = not resolving to Vercel at all. */
+  configuredBy: "A" | "CNAME" | "http" | "dns-01" | null;
+  /** `false` once DNS is correctly configured and a TLS cert can be issued. */
+  misconfigured: boolean;
+  /** Recommended CNAME target(s) for a subdomain, ranked; `[0]` is preferred. Per-project, never a fixed host. */
+  recommendedCNAME: VercelDomainConfigRecommendation<string>[];
+  /** Recommended A-record IPv4(s) for an apex domain, ranked. */
+  recommendedIPv4: VercelDomainConfigRecommendation<string[]>[];
+}
 //#endregion
 //#region src/env/env.d.ts
 type VercelEnvTarget = "production" | "preview" | "development";
@@ -146,6 +170,7 @@ declare function createVercelClient(opts: VercelClientOptions): {
   domains: {
     list: (projectId: string) => Promise<VercelDomainsResponse>;
     add: (projectId: string, name: string) => Promise<VercelAddDomainResult>;
+    config: (domain: string, projectIdOrName?: string) => Promise<VercelDomainConfig>;
   };
   env: {
     list: (projectId: string) => Promise<VercelEnvVarsResponse>;
@@ -163,4 +188,4 @@ declare function createVercelClient(opts: VercelClientOptions): {
 };
 type VercelClient = ReturnType<typeof createVercelClient>;
 //#endregion
-export { type VercelAddDomainResult, VercelClient, type VercelClientOptions, type VercelCreateDeploymentInput, type VercelCreateProjectInput, type VercelDeployFile, type VercelDeployment, type VercelDeploymentState, type VercelDeploymentTarget, type VercelDomain, type VercelDomainVerification, type VercelDomainsResponse, type VercelEnvTarget, type VercelEnvVar, type VercelEnvVarsResponse, type VercelProject, type VercelProjectLink, type VercelProjectsResponse, type VercelTriggerDeploymentInput, type VercelUpdateProjectInput, type VercelUser, type VercelUserResponse, createVercelClient };
+export { type VercelAddDomainResult, VercelClient, type VercelClientOptions, type VercelCreateDeploymentInput, type VercelCreateProjectInput, type VercelDeployFile, type VercelDeployment, type VercelDeploymentState, type VercelDeploymentTarget, type VercelDomain, type VercelDomainConfig, type VercelDomainConfigRecommendation, type VercelDomainVerification, type VercelDomainsResponse, type VercelEnvTarget, type VercelEnvVar, type VercelEnvVarsResponse, type VercelProject, type VercelProjectLink, type VercelProjectsResponse, type VercelTriggerDeploymentInput, type VercelUpdateProjectInput, type VercelUser, type VercelUserResponse, createVercelClient };

package/dist/index.mjs

@@ -44,7 +44,15 @@ function domains(rest) {
 		add: (projectId, name) => rest.request(`/v10/projects/${encodeURIComponent(projectId)}/domains`, {
 			method: "POST",
 			body: { name }
-		})
+		}),
+		/**
+		* DNS routing status for `domain` — works regardless of whether the
+		* domain is already attached/verified on a project. `projectIdOrName`
+		* is optional per Vercel's docs ("use this when the domain is not yet
+		* associated with a project") but passed through when known to scope
+		* the recommendation to that project.
+		*/
+		config: (domain, projectIdOrName) => rest.request(`/v6/domains/${encodeURIComponent(domain)}/config`, { query: projectIdOrName ? { projectIdOrName } : void 0 })
 	};
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/vercel-client",
-  "version": "1.23.0",
+  "version": "1.25.0",
   "description": "A TypeScript client for the Vercel API",
   "keywords": [
     "vercel",
@@ -33,11 +33,11 @@
   ],
   "dependencies": {
     "@theholocron/observability": "^0.3.0",
-    "@theholocron/http-client": "^1.23.0"
+    "@theholocron/http-client": "^1.25.0"
   },
   "devDependencies": {
-    "@theholocron/cli": "5.0.0-alpha.3",
-    "@theholocron/eslint-config": "^8.2.0",
+    "@theholocron/cli": "5.0.0-alpha.33",
+    "@theholocron/eslint-config": "^8.4.3",
     "@theholocron/tsconfig": "^8.2.0",
     "@theholocron/tsdown-config": "^8.2.0",
     "@theholocron/vitest-config": "^8.2.0",