@theholocron/holocron-plugin-vercel 2.0.0-alpha.9 → 2.0.0

package/README.md

@@ -1,3 +1,5 @@
+<!-- editorconfig-checker-disable-file -->
+
 # `@theholocron/holocron-plugin-vercel`
 
 Vercel plugin for [Holocron](../cli). Implements the `deployment`
@@ -5,8 +7,10 @@ capability against the [Vercel REST API](https://vercel.com/docs/rest-api).
 
 ## Install
 
+<!-- prettier-ignore -->
 ```bash
 pnpm add -D @theholocron/holocron-plugin-vercel@alpha
+
 ```
 
 ## Auth
@@ -23,17 +27,19 @@ always cover what holocron needs at the API level. Explicit token only.
 
 ## Config
 
+<!-- prettier-ignore -->
 ```jsonc
 // holocron.config.json
 {
-	"providers": {
-		"deployment": ["vercel", { "teamId": "team_xxx" }],
-	},
+  "providers": {
+    "deployment": ["vercel", { "teamId": "team_xxx" }],
+  },
 }
+
 ```
 
 - `teamId` (optional) — Vercel team id. When set, all requests are
-	scoped to that team. Leave unset for personal-account projects.
+  scoped to that team. Leave unset for personal-account projects.
 
 ## Status
 

package/dist/index.d.mts

@@ -1,66 +1,8 @@
-import { Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger } from "@theholocron/cli";
+import { AuthError, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, ResolveTokenInput } from "@theholocron/cli";
+import { VercelClient, VercelClient as VercelClient$1, createVercelClient } from "@theholocron/vercel-client";
 
 //#region src/auth.d.ts
-/**
- * Token resolution for the Vercel plugin.
- *
- * Resolution order (matches the standard 4-step precedence set by
- * `.notes/tech-auth-bootstrap.spec.md`):
- *   1. explicit `cliToken` argument (from `--token` flag)
- *   2. HOLOCRON_VERCEL_TOKEN env var (preferred — explicit intent)
- *   3. VERCEL_TOKEN env var (the default the Vercel CLI also reads)
- *   4. keyring (com.theholocron.cli / "vercel")
- *   5. AuthError naming all four options + the bootstrap hint
- *
- * No `vercel auth` fallback — Vercel CLI auth is per-account-scoped
- * and the resulting tokens don't always cover team operations.
- */
-declare class AuthError extends Error {
-  name: string;
-}
-interface ResolveTokenInput {
-  /** From `--token` CLI flag. */
-  cliToken?: string;
-  /** Env vars; passed in for testability. Defaults to `process.env`. */
-  env?: NodeJS.ProcessEnv;
-  /** Keyring lookup fn; passed in for testability. Defaults to `getToken(provider)`. */
-  keyring?: (provider: string) => string | null;
-}
-declare function resolveToken(input?: ResolveTokenInput): string;
-//#endregion
-//#region src/rest.d.ts
-/**
- * Thin REST wrapper around api.vercel.com.
- *
- * Differences from the GitHub REST client:
- *  - Vercel uses simple `Bearer <token>` (no api-version header)
- *  - Team scoping is a query-string param (`teamId=...`), not a path
- *    prefix; the client appends it to every URL when configured
- *  - 204 responses are honored the same way; transport failures get
- *    wrapped in `ProviderApiError` with `status: 0` for clear hint
- *    output
- */
-interface RestClientOptions {
-  token: string;
-  /** Vercel team id. When set, scoped to that team for every request. */
-  teamId?: string;
-  fetch?: typeof fetch;
-  baseUrl?: string;
-}
-interface RequestOptions {
-  method?: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
-  body?: unknown;
-  /** Additional query-string params. */
-  query?: Record<string, string>;
-}
-declare class VercelRestClient {
-  private readonly token;
-  private readonly teamId?;
-  private readonly fetchImpl;
-  readonly baseUrl: string;
-  constructor(opts: RestClientOptions);
-  request<T>(path: string, opts?: RequestOptions): Promise<T>;
-}
+declare const resolveToken: (input?: import("@theholocron/http-client").ResolveTokenInput) => string;
 //#endregion
 //#region src/capabilities/deployment.d.ts
 interface DeploymentOptions {
@@ -68,11 +10,11 @@ interface DeploymentOptions {
   defaultFramework?: string;
 }
 declare class VercelDeployment implements Deployment {
-  private readonly rest;
+  private readonly client;
   readonly key: "deployment";
   readonly providerName = "vercel";
   private readonly defaultFramework;
-  constructor(rest: VercelRestClient, opts?: DeploymentOptions);
+  constructor(client: VercelClient$1, opts?: DeploymentOptions);
   listProjects(): Promise<DeploymentProject[]>;
   ensureProject(input: {
     name: string;
@@ -89,7 +31,6 @@ declare class VercelDeployment implements Deployment {
     target?: DeploymentTrigger;
   }): Promise<DeploymentRecord>;
   getDeployment(deploymentId: string): Promise<DeploymentRecord>;
-  /** GET project by name with 404→null soft-skip. */
   private getProjectByName;
 }
 //#endregion
@@ -127,7 +68,7 @@ interface VercelPluginOptions extends ResolveTokenInput {
 }
 interface PluginContext {
   options: VercelPluginOptions;
-  rest: VercelRestClient;
+  client: VercelClient;
 }
 declare function createContext(options?: VercelPluginOptions): PluginContext;
 declare function deployment(ctx: PluginContext): Deployment;
@@ -139,10 +80,8 @@ declare function createPlugin(options?: VercelPluginOptions): {
 };
 /**
  * One-line hint printed by `holocron auth set vercel` when no token
- * is supplied or the supplied token is rejected. Points operators at
- * https://vercel.com/account/tokens where PATs are minted with
- * "Full Account" scope for team-level ops.
+ * is supplied or the supplied token is rejected.
  */
 declare const AUTH_HINT: string;
 //#endregion
-export { AUTH_HINT, AuthError, PluginContext, ResolveTokenInput, VercelDeployment, VercelPluginOptions, VercelRestClient, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, createContext, createPlugin, deployment, resolveToken, verifyToken };
+export { AUTH_HINT, AuthError, PluginContext, type ResolveTokenInput, type VercelClient, VercelDeployment, VercelPluginOptions, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, createContext, createPlugin, createVercelClient, deployment, resolveToken, verifyToken };

package/dist/index.mjs

@@ -1,29 +1,12 @@
-import { ProviderApiError, getToken } from "@theholocron/cli";
+import { AuthError, ProviderApiError, createResolveToken } from "@theholocron/cli";
+import { createVercelClient } from "@theholocron/vercel-client";
 //#region src/auth.ts
-/**
-* Token resolution for the Vercel plugin.
-*
-* Resolution order (matches the standard 4-step precedence set by
-* `.notes/tech-auth-bootstrap.spec.md`):
-*   1. explicit `cliToken` argument (from `--token` flag)
-*   2. HOLOCRON_VERCEL_TOKEN env var (preferred — explicit intent)
-*   3. VERCEL_TOKEN env var (the default the Vercel CLI also reads)
-*   4. keyring (com.theholocron.cli / "vercel")
-*   5. AuthError naming all four options + the bootstrap hint
-*
-* No `vercel auth` fallback — Vercel CLI auth is per-account-scoped
-* and the resulting tokens don't always cover team operations.
-*/
-var AuthError = class extends Error {
-	name = "AuthError";
-};
-function resolveToken(input = {}) {
-	const env = input.env ?? process.env;
-	const keyring = input.keyring ?? getToken;
-	const token = input.cliToken || env["HOLOCRON_VERCEL_TOKEN"] || env["VERCEL_TOKEN"] || keyring("vercel");
-	if (!token) throw new AuthError("no Vercel token found. Pass --token <PAT>, set HOLOCRON_VERCEL_TOKEN / VERCEL_TOKEN, or run: holocron auth set vercel <PAT>");
-	return token;
-}
+const resolveToken = createResolveToken({
+	envName: "HOLOCRON_VERCEL_TOKEN",
+	vendorEnvName: "VERCEL_TOKEN",
+	keyringService: "vercel",
+	errorMessage: "no Vercel token found. Pass --token <PAT>, set HOLOCRON_VERCEL_TOKEN / VERCEL_TOKEN, or run: holocron auth set vercel <PAT>"
+});
 //#endregion
 //#region src/capabilities/deployment.ts
 /**
@@ -45,83 +28,59 @@ function resolveToken(input = {}) {
 * sealed-box / libsodium step on the client.
 */
 var VercelDeployment = class {
-	rest;
+	client;
 	key = "deployment";
 	providerName = "vercel";
 	defaultFramework;
-	constructor(rest, opts = {}) {
-		this.rest = rest;
+	constructor(client, opts = {}) {
+		this.client = client;
 		this.defaultFramework = opts.defaultFramework ?? "nextjs";
 	}
 	async listProjects() {
-		return (await this.rest.request("/v10/projects")).projects.map(mapProject);
+		const { projects } = await this.client.projects.list();
+		return projects.map(mapProject);
 	}
 	async ensureProject(input) {
 		const existing = await this.getProjectByName(input.name);
 		if (existing) return existing;
-		const body = {
+		return mapProject(await this.client.projects.create({
 			name: input.name,
-			framework: input.framework ?? this.defaultFramework
-		};
-		if (input.repo) body.gitRepository = {
-			type: "github",
-			repo: input.repo
-		};
-		if (input.rootDirectory) body.rootDirectory = input.rootDirectory;
-		return mapProject(await this.rest.request("/v11/projects", {
-			method: "POST",
-			body
+			framework: input.framework ?? this.defaultFramework,
+			repo: input.repo,
+			rootDirectory: input.rootDirectory
 		}));
 	}
 	async updateProjectSettings(projectId, settings) {
-		const body = {};
-		if (settings.previewDeploymentsDisabled !== void 0) body.previewDeploymentsDisabled = settings.previewDeploymentsDisabled;
-		if (settings.gitProviderCreateDeployments !== void 0) body.gitProviderOptions = { createDeployments: settings.gitProviderCreateDeployments };
-		return mapProject(await this.rest.request(`/v9/projects/${encodeURIComponent(projectId)}`, {
-			method: "PATCH",
-			body
+		return mapProject(await this.client.projects.update(projectId, {
+			previewDeploymentsDisabled: settings.previewDeploymentsDisabled,
+			gitProviderOptions: settings.gitProviderCreateDeployments !== void 0 ? { createDeployments: settings.gitProviderCreateDeployments } : void 0
 		}));
 	}
 	async listEnvVars(projectId, target) {
-		return (await this.rest.request(`/v9/projects/${encodeURIComponent(projectId)}/env`)).envs.filter((e) => e.target.includes(target)).map((e) => e.key);
+		const { envs } = await this.client.env.list(projectId);
+		return envs.filter((e) => e.target.includes(target)).map((e) => e.key);
 	}
 	async setEnvVar(projectId, target, name, value) {
-		await this.rest.request(`/v10/projects/${encodeURIComponent(projectId)}/env`, {
-			method: "POST",
-			query: { upsert: "true" },
-			body: {
-				key: name,
-				value,
-				target: [target],
-				type: "encrypted"
-			}
-		});
+		await this.client.env.set(projectId, target, name, value);
 	}
 	async triggerDeployment(input) {
-		const project = await this.rest.request(`/v10/projects/${encodeURIComponent(input.projectId)}`);
+		const project = await this.client.projects.get(input.projectId);
 		const repoId = project.link?.repoId;
 		if (!repoId) throw new ProviderApiError(`Vercel project "${project.name}" has no linked GitHub repo — cannot trigger a deployment. Link the repo first.`, 400, void 0);
-		return mapDeployment(await this.rest.request("/v13/deployments", {
-			method: "POST",
-			body: {
-				name: project.name,
-				gitSource: {
-					type: "github",
-					ref: input.branch,
-					repoId
-				},
-				...input.target ? { target: input.target } : {}
-			}
+		return mapDeployment(await this.client.deployments.trigger({
+			projectName: project.name,
+			branch: input.branch,
+			repoId,
+			target: input.target
 		}), input.branch);
 	}
 	async getDeployment(deploymentId) {
-		const raw = await this.rest.request(`/v13/deployments/${encodeURIComponent(deploymentId)}`);
+		const raw = await this.client.deployments.get(deploymentId);
 		return mapDeployment(raw, raw.meta?.githubCommitRef ?? null);
 	}
-	/** GET project by name with 404→null soft-skip. */
 	async getProjectByName(name) {
 		try {
-			return mapProject(await this.rest.request(`/v10/projects/${encodeURIComponent(name)}`));
+			return mapProject(await this.client.projects.get(name));
 		} catch (err) {
 			if (err instanceof ProviderApiError && err.status === 404) return null;
 			throw err;
@@ -159,66 +118,6 @@ function normalizeState(s) {
 	}
 }
 //#endregion
-//#region src/rest.ts
-/**
-* Thin REST wrapper around api.vercel.com.
-*
-* Differences from the GitHub REST client:
-*  - Vercel uses simple `Bearer <token>` (no api-version header)
-*  - Team scoping is a query-string param (`teamId=...`), not a path
-*    prefix; the client appends it to every URL when configured
-*  - 204 responses are honored the same way; transport failures get
-*    wrapped in `ProviderApiError` with `status: 0` for clear hint
-*    output
-*/
-var VercelRestClient = class {
-	token;
-	teamId;
-	fetchImpl;
-	baseUrl;
-	constructor(opts) {
-		this.token = opts.token;
-		if (opts.teamId !== void 0) this.teamId = opts.teamId;
-		this.fetchImpl = opts.fetch ?? globalThis.fetch;
-		let url = opts.baseUrl ?? "https://api.vercel.com";
-		while (url.endsWith("/")) url = url.slice(0, -1);
-		this.baseUrl = url;
-	}
-	async request(path, opts = {}) {
-		const url = new URL(`${this.baseUrl}${path.startsWith("/") ? path : "/" + path}`);
-		if (this.teamId) url.searchParams.set("teamId", this.teamId);
-		for (const [k, v] of Object.entries(opts.query ?? {})) url.searchParams.set(k, v);
-		const fullUrl = url.toString();
-		const headers = {
-			authorization: `Bearer ${this.token}`,
-			accept: "application/json"
-		};
-		const init = {
-			method: opts.method ?? "GET",
-			headers
-		};
-		if (opts.body !== void 0) {
-			headers["content-type"] = "application/json";
-			init.body = JSON.stringify(opts.body);
-		}
-		let res;
-		try {
-			res = await this.fetchImpl(fullUrl, init);
-		} catch (err) {
-			const detail = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
-			throw new ProviderApiError(`Vercel ${init.method} ${path} failed: ${detail}`, 0, void 0);
-		}
-		if (!res.ok) {
-			const body = await res.text().catch(() => "");
-			throw new ProviderApiError(`Vercel ${init.method} ${path} → ${res.status}`, res.status, body);
-		}
-		if (res.status === 204) return void 0;
-		const text = await res.text();
-		if (!text) return void 0;
-		return JSON.parse(text);
-	}
-};
-//#endregion
 //#region src/verify-token.ts
 /**
 * `verifyToken` — plugin-level export used by `holocron auth set` +
@@ -226,12 +125,13 @@ var VercelRestClient = class {
 * response into the normalized `VerifyTokenResult` shape.
 */
 async function verifyToken(token, opts = {}) {
-	const restOpts = { token };
-	if (opts.baseUrl !== void 0) restOpts.baseUrl = opts.baseUrl;
-	if (opts.fetch !== void 0) restOpts.fetch = opts.fetch;
-	const rest = new VercelRestClient(restOpts);
+	const client = createVercelClient({
+		token,
+		baseUrl: opts.baseUrl,
+		fetch: opts.fetch
+	});
 	try {
-		const res = await rest.request("/v2/user");
+		const res = await client.user.get();
 		return {
 			ok: true,
 			subject: `user @ ${res?.user?.email ?? res?.user?.username ?? res?.user?.name ?? res?.user?.id ?? "unknown"}`
@@ -246,19 +146,20 @@ async function verifyToken(token, opts = {}) {
 //#endregion
 //#region src/index.ts
 function createContext(options = {}) {
-	const restOpts = { token: resolveToken(options) };
-	if (options.teamId !== void 0) restOpts.teamId = options.teamId;
-	if (options.baseUrl !== void 0) restOpts.baseUrl = options.baseUrl;
-	if (options.fetch !== void 0) restOpts.fetch = options.fetch;
 	return {
 		options,
-		rest: new VercelRestClient(restOpts)
+		client: createVercelClient({
+			token: resolveToken(options),
+			teamId: options.teamId,
+			baseUrl: options.baseUrl,
+			fetch: options.fetch
+		})
 	};
 }
 function deployment(ctx) {
 	const opts = {};
 	if (ctx.options.defaultFramework !== void 0) opts.defaultFramework = ctx.options.defaultFramework;
-	return new VercelDeployment(ctx.rest, opts);
+	return new VercelDeployment(ctx.client, opts);
 }
 function createPlugin(options = {}) {
 	const ctx = createContext(options);
@@ -269,10 +170,8 @@ function createPlugin(options = {}) {
 }
 /**
 * One-line hint printed by `holocron auth set vercel` when no token
-* is supplied or the supplied token is rejected. Points operators at
-* https://vercel.com/account/tokens where PATs are minted with
-* "Full Account" scope for team-level ops.
+* is supplied or the supplied token is rejected.
 */
 const AUTH_HINT = "generate a Vercel Personal Access Token at https://vercel.com/account/tokens (scope: Full Account for team ops), then run: holocron auth set vercel <PAT>";
 //#endregion
-export { AUTH_HINT, AuthError, VercelDeployment, VercelRestClient, createContext, createPlugin, deployment, resolveToken, verifyToken };
+export { AUTH_HINT, AuthError, VercelDeployment, createContext, createPlugin, createVercelClient, deployment, resolveToken, verifyToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-vercel",
-  "version": "2.0.0-alpha.9",
+  "version": "2.0.0",
   "description": "Holocron plugin for Vercel. Implements the deployment capability against the Vercel REST API.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/holocron-plugin-vercel#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",
@@ -21,19 +21,31 @@
     }
   },
   "peerDependencies": {
-    "@theholocron/cli": "2.0.0-alpha.9"
+    "@theholocron/vercel-client": "^1.1.0",
+    "@theholocron/cli": "2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@theholocron/vercel-client": {
+      "optional": false
+    }
   },
   "devDependencies": {
-    "@theholocron/tsconfig": "^4.1.0",
-    "@tsconfig/node-lts": "^24.0.0",
-    "@vitest/coverage-v8": "^3.2.6",
-    "eslint": "^9.36.0",
-    "globals": "^16.5.0",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.6",
+    "@theholocron/eslint-config": "^7.3.0",
+    "@theholocron/tsconfig": "^7.3.0",
+    "@theholocron/tsdown-config": "^7.3.0",
+    "@theholocron/vercel-client": "^1.1.0",
+    "@theholocron/vitest-config": "^7.3.0",
+    "@types/node": "^26",
+    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/eslint-plugin": "^1.6.23",
+    "eslint": "^10.7.0",
+    "eslint-plugin-n": "^18.2.2",
+    "globals": "^17.7.0",
     "tsdown": "^0.22.3",
     "tsx": "^4.22.4",
-    "@theholocron/cli": "2.0.0-alpha.9"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "@theholocron/cli": "2.0.0"
   },
   "publishConfig": {
     "access": "public"