@theholocron/cli 5.0.0-alpha.22 → 5.0.0-alpha.23

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import path, { basename, dirname, join, relative, resolve } from "node:path";
+import path, { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { checkbox, input, select } from "@inquirer/prompts";
 import { KNOWN_WORKFLOWS, createAstromech, extractPreviewConfig, readWorkspacePackages, reusableTemplates } from "@theholocron/astromech";
 import { loadTasksConfig } from "@theholocron/astromech/config";
@@ -1233,6 +1233,30 @@ function commandsInContext(context) {
 }
 //#endregion
 //#region src/commands/deploy.ts
+/**
+* `holocron deploy` — trigger a deployment via the configured
+* `deployment` capability.
+*
+* Two modes, one command: `runDeploy` (the default — a Git branch,
+* `triggerDeployment()`) and `runDeployFromFiles` (`--files <dir>` —
+* a local directory of source files, `deployFunction()`, no linked
+* repo required — for a consumer with no Git history to deploy from,
+* e.g. Sentinel, shipped as an npm package). Separate functions, not
+* one branching `runDeploy`, because their inputs genuinely differ
+* (`branch` vs `dir`) and their result shapes differ too
+* (`DeploymentRecord` carries `status`/`branch`; `DeployFunctionResult`
+* is deliberately minimal, same as `DeployScriptResult` for Workers).
+*
+* Errors clearly when `deployment` isn't loaded (no provider declared
+* in `holocron.config.json`), or when the configured provider doesn't
+* implement `deployFunction` (it's optional on `Deployment` — not
+* every provider has a files-based deploy API).
+*
+* Dry-run skips the actual deploy call but still verifies the
+* deployment capability (and, for `--files`, `deployFunction`) is
+* present, so operators can sanity-check the wiring without spinning
+* up a build.
+*/
 async function runDeploy(input) {
 	const print = input.print ?? ((line) => console.log(line));
 	const logger = input.logger ?? getLogger();
@@ -1288,6 +1312,88 @@ async function runDeploy(input) {
 		};
 	}
 }
+const SKIP_DIRS$2 = /* @__PURE__ */ new Set([
+	".git",
+	"node_modules",
+	"dist",
+	".turbo"
+]);
+/** Recursively lists absolute file paths under `dir`, skipping VCS/build noise. */
+function defaultWalkFiles$2(dir) {
+	const results = [];
+	for (const entry of readdirSync(dir)) {
+		if (SKIP_DIRS$2.has(entry)) continue;
+		const full = join(dir, entry);
+		const stat = statSync(full);
+		if (stat.isDirectory()) results.push(...defaultWalkFiles$2(full));
+		else if (stat.isFile()) results.push(full);
+	}
+	return results;
+}
+/** `holocron deploy --files <dir>` — the non-git counterpart to `runDeploy`. */
+async function runDeployFromFiles(input) {
+	const print = input.print ?? ((line) => console.log(line));
+	const logger = input.logger ?? getLogger();
+	const loader = input.loader ?? new PluginLoader(input.loaded.resolved, input.context);
+	await loader.load();
+	assertPluginsResolvable(loader, "deploy");
+	const dryRun = input.context.dryRun ?? false;
+	const walkFiles = input.walkFiles ?? defaultWalkFiles$2;
+	const readFile = input.readFile ?? ((p) => readFileSync(p, "utf8"));
+	const files = {};
+	for (const abs of walkFiles(input.dir)) {
+		const rel = relative(input.dir, abs).split(sep).join("/");
+		files[rel] = readFile(abs);
+	}
+	const fileCount = Object.keys(files).length;
+	logger.info({
+		dir: input.dir,
+		fileCount,
+		target: input.target ?? "preview",
+		projectId: input.projectId,
+		dryRun: dryRun || void 0
+	}, "deploy: start (files)");
+	print(style.header(`Holocron deploy — files=${input.dir} (${fileCount} file${fileCount === 1 ? "" : "s"})${input.target ? `, target=${input.target}` : " (preview)"}${dryRun ? " (dry-run)" : ""}`));
+	if (!loader.has("deployment")) throw new Error("deployment capability is not configured — add a `deployment` provider to holocron.config.json");
+	const deploy = loader.get("deployment");
+	if (!deploy.deployFunction) throw new Error(`deployment provider "${deploy.providerName}" does not support deploying from files — deployFunction() is not implemented`);
+	if (dryRun) {
+		const message = `would: ${deploy.providerName}.deployFunction(projectId=${input.projectId}, files=${fileCount}${input.target ? `, target=${input.target}` : ""})`;
+		print(`  ${style.dim(`… ${message}`)}`);
+		return {
+			deployment: null,
+			status: "dry-run",
+			message
+		};
+	}
+	try {
+		const result = await withSpinner(`Deploying ${fileCount} file${fileCount === 1 ? "" : "s"} from ${input.dir}…`, () => deploy.deployFunction(input.projectId, {
+			files,
+			...input.target ? { target: input.target } : {}
+		}));
+		print(`  ${style.success(result.url)}`);
+		logger.info({
+			url: result.url,
+			id: result.deploymentId
+		}, "deploy: triggered (files)");
+		return {
+			deployment: result,
+			status: "ok"
+		};
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		print(`  ${style.fail(message)}`);
+		logger.warn({
+			dir: input.dir,
+			reason: message
+		}, "deploy: failed (files)");
+		return {
+			deployment: null,
+			status: "fail",
+			message
+		};
+	}
+}
 //#endregion
 //#region src/commands/doctor.ts
 async function runDoctor(input) {
@@ -8266,7 +8372,7 @@ try {
 		})).summary.fail > 0) process.exitCode = 1;
 	}).command("deploy [branch]", "Trigger a deployment via the configured `deployment` capability", (y) => y.positional("branch", {
 		type: "string",
-		describe: "Git branch to deploy"
+		describe: "Git branch to deploy (omit when using --files)"
 	}).option("project-id", {
 		type: "string",
 		demandOption: true,
@@ -8275,20 +8381,34 @@ try {
 		type: "string",
 		choices: ["production", "staging"],
 		describe: "Named environment to deploy into. Omit for a branch preview."
-	}), async (argv) => {
+	}).option("files", {
+		type: "string",
+		describe: "Deploy from a local directory of source files instead of a Git branch — calls deployFunction(), no linked repo required. Conflicts with `branch`."
+	}).conflicts("files", "branch"), async (argv) => {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
-		const [branch] = await promptForPositionals(getEntry("deploy"), argv);
 		const loaded = await loadConfig(argv.cwd);
 		applyResolvedConfig(argv, loaded.resolved);
+		const context = {
+			repoRoot: argv.cwd,
+			dryRun: argv.dryRun,
+			...tokens,
+			org: resolveOrg(argv, loaded.resolved)
+		};
+		if (argv.files) {
+			if ((await runDeployFromFiles({
+				loaded,
+				context,
+				projectId: argv.projectId,
+				dir: argv.files,
+				...argv.target ? { target: argv.target } : {}
+			})).status === "fail") process.exitCode = 1;
+			return;
+		}
+		const [branch] = await promptForPositionals(getEntry("deploy"), argv);
 		if ((await runDeploy({
 			loaded,
-			context: {
-				repoRoot: argv.cwd,
-				dryRun: argv.dryRun,
-				...tokens,
-				org: resolveOrg(argv, loaded.resolved)
-			},
+			context,
 			projectId: argv.projectId,
 			branch,
 			...argv.target ? { target: argv.target } : {}