@rmartz/envctl 3.1.1

package/dist/lib/commands/config-push-args.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PUSH_USAGE = void 0;
+exports.parsePushArgs = parsePushArgs;
+const path = __importStar(require("path"));
+const logger_1 = require("../logger");
+exports.PUSH_USAGE = `Usage: envctl config push [OPTIONS]
+
+Upsert public (non-secret) environment variables to a Vercel project from
+deployment configuration files. Reads the list of active environments from
+<deployment-dir>/environments.yml and per-environment values from
+<deployment-dir>/{env}.yml.
+
+The development Vercel target is always populated from the same YAML source as
+the staging/preview environment. It does not appear in environments.yml and has
+no dedicated YAML file. Existing variables are updated in place; missing ones
+are created as plain-type records. Variables not present in the config files are
+left untouched.
+
+OPTIONS:
+  --env <name>             Target a specific environment by name as listed in
+                           environments.yml, or 'development' for the implicit
+                           development target (default: all active environments
+                           plus development)
+  --deployment-dir <path>  Path to the deployment config directory, resolved
+                           against the project root (default: deployment)
+  --dry-run                Print what would change without making any API calls
+  -h, --help               Show this help
+
+ENVIRONMENT MAPPING:
+  production  → production (Vercel target)
+  staging     → preview   (Vercel target)
+  preview     → preview   (Vercel target)
+  development → development (implicit — mirrors staging/preview)
+  <other>     → passed through as-is`;
+// Parses the `config push` argument list. `args` has already had the global
+// -C/--working-dir flag stripped by the router. The (absolute) project root is
+// used to resolve the default and relative --deployment-dir values. Prints
+// usage and exits 0 on -h/--help.
+function parsePushArgs(args, workingDir) {
+    let targetEnv = "all";
+    let deploymentDir = "deployment";
+    let dryRun = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--env") {
+            targetEnv =
+                args[++i] ?? (0, logger_1.err)('--env requires an environment name or "all"');
+            if (!targetEnv)
+                (0, logger_1.err)('--env requires an environment name or "all"');
+        }
+        else if (arg === "--deployment-dir") {
+            deploymentDir = args[++i] ?? (0, logger_1.err)("--deployment-dir requires a path");
+            if (!deploymentDir)
+                (0, logger_1.err)("--deployment-dir requires a path");
+        }
+        else if (arg === "--dry-run") {
+            dryRun = true;
+        }
+        else if (arg === "-h" || arg === "--help") {
+            console.log(exports.PUSH_USAGE);
+            process.exit(0);
+        }
+        else {
+            (0, logger_1.err)(`Unknown option: ${arg}. Run 'envctl config push --help' for usage.`);
+        }
+    }
+    return {
+        targetEnv,
+        workingDir,
+        deploymentDir: path.resolve(workingDir, deploymentDir),
+        dryRun,
+    };
+}
+//# sourceMappingURL=config-push-args.js.map

package/dist/lib/commands/config-push-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-push-args.js","sourceRoot":"","sources":["../../../src/lib/commands/config-push-args.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,sCA8BC;AAnFD,2CAA6B;AAE7B,sCAAgC;AAiBnB,QAAA,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCA4BW,CAAC;AAEtC,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,kCAAkC;AAClC,SAAgB,aAAa,CAAC,IAAc,EAAE,UAAkB;IAC9D,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,aAAa,GAAG,YAAY,CAAC;IACjC,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,SAAS;gBACP,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,IAAA,YAAG,EAAC,6CAA6C,CAAC,CAAC;YAClE,IAAI,CAAC,SAAS;gBAAE,IAAA,YAAG,EAAC,6CAA6C,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;YACtC,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,IAAA,YAAG,EAAC,kCAAkC,CAAC,CAAC;YACrE,IAAI,CAAC,aAAa;gBAAE,IAAA,YAAG,EAAC,kCAAkC,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,kBAAU,CAAC,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,IAAA,YAAG,EAAC,mBAAmB,GAAG,8CAA8C,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,UAAU;QACV,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC;QACtD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/lib/commands/config-push.d.ts

@@ -0,0 +1,6 @@
+import type { CommandContext } from "../cli/registry";
+import { type PushOptions } from "./config-push-args";
+export type { PushOptions };
+export declare function runPush(opts: PushOptions): Promise<void>;
+export declare function configPushCommand(ctx: CommandContext, args: string[]): Promise<void>;
+//# sourceMappingURL=config-push.d.ts.map

package/dist/lib/commands/config-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-push.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/config-push.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOrE,YAAY,EAAE,WAAW,EAAE,CAAC;AAwH5B,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD9D;AAKD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/lib/commands/config-push.js

@@ -0,0 +1,166 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPush = runPush;
+exports.configPushCommand = configPushCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const auth_1 = require("../auth");
+const environments_1 = require("../environments");
+const logger_1 = require("../logger");
+const registry_1 = require("../providers/registry");
+const targets_1 = require("../targets");
+const config_push_args_1 = require("./config-push-args");
+const env_plan_1 = require("./env-plan");
+// Resolves which active environments to push and whether the implicit
+// development target should be synced, validating the requested --env.
+function resolvePlan(opts, activeEnvs, devSource) {
+    const envList = (0, env_plan_1.resolveEnvList)(activeEnvs, opts.targetEnv, devSource);
+    const syncDev = (opts.targetEnv === "all" || opts.targetEnv === "development") &&
+        devSource !== undefined;
+    return { envList, syncDev };
+}
+function dryRunPlan(opts, envList, syncDev, devSource, resolveTarget) {
+    (0, logger_1.log)("Dry run — no changes will be made");
+    for (const envName of envList) {
+        const envFile = path.join(opts.deploymentDir, `${envName}.yml`);
+        if (!fs.existsSync(envFile)) {
+            (0, logger_1.warn)(`No config file for '${envName}': ${envFile}`);
+            continue;
+        }
+        (0, logger_1.log)(`Would push ${envName} → ${resolveTarget(envName)}:`);
+        const vars = (0, environments_1.parseDeploymentEnv)(opts.deploymentDir, envName);
+        for (const key of Object.keys(vars))
+            (0, logger_1.log)(`  Would push: ${key}`);
+    }
+    if (syncDev && devSource) {
+        (0, logger_1.log)(`Would push development (from ${devSource}) → development:`);
+        const vars = (0, environments_1.parseDeploymentEnv)(opts.deploymentDir, devSource);
+        for (const key of Object.keys(vars))
+            (0, logger_1.log)(`  Would push: ${key}`);
+    }
+}
+// Upserts every variable in `vars` for the given Vercel target, re-listing the
+// remote env vars first so writes from a prior environment are reflected.
+// Returns the running totals incremented by this pass.
+async function pushVars(deployment, label, target, vars) {
+    let created = 0;
+    let updated = 0;
+    const allEnvs = await deployment.listEnvVars();
+    for (const key of Object.keys(vars)) {
+        const existing = deployment.findEnvVar(allEnvs.envs, key, target);
+        if (existing) {
+            await deployment.updateEnvVar(existing, vars[key]);
+            (0, logger_1.log)(`  Updated : ${key}`);
+            updated++;
+        }
+        else {
+            await deployment.createEnvVar(key, vars[key], target, "plain");
+            (0, logger_1.log)(`  Created : ${key}`);
+            created++;
+        }
+    }
+    (0, logger_1.log)(`  ${label} — ${created} created, ${updated} updated`);
+    return { created, updated };
+}
+// Pushes public env vars for a single named environment, skipping (with a
+// warning) when its YAML file is missing or empty.
+async function pushEnv(deployment, opts, envName, target) {
+    const envFile = path.join(opts.deploymentDir, `${envName}.yml`);
+    if (!fs.existsSync(envFile)) {
+        (0, logger_1.warn)(`No config file for '${envName}': ${envFile} — skipping`);
+        return { created: 0, updated: 0 };
+    }
+    (0, logger_1.log)(`Pushing ${envName} → ${target}...`);
+    const vars = (0, environments_1.parseDeploymentEnv)(opts.deploymentDir, envName);
+    if (Object.keys(vars).length === 0) {
+        (0, logger_1.warn)(`No variables found in ${envFile} — skipping`);
+        return { created: 0, updated: 0 };
+    }
+    return pushVars(deployment, envName, target, vars);
+}
+// Pushes the staging/preview YAML to the implicit development target.
+async function pushDev(deployment, opts, devSource) {
+    const devEnvFile = path.join(opts.deploymentDir, `${devSource}.yml`);
+    if (!fs.existsSync(devEnvFile)) {
+        (0, logger_1.warn)(`No config file for development source '${devSource}': ${devEnvFile} — skipping development push`);
+        return { created: 0, updated: 0 };
+    }
+    const vars = (0, environments_1.parseDeploymentEnv)(opts.deploymentDir, devSource);
+    if (Object.keys(vars).length === 0) {
+        (0, logger_1.warn)(`No variables found in ${devEnvFile} — skipping development push`);
+        return { created: 0, updated: 0 };
+    }
+    (0, logger_1.log)(`Pushing development (from ${devSource}) → development...`);
+    return pushVars(deployment, `development (from ${devSource})`, "development", vars);
+}
+// Orchestrates the public-variable push. Accepts fully-resolved options so it
+// is directly unit-testable (mirroring the predecessor's `sync-env` run()).
+async function runPush(opts) {
+    const token = (0, auth_1.resolveVercelToken)();
+    (0, env_plan_1.assertDeploymentPrereqs)(opts.deploymentDir, token);
+    const deployment = (0, registry_1.resolveProjectDeployment)(opts.deploymentDir, opts.workingDir);
+    (0, logger_1.log)(`Project: ${deployment.projectId}${deployment.teamId ? ` (team: ${deployment.teamId})` : ""}`);
+    const activeEnvs = (0, environments_1.listActiveEnvs)(opts.deploymentDir);
+    if (activeEnvs.length === 0)
+        (0, logger_1.err)(`No active environments found in ${opts.deploymentDir}/environments.yml`);
+    const resolveTarget = (0, targets_1.envTargetResolver)(opts.deploymentDir);
+    const devSource = (0, env_plan_1.findDevSource)(opts.deploymentDir, activeEnvs);
+    const { envList, syncDev } = resolvePlan(opts, activeEnvs, devSource);
+    if (opts.dryRun) {
+        dryRunPlan(opts, envList, syncDev, devSource, resolveTarget);
+        return;
+    }
+    let totalCreated = 0;
+    let totalUpdated = 0;
+    for (const envName of envList) {
+        const { created, updated } = await pushEnv(deployment, opts, envName, resolveTarget(envName));
+        totalCreated += created;
+        totalUpdated += updated;
+    }
+    if (syncDev && devSource) {
+        const { created, updated } = await pushDev(deployment, opts, devSource);
+        totalCreated += created;
+        totalUpdated += updated;
+    }
+    (0, logger_1.log)(`Done — ${totalCreated} created, ${totalUpdated} updated across all target environments.`);
+}
+// Command adapter: parses args (with the global -C already stripped by the
+// router) and dispatches to runPush, resolving deployment-dir against the
+// project root from ctx.workingDir.
+async function configPushCommand(ctx, args) {
+    await runPush((0, config_push_args_1.parsePushArgs)(args, ctx.workingDir));
+}
+//# sourceMappingURL=config-push.js.map

package/dist/lib/commands/config-push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-push.js","sourceRoot":"","sources":["../../../src/lib/commands/config-push.ts"],"names":[],"mappings":"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"}

package/dist/lib/commands/deployment-config.d.ts

@@ -0,0 +1,9 @@
+export declare const VALID_TARGETS: readonly ["production", "preview", "development"];
+export type DeployTarget = (typeof VALID_TARGETS)[number];
+export declare function isValidTarget(value: string): value is DeployTarget;
+export declare function deploymentDir(workingDir: string): string;
+export declare function environmentsFile(workingDir: string): string;
+export declare function envFile(workingDir: string, name: string): string;
+export declare function writeActiveEnvs(workingDir: string, active: string[]): void;
+export declare function writeEnvFile(workingDir: string, name: string, variables: Record<string, string>): void;
+//# sourceMappingURL=deployment-config.d.ts.map

package/dist/lib/commands/deployment-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-config.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/deployment-config.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,mDAAoD,CAAC;AAC/E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAElE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAKD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1E;AAID,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CAKN"}

package/dist/lib/commands/deployment-config.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_TARGETS = void 0;
+exports.isValidTarget = isValidTarget;
+exports.deploymentDir = deploymentDir;
+exports.environmentsFile = environmentsFile;
+exports.envFile = envFile;
+exports.writeActiveEnvs = writeActiveEnvs;
+exports.writeEnvFile = writeEnvFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+// The deploy targets `env add` accepts. The name→target mapping itself is the
+// ported engine's convention (see vercelTarget); this is the validated set a
+// caller may declare for an environment.
+exports.VALID_TARGETS = ["production", "preview", "development"];
+function isValidTarget(value) {
+    return exports.VALID_TARGETS.includes(value);
+}
+function deploymentDir(workingDir) {
+    return path.join(workingDir, "deployment");
+}
+function environmentsFile(workingDir) {
+    return path.join(deploymentDir(workingDir), "environments.yml");
+}
+function envFile(workingDir, name) {
+    return path.join(deploymentDir(workingDir), `${name}.yml`);
+}
+// Reserializes environments.yml from the active list. Per the recorded design
+// decision this is a load→mutate→dump round-trip, so comments and key ordering
+// in an existing file are not preserved.
+function writeActiveEnvs(workingDir, active) {
+    fs.writeFileSync(environmentsFile(workingDir), yaml.dump({ active }));
+}
+// Writes a per-environment file in the nested format
+// ({ environment, variables }), the form `init`/`env add` scaffold.
+function writeEnvFile(workingDir, name, variables) {
+    fs.writeFileSync(envFile(workingDir, name), yaml.dump({ environment: name, variables }));
+}
+//# sourceMappingURL=deployment-config.js.map

package/dist/lib/commands/deployment-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-config.js","sourceRoot":"","sources":["../../../src/lib/commands/deployment-config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,sCAEC;AAED,sCAEC;AAED,4CAEC;AAED,0BAEC;AAKD,0CAEC;AAID,oCASC;AA7CD,uCAAyB;AACzB,2CAA6B;AAE7B,8CAAgC;AAEhC,8EAA8E;AAC9E,6EAA6E;AAC7E,yCAAyC;AAC5B,QAAA,aAAa,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,aAAa,CAAU,CAAC;AAG/E,SAAgB,aAAa,CAAC,KAAa;IACzC,OAAQ,qBAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,aAAa,CAAC,UAAkB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,gBAAgB,CAAC,UAAkB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,OAAO,CAAC,UAAkB,EAAE,IAAY;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,+EAA+E;AAC/E,yCAAyC;AACzC,SAAgB,eAAe,CAAC,UAAkB,EAAE,MAAgB;IAClE,EAAE,CAAC,aAAa,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,qDAAqD;AACrD,oEAAoE;AACpE,SAAgB,YAAY,CAC1B,UAAkB,EAClB,IAAY,EACZ,SAAiC;IAEjC,EAAE,CAAC,aAAa,CACd,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EACzB,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/lib/commands/env-plan.d.ts

@@ -0,0 +1,4 @@
+export declare function assertDeploymentPrereqs(deploymentDir: string, token: string | undefined): asserts token is string;
+export declare function findDevSource(deploymentDir: string, activeEnvs: string[]): string | undefined;
+export declare function resolveEnvList(activeEnvs: string[], targetEnv: string, devSource: string | undefined): string[];
+//# sourceMappingURL=env-plan.d.ts.map

package/dist/lib/commands/env-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-plan.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/env-plan.ts"],"names":[],"mappings":"AAaA,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,KAAK,IAAI,MAAM,CASzB;AAQD,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,GAAG,SAAS,CAGpB;AAOD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,EAAE,CAcV"}

package/dist/lib/commands/env-plan.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertDeploymentPrereqs = assertDeploymentPrereqs;
+exports.findDevSource = findDevSource;
+exports.resolveEnvList = resolveEnvList;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../logger");
+const targets_1 = require("../targets");
+// Environment-planning helpers shared by `config push` and `secrets` — the
+// logic that turns a requested --env value plus the active-environments list
+// into the concrete set of named environments a command acts on.
+// Preflight shared by the deployment-config commands: a Vercel token must
+// resolve and the deployment directory (with its environments.yml) must exist.
+// Narrows `token` to a string for the caller.
+function assertDeploymentPrereqs(deploymentDir, token) {
+    if (!token)
+        (0, logger_1.err)("No Vercel token found. Set VERCEL_TOKEN or run 'vercel login' to authenticate.");
+    if (!fs.existsSync(deploymentDir))
+        (0, logger_1.err)(`Deployment directory not found: ${deploymentDir}`);
+    const envsFile = path.join(deploymentDir, "environments.yml");
+    if (!fs.existsSync(envsFile))
+        (0, logger_1.err)(`environments.yml not found: ${envsFile}`);
+}
+// Returns the first active env whose provider target is "preview" (i.e.
+// staging), resolved from the manifest's authoritative targets map (#87) rather
+// than inferred from the name convention. The implicit development target
+// mirrors this source (public vars for `config push`; the shared Firebase
+// project for `secrets`), so a project can now designate the dev source by
+// declaring a `preview` target for a non-conventionally-named env.
+function findDevSource(deploymentDir, activeEnvs) {
+    const resolveTarget = (0, targets_1.envTargetResolver)(deploymentDir);
+    return activeEnvs.find((e) => resolveTarget(e) === "preview");
+}
+// Resolves the concrete list of named environments from the requested --env:
+// "all" → every active env; "development" → none (the implicit development
+// target is handled separately and requires a devSource); otherwise the single
+// named env, validated against the active list. Errors (via `err`) on an
+// unknown --env or on "development" with no staging/preview source.
+function resolveEnvList(activeEnvs, targetEnv, devSource) {
+    if (targetEnv === "all")
+        return activeEnvs;
+    if (targetEnv === "development") {
+        if (!devSource)
+            (0, logger_1.err)("--env development requires a staging or preview environment in environments.yml");
+        return [];
+    }
+    if (!activeEnvs.includes(targetEnv))
+        (0, logger_1.err)(`--env '${targetEnv}' not in active environments: ${activeEnvs.join(", ")}`);
+    return [targetEnv];
+}
+//# sourceMappingURL=env-plan.js.map

package/dist/lib/commands/env-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-plan.js","sourceRoot":"","sources":["../../../src/lib/commands/env-plan.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,0DAYC;AAQD,sCAMC;AAOD,wCAkBC;AAhED,uCAAyB;AACzB,2CAA6B;AAE7B,sCAAgC;AAChC,wCAA+C;AAE/C,2EAA2E;AAC3E,6EAA6E;AAC7E,iEAAiE;AAEjE,0EAA0E;AAC1E,+EAA+E;AAC/E,8CAA8C;AAC9C,SAAgB,uBAAuB,CACrC,aAAqB,EACrB,KAAyB;IAEzB,IAAI,CAAC,KAAK;QACR,IAAA,YAAG,EACD,gFAAgF,CACjF,CAAC;IACJ,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;QAC/B,IAAA,YAAG,EAAC,mCAAmC,aAAa,EAAE,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,IAAA,YAAG,EAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,wEAAwE;AACxE,gFAAgF;AAChF,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,mEAAmE;AACnE,SAAgB,aAAa,CAC3B,aAAqB,EACrB,UAAoB;IAEpB,MAAM,aAAa,GAAG,IAAA,2BAAiB,EAAC,aAAa,CAAC,CAAC;IACvD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AAChE,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,yEAAyE;AACzE,oEAAoE;AACpE,SAAgB,cAAc,CAC5B,UAAoB,EACpB,SAAiB,EACjB,SAA6B;IAE7B,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,UAAU,CAAC;IAC3C,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS;YACZ,IAAA,YAAG,EACD,iFAAiF,CAClF,CAAC;QACJ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QACjC,IAAA,YAAG,EACD,UAAU,SAAS,iCAAiC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAC;IACJ,OAAO,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC"}

package/dist/lib/commands/env.d.ts

@@ -0,0 +1,4 @@
+import type { CommandContext } from "../cli/registry";
+export declare function runEnvAdd(ctx: CommandContext, args: string[]): void;
+export declare function runEnvList(ctx: CommandContext): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/commands/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/env.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAsEtD,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuBnE;AAGD,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAepD"}

package/dist/lib/commands/env.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEnvAdd = runEnvAdd;
+exports.runEnvList = runEnvList;
+const fs = __importStar(require("fs"));
+const environments_1 = require("../environments");
+const manifest_1 = require("../manifest");
+const logger_1 = require("../logger");
+const targets_1 = require("../targets");
+const deployment_config_1 = require("./deployment-config");
+const ENV_ADD_USAGE = `Usage: envctl env add <name> --target <${deployment_config_1.VALID_TARGETS.join("|")}>
+
+Define an environment: append <name> to environments.yml's active list and
+create deployment/<name>.yml. --target is required and sets the authoritative
+Vercel deployment target for this env (written to manifest.yml), used by config
+push, env pull, and secrets rotation.`;
+function parseAddArgs(args) {
+    let name;
+    let target;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--target") {
+            target = args[++i] ?? (0, logger_1.err)("--target requires a value");
+        }
+        else if (arg === "-h" || arg === "--help") {
+            console.log(ENV_ADD_USAGE);
+            process.exit(0);
+        }
+        else if (arg.startsWith("-")) {
+            (0, logger_1.err)(`Unknown option: ${arg}. Run 'envctl env add --help' for usage.`);
+        }
+        else if (name === undefined) {
+            name = arg;
+        }
+        else {
+            (0, logger_1.err)(`Unexpected argument: ${arg}`);
+        }
+    }
+    if (name === undefined)
+        return (0, logger_1.err)("env add requires an environment name");
+    if (name.includes("/") || name.includes(".."))
+        return (0, logger_1.err)(`Invalid environment name '${name}': must not contain '/' or '..'`);
+    if (target === undefined)
+        return (0, logger_1.err)(`env add requires --target <${deployment_config_1.VALID_TARGETS.join("|")}>`);
+    if (!(0, deployment_config_1.isValidTarget)(target))
+        return (0, logger_1.err)(`Invalid --target '${target}'. Must be one of: ${deployment_config_1.VALID_TARGETS.join(", ")}`);
+    return { name, target };
+}
+function requireConfig(ctx) {
+    if (!fs.existsSync((0, deployment_config_1.environmentsFile)(ctx.workingDir)))
+        (0, logger_1.err)("No deployment config found. Run 'envctl init' first.");
+}
+// `envctl env add <name> --target <t>` — append the environment to the active
+// list and scaffold its file. Idempotent: an already-active name is a no-op.
+function runEnvAdd(ctx, args) {
+    const { name, target } = parseAddArgs(args);
+    requireConfig(ctx);
+    const dir = (0, deployment_config_1.deploymentDir)(ctx.workingDir);
+    const active = (0, environments_1.listActiveEnvs)(dir);
+    if (active.includes(name)) {
+        (0, logger_1.warn)(`'${name}' is already an active environment — config unchanged.`);
+        return;
+    }
+    (0, deployment_config_1.writeActiveEnvs)(ctx.workingDir, [...active, name]);
+    if (!fs.existsSync((0, deployment_config_1.envFile)(ctx.workingDir, name))) {
+        (0, deployment_config_1.writeEnvFile)(ctx.workingDir, name, {});
+    }
+    // Persist the explicit env→target mapping into the manifest (#87), where it is
+    // now authoritative for config push / secrets — rather than validated and
+    // dropped as before.
+    (0, manifest_1.setManifestTarget)(dir, name, target);
+    (0, logger_1.log)(`Added '${name}' → ${target}. Edit ${(0, deployment_config_1.envFile)(ctx.workingDir, name)} to set its vars.`);
+}
+// `envctl env list` — list defined environments and their provider targets.
+function runEnvList(ctx) {
+    requireConfig(ctx);
+    const dir = (0, deployment_config_1.deploymentDir)(ctx.workingDir);
+    const active = (0, environments_1.listActiveEnvs)(dir);
+    if (active.length === 0) {
+        (0, logger_1.log)("No environments defined.");
+        return;
+    }
+    const resolveTarget = (0, targets_1.envTargetResolver)(dir);
+    (0, logger_1.log)("Environments:");
+    for (const name of active) {
+        (0, logger_1.log)(`  ${name} → ${resolveTarget(name)}`);
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/lib/commands/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/lib/commands/env.ts"],"names":[],"mappings":"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"}

package/dist/lib/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContext } from "../cli/registry";
+export declare function runInit(ctx: CommandContext): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/lib/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAatD,wBAAgB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAmBjD"}