@theholocron/vercel-client 1.21.0 → 1.22.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,6 +53,14 @@ 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);
 ```

package/dist/index.d.mts

@@ -34,6 +34,25 @@ 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/env/env.d.ts
 type VercelEnvTarget = "production" | "preview" | "development";
@@ -91,6 +110,7 @@ interface VercelUserResponse {
 declare function createVercelClient(opts: VercelClientOptions): {
   deployments: {
     trigger: (input: VercelTriggerDeploymentInput) => Promise<VercelDeployment>;
+    create: (input: VercelCreateDeploymentInput) => Promise<VercelDeployment>;
     get: (deploymentId: string) => Promise<VercelDeployment>;
   };
   env: {
@@ -109,4 +129,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 { VercelClient, type VercelClientOptions, type VercelCreateDeploymentInput, type VercelCreateProjectInput, type VercelDeployFile, 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 };

package/dist/index.mjs

@@ -14,6 +14,25 @@ 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)}`)
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/vercel-client",
-  "version": "1.21.0",
+  "version": "1.22.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.22.0"
   },
   "devDependencies": {
     "@theholocron/cli": "5.0.0-alpha.3",