@geekmidas/cli 10.0.0-alpha.64 → 10.0.0-alpha.65

package/dist/sniffer-BZ-OJO4Y.mjs

@@ -0,0 +1,2068 @@
+import { t as __exportAll } from "./rolldown-runtime-BhDjJH2R.mjs";
+import { t as LocalSandbox } from "./local-CWR4Y_kW.mjs";
+import { a as getDokployCredentials, d as storeHostingerToken, i as getCredentialsPath, l as removeDokployCredentials, u as storeDokployCredentials } from "./credentials-Dq1MnWQf.mjs";
+import { d as output, r as discover, s as nodeWithTsx } from "./discover-LMrqsWSU.mjs";
+import { i as activeSandbox } from "./sandbox-Dm247NGx.mjs";
+import { n as derivedApps } from "./derive-B4vDpzgP.mjs";
+import { o as builtinTarget } from "./define-DR8xGYfL.mjs";
+import { h as getPublicEnvPrefix, k as assertDeployedStage, s as getAppBuildOrder } from "./workspace-C06_pW4g.mjs";
+import { l as applicationName, n as secretsStoreFor, u as deployIdentity } from "./store-CLiHnqOY.mjs";
+import { D as constructGlobs } from "./state-B8YwmUZU.mjs";
+import { a as parseTargetOptions, o as resolveTarget } from "./resolve-DLkIXTct.mjs";
+import { dirname, resolve } from "node:path";
+import { stdin, stdout } from "node:process";
+import * as readline from "node:readline/promises";
+import { existsSync } from "node:fs";
+import { hostname, userInfo } from "node:os";
+import { fileURLToPath } from "node:url";
+import { createCipheriv, createHash, randomBytes, randomUUID } from "node:crypto";
+//#region src/prompt.ts
+/**
+* Asking the person at the terminal.
+*
+* CLI layer only: a command's action may prompt, nothing it calls may. A
+* library call (`deploy()`) that needs something it was not given raises a
+* named error instead, and the command decides whether to ask.
+*/
+/** A prompt was needed with no terminal to ask at. */
+var PromptNeedsTerminal = class extends Error {
+	question;
+	instead;
+	constructor(question, instead) {
+		super(`Interactive input required. ${instead}`);
+		this.question = question;
+		this.instead = instead;
+		this.name = "PromptNeedsTerminal";
+	}
+};
+/** Whether there is a person at a terminal to ask. */
+function canPrompt() {
+	return process.stdin.isTTY === true;
+}
+/**
+* Ask `message` and resolve with the line typed — without echoing it when
+* `hidden`. Ctrl+C at a hidden prompt exits, as it would anywhere else in a
+* terminal program: raw mode has taken the signal away from the shell.
+*/
+async function prompt(message, options) {
+	if (!canPrompt()) throw new PromptNeedsTerminal(message, options.instead);
+	if (options.hidden) {
+		process.stdout.write(message);
+		return new Promise((resolve, reject) => {
+			let value = "";
+			const cleanup = () => {
+				process.stdin.setRawMode(false);
+				process.stdin.pause();
+				process.stdin.removeListener("data", onData);
+				process.stdin.removeListener("error", onError);
+			};
+			const onError = (err) => {
+				cleanup();
+				reject(err);
+			};
+			const onData = (char) => {
+				const c = char.toString();
+				if (c === "\n" || c === "\r") {
+					cleanup();
+					process.stdout.write("\n");
+					resolve(value);
+				} else if (c === "") {
+					cleanup();
+					process.stdout.write("\n");
+					process.exit(1);
+				} else if (c === "" || c === "\b") {
+					if (value.length > 0) value = value.slice(0, -1);
+				} else value += c;
+			};
+			process.stdin.setRawMode(true);
+			process.stdin.resume();
+			process.stdin.on("data", onData);
+			process.stdin.on("error", onError);
+		});
+	}
+	const rl = readline.createInterface({
+		input: stdin,
+		output: stdout
+	});
+	try {
+		return await rl.question(message);
+	} finally {
+		rl.close();
+	}
+}
+//#endregion
+//#region src/auth/index.ts
+const logger = console;
+/**
+* Validate Dokploy token by making a test API call
+*/
+async function validateDokployToken(endpoint, token) {
+	const { DokployApi } = await Promise.resolve().then(() => dokploy_api_exports);
+	return new DokployApi({
+		baseUrl: endpoint,
+		token
+	}).validateToken();
+}
+/** What answers a login prompt without a terminal. */
+const LOGIN_INSTEAD = "Please provide --token option.";
+/**
+* Login to a service
+*/
+async function loginCommand(options) {
+	const { provider, token: providedToken, endpoint: providedEndpoint } = options;
+	if (provider === "dokploy") {
+		logger.log("\n🔐 Logging in to Dokploy...\n");
+		let endpoint = providedEndpoint;
+		if (!endpoint) endpoint = await prompt("Dokploy URL (e.g., https://dokploy.example.com): ", { instead: LOGIN_INSTEAD });
+		endpoint = endpoint.replace(/\/$/, "");
+		try {
+			new URL(endpoint);
+		} catch {
+			logger.error("Invalid URL format");
+			process.exit(1);
+		}
+		let token = providedToken;
+		if (!token) {
+			logger.log(`\nGenerate a token at: ${endpoint}/settings/profile\n`);
+			token = await prompt("API Token: ", {
+				hidden: true,
+				instead: LOGIN_INSTEAD
+			});
+		}
+		if (!token) {
+			logger.error("Token is required");
+			process.exit(1);
+		}
+		logger.log("\nValidating credentials...");
+		if (!await validateDokployToken(endpoint, token)) {
+			logger.error("\n✗ Invalid credentials. Please check your token and try again.");
+			process.exit(1);
+		}
+		await storeDokployCredentials(token, endpoint);
+		logger.log("\n✓ Successfully logged in to Dokploy!");
+		logger.log(`  Endpoint: ${endpoint}`);
+		logger.log(`  Credentials stored in: ${getCredentialsPath()}`);
+		logger.log("\nYou can now use deploy commands without setting DOKPLOY_API_TOKEN.");
+	}
+	if (provider === "hostinger") {
+		logger.log("\n🔐 Logging in to Hostinger...\n");
+		let token = providedToken;
+		if (!token) {
+			logger.log("\nGenerate a token at: https://hpanel.hostinger.com/profile/api\n");
+			token = await prompt("API Token: ", {
+				hidden: true,
+				instead: LOGIN_INSTEAD
+			});
+		}
+		if (!token) {
+			logger.error("Token is required");
+			process.exit(1);
+		}
+		await storeHostingerToken(token);
+		logger.log("\n✓ Hostinger token stored.");
+		logger.log(`  Credentials stored in: ${getCredentialsPath()}`);
+		logger.log("  Not validated here: every DNS endpoint is scoped to a domain, so the\n  first deploy that touches DNS is where a bad token reports itself.");
+		logger.log("\nYou can now use it as a DNS provider without setting HOSTINGER_API_TOKEN.");
+	}
+}
+/**
+* Logout from a service
+*/
+async function logoutCommand(options) {
+	const { provider = "dokploy" } = options;
+	if (provider === "all") {
+		if (await removeDokployCredentials()) logger.log("\n✓ Logged out from all services");
+		else logger.log("\nNo stored credentials found");
+		return;
+	}
+	if (provider === "dokploy") {
+		if (await removeDokployCredentials()) logger.log("\n✓ Logged out from Dokploy");
+		else logger.log("\nNo Dokploy credentials found");
+	}
+}
+/**
+* Show current login status
+*/
+async function whoamiCommand() {
+	logger.log("\n📋 Current credentials:\n");
+	const dokploy = await getDokployCredentials();
+	if (dokploy) {
+		logger.log("  Dokploy:");
+		logger.log(`    Endpoint: ${dokploy.endpoint}`);
+		logger.log(`    Token: ${maskToken(dokploy.token)}`);
+	} else logger.log("  Dokploy: Not logged in");
+	logger.log(`\n  Credentials file: ${getCredentialsPath()}`);
+}
+/**
+* Mask a token for display
+*/
+function maskToken(token) {
+	if (token.length <= 8) return "****";
+	return `${token.slice(0, 4)}...${token.slice(-4)}`;
+}
+//#endregion
+//#region src/workspace/client-generator.ts
+/**
+* Normalize routes to an array of patterns.
+* Handles a glob or a list of them.
+* @internal Exported for use in dev command
+*/
+function normalizeRoutes(routes) {
+	if (!routes) return [];
+	return Array.isArray(routes) ? routes : [routes];
+}
+//#endregion
+//#region src/secrets/encryption.ts
+var encryption_exports = /* @__PURE__ */ __exportAll({
+	encryptSecrets: () => encryptSecrets,
+	generateDefineOptions: () => generateDefineOptions,
+	keyFingerprint: () => keyFingerprint
+});
+/** AES-256-GCM configuration */
+const ALGORITHM = "aes-256-gcm";
+const KEY_LENGTH = 32;
+const IV_LENGTH = 12;
+/**
+* Encrypt secrets for embedding in a bundle.
+* Uses AES-256-GCM with a randomly generated ephemeral key.
+*
+* @param secrets - Key-value pairs to encrypt
+* @returns Encrypted payload with ephemeral master key
+*/
+function encryptSecrets(secrets) {
+	const masterKey = randomBytes(KEY_LENGTH);
+	const iv = randomBytes(IV_LENGTH);
+	const plaintext = JSON.stringify(secrets);
+	const cipher = createCipheriv(ALGORITHM, masterKey, iv);
+	const ciphertext = Buffer.concat([cipher.update(plaintext, "utf-8"), cipher.final()]);
+	const authTag = cipher.getAuthTag();
+	return {
+		encrypted: Buffer.concat([ciphertext, authTag]).toString("base64"),
+		iv: iv.toString("hex"),
+		masterKey: masterKey.toString("hex")
+	};
+}
+/**
+* Generate the define options for tsdown/esbuild.
+* These will be injected at build time.
+*/
+function generateDefineOptions(payload) {
+	return {
+		__GKM_ENCRYPTED_CREDENTIALS__: JSON.stringify(payload.encrypted),
+		__GKM_CREDENTIALS_IV__: JSON.stringify(payload.iv)
+	};
+}
+/**
+* A short, one-way name for a master key: the first 8 hex characters of its
+* SHA-256.
+*
+* Printed where the key itself used to be, so a person can tell which key a
+* build used — and match it against the one they hold — without the output
+* carrying a value that decrypts every secret of the stage.
+*/
+function keyFingerprint(masterKey) {
+	return createHash("sha256").update(masterKey).digest("hex").slice(0, 8);
+}
+//#endregion
+//#region src/target/secrets.ts
+/**
+* A stage's secrets as a target sees them: read and written through the
+* stage's own store, and masked in everything the run prints once read.
+*/
+/**
+* Shorter values are left alone: what a progress line legitimately prints —
+* a port, a stage, an app name — would otherwise come out as `***` wherever
+* a secret happened to share it.
+*/
+const SHORTEST_MASKED = 6;
+/** The values a run must never print, and the rewrite that keeps it so. */
+var Redactor = class {
+	values = /* @__PURE__ */ new Set();
+	add(value) {
+		if (value && value.length >= SHORTEST_MASKED) this.values.add(value);
+	}
+	/** `text` with every masked value replaced by `***`, longest first. */
+	redact(text) {
+		if (this.values.size === 0) return text;
+		let out = text;
+		const longestFirst = [...this.values].sort((a, b) => b.length - a.length);
+		for (const value of longestFirst) out = out.replaceAll(value, "***");
+		return out;
+	}
+};
+/** Every value in `secrets` that is a secret rather than a label. */
+function secretValues(secrets) {
+	return [
+		secrets.seed,
+		...Object.values(secrets.custom ?? {}),
+		...Object.values(secrets.urls ?? {}),
+		...Object.values(secrets.services ?? {}).map((service) => service?.password)
+	].filter((value) => typeof value === "string");
+}
+/**
+* The stage's secrets through the store `secrets.store` names for it. Opening
+* one builds a client and makes no request, so a target that never reads them
+* costs nothing.
+*/
+async function deploySecrets(workspace, stage, redactor, options = {}) {
+	const store = await secretsStoreFor(workspace, stage, options);
+	const mask = (secrets) => {
+		for (const value of secretValues(secrets)) redactor.add(value);
+	};
+	return {
+		store: store.name,
+		async read() {
+			const secrets = await store.read(stage);
+			if (secrets) mask(secrets);
+			return secrets;
+		},
+		async write(secrets) {
+			mask(secrets);
+			await store.write(stage, secrets);
+		},
+		mask: (value) => redactor.add(value)
+	};
+}
+//#endregion
+//#region src/deploy/events.ts
+/** An error as an event carries it: its name and message, nothing else. */
+function eventError(error) {
+	if (error instanceof Error) return {
+		name: error.name,
+		message: error.message
+	};
+	return {
+		name: "Error",
+		message: String(error)
+	};
+}
+//#endregion
+//#region src/deploy/StateProvider.ts
+/**
+* Check if value is a StateProvider implementation.
+*/
+function isStateProvider(value) {
+	return typeof value === "object" && value !== null && typeof value.read === "function" && typeof value.write === "function";
+}
+//#endregion
+//#region src/deploy/StateStore.ts
+/**
+* Deploy state store.
+*
+* `StateProvider` reads and writes a whole stage at once, with nothing to stop
+* two runs of the same stage from overwriting each other and nowhere to record
+* a resource the moment it exists. A `StateStore` adds the three things a
+* deploy needs to be safe against crashes and concurrent runs:
+*
+* - `lock(stage)`: one run per stage. A second gets `StateLocked`, naming the
+*   holder, instead of racing the first.
+* - Versioned `read` and conditional `write`: a write names the version it was
+*   based on, and raises `StateVersionConflict` when the stored state moved on
+*   underneath it, so nothing is lost silently even without the lock.
+* - Per-resource records: `putResource` journals one resource at a time, so a
+*   run that dies half way leaves behind the ids of everything it created.
+*
+* Built-in stores: `LocalStateStore`, `SSMStateStore`, `S3StateStore`. A
+* custom `StateProvider` is wrapped by `LegacyStateStore`, which keeps it
+* working but cannot lock.
+*/
+var StateLocked = class extends Error {
+	stage;
+	holder;
+	location;
+	constructor(stage, holder, location) {
+		const by = holder ? `${holder.owner}@${holder.host} (pid ${holder.pid}) since ${holder.acquiredAt}${holder.operation ? ` for '${holder.operation}'` : ""}` : "a run that did not record who it was";
+		super(`Deploy state for stage '${stage}' is locked by ${by} (${location}). Wait for that run to finish; if it crashed, release the lock with \`gkm state:unlock --stage ${stage}\`.`);
+		this.stage = stage;
+		this.holder = holder;
+		this.location = location;
+		this.name = "StateLocked";
+	}
+};
+var StateVersionConflict = class extends Error {
+	stage;
+	expectedVersion;
+	actualVersion;
+	constructor(stage, expectedVersion, actualVersion) {
+		super(`Deploy state for stage '${stage}' changed since it was read (expected ${expectedVersion ? `version ${expectedVersion}` : "no state"}, found ${actualVersion ? `version ${actualVersion}` : "no state"}). Another run wrote it: read the state again and re-apply the change, and hold the stage's lock so runs take turns.`);
+		this.stage = stage;
+		this.expectedVersion = expectedVersion;
+		this.actualVersion = actualVersion;
+		this.name = "StateVersionConflict";
+	}
+};
+var StageStateMissing = class extends Error {
+	stage;
+	constructor(stage) {
+		super(`There is no deploy state for stage '${stage}' to record a resource in. Write the stage's state first (write with expectedVersion: null).`);
+		this.stage = stage;
+		this.name = "StageStateMissing";
+	}
+};
+var StateUnreadable = class extends Error {
+	stage;
+	location;
+	constructor(stage, location, cause) {
+		super(`Deploy state for stage '${stage}' at ${location} is not valid JSON. Restore it from a backup (or the provider's history) rather than deploying without it — a deploy without state recreates every resource.`, { cause });
+		this.stage = stage;
+		this.location = location;
+		this.name = "StateUnreadable";
+	}
+};
+var StateSchemaTooNew = class extends Error {
+	stage;
+	schemaVersion;
+	constructor(stage, schemaVersion) {
+		super(`Deploy state for stage '${stage}' has schema version ${String(schemaVersion)}, newer than this @geekmidas/cli understands (2). Upgrade @geekmidas/cli to the version that wrote it.`);
+		this.stage = stage;
+		this.schemaVersion = schemaVersion;
+		this.name = "StateSchemaTooNew";
+	}
+};
+/**
+* Not thrown: emitted (once per store) when a custom `StateProvider` stands
+* in for a store, so a deploy that cannot be protected from a concurrent one
+* says so.
+*/
+var StateStoreWithoutLocking = class extends Error {
+	provider;
+	constructor(provider) {
+		super(`The custom state provider '${provider}' has no lock and no versions, so two deploys of the same stage can still overwrite each other. Implement StateStore (lock, versioned read, conditional write) or use the 'local', 'ssm' or 's3' state provider.`);
+		this.provider = provider;
+		this.name = "StateStoreWithoutLocking";
+	}
+};
+var StateStoreNeedsWorkspaceName = class extends Error {
+	provider;
+	constructor(provider) {
+		super(`The '${provider}' state provider keys state by workspace name. Set "name" in gkm.config.ts.`);
+		this.provider = provider;
+		this.name = "StateStoreNeedsWorkspaceName";
+	}
+};
+var UnknownStateProvider = class extends Error {
+	config;
+	constructor(config) {
+		super(`Unknown state provider ${JSON.stringify(config)}. Use 'local', 'ssm', 's3', or an object implementing StateStore or StateProvider.`);
+		this.config = config;
+		this.name = "UnknownStateProvider";
+	}
+};
+/** A lock or write that could not get at the state backend in time. */
+var StateStoreBusy = class extends Error {
+	stage;
+	location;
+	constructor(stage, location) {
+		super(`Timed out waiting to write deploy state for stage '${stage}' (${location}). If no other gkm process is running, remove ${location}.`);
+		this.stage = stage;
+		this.location = location;
+		this.name = "StateStoreBusy";
+	}
+};
+function decodeDocument(stage, body, location) {
+	let parsed;
+	try {
+		parsed = JSON.parse(body);
+	} catch (error) {
+		throw new StateUnreadable(stage, location, error);
+	}
+	if (typeof parsed !== "object" || parsed === null) throw new StateUnreadable(stage, location, parsed);
+	const schemaVersion = parsed.schemaVersion;
+	if (schemaVersion === void 0) return {
+		schemaVersion: 1,
+		state: parsed
+	};
+	if (schemaVersion === 2) return {
+		schemaVersion: 2,
+		document: parsed
+	};
+	throw new StateSchemaTooNew(stage, schemaVersion);
+}
+function encodeDocument(document) {
+	return JSON.stringify(document, null, 2);
+}
+/**
+* v1 state as a v2 document. The ids v1 kept are seeded as `ready` records,
+* so the first journaled deploy after an upgrade adopts them rather than
+* treating them as unknown.
+*/
+function migrateV1(stage, state) {
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const resources = {};
+	const seed = (type, name, id) => {
+		if (!id) return;
+		const key = name ? `${type}:${name}` : type;
+		resources[key] = {
+			key,
+			type,
+			id,
+			status: "ready",
+			updatedAt: now
+		};
+	};
+	seed("project", null, state.projectId);
+	seed("environment", null, state.environmentId);
+	for (const [app, id] of Object.entries(state.applications ?? {})) seed("application", app, id);
+	seed("postgres", null, state.services?.postgresId);
+	seed("redis", null, state.services?.redisId);
+	seed("backup-destination", null, state.backups?.destinationId);
+	return {
+		schemaVersion: 2,
+		stage,
+		serial: 1,
+		state,
+		resources,
+		updatedAt: now
+	};
+}
+function newLockHolder(options) {
+	let owner = "unknown";
+	try {
+		owner = userInfo().username;
+	} catch {}
+	return {
+		id: randomUUID(),
+		owner,
+		host: hostname(),
+		pid: process.pid,
+		acquiredAt: (/* @__PURE__ */ new Date()).toISOString(),
+		operation: options?.operation
+	};
+}
+function contentVersion(body) {
+	return createHash("sha256").update(body).digest("hex").slice(0, 16);
+}
+/**
+* A store over a backend that can read and conditionally write one blob per
+* stage, and create a lock object only if it does not exist. Migration and
+* resource records are the same for every such backend, so they live here.
+*/
+var DocumentStateStore = class {
+	async lock(stage, options) {
+		const holder = newLockHolder(options);
+		await this.createLock(stage, holder);
+		let released = false;
+		return {
+			stage,
+			holder,
+			release: async () => {
+				if (released) return;
+				released = true;
+				await this.removeLock(stage, holder);
+			}
+		};
+	}
+	async forceUnlock(stage) {
+		const holder = await this.readLock(stage);
+		await this.removeLock(stage, null);
+		return holder;
+	}
+	async read(stage) {
+		const current = await this.readDocument(stage);
+		if (!current) return null;
+		return {
+			state: current.document.state,
+			resources: current.document.resources,
+			version: current.version
+		};
+	}
+	async write(stage, state, options) {
+		if (options.expectedVersion === null) {
+			const document = {
+				schemaVersion: 2,
+				stage,
+				serial: 1,
+				state,
+				resources: {},
+				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+			};
+			return this.writeRaw(stage, encodeDocument(document), null);
+		}
+		return this.mutate(stage, options.expectedVersion, (document) => ({
+			...document,
+			state
+		}));
+	}
+	async putResource(stage, record, options) {
+		return this.mutate(stage, options?.expectedVersion, (document) => ({
+			...document,
+			resources: {
+				...document.resources,
+				[record.key]: {
+					...record,
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+				}
+			}
+		}));
+	}
+	async deleteResource(stage, key, options) {
+		return this.mutate(stage, options?.expectedVersion, (document) => {
+			const { [key]: _removed, ...resources } = document.resources;
+			return {
+				...document,
+				resources
+			};
+		});
+	}
+	async mutate(stage, expectedVersion, change) {
+		const current = await this.readDocument(stage);
+		if (!current) {
+			if (expectedVersion !== void 0) throw new StateVersionConflict(stage, expectedVersion, null);
+			throw new StageStateMissing(stage);
+		}
+		if (expectedVersion !== void 0 && current.version !== expectedVersion) throw new StateVersionConflict(stage, expectedVersion, current.version);
+		const next = change(current.document);
+		next.serial = current.document.serial + 1;
+		next.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		return this.writeRaw(stage, encodeDocument(next), current.version);
+	}
+	/**
+	* Reads the stage's document, migrating v1 in place on the way. The
+	* migration is itself a conditional write: if another run migrated (or
+	* wrote) first, its result is read instead.
+	*/
+	async readDocument(stage, attempt = 0) {
+		const raw = await this.readRaw(stage);
+		if (!raw) return null;
+		const decoded = decodeDocument(stage, raw.body, this.location(stage));
+		if (decoded.schemaVersion === 2) return {
+			document: decoded.document,
+			version: raw.version
+		};
+		await this.writeV1Backup(stage, raw.body);
+		const document = migrateV1(stage, decoded.state);
+		try {
+			return {
+				document,
+				version: await this.writeRaw(stage, encodeDocument(document), raw.version)
+			};
+		} catch (error) {
+			if (error instanceof StateVersionConflict && attempt < 2) return this.readDocument(stage, attempt + 1);
+			throw error;
+		}
+	}
+};
+function isStateStore(value) {
+	return typeof value === "object" && value !== null && typeof value.lock === "function" && typeof value.read === "function" && typeof value.write === "function" && typeof value.putResource === "function";
+}
+/**
+* The store for a workspace's `state` config:
+*
+* - none / `'local'`: `LocalStateStore` under `.gkm/`
+* - `'ssm'`: `SSMStateStore`, with no local cache — SSM is read directly, so
+*   a stale local copy can never win over it
+* - `'s3'`: `S3StateStore`
+* - a `StateStore` object: used as is
+* - a `StateProvider` object: wrapped by `LegacyStateStore`
+*/
+async function createStateStore(options) {
+	const { config, workspaceRoot, workspaceName } = options;
+	if (!config || config.provider === "local") {
+		const { LocalStateStore } = await import("./LocalStateStore-BRhMQRuy.mjs").then((n) => n.n);
+		return new LocalStateStore(workspaceRoot);
+	}
+	if (isStateStore(config.provider)) return config.provider;
+	if (isStateProvider(config.provider)) {
+		const { LegacyStateStore } = await import("./LegacyStateStore-BUu1nQ5u.mjs");
+		return new LegacyStateStore(config.provider, { warn: options.warn });
+	}
+	if (config.provider === "ssm") {
+		if (!workspaceName) throw new StateStoreNeedsWorkspaceName("ssm");
+		const { SSMStateStore } = await import("./SSMStateStore-Dmj7zzFO.mjs");
+		const ssm = config;
+		return SSMStateStore.create({
+			workspaceName,
+			region: ssm.region,
+			profile: ssm.profile
+		});
+	}
+	if (config.provider === "s3") {
+		if (!workspaceName) throw new StateStoreNeedsWorkspaceName("s3");
+		const { S3StateStore } = await import("./S3StateStore-pw1GhWwt.mjs");
+		const s3 = config;
+		return S3StateStore.create({
+			workspaceName,
+			bucket: s3.bucket,
+			prefix: s3.prefix,
+			region: s3.region,
+			profile: s3.profile
+		});
+	}
+	throw new UnknownStateProvider(config);
+}
+//#endregion
+//#region src/deploy/orchestrate.ts
+/**
+* The run around a target: what every deploy does whatever it deploys
+* through.
+*
+* It loads the workspace, resolves the target, works out the apps and the
+* identity, takes the stage's lock, and calls the target's phases in order,
+* reporting each as it starts, finishes or fails. Everything that is about
+* *where* the stage goes is the target's.
+*/
+/** Apps were asked for by name that the workspace does not have. */
+var UnknownDeployApps = class extends Error {
+	apps;
+	available;
+	constructor(apps, available) {
+		super(`Unknown apps: ${apps.join(", ")}\nAvailable apps: ${available.join(", ")}`);
+		this.apps = apps;
+		this.available = available;
+		this.name = "UnknownDeployApps";
+	}
+};
+/** Every app asked for deploys through some other target. */
+var NoDeployableApps = class extends Error {
+	stage;
+	target;
+	constructor(stage, target) {
+		super(`No apps to deploy through "${target}": every selected app deploys somewhere else. Pick the target with --target, or set each app's deploy in gkm.config.ts.`);
+		this.stage = stage;
+		this.target = target;
+		this.name = "NoDeployableApps";
+	}
+};
+/** A failed rollback, after the failure that called for it. */
+var RollbackFailed = class extends Error {
+	target;
+	failure;
+	constructor(target, failure, cause) {
+		super(`Deploying through "${target}" failed, and so did rolling it back: ${cause instanceof Error ? cause.message : String(cause)}. The stage may be part-released; deploy again, or roll it back by hand. The first failure: ${failure instanceof Error ? failure.message : String(failure)}`, { cause });
+		this.target = target;
+		this.failure = failure;
+		this.name = "RollbackFailed";
+	}
+};
+/**
+* Generate image tag from stage and timestamp
+*/
+function generateTag(stage) {
+	return `${stage}-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19)}`;
+}
+/** Why an app that deploys through another target is left out. */
+function elsewhere(target, stage) {
+	const instead = builtinTarget(target)?.instead?.(stage);
+	if (instead) return `it deploys through "${target}" — ${instead}`;
+	return `it deploys through "${target}" — run \`gkm deploy --target ${target} --stage ${stage}\``;
+}
+/**
+* Deploy a workspace's stage through its target.
+*
+* The engine under `deploy()` and `gkm deploy`. It never prompts and never
+* exits: credentials come from `ctx.credentials`, progress goes to
+* `ctx.emit` and to `output`, and every failure is thrown.
+*
+* @internal
+*/
+async function runDeploy(source, request, ctx) {
+	const { stage } = request;
+	const redactor = ctx.redactor ?? new Redactor();
+	const emit = (event) => ctx.emit(event.type === "log" ? {
+		...event,
+		message: redactor.redact(event.message)
+	} : event);
+	/** Run one phase between its events. */
+	const phase = async (name, body) => {
+		ctx.signal?.throwIfAborted();
+		emit({
+			type: "phase.started",
+			phase: name
+		});
+		try {
+			const value = await body();
+			emit({
+				type: "phase.finished",
+				phase: name
+			});
+			return value;
+		} catch (error) {
+			emit({
+				type: "phase.failed",
+				phase: name,
+				error: eventError(error)
+			});
+			throw error;
+		}
+	};
+	ctx.signal?.throwIfAborted();
+	emit({
+		type: "phase.started",
+		phase: "validate"
+	});
+	let prepared;
+	try {
+		prepared = await prepare(source, request, ctx, emit, redactor);
+	} catch (error) {
+		emit({
+			type: "phase.failed",
+			phase: "validate",
+			error: eventError(error)
+		});
+		throw error;
+	}
+	const { resolved, phaseCtx, store } = prepared;
+	const { target } = resolved;
+	if (ctx.dryRun) {
+		const run = await validate(target, phaseCtx, emit);
+		await phase("plan", () => target.plan(phaseCtx, run));
+		return target.result(phaseCtx, run);
+	}
+	let lock;
+	try {
+		lock = await store.lock(stage, { operation: "deploy" });
+	} catch (error) {
+		emit({
+			type: "phase.failed",
+			phase: "validate",
+			error: eventError(error)
+		});
+		throw error;
+	}
+	try {
+		const run = await validate(target, phaseCtx, emit);
+		if (target.provision) await phase("provision", () => target.provision(phaseCtx, run));
+		if (target.build) await phase("build", () => target.build(phaseCtx, run));
+		let releasing = "release";
+		try {
+			await phase("release", () => target.release(phaseCtx, run));
+			releasing = "verify";
+			if (target.verify) await phase("verify", () => target.verify(phaseCtx, run));
+		} catch (error) {
+			if (ctx.signal?.aborted || !target.capabilities.rollback) throw error;
+			if (!target.rollback) throw error;
+			try {
+				await phase("rollback", () => target.rollback(phaseCtx, run, {
+					phase: releasing,
+					error
+				}));
+			} catch (rollbackError) {
+				throw new RollbackFailed(resolved.name, error, rollbackError);
+			}
+			throw error;
+		}
+		return await target.result(phaseCtx, run);
+	} finally {
+		await lock.release();
+	}
+}
+/** `validate`, then the run's `deploy.started`, inside the validate phase. */
+async function validate(target, phaseCtx, emit) {
+	try {
+		const run = await target.validate(phaseCtx);
+		const skipped = new Set(phaseCtx.skipped.map((s) => s.app));
+		emit({
+			type: "deploy.started",
+			stage: phaseCtx.stage,
+			target: phaseCtx.target,
+			identity: phaseCtx.identity.key,
+			tag: phaseCtx.tag,
+			apps: phaseCtx.apps.filter((app) => !skipped.has(app)),
+			dryRun: phaseCtx.dryRun
+		});
+		emit({
+			type: "phase.finished",
+			phase: "validate"
+		});
+		return run;
+	} catch (error) {
+		emit({
+			type: "phase.failed",
+			phase: "validate",
+			error: eventError(error)
+		});
+		throw error;
+	}
+}
+/** Everything the phases are handed, worked out before the first of them. */
+async function prepare(source, request, ctx, emit, redactor) {
+	const { stage } = request;
+	const configured = typeof source === "function" ? await source() : source;
+	const local = stage === configured.stages.local;
+	if (!local) assertDeployedStage(configured.stages, stage);
+	const targetName = request.target ?? configured.deploy?.default ?? "dokploy";
+	const resolved = await resolveTarget(targetName, {
+		workspace: configured,
+		stage,
+		...ctx.targets ? { host: ctx.targets } : {}
+	});
+	if (local && !resolved.target.capabilities.localStage) assertDeployedStage(configured.stages, stage);
+	const options = await parseTargetOptions(resolved);
+	const manifest = await discover({
+		patterns: constructGlobs(configured),
+		cwd: configured.root
+	});
+	const units = derivedApps(manifest, configured);
+	const workspace = Object.keys(units).length > 0 ? {
+		...configured,
+		apps: units
+	} : configured;
+	const identity = deployIdentity(workspace, stage);
+	const tag = request.tag ?? (resolved.target.tag ? await resolved.target.tag({
+		cwd: workspace.root,
+		stage
+	}) : generateTag(stage));
+	const buildOrder = getAppBuildOrder(workspace);
+	let selected = buildOrder;
+	if (request.apps && request.apps.length > 0) {
+		const unknown = request.apps.filter((name) => !workspace.apps[name]);
+		if (unknown.length > 0) throw new UnknownDeployApps(unknown, Object.keys(workspace.apps));
+		selected = buildOrder.filter((name) => request.apps.includes(name));
+	}
+	const skipped = [];
+	const skip = (app, reason) => {
+		skipped.push({
+			app,
+			reason
+		});
+		emit({
+			type: "app.skipped",
+			app,
+			reason
+		});
+	};
+	const byDefault = configured.deploy?.default ?? "dokploy";
+	const apps = selected.filter((name) => {
+		const own = workspace.apps[name].resolvedDeployTarget;
+		const deploysThrough = own === byDefault ? targetName : own;
+		if (deploysThrough === targetName) return true;
+		skip(name, elsewhere(deploysThrough, stage));
+		return false;
+	});
+	if (apps.length === 0) throw new NoDeployableApps(stage, targetName);
+	const store = await createStateStore({
+		config: workspace.state,
+		workspaceRoot: workspace.root,
+		workspaceName: workspace.name
+	});
+	const secrets = await deploySecrets(workspace, stage, redactor, { ...ctx.home ? { home: ctx.home } : {} });
+	const line = (level) => (message) => emit({
+		type: "log",
+		level,
+		message
+	});
+	const logger = {
+		info: line("info"),
+		warn: line("warn"),
+		error: line("error")
+	};
+	return {
+		resolved,
+		phaseCtx: {
+			target: targetName,
+			cwd: workspace.root,
+			stage,
+			tag,
+			tagGiven: request.tag !== void 0,
+			apps,
+			skipped,
+			identity,
+			workspace,
+			manifest,
+			options,
+			dryRun: ctx.dryRun,
+			credentials: ctx.credentials,
+			state: store,
+			secrets,
+			logger,
+			signal: ctx.signal ?? new AbortController().signal,
+			childOutput: ctx.childOutput ?? "inherit",
+			emit,
+			skip,
+			name: (resource) => applicationName(identity, resource)
+		},
+		store
+	};
+}
+//#endregion
+//#region src/deploy/dokploy-api.ts
+var dokploy_api_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_DOKPLOY_TIMEOUT_MS: () => DEFAULT_DOKPLOY_TIMEOUT_MS,
+	DokployApi: () => DokployApi,
+	DokployApiError: () => DokployApiError,
+	DokployRequestTimedOut: () => DokployRequestTimedOut
+});
+/** Per request, so a stalled server fails the deploy, not the CI job. */
+const DEFAULT_DOKPLOY_TIMEOUT_MS = 3e4;
+/**
+* Dokploy accepted the connection but did not answer in time.
+*
+* Not retried: a request that arrived and stalled may still be acted on, and
+* sending it again could repeat a deploy or a create the server is already
+* doing.
+*/
+var DokployRequestTimedOut = class extends Error {
+	baseUrl;
+	endpoint;
+	timeoutMs;
+	constructor(baseUrl, endpoint, timeoutMs) {
+		super(`Dokploy at ${baseUrl} did not answer ${endpoint} within ${timeoutMs}ms. Check that the Dokploy server is healthy, or raise \`timeoutMs\` if this call is known to be slow.`);
+		this.baseUrl = baseUrl;
+		this.endpoint = endpoint;
+		this.timeoutMs = timeoutMs;
+		this.name = "DokployRequestTimedOut";
+	}
+};
+/**
+* Waits `ms` between retries, or rejects with the signal's reason the moment
+* it aborts — a caller who gave up should not sit through the backoff.
+*/
+function pause(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) {
+			reject(signal.reason);
+			return;
+		}
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(signal?.reason);
+		};
+		const timer = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+var DokployApiError = class extends Error {
+	status;
+	statusText;
+	issues;
+	constructor(message, status, statusText, issues) {
+		super(message);
+		this.status = status;
+		this.statusText = statusText;
+		this.issues = issues;
+		this.name = "DokployApiError";
+	}
+};
+/**
+* Dokploy API client
+*/
+var DokployApi = class {
+	baseUrl;
+	token;
+	timeoutMs;
+	signal;
+	constructor(options) {
+		this.baseUrl = options.baseUrl.replace(/\/$/, "");
+		this.token = options.token;
+		this.timeoutMs = options.timeoutMs ?? 3e4;
+		this.signal = options.signal;
+	}
+	/**
+	* Make a GET request to the Dokploy API
+	*/
+	async get(endpoint) {
+		return this.request("GET", endpoint);
+	}
+	/**
+	* Make a POST request to the Dokploy API
+	*/
+	async post(endpoint, body) {
+		return this.request("POST", endpoint, body);
+	}
+	/**
+	* Make a request to the Dokploy API
+	*/
+	async request(method, endpoint, body) {
+		const url = `${this.baseUrl}/api/${endpoint}`;
+		let response;
+		let timeout;
+		let lastError;
+		for (let attempt = 1; attempt <= 3; attempt++) {
+			this.signal?.throwIfAborted();
+			timeout = AbortSignal.timeout(this.timeoutMs);
+			try {
+				response = await fetch(url, {
+					method,
+					headers: {
+						"Content-Type": "application/json",
+						"x-api-key": this.token
+					},
+					body: body ? JSON.stringify(body) : void 0,
+					signal: this.signal ? AbortSignal.any([this.signal, timeout]) : timeout
+				});
+				break;
+			} catch (error) {
+				const stopped = this.stopped(timeout, endpoint);
+				if (stopped) throw stopped;
+				lastError = error;
+				if (attempt === 3) break;
+				await pause(attempt * 750, this.signal);
+			}
+		}
+		if (!response || !timeout) {
+			const detail = lastError instanceof Error ? lastError.message : String(lastError);
+			throw new DokployApiError(`Could not reach Dokploy at ${this.baseUrl} (${endpoint}): ${detail}`, 0, "Network error");
+		}
+		try {
+			return await this.read(response);
+		} catch (error) {
+			throw this.stopped(timeout, endpoint) ?? error;
+		}
+	}
+	/**
+	* What a request cut short should reject with: the caller's own reason
+	* when they aborted, `DokployRequestTimedOut` when the deadline passed,
+	* nothing when it was neither.
+	*/
+	stopped(timeout, endpoint) {
+		if (this.signal?.aborted) return this.signal.reason;
+		if (timeout.aborted) return new DokployRequestTimedOut(this.baseUrl, endpoint, this.timeoutMs);
+	}
+	/** Turns a response into its JSON body, or a `DokployApiError`. */
+	async read(response) {
+		if (!response.ok) {
+			let errorMessage = `Dokploy API error: ${response.status} ${response.statusText}`;
+			let issues;
+			try {
+				const errorBody = await response.json();
+				if (errorBody.message) errorMessage = `Dokploy API error: ${errorBody.message}`;
+				if (errorBody.issues?.length) {
+					issues = errorBody.issues;
+					errorMessage += `\n  Issues: ${errorBody.issues.map((i) => i.message).join(", ")}`;
+				}
+			} catch {}
+			throw new DokployApiError(errorMessage, response.status, response.statusText, issues);
+		}
+		const text = await response.text();
+		if (!text || text.trim() === "") return;
+		return JSON.parse(text);
+	}
+	/**
+	* Every external port published on this server, across every project.
+	*
+	* Dokploy knows what it has bound; guessing does not. A port that looks free
+	* from here can be held by a service in a project this deploy has never
+	* heard of — which surfaces as `Port 5432 is already in use by container
+	* "…"`, naming something the caller cannot see.
+	*
+	* `project.all` is a summary, so each project is fetched: the per-service
+	* `externalPort` only appears on `project.one`.
+	*/
+	async publishedPorts() {
+		const ports = /* @__PURE__ */ new Set();
+		const projects = await this.listProjects();
+		for (const project of projects) {
+			const details = await this.getProject(project.projectId);
+			for (const environment of details.environments ?? []) {
+				const resources = [
+					...environment.postgres ?? [],
+					...environment.redis ?? [],
+					...environment.applications ?? []
+				];
+				for (const resource of resources) if (typeof resource.externalPort === "number") ports.add(resource.externalPort);
+			}
+		}
+		return ports;
+	}
+	/**
+	* Validate the API token by making a test request
+	*/
+	async validateToken() {
+		try {
+			await this.get("project.all");
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* List all projects
+	*/
+	async listProjects() {
+		return this.get("project.all");
+	}
+	/**
+	* Get a single project by ID
+	*/
+	async getProject(projectId) {
+		return this.get(`project.one?projectId=${projectId}`);
+	}
+	/**
+	* Create a new project
+	*/
+	async createProject(name, description) {
+		return this.post("project.create", {
+			name,
+			description: description ?? `Created by gkm CLI`
+		});
+	}
+	/**
+	* Change a project's name or description.
+	*
+	* The name is sent with the description because `project.update` validates
+	* the whole project on some Dokploy versions, and a missing name fails it.
+	*/
+	async updateProject(projectId, updates) {
+		await this.post("project.update", {
+			projectId,
+			...updates
+		});
+	}
+	/**
+	* Delete a project and all its resources
+	*/
+	async deleteProject(projectId) {
+		await this.post("project.remove", { projectId });
+	}
+	/**
+	* Create an environment in a project
+	*/
+	async createEnvironment(projectId, name, description) {
+		return this.post("environment.create", {
+			projectId,
+			name,
+			description: description ?? `${name} environment`
+		});
+	}
+	/**
+	* List all applications in a project
+	*/
+	async listApplications(projectId) {
+		return this.listInProject(projectId, (env) => env.applications);
+	}
+	/**
+	* Everything of one kind in a project, across its environments.
+	*
+	* From `project.one`, because the per-kind `*.all?projectId=` endpoints
+	* return **404** on current Dokploy: resources live under environments now.
+	* Those calls used to be wrapped in `catch { return [] }`, which turned "I
+	* could not ask" into "there are none" — and for a find-or-create that is
+	* the worst available answer. Every deploy created a second application, a
+	* second Postgres and a second Redis, silently, for as long as the project
+	* existed.
+	*
+	* A failure here is not swallowed: creating a duplicate is worse than
+	* stopping.
+	*/
+	async listInProject(projectId, pick) {
+		return ((await this.getProject(projectId)).environments ?? []).flatMap((environment) => (pick(environment) ?? []).map((resource) => ({
+			...resource,
+			environmentId: environment.environmentId
+		})));
+	}
+	/**
+	* Find an application by name in a project
+	*/
+	async findApplicationByName(projectId, name, environmentId) {
+		const applications = await this.listApplications(projectId);
+		const normalizedName = name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+		return applications.find((app) => (!environmentId || app.environmentId === environmentId) && (app.name === name || app.appName === normalizedName));
+	}
+	/**
+	* Create a new application
+	*/
+	async createApplication(name, projectId, environmentId) {
+		return this.post("application.create", {
+			name,
+			projectId,
+			environmentId,
+			appName: name.toLowerCase().replace(/[^a-z0-9-]/g, "-")
+		});
+	}
+	/**
+	* Find or create an application by name
+	*/
+	async findOrCreateApplication(name, projectId, environmentId) {
+		const existing = await this.findApplicationByName(projectId, name, environmentId);
+		if (existing) return {
+			application: existing,
+			created: false
+		};
+		return {
+			application: await this.createApplication(name, projectId, environmentId),
+			created: true
+		};
+	}
+	/**
+	* Get an application by ID
+	*/
+	async getApplication(applicationId) {
+		try {
+			return await this.get(`application.one?applicationId=${applicationId}`);
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Update an application
+	*/
+	async updateApplication(applicationId, updates) {
+		await this.post("application.update", {
+			applicationId,
+			...updates
+		});
+	}
+	/**
+	* Save environment variables for an application
+	*/
+	async saveApplicationEnv(applicationId, env, options) {
+		await this.post("application.saveEnvironment", {
+			applicationId,
+			env,
+			buildArgs: options?.buildArgs ?? null,
+			buildSecrets: options?.buildSecrets ?? null,
+			createEnvFile: false
+		});
+	}
+	/**
+	* Configure application to use Docker provider (pull from registry)
+	*
+	* For private registries, either:
+	* - Use `registryId` if the registry is configured in Dokploy
+	* - Or provide `username`, `password`, and `registryUrl` directly
+	*/
+	async saveDockerProvider(applicationId, dockerImage, options) {
+		await this.post("application.saveDockerProvider", {
+			applicationId,
+			dockerImage,
+			...options,
+			username: options?.username ?? null,
+			password: options?.password ?? null,
+			registryUrl: options?.registryUrl ?? null
+		});
+	}
+	/**
+	* Deploy an application
+	*/
+	async deployApplication(applicationId) {
+		await this.post("application.deploy", { applicationId });
+	}
+	/**
+	* Delete an application
+	*/
+	async deleteApplication(applicationId) {
+		await this.post("application.remove", { applicationId });
+	}
+	/**
+	* List all registries
+	*/
+	async listRegistries() {
+		return this.get("registry.all");
+	}
+	/**
+	* Create a new registry
+	*/
+	async createRegistry(registryName, registryUrl, username, password, options) {
+		return this.post("registry.create", {
+			registryName,
+			registryUrl,
+			username,
+			password,
+			imagePrefix: options?.imagePrefix
+		});
+	}
+	/**
+	* Get a registry by ID
+	*/
+	async getRegistry(registryId) {
+		return this.get(`registry.one?registryId=${registryId}`);
+	}
+	/**
+	* Update a registry
+	*/
+	async updateRegistry(registryId, updates) {
+		await this.post("registry.update", {
+			registryId,
+			...updates
+		});
+	}
+	/**
+	* Delete a registry
+	*/
+	async deleteRegistry(registryId) {
+		await this.post("registry.remove", { registryId });
+	}
+	/**
+	* List all Postgres databases in a project
+	*/
+	async listPostgres(projectId) {
+		return this.listInProject(projectId, (env) => env.postgres);
+	}
+	/**
+	* Find a Postgres database by name in a project
+	*/
+	async findPostgresByName(projectId, name) {
+		const databases = await this.listPostgres(projectId);
+		const normalizedName = name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+		const match = databases.find((db) => db.name === name || db.appName === normalizedName);
+		if (!match) return void 0;
+		return this.getPostgres(match.postgresId);
+	}
+	/**
+	* Create a new Postgres database
+	*/
+	async createPostgres(name, projectId, environmentId, options) {
+		return this.post("postgres.create", {
+			name,
+			projectId,
+			environmentId,
+			appName: options?.appName ?? name.toLowerCase().replace(/[^a-z0-9-]/g, "-"),
+			databaseName: options?.databaseName,
+			databaseUser: options?.databaseUser ?? "postgres",
+			databasePassword: options?.databasePassword,
+			dockerImage: options?.dockerImage ?? "postgres:18",
+			description: options?.description ?? `Postgres database for ${name}`
+		});
+	}
+	/**
+	* Find or create a Postgres database by name
+	*/
+	async findOrCreatePostgres(name, projectId, environmentId, options) {
+		const existing = await this.findPostgresByName(projectId, name);
+		if (existing) return {
+			postgres: existing,
+			created: false
+		};
+		return {
+			postgres: await this.createPostgres(name, projectId, environmentId, options),
+			created: true
+		};
+	}
+	/**
+	* Get a Postgres database by ID
+	*/
+	async getPostgres(postgresId) {
+		return this.get(`postgres.one?postgresId=${postgresId}`);
+	}
+	/**
+	* Deploy a Postgres database
+	*/
+	async deployPostgres(postgresId) {
+		await this.post("postgres.deploy", { postgresId });
+	}
+	/**
+	* Save environment variables for Postgres
+	*/
+	async savePostgresEnv(postgresId, env) {
+		await this.post("postgres.saveEnvironment", {
+			postgresId,
+			env
+		});
+	}
+	/**
+	* Set external port for Postgres (for external access)
+	*/
+	async savePostgresExternalPort(postgresId, externalPort) {
+		await this.post("postgres.saveExternalPort", {
+			postgresId,
+			externalPort
+		});
+	}
+	/**
+	* Update Postgres configuration
+	*/
+	async updatePostgres(postgresId, updates) {
+		await this.post("postgres.update", {
+			postgresId,
+			...updates
+		});
+	}
+	/**
+	* Delete a Postgres database
+	*/
+	async deletePostgres(postgresId) {
+		await this.post("postgres.remove", { postgresId });
+	}
+	/**
+	* The compose stacks in a project.
+	*
+	* Dokploy has first-class primitives for Postgres and Redis and none for
+	* MinIO, so an object store is a compose stack — the one kind whose contents
+	* this target writes rather than configures.
+	*/
+	async listCompose(projectId) {
+		return this.listInProject(projectId, (env) => env.compose);
+	}
+	/** A compose stack by name, hydrated — `project.one` returns summaries. */
+	async findComposeByName(projectId, name) {
+		const summary = (await this.listCompose(projectId)).find((compose) => compose.name === name);
+		return summary ? this.getCompose(summary.composeId) : void 0;
+	}
+	async getCompose(composeId) {
+		return this.get(`compose.one?composeId=${composeId}`);
+	}
+	/**
+	* A compose stack carrying the file this target wrote.
+	*
+	* Created empty and then updated, because `compose.create` takes no file:
+	* it defaults to `sourceType: 'github'` and expects a repository. `raw` is
+	* what makes the file ours.
+	*/
+	async findOrCreateCompose(name, projectId, environmentId, composeFile) {
+		const existing = await this.findComposeByName(projectId, name);
+		const compose = existing ?? await this.post("compose.create", {
+			name,
+			environmentId,
+			composeType: "docker-compose"
+		});
+		await this.post("compose.update", {
+			composeId: compose.composeId,
+			sourceType: "raw",
+			composeFile
+		});
+		return {
+			compose,
+			created: !existing
+		};
+	}
+	async deployCompose(composeId) {
+		await this.post("compose.deploy", { composeId });
+	}
+	async deleteCompose(composeId) {
+		await this.post("compose.delete", {
+			composeId,
+			deleteVolumes: false
+		});
+	}
+	/**
+	* List all Redis instances in a project
+	*/
+	async listRedis(projectId) {
+		return this.listInProject(projectId, (env) => env.redis);
+	}
+	/**
+	* Find a Redis instance by name in a project
+	*/
+	async findRedisByName(projectId, name) {
+		const instances = await this.listRedis(projectId);
+		const normalizedName = name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+		const match = instances.find((redis) => redis.name === name || redis.appName === normalizedName);
+		return match ? this.getRedis(match.redisId) : void 0;
+	}
+	/**
+	* Create a new Redis instance
+	*/
+	async createRedis(name, projectId, environmentId, options) {
+		return this.post("redis.create", {
+			name,
+			projectId,
+			environmentId,
+			appName: options?.appName ?? name.toLowerCase().replace(/[^a-z0-9-]/g, "-"),
+			databasePassword: options?.databasePassword,
+			dockerImage: options?.dockerImage ?? "redis:8",
+			description: options?.description ?? `Redis instance for ${name}`
+		});
+	}
+	/**
+	* Find or create a Redis instance by name
+	*/
+	async findOrCreateRedis(name, projectId, environmentId, options) {
+		const existing = await this.findRedisByName(projectId, name);
+		if (existing) return {
+			redis: existing,
+			created: false
+		};
+		return {
+			redis: await this.createRedis(name, projectId, environmentId, options),
+			created: true
+		};
+	}
+	/**
+	* Get a Redis instance by ID
+	*/
+	async getRedis(redisId) {
+		return this.get(`redis.one?redisId=${redisId}`);
+	}
+	/**
+	* Deploy a Redis instance
+	*/
+	async deployRedis(redisId) {
+		await this.post("redis.deploy", { redisId });
+	}
+	/**
+	* Save environment variables for Redis
+	*/
+	async saveRedisEnv(redisId, env) {
+		await this.post("redis.saveEnvironment", {
+			redisId,
+			env
+		});
+	}
+	/**
+	* Set external port for Redis (for external access)
+	*/
+	async saveRedisExternalPort(redisId, externalPort) {
+		await this.post("redis.saveExternalPort", {
+			redisId,
+			externalPort
+		});
+	}
+	/**
+	* Update Redis configuration
+	*/
+	async updateRedis(redisId, updates) {
+		await this.post("redis.update", {
+			redisId,
+			...updates
+		});
+	}
+	/**
+	* Delete a Redis instance
+	*/
+	async deleteRedis(redisId) {
+		await this.post("redis.remove", { redisId });
+	}
+	/**
+	* Create a new domain for an application
+	*/
+	async createDomain(options) {
+		return this.post("domain.create", options);
+	}
+	/**
+	* Update an existing domain
+	*/
+	async updateDomain(domainId, updates) {
+		await this.post("domain.update", {
+			domainId,
+			...updates
+		});
+	}
+	/**
+	* Delete a domain
+	*/
+	async deleteDomain(domainId) {
+		await this.post("domain.delete", { domainId });
+	}
+	/**
+	* Get a domain by ID
+	*/
+	async getDomain(domainId) {
+		return this.get(`domain.one?domainId=${domainId}`);
+	}
+	/**
+	* Get all domains for an application
+	*/
+	async getDomainsByApplicationId(applicationId) {
+		return this.get(`domain.byApplicationId?applicationId=${applicationId}`);
+	}
+	/**
+	* Validate a domain and trigger SSL certificate generation
+	*
+	* This should be called after DNS records are created and propagated.
+	* It triggers Let's Encrypt certificate generation for HTTPS domains.
+	*
+	* @param domain - The domain hostname to validate (e.g., 'api.example.com')
+	*/
+	async validateDomain(domain) {
+		return this.post("domain.validateDomain", { domain });
+	}
+	/**
+	* Auto-generate a domain name for an application
+	*/
+	async generateDomain(appName, serverId) {
+		return this.post("domain.generateDomain", {
+			appName,
+			serverId
+		});
+	}
+	/**
+	* List all backup destinations
+	*/
+	async listDestinations() {
+		return this.get("destination.all");
+	}
+	/**
+	* Get a destination by ID
+	*/
+	async getDestination(destinationId) {
+		return this.get(`destination.one?destinationId=${destinationId}`);
+	}
+	/**
+	* Create a new S3 backup destination
+	*/
+	async createDestination(options) {
+		return this.post("destination.create", { ...options });
+	}
+	/**
+	* Find a destination by name
+	*/
+	async findDestinationByName(name) {
+		return (await this.listDestinations()).find((d) => d.name === name);
+	}
+	/**
+	* Find or create a destination by name
+	*/
+	async findOrCreateDestination(name, options) {
+		const existing = await this.findDestinationByName(name);
+		if (existing) return {
+			destination: existing,
+			created: false
+		};
+		return {
+			destination: await this.createDestination({
+				name,
+				...options
+			}),
+			created: true
+		};
+	}
+	/**
+	* Update a destination
+	*/
+	async updateDestination(destinationId, updates) {
+		await this.post("destination.update", {
+			destinationId,
+			...updates
+		});
+	}
+	/**
+	* Delete a destination
+	*/
+	async deleteDestination(destinationId) {
+		await this.post("destination.remove", { destinationId });
+	}
+	/**
+	* Test connection to a destination
+	*/
+	async testDestinationConnection(destinationId) {
+		return this.post("destination.testConnection", { destinationId });
+	}
+	/**
+	* Create a backup schedule for postgres
+	*/
+	async createPostgresBackup(options) {
+		return this.post("backup.create", {
+			...options,
+			databaseType: "postgres"
+		});
+	}
+	/**
+	* List backups for a postgres database
+	*/
+	async listPostgresBackups(postgresId) {
+		return this.get(`backup.all?postgresId=${postgresId}&databaseType=postgres`);
+	}
+	/**
+	* Get a backup by ID
+	*/
+	async getBackup(backupId) {
+		return this.get(`backup.one?backupId=${backupId}`);
+	}
+	/**
+	* Update a backup schedule
+	*/
+	async updateBackup(backupId, updates) {
+		await this.post("backup.update", {
+			backupId,
+			...updates
+		});
+	}
+	/**
+	* Delete a backup schedule
+	*/
+	async deleteBackup(backupId) {
+		await this.post("backup.remove", { backupId });
+	}
+	/**
+	* Trigger a manual backup run
+	*/
+	async runBackupManually(backupId) {
+		await this.post("backup.manualBackup", { backupId });
+	}
+};
+//#endregion
+//#region src/deploy/sniffer.ts
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+* Resolve the path to a sniffer helper file.
+* Handles both dev (.ts with tsx) and production (.mjs from dist).
+*
+* In production: sniffer.ts is bundled into dist/index.mjs, but sniffer helper
+* files are output to dist/deploy/ as standalone modules for subprocess loading.
+*
+* In development: All files are in src/deploy/ and loaded via tsx.
+*/
+function resolveSnifferFile(baseName) {
+	const deployMjsPath = resolve(__dirname, "deploy", `${baseName}.mjs`);
+	if (existsSync(deployMjsPath)) return deployMjsPath;
+	const mjsPath = resolve(__dirname, `${baseName}.mjs`);
+	if (existsSync(mjsPath)) return mjsPath;
+	const tsPath = resolve(__dirname, `${baseName}.ts`);
+	if (existsSync(tsPath)) return tsPath;
+	return tsPath;
+}
+/**
+* Run a sniffer worker in the sandbox, with the sandbox's environment and
+* nothing of the deploy's: the deploy's Dokploy token, registry login and AWS
+* keys stay where they are. A worker that outlives the timeout is killed, and
+* comes back as the error the caller reports.
+*/
+async function runSniffer(run, workspacePath, cwd, nodeArgs) {
+	const sandbox = run.sandbox ?? activeSandbox() ?? new LocalSandbox({ root: resolve(workspacePath) });
+	try {
+		const result = await sandbox.exec("node", nodeArgs, {
+			cwd,
+			env: { ...sandbox.env },
+			timeoutMs: run.timeoutMs ?? 3e4,
+			output: "capture"
+		});
+		return {
+			stdout: result.stdout,
+			stderr: result.stderr,
+			code: result.exitCode
+		};
+	} catch (error) {
+		return { error: error instanceof Error ? error : new Error(String(error)) };
+	}
+}
+/** The worker's JSON answer: the last object on stdout naming `envVars`. */
+function snifferAnswer(stdout) {
+	try {
+		const jsonMatch = stdout.match(/\{[^{}]*"envVars"[^{}]*\}[^{]*$/);
+		return jsonMatch ? JSON.parse(jsonMatch[0]) : void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Get required environment variables for an app.
+*
+* Detection strategy (in order):
+* 1. Frontend apps: Returns empty (no server secrets)
+* 2. Apps with `requiredEnv`: Uses explicit list from config
+* 3. Entry apps: Imports entry file in subprocess to capture config.parse() calls
+* 4. Route-based apps: Loads route files and calls getEnvironment() on each construct
+* 5. Apps with `envParser` (no routes): Runs SnifferEnvironmentParser to detect usage
+* 6. Apps with neither: Returns empty
+*
+* This function handles "fire and forget" async operations gracefully,
+* capturing errors and unhandled rejections without failing the build.
+*
+* @param app - The normalized app configuration
+* @param appName - The name of the app
+* @param workspacePath - Absolute path to the workspace root
+* @param options - Optional configuration for sniffing behavior
+* @returns The sniffed environment with required variables
+*/
+async function sniffAppEnvironment(app, appName, workspacePath, options = {}) {
+	const { logWarnings = true, markOptional = false } = options;
+	const run = {
+		...options.sandbox ? { sandbox: options.sandbox } : {},
+		...options.timeoutMs ? { timeoutMs: options.timeoutMs } : {}
+	};
+	if (app.type === "web" || app.type === "mobile") {
+		const publicPrefix = getPublicEnvPrefix(app.framework);
+		const depVars = publicPrefix ? (app.dependencies ?? []).map((dep) => `${publicPrefix}${dep.toUpperCase()}_URL`) : [];
+		if (app.config) {
+			const sniffedVars = [];
+			const sniffedOptional = [];
+			const configPaths = [];
+			if (app.config.client) configPaths.push(app.config.client);
+			if (app.config.server) configPaths.push(app.config.server);
+			for (const configPath of configPaths) {
+				const result = await sniffEntryFile(configPath, app.path, workspacePath, run);
+				if (logWarnings && result.error) output.warn(`[sniffer] ${appName}: Config file "${configPath}" threw error during sniffing (env vars still captured): ${result.error.message}`);
+				sniffedVars.push(...result.envVars);
+				sniffedOptional.push(...result.optionalEnvVars);
+			}
+			const optionalEnvVars = [...new Set(sniffedOptional)];
+			return {
+				appName,
+				requiredEnvVars: applyMarkOptional([.../* @__PURE__ */ new Set([...depVars, ...sniffedVars])], optionalEnvVars, markOptional),
+				optionalEnvVars
+			};
+		}
+		return {
+			appName,
+			requiredEnvVars: depVars,
+			optionalEnvVars: []
+		};
+	}
+	if (app.entry) {
+		const result = await sniffEntryFile(app.entry, app.path, workspacePath, run);
+		if (logWarnings && result.error) output.warn(`[sniffer] ${appName}: Entry file threw error during sniffing (env vars still captured): ${result.error.message}`);
+		return {
+			appName,
+			requiredEnvVars: applyMarkOptional(result.envVars, result.optionalEnvVars, markOptional),
+			optionalEnvVars: result.optionalEnvVars
+		};
+	}
+	if (app.routes) {
+		const result = await sniffRouteFiles(normalizeRoutes(app.routes), app.path, workspacePath, run);
+		if (logWarnings && result.error) output.warn(`[sniffer] ${appName}: Route sniffing threw error (env vars still captured): ${result.error.message}`);
+		return {
+			appName,
+			requiredEnvVars: applyMarkOptional(result.envVars, result.optionalEnvVars, markOptional),
+			optionalEnvVars: result.optionalEnvVars
+		};
+	}
+	if (app.envParser) {
+		const result = await sniffEnvParser(app.envParser, app.path, workspacePath, run);
+		if (logWarnings) {
+			if (result.error) output.warn(`[sniffer] ${appName}: envParser threw error during sniffing (env vars still captured): ${result.error.message}`);
+			if (result.unhandledRejections.length > 0) output.warn(`[sniffer] ${appName}: Fire-and-forget rejections during sniffing (suppressed): ${result.unhandledRejections.map((e) => e.message).join(", ")}`);
+		}
+		return {
+			appName,
+			requiredEnvVars: applyMarkOptional(result.envVars, result.optionalEnvVars, markOptional),
+			optionalEnvVars: result.optionalEnvVars
+		};
+	}
+	return {
+		appName,
+		requiredEnvVars: [],
+		optionalEnvVars: []
+	};
+}
+/**
+* Apply the `?` suffix to optional variables in an env var list.
+* Only modifies the list when `markOptional` is true and there are optional vars.
+*/
+function applyMarkOptional(envVars, optionalEnvVars, markOptional) {
+	if (!markOptional || optionalEnvVars.length === 0) return envVars;
+	const optionalSet = new Set(optionalEnvVars);
+	return envVars.map((v) => optionalSet.has(v) ? `${v}?` : v);
+}
+/**
+* Sniff an entry file by importing it in a subprocess.
+*
+* Entry apps call `config.parse()` at module load time. To capture which
+* env vars are accessed, we:
+* 1. Spawn a subprocess with a module loader hook
+* 2. The loader intercepts `@geekmidas/envkit` and replaces EnvironmentParser
+*    with SnifferEnvironmentParser
+* 3. Import the entry file (triggers config.parse())
+* 4. Capture and return the accessed env var names
+*
+* This approach provides process isolation - each app is sniffed in its own
+* subprocess, preventing module cache pollution.
+*
+* @param entryPath - Relative path to the entry file (e.g., './src/index.ts')
+* @param appPath - The app's path relative to workspace (e.g., 'apps/auth')
+* @param workspacePath - Absolute path to workspace root
+* @returns EntrySniffResult with env vars and optional error
+*/
+async function sniffEntryFile(entryPath, appPath, workspacePath, run = {}) {
+	const fullEntryPath = resolve(workspacePath, appPath, entryPath);
+	const loaderPath = resolveSnifferFile("sniffer-loader");
+	const workerPath = resolveSnifferFile("sniffer-worker");
+	const ran = await runSniffer(run, workspacePath, resolve(workspacePath, appPath), nodeWithTsx(workerPath, [fullEntryPath], [loaderPath]));
+	if ("error" in ran) return {
+		envVars: [],
+		optionalEnvVars: [],
+		error: ran.error
+	};
+	const answer = snifferAnswer(ran.stdout);
+	if (answer) return {
+		envVars: answer.envVars || [],
+		optionalEnvVars: answer.optionalEnvVars || [],
+		error: answer.error ? new Error(answer.error) : void 0
+	};
+	return {
+		envVars: [],
+		optionalEnvVars: [],
+		error: /* @__PURE__ */ new Error(`Failed to sniff entry file (exit code ${ran.code}): ${ran.stderr || ran.stdout || "No output"}`)
+	};
+}
+/**
+* Sniff route files by loading constructs and calling getEnvironment().
+*
+* Route-based apps have endpoints, functions, crons, and subscribers that
+* use services. Each service's register() method accesses environment variables.
+*
+* This runs in a subprocess with tsx loader to properly handle TypeScript
+* compilation and path alias resolution (e.g., `src/...` imports).
+*
+* @param routes - Glob pattern(s) for route files
+* @param appPath - The app's path relative to workspace (e.g., 'apps/api')
+* @param workspacePath - Absolute path to workspace root
+* @returns EntrySniffResult with env vars and optional error
+*/
+async function sniffRouteFiles(routes, appPath, workspacePath, run = {}) {
+	const fullAppPath = resolve(workspacePath, appPath);
+	const workerPath = resolveSnifferFile("sniffer-routes-worker");
+	const pattern = (Array.isArray(routes) ? routes : [routes])[0];
+	if (!pattern) return {
+		envVars: [],
+		optionalEnvVars: [],
+		error: /* @__PURE__ */ new Error("No route patterns provided")
+	};
+	const ran = await runSniffer(run, workspacePath, fullAppPath, nodeWithTsx(workerPath, [fullAppPath, pattern]));
+	if ("error" in ran) return {
+		envVars: [],
+		optionalEnvVars: [],
+		error: ran.error
+	};
+	if (ran.stderr) ran.stderr.split("\n").filter((line) => line.trim()).forEach((line) => output.warn(line));
+	const answer = snifferAnswer(ran.stdout);
+	if (answer) return {
+		envVars: answer.envVars || [],
+		optionalEnvVars: answer.optionalEnvVars || [],
+		error: answer.error ? new Error(answer.error) : void 0
+	};
+	return {
+		envVars: [],
+		optionalEnvVars: [],
+		error: /* @__PURE__ */ new Error(`Failed to sniff route files (exit code ${ran.code}): ${ran.stderr || ran.stdout || "No output"}`)
+	};
+}
+/**
+* Run the SnifferEnvironmentParser on an envParser module to detect
+* which environment variables it accesses.
+*
+* In a subprocess, like the entry and route sniffers: the module is the
+* project's code, and it was imported into the deploy itself before — with
+* every credential the deploy held in reach. Fire-and-forget rejections are
+* collected there with the shared `sniffWithFireAndForget`.
+*
+* @param envParserPath - The envParser config (e.g., './src/config/env#envParser')
+* @param appPath - The app's path relative to workspace
+* @param workspacePath - Absolute path to workspace root
+* @returns SniffResult with env vars and any errors encountered
+*/
+async function sniffEnvParser(envParserPath, appPath, workspacePath, run = {}) {
+	const [modulePath, exportName = "default"] = envParserPath.split("#");
+	if (!modulePath) return {
+		envVars: [],
+		optionalEnvVars: [],
+		unhandledRejections: []
+	};
+	const appRoot = resolve(workspacePath, appPath);
+	const fullPath = resolve(appRoot, modulePath);
+	const workerPath = resolveSnifferFile("sniffer-envparser-worker");
+	const ran = await runSniffer(run, workspacePath, appRoot, nodeWithTsx(workerPath, [fullPath, exportName]));
+	if ("error" in ran) return {
+		envVars: [],
+		optionalEnvVars: [],
+		unhandledRejections: [],
+		error: ran.error
+	};
+	const answer = snifferAnswer(ran.stdout);
+	if (!answer) return {
+		envVars: [],
+		optionalEnvVars: [],
+		unhandledRejections: [],
+		error: /* @__PURE__ */ new Error(`Failed to sniff envParser (exit code ${ran.code}): ${ran.stderr || ran.stdout || "No output"}`)
+	};
+	for (const warning of answer.warnings ?? []) output.warn(warning);
+	return {
+		envVars: answer.envVars ?? [],
+		optionalEnvVars: answer.optionalEnvVars ?? [],
+		unhandledRejections: (answer.unhandledRejections ?? []).map((message) => new Error(message)),
+		...answer.error ? { error: new Error(answer.error) } : {}
+	};
+}
+/**
+* Sniff environment requirements for multiple apps.
+*
+* @param apps - Map of app name to app config
+* @param workspacePath - Absolute path to workspace root
+* @param options - Optional configuration for sniffing behavior
+* @returns Map of app name to sniffed environment
+*/
+async function sniffAllApps(apps, workspacePath, options = {}) {
+	const results = /* @__PURE__ */ new Map();
+	for (const [appName, app] of Object.entries(apps)) {
+		const sniffed = await sniffAppEnvironment(app, appName, workspacePath, options);
+		results.set(appName, sniffed);
+	}
+	return results;
+}
+//#endregion
+export { loginCommand as C, canPrompt as D, whoamiCommand as E, prompt as O, keyFingerprint as S, validateDokployToken as T, newLockHolder as _, NoDeployableApps as a, encryptSecrets as b, runDeploy as c, StateLocked as d, StateStoreBusy as f, createStateStore as g, contentVersion as h, DokployApiError as i, DocumentStateStore as l, StateVersionConflict as m, sniffAppEnvironment as n, RollbackFailed as o, StateStoreWithoutLocking as p, DokployApi as r, UnknownDeployApps as s, sniffAllApps as t, StageStateMissing as u, eventError as v, logoutCommand as w, encryption_exports as x, Redactor as y };
+
+//# sourceMappingURL=sniffer-BZ-OJO4Y.mjs.map