gcp-job-runner 1.0.0-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thijs Koerselman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# code-conventions
+
+Formalize and sync code-conventions across repositories

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+import { discoverJobs } from "./discover-jobs.mjs";
+import { promptForArgs, selectJob } from "./interactive.mjs";
+import { runJob } from "./run-job.mjs";
+import { deploy, deployIfChanged } from "./cloud/deploy.mjs";
+import { execute } from "./cloud/execute.mjs";
+import { getSecrets } from "./secrets/loader.mjs";
+import { consola } from "consola";
+import path from "node:path";
+import process from "node:process";
+import { execSync } from "node:child_process";
+
+//#region src/cli.ts
+const BIN_NAME = "job";
+const CONFIG_FILE = "job-runner.config.ts";
+const DEFAULT_BUILD_COMMAND = "turbo build";
+const DEFAULT_JOBS_DIRECTORY = "dist/jobs";
+const USAGE = `Usage: ${BIN_NAME} local run <env> <job-name> [options]
+       ${BIN_NAME} cloud run <env> <job-name> [options]
+       ${BIN_NAME} cloud deploy <env>
+       ${BIN_NAME} --list`;
+async function main() {
+	const args = process.argv.slice(2);
+	/** Extract flags from anywhere in args */
+	const noBuild = args.includes("--no-build");
+	const isInteractive = args.includes("--interactive") || args.includes("-i");
+	const isAsync = args.includes("--async");
+	const configPath = path.resolve(process.cwd(), CONFIG_FILE);
+	/** Load config directly (config should only depend on gcp-job-runner) */
+	let config;
+	try {
+		config = (await import(configPath)).default;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		consola.error(`Failed to load runner config from ${configPath}\n${message}`);
+		process.exit(1);
+	}
+	/** Resolve jobs directory with default */
+	const jobsDirectory = config.jobsDirectory ?? path.resolve(process.cwd(), DEFAULT_JOBS_DIRECTORY);
+	const envNames = Object.keys(config.environments);
+	/** Handle --list: discover and print all available jobs */
+	if (args.includes("--list")) {
+		if (!noBuild && config.buildCommand !== false) runBuild(config.buildCommand ?? DEFAULT_BUILD_COMMAND);
+		const jobs = await discoverJobs(jobsDirectory);
+		if (jobs.length === 0) consola.info("No jobs found.");
+		else {
+			consola.info("Available jobs:");
+			for (const job of jobs) consola.log(`  ${job.name}`);
+		}
+		return;
+	}
+	/** Parse positional arguments */
+	const positionals = args.filter((arg) => !arg.startsWith("-"));
+	const mode = positionals[0];
+	if (mode !== "local" && mode !== "cloud") {
+		consola.error(`Unknown or missing mode "${mode ?? ""}".\n\n${USAGE}\n\nEnvironments: ${envNames.join(", ")}`);
+		process.exit(1);
+	}
+	const action = positionals[1];
+	if (mode === "cloud" && action !== "run" && action !== "deploy") {
+		consola.error(`Unknown or missing action "${action ?? ""}" for cloud mode.\n\n` + USAGE);
+		process.exit(1);
+	}
+	if (mode === "local" && action !== "run") {
+		consola.error(`Unknown or missing action "${action ?? ""}" for local mode.\n\n` + USAGE);
+		process.exit(1);
+	}
+	const envName = positionals[2];
+	if (!envName) {
+		consola.error(`No environment specified.\n\n${USAGE}\n\nEnvironments: ${envNames.join(", ")}`);
+		process.exit(1);
+	}
+	if (!envNames.includes(envName)) {
+		consola.error(`Unknown environment "${envName}".\n\nAvailable environments: ${envNames.join(", ")}`);
+		process.exit(1);
+	}
+	const envConfig = config.environments[envName];
+	/**
+	* Remaining positionals after env become the job name/path. For example
+	* `job cloud run stag test/countdown` -> positionals[3] = "test/countdown".
+	*/
+	const jobNameFromArgs = positionals[3];
+	/**
+	* Collect job flags: everything after `<env>` in the original args that
+	* isn't a consumed positional or a known global flag.
+	*/
+	const consumedPositionals = new Set([
+		mode,
+		action,
+		envName,
+		jobNameFromArgs
+	].filter(Boolean));
+	const globalFlags = new Set([
+		"--no-build",
+		"--interactive",
+		"-i",
+		"--async",
+		"--list"
+	]);
+	const envIndex = args.indexOf(envName);
+	const jobFlags = args.slice(envIndex + 1).filter((arg) => !consumedPositionals.has(arg) && !globalFlags.has(arg));
+	/** Build unless skipped */
+	if (!noBuild && config.buildCommand !== false) runBuild(config.buildCommand ?? DEFAULT_BUILD_COMMAND);
+	if (mode === "local") await handleLocalRun({
+		config,
+		envName,
+		envConfig,
+		jobsDirectory,
+		jobNameFromArgs,
+		jobFlags,
+		isInteractive
+	});
+	else if (action === "deploy") await handleCloudDeploy({
+		config,
+		envConfig
+	});
+	else await handleCloudRun({
+		config,
+		envConfig,
+		jobsDirectory,
+		jobNameFromArgs,
+		jobFlags,
+		isInteractive,
+		isAsync
+	});
+}
+async function handleLocalRun(options) {
+	const { config, envName, envConfig, jobsDirectory, jobNameFromArgs, jobFlags, isInteractive } = options;
+	/** Set environment variables for local execution */
+	process.env.GOOGLE_CLOUD_PROJECT = envConfig.project;
+	process.env.USE_CONSOLE_LOG ??= "true";
+	process.env.LOG_COLORIZE ??= "true";
+	if (envConfig.env) for (const [key, value] of Object.entries(envConfig.env)) process.env[key] = value;
+	if (envConfig.secrets && envConfig.secrets.length > 0) {
+		const secrets = await getSecrets(envConfig.secrets);
+		for (const [key, value] of Object.entries(secrets)) process.env[key] = value;
+	}
+	if (isInteractive) {
+		const { jobArgv } = await resolveInteractiveJob(jobsDirectory);
+		process.argv = [
+			process.argv[0],
+			process.argv[1],
+			...jobArgv
+		];
+		const commandPrefix = `${BIN_NAME} local run ${envName}`;
+		await runJob({
+			jobsDirectory,
+			initialize: config.initialize,
+			logger: config.logger,
+			commandPrefix
+		});
+		return;
+	}
+	if (!jobNameFromArgs) {
+		consola.error(`No job name specified.\n\nUsage: ${BIN_NAME} local run ${envName} <job-name> [options]\n       ${BIN_NAME} local run ${envName} -i`);
+		process.exit(1);
+	}
+	/**
+	* Rewrite process.argv so runJob sees the job name as the first positional
+	* argument, followed by any job-specific flags.
+	*/
+	process.argv = [
+		process.argv[0],
+		process.argv[1],
+		jobNameFromArgs,
+		...jobFlags
+	];
+	const commandPrefix = `${BIN_NAME} local run ${envName}`;
+	await runJob({
+		jobsDirectory,
+		initialize: config.initialize,
+		logger: config.logger,
+		commandPrefix
+	});
+}
+async function handleCloudDeploy(options) {
+	const { config, envConfig } = options;
+	const cloud = config.cloud;
+	if (!cloud) {
+		consola.error("No cloud configuration found in runner config.\nAdd a `cloud` section to your job-runner.config.ts");
+		process.exit(1);
+	}
+	const { imageUri } = await deploy({
+		cloud,
+		envConfig,
+		serviceDirectory: process.cwd()
+	});
+	consola.info(`Image: ${imageUri}`);
+	consola.success("Deploy complete");
+}
+async function handleCloudRun(options) {
+	const { config, envConfig, jobsDirectory, jobNameFromArgs, jobFlags, isInteractive, isAsync } = options;
+	const cloud = config.cloud;
+	if (!cloud) {
+		consola.error("No cloud configuration found in runner config.\nAdd a `cloud` section to your job-runner.config.ts");
+		process.exit(1);
+	}
+	const serviceDirectory = process.cwd();
+	/** Determine job name and argv */
+	let jobArgv;
+	if (isInteractive) jobArgv = (await resolveInteractiveJob(jobsDirectory)).jobArgv;
+	else {
+		if (!jobNameFromArgs) {
+			consola.error(`No job name specified.\n\nUsage: ${BIN_NAME} cloud run <env> <job-name> [options]\n       ${BIN_NAME} cloud run <env> -i`);
+			process.exit(1);
+		}
+		jobArgv = [jobNameFromArgs, ...jobFlags];
+	}
+	/** Auto-deploy if changed */
+	const { imageUri } = await deployIfChanged({
+		cloud,
+		envConfig,
+		serviceDirectory
+	});
+	consola.info(`Image: ${imageUri}`);
+	/** Execute the Cloud Run Job */
+	await execute({
+		cloud,
+		project: envConfig.project,
+		jobArgv,
+		async: isAsync
+	});
+}
+/**
+* Interactively select a job and prompt for arguments.
+* Returns the job name and the complete jobArgv array.
+*/
+async function resolveInteractiveJob(jobsDirectory) {
+	const jobName = await selectJob(jobsDirectory);
+	consola.info(`Selected job: ${jobName}`);
+	/**
+	* Set console-friendly env vars before importing the module, since
+	* importing may initialize a structured logger like pino.
+	*/
+	process.env.USE_CONSOLE_LOG ??= "true";
+	process.env.LOG_COLORIZE ??= "true";
+	const parts = jobName.split("/");
+	const fileName = parts.pop() ?? "";
+	const subDirectories = parts;
+	const fileLocation = path.join(jobsDirectory, ...subDirectories);
+	const modulePath = path.resolve(fileLocation, `${fileName}.mjs`);
+	let schema;
+	try {
+		schema = (await import(modulePath)).default?.__metadata?.schema;
+	} catch {}
+	/** Prompt for arguments if schema exists */
+	let args = {};
+	if (schema && Object.keys(schema.shape).length > 0) {
+		consola.info("Enter arguments for the job:");
+		args = await promptForArgs(schema);
+	}
+	const jobArgv = [jobName];
+	if (Object.keys(args).length > 0) jobArgv.push("--args", JSON.stringify(args));
+	return {
+		jobName,
+		jobArgv
+	};
+}
+/**
+* Run the build command to compile workspace dependencies.
+* Shows a spinner and hides output unless the build fails.
+*/
+function runBuild(command) {
+	consola.start("Building jobs source code...");
+	try {
+		execSync(command, {
+			stdio: "pipe",
+			encoding: "utf-8"
+		});
+		consola.success("Build complete");
+	} catch (error) {
+		consola.fail("Build failed");
+		/** Show the build output on failure */
+		if (error && typeof error === "object" && "stdout" in error) {
+			const stdout = error.stdout;
+			if (stdout) consola.log(stdout);
+		}
+		if (error && typeof error === "object" && "stderr" in error) {
+			const stderr = error.stderr;
+			if (stderr) consola.log(stderr);
+		}
+		process.exit(1);
+	}
+}
+await main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { execSync } from \"node:child_process\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { consola } from \"consola\";\nimport type { ZodObject, ZodRawShape } from \"zod\";\nimport type { RunnerConfig } from \"./config\";\nimport { deploy, deployIfChanged } from \"./cloud/deploy\";\nimport { execute } from \"./cloud/execute\";\nimport { discoverJobs } from \"./discover-jobs\";\nimport { promptForArgs, selectJob } from \"./interactive\";\nimport { runJob } from \"./run-job\";\nimport { getSecrets } from \"./secrets\";\nimport type { JobFunction } from \"./types\";\n\nconst BIN_NAME = \"job\";\nconst CONFIG_FILE = \"job-runner.config.ts\";\nconst DEFAULT_BUILD_COMMAND = \"turbo build\";\nconst DEFAULT_JOBS_DIRECTORY = \"dist/jobs\";\n\nconst USAGE = `Usage: ${BIN_NAME} local run <env> <job-name> [options]\n       ${BIN_NAME} cloud run <env> <job-name> [options]\n       ${BIN_NAME} cloud deploy <env>\n       ${BIN_NAME} --list`;\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2);\n\n  /** Extract flags from anywhere in args */\n  const noBuild = args.includes(\"--no-build\");\n  const isInteractive = args.includes(\"--interactive\") || args.includes(\"-i\");\n  const isAsync = args.includes(\"--async\");\n\n  const configPath = path.resolve(process.cwd(), CONFIG_FILE);\n\n  /** Load config directly (config should only depend on gcp-job-runner) */\n  let config: RunnerConfig;\n  try {\n    const module = (await import(configPath)) as { default: RunnerConfig };\n    config = module.default;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    consola.error(\n      `Failed to load runner config from ${configPath}\\n${message}`,\n    );\n    process.exit(1);\n  }\n\n  /** Resolve jobs directory with default */\n  const jobsDirectory =\n    config.jobsDirectory ?? path.resolve(process.cwd(), DEFAULT_JOBS_DIRECTORY);\n\n  const envNames = Object.keys(config.environments);\n\n  /** Handle --list: discover and print all available jobs */\n  if (args.includes(\"--list\")) {\n    if (!noBuild && config.buildCommand !== false) {\n      const buildCommand = config.buildCommand ?? DEFAULT_BUILD_COMMAND;\n      runBuild(buildCommand);\n    }\n\n    const jobs = await discoverJobs(jobsDirectory);\n    if (jobs.length === 0) {\n      consola.info(\"No jobs found.\");\n    } else {\n      consola.info(\"Available jobs:\");\n      for (const job of jobs) {\n        consola.log(`  ${job.name}`);\n      }\n    }\n    return;\n  }\n\n  /** Parse positional arguments */\n  const positionals = args.filter((arg) => !arg.startsWith(\"-\"));\n\n  const mode = positionals[0];\n  if (mode !== \"local\" && mode !== \"cloud\") {\n    consola.error(\n      `Unknown or missing mode \"${mode ?? \"\"}\".\\n\\n` +\n        `${USAGE}\\n\\n` +\n        `Environments: ${envNames.join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  const action = positionals[1];\n  if (mode === \"cloud\" && action !== \"run\" && action !== \"deploy\") {\n    consola.error(\n      `Unknown or missing action \"${action ?? \"\"}\" for cloud mode.\\n\\n` + USAGE,\n    );\n    process.exit(1);\n  }\n  if (mode === \"local\" && action !== \"run\") {\n    consola.error(\n      `Unknown or missing action \"${action ?? \"\"}\" for local mode.\\n\\n` + USAGE,\n    );\n    process.exit(1);\n  }\n\n  const envName = positionals[2];\n  if (!envName) {\n    consola.error(\n      `No environment specified.\\n\\n` +\n        `${USAGE}\\n\\n` +\n        `Environments: ${envNames.join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  if (!envNames.includes(envName)) {\n    consola.error(\n      `Unknown environment \"${envName}\".\\n\\n` +\n        `Available environments: ${envNames.join(\", \")}`,\n    );\n    process.exit(1);\n  }\n\n  const envConfig = config.environments[envName]!;\n\n  /**\n   * Remaining positionals after env become the job name/path. For example\n   * `job cloud run stag test/countdown` -> positionals[3] = \"test/countdown\".\n   */\n  const jobNameFromArgs = positionals[3];\n\n  /**\n   * Collect job flags: everything after `<env>` in the original args that\n   * isn't a consumed positional or a known global flag.\n   */\n  const consumedPositionals = new Set(\n    [mode, action, envName, jobNameFromArgs].filter(Boolean),\n  );\n  const globalFlags = new Set([\n    \"--no-build\",\n    \"--interactive\",\n    \"-i\",\n    \"--async\",\n    \"--list\",\n  ]);\n\n  const envIndex = args.indexOf(envName);\n  const jobFlags = args\n    .slice(envIndex + 1)\n    .filter((arg) => !consumedPositionals.has(arg) && !globalFlags.has(arg));\n\n  /** Build unless skipped */\n  if (!noBuild && config.buildCommand !== false) {\n    const buildCommand = config.buildCommand ?? DEFAULT_BUILD_COMMAND;\n    runBuild(buildCommand);\n  }\n\n  if (mode === \"local\") {\n    await handleLocalRun({\n      config,\n      envName,\n      envConfig,\n      jobsDirectory,\n      jobNameFromArgs,\n      jobFlags,\n      isInteractive,\n    });\n  } else if (action === \"deploy\") {\n    await handleCloudDeploy({ config, envConfig });\n  } else {\n    await handleCloudRun({\n      config,\n      envConfig,\n      jobsDirectory,\n      jobNameFromArgs,\n      jobFlags,\n      isInteractive,\n      isAsync,\n    });\n  }\n}\n\ninterface LocalRunOptions {\n  config: RunnerConfig;\n  envName: string;\n  envConfig: RunnerConfig[\"environments\"][string];\n  jobsDirectory: string;\n  jobNameFromArgs: string | undefined;\n  jobFlags: string[];\n  isInteractive: boolean;\n}\n\nasync function handleLocalRun(options: LocalRunOptions): Promise<void> {\n  const {\n    config,\n    envName,\n    envConfig,\n    jobsDirectory,\n    jobNameFromArgs,\n    jobFlags,\n    isInteractive,\n  } = options;\n\n  /** Set environment variables for local execution */\n  process.env.GOOGLE_CLOUD_PROJECT = envConfig.project;\n  process.env.USE_CONSOLE_LOG ??= \"true\";\n  process.env.LOG_COLORIZE ??= \"true\";\n\n  if (envConfig.env) {\n    for (const [key, value] of Object.entries(envConfig.env)) {\n      process.env[key] = value;\n    }\n  }\n\n  if (envConfig.secrets && envConfig.secrets.length > 0) {\n    const secrets = await getSecrets(envConfig.secrets);\n    for (const [key, value] of Object.entries(secrets)) {\n      process.env[key] = value;\n    }\n  }\n\n  if (isInteractive) {\n    const { jobArgv } = await resolveInteractiveJob(jobsDirectory);\n\n    process.argv = [process.argv[0]!, process.argv[1]!, ...jobArgv];\n\n    const commandPrefix = `${BIN_NAME} local run ${envName}`;\n\n    await runJob({\n      jobsDirectory,\n      initialize: config.initialize,\n      logger: config.logger,\n      commandPrefix,\n    });\n    return;\n  }\n\n  if (!jobNameFromArgs) {\n    consola.error(\n      `No job name specified.\\n\\n` +\n        `Usage: ${BIN_NAME} local run ${envName} <job-name> [options]\\n` +\n        `       ${BIN_NAME} local run ${envName} -i`,\n    );\n    process.exit(1);\n  }\n\n  /**\n   * Rewrite process.argv so runJob sees the job name as the first positional\n   * argument, followed by any job-specific flags.\n   */\n  process.argv = [\n    process.argv[0]!,\n    process.argv[1]!,\n    jobNameFromArgs,\n    ...jobFlags,\n  ];\n\n  const commandPrefix = `${BIN_NAME} local run ${envName}`;\n\n  await runJob({\n    jobsDirectory,\n    initialize: config.initialize,\n    logger: config.logger,\n    commandPrefix,\n  });\n}\n\ninterface CloudDeployOptions {\n  config: RunnerConfig;\n  envConfig: RunnerConfig[\"environments\"][string];\n}\n\nasync function handleCloudDeploy(options: CloudDeployOptions): Promise<void> {\n  const { config, envConfig } = options;\n  const cloud = config.cloud;\n\n  if (!cloud) {\n    consola.error(\n      \"No cloud configuration found in runner config.\\n\" +\n        \"Add a `cloud` section to your job-runner.config.ts\",\n    );\n    process.exit(1);\n  }\n\n  const serviceDirectory = process.cwd();\n\n  const { imageUri } = await deploy({\n    cloud,\n    envConfig,\n    serviceDirectory,\n  });\n\n  consola.info(`Image: ${imageUri}`);\n  consola.success(\"Deploy complete\");\n}\n\ninterface CloudRunOptions {\n  config: RunnerConfig;\n  envConfig: RunnerConfig[\"environments\"][string];\n  jobsDirectory: string;\n  jobNameFromArgs: string | undefined;\n  jobFlags: string[];\n  isInteractive: boolean;\n  isAsync: boolean;\n}\n\nasync function handleCloudRun(options: CloudRunOptions): Promise<void> {\n  const {\n    config,\n    envConfig,\n    jobsDirectory,\n    jobNameFromArgs,\n    jobFlags,\n    isInteractive,\n    isAsync,\n  } = options;\n\n  const cloud = config.cloud;\n\n  if (!cloud) {\n    consola.error(\n      \"No cloud configuration found in runner config.\\n\" +\n        \"Add a `cloud` section to your job-runner.config.ts\",\n    );\n    process.exit(1);\n  }\n\n  const serviceDirectory = process.cwd();\n\n  /** Determine job name and argv */\n  let jobArgv: string[];\n\n  if (isInteractive) {\n    const result = await resolveInteractiveJob(jobsDirectory);\n    jobArgv = result.jobArgv;\n  } else {\n    if (!jobNameFromArgs) {\n      consola.error(\n        `No job name specified.\\n\\n` +\n          `Usage: ${BIN_NAME} cloud run <env> <job-name> [options]\\n` +\n          `       ${BIN_NAME} cloud run <env> -i`,\n      );\n      process.exit(1);\n    }\n    jobArgv = [jobNameFromArgs, ...jobFlags];\n  }\n\n  /** Auto-deploy if changed */\n  const { imageUri } = await deployIfChanged({\n    cloud,\n    envConfig,\n    serviceDirectory,\n  });\n\n  consola.info(`Image: ${imageUri}`);\n\n  /** Execute the Cloud Run Job */\n  await execute({\n    cloud,\n    project: envConfig.project,\n    jobArgv,\n    async: isAsync,\n  });\n}\n\n/**\n * Interactively select a job and prompt for arguments.\n * Returns the job name and the complete jobArgv array.\n */\nasync function resolveInteractiveJob(\n  jobsDirectory: string,\n): Promise<{ jobName: string; jobArgv: string[] }> {\n  const jobName = await selectJob(jobsDirectory);\n\n  consola.info(`Selected job: ${jobName}`);\n\n  /**\n   * Set console-friendly env vars before importing the module, since\n   * importing may initialize a structured logger like pino.\n   */\n  process.env.USE_CONSOLE_LOG ??= \"true\";\n  process.env.LOG_COLORIZE ??= \"true\";\n\n  const parts = jobName.split(\"/\");\n  const fileName = parts.pop() ?? \"\";\n  const subDirectories = parts;\n  const fileLocation = path.join(jobsDirectory, ...subDirectories);\n  const modulePath = path.resolve(fileLocation, `${fileName}.mjs`);\n\n  let schema: ZodObject<ZodRawShape> | undefined;\n  try {\n    const moduleObject = (await import(modulePath)) as Record<string, unknown>;\n    const fn = moduleObject.default as JobFunction | undefined;\n    schema = fn?.__metadata?.schema;\n  } catch {\n    /** Module might not exist yet or have errors - proceed without schema */\n  }\n\n  /** Prompt for arguments if schema exists */\n  let args: Record<string, unknown> = {};\n  if (schema && Object.keys(schema.shape).length > 0) {\n    consola.info(\"Enter arguments for the job:\");\n    args = await promptForArgs(schema);\n  }\n\n  const jobArgv = [jobName];\n  if (Object.keys(args).length > 0) {\n    jobArgv.push(\"--args\", JSON.stringify(args));\n  }\n\n  return { jobName, jobArgv };\n}\n\n/**\n * Run the build command to compile workspace dependencies.\n * Shows a spinner and hides output unless the build fails.\n */\nfunction runBuild(command: string): void {\n  consola.start(\"Building jobs source code...\");\n\n  try {\n    execSync(command, {\n      stdio: \"pipe\",\n      encoding: \"utf-8\",\n    });\n    consola.success(\"Build complete\");\n  } catch (error) {\n    consola.fail(\"Build failed\");\n\n    /** Show the build output on failure */\n    if (error && typeof error === \"object\" && \"stdout\" in error) {\n      const stdout = (error as { stdout?: string }).stdout;\n      if (stdout) {\n        consola.log(stdout);\n      }\n    }\n    if (error && typeof error === \"object\" && \"stderr\" in error) {\n      const stderr = (error as { stderr?: string }).stderr;\n      if (stderr) {\n        consola.log(stderr);\n      }\n    }\n\n    process.exit(1);\n  }\n}\n\nawait main();\n"],"mappings":"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"}

package/dist/cloud/deploy.mjs

@@ -0,0 +1,285 @@
+import { generateDockerfile } from "./dockerfile.mjs";
+import { checkGcloudAvailable, gcloudExec, gcloudExecCapture, gcloudJson, isDockerAvailable, shellExecCapture } from "./gcloud.mjs";
+import { hashDirectory } from "./hash.mjs";
+import { consola } from "consola";
+import path from "node:path";
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+
+//#region src/cloud/deploy.ts
+const DEFAULT_REGION = "us-central1";
+const DEFAULT_ARTIFACT_REGISTRY = "cloud-run";
+const DEFAULT_ISOLATE_PATH = "isolate";
+const GENERATED_DOCKERFILE = "Dockerfile";
+const REGISTRY = "docker.pkg.dev";
+/**
+* Resolve the isolate output directory path.
+* Reads isolate.config.json if present, otherwise uses default "./isolate".
+*/
+function resolveIsolateDirectory(serviceDirectory) {
+	const configPath = path.join(serviceDirectory, "isolate.config.json");
+	if (existsSync(configPath)) try {
+		const configContent = readFileSync(configPath, "utf-8");
+		const config = JSON.parse(configContent);
+		if (config.targetPackagePath) return path.join(serviceDirectory, config.targetPackagePath);
+	} catch {}
+	return path.join(serviceDirectory, DEFAULT_ISOLATE_PATH);
+}
+/**
+* Shared preparation logic: isolate, hash, check image, build if needed.
+* Used by both deploy() and deployIfChanged().
+*/
+async function prepareImage(options) {
+	const { cloud, envConfig, serviceDirectory } = options;
+	const region = cloud.region ?? DEFAULT_REGION;
+	const artifactRegistry = cloud.artifactRegistry ?? DEFAULT_ARTIFACT_REGISTRY;
+	const project = envConfig.project;
+	let buildLocal = cloud.buildLocal !== false;
+	checkGcloudAvailable();
+	if (buildLocal && !isDockerAvailable()) {
+		consola.warn("Docker is not available, falling back to Cloud Build. Install Docker for faster local builds: https://docs.docker.com/get-docker/");
+		buildLocal = false;
+	}
+	/** Step 1: Run isolate to bundle workspace dependencies */
+	const isolateDirectory = resolveIsolateDirectory(serviceDirectory);
+	consola.start("Isolating package...");
+	try {
+		const { isolate: runIsolate } = await import("isolate-package");
+		const configPath = path.join(serviceDirectory, "isolate.config.json");
+		await runIsolate({
+			...existsSync(configPath) ? JSON.parse(readFileSync(configPath, "utf-8")) : {},
+			includeDevDependencies: true
+		});
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		consola.error(`Failed to isolate package: ${message}`);
+		process.exit(1);
+	}
+	consola.success("Package isolated");
+	/** Step 2: Hash the isolate directory */
+	const tag = await hashDirectory(isolateDirectory);
+	consola.info(`Content hash: ${tag}`);
+	/** Step 3: Check if image already exists */
+	const imageUri = `${region}-${REGISTRY}/${project}/${artifactRegistry}/${cloud.name}:${tag}`;
+	const imageExists = checkImageExists(imageUri, project);
+	let imageBuilt = false;
+	if (imageExists) consola.success(`Image already exists: ${cloud.name}:${tag}`);
+	else if (buildLocal) {
+		/** Step 4a: Generate Dockerfile and build locally with Docker */
+		consola.start("Building image locally with Docker...");
+		const dockerfilePath = path.join(serviceDirectory, GENERATED_DOCKERFILE);
+		writeFileSync(dockerfilePath, generateDockerfile());
+		try {
+			const buildResult = shellExecCapture(`docker build --platform linux/amd64 -t ${imageUri} .`, { cwd: serviceDirectory });
+			if (!buildResult.success) {
+				consola.error("Docker build failed. Output:\n" + buildResult.output);
+				process.exit(1);
+			}
+			consola.success(`Image built: ${cloud.name}:${tag}`);
+			/** Configure Docker authentication for Artifact Registry */
+			gcloudExecCapture([
+				"auth",
+				"configure-docker",
+				`${region}-${REGISTRY}`,
+				"--quiet"
+			]);
+			consola.start("Pushing image to Artifact Registry...");
+			const pushResult = shellExecCapture(`docker push ${imageUri}`);
+			if (!pushResult.success) {
+				consola.error("Docker push failed. Output:\n" + pushResult.output);
+				process.exit(1);
+			}
+			consola.success(`Image pushed: ${cloud.name}:${tag}`);
+			imageBuilt = true;
+		} finally {
+			/** Clean up generated Dockerfile */
+			try {
+				unlinkSync(dockerfilePath);
+			} catch {}
+		}
+	} else {
+		/** Step 4b: Generate Dockerfile and build with Cloud Build */
+		consola.start("Building image with Cloud Build...");
+		const dockerfilePath = path.join(serviceDirectory, GENERATED_DOCKERFILE);
+		writeFileSync(dockerfilePath, generateDockerfile());
+		try {
+			const buildResult = gcloudExecCapture([
+				"builds",
+				"submit",
+				"--project",
+				project,
+				"--region",
+				region,
+				`--tag=${imageUri}`,
+				"."
+			], { cwd: serviceDirectory });
+			/** Extract and show the Cloud Build logs URL if available */
+			const logsUrlMatch = buildResult.output.match(/Logs are available at \[(.+?)]/);
+			if (logsUrlMatch) consola.info(`Cloud Build logs: ${logsUrlMatch[1]}`);
+			if (!buildResult.success) {
+				consola.error("Cloud Build failed. Output:\n" + buildResult.output);
+				process.exit(1);
+			}
+			consola.success(`Image built: ${cloud.name}:${tag}`);
+			imageBuilt = true;
+		} finally {
+			/** Clean up generated Dockerfile */
+			try {
+				unlinkSync(dockerfilePath);
+			} catch {}
+		}
+	}
+	return {
+		imageUri,
+		imageBuilt,
+		region,
+		project
+	};
+}
+/**
+* Build and deploy a Cloud Run Job image.
+*
+* Always creates or updates the Cloud Run Job resource, regardless of whether
+* the image changed. Use deployIfChanged() to skip when unchanged.
+*/
+async function deploy(options) {
+	const { imageUri, imageBuilt, region, project } = await prepareImage(options);
+	return {
+		imageUri,
+		imageBuilt,
+		jobCreated: await createOrUpdateJob({
+			cloud: options.cloud,
+			envConfig: options.envConfig,
+			imageUri,
+			region,
+			project
+		})
+	};
+}
+/**
+* Build and conditionally deploy a Cloud Run Job image.
+*
+* Only creates/updates the Cloud Run Job when the image has changed.
+* When the image already exists, skips both the Docker build and the
+* createOrUpdateJob step.
+*/
+async function deployIfChanged(options) {
+	const { imageUri, imageBuilt, region, project } = await prepareImage(options);
+	if (!imageBuilt) {
+		consola.info("No changes detected, skipping deploy");
+		return {
+			imageUri,
+			imageBuilt: false,
+			jobCreated: false
+		};
+	}
+	consola.info("Changes detected, deploying...");
+	return {
+		imageUri,
+		imageBuilt,
+		jobCreated: await createOrUpdateJob({
+			cloud: options.cloud,
+			envConfig: options.envConfig,
+			imageUri,
+			region,
+			project
+		})
+	};
+}
+/**
+* Create or update a Cloud Run Job resource.
+* Returns true if the job was newly created, false if updated.
+*/
+async function createOrUpdateJob(options) {
+	const { cloud, envConfig, imageUri, region, project } = options;
+	const memory = cloud.resources?.memory ?? "512Mi";
+	const cpu = cloud.resources?.cpu ?? "1";
+	const timeout = cloud.resources?.timeout ?? 3600;
+	/** Check if job already exists */
+	const existingJob = gcloudJson([
+		"run",
+		"jobs",
+		"describe",
+		cloud.name,
+		"--project",
+		project,
+		"--region",
+		region
+	], { ignoreErrors: true });
+	/** Build environment variables */
+	const envVars = {
+		GOOGLE_CLOUD_PROJECT: project,
+		...envConfig.env
+	};
+	const envVarsString = Object.entries(envVars).map(([key, value]) => `${key}=${value}`).join(",");
+	const secretsString = (envConfig.secrets ?? []).map((name) => `${name}=${name}:latest`).join(",");
+	if (existingJob) {
+		consola.start("Updating Cloud Run Job...");
+		const updateArgs = [
+			"run",
+			"jobs",
+			"update",
+			cloud.name,
+			"--project",
+			project,
+			"--region",
+			region,
+			`--image=${imageUri}`,
+			`--set-env-vars=${envVarsString}`,
+			`--memory=${memory}`,
+			`--cpu=${cpu}`,
+			`--task-timeout=${timeout}s`,
+			"--max-retries=0"
+		];
+		if (secretsString) updateArgs.push(`--set-secrets=${secretsString}`);
+		if (cloud.serviceAccount) updateArgs.push(`--service-account=${cloud.serviceAccount}`);
+		if (!gcloudExec(updateArgs)) {
+			consola.error("Failed to update Cloud Run Job");
+			process.exit(1);
+		}
+		consola.success(`Cloud Run Job updated: ${cloud.name}`);
+		return false;
+	}
+	consola.start("Creating Cloud Run Job...");
+	const createArgs = [
+		"run",
+		"jobs",
+		"create",
+		cloud.name,
+		"--project",
+		project,
+		"--region",
+		region,
+		`--image=${imageUri}`,
+		`--set-env-vars=${envVarsString}`,
+		`--memory=${memory}`,
+		`--cpu=${cpu}`,
+		`--task-timeout=${timeout}s`,
+		"--max-retries=0"
+	];
+	if (secretsString) createArgs.push(`--set-secrets=${secretsString}`);
+	if (cloud.serviceAccount) createArgs.push(`--service-account=${cloud.serviceAccount}`);
+	if (!gcloudExec(createArgs)) {
+		consola.error("Failed to create Cloud Run Job");
+		process.exit(1);
+	}
+	consola.success(`Cloud Run Job created: ${cloud.name}`);
+	return true;
+}
+/**
+* Check if a Docker image exists in Artifact Registry.
+*/
+function checkImageExists(imageUri, project) {
+	return gcloudJson([
+		"artifacts",
+		"docker",
+		"images",
+		"describe",
+		imageUri,
+		"--project",
+		project
+	], { ignoreErrors: true }) !== void 0;
+}
+
+//#endregion
+export { deploy, deployIfChanged };
+//# sourceMappingURL=deploy.mjs.map

package/dist/cloud/deploy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.mjs","names":[],"sources":["../../src/cloud/deploy.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync, unlinkSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { consola } from \"consola\";\nimport type { CloudConfig, RunnerEnvOptions } from \"../config\";\nimport { generateDockerfile } from \"./dockerfile\";\nimport {\n  checkGcloudAvailable,\n  isDockerAvailable,\n  gcloudExec,\n  gcloudExecCapture,\n  gcloudJson,\n  shellExecCapture,\n} from \"./gcloud\";\nimport { hashDirectory } from \"./hash\";\n\nexport interface DeployOptions {\n  /** Cloud configuration from the runner config */\n  cloud: CloudConfig;\n  /** Environment configuration (project, env vars, secrets) */\n  envConfig: RunnerEnvOptions;\n  /** Working directory (service root where isolate.config.json lives) */\n  serviceDirectory: string;\n}\n\nexport interface DeployResult {\n  /** Full image URI including tag */\n  imageUri: string;\n  /** Whether a new image was built */\n  imageBuilt: boolean;\n  /** Whether the Cloud Run Job was created or updated */\n  jobCreated: boolean;\n}\n\nconst DEFAULT_REGION = \"us-central1\";\nconst DEFAULT_ARTIFACT_REGISTRY = \"cloud-run\";\nconst DEFAULT_ISOLATE_PATH = \"isolate\";\nconst GENERATED_DOCKERFILE = \"Dockerfile\";\nconst REGISTRY = \"docker.pkg.dev\";\n\ninterface IsolateConfig {\n  targetPackagePath?: string;\n}\n\n/**\n * Resolve the isolate output directory path.\n * Reads isolate.config.json if present, otherwise uses default \"./isolate\".\n */\nfunction resolveIsolateDirectory(serviceDirectory: string): string {\n  const configPath = path.join(serviceDirectory, \"isolate.config.json\");\n\n  if (existsSync(configPath)) {\n    try {\n      const configContent = readFileSync(configPath, \"utf-8\");\n      const config = JSON.parse(configContent) as IsolateConfig;\n      if (config.targetPackagePath) {\n        return path.join(serviceDirectory, config.targetPackagePath);\n      }\n    } catch {\n      /** Ignore parse errors, use default */\n    }\n  }\n\n  return path.join(serviceDirectory, DEFAULT_ISOLATE_PATH);\n}\n\ninterface PrepareResult {\n  imageUri: string;\n  imageBuilt: boolean;\n  region: string;\n  project: string;\n}\n\n/**\n * Shared preparation logic: isolate, hash, check image, build if needed.\n * Used by both deploy() and deployIfChanged().\n */\nasync function prepareImage(options: DeployOptions): Promise<PrepareResult> {\n  const { cloud, envConfig, serviceDirectory } = options;\n  const region = cloud.region ?? DEFAULT_REGION;\n  const artifactRegistry = cloud.artifactRegistry ?? DEFAULT_ARTIFACT_REGISTRY;\n  const project = envConfig.project;\n  let buildLocal = cloud.buildLocal !== false;\n\n  checkGcloudAvailable();\n\n  if (buildLocal && !isDockerAvailable()) {\n    consola.warn(\n      \"Docker is not available, falling back to Cloud Build. \" +\n        \"Install Docker for faster local builds: https://docs.docker.com/get-docker/\",\n    );\n    buildLocal = false;\n  }\n\n  /** Step 1: Run isolate to bundle workspace dependencies */\n  const isolateDirectory = resolveIsolateDirectory(serviceDirectory);\n\n  consola.start(\"Isolating package...\");\n\n  try {\n    const { isolate: runIsolate } = await import(\"isolate-package\");\n\n    const configPath = path.join(serviceDirectory, \"isolate.config.json\");\n    const fileConfig = existsSync(configPath)\n      ? JSON.parse(readFileSync(configPath, \"utf-8\"))\n      : {};\n\n    await runIsolate({\n      ...fileConfig,\n      includeDevDependencies: true,\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    consola.error(`Failed to isolate package: ${message}`);\n    process.exit(1);\n  }\n\n  consola.success(\"Package isolated\");\n\n  /** Step 2: Hash the isolate directory */\n  const tag = await hashDirectory(isolateDirectory);\n  consola.info(`Content hash: ${tag}`);\n\n  /** Step 3: Check if image already exists */\n  const imageUri = `${region}-${REGISTRY}/${project}/${artifactRegistry}/${cloud.name}:${tag}`;\n\n  const imageExists = checkImageExists(imageUri, project);\n  let imageBuilt = false;\n\n  if (imageExists) {\n    consola.success(`Image already exists: ${cloud.name}:${tag}`);\n  } else if (buildLocal) {\n    /** Step 4a: Generate Dockerfile and build locally with Docker */\n    consola.start(\"Building image locally with Docker...\");\n\n    const dockerfilePath = path.join(serviceDirectory, GENERATED_DOCKERFILE);\n    writeFileSync(dockerfilePath, generateDockerfile());\n\n    try {\n      const buildResult = shellExecCapture(\n        `docker build --platform linux/amd64 -t ${imageUri} .`,\n        { cwd: serviceDirectory },\n      );\n\n      if (!buildResult.success) {\n        consola.error(\"Docker build failed. Output:\\n\" + buildResult.output);\n        process.exit(1);\n      }\n\n      consola.success(`Image built: ${cloud.name}:${tag}`);\n\n      /** Configure Docker authentication for Artifact Registry */\n      gcloudExecCapture([\n        \"auth\",\n        \"configure-docker\",\n        `${region}-${REGISTRY}`,\n        \"--quiet\",\n      ]);\n\n      consola.start(\"Pushing image to Artifact Registry...\");\n\n      const pushResult = shellExecCapture(`docker push ${imageUri}`);\n\n      if (!pushResult.success) {\n        consola.error(\"Docker push failed. Output:\\n\" + pushResult.output);\n        process.exit(1);\n      }\n\n      consola.success(`Image pushed: ${cloud.name}:${tag}`);\n      imageBuilt = true;\n    } finally {\n      /** Clean up generated Dockerfile */\n      try {\n        unlinkSync(dockerfilePath);\n      } catch {\n        /** Ignore cleanup errors */\n      }\n    }\n  } else {\n    /** Step 4b: Generate Dockerfile and build with Cloud Build */\n    consola.start(\"Building image with Cloud Build...\");\n\n    const dockerfilePath = path.join(serviceDirectory, GENERATED_DOCKERFILE);\n    writeFileSync(dockerfilePath, generateDockerfile());\n\n    try {\n      const buildResult = gcloudExecCapture(\n        [\n          \"builds\",\n          \"submit\",\n          \"--project\",\n          project,\n          \"--region\",\n          region,\n          `--tag=${imageUri}`,\n          \".\",\n        ],\n        { cwd: serviceDirectory },\n      );\n\n      /** Extract and show the Cloud Build logs URL if available */\n      const logsUrlMatch = buildResult.output.match(\n        /Logs are available at \\[(.+?)]/,\n      );\n      if (logsUrlMatch) {\n        consola.info(`Cloud Build logs: ${logsUrlMatch[1]}`);\n      }\n\n      if (!buildResult.success) {\n        consola.error(\"Cloud Build failed. Output:\\n\" + buildResult.output);\n        process.exit(1);\n      }\n\n      consola.success(`Image built: ${cloud.name}:${tag}`);\n      imageBuilt = true;\n    } finally {\n      /** Clean up generated Dockerfile */\n      try {\n        unlinkSync(dockerfilePath);\n      } catch {\n        /** Ignore cleanup errors */\n      }\n    }\n  }\n\n  return { imageUri, imageBuilt, region, project };\n}\n\n/**\n * Build and deploy a Cloud Run Job image.\n *\n * Always creates or updates the Cloud Run Job resource, regardless of whether\n * the image changed. Use deployIfChanged() to skip when unchanged.\n */\nexport async function deploy(options: DeployOptions): Promise<DeployResult> {\n  const { imageUri, imageBuilt, region, project } = await prepareImage(options);\n\n  /** Always create or update the Cloud Run Job */\n  const jobCreated = await createOrUpdateJob({\n    cloud: options.cloud,\n    envConfig: options.envConfig,\n    imageUri,\n    region,\n    project,\n  });\n\n  return { imageUri, imageBuilt, jobCreated };\n}\n\n/**\n * Build and conditionally deploy a Cloud Run Job image.\n *\n * Only creates/updates the Cloud Run Job when the image has changed.\n * When the image already exists, skips both the Docker build and the\n * createOrUpdateJob step.\n */\nexport async function deployIfChanged(\n  options: DeployOptions,\n): Promise<DeployResult> {\n  const { imageUri, imageBuilt, region, project } = await prepareImage(options);\n\n  if (!imageBuilt) {\n    consola.info(\"No changes detected, skipping deploy\");\n    return { imageUri, imageBuilt: false, jobCreated: false };\n  }\n\n  consola.info(\"Changes detected, deploying...\");\n\n  const jobCreated = await createOrUpdateJob({\n    cloud: options.cloud,\n    envConfig: options.envConfig,\n    imageUri,\n    region,\n    project,\n  });\n\n  return { imageUri, imageBuilt, jobCreated };\n}\n\ninterface CreateOrUpdateJobOptions {\n  cloud: CloudConfig;\n  envConfig: RunnerEnvOptions;\n  imageUri: string;\n  region: string;\n  project: string;\n}\n\n/**\n * Create or update a Cloud Run Job resource.\n * Returns true if the job was newly created, false if updated.\n */\nasync function createOrUpdateJob(\n  options: CreateOrUpdateJobOptions,\n): Promise<boolean> {\n  const { cloud, envConfig, imageUri, region, project } = options;\n  const memory = cloud.resources?.memory ?? \"512Mi\";\n  const cpu = cloud.resources?.cpu ?? \"1\";\n  const timeout = cloud.resources?.timeout ?? 3600;\n\n  /** Check if job already exists */\n  const existingJob = gcloudJson(\n    [\n      \"run\",\n      \"jobs\",\n      \"describe\",\n      cloud.name,\n      \"--project\",\n      project,\n      \"--region\",\n      region,\n    ],\n    { ignoreErrors: true },\n  );\n\n  /** Build environment variables */\n  const envVars: Record<string, string> = {\n    GOOGLE_CLOUD_PROJECT: project,\n    ...envConfig.env,\n  };\n\n  const envVarsString = Object.entries(envVars)\n    .map(([key, value]) => `${key}=${value}`)\n    .join(\",\");\n\n  /** Build secret references */\n  const secretNames = envConfig.secrets ?? [];\n  const secretsString = secretNames\n    .map((name) => `${name}=${name}:latest`)\n    .join(\",\");\n\n  if (existingJob) {\n    consola.start(\"Updating Cloud Run Job...\");\n\n    const updateArgs = [\n      \"run\",\n      \"jobs\",\n      \"update\",\n      cloud.name,\n      \"--project\",\n      project,\n      \"--region\",\n      region,\n      `--image=${imageUri}`,\n      `--set-env-vars=${envVarsString}`,\n      `--memory=${memory}`,\n      `--cpu=${cpu}`,\n      `--task-timeout=${timeout}s`,\n      \"--max-retries=0\",\n    ];\n\n    if (secretsString) {\n      updateArgs.push(`--set-secrets=${secretsString}`);\n    }\n\n    if (cloud.serviceAccount) {\n      updateArgs.push(`--service-account=${cloud.serviceAccount}`);\n    }\n\n    const success = gcloudExec(updateArgs);\n\n    if (!success) {\n      consola.error(\"Failed to update Cloud Run Job\");\n      process.exit(1);\n    }\n\n    consola.success(`Cloud Run Job updated: ${cloud.name}`);\n    return false;\n  }\n\n  consola.start(\"Creating Cloud Run Job...\");\n\n  const createArgs = [\n    \"run\",\n    \"jobs\",\n    \"create\",\n    cloud.name,\n    \"--project\",\n    project,\n    \"--region\",\n    region,\n    `--image=${imageUri}`,\n    `--set-env-vars=${envVarsString}`,\n    `--memory=${memory}`,\n    `--cpu=${cpu}`,\n    `--task-timeout=${timeout}s`,\n    \"--max-retries=0\",\n  ];\n\n  if (secretsString) {\n    createArgs.push(`--set-secrets=${secretsString}`);\n  }\n\n  if (cloud.serviceAccount) {\n    createArgs.push(`--service-account=${cloud.serviceAccount}`);\n  }\n\n  const success = gcloudExec(createArgs);\n\n  if (!success) {\n    consola.error(\"Failed to create Cloud Run Job\");\n    process.exit(1);\n  }\n\n  consola.success(`Cloud Run Job created: ${cloud.name}`);\n  return true;\n}\n\n/**\n * Check if a Docker image exists in Artifact Registry.\n */\nfunction checkImageExists(imageUri: string, project: string): boolean {\n  const result = gcloudJson(\n    [\n      \"artifacts\",\n      \"docker\",\n      \"images\",\n      \"describe\",\n      imageUri,\n      \"--project\",\n      project,\n    ],\n    { ignoreErrors: true },\n  );\n\n  return result !== undefined;\n}\n"],"mappings":"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"}