@theholocron/vercel-client 1.21.0 → 1.23.0

package/README.md

@@ -45,7 +45,7 @@ const { envs } = await vercel.env.list("project-id");
 // Set (upsert) an env var
 await vercel.env.set("project-id", "production", "API_URL", "https://api.example.com");
 
-// Trigger a deployment
+// Trigger a deployment (requires a project linked to a Git repo)
 const deployment = await vercel.deployments.trigger({
   projectName: "my-app",
   branch: "main",
@@ -53,8 +53,26 @@ const deployment = await vercel.deployments.trigger({
   target: "production",
 });
 
+// Create a deployment directly from source files — no linked repo required
+const fnDeployment = await vercel.deployments.create({
+  projectName: "my-fn",
+  files: [{ file: "api/webhook.js", content: "export default () => new Response('ok');" }],
+  framework: null, // no framework preset — a bare function, not an app
+  target: "production",
+});
+
 // Poll deployment status
 const status = await vercel.deployments.get(deployment.id);
+
+// List a project's custom domains
+const { domains } = await vercel.domains.list("project-id");
+
+// Add a custom domain — the CNAME target is generated per-project by
+// Vercel, not a fixed well-known host; always read it from the response
+const added = await vercel.domains.add("project-id", "sentinel.example.com");
+if (!added.verified) {
+  console.log(added.verification); // [{ type: "CNAME", domain, value }]
+}
 ```
 
 ## Status

package/dist/index.d.mts

@@ -34,6 +34,55 @@ interface VercelTriggerDeploymentInput {
   repoId: number;
   target?: VercelDeploymentTarget;
 }
+/** One file for `deployments.create()` — content is sent inline, base64-encoded. */
+interface VercelDeployFile {
+  /** Path relative to the project root, e.g. "api/webhook.js". */
+  file: string;
+  /** File content, plain text — base64-encoded by `create()` before the request goes out. */
+  content: string;
+}
+interface VercelCreateDeploymentInput {
+  projectName: string;
+  files: VercelDeployFile[];
+  /**
+   * `projectSettings.framework`. `null` (the default) deploys with no
+   * framework preset — the right choice for a bare serverless function,
+   * not an app. Vercel requires this on a project's first deployment;
+   * later deployments inherit it unless overridden here again.
+   */
+  framework?: string | null;
+  target?: VercelDeploymentTarget;
+}
+//#endregion
+//#region src/domains/domains.d.ts
+interface VercelDomain {
+  name: string;
+  apexName: string;
+  verified: boolean;
+}
+interface VercelDomainsResponse {
+  domains: VercelDomain[];
+}
+/**
+ * One DNS verification challenge — complete any one of these (usually
+ * just one is returned) to prove ownership. `type: "CNAME"` means
+ * `domain` needs a CNAME record pointing at `value`; `type: "TXT"`
+ * means a TXT record on `domain` with content `value`. The CNAME
+ * target is generated per-project by Vercel, not a fixed well-known
+ * host — always read it from this response, never hardcode it.
+ */
+interface VercelDomainVerification {
+  type: string;
+  domain: string;
+  value: string;
+  reason: string;
+}
+interface VercelAddDomainResult {
+  name: string;
+  apexName: string;
+  verified: boolean;
+  verification?: VercelDomainVerification[];
+}
 //#endregion
 //#region src/env/env.d.ts
 type VercelEnvTarget = "production" | "preview" | "development";
@@ -91,8 +140,13 @@ interface VercelUserResponse {
 declare function createVercelClient(opts: VercelClientOptions): {
   deployments: {
     trigger: (input: VercelTriggerDeploymentInput) => Promise<VercelDeployment>;
+    create: (input: VercelCreateDeploymentInput) => Promise<VercelDeployment>;
     get: (deploymentId: string) => Promise<VercelDeployment>;
   };
+  domains: {
+    list: (projectId: string) => Promise<VercelDomainsResponse>;
+    add: (projectId: string, name: string) => Promise<VercelAddDomainResult>;
+  };
   env: {
     list: (projectId: string) => Promise<VercelEnvVarsResponse>;
     set: (projectId: string, target: VercelEnvTarget, name: string, value: string) => Promise<VercelEnvVar>;
@@ -109,4 +163,4 @@ declare function createVercelClient(opts: VercelClientOptions): {
 };
 type VercelClient = ReturnType<typeof createVercelClient>;
 //#endregion
-export { VercelClient, type VercelClientOptions, type VercelCreateProjectInput, type VercelDeployment, type VercelDeploymentState, type VercelDeploymentTarget, 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 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

@@ -14,10 +14,40 @@ function deployments(rest) {
 				...input.target ? { target: input.target } : {}
 			}
 		}),
+		/**
+		* Create a deployment directly from source files — no `gitSource`,
+		* no linked repo required. The non-git counterpart to `trigger()`,
+		* for a consumer with no repo to deploy from (a webhook receiver
+		* bundled and shipped as an npm package, for instance).
+		*/
+		create: (input) => rest.request("/v13/deployments", {
+			method: "POST",
+			body: {
+				name: input.projectName,
+				files: input.files.map((f) => ({
+					file: f.file,
+					data: Buffer.from(f.content, "utf8").toString("base64"),
+					encoding: "base64"
+				})),
+				projectSettings: { framework: input.framework ?? null },
+				...input.target ? { target: input.target } : {}
+			}
+		}),
 		get: (deploymentId) => rest.request(`/v13/deployments/${encodeURIComponent(deploymentId)}`)
 	};
 }
 //#endregion
+//#region src/domains/domains.ts
+function domains(rest) {
+	return {
+		list: (projectId) => rest.request(`/v9/projects/${encodeURIComponent(projectId)}/domains`),
+		add: (projectId, name) => rest.request(`/v10/projects/${encodeURIComponent(projectId)}/domains`, {
+			method: "POST",
+			body: { name }
+		})
+	};
+}
+//#endregion
 //#region src/env/env.ts
 function env(rest) {
 	return {
@@ -90,6 +120,7 @@ function createVercelClient(opts) {
 	const rest = createVercelRestClient(opts);
 	return {
 		deployments: deployments(rest),
+		domains: domains(rest),
 		env: env(rest),
 		projects: projects(rest),
 		user: user(rest)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/vercel-client",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "A TypeScript client for the Vercel API",
   "keywords": [
     "vercel",
@@ -33,7 +33,7 @@
   ],
   "dependencies": {
     "@theholocron/observability": "^0.3.0",
-    "@theholocron/http-client": "^1.21.0"
+    "@theholocron/http-client": "^1.23.0"
   },
   "devDependencies": {
     "@theholocron/cli": "5.0.0-alpha.3",