@sfdxy/anypoint-connect 0.14.0 → 0.16.2

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYnD;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAGjC,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAH/B,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,aAAa,CAAC,EAAE,MAAM,YAAA;IAMnC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;CAc7D"}

package/dist/utils/errors.js

@@ -3,11 +3,13 @@
  * Shared error formatting for CLI and MCP error handling
  */
 import { AxiosError } from 'axios';
+import { redactDeep } from '../safety/secrets.js';
 /**
  * Extracts a human-readable message from an unknown error value.
  * For AxiosErrors, prefers the API response body (which often contains
  * a more descriptive message than the generic HTTP status).
- * Safely handles Error instances, strings, and other types.
+ * Safely handles Error instances, strings, and other types. Secret-looking
+ * fields in an echoed response body are masked.
  */
 export function errorMessage(error) {
     if (error instanceof AxiosError && error.response) {
@@ -17,11 +19,37 @@ export function errorMessage(error) {
         if (data && typeof data === 'object') {
             if ('message' in data)
                 return String(data.message);
-            // Some APIs return { error: '...' } or { status, ... } — show full body
-            return `HTTP ${error.response.status}: ${JSON.stringify(data)}`;
+            // Some APIs return { error: '...' } or { status, ... } — show the body, masked
+            return `HTTP ${error.response.status}: ${JSON.stringify(redactDeep(data))}`;
         }
         return `HTTP ${error.response.status || 'unknown'}`;
     }
     return error instanceof Error ? error.message : String(error);
 }
+/**
+ * A metrics query the monitoring service rejected or could not run. Carries the platform's own
+ * message (syntax errors, unknown datasources or attributes, oversized limits) so callers never
+ * mistake a broken query for "no data".
+ */
+export class AmqlQueryError extends Error {
+    query;
+    status;
+    transactionId;
+    constructor(message, query, status, transactionId) {
+        super(message);
+        this.query = query;
+        this.status = status;
+        this.transactionId = transactionId;
+        this.name = 'AmqlQueryError';
+    }
+    static from(error, query) {
+        if (error instanceof AxiosError && error.response) {
+            const data = error.response.data;
+            const detail = typeof data?.message === 'string' ? data.message : errorMessage(error);
+            const transactionId = typeof data?.['X-ANYPNT-TRX-ID'] === 'string' ? data['X-ANYPNT-TRX-ID'] : undefined;
+            return new AmqlQueryError(`AMQL query failed (HTTP ${error.response.status}): ${detail}`, query, error.response.status, transactionId);
+        }
+        return new AmqlQueryError(`AMQL query failed: ${errorMessage(error)}`, query);
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,SAAS,IAAI,IAAI;gBAAE,OAAO,MAAM,CAAE,IAA4B,CAAC,OAAO,CAAC,CAAC;YAC5E,wEAAwE;YACxE,OAAO,QAAQ,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,CAAC;QACD,OAAO,QAAQ,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,SAAS,IAAI,IAAI;gBAAE,OAAO,MAAM,CAAE,IAA4B,CAAC,OAAO,CAAC,CAAC;YAC5E,+EAA+E;YAC/E,OAAO,QAAQ,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAChF,CAAC;QACD,OAAO,QAAQ,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGxB;IACA;IACA;IAJb,YACI,OAAe,EACN,KAAa,EACb,MAAe,EACf,aAAsB;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAS;QACf,kBAAa,GAAb,aAAa,CAAS;QAG/B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,KAAa;QACrC,IAAI,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAsE,CAAC;YACnG,MAAM,MAAM,GAAG,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACtF,MAAM,aAAa,GAAG,OAAO,IAAI,EAAE,CAAC,iBAAiB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1G,OAAO,IAAI,cAAc,CACrB,2BAA2B,KAAK,CAAC,QAAQ,CAAC,MAAM,MAAM,MAAM,EAAE,EAC9D,KAAK,EACL,KAAK,CAAC,QAAQ,CAAC,MAAM,EACrB,aAAa,CAChB,CAAC;QACN,CAAC;QACD,OAAO,IAAI,cAAc,CAAC,sBAAsB,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;CACJ"}

package/dist/workflows/app-change.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Application change workflow
+ * One plan and one PATCH for every change to an existing CloudHub 2.0 application: artifact,
+ * runtime, settings and update strategy, applied in place or as stop, change, start. Shared by
+ * the MCP tools and the CLI so previews, runtime checks, secret handling and waits match.
+ */
+import type { AnypointClient } from '../client/AnypointClient.js';
+import type { Environment } from '../api/AccessManagementApi.js';
+import type { ArtifactRef, CH2Deployment, DeploymentPatch } from '../api/CloudHub2Api.js';
+import { type DeploymentChange, type SettingsChange, type SettingsPlan } from '../safety/deployment.js';
+import { type RuntimeSpec } from '../safety/runtime.js';
+import { type SecretSource } from '../safety/secret-sources.js';
+import { type PhaseSnapshot } from './app-state.js';
+export type ChangeMode = 'inPlace' | 'stopStart';
+export type UpdateStrategy = 'rolling' | 'recreate';
+/** A settings change as callers express it: inline values plus server-side sources. */
+export interface SettingsChangeInput extends SettingsChange {
+    propertiesFrom?: SecretSource[];
+    securePropertiesFrom?: SecretSource[];
+}
+/** Resolve file and environment sources into values. Returns the secret values for output scrubbing. */
+export declare function resolveSettingsInput(input: SettingsChangeInput | undefined, options?: {
+    projectRoot?: string;
+    env?: NodeJS.ProcessEnv;
+}): {
+    change: SettingsChange | undefined;
+    secretValues: string[];
+};
+export interface AppChangeRequest {
+    orgId: string;
+    env: Environment;
+    appName: string;
+    /** Prefetched deployment detail; looked up by name when omitted. */
+    existing?: CH2Deployment | null;
+    ref?: Partial<ArtifactRef>;
+    runtime?: RuntimeSpec;
+    settings?: SettingsChange;
+    updateStrategy?: UpdateStrategy;
+    mode?: ChangeMode;
+    /** Restart even when nothing else changes (stop then start). */
+    restart?: boolean;
+    /** Values to scrub from every response and error. */
+    secretValues?: string[];
+}
+export interface RuntimeCheck {
+    checked: boolean;
+    reason?: string;
+    targetId: string;
+    current: {
+        version: string;
+        java?: string;
+        releaseChannel?: string;
+        supported?: boolean;
+    };
+    requested?: {
+        version: string;
+        java?: string;
+        releaseChannel?: string;
+        supported?: boolean;
+    };
+    suggestions?: string[];
+}
+export interface AppChangePlan {
+    request: AppChangeRequest;
+    existing: CH2Deployment;
+    mode: ChangeMode;
+    patch: DeploymentPatch;
+    changes: DeploymentChange[];
+    settings?: SettingsPlan;
+    runtimeCheck: RuntimeCheck;
+    steps: string[];
+    warnings: string[];
+    /** Problems that stop the change before anything is written. */
+    blockers: string[];
+    production: boolean;
+    /** Nothing would change. */
+    noop: boolean;
+}
+/** Build the plan: what changes, the single PATCH body, the runtime check and the steps. Nothing is written. */
+export declare function planAppChange(client: AnypointClient, request: AppChangeRequest): Promise<AppChangePlan>;
+/** A serializable preview of the plan. Never contains secret values. */
+export declare function describeAppChange(plan: AppChangePlan): {
+    preserved: string;
+    production?: boolean | undefined;
+    noop?: boolean | undefined;
+    blockers?: string[] | undefined;
+    warnings?: string[] | undefined;
+    runtimeCheck: RuntimeCheck;
+    steps: string[];
+    settings?: import("../safety/deployment.js").SettingsDiff | undefined;
+    app: string;
+    environment: string;
+    mode: ChangeMode;
+    current: {
+        ref: ArtifactRef;
+        runtime: {
+            version: string;
+            releaseChannel?: string;
+            java?: string;
+        } | undefined;
+        updateStrategy: string;
+        desiredState: string;
+        phase: import("./app-state.js").AppPhase;
+    };
+    changes: DeploymentChange[];
+};
+export interface AppChangeResult {
+    deployment: CH2Deployment;
+    performed: string[];
+    snapshot?: PhaseSnapshot;
+    timedOut?: boolean;
+    /** The stop step ran but the start step did not; the app is left stopped. */
+    leftStopped?: boolean;
+}
+export interface ExecuteOptions {
+    wait?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    graceMs?: number;
+    onStatus?: (step: string, snapshot: PhaseSnapshot) => void;
+}
+/** Apply a plan. Errors and results are scrubbed of the request's secret values. */
+export declare function executeAppChange(client: AnypointClient, plan: AppChangePlan, options?: ExecuteOptions): Promise<AppChangeResult>;
+//# sourceMappingURL=app-change.d.ts.map

package/dist/workflows/app-change.d.ts.map

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

package/dist/workflows/app-change.js

@@ -0,0 +1,305 @@
+/**
+ * Application change workflow
+ * One plan and one PATCH for every change to an existing CloudHub 2.0 application: artifact,
+ * runtime, settings and update strategy, applied in place or as stop, change, start. Shared by
+ * the MCP tools and the CLI so previews, runtime checks, secret handling and waits match.
+ */
+import { isEmptySettingsChange, mergeForArtifactUpdate, planSettingsChange, } from '../safety/deployment.js';
+import { isProductionEnv } from '../safety/guards.js';
+import { parseRuntimeString, resolveRuntime, suggestRuntimes } from '../safety/runtime.js';
+import { looksSecret, redactText } from '../safety/secrets.js';
+import { resolveSecretSources } from '../safety/secret-sources.js';
+import { errorMessage } from '../utils/errors.js';
+import { deploymentPhase, waitForAppPhase } from './app-state.js';
+/** Resolve file and environment sources into values. Returns the secret values for output scrubbing. */
+export function resolveSettingsInput(input, options = {}) {
+    if (!input)
+        return { change: undefined, secretValues: [] };
+    const properties = { ...resolveSecretSources(input.propertiesFrom, options), ...(input.properties ?? {}) };
+    const secureProperties = {
+        ...resolveSecretSources(input.securePropertiesFrom, options),
+        ...(input.secureProperties ?? {}),
+    };
+    const change = {
+        ...(Object.keys(properties).length ? { properties } : {}),
+        ...(Object.keys(secureProperties).length ? { secureProperties } : {}),
+        ...(input.removeProperties?.length ? { removeProperties: input.removeProperties } : {}),
+        ...(input.removeSecureProperties?.length ? { removeSecureProperties: input.removeSecureProperties } : {}),
+        ...(input.moveToSecure?.length ? { moveToSecure: input.moveToSecure } : {}),
+    };
+    const secretValues = [
+        ...Object.values(secureProperties),
+        ...Object.entries(properties)
+            .filter(([key]) => looksSecret(key))
+            .map(([, value]) => value),
+    ];
+    return { change: isEmptySettingsChange(change) ? undefined : change, secretValues };
+}
+function refsDiffer(a, b) {
+    return (a.groupId !== b.groupId ||
+        a.artifactId !== b.artifactId ||
+        a.version !== b.version ||
+        a.packaging !== b.packaging);
+}
+async function loadCatalog(client, orgId, targetId) {
+    try {
+        const target = await client.runtimes.getTarget(orgId, targetId);
+        if (!target)
+            return { reason: `target ${targetId} is not in the organization's runtime catalog` };
+        if (target.runtimes.length === 0)
+            return { reason: `target ${targetId} lists no runtime versions` };
+        return { catalog: target.runtimes };
+    }
+    catch (error) {
+        return { reason: `runtime catalog unavailable: ${errorMessage(error)}` };
+    }
+}
+/** Pick the Java version to send: requested, else the current one if still offered, else 17, else the newest offered. */
+function chooseJava(resolved, requested, current) {
+    if (requested)
+        return requested;
+    if (!resolved || resolved.java.length === 0)
+        return current;
+    if (current && resolved.java.includes(current))
+        return current;
+    if (resolved.java.includes('17'))
+        return '17';
+    return resolved.java[resolved.java.length - 1];
+}
+/** Build the plan: what changes, the single PATCH body, the runtime check and the steps. Nothing is written. */
+export async function planAppChange(client, request) {
+    const existing = request.existing ?? (await client.cloudHub2.findDetailByName(request.orgId, request.env.id, request.appName));
+    if (!existing)
+        throw new Error(`Application "${request.appName}" not found in ${request.env.name}`);
+    const mode = request.mode ?? (request.restart ? 'stopStart' : 'inPlace');
+    const changes = [];
+    const warnings = [];
+    const blockers = [];
+    const patch = {};
+    const settings = existing.target?.deploymentSettings ?? {};
+    // Artifact
+    if (request.ref && Object.values(request.ref).some((v) => v !== undefined)) {
+        const nextRef = mergeForArtifactUpdate(existing, request.ref).application.ref;
+        if (refsDiffer(existing.application.ref, nextRef)) {
+            patch.application = { ...patch.application, ref: nextRef };
+            for (const field of ['groupId', 'artifactId', 'version', 'packaging']) {
+                if (existing.application.ref[field] !== nextRef[field]) {
+                    changes.push({ field: `ref.${field}`, from: existing.application.ref[field], to: nextRef[field] });
+                }
+            }
+        }
+    }
+    // Settings
+    let settingsPlan;
+    if (!isEmptySettingsChange(request.settings)) {
+        settingsPlan = planSettingsChange(existing, request.settings);
+        warnings.push(...settingsPlan.warnings);
+        if (settingsPlan.changed) {
+            patch.application = {
+                ...patch.application,
+                configuration: { 'mule.agent.application.properties.service': settingsPlan.service },
+            };
+        }
+    }
+    // Runtime
+    const currentRuntime = settings.runtime ?? { version: 'unknown' };
+    const current = parseRuntimeString(currentRuntime.version, currentRuntime.java);
+    const { catalog, reason } = await loadCatalog(client, request.orgId, existing.target.targetId);
+    const runtimeCheck = {
+        checked: Boolean(catalog),
+        ...(reason ? { reason } : {}),
+        targetId: existing.target.targetId,
+        current: {
+            version: current.version,
+            ...(current.java ? { java: current.java } : {}),
+            ...(currentRuntime.releaseChannel ? { releaseChannel: currentRuntime.releaseChannel } : {}),
+            ...(catalog
+                ? { supported: Boolean(resolveRuntime(catalog, { version: current.version, java: current.java })) }
+                : {}),
+        },
+    };
+    let nextRuntime;
+    if (request.runtime) {
+        const resolved = catalog ? resolveRuntime(catalog, request.runtime) : undefined;
+        runtimeCheck.requested = {
+            version: request.runtime.version,
+            ...(request.runtime.java ? { java: request.runtime.java } : {}),
+            ...(request.runtime.releaseChannel ? { releaseChannel: request.runtime.releaseChannel } : {}),
+            ...(catalog ? { supported: Boolean(resolved) } : {}),
+        };
+        if (catalog && !resolved) {
+            runtimeCheck.suggestions = suggestRuntimes(catalog, request.runtime.java ? request.runtime : { ...request.runtime, java: current.java });
+            blockers.push(`Runtime ${request.runtime.version}${request.runtime.java ? ` (Java ${request.runtime.java})` : ''} is not offered by ${existing.target.targetId}. Nearest supported: ${runtimeCheck.suggestions.join('; ') || 'none listed'}`);
+        }
+        nextRuntime = {
+            version: resolved?.version ?? request.runtime.version,
+            ...((request.runtime.releaseChannel ?? resolved?.releaseChannel ?? currentRuntime.releaseChannel)
+                ? {
+                    releaseChannel: request.runtime.releaseChannel ?? resolved?.releaseChannel ?? currentRuntime.releaseChannel,
+                }
+                : {}),
+            ...(chooseJava(resolved, request.runtime.java, current.java)
+                ? { java: chooseJava(resolved, request.runtime.java, current.java) }
+                : {}),
+        };
+        if (!catalog)
+            warnings.push(`Runtime ${nextRuntime.version} was not validated (${reason})`);
+        if (nextRuntime.version !== current.version)
+            changes.push({ field: 'runtime', from: current.version, to: nextRuntime.version });
+        if (nextRuntime.java && nextRuntime.java !== current.java)
+            changes.push({ field: 'java', from: current.java, to: nextRuntime.java });
+        if (nextRuntime.releaseChannel && nextRuntime.releaseChannel !== currentRuntime.releaseChannel) {
+            changes.push({
+                field: 'releaseChannel',
+                from: currentRuntime.releaseChannel,
+                to: nextRuntime.releaseChannel,
+            });
+        }
+        if (changes.every((c) => !['runtime', 'java', 'releaseChannel'].includes(c.field)))
+            nextRuntime = undefined;
+    }
+    // Update strategy
+    const strategyChange = request.updateStrategy && request.updateStrategy !== (settings.updateStrategy ?? 'rolling')
+        ? request.updateStrategy
+        : undefined;
+    if (strategyChange)
+        changes.push({ field: 'updateStrategy', from: settings.updateStrategy ?? 'rolling', to: strategyChange });
+    if (nextRuntime || strategyChange) {
+        // The live target is restated exactly as read, so only the runtime and strategy differ.
+        patch.target = {
+            provider: existing.target.provider,
+            targetId: existing.target.targetId,
+            replicas: existing.target.replicas,
+            deploymentSettings: {
+                ...settings,
+                ...(nextRuntime ? { runtime: nextRuntime } : {}),
+                ...(strategyChange ? { updateStrategy: strategyChange } : {}),
+            },
+        };
+    }
+    const createsSpec = Boolean(patch.application?.ref || patch.application?.configuration || patch.target);
+    if (catalog && runtimeCheck.current.supported === false && !nextRuntime && createsSpec) {
+        runtimeCheck.suggestions = suggestRuntimes(catalog, current);
+        blockers.push(`The app's current runtime ${current.version}${current.java ? ` (Java ${current.java})` : ''} is no longer offered by ${existing.target.targetId}, so the platform will reject a new spec. Pass runtime with one of: ${runtimeCheck.suggestions.join('; ') || 'none listed'}`);
+    }
+    const noop = !createsSpec && !request.restart;
+    if (mode === 'stopStart' && !noop)
+        patch.application = { ...patch.application, desiredState: 'STARTED' };
+    if (settingsPlan?.changed)
+        warnings.push('Applying a settings change restarts the application.');
+    if (mode === 'inPlace' && createsSpec && (settings.updateStrategy ?? 'rolling') === 'rolling' && !strategyChange) {
+        warnings.push('Rolling update: old and new replicas overlap briefly. For apps with streaming or polling listeners use mode stopStart, or set updateStrategy recreate.');
+    }
+    if (mode === 'inPlace' && existing.application.desiredState === 'STOPPED' && createsSpec) {
+        warnings.push('The application is stopped; the change applies but it stays stopped until started.');
+    }
+    const steps = noop
+        ? []
+        : mode === 'stopStart'
+            ? [
+                ...(existing.application.desiredState !== 'STOPPED'
+                    ? ['stop the application and wait until it is stopped']
+                    : []),
+                createsSpec ? 'apply the change and start in one update' : 'start the application',
+                'wait until every replica runs the new spec',
+            ]
+            : ['apply the change in one update (one new spec)', 'wait until every replica runs the new spec'];
+    return {
+        request,
+        existing,
+        mode,
+        patch,
+        changes,
+        ...(settingsPlan ? { settings: settingsPlan } : {}),
+        runtimeCheck,
+        steps,
+        warnings,
+        blockers,
+        production: isProductionEnv(request.env.name, request.env.isProduction),
+        noop,
+    };
+}
+/** A serializable preview of the plan. Never contains secret values. */
+export function describeAppChange(plan) {
+    const { existing, request } = plan;
+    const preview = {
+        app: existing.name,
+        environment: request.env.name,
+        mode: plan.mode,
+        current: {
+            ref: existing.application.ref,
+            runtime: existing.target?.deploymentSettings?.runtime,
+            updateStrategy: existing.target?.deploymentSettings?.updateStrategy ?? 'rolling',
+            desiredState: existing.application.desiredState,
+            phase: deploymentPhase(existing).phase,
+        },
+        changes: plan.changes,
+        ...(plan.settings ? { settings: plan.settings.diff } : {}),
+        runtimeCheck: plan.runtimeCheck,
+        steps: plan.steps,
+        ...(plan.warnings.length ? { warnings: plan.warnings } : {}),
+        ...(plan.blockers.length ? { blockers: plan.blockers } : {}),
+        ...(plan.noop ? { noop: true } : {}),
+        ...(plan.production ? { production: true } : {}),
+        preserved: 'target, replicas, resources, other settings and stored secure values',
+    };
+    return JSON.parse(redactText(JSON.stringify(preview), request.secretValues ?? []));
+}
+/** Apply a plan. Errors and results are scrubbed of the request's secret values. */
+export async function executeAppChange(client, plan, options = {}) {
+    if (plan.blockers.length)
+        throw new Error(plan.blockers.join('\n'));
+    const { orgId, env, secretValues = [] } = plan.request;
+    const { existing } = plan;
+    const performed = [];
+    if (plan.noop)
+        return { deployment: existing, performed };
+    // `previous` enables the staleness check, needed only when the target state looks like the
+    // starting state (an in-place update of a running app). Stop and start are told apart by state.
+    const waitFor = (step, previous, sentAt, expectedSpecVersion) => waitForAppPhase(client.cloudHub2, orgId, env.id, existing.id, {
+        expectedSpecVersion,
+        previousModifiedDate: previous?.lastModifiedDate,
+        sinceChange: sentAt,
+        timeoutMs: options.timeoutMs,
+        pollIntervalMs: options.pollIntervalMs,
+        graceMs: options.graceMs,
+        onStatus: options.onStatus ? (snapshot) => options.onStatus?.(step, snapshot) : undefined,
+    });
+    try {
+        let before = existing;
+        if (plan.mode === 'stopStart' && existing.application.desiredState !== 'STOPPED') {
+            const sentAt = Date.now();
+            await client.cloudHub2.setDesiredState(orgId, env.id, existing.id, 'STOPPED');
+            performed.push('stop requested');
+            const stopped = await waitFor('stop', undefined, sentAt);
+            if (!stopped.snapshot.settled) {
+                throw new Error(`Stop did not complete (${stopped.snapshot.phase}${stopped.timedOut ? ', timed out' : ''}); the change was not applied. The app may still be stopping.`);
+            }
+            performed.push('stopped');
+            before = stopped.deployment;
+        }
+        const sentAt = Date.now();
+        const deployment = await client.cloudHub2.patchDeployment(orgId, env.id, existing.id, plan.patch);
+        performed.push(plan.mode === 'stopStart' ? 'change applied and start requested' : 'change applied');
+        if (!options.wait)
+            return { deployment, performed };
+        const expected = deployment.desiredVersion && deployment.desiredVersion !== before.desiredVersion
+            ? deployment.desiredVersion
+            : undefined;
+        const wasRunning = before.application.desiredState !== 'STOPPED';
+        const result = await waitFor('apply', wasRunning ? before : undefined, sentAt, expected);
+        performed.push(result.snapshot.settled ? 'settled' : `wait ended in ${result.snapshot.phase}`);
+        return { deployment: result.deployment, performed, snapshot: result.snapshot, timedOut: result.timedOut };
+    }
+    catch (error) {
+        const leftStopped = performed.includes('stopped') && !performed.some((step) => step.startsWith('change applied'));
+        const message = redactText(errorMessage(error), secretValues);
+        const err = new Error(leftStopped
+            ? `${message}\nThe application was stopped and is still stopped. Steps done: ${performed.join(', ')}`
+            : performed.length
+                ? `${message}\nSteps done: ${performed.join(', ')}`
+                : message);
+        throw err;
+    }
+}
+//# sourceMappingURL=app-change.js.map

package/dist/workflows/app-change.js.map

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

package/dist/workflows/app-state.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Deployment state model
+ * One interpretation of CloudHub 2.0 deployment, application and replica status, shared by
+ * status reads and every wait loop. It hides the transient FAILED the platform reports while
+ * a stopped app starts, and never treats a status left over from the previous spec as settled.
+ */
+import type { CH2Deployment } from '../api/CloudHub2Api.js';
+/** The slice of the CloudHub 2.0 API the wait loop needs. */
+export interface DeploymentReader {
+    getDeployment(orgId: string, envId: string, deploymentId: string): Promise<CH2Deployment>;
+}
+export interface WaitOptions extends PhaseOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    onStatus?: (snapshot: PhaseSnapshot, deployment: CH2Deployment) => void;
+}
+export interface WaitResult {
+    deployment: CH2Deployment;
+    snapshot: PhaseSnapshot;
+    timedOut: boolean;
+    waitedMs: number;
+}
+/**
+ * Poll until the deployment is terminal (settled, failed past the grace window, or degraded)
+ * or the timeout passes. Never throws for a failed deployment; the caller reads the snapshot.
+ */
+export declare function waitForAppPhase(api: DeploymentReader, orgId: string, envId: string, deploymentId: string, options?: WaitOptions): Promise<WaitResult>;
+export type AppPhase = 'RUNNING' | 'STARTING' | 'UPDATING' | 'DEGRADED' | 'FAILED' | 'STOPPING' | 'STOPPED';
+export interface PhaseSnapshot {
+    phase: AppPhase;
+    /** The app reached its desired state on the expected spec. */
+    settled: boolean;
+    /** Waiting longer will not change the outcome (settled, failed or degraded past the grace window). */
+    terminal: boolean;
+    reason?: string;
+    desiredState: string;
+    platformStatus: string;
+    replicas: {
+        total: number;
+        started: number;
+        onSpec: number;
+        failed: number;
+    };
+    specVersion?: string;
+}
+export interface PhaseOptions {
+    /** Spec version the change produced; replicas must run it to count as settled. */
+    expectedSpecVersion?: string;
+    /** The deployment's `lastModifiedDate` before the change; an unchanged value means the change is not visible yet. */
+    previousModifiedDate?: number;
+    /** When the change was sent (local epoch ms), the start of the grace window. Defaults to the deployment's last modification. */
+    sinceChange?: number;
+    /** How long a FAILED status is treated as start-up noise. Default 90 s. */
+    graceMs?: number;
+    now?: number;
+}
+export declare const DEFAULT_GRACE_MS = 90000;
+/** Interpret a deployment detail as a single phase. Pure; safe to call on every poll. */
+export declare function deploymentPhase(deployment: CH2Deployment, options?: PhaseOptions): PhaseSnapshot;
+//# sourceMappingURL=app-state.d.ts.map

package/dist/workflows/app-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../src/workflows/app-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC7B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7F;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3E;AAED,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACjC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5G,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,sGAAsG;IACtG,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IACzB,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qHAAqH;IACrH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gIAAgI;IAChI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAKvC,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,GAAE,YAAiB,GAAG,aAAa,CAgEpG"}