@geekmidas/cli 10.0.0-alpha.126 → 10.0.0-alpha.127

package/dist/index.mjs

@@ -2,28 +2,28 @@
 import { n as __require, t as __exportAll } from "./rolldown-runtime-BhDjJH2R.mjs";
 import { n as isGkmError, t as GkmError } from "./errors-D8Gwp5kU.mjs";
 import { _ as storeDokployCredentials, d as getDokployRegistryId, f as getDokployToken, g as removeGoDaddyCredentials, h as removeDokployCredentials, i as CommandFailed, l as getCredentialsPath, m as readCredentials, o as DEFAULT_TIMEOUT_MS, u as getDokployCredentials, v as storeGoDaddyToken, y as storeHostingerToken } from "./credentials-DpfnUvIR.mjs";
-import { C as dockerCompose, S as sshTarget, _ as parseDigests, b as dockerHost, c as edgeRef, f as derivedCredentials, h as EDGE_PROJECT, i as ComposePushNeedsBuild, l as removeEdgeRoutes, m as stackPlan, o as stackOverrideFile, p as stackDir, r as ComposePinNeedsPull, t as composeTarget, u as composeProject, v as pinnedRef, w as projectNetwork, y as composeServer } from "./compose-CvHIjMDd.mjs";
+import { C as dockerCompose, S as sshTarget, _ as parseDigests, b as dockerHost, c as edgeRef, f as derivedCredentials, h as EDGE_PROJECT, i as ComposePushNeedsBuild, l as removeEdgeRoutes, m as stackPlan, o as stackOverrideFile, p as stackDir, r as ComposePinNeedsPull, t as composeTarget, u as composeProject, v as pinnedRef, w as projectNetwork, y as composeServer } from "./compose-CIzCcsoz.mjs";
 import { A as InvalidStages, F as stageProblems, P as deployedProblems, R as stageSampleRate, a as allConstructGlobs, d as getAppGkmConfig, j as TEST_STAGE, u as getAppBuildOrder } from "./workspace-DBHF9Gba.mjs";
-import { D as BACKUPS_SERVICE, F as backupFile, I as backupsPrefix, L as runTime, N as backupDatabases, O as BACKUPS_URL_KEY, R as stageBackups, b as awsEndpoint, k as RUNNER_PATH, x as awsProvisioningCredentials, y as awsClientConfig } from "./snsSubscriptions-R_AKBZYK.mjs";
+import { D as BACKUPS_SERVICE, F as backupFile, I as backupsPrefix, L as runTime, N as backupDatabases, O as BACKUPS_URL_KEY, R as stageBackups, b as awsEndpoint, k as RUNNER_PATH, x as awsProvisioningCredentials, y as awsClientConfig } from "./snsSubscriptions-BxLJQH4u.mjs";
 import { o as email } from "./schemas-BCwKKA42.mjs";
-import { $n as telemetryOf, $t as maskPassword, Bt as createCredentialsPreload, Cn as postgresDatabaseNames, Ct as backendsOf$1, Et as reconcileWorkspace, Fn as projectKey, G as workerBundleName, Gt as loadPortState, Ht as findAvailablePort, It as cacheBackendFor, J as CronGenerator, K as workerEntryDir, Kn as TELEMETRY_CONTAINER, Kt as loadSecretsForApp, Lt as eventsBackendFor, Mn as FileSecretsStore, Nn as getKeyPath, Nt as pgClient, Ot as LOCAL_CA_PATH, Pt as CLUSTER_DATABASE, Q as processorInfo, Qn as surfaceClientTraced, R as dockerCommand, Rt as providerOf, St as FAKE_ENV, Tn as quoteIdentifier, Tt as derivedContainers, Ut as isPortAvailable, Vt as createEntryWrapper, W as WorkerGenerator, Wt as loadEnvFiles, X as processorBundleName, Y as ProcessorGenerator, Yn as appTelemetry, Yt as secretsStoreFor, Z as processorEntryDir, Zn as scopeTelemetryEnv, a as dnsResources, dn as isImageBuild, dr as primaryPortKey, fr as LOCAL_LOGS_EMAIL, hn as workerUnits, jn as readLocalCredentials, kt as forgetState, l as describeActor, lr as portsOf, mn as processorUnits, nn as withCustomSecret, or as describeServices, pn as isUnder, q as QueueGenerator, qt as prepareEntryCredentials, sr as fakeKey, tn as toEmbeddableSecrets, un as imageBuildCredentials, ut as assertDevServicesFlag, wt as constructGlobs } from "./seeds-Cfejy8wj.mjs";
-import { t as appKey } from "./derive-B4vDpzgP.mjs";
+import { $n as telemetryOf, $t as maskPassword, Bt as createCredentialsPreload, Cn as postgresDatabaseNames, Ct as backendsOf$1, Et as reconcileWorkspace, Fn as projectKey, G as workerBundleName, Gt as loadPortState, Ht as findAvailablePort, It as cacheBackendFor, J as CronGenerator, K as workerEntryDir, Kn as TELEMETRY_CONTAINER, Kt as loadSecretsForApp, Lt as eventsBackendFor, Mn as FileSecretsStore, Nn as getKeyPath, Nt as pgClient, Ot as LOCAL_CA_PATH, Pt as CLUSTER_DATABASE, Q as processorInfo, Qn as surfaceClientTraced, R as dockerCommand, Rt as providerOf, St as FAKE_ENV, Tn as quoteIdentifier, Tt as derivedContainers, Ut as isPortAvailable, Vt as createEntryWrapper, W as WorkerGenerator, Wt as loadEnvFiles, X as processorBundleName, Y as ProcessorGenerator, Yn as appTelemetry, Yt as secretsStoreFor, Z as processorEntryDir, Zn as scopeTelemetryEnv, a as dnsResources, dn as isImageBuild, dr as primaryPortKey, fr as LOCAL_LOGS_EMAIL, hn as workerUnits, jn as readLocalCredentials, kt as forgetState, l as describeActor, lr as portsOf, mn as processorUnits, nn as withCustomSecret, or as describeServices, pn as isUnder, q as QueueGenerator, qt as prepareEntryCredentials, sr as fakeKey, tn as toEmbeddableSecrets, un as imageBuildCredentials, ut as assertDevServicesFlag, wt as constructGlobs } from "./seeds-BX9pskrU.mjs";
+import { t as appKey } from "./derive-Dew0QoGe.mjs";
 import { a as opensKmsKeys, n as driversFor, r as eventsBackendsIn, t as cacheBackendsIn, u as isCacheBackend } from "./drivers-CDjpjakg.mjs";
 import { n as deployIdentity } from "./identity-CBXr4wNi.mjs";
-import { a as startTelemetryCode, c as parseTelemetryFlag, i as routeTelemetry, n as runtimeFor, o as telemetryFor, r as mountRequestSpansCode, s as writeTelemetryModule, t as EndpointGenerator } from "./EndpointGenerator-errMeldx.mjs";
-import { d as ConstructGenerator, i as discover, r as consumedBy, u as withOwningTsconfigJsx } from "./discover-CzGM5P3p.mjs";
+import { a as startTelemetryCode, c as parseTelemetryFlag, i as routeTelemetry, n as runtimeFor, o as telemetryFor, r as mountRequestSpansCode, s as writeTelemetryModule, t as EndpointGenerator } from "./EndpointGenerator-B99OGzbO.mjs";
+import { d as ConstructGenerator, i as discover, r as consumedBy, u as withOwningTsconfigJsx } from "./discover-DOhYSKY_.mjs";
 import { ConfigNotFound, NotABackendApp, NotInAnApp, loadAppConfig, loadConfig, loadWorkspaceConfig, loadWorkspaceSettings, parseModuleConfig } from "./config.mjs";
-import { n as assertTestCredentials, t as SubscriberGenerator } from "./SubscriberGenerator-BALddfuW.mjs";
+import { n as assertTestCredentials, t as SubscriberGenerator } from "./SubscriberGenerator-0ruEmYXj.mjs";
 import { generateOpenApi, openapiCommand, resolveOpenApiConfig } from "./openapi.mjs";
 import { a as describeHolder, c as withAppPorts, i as assignAppPorts, o as describeMove, r as appTag, s as holderOf, t as APP_TAG_ENV } from "./appPorts-BoXMwolc.mjs";
 import { n as withCompute, r as withRoutes, t as manifestModule } from "./emit-CiJGdy_f.mjs";
 import { t as LocalSandbox } from "./local-B7Zv1NoA.mjs";
-import { S as createStateStore, k as keyFingerprint, n as sniffAppEnvironment, o as DokployApi } from "./sniffer-CCkdzjiU.mjs";
-import { t as deploy$1 } from "./deploy-CIPwTJ47.mjs";
-import { o as loadCredentialSchemas, t as CredentialsInvalid } from "./credentialSchemas-DaMpt-Dx.mjs";
-import { t as LocalStateStore } from "./LocalStateStore-DxoNpiBg.mjs";
+import { S as createStateStore, k as keyFingerprint, n as sniffAppEnvironment, o as DokployApi } from "./sniffer-XnAnEbuI.mjs";
+import { t as deploy$1 } from "./deploy-BVf6c_h8.mjs";
+import { o as loadCredentialSchemas, t as CredentialsInvalid } from "./credentialSchemas-DPOGqOrU.mjs";
+import { t as LocalStateStore } from "./LocalStateStore-EenTHwr4.mjs";
 import { a as getExecCommand, c as validateProjectName, i as findWorkspaceRoot, n as detectPackageManager$1, o as getInstallCommand, r as findWorkspacePackages, s as getRunCommand, t as checkDirectoryExists } from "./utils-D_fxUqvU.mjs";
-import { a as writeTestHarness, i as TEST_MANIFEST_ENV, n as TEST_READY_FILE, t as TEST_READY_ENV } from "./ready-DrvaAwKv.mjs";
+import { a as writeTestHarness, i as TEST_MANIFEST_ENV, n as TEST_READY_FILE, t as TEST_READY_ENV } from "./ready-BwtLriAF.mjs";
 import { createRequire } from "node:module";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { Command, Option } from "commander";
@@ -51,7 +51,7 @@ import crypto from "crypto";
 import { Function } from "@geekmidas/constructs/functions";
 import { Topic } from "@geekmidas/constructs/topic";
 //#region package.json
-var version = "10.0.0-alpha.126";
+var version = "10.0.0-alpha.127";
 //#endregion
 //#region src/prompt.ts
 /**
@@ -134,7 +134,7 @@ const logger$8 = console;
 * Validate Dokploy token by making a test API call
 */
 async function validateDokployToken(endpoint, token) {
-	const { DokployApi } = await import("./sniffer-CCkdzjiU.mjs").then((n) => n.c);
+	const { DokployApi } = await import("./sniffer-XnAnEbuI.mjs").then((n) => n.c);
 	return new DokployApi({
 		baseUrl: endpoint,
 		token
@@ -2174,7 +2174,7 @@ async function execCommand(commandArgs, options = {}, stageDeps) {
 	const cwd = options.cwd ?? process.cwd();
 	if (!commandArgs[0]) throw new NoCommandSpecified();
 	if (options.stage && !isImageBuild()) {
-		const { execOnStage } = await import("./stage-DCaxqm-G.mjs").then((n) => n.n);
+		const { execOnStage } = await import("./stage-mta618Oy.mjs").then((n) => n.n);
 		const { loadWorkspaceConfig } = await import("./config.mjs");
 		const { workspace } = await loadWorkspaceConfig(cwd);
 		if (options.stage !== workspace.stages.local) {
@@ -2401,7 +2401,7 @@ async function devCommand(options) {
 		});
 		for (const key of Object.keys(appSecrets)) if (!(key in scoped)) delete appSecrets[key];
 		Object.assign(appSecrets, scoped);
-		const own = reconciled.plan.resources.find((r) => (r.kind === "rest-api" || r.kind === "site") && appKey(r.id) === workspaceAppName);
+		const own = reconciled.plan.resources.find((r) => (r.kind === "rest-api" || r.kind === "websocket-api" || r.kind === "site") && appKey(r.id) === workspaceAppName);
 		publicUrl = own ? reconciled.env[own.envKey] : void 0;
 		manifest = reconciled.manifest;
 		telemetryUi = telemetryUiOf(reconciled.services);
@@ -2747,14 +2747,14 @@ async function workspaceDevCommand(configured, options) {
 	for (const { id, port } of fakes) logger$5.log(`🎭 ${id} fake: http://localhost:${port}`);
 	logger$5.log(options.migrate || options.seed ? "🗄️  Migrating the databases" : "🗄️  Checking for pending migrations");
 	if (options.migrate || options.seed) {
-		const { prepareDevDatabases } = await import("./migrate-DZeNpuX2.mjs");
+		const { prepareDevDatabases } = await import("./migrate-DQPEUiFC.mjs");
 		await prepareDevDatabases(workspace, reconciled.env, { seed: !!options.seed });
-	} else await import("./migrate-DZeNpuX2.mjs").then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
+	} else await import("./migrate-DQPEUiFC.mjs").then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
 		logger$5.log(`⚠️  Could not check for pending migrations: ${error instanceof Error ? error.message : String(error)}`);
 	});
 	const appUrls = {};
 	for (const resource of reconciled.plan.resources) {
-		if (resource.kind !== "rest-api" && resource.kind !== "site") continue;
+		if (resource.kind !== "rest-api" && resource.kind !== "websocket-api" && resource.kind !== "site") continue;
 		const address = reconciled.env[resource.envKey];
 		if (address) appUrls[resource.id] = address;
 	}
@@ -3082,7 +3082,7 @@ ${credentialsInjection}${parentWatch}const port = process.argv.includes('--port'
 
 ${telemetry}
 // Dynamic import so Credentials are populated before the surface evaluates
-const { app: surface } = await import('${appImportPath}');
+const { app: surface, attach } = await import('${appImportPath}');
 
 // Behind the request spans when there are any, as the production server is.
 const { Hono } = await import('hono');
@@ -3092,7 +3092,9 @@ if (requestSpans) {
   app.route('/', surface);
 }
 
-${serveCode.replace(/^ {4}/gm, "")}
+${serveCode.replace(/^ {4}/gm, "")}${runtime === "bun" ? "" : `
+// A surface that takes upgrades — a WebSocket one — is handed them.
+attach?.(server);`}
 `;
 	return `#!/usr/bin/env node
 /**
@@ -3524,7 +3526,7 @@ function servesItself(construct) {
 */
 function selfServingSurface(options) {
 	const { declared, sources, workspaceRoot, appRoot } = options;
-	const served = servedSurface(declared, workspaceRoot, appRoot);
+	const served = servedSurface(declared, workspaceRoot, appRoot) ?? servedWebSocketApi(declared, workspaceRoot, appRoot);
 	const source = served ? sources[served.id] : void 0;
 	if (!served || !source || !servesItself(source.construct)) return void 0;
 	return {
@@ -3532,6 +3534,15 @@ function selfServingSurface(options) {
 		source
 	};
 }
+/** The WebSocket surface whose `path` is the directory being built. */
+function servedWebSocketApi(declared, workspaceRoot, appRoot) {
+	return Object.values(declared).find((d) => d.kind === "websocket-api" && resolve(workspaceRoot, d.path) === resolve(appRoot));
+}
+/** An import specifier for `file`, from `outputDir`, as the bundle sees it. */
+function specifierOf(outputDir, file) {
+	const rel = relative(outputDir, file).replace(/\.ts$/, ".js");
+	return rel.startsWith(".") ? rel : `./${rel}`;
+}
 /**
 * The entry for a surface that serves itself.
 *
@@ -3544,10 +3555,12 @@ function selfServingSurface(options) {
 * The import specifier comes from discovery, which globbed the file and
 * imported it. Nothing about the surface is named here.
 */
-async function writeSurfaceEntry(outputDir, source) {
+async function writeSurfaceEntry(outputDir, source, served = []) {
 	await mkdir(outputDir, { recursive: true });
-	const rel = relative(outputDir, source.file).replace(/\.ts$/, ".js");
-	const specifier = rel.startsWith(".") ? rel : `./${rel}`;
+	const specifier = specifierOf(outputDir, source.file);
+	const modules = served.filter((file) => file !== source.file);
+	const imports = modules.map((file, index) => `import * as served${index} from '${specifierOf(outputDir, file)}';\n`).join("");
+	const options = modules.length ? `{ envParser, context: snifferContext, modules: [${modules.map((_, index) => `served${index}`).join(", ")}] }` : "{ envParser, context: snifferContext }";
 	await writeFile(join(outputDir, "app.ts"), `/**
  * Generated entry for a surface that serves itself.
  *
@@ -3557,10 +3570,19 @@ async function writeSurfaceEntry(outputDir, source) {
 import { snifferContext } from '@geekmidas/constructs';
 import { defaultEnvParser } from '@geekmidas/constructs/endpoints';
 import { ${source.exportName} as surface } from '${specifier}';
-
+${imports}
 const envParser = defaultEnvParser();
 
-export const { app } = await surface.server({ envParser, context: snifferContext });
+const served = await surface.server(${options});
+
+export const app = served.app;
+/** Hands the HTTP server's upgrades to the surface, when it takes them. */
+export const attach: ((server: unknown) => void) | undefined = served.attach;
+/**
+ * Ends what the HTTP server would otherwise wait on forever — open sockets —
+ * before it is closed.
+ */
+export const release: (() => Promise<void>) | undefined = served.release;
 
 export default app;
 `);
@@ -3588,6 +3610,9 @@ const shutdown = async () => {
   shuttingDown = true;
   const deadline = Number(process.env.GKM_SHUTDOWN_TIMEOUT_MS) || 8000;
   setTimeout(() => process.exit(1), deadline).unref();
+  // Upgraded sockets hold the server open: they are closed first, with a code
+  // that tells a client to reconnect elsewhere.
+  await release?.();
   await new Promise<void>((resolve) => server.close(() => resolve()));
   await runShutdownHooks((error) => console.error(error));
   process.exit(0);
@@ -3606,7 +3631,7 @@ import { serve } from '@hono/node-server';
 import { Hono } from 'hono';
 ${options.gracefulShutdown ? "import { runShutdownHooks } from '@geekmidas/constructs';\n" : ""}
 ${startTelemetryCode([options.healthCheck])}
-const { app: surface } = await import('./app.js');
+const { app: surface, attach, release } = await import('./app.js');
 
 const port = Number(process.env.PORT) || 3000;
 
@@ -3618,6 +3643,7 @@ app.get(${JSON.stringify(options.healthCheck)}, (c) =>
 app.route('/', surface);
 
 const server = serve({ fetch: app.fetch, port });
+attach?.(server);
 console.log(JSON.stringify({ msg: 'Production server started', port }));
 ${shutdown}`);
 	return path;
@@ -3795,12 +3821,14 @@ async function buildApp(input) {
 	const constructGlobs = config.constructs;
 	const constructSources = {};
 	const background = {};
+	const served = {};
 	const declared = constructGlobs ? await discover({
 		patterns: constructGlobs,
 		cwd: appRoot,
 		bustCache,
 		sources: constructSources,
-		background
+		background,
+		served
 	}) : {};
 	const selfServing = selfServingSurface({
 		declared,
@@ -3809,7 +3837,7 @@ async function buildApp(input) {
 		appRoot
 	});
 	if (selfServing) {
-		await writeSurfaceEntry(join(appRoot, ".gkm", "server"), selfServing.source);
+		await writeSurfaceEntry(join(appRoot, ".gkm", "server"), selfServing.source, served[selfServing.id] ?? []);
 		const telemetry = telemetryFor({
 			node: telemetryOf(declared, selfServing.id),
 			appRoot,
@@ -3826,7 +3854,7 @@ async function buildApp(input) {
 				...production,
 				...telemetry ? { telemetry } : {}
 			});
-			const { bundleServer } = await import("./bundler-2V2PR_E-.mjs");
+			const { bundleServer } = await import("./bundler-DqHozK8W.mjs");
 			await bundleServer({
 				entryPoint,
 				outputDir: join(outputDir, "dist"),
@@ -4071,7 +4099,7 @@ async function buildWorkers(input) {
 		});
 		logger$4.log(`Generated worker ${worker.id}: ${crons.length} crons, ${queues.length} queues, ${subscribers.length} subscribers`);
 		if (!input.bundle) continue;
-		const { bundleServer } = await import("./bundler-2V2PR_E-.mjs");
+		const { bundleServer } = await import("./bundler-DqHozK8W.mjs");
 		const outfile = workerBundleName(worker.id);
 		await bundleServer({
 			entryPoint,
@@ -4113,7 +4141,7 @@ async function buildProcessors(input) {
 		for (const { key, construct } of processors) infos.push(await processorInfo(key, construct, handler, context));
 		logger$4.log(`Generated processors for ${fileServerId}: ${processors.map(({ key }) => key).join(", ")}`);
 		if (!input.bundle) continue;
-		const { bundleServer } = await import("./bundler-2V2PR_E-.mjs");
+		const { bundleServer } = await import("./bundler-DqHozK8W.mjs");
 		const outfile = processorBundleName(fileServerId);
 		await bundleServer({
 			entryPoint,
@@ -4196,7 +4224,7 @@ async function buildForTarget(target, context, appRoot, workspaceRoot, endpointG
 		let masterKey;
 		if (context.production?.bundle && !skipBundle) {
 			logger$4.log(`\n📦 Bundling production server...`);
-			const { bundleServer } = await import("./bundler-2V2PR_E-.mjs");
+			const { bundleServer } = await import("./bundler-DqHozK8W.mjs");
 			const allConstructs = [
 				...endpoints.map((e) => e.construct),
 				...functions.map((f) => f.construct),
@@ -6030,25 +6058,25 @@ function loadPackageJson() {
 * Run: pnpm --filter @geekmidas/cli sync-versions
 */
 const GEEKMIDAS_VERSIONS = {
-	"@geekmidas/audit": "~10.0.0-alpha.126",
-	"@geekmidas/auth": "~10.0.0-alpha.126",
-	"@geekmidas/cache": "~10.0.0-alpha.126",
-	"@geekmidas/client": "~10.0.0-alpha.126",
-	"@geekmidas/cloud": "~10.0.0-alpha.126",
-	"@geekmidas/constructs": "~10.0.0-alpha.126",
-	"@geekmidas/db": "~10.0.0-alpha.126",
-	"@geekmidas/emailkit": "~10.0.0-alpha.126",
-	"@geekmidas/envkit": "~10.0.0-alpha.126",
-	"@geekmidas/errors": "~10.0.0-alpha.126",
-	"@geekmidas/events": "~10.0.0-alpha.126",
-	"@geekmidas/logger": "~10.0.0-alpha.126",
-	"@geekmidas/manifest": "~10.0.0-alpha.126",
-	"@geekmidas/rate-limit": "~10.0.0-alpha.126",
-	"@geekmidas/schema": "~10.0.0-alpha.126",
-	"@geekmidas/services": "~10.0.0-alpha.126",
-	"@geekmidas/storage": "~10.0.0-alpha.126",
-	"@geekmidas/telescope": "~10.0.0-alpha.126",
-	"@geekmidas/testkit": "~10.0.0-alpha.126",
+	"@geekmidas/audit": "~10.0.0-alpha.127",
+	"@geekmidas/auth": "~10.0.0-alpha.127",
+	"@geekmidas/cache": "~10.0.0-alpha.127",
+	"@geekmidas/client": "~10.0.0-alpha.127",
+	"@geekmidas/cloud": "~10.0.0-alpha.127",
+	"@geekmidas/constructs": "~10.0.0-alpha.127",
+	"@geekmidas/db": "~10.0.0-alpha.127",
+	"@geekmidas/emailkit": "~10.0.0-alpha.127",
+	"@geekmidas/envkit": "~10.0.0-alpha.127",
+	"@geekmidas/errors": "~10.0.0-alpha.127",
+	"@geekmidas/events": "~10.0.0-alpha.127",
+	"@geekmidas/logger": "~10.0.0-alpha.127",
+	"@geekmidas/manifest": "~10.0.0-alpha.127",
+	"@geekmidas/rate-limit": "~10.0.0-alpha.127",
+	"@geekmidas/schema": "~10.0.0-alpha.127",
+	"@geekmidas/services": "~10.0.0-alpha.127",
+	"@geekmidas/storage": "~10.0.0-alpha.127",
+	"@geekmidas/telescope": "~10.0.0-alpha.127",
+	"@geekmidas/testkit": "~10.0.0-alpha.127",
 	"@geekmidas/cli": `~${loadPackageJson().version}`
 };
 //#endregion
@@ -7241,7 +7269,7 @@ const COMMIT = /^[0-9a-f]{40}$/;
 * The `uses:` value for the stages action, with a comment saying which CLI
 * release the pinned commit is.
 */
-function stagesActionUses(commit = "fba5cacc6aa27bc28fb25954325a4a62c13302e2", version = cliVersion()) {
+function stagesActionUses(commit = "ba2d3fd603ba7812a218838e777b845267582e05", version = cliVersion()) {
 	return commit && COMMIT.test(commit) ? `${STAGES_ACTION}@${commit} # @geekmidas/cli ${version}` : `${STAGES_ACTION}@main # pin to a commit SHA: see the action's README`;
 }
 //#endregion
@@ -16213,8 +16241,8 @@ function testDatabases(reconciled) {
 * starts without the reference data the app needs.
 */
 async function migrateTestStage(workspace, env) {
-	const { migrateAndSeed } = await import("./migrate-DZeNpuX2.mjs");
-	const { discover } = await import("./discover-CzGM5P3p.mjs").then((n) => n.a);
+	const { migrateAndSeed } = await import("./migrate-DQPEUiFC.mjs");
+	const { discover } = await import("./discover-DOhYSKY_.mjs").then((n) => n.a);
 	const sources = {};
 	const manifest = await discover({
 		patterns: constructGlobs(workspace),
@@ -16638,7 +16666,7 @@ program.command("eas:sync").description("Set up a mobile app's EAS project for a
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { easSync } = await import("./eas-CxX2RCE_.mjs");
+		const { easSync } = await import("./eas-Dlr1Lw56.mjs");
 		await easSync(options);
 	} catch (error) {
 		exitWithError(error);
@@ -16648,7 +16676,7 @@ program.command("publish").description("Ship a mobile app for a deployed stage:
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { publish, PublishModeConflict } = await import("./publish-BsnDeOVL.mjs");
+		const { publish, PublishModeConflict } = await import("./publish-VYt4xOOc.mjs");
 		if (options.build && options.update) throw new PublishModeConflict();
 		const { build, update, ...rest } = options;
 		await publish({
@@ -16664,7 +16692,7 @@ program.command("deploy:google-play").description("Let EAS Submit publish a mobi
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { deployGooglePlay } = await import("./googlePlay-DTuvDHi5.mjs");
+		const { deployGooglePlay } = await import("./googlePlay-Nqc4EAiC.mjs");
 		await deployGooglePlay(options);
 	} catch (error) {
 		exitWithError(error);
@@ -16686,7 +16714,7 @@ program.command("migrate").description("Apply each database construct's migratio
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrateCommand } = await import("./migrate-DZeNpuX2.mjs");
+		const { migrateCommand } = await import("./migrate-DQPEUiFC.mjs");
 		await migrateCommand({
 			...options,
 			...construct ? { construct } : {}
@@ -16699,7 +16727,7 @@ program.command("seed").description("Migrate, then run each database construct's
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { seedCommand } = await import("./migrate-DZeNpuX2.mjs");
+		const { seedCommand } = await import("./migrate-DQPEUiFC.mjs");
 		await seedCommand({
 			...options,
 			...construct ? { construct } : {}
@@ -16712,7 +16740,7 @@ program.command("migration").description("Write a construct's next migration: an
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrationCommand } = await import("./migrate-DZeNpuX2.mjs");
+		const { migrationCommand } = await import("./migrate-DQPEUiFC.mjs");
 		await migrationCommand({
 			construct,
 			...name ? { name } : {}
@@ -16812,7 +16840,7 @@ program.command("secrets:add").description("Build the keys a stage must be given
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { secretsAddCommand } = await import("./add-CamA9Uqv.mjs");
+		const { secretsAddCommand } = await import("./add-CgyyN6aF.mjs");
 		await secretsAddCommand(options);
 	} catch (error) {
 		exitWithError(error);
@@ -16822,7 +16850,7 @@ program.command("encryption:rotate").description("Add a new current key to an En
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { encryptionRotateCommand } = await import("./encryption-BFSrt89F.mjs");
+		const { encryptionRotateCommand } = await import("./encryption-D0tWRvy_.mjs");
 		await encryptionRotateCommand(construct, options);
 	} catch (error) {
 		exitWithError(error);
@@ -16832,7 +16860,7 @@ program.command("encryption:retire").description("Remove an old key from an Encr
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { encryptionRetireCommand } = await import("./encryption-BFSrt89F.mjs");
+		const { encryptionRetireCommand } = await import("./encryption-D0tWRvy_.mjs");
 		await encryptionRetireCommand(construct, key, options);
 	} catch (error) {
 		exitWithError(error);
@@ -16871,7 +16899,7 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		const { loadWorkspaceConfig } = await import("./config.mjs");
 		const { reconcileMissingSecrets } = await import("./reconcile--I7V4Klj.mjs");
-		const { secretsStoreFor } = await import("./seeds-Cfejy8wj.mjs").then((n) => n.Zt);
+		const { secretsStoreFor } = await import("./seeds-BX9pskrU.mjs").then((n) => n.Zt);
 		const { workspace } = await loadWorkspaceConfig();
 		const stage = options.stage ?? workspace.stages.local;
 		const store = await secretsStoreFor(workspace, stage);
@@ -16880,7 +16908,7 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 			console.error(`No secrets found for stage "${stage}". Run "gkm secrets:init --stage ${stage}" first.`);
 			process.exit(1);
 		}
-		const { derivedContainers } = await import("./seeds-Cfejy8wj.mjs").then((n) => n.Dt);
+		const { derivedContainers } = await import("./seeds-BX9pskrU.mjs").then((n) => n.Dt);
 		const result = reconcileMissingSecrets(secrets, workspace, await derivedContainers(workspace, stage));
 		if (!result) {
 			console.log(`\n✓ Secrets for stage "${stage}" are up-to-date`);
@@ -16897,14 +16925,14 @@ program.command("secrets:migrate").description("Copy a deployed stage's secrets
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { secretsMigrateCommand } = await import("./migrate-BABIuzQj.mjs");
+		const { secretsMigrateCommand } = await import("./migrate-C7exqXTD.mjs");
 		await secretsMigrateCommand(options);
 	} catch (error) {
 		exitWithError(error);
 	}
 });
 program.command("deploy").description("Deploy a stage through its target").option("--target <name>", "Deploy target: dokploy, compose, sst, or one named in deploy.targets (default: deploy.default)").option("--provider <provider>", "[DEPRECATED] Use --target instead").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").option("--tag <tag>", "Image tag (default: stage-timestamp; compose: the commit). Compose pulls a given tag").option("--skip-push", "Skip pushing image to registry").option("--skip-build", "Skip build step (use existing build)").option("--json", "Write events as JSON lines instead of progress; never prompts").option("--dry-run", "Show what would be created or reused; change, build and push nothing").option("--atomic", "If the release fails, roll back every app it released, not only the failed ones").option("--allow-dev-services", "Server targets: run the dev service (MinIO, Mailpit) for every bucket and mail the stage doesn't account for. Not production-grade").option("--skip-dns", "Compose: neither write the public hosts' DNS records nor check they point at GKM_SERVER_IPV4 (a CDN or proxy in front, or records written elsewhere)").option("--rotate-keys", "Deployed stage: each provider issues its runtime keys a successor (the old one is deleted by the next deploy)").option("--retire-old-keys", "Deployed stage: delete a rotated-out key now instead of on the next deploy").action(async (options) => {
-	const { deployCli } = await import("./cli-PiyYqHGx.mjs");
+	const { deployCli } = await import("./cli-D_BQkb4B.mjs");
 	const globalOptions = program.opts();
 	const code = await deployCli({
 		cwd: resolve(globalOptions.cwd ?? process.cwd()),
@@ -16924,8 +16952,8 @@ program.command("deploy").description("Deploy a stage through its target").optio
 });
 program.command("deploy:rollback").description("Put a stage's app back on its previous release (Dokploy): one app with --app, every app with --atomic").requiredOption("--stage <stage>", "A deployed stage").option("--app <app>", "The app to roll back").option("--atomic", "Roll back every app that has an earlier release").action(async (options) => {
 	try {
-		const { rollbackStage } = await import("./rollback-BkhVrtAf.mjs").then((n) => n.a);
-		const { terminalCredentials } = await import("./terminal-bqY33lpN.mjs");
+		const { rollbackStage } = await import("./rollback-dUShCpZu.mjs").then((n) => n.a);
+		const { terminalCredentials } = await import("./terminal-CebFDhWQ.mjs");
 		const globalOptions = program.opts();
 		await rollbackStage({
 			cwd: resolve(globalOptions.cwd ?? process.cwd()),
@@ -16943,7 +16971,7 @@ program.command("compose:server").description("Set up a stage's server for compo
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { composeServerCommand } = await import("./serverSetup-C8ZbHTm_.mjs");
+		const { composeServerCommand } = await import("./serverSetup-BvHpm7QD.mjs");
 		await composeServerCommand(options);
 	} catch (error) {
 		exitWithError(error);
@@ -16968,7 +16996,7 @@ program.command("deploy:github").description("Let GitHub Actions deploy a stage:
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { deployGithubCommand } = await import("./github-Dck0nLW9.mjs");
+		const { deployGithubCommand } = await import("./github-VQaj8gLE.mjs");
 		await deployGithubCommand(options);
 	} catch (error) {
 		exitWithError(error);