@sitecoreai-labs/sitecoreai-cli 0.0.4

package/dist/commands/shared.d.ts

@@ -0,0 +1,21 @@
+import { Command } from "commander";
+export declare const collectList: (value: string, previous?: string[]) => string[];
+export declare const normalizeArgs: (argv: string[]) => string[];
+export declare const addConfigOption: (command: Command) => Command;
+export declare const addEnvironmentOption: (command: Command) => Command;
+export declare const addVerbosityOptions: (command: Command) => Command;
+export declare const addAllowWriteOption: (command: Command) => Command;
+export declare const addIncludeExcludeOptions: (command: Command) => Command;
+export declare const addWhatIfOption: (command: Command) => Command;
+export declare const addSkipValidationOption: (command: Command) => Command;
+export declare const addForceOption: (command: Command) => Command;
+export declare const addUseDebugSignaturesOption: (command: Command) => Command;
+export declare const addPublishOptions: (command: Command) => Command;
+export declare const addSkipPullOption: (command: Command) => Command;
+export declare const addAllowFileChangesOption: (command: Command) => Command;
+export declare const addExplainOptions: (command: Command) => Command;
+export declare const addDiffOptions: (command: Command) => Command;
+export declare const addValidateOptions: (command: Command) => Command;
+export declare const addPackageCreateOptions: (command: Command) => Command;
+export declare const addPackageInstallOptions: (command: Command) => Command;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAQ5C,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,WAAU,MAAM,EAAO,KAAG,MAAM,EACvC,CAAC;AAErC,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,KAAG,MAAM,EAYjD,CAAC;AAEL,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,KAAG,OAMhD,CAAC;AAEJ,eAAO,MAAM,oBAAoB,GAAI,SAAS,OAAO,KAAG,OAMrD,CAAC;AAEJ,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,KAAG,OAOsC,CAAC;AAE9F,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,KAAG,OAIpD,CAAC;AAEJ,eAAO,MAAM,wBAAwB,GAAI,SAAS,OAAO,KAAG,OAavD,CAAC;AAEN,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,KAAG,OAC+C,CAAC;AAEnG,eAAO,MAAM,uBAAuB,GAAI,SAAS,OAAO,KAAG,OACwC,CAAC;AAEpG,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,OACkC,CAAC;AAErF,eAAO,MAAM,2BAA2B,GAAI,SAAS,OAAO,KAAG,OAI5D,CAAC;AAEJ,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,OAWhD,CAAC;AAEN,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,OAC8C,CAAC;AAEpG,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,OAI1D,CAAC;AAEJ,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,KAAG,OAG6C,CAAC;AAEnG,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,KAAG,OAUwC,CAAC;AAE3F,eAAO,MAAM,kBAAkB,GAAI,SAAS,OAAO,KAAG,OAInD,CAAC;AAEJ,eAAO,MAAM,uBAAuB,GAAI,SAAS,OAAO,KAAG,OAMQ,CAAC;AAEpE,eAAO,MAAM,wBAAwB,GAAI,SAAS,OAAO,KAAG,OAevD,CAAC"}

package/dist/commands/shared.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPackageInstallOptions = exports.addPackageCreateOptions = exports.addValidateOptions = exports.addDiffOptions = exports.addExplainOptions = exports.addAllowFileChangesOption = exports.addSkipPullOption = exports.addPublishOptions = exports.addUseDebugSignaturesOption = exports.addForceOption = exports.addSkipValidationOption = exports.addWhatIfOption = exports.addIncludeExcludeOptions = exports.addAllowWriteOption = exports.addVerbosityOptions = exports.addEnvironmentOption = exports.addConfigOption = exports.normalizeArgs = exports.collectList = void 0;
+const commander_1 = require("commander");
+const splitComma = (value) => value
+    .split(",")
+    .map((entry) => entry.trim())
+    .filter((entry) => entry.length > 0);
+const collectList = (value, previous = []) => previous.concat(splitComma(value));
+exports.collectList = collectList;
+const normalizeArgs = (argv) => argv.map((arg) => {
+    if (arg === "-fr") {
+        return "--force";
+    }
+    if (arg === "--env" || arg === "--env-name") {
+        return "--environment-name";
+    }
+    if (arg === "-q") {
+        return "--quiet";
+    }
+    return arg;
+});
+exports.normalizeArgs = normalizeArgs;
+const addConfigOption = (command) => command.addOption(new commander_1.Option("-c, --config <path>", "Path to a sitecoreai.cli.json file, or a directory containing one (walks up if not in the dir itself).").default(process.cwd()));
+exports.addConfigOption = addConfigOption;
+const addEnvironmentOption = (command) => command.addOption(new commander_1.Option("-n, --environment-name <name>", "Config environment name from sitecoreai.cli.json (alias: --env-name)"));
+exports.addEnvironmentOption = addEnvironmentOption;
+const addVerbosityOptions = (command) => command
+    .addOption(new commander_1.Option("-v, --verbose", "Write some additional diagnostic and performance data"))
+    .addOption(new commander_1.Option("-t, --trace", "Write more additional diagnostic and performance data"))
+    .addOption(new commander_1.Option("-q, --quiet", "Suppress non-error output"))
+    .addOption(new commander_1.Option("--json", "Output machine-readable JSON"))
+    .addOption(new commander_1.Option("--log-file <path>", "Write logs to a file"))
+    .addOption(new commander_1.Option("--non-interactive", "Disable prompts and require explicit input"));
+exports.addVerbosityOptions = addVerbosityOptions;
+const addAllowWriteOption = (command) => command.option("--allow-write", "Allow write operations for this command without updating config");
+exports.addAllowWriteOption = addAllowWriteOption;
+const addIncludeExcludeOptions = (command) => command
+    .option("-i, --include <value>", "Module configurations to include. Wildcards and multiple values are allowed", exports.collectList, [])
+    .option("-e, --exclude <value>", "Module configurations to explicitly exclude. Wildcards and multiple values are allowed", exports.collectList, []);
+exports.addIncludeExcludeOptions = addIncludeExcludeOptions;
+const addWhatIfOption = (command) => command.option("-w, --what-if", "Lists commands that would be executed, without executing them");
+exports.addWhatIfOption = addWhatIfOption;
+const addSkipValidationOption = (command) => command.option("-s, --skip-validation", "Skips filesystem integrity validation prior to syncing");
+exports.addSkipValidationOption = addSkipValidationOption;
+const addForceOption = (command) => command.option("--force", "Perform force sync. In case you have invalid includes");
+exports.addForceOption = addForceOption;
+const addUseDebugSignaturesOption = (command) => command.option("--use-debug-signatures", "Use debug (un-hashed) item signatures to diagnose hash mismatches. Much slower");
+exports.addUseDebugSignaturesOption = addUseDebugSignaturesOption;
+const addPublishOptions = (command) => command
+    .option("-p, --publish", "Publish synced items. Not recommended to use with Publishing Service due to performance drop")
+    .option("--targets, --pt <value>", "Comma separated list of targets database to publish. Blank publishes to the default publishing target (first one in the list)", exports.collectList, []);
+exports.addPublishOptions = addPublishOptions;
+const addSkipPullOption = (command) => command.option("-s, --skip-pull", "Skips pulling data from Sitecore before starting the watcher");
+exports.addSkipPullOption = addSkipPullOption;
+const addAllowFileChangesOption = (command) => command.option("--allow-file-changes", "Don't stop watch if files change. May result in tree corruption if underlying state is changed; use only if some other program is touching serialized files that are not changing");
+exports.addAllowFileChangesOption = addAllowFileChangesOption;
+const addExplainOptions = (command) => command
+    .option("-p, --path <path>", "Item path to explain")
+    .option("-d, --database <database>", "Database of the item path to explain (default: master)");
+exports.addExplainOptions = addExplainOptions;
+const addDiffOptions = (command) => command
+    .option("-s, --source <name>", "Named Sitecore endpoint to use as a source for comparison")
+    .option("-d, --destination <name>", "Named Sitecore endpoint to use as a destination for comparison")
+    .option("-p, --path <path>", "Item path to compare (instead of include/exclude)")
+    .option("--source-database <database>", "Source database (when used with --path)")
+    .option("--destination-database <database>", "Destination database (when used with --path)")
+    .option("--push", "Applies the differences detected to the destination (diff + push)");
+exports.addDiffOptions = addDiffOptions;
+const addValidateOptions = (command) => command.option("-f, --fix", "Execute possible fix operations when validating the serialized items");
+exports.addValidateOptions = addValidateOptions;
+const addPackageCreateOptions = (command) => command
+    .option("-o, --output <path>", "Package path to output (will have extension added if not provided)")
+    .option("--overwrite", "Allow overwriting an existing package");
+exports.addPackageCreateOptions = addPackageCreateOptions;
+const addPackageInstallOptions = (command) => command
+    .option("-f, --package <path>", "Package path to install from")
+    .option("--authority, --auth <url>", "Identity authority for the environment, i.e. identity server or AAD tenant URL")
+    .option("--cm <url>", "Sitecore content management hostname to connect to")
+    .option("--client-id <id>", "The OAuth ClientID to send. Defaults to 'Device' for device auth, and 'SitecoreCLIServer' for client credentials")
+    .option("--client-secret <secret>", "The OAuth client secret to send. Only used for client credentials authentication");
+exports.addPackageInstallOptions = addPackageInstallOptions;

package/dist/commands/shell.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+type ShellEnvSnapshot = Record<string, string | undefined>;
+type RunCli = (argv: string[], options?: {
+    baseEnv?: ShellEnvSnapshot;
+    skipBanner?: boolean;
+    shellMode?: boolean;
+}) => Promise<void>;
+export declare const createShellCommand: (runCli: RunCli) => Command;
+export {};
+//# sourceMappingURL=shell.d.ts.map

package/dist/commands/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/commands/shell.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3D,KAAK,MAAM,GAAG,CACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,KAChF,OAAO,CAAC,IAAI,CAAC,CAAC;AA0EnB,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,OA4EnD,CAAC"}

package/dist/commands/shell.js

@@ -0,0 +1,155 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createShellCommand = void 0;
+const node_readline_1 = __importDefault(require("node:readline"));
+const commander_1 = require("commander");
+const prompt_1 = require("../shared/prompt");
+const shared_1 = require("./shared");
+const parseShellArgs = (input) => {
+    const args = [];
+    let current = "";
+    let quote = null;
+    let escaped = false;
+    for (let i = 0; i < input.length; i += 1) {
+        const char = input[i];
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (char === quote) {
+                quote = null;
+            }
+            else {
+                current += char;
+            }
+            continue;
+        }
+        if (char === "'" || char === '"') {
+            quote = char;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            if (current) {
+                args.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (current) {
+        args.push(current);
+    }
+    return args;
+};
+const snapshotShellEnv = () => ({
+    SITECOREAI_NON_INTERACTIVE: process.env.SITECOREAI_NON_INTERACTIVE,
+    SITECOREAI_JSON: process.env.SITECOREAI_JSON,
+    SITECOREAI_QUIET: process.env.SITECOREAI_QUIET,
+    SITECOREAI_TRACE_HTTP: process.env.SITECOREAI_TRACE_HTTP,
+});
+const restoreShellEnv = (snapshot) => {
+    for (const [key, value] of Object.entries(snapshot)) {
+        if (value === undefined) {
+            delete process.env[key];
+        }
+        else {
+            process.env[key] = value;
+        }
+    }
+};
+const shellHelp = () => {
+    console.log("Interactive shell commands:");
+    console.log("  exit | quit    Exit the shell");
+    console.log("  help | ?       Show this help");
+    console.log("  <command>      Run any scai command");
+    console.log("");
+    console.log("Examples:");
+    console.log("  status");
+    console.log("  init --environment-name demo --cm https://cm.example");
+    console.log("  deploy projects list");
+};
+const createShellCommand = (runCli) => {
+    const command = new commander_1.Command("shell")
+        .description("Start an interactive shell")
+        .action(async () => {
+        (0, prompt_1.assertInteractive)("Shell mode requires a TTY.", "Run without --non-interactive.");
+        const envSnapshot = snapshotShellEnv();
+        const rl = node_readline_1.default.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: "scai> ",
+        });
+        const closeShell = () => {
+            rl.close();
+        };
+        rl.on("SIGINT", () => {
+            rl.write("\n");
+            closeShell();
+        });
+        rl.on("close", () => {
+            console.log("Shell closed.");
+        });
+        rl.prompt();
+        rl.on("line", (line) => {
+            void (async () => {
+                rl.pause();
+                const trimmed = line.trim();
+                if (!trimmed) {
+                    rl.resume();
+                    rl.prompt();
+                    return;
+                }
+                if (trimmed === "exit" || trimmed === "quit") {
+                    closeShell();
+                    return;
+                }
+                if (trimmed === "help" || trimmed === "?") {
+                    shellHelp();
+                    rl.resume();
+                    rl.prompt();
+                    return;
+                }
+                const inputArgs = parseShellArgs(trimmed);
+                if (inputArgs.length === 0) {
+                    rl.resume();
+                    rl.prompt();
+                    return;
+                }
+                const [firstArg] = inputArgs;
+                if (firstArg === "scai" || firstArg === "sitecoreai-cli") {
+                    inputArgs.shift();
+                }
+                if (inputArgs[0] === "shell") {
+                    console.log("Already in shell. Type 'exit' to leave.");
+                    rl.resume();
+                    rl.prompt();
+                    return;
+                }
+                restoreShellEnv(envSnapshot);
+                await runCli((0, shared_1.normalizeArgs)(["node", "scai", ...inputArgs]), {
+                    baseEnv: envSnapshot,
+                    skipBanner: true,
+                    shellMode: true,
+                });
+                rl.resume();
+                rl.prompt();
+            })();
+        });
+        await new Promise((resolve) => {
+            rl.on("close", resolve);
+        });
+    });
+    command.addHelpText("after", "\nExample:\n  $ scai shell\n  scai> status\n  scai> exit\n");
+    return command;
+};
+exports.createShellCommand = createShellCommand;

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createStatusCommand: () => Command;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,mBAAmB,QAAO,OAatC,CAAC"}

package/dist/commands/status.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatusCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("./shared");
+const tasks_1 = require("../serialization/tasks");
+const createStatusCommand = () => {
+    const command = new commander_1.Command("status").description("Show configured Sitecore environments for this CLI");
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    command.addHelpText("after", "\nExample:\n  $ scai status\n");
+    command.action(async (options) => (0, tasks_1.runStatus)(options));
+    return command;
+};
+exports.createStatusCommand = createStatusCommand;

package/dist/commands/telemetry.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const createTelemetryCommand: () => Command;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/commands/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/commands/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,sBAAsB,QAAO,OA2BzC,CAAC"}

package/dist/commands/telemetry.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTelemetryCommand = void 0;
+const commander_1 = require("commander");
+const shared_1 = require("./shared");
+const telemetry_1 = require("../shared/telemetry");
+const logger_1 = require("../shared/logger");
+const createTelemetryCommand = () => {
+    const command = new commander_1.Command("telemetry").description("Telemetry utilities");
+    const status = new commander_1.Command("status").description("Show telemetry status");
+    (0, shared_1.addConfigOption)(status);
+    (0, shared_1.addVerbosityOptions)(status);
+    status.action(async (options) => {
+        const logger = new logger_1.Logger(Boolean(options.verbose), Boolean(options.trace), Boolean(options.json), Boolean(options.quiet), options.logFile);
+        const statusInfo = (0, telemetry_1.getTelemetryStatus)(options.config ?? process.cwd());
+        if (logger.isJson()) {
+            logger.json(statusInfo);
+            return;
+        }
+        logger.info(`Telemetry: ${statusInfo.enabled ? "enabled" : "disabled"}`, "cyan");
+        logger.info(`Source: ${statusInfo.source}`);
+        logger.info(`Endpoint: ${statusInfo.url}`);
+    });
+    command.addCommand(status);
+    command.addHelpText("after", "\nExample:\n  $ scai telemetry status\n");
+    return command;
+};
+exports.createTelemetryCommand = createTelemetryCommand;

package/dist/config/env-overrides.d.ts

@@ -0,0 +1,4 @@
+import type { EnvironmentConfiguration, RootConfigurationFile } from "./types";
+export declare const applyEnvOverrides: (envName: string, env: EnvironmentConfiguration, includeGlobal: boolean) => EnvironmentConfiguration;
+export declare const stripAuthenticationTokensFromConfig: (config: RootConfigurationFile) => RootConfigurationFile;
+//# sourceMappingURL=env-overrides.d.ts.map

package/dist/config/env-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-overrides.d.ts","sourceRoot":"","sources":["../../src/config/env-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA4C/E,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,KAAK,wBAAwB,EAC7B,eAAe,OAAO,KACrB,wBAqJF,CAAC;AAqBF,eAAO,MAAM,mCAAmC,GAC9C,QAAQ,qBAAqB,KAC5B,qBASF,CAAC"}

package/dist/config/env-overrides.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripAuthenticationTokensFromConfig = exports.applyEnvOverrides = void 0;
+const toBoolean = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized)) {
+        return true;
+    }
+    if (["0", "false", "no", "off"].includes(normalized)) {
+        return false;
+    }
+    return undefined;
+};
+const normalizeEnvKey = (name) => name
+    .trim()
+    .toUpperCase()
+    .replace(/[^A-Z0-9]+/g, "_")
+    .replace(/^_+|_+$/g, "");
+const getEnvOverride = (envName, key, includeGlobal) => {
+    const scopedKey = `SITECOREAI_ENV_${normalizeEnvKey(envName)}_${key}`;
+    const scopedValue = process.env[scopedKey];
+    if (scopedValue && scopedValue.trim().length > 0) {
+        return scopedValue.trim();
+    }
+    if (!includeGlobal) {
+        return undefined;
+    }
+    const globalKey = `SITECOREAI_${key}`;
+    const globalValue = process.env[globalKey];
+    if (globalValue && globalValue.trim().length > 0) {
+        return globalValue.trim();
+    }
+    return undefined;
+};
+const applyEnvOverrides = (envName, env, includeGlobal) => {
+    const overrides = {};
+    const allowWrite = toBoolean(getEnvOverride(envName, "ALLOW_WRITE", includeGlobal));
+    if (allowWrite !== undefined) {
+        overrides.allowWrite = allowWrite;
+    }
+    const useClientCredentials = toBoolean(getEnvOverride(envName, "USE_CLIENT_CREDENTIALS", includeGlobal));
+    if (useClientCredentials !== undefined) {
+        overrides.useClientCredentials = useClientCredentials;
+    }
+    const host = getEnvOverride(envName, "CM_HOST", includeGlobal);
+    if (host !== undefined) {
+        overrides.host = host;
+    }
+    const authority = getEnvOverride(envName, "AUTHORITY", includeGlobal);
+    if (authority !== undefined) {
+        overrides.authority = authority;
+    }
+    const audience = getEnvOverride(envName, "AUDIENCE", includeGlobal);
+    if (audience !== undefined) {
+        overrides.audience = audience;
+    }
+    const clientId = getEnvOverride(envName, "CLIENT_ID", includeGlobal);
+    if (clientId !== undefined) {
+        overrides.clientId = clientId;
+    }
+    const clientSecret = getEnvOverride(envName, "CLIENT_SECRET", includeGlobal);
+    if (clientSecret !== undefined) {
+        overrides.clientSecret = clientSecret;
+    }
+    const deployToken = getEnvOverride(envName, "DEPLOY_TOKEN", includeGlobal);
+    if (deployToken !== undefined) {
+        overrides.deployToken = deployToken;
+    }
+    // CM/admin access token override — useful when keychain storage is
+    // unreliable (e.g. headless CI, sandboxed shells) or for one-off
+    // debugging. Read by `getAccessToken` in serialization/sitecore-api/auth.ts
+    // before falling through to client-credentials.
+    const accessToken = getEnvOverride(envName, "ACCESS_TOKEN", includeGlobal);
+    if (accessToken !== undefined) {
+        overrides.accessToken = accessToken;
+    }
+    // Recipe parent paths — read by `resolveRecipeRoots` in
+    // src/recipe/tasks/shared.ts when --templates-root / --renderings-root
+    // CLI flags are absent.
+    const templatesRoot = getEnvOverride(envName, "TEMPLATES_ROOT", includeGlobal);
+    if (templatesRoot !== undefined) {
+        overrides.templatesRoot = templatesRoot;
+    }
+    const renderingsRoot = getEnvOverride(envName, "RENDERINGS_ROOT", includeGlobal);
+    if (renderingsRoot !== undefined) {
+        overrides.renderingsRoot = renderingsRoot;
+    }
+    // Phase 2 per-site folder layout roots — read by `runRecipePush` /
+    // `runRecipeCompile` to wire
+    // `CompileContext.{componentsRoot, contentModelsRoot}` so recipes
+    // with `section:` land at `<componentsRoot>/<section>/<Component>`
+    // and content templates land under `<contentModelsRoot>`.
+    const componentsRoot = getEnvOverride(envName, "COMPONENTS_ROOT", includeGlobal);
+    if (componentsRoot !== undefined) {
+        overrides.componentsRoot = componentsRoot;
+    }
+    const contentModelsRoot = getEnvOverride(envName, "CONTENT_MODELS_ROOT", includeGlobal);
+    if (contentModelsRoot !== undefined) {
+        overrides.contentModelsRoot = contentModelsRoot;
+    }
+    // Phase 4 composition roots — read by `runRecipePush` to wire
+    // `CompileContext.{partialDesignsRoot, pageDesignsRoot, contentItemsRoot}`
+    // and to seed `crossRecipeRefs[PAGE_DESIGNS_ROOT_REF_KEY]`.
+    const partialDesignsRoot = getEnvOverride(envName, "PARTIAL_DESIGNS_ROOT", includeGlobal);
+    if (partialDesignsRoot !== undefined) {
+        overrides.partialDesignsRoot = partialDesignsRoot;
+    }
+    const pageDesignsRoot = getEnvOverride(envName, "PAGE_DESIGNS_ROOT", includeGlobal);
+    if (pageDesignsRoot !== undefined) {
+        overrides.pageDesignsRoot = pageDesignsRoot;
+    }
+    const contentItemsRoot = getEnvOverride(envName, "CONTENT_ITEMS_ROOT", includeGlobal);
+    if (contentItemsRoot !== undefined) {
+        overrides.contentItemsRoot = contentItemsRoot;
+    }
+    // SXA Headless variants root — read by `runRecipePush` to wire
+    // `CompileContext.headlessVariantsRoot` so component recipes' variants
+    // land under `<headlessVariantsRoot>/<section>/<rendering>/<variant>`
+    // (SXA Headless tree) instead of the legacy "under the rendering
+    // item" location.
+    const headlessVariantsRoot = getEnvOverride(envName, "HEADLESS_VARIANTS_ROOT", includeGlobal);
+    if (headlessVariantsRoot !== undefined) {
+        overrides.headlessVariantsRoot = headlessVariantsRoot;
+    }
+    // SXA Available Renderings root — read by `compileRecipeSet` to
+    // emit one Available Renderings section per `recipe.section` with
+    // every rendering in that section listed.
+    const availableRenderingsRoot = getEnvOverride(envName, "AVAILABLE_RENDERINGS_ROOT", includeGlobal);
+    if (availableRenderingsRoot !== undefined) {
+        overrides.availableRenderingsRoot = availableRenderingsRoot;
+    }
+    // Enumerations root — required for EnumerationRecipe compilation
+    // and for any field that carries `sitecore.enumHandle`.
+    const enumerationsRoot = getEnvOverride(envName, "ENUMERATIONS_ROOT", includeGlobal);
+    if (enumerationsRoot !== undefined) {
+        overrides.enumerationsRoot = enumerationsRoot;
+    }
+    // Placeholder Settings roots — read by recipe push's placeholder
+    // resolver to find items by `Placeholder Key` and append the
+    // recipe's rendering to their `Allowed Controls`. Comma-separated.
+    const placeholderSettingsRoots = getEnvOverride(envName, "PLACEHOLDER_SETTINGS_ROOTS", includeGlobal);
+    if (placeholderSettingsRoots !== undefined) {
+        overrides.placeholderSettingsRoots = placeholderSettingsRoots
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+    }
+    const organizationId = getEnvOverride(envName, "ORGANIZATION_ID", includeGlobal);
+    if (organizationId !== undefined) {
+        overrides.organizationId = organizationId;
+    }
+    const tenantId = getEnvOverride(envName, "TENANT_ID", includeGlobal);
+    if (tenantId !== undefined) {
+        overrides.tenantId = tenantId;
+    }
+    const projectId = getEnvOverride(envName, "PROJECT_ID", includeGlobal);
+    if (projectId !== undefined) {
+        overrides.projectId = projectId;
+    }
+    const environmentId = getEnvOverride(envName, "ENVIRONMENT_ID", includeGlobal);
+    if (environmentId !== undefined) {
+        overrides.environmentId = environmentId;
+    }
+    const environmentType = getEnvOverride(envName, "ENVIRONMENT_TYPE", includeGlobal);
+    if (environmentType !== undefined) {
+        const normalized = environmentType.trim().toLowerCase();
+        if (normalized === "cm" || normalized === "eh") {
+            overrides.environmentType = normalized;
+        }
+    }
+    return { ...env, ...overrides };
+};
+exports.applyEnvOverrides = applyEnvOverrides;
+const stripAuthenticationTokens = (env) => {
+    const sanitized = { ...env };
+    delete sanitized.accessToken;
+    delete sanitized.refreshToken;
+    delete sanitized.refreshTokenParameters;
+    delete sanitized.expiresIn;
+    delete sanitized.lastUpdated;
+    delete sanitized.deployToken;
+    delete sanitized.clientSecret;
+    return sanitized;
+};
+const stripAuthenticationTokensFromProfiles = (envProfiles) => Object.fromEntries(Object.entries(envProfiles).map(([name, env]) => [name, stripAuthenticationTokens(env)]));
+const stripAuthenticationTokensFromConfig = (config) => {
+    if (!config.envProfiles) {
+        return config;
+    }
+    const sanitizedProfiles = stripAuthenticationTokensFromProfiles(config.envProfiles);
+    return {
+        ...config,
+        envProfiles: sanitizedProfiles,
+    };
+};
+exports.stripAuthenticationTokensFromConfig = stripAuthenticationTokensFromConfig;

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+export type { EnvironmentConfiguration, RootConfiguration, RootConfigurationFile, SerializationModuleConfiguration, SerializationModuleConfigurationItems, SerializationRootConfiguration, Settings, UserConfiguration, } from "./types";
+export { resolveRootConfigurationPath } from "./paths";
+export { readRootConfigurationFile, writeRootConfigurationFile, mergeEnvironmentConfigurations, readRootConfiguration, } from "./root-config";
+export { normalizeModuleConfiguration, readSerializationModules } from "./modules";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,gCAAgC,EAChC,qCAAqC,EACrC,8BAA8B,EAC9B,QAAQ,EACR,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSerializationModules = exports.normalizeModuleConfiguration = exports.readRootConfiguration = exports.mergeEnvironmentConfigurations = exports.writeRootConfigurationFile = exports.readRootConfigurationFile = exports.resolveRootConfigurationPath = void 0;
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "resolveRootConfigurationPath", { enumerable: true, get: function () { return paths_1.resolveRootConfigurationPath; } });
+var root_config_1 = require("./root-config");
+Object.defineProperty(exports, "readRootConfigurationFile", { enumerable: true, get: function () { return root_config_1.readRootConfigurationFile; } });
+Object.defineProperty(exports, "writeRootConfigurationFile", { enumerable: true, get: function () { return root_config_1.writeRootConfigurationFile; } });
+Object.defineProperty(exports, "mergeEnvironmentConfigurations", { enumerable: true, get: function () { return root_config_1.mergeEnvironmentConfigurations; } });
+Object.defineProperty(exports, "readRootConfiguration", { enumerable: true, get: function () { return root_config_1.readRootConfiguration; } });
+var modules_1 = require("./modules");
+Object.defineProperty(exports, "normalizeModuleConfiguration", { enumerable: true, get: function () { return modules_1.normalizeModuleConfiguration; } });
+Object.defineProperty(exports, "readSerializationModules", { enumerable: true, get: function () { return modules_1.readSerializationModules; } });

package/dist/config/modules.d.ts

@@ -0,0 +1,4 @@
+import type { RootConfiguration, SerializationModuleConfiguration } from "./types";
+export declare const normalizeModuleConfiguration: (raw: Partial<SerializationModuleConfiguration>, moduleFile: string, rootConfig: RootConfiguration) => SerializationModuleConfiguration;
+export declare const readSerializationModules: (rootConfig: RootConfiguration, include?: string[], exclude?: string[]) => Promise<SerializationModuleConfiguration[]>;
+//# sourceMappingURL=modules.d.ts.map

package/dist/config/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/config/modules.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAoEnF,eAAO,MAAM,4BAA4B,GACvC,KAAK,OAAO,CAAC,gCAAgC,CAAC,EAC9C,YAAY,MAAM,EAClB,YAAY,iBAAiB,KAC5B,gCA6DF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,YAAY,iBAAiB,EAC7B,UAAU,MAAM,EAAE,EAClB,UAAU,MAAM,EAAE,KACjB,OAAO,CAAC,gCAAgC,EAAE,CAsD5C,CAAC"}