@simplysf/simply-cicd-core 0.2.1 → 0.3.1

package/lib/deploy/deployCommon.js

@@ -0,0 +1,358 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import { createVcsProvider } from '../vcs/index.js';
+import { cloneRepo } from '../git.js';
+import { logger } from '../logger.js';
+import { runApexTests as runApexTestsCommon } from '../sfApex.js';
+import { installPackageDependencies as installPackageDependenciesCommon } from '../sfPackages.js';
+import { installDeploymentPlugins } from '../sfPlugins.js';
+import { deployConfigSchema } from '../schemas/deployConfig.js';
+import { deployProgressSchema } from '../schemas/deployProgress.js';
+import { deployRulesSchema } from '../schemas/deployRules.js';
+/** Validates `data` against a zod schema, throwing a formatted error (one bullet per issue) if it fails. */
+export function validateWithSchema(schema, data, fileName) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        const errorMessages = result.error.issues
+            .map((issue) => `  - ${issue.path.join('.') || 'root'}: ${issue.message}`)
+            .join('');
+        throw new Error(`Invalid format for ${fileName}: ${errorMessages}`);
+    }
+    return result.data;
+}
+/**
+ * Read a JSON file and validate it against a zod schema.
+ *
+ * @param filePath - The file to read. Its name appears in the error on a schema violation.
+ * @param schema - The schema to validate against.
+ * @returns The validated contents.
+ * @throws {Error} With one bullet per schema issue, via {@link validateWithSchema}.
+ * @throws {NodeJS.ErrnoException} If the file can't be read — callers check for `ENOENT` to
+ * treat a missing file as non-fatal.
+ * @throws {SyntaxError} If the file isn't valid JSON.
+ */
+export async function loadValidatedJsonFile(filePath, schema) {
+    const contents = await fs.readFile(filePath, 'utf-8');
+    return validateWithSchema(schema, JSON.parse(contents), filePath);
+}
+/** Validates a deployment configuration against a set of deployment rules (e.g. "prod must run postDeploy"). */
+export async function validateDeploymentRules(deploymentConfig, rulesFile) {
+    let rulesConfig;
+    try {
+        rulesConfig = await loadValidatedJsonFile(rulesFile, deployRulesSchema);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            logger.info(`Deployment rules file not found at ${rulesFile}. Skipping rules validation.`);
+            return;
+        }
+        logger.error(`Failed to read or validate ${rulesFile}: ${error.message}`);
+        throw error;
+    }
+    const errors = [];
+    for (const rule of rulesConfig.rules) {
+        const deployment = deploymentConfig.deployments.find((d) => {
+            const matchesName = Boolean(rule.deploymentName) && d.name === rule.deploymentName;
+            const matchesSlug = Boolean(rule.deploymentSlug) && d.slug === rule.deploymentSlug;
+            return matchesName || matchesSlug;
+        });
+        if (deployment) {
+            for (const requiredStage of rule.requireStages) {
+                if (!deployment[requiredStage]) {
+                    let identifier;
+                    if (rule.deploymentName && rule.deploymentSlug) {
+                        identifier = `name '${rule.deploymentName}' or slug '${rule.deploymentSlug}'`;
+                    }
+                    else if (rule.deploymentName) {
+                        identifier = `name '${rule.deploymentName}'`;
+                    }
+                    else {
+                        identifier = `slug '${rule.deploymentSlug ?? 'unknown'}'`;
+                    }
+                    errors.push(`Deployment with ${identifier} is missing required stage '${requiredStage}'.`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Deployment configuration failed validation against deployment rules:\n${errors.join('\n')}`);
+    }
+    logger.success('Deployment configuration passed validation against deployment rules.');
+}
+export const STAGE_TO_SCRIPT_NAME_MAP = {
+    'pre-destructive': 'preDestructive.sh',
+    'deploy-unpackaged': 'unpackagedDeploy.sh',
+    'post-deploy': 'postDeploy.sh',
+    'post-destructive': 'postDestructive.sh',
+};
+export const STAGE_TO_PROPERTY_MAP = {
+    'pre-destructive': 'preDestructive',
+    'install-packaged': 'installPackaged',
+    'deploy-unpackaged': 'unpackagedDeploy',
+    'post-deploy': 'postDeploy',
+    'post-destructive': 'postDestructive',
+};
+export const STAGE_CONFIG = {
+    'pre-destructive': { property: 'preDestructive' },
+    'deploy-unpackaged': { property: 'unpackagedDeploy' },
+    'post-deploy': { property: 'postDeploy' },
+    'post-destructive': { property: 'postDestructive' },
+};
+/** Atomically updates a progress file: writes to a temp file first, then renames it into place. */
+export async function updateProgress(deployProgressFile, newProgress) {
+    const tempFile = `${deployProgressFile}.${Date.now()}.tmp`;
+    await fs.writeFile(tempFile, JSON.stringify(newProgress, null, 2));
+    await fs.rename(tempFile, deployProgressFile);
+}
+const DIRS_TO_CHMOD = [
+    { dir: 'logs', mode: '+rw' },
+    { dir: 'data', mode: '+rw' },
+    { dir: 'bin', mode: '+rx' },
+    { dir: 'scripts', mode: '+rw' },
+];
+async function chmodStageDirectories(repoDir, jobName) {
+    for (const { dir, mode } of DIRS_TO_CHMOD) {
+        const dirPath = path.join(repoDir, dir);
+        try {
+            // eslint-disable-next-line no-await-in-loop
+            await fs.access(dirPath);
+        }
+        catch {
+            continue;
+        }
+        try {
+            logger.info(`[${jobName}] Modifying permissions of ${dir} to ${mode}...`);
+            // eslint-disable-next-line no-await-in-loop
+            await execa('chmod', ['-R', mode, `./${dir}`], { cwd: repoDir });
+        }
+        catch {
+            logger.warn(`[${jobName}] Could not modify permissions for ${dir}. This might cause issues on non-Windows systems.`);
+        }
+    }
+}
+/**
+ * Executes a stage-specific script (e.g. `bin/preDestructive.sh`) for a deployment: installs npm
+ * production dependencies if a `package.json` exists, sets executable/writable permissions on the
+ * repo's working directories, and runs the script with `--target-org`/`--test-level`/`--tests`.
+ */
+export async function executeStageScript(deployment, stage, repoDir, config) {
+    const { alias } = config;
+    const jobName = deployment.name.toUpperCase();
+    const scriptName = STAGE_TO_SCRIPT_NAME_MAP[stage];
+    if (!scriptName) {
+        logger.info(`No script configured for stage ${stage}, skipping script execution.`);
+        return;
+    }
+    const scriptPath = path.join(repoDir, 'bin', scriptName);
+    try {
+        await fs.access(scriptPath);
+    }
+    catch {
+        logger.info(`Script ${scriptPath} not found for deployment ${deployment.name}, skipping.`);
+        return;
+    }
+    logger.info(`[${jobName}] Preparing to run ${scriptName}`);
+    const packageJsonPath = path.join(repoDir, 'package.json');
+    try {
+        await fs.access(packageJsonPath);
+        logger.info(`[${jobName}] Installing npm dependencies...`);
+        await execa('npm', ['install', '--omit=dev'], { cwd: repoDir, env: { HUSKY_SKIP_INSTALL: '1' } });
+    }
+    catch {
+        // No package.json for this repo; nothing to install.
+    }
+    await chmodStageDirectories(repoDir, jobName);
+    const testLevel = deployment.testLevel ?? config.testLevel ?? 'RunLocalTests';
+    const tests = deployment.tests ?? config.tests ?? '';
+    const scriptArgs = ['--target-org', alias ?? '', '--test-level', testLevel];
+    if (tests) {
+        scriptArgs.push('--tests', tests);
+    }
+    logger.info(`[${jobName}] Executing: ./${path.join('bin', scriptName)} ${scriptArgs.join(' ')}`);
+    await execa(path.resolve(scriptPath), scriptArgs, { cwd: repoDir, stdio: 'inherit' });
+}
+/** Installs the target org's packaged dependencies. The org must already be authenticated. */
+export async function installDeployPackageDependencies(config) {
+    const { alias, wait = '120', installType = 'Upgrade', upgradeType } = config;
+    await installPackageDependenciesCommon({ alias, wait, installType, upgradeType });
+}
+/** Logs a per-job duration summary for the given stage, from the recorded progress file durations. */
+export function printDeploymentSummary(deployProgress, stage) {
+    try {
+        const stageConfig = STAGE_CONFIG[stage];
+        if (!stageConfig) {
+            return;
+        }
+        const stageProperty = stageConfig.property;
+        if (!deployProgress.durations) {
+            return;
+        }
+        const jobs = [];
+        for (const [jobName, durations] of Object.entries(deployProgress.durations)) {
+            if (durations?.[stageProperty] !== undefined) {
+                jobs.push({ name: jobName.toUpperCase(), duration: durations[stageProperty] });
+            }
+        }
+        if (jobs.length === 0) {
+            return;
+        }
+        logger.raw('\n');
+        logger.info(`Job Summary: ${chalk.bold(stage)}`);
+        for (const job of jobs) {
+            logger.info(`  - Job: ${job.name} | Duration: ${job.duration}s`);
+        }
+    }
+    catch (error) {
+        logger.warn(`Could not generate deployment summary: ${error.message}`);
+    }
+}
+/** Runs Apex tests on the target org. The org must already be authenticated. */
+export async function runDeployApexTests(config) {
+    const { alias, testLevel = 'RunLocalTests', testSuite, wait = '360' } = config;
+    logger.info(`Running Apex tests on org ${alias ?? 'unknown'}...`);
+    await runApexTestsCommon({ alias, testLevel, testSuite, wait, debugMode: config.debugMode });
+}
+export async function loadProgress(deployProgressFile) {
+    try {
+        return await loadValidatedJsonFile(deployProgressFile, deployProgressSchema);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {};
+        }
+        logger.warn(`Could not read or validate ${deployProgressFile}: ${error.message}. Starting fresh.`);
+        return {};
+    }
+}
+async function loadDeployConfig(deployConfigFile, deployRulesFile) {
+    try {
+        const deploymentConfig = await loadValidatedJsonFile(deployConfigFile, deployConfigSchema);
+        await validateDeploymentRules(deploymentConfig, deployRulesFile);
+        return { found: true, config: deploymentConfig };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            logger.warn(`Deployment config file not found at ${deployConfigFile}. Skipping deployments from config for this stage.`);
+            return { found: false };
+        }
+        logger.error(`Failed to read or validate ${deployConfigFile}: ${error.message}`);
+        throw error;
+    }
+}
+function resolveStartFrom(progress, stage, stageProperty, startFrom) {
+    if (startFrom) {
+        logger.info(`Starting ${chalk.bold(stage)} from job: ${chalk.bold(startFrom)} (forced by CLI option)`);
+        return { effectiveStartFrom: startFrom, idxOffset: 0 };
+    }
+    const resumePoint = progress[stageProperty];
+    if (resumePoint && resumePoint !== 'COMPLETE') {
+        logger.info(`Resuming ${chalk.bold(stage)} from job: ${chalk.bold(resumePoint)} (offset 1) based on progress file`);
+        return { effectiveStartFrom: resumePoint, idxOffset: 1 };
+    }
+    return { idxOffset: 0 };
+}
+function buildDeploymentsToRun(deploymentConfig, isProjectDeployment, stageProperty, effectiveStartFrom, idxOffset) {
+    let deploymentsToRun = deploymentConfig?.deployments ?? [];
+    if (isProjectDeployment) {
+        const localDeployment = { name: 'local' };
+        localDeployment[stageProperty] = true;
+        deploymentsToRun = [...deploymentsToRun, localDeployment];
+    }
+    if (effectiveStartFrom) {
+        const startIndex = deploymentsToRun.findIndex((d) => d.name === effectiveStartFrom);
+        if (startIndex === -1) {
+            throw new Error(`Start job ${chalk.bold(effectiveStartFrom)} not found in deployments configuration.`);
+        }
+        deploymentsToRun = deploymentsToRun.slice(startIndex + idxOffset);
+    }
+    return deploymentsToRun.filter((d) => Boolean(d[stageProperty]));
+}
+async function runDeploymentJob(deployment, stage, stageProperty, progress, deployProgressFile, config, vcsProvider) {
+    const jobName = deployment.name.toUpperCase();
+    logger.raw('\n' + '='.repeat(80));
+    logger.info(`>>> Starting Job: ${chalk.bold(jobName)} <<<`);
+    logger.raw('='.repeat(80) + '\n');
+    const startTime = Date.now();
+    try {
+        const repoDir = deployment.name.toLowerCase() === 'local'
+            ? process.cwd()
+            : await cloneRepo({ name: deployment.name, slug: deployment.slug ?? '', ref: deployment.ref }, { ciJobToken: config.ciJobToken, vcsProvider });
+        await installDeploymentPlugins(config.debug, repoDir);
+        await executeStageScript(deployment, stage, repoDir, config);
+        const durationSeconds = Number(((Date.now() - startTime) / 1000).toFixed(2));
+        progress[stageProperty] = deployment.name;
+        progress.durations ??= {};
+        progress.durations[deployment.name] ??= {};
+        progress.durations[deployment.name][stageProperty] = durationSeconds;
+        await updateProgress(deployProgressFile, progress);
+        logger.raw('\n' + '='.repeat(80));
+        logger.success(`Completed Job: ${chalk.bold(jobName)} in ${durationSeconds}s`);
+        logger.raw('='.repeat(80) + '\n');
+    }
+    catch (error) {
+        error.job = jobName;
+        throw error;
+    }
+}
+/**
+ * Runs a complete set of deployment jobs for a stage: loads (and validates) the progress and
+ * config files, determines where to resume from, then clones/prepares/executes each job in order
+ * — persisting progress after every job so a mid-run crash can resume cleanly. The target org
+ * (`config.alias`) must already be authenticated.
+ */
+export async function runDeploymentSteps(config) {
+    const { deployConfigFile, deployRulesFile, isProjectDeployment, deployProgressFile, stage, startFrom } = config;
+    const progress = await loadProgress(deployProgressFile);
+    const deployConfigResult = await loadDeployConfig(deployConfigFile, deployRulesFile);
+    if (!deployConfigResult.found && !isProjectDeployment) {
+        return { deployProgress: progress };
+    }
+    const stageConfig = STAGE_CONFIG[stage];
+    if (!stageConfig) {
+        throw new Error(`Invalid or unsupported stage for deployment jobs: ${chalk.bold(stage)}`);
+    }
+    const stageProperty = stageConfig.property;
+    const { effectiveStartFrom, idxOffset } = resolveStartFrom(progress, stage, stageProperty, startFrom);
+    const deploymentsToRun = buildDeploymentsToRun(deployConfigResult.found ? deployConfigResult.config : undefined, isProjectDeployment, stageProperty, effectiveStartFrom, idxOffset);
+    if (deploymentsToRun.length === 0) {
+        logger.info(`No deployments configured for ${chalk.bold(stage)}.`);
+        return { deployProgress: progress };
+    }
+    const vcsProvider = createVcsProvider(config.vcsProvider, { host: config.vcsHost, token: config.ciJobToken });
+    for (const deployment of deploymentsToRun) {
+        // eslint-disable-next-line no-await-in-loop
+        await runDeploymentJob(deployment, stage, stageProperty, progress, deployProgressFile, config, vcsProvider);
+    }
+    progress[stageProperty] = 'COMPLETE';
+    await updateProgress(deployProgressFile, progress);
+    return { deployProgress: progress };
+}
+/** Determines the deploy config file path: explicit path wins, else derived from the branch name. */
+export function determineDeployConfigFile(sourceBranchName, deployConfigFile) {
+    if (deployConfigFile) {
+        return deployConfigFile;
+    }
+    if (!sourceBranchName) {
+        return undefined;
+    }
+    const branchNamePart = sourceBranchName.includes('/') ? sourceBranchName.split('/')[1] : sourceBranchName;
+    return `deployment-configs/${branchNamePart}.json`;
+}
+//# sourceMappingURL=deployCommon.js.map

package/lib/deploy/deployCommon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployCommon.js","sourceRoot":"","sources":["../../src/deploy/deployCommon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAA0C,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,0BAA0B,IAAI,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAqB,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAuB,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAoB,MAAM,2BAA2B,CAAC;AA4BhF,4GAA4G;AAC5G,MAAM,UAAU,kBAAkB,CAAI,MAAoB,EAAE,IAAa,EAAE,QAAgB;IACzF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aACzE,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,KAAK,aAAa,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAI,QAAgB,EAAE,MAAoB;IACnF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEtD,OAAO,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,gHAAgH;AAChH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,gBAA8B,EAAE,SAAiB;IAC7F,IAAI,WAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,qBAAqB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,sCAAsC,SAAS,8BAA8B,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,8BAA8B,SAAS,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACzD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC;YACnF,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,cAAc,CAAC;YACnF,OAAO,WAAW,IAAI,WAAW,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC/C,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC/B,IAAI,UAAkB,CAAC;oBACvB,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;wBAC/C,UAAU,GAAG,SAAS,IAAI,CAAC,cAAc,cAAc,IAAI,CAAC,cAAc,GAAG,CAAC;oBAChF,CAAC;yBAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;wBAC/B,UAAU,GAAG,SAAS,IAAI,CAAC,cAAc,GAAG,CAAC;oBAC/C,CAAC;yBAAM,CAAC;wBACN,UAAU,GAAG,SAAS,IAAI,CAAC,cAAc,IAAI,SAAS,GAAG,CAAC;oBAC5D,CAAC;oBACD,MAAM,CAAC,IAAI,CAAC,mBAAmB,UAAU,+BAA+B,aAAa,IAAI,CAAC,CAAC;gBAC7F,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,yEAAyE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,sEAAsE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,iBAAiB,EAAE,gBAAgB;IACnC,kBAAkB,EAAE,iBAAiB;IACrC,mBAAmB,EAAE,kBAAkB;IACvC,aAAa,EAAE,YAAY;IAC3B,kBAAkB,EAAE,iBAAiB;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAgD;IACvE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;IACjD,mBAAmB,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IACrD,aAAa,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;IACzC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE;CACpD,CAAC;AAEF,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,kBAA0B,EAAE,WAA2B;IAC1F,MAAM,QAAQ,GAAG,GAAG,kBAAkB,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,aAAa,GAAyC;IAC1D,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE;IAC5B,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE;IAC5B,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAC3B,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;CAChC,CAAC;AAEF,KAAK,UAAU,qBAAqB,CAAC,OAAe,EAAE,OAAe;IACnE,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,4CAA4C;YAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,8BAA8B,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC;YAC1E,4CAA4C;YAC5C,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CACT,IAAI,OAAO,sCAAsC,GAAG,mDAAmD,CACxG,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAQD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA2B,EAC3B,KAAa,EACb,OAAe,EACf,MAAgC;IAEhC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,kCAAkC,KAAK,8BAA8B,CAAC,CAAC;QACnF,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,UAAU,UAAU,6BAA6B,UAAU,CAAC,IAAI,aAAa,CAAC,CAAC;QAC3F,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,sBAAsB,UAAU,EAAE,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,kCAAkC,CAAC,CAAC;QAC3D,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,MAAM,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE9C,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC;IAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAErD,MAAM,UAAU,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IAC5E,IAAI,KAAK,EAAE,CAAC;QACV,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,kBAAkB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEjG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACxF,CAAC;AAQD,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,MAA8C;IACnG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC7E,MAAM,gCAAgC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,sBAAsB,CAAC,cAA8B,EAAE,KAAa;IAClF,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC;QAE3C,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAA8C,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5E,IAAI,SAAS,EAAE,CAAC,aAAa,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,gBAAgB,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,0CAA2C,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AASD,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAA0B;IACjE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,eAAe,EAAE,SAAS,EAAE,IAAI,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;IAE/E,MAAM,CAAC,IAAI,CAAC,6BAA6B,KAAK,IAAI,SAAS,KAAK,CAAC,CAAC;IAClE,MAAM,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,kBAA0B;IAC3D,IAAI,CAAC;QACH,OAAO,MAAM,qBAAqB,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,8BAA8B,kBAAkB,KAAM,KAAe,CAAC,OAAO,mBAAmB,CAAC,CAAC;QAC9G,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAID,KAAK,UAAU,gBAAgB,CAAC,gBAAwB,EAAE,eAAuB;IAC/E,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QAC3F,MAAM,uBAAuB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;QACjE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CACT,uCAAuC,gBAAgB,oDAAoD,CAC5G,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,8BAA8B,gBAAgB,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAwB,EACxB,KAAa,EACb,aAA4B,EAC5B,SAAkB;IAElB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACvG,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,WAAW,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;QACpH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,qBAAqB,CAC5B,gBAA0C,EAC1C,mBAAwC,EACxC,aAA4B,EAC5B,kBAAsC,EACtC,SAAiB;IAEjB,IAAI,gBAAgB,GAAsB,gBAAgB,EAAE,WAAW,IAAI,EAAE,CAAC;IAE9E,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,eAAe,GAAoB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3D,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QACtC,gBAAgB,GAAG,CAAC,GAAG,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;QACpF,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,0CAA0C,CAAC,CAAC;QACzG,CAAC;QACD,gBAAgB,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAmBD,KAAK,UAAU,gBAAgB,CAC7B,UAA2B,EAC3B,KAAa,EACb,aAA4B,EAC5B,QAAwB,EACxB,kBAA0B,EAC1B,MAAgC,EAChC,WAAwB;IAExB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAE9C,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,OAAO,GACX,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,OAAO;YACvC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACf,CAAC,CAAC,MAAM,SAAS,CACb,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,EAC3E,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,CAC/C,CAAC;QAER,MAAM,wBAAwB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,kBAAkB,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE7D,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7E,QAAQ,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC;QAC1C,QAAQ,CAAC,SAAS,KAAK,EAAE,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3C,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,eAAe,CAAC;QAErE,MAAM,cAAc,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QAEnD,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,kBAAkB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,eAAe,GAAG,CAAC,CAAC;QAC/E,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACd,KAAkC,CAAC,GAAG,GAAG,OAAO,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAgC;IACvE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEhH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACxD,MAAM,kBAAkB,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAErF,IAAI,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACtD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,qDAAqD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC;IAE3C,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IACtG,MAAM,gBAAgB,GAAG,qBAAqB,CAC5C,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAChE,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,SAAS,CACV,CAAC;IAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,iCAAiC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAE9G,KAAK,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC;QAC1C,4CAA4C;QAC5C,MAAM,gBAAgB,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9G,CAAC;IAED,QAAQ,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;IACrC,MAAM,cAAc,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAEnD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,yBAAyB,CAAC,gBAAyB,EAAE,gBAAyB;IAC5F,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,cAAc,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC1G,OAAO,sBAAsB,cAAc,OAAO,CAAC;AACrD,CAAC"}

package/lib/deploy/deployHappySoup.d.ts

@@ -0,0 +1,56 @@
+import { type VcsProviderKind } from '../vcs/index.js';
+import { type OrgAuthConfig } from './deployCommon.js';
+export type DeploymentCloseOutConfig = {
+    projectAccessToken: string;
+    ciPipelineId: string;
+    ciProjectPath: string;
+    ciCommitRefName: string;
+    deployReleaseDate?: string;
+    deployConfigFile?: string;
+    vcsHost?: string;
+    vcsProvider: VcsProviderKind;
+};
+export type TagDeploymentConfig = OrgAuthConfig & {
+    projectAccessToken: string;
+    ciPipelineId: string;
+    ciProjectPath: string;
+    ciPipelineUrl?: string;
+    ciMergeRequestProjectUrl?: string;
+    ciMergeRequestIid?: string;
+    debug?: boolean;
+    vcsHost?: string;
+    vcsProvider: VcsProviderKind;
+};
+export type DeployHappySoupOptions = OrgAuthConfig & {
+    stage: string;
+    sourceBranchName?: string;
+    deployConfigFile?: string;
+    deployRulesFile?: string;
+    deployProgressFile?: string;
+    startFrom?: string;
+    debug?: boolean;
+    testLevel?: string;
+    tests?: string;
+    ciJobToken?: string;
+    vcsHost?: string;
+    vcsProvider: VcsProviderKind;
+    installType?: 'All' | 'Delta' | 'Upgrade';
+    upgradeType?: 'DeprecateOnly' | 'Mixed' | 'Delete';
+    wait?: string;
+    packagingDevhub?: string;
+    projectAccessToken?: string;
+    ciPipelineId?: string;
+    ciProjectPath?: string;
+    ciPipelineUrl?: string;
+    ciMergeRequestProjectUrl?: string;
+    ciMergeRequestIid?: string;
+    ciCommitRefName?: string;
+    deployReleaseDate?: string;
+};
+/**
+ * Runs a "happy-soup" (multi-repo, unlocked-package) deployment stage. `install-packaged` installs
+ * dependencies only; `tag-deployment` and `deployment-close-out` have their own git-native logic;
+ * every other stage runs through the resumable deployment-steps loop against the branch-derived
+ * (or explicit) deploy config file.
+ */
+export declare function deployHappySoup(options: DeployHappySoupOptions): Promise<void>;

package/lib/deploy/deployHappySoup.js

@@ -0,0 +1,160 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { promises as fs } from 'node:fs';
+import { execa } from 'execa';
+import { createVcsProvider } from '../vcs/index.js';
+import { runSf } from '../exec/sfCli.js';
+import { addGitRemote } from '../git.js';
+import { logger } from '../logger.js';
+import { installPackageDependencies as installPackageDependenciesCommon, resolveUpgradedPackages, } from '../sfPackages.js';
+import { runDeployStage } from './runDeployStage.js';
+import { determineDeployConfigFile, loadProgress, printDeploymentSummary, runDeploymentSteps, updateProgress, } from './deployCommon.js';
+async function archiveOrRemoveDeployConfig(finalDeployConfigFile, remoteAlias) {
+    if (finalDeployConfigFile) {
+        try {
+            await fs.access(finalDeployConfigFile);
+            const newDeployPath = 'config/deploy.json';
+            await fs.copyFile(finalDeployConfigFile, newDeployPath);
+            await execa('git', ['add', newDeployPath]);
+            await execa('git', ['commit', '-m', 'Archiving deploy.json [skip ci]', newDeployPath]);
+            await execa('git', ['push', remoteAlias]);
+            return;
+        }
+        catch {
+            // Fall through and try to remove an obsolete config/deploy.json instead.
+        }
+    }
+    try {
+        await fs.access('config/deploy.json');
+        await execa('git', ['rm', 'config/deploy.json']);
+        await execa('git', ['commit', '-m', 'Removing obsolete config/deploy.json [skip ci]', 'config/deploy.json']);
+        await execa('git', ['push', remoteAlias]);
+    }
+    catch {
+        logger.warn('Unable to find a deploy.json to archive.');
+    }
+}
+/** Fetches/switches to the release branch, then archives (or removes an obsolete) `config/deploy.json`. */
+async function deploymentCloseOut(config) {
+    const { projectAccessToken, ciPipelineId, ciProjectPath, ciCommitRefName, deployReleaseDate, deployConfigFile, vcsHost, vcsProvider: vcsProviderKind, } = config;
+    const vcsProvider = createVcsProvider(vcsProviderKind, { host: vcsHost, token: projectAccessToken });
+    const remoteAlias = await addGitRemote(ciPipelineId, projectAccessToken, ciProjectPath, vcsProvider);
+    await execa('git', ['fetch']);
+    await execa('git', ['switch', ciCommitRefName]);
+    const finalDeployConfigFile = deployReleaseDate ? `deployment-configs/${deployReleaseDate}.json` : deployConfigFile;
+    await archiveOrRemoveDeployConfig(finalDeployConfigFile, remoteAlias);
+}
+function formatDeploymentTimestamp(date) {
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: 'America/New_York',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hourCycle: 'h23',
+    });
+    const parts = formatter.formatToParts(date);
+    const partMap = Object.fromEntries(parts.map((p) => [p.type, p.value]));
+    return `${partMap.year}${partMap.month}${partMap.day}.${partMap.hour}${partMap.minute}`;
+}
+function buildDeploymentTagMessage(orgDomainPrefix, currentTime, config, vcsProvider) {
+    let message = `deployed to org ${orgDomainPrefix} at ${currentTime}`;
+    if (config.ciPipelineUrl) {
+        message += ` Associated pipeline - ${config.ciPipelineUrl}`;
+    }
+    if (config.ciMergeRequestProjectUrl && config.ciMergeRequestIid) {
+        // Both the wording and the URL path differ per platform, so both come from the provider.
+        const changeRequestUrl = vcsProvider.buildChangeRequestUrl(config.ciMergeRequestProjectUrl, config.ciMergeRequestIid);
+        message += ` Associated ${vcsProvider.terminology.changeRequest} - ${changeRequestUrl}`;
+    }
+    return message;
+}
+/** Tags the current commit with deployment details (org, timestamp, pipeline/MR links) and pushes the tag. */
+async function tagDeployment(config) {
+    const { alias, projectAccessToken, ciPipelineId, ciProjectPath, vcsHost, vcsProvider: vcsProviderKind } = config;
+    const vcsProvider = createVcsProvider(vcsProviderKind, { host: vcsHost, token: projectAccessToken });
+    const remoteAlias = await addGitRemote(ciPipelineId, projectAccessToken, ciProjectPath, vcsProvider);
+    const { stdout: orgDisplay } = await runSf(['org', 'display', '--target-org', alias ?? '', '--json']);
+    const instanceUrlResult = JSON.parse(orgDisplay).result.instanceUrl;
+    const instanceSlug = instanceUrlResult.split('.')[0];
+    const orgDomainPrefix = instanceSlug.replace('https://', '');
+    if (!orgDomainPrefix) {
+        throw new Error('Unable to determine org domain prefix.');
+    }
+    const currentTime = formatDeploymentTimestamp(new Date());
+    const gitMessage = buildDeploymentTagMessage(orgDomainPrefix, currentTime, config, vcsProvider);
+    const tagName = `deployed--${orgDomainPrefix}-${currentTime}`;
+    await execa('git', ['tag', '-m', gitMessage, tagName]);
+    await execa('git', ['push', remoteAlias, '--tags']);
+    logger.log(`Deployment tagged as ${tagName}`);
+}
+/**
+ * Installs the target org's packaged dependencies, and — for every dependency that upgraded an
+ * already-installed package — resolves the previous/target version's origin commit SHA and
+ * pipeline URL via `sf package version report`. Detection only: the remote commit compare and
+ * story extraction happen later, at notify time (`notify happy-soup`), once the origin repo per
+ * package can be resolved. The target org must already be authenticated.
+ */
+async function installPackagedAndDetectUpgrades(config) {
+    const { alias, wait, installType, upgradeType } = config;
+    const installResults = await installPackageDependenciesCommon({ alias, wait, installType, upgradeType });
+    return resolveUpgradedPackages(installResults, { packagingDevhub: config.packagingDevhub });
+}
+async function runHappySoupStage(stage, config, deployConfigFile) {
+    if (stage === 'install-packaged') {
+        const upgradedPackages = await installPackagedAndDetectUpgrades(config);
+        const deployProgressFile = config.deployProgressFile ?? 'DEPLOY_PROGRESS.json';
+        const progress = await loadProgress(deployProgressFile);
+        progress.upgradedPackages = upgradedPackages;
+        await updateProgress(deployProgressFile, progress);
+    }
+    else if (stage === 'tag-deployment') {
+        // The CLI layer requires projectAccessToken/ciPipelineId/ciProjectPath for this stage.
+        await tagDeployment(config);
+    }
+    else if (stage === 'deployment-close-out') {
+        // The CLI layer requires projectAccessToken/ciPipelineId/ciProjectPath/ciCommitRefName for this stage.
+        await deploymentCloseOut({ ...config, deployConfigFile });
+    }
+    else {
+        // The CLI layer requires ciJobToken for every other stage.
+        const stepsConfig = {
+            ...config,
+            ciJobToken: config.ciJobToken ?? '',
+            stage,
+            deployConfigFile: deployConfigFile ?? '',
+            deployProgressFile: config.deployProgressFile ?? 'DEPLOY_PROGRESS.json',
+            deployRulesFile: config.deployRulesFile ?? 'config/deploy-rules.json',
+        };
+        const { deployProgress } = await runDeploymentSteps(stepsConfig);
+        printDeploymentSummary(deployProgress, stage);
+    }
+}
+/**
+ * Runs a "happy-soup" (multi-repo, unlocked-package) deployment stage. `install-packaged` installs
+ * dependencies only; `tag-deployment` and `deployment-close-out` have their own git-native logic;
+ * every other stage runs through the resumable deployment-steps loop against the branch-derived
+ * (or explicit) deploy config file.
+ */
+export async function deployHappySoup(options) {
+    const { stage, ...config } = options;
+    await runDeployStage(stage, options, async () => {
+        const deployConfigFile = determineDeployConfigFile(config.sourceBranchName, config.deployConfigFile);
+        await runHappySoupStage(stage, config, deployConfigFile);
+    });
+}
+//# sourceMappingURL=deployHappySoup.js.map

package/lib/deploy/deployHappySoup.js.map

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

package/lib/deploy/deployProject.d.ts

@@ -0,0 +1,27 @@
+import type { VcsProviderKind } from '../vcs/index.js';
+import { type OrgAuthConfig, type RunApexTestsConfig } from './deployCommon.js';
+type UpgradeType = 'DeprecateOnly' | 'Mixed' | 'Delete';
+export type InstallProjectPackageConfig = OrgAuthConfig & {
+    subscriberPackageVersionId?: string;
+    debug?: boolean;
+    upgradeType?: UpgradeType;
+};
+export type DeployProjectOptions = OrgAuthConfig & RunApexTestsConfig & InstallProjectPackageConfig & {
+    stage: string;
+    deployConfigFile?: string;
+    deployRulesFile?: string;
+    deployProgressFile?: string;
+    startFrom?: string;
+    tests?: string;
+    ciJobToken: string;
+    vcsHost?: string;
+    vcsProvider: VcsProviderKind;
+    installType?: 'All' | 'Delta' | 'Upgrade';
+};
+/**
+ * Runs a single-package "project" deployment stage: `install-packaged` installs dependencies plus
+ * the project's own package, `run-apex-tests` delegates to the shared Apex test runner, and every
+ * other stage runs through the resumable deployment-steps loop against `config/deploy.json`.
+ */
+export declare function deployProject(options: DeployProjectOptions): Promise<void>;
+export {};