@jterrats/smart-deployment 1.2.6 → 1.4.0

package/lib/deployment/commit-scope-service.js

@@ -0,0 +1,292 @@
+import { execFile } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { promisify } from 'node:util';
+import { DependencyGraphBuilder } from '../dependencies/dependency-graph-builder.js';
+const execFileAsync = promisify(execFile);
+export class CommitScopeService {
+    gitChangeProvider;
+    constructor(dependencies = {}) {
+        this.gitChangeProvider = dependencies.gitChangeProvider ?? new CliCommitScopeGitChangeProvider();
+    }
+    async apply(scanResult, options = {}) {
+        const manifest = options.manifestPath
+            ? await this.readManifest(scanResult.projectRoot, options.manifestPath)
+            : undefined;
+        const commits = this.resolveCommits(options, manifest);
+        const manifestScope = manifest ? this.resolveManifestScope(manifest) : undefined;
+        if (commits.length === 0 && (manifestScope?.includedComponents.length ?? 0) === 0) {
+            return {
+                scanResult,
+                summary: createDisabledSummary(),
+            };
+        }
+        const commitScope = manifestScope?.hasIncludedComponentContract === true
+            ? {
+                changedFiles: manifest?.changes ?? [],
+                changedNodeIds: manifestScope.changedComponents,
+                dependencyNodeIds: manifestScope.dependencyComponents,
+                explicitNodeIds: manifestScope.explicitComponents,
+                includedNodeIds: manifestScope.includedComponents,
+            }
+            : await this.resolveScopeFromCommits(scanResult, commits, manifestScope?.explicitComponents ?? []);
+        const includedNodeIds = this.deduplicate(commitScope.includedNodeIds);
+        const included = new Set(includedNodeIds);
+        const scopedComponents = scanResult.components
+            .filter((component) => included.has(toNodeId(component)))
+            .map((component) => cloneComponentForScope(component, included));
+        const graphBuilder = new DependencyGraphBuilder();
+        graphBuilder.addComponents(scopedComponents);
+        const scopedDependencyResult = graphBuilder.build();
+        const ignoredComponents = scanResult.components
+            .map((component) => toNodeId(component))
+            .filter((nodeId) => !included.has(nodeId))
+            .sort();
+        const summary = {
+            enabled: true,
+            commits,
+            manifestPath: options.outputManifestPath ?? options.manifestPath,
+            changedFiles: commitScope.changedFiles,
+            changedComponents: commitScope.changedNodeIds,
+            dependencyComponents: commitScope.dependencyNodeIds,
+            explicitComponents: commitScope.explicitNodeIds,
+            includedComponents: includedNodeIds,
+            ignoredComponents,
+        };
+        if (options.outputManifestPath) {
+            await this.writeManifest(scanResult.projectRoot, options.outputManifestPath, summary);
+        }
+        return {
+            scanResult: {
+                ...scanResult,
+                components: scopedComponents,
+                dependencyResult: scopedDependencyResult,
+            },
+            summary,
+        };
+    }
+    resolveCommits(options, manifest) {
+        const directCommits = parseCommitList(options.commits ?? []);
+        const manifestCommits = manifest ? parseCommitList(extractManifestCommits(manifest)) : [];
+        return this.deduplicate([...directCommits, ...manifestCommits]);
+    }
+    async readManifest(projectRoot, manifestPath) {
+        const resolvedPath = path.isAbsolute(manifestPath) ? manifestPath : path.join(projectRoot, manifestPath);
+        const raw = await readFile(resolvedPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error(`Commit scope manifest must be a JSON object: ${resolvedPath}`);
+        }
+        return parsed;
+    }
+    async writeManifest(projectRoot, manifestPath, summary) {
+        const resolvedPath = path.isAbsolute(manifestPath) ? manifestPath : path.join(projectRoot, manifestPath);
+        await mkdir(path.dirname(resolvedPath), { recursive: true });
+        await writeFile(resolvedPath, `${JSON.stringify(toManifest(summary), null, 2)}\n`, 'utf8');
+    }
+    resolveManifestScope(manifest) {
+        const changedComponents = parseNodeIdList(manifest.scope?.changedComponents ?? []);
+        const dependencyComponents = parseNodeIdList(manifest.scope?.dependencyComponents ?? []);
+        const explicitComponents = parseNodeIdList([
+            ...(manifest.scope?.explicitComponents ?? []),
+            ...(manifest.includeComponents ?? []),
+            ...(manifest.stories?.flatMap((story) => story.includeComponents ?? []) ?? []),
+        ]);
+        const contractComponents = parseNodeIdList(manifest.scope?.includedComponents ?? []);
+        const includedComponents = parseNodeIdList([
+            ...contractComponents,
+            ...changedComponents,
+            ...dependencyComponents,
+            ...explicitComponents,
+        ]);
+        if (changedComponents.length === 0 &&
+            dependencyComponents.length === 0 &&
+            explicitComponents.length === 0 &&
+            includedComponents.length === 0) {
+            return undefined;
+        }
+        return {
+            changedComponents,
+            dependencyComponents,
+            explicitComponents,
+            includedComponents,
+            hasIncludedComponentContract: contractComponents.length > 0,
+        };
+    }
+    async resolveScopeFromCommits(scanResult, commits, explicitNodeIds) {
+        const changedFiles = await this.gitChangeProvider.listCommitChanges(scanResult.projectRoot, commits);
+        const changedComponents = this.resolveChangedComponents(scanResult, changedFiles);
+        const changedNodeIds = this.deduplicate(changedComponents.map((component) => toNodeId(component)));
+        const dependencyNodeIds = this.collectDependencyClosure(scanResult, changedNodeIds);
+        const knownExplicitNodeIds = this.filterKnownNodeIds(scanResult, explicitNodeIds);
+        const includedNodeIds = this.deduplicate([...changedNodeIds, ...dependencyNodeIds, ...knownExplicitNodeIds]);
+        return {
+            changedFiles,
+            changedNodeIds,
+            dependencyNodeIds,
+            explicitNodeIds: knownExplicitNodeIds,
+            includedNodeIds,
+        };
+    }
+    resolveChangedComponents(scanResult, changes) {
+        const components = [];
+        for (const change of changes) {
+            if (change.status === 'deleted') {
+                continue;
+            }
+            const component = scanResult.components.find((candidate) => isComponentPathMatch(scanResult.projectRoot, candidate, change.path));
+            if (component) {
+                components.push(component);
+            }
+        }
+        return this.deduplicateComponents(components);
+    }
+    collectDependencyClosure(scanResult, changedNodeIds) {
+        const knownComponents = scanResult.dependencyResult.components;
+        const dependencies = new Set();
+        const visited = new Set(changedNodeIds);
+        const queue = [...changedNodeIds];
+        while (queue.length > 0) {
+            const nodeId = queue.shift();
+            for (const dependency of scanResult.dependencyResult.graph.get(nodeId) ?? []) {
+                if (!knownComponents.has(dependency) || visited.has(dependency)) {
+                    continue;
+                }
+                visited.add(dependency);
+                dependencies.add(dependency);
+                queue.push(dependency);
+            }
+        }
+        return [...dependencies].sort();
+    }
+    deduplicate(values) {
+        return [...new Set(values.filter(Boolean))].sort();
+    }
+    deduplicateComponents(components) {
+        const byNodeId = new Map();
+        for (const component of components) {
+            byNodeId.set(toNodeId(component), component);
+        }
+        return [...byNodeId.values()].sort((left, right) => toNodeId(left).localeCompare(toNodeId(right)));
+    }
+    filterKnownNodeIds(scanResult, nodeIds) {
+        return this.deduplicate(nodeIds.filter((nodeId) => scanResult.dependencyResult.components.has(nodeId)));
+    }
+}
+class CliCommitScopeGitChangeProvider {
+    async listCommitChanges(projectRoot, commits) {
+        const changesByCommit = await Promise.all(commits.map(async (commit) => {
+            const { stdout } = await execFileAsync('git', ['diff-tree', '--no-commit-id', '--name-status', '--no-renames', '-r', '--root', commit], { cwd: projectRoot });
+            return parseNameStatus(stdout, commit);
+        }));
+        return deduplicateChanges(changesByCommit.flat());
+    }
+}
+function parseNameStatus(output, commit) {
+    return output
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => {
+        const [statusCode, filePath] = line.split(/\t+/);
+        return {
+            commit,
+            status: toChangeStatus(statusCode),
+            path: normalizePath(filePath),
+        };
+    });
+}
+function parseCommitList(values) {
+    return values
+        .flatMap((value) => value.split(','))
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+function parseNodeIdList(values) {
+    return [...new Set(values.map((value) => value.trim()).filter((value) => value.includes(':')))].sort();
+}
+function extractManifestCommits(manifest) {
+    return [
+        ...(Array.isArray(manifest.commits) ? manifest.commits : []),
+        ...(Array.isArray(manifest.stories) ? manifest.stories.flatMap((story) => story.commits ?? []) : []),
+    ];
+}
+function cloneComponentForScope(component, included) {
+    const dependencies = filterNodeSet(component.dependencies, included);
+    const optionalDependencies = component.optionalDependencies
+        ? filterNodeSet(component.optionalDependencies, included)
+        : undefined;
+    return {
+        ...component,
+        dependencies,
+        optionalDependencies,
+        dependencyDetails: component.dependencyDetails?.filter((dependency) => included.has(dependency.nodeId)),
+        dependents: filterNodeSet(component.dependents, included),
+    };
+}
+function filterNodeSet(values, allowed) {
+    return new Set([...values].filter((value) => allowed.has(value)));
+}
+function isComponentPathMatch(projectRoot, component, changedPath) {
+    const relativeComponentPath = path.isAbsolute(component.filePath)
+        ? path.relative(projectRoot, component.filePath)
+        : component.filePath;
+    const componentPath = normalizePath(relativeComponentPath);
+    if (changedPath === componentPath || changedPath === `${componentPath}-meta.xml`) {
+        return true;
+    }
+    if (component.type !== 'LightningComponentBundle' && component.type !== 'AuraDefinitionBundle') {
+        return false;
+    }
+    const componentDirectory = normalizePath(path.dirname(componentPath));
+    return changedPath.startsWith(`${componentDirectory}/`);
+}
+function toChangeStatus(statusCode) {
+    if (statusCode.includes('D')) {
+        return 'deleted';
+    }
+    if (statusCode.includes('A')) {
+        return 'added';
+    }
+    return 'changed';
+}
+function deduplicateChanges(changes) {
+    const byCommitAndPath = new Map();
+    for (const change of changes) {
+        byCommitAndPath.set(`${change.commit}:${change.path}`, change);
+    }
+    return [...byCommitAndPath.values()].sort((left, right) => left.commit.localeCompare(right.commit) || left.path.localeCompare(right.path));
+}
+function normalizePath(filePath) {
+    return filePath.split(path.sep).join('/');
+}
+function toNodeId(component) {
+    return `${component.type}:${component.name}`;
+}
+function toManifest(summary) {
+    return {
+        schemaVersion: 1,
+        commits: summary.commits,
+        changes: summary.changedFiles,
+        scope: {
+            changedComponents: summary.changedComponents,
+            dependencyComponents: summary.dependencyComponents,
+            explicitComponents: summary.explicitComponents,
+            includedComponents: summary.includedComponents,
+            ignoredComponents: summary.ignoredComponents,
+        },
+    };
+}
+function createDisabledSummary() {
+    return {
+        enabled: false,
+        commits: [],
+        changedFiles: [],
+        changedComponents: [],
+        dependencyComponents: [],
+        explicitComponents: [],
+        includedComponents: [],
+        ignoredComponents: [],
+    };
+}
+//# sourceMappingURL=commit-scope-service.js.map

package/lib/deployment/commit-scope-service.js.map

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

package/lib/deployment/deployment-context-service.d.ts

@@ -1,12 +1,14 @@
 import { ProjectAnalysisService, type ProjectAnalysisAIContext, type ProjectAnalysisMessages } from '../analysis/project-analysis-service.js';
 import type { ScanResult } from '../services/metadata-scanner-service.js';
 import type { Wave } from '../waves/wave-builder.js';
+import type { CommitScopeOptions, CommitScopeSummary } from './commit-scope-service.js';
 export type DeploymentAIContext = ProjectAnalysisAIContext;
 export type DeploymentContextMessages = ProjectAnalysisMessages;
 export type DeploymentContext = {
     scanResult: ScanResult;
     orderedWaves: Wave[];
     aiContext?: DeploymentAIContext;
+    commitScope?: CommitScopeSummary;
     messages: DeploymentContextMessages;
 };
 export type DeploymentContextBuildOptions = {
@@ -14,6 +16,7 @@ export type DeploymentContextBuildOptions = {
     useAI?: boolean;
     orgType?: string;
     industry?: string;
+    commitScope?: CommitScopeOptions;
 };
 type DeploymentContextServiceDependencies = ConstructorParameters<typeof ProjectAnalysisService>[0];
 export declare class DeploymentContextService {

package/lib/deployment/deployment-context-service.js

@@ -10,6 +10,7 @@ export class DeploymentContextService {
             scanResult: analysis.scanResult,
             orderedWaves: analysis.orderedWaves,
             aiContext: analysis.aiContext,
+            commitScope: analysis.commitScope,
             messages: analysis.messages,
         };
     }

package/lib/deployment/deployment-context-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployment-context-service.js","sourceRoot":"","sources":["../../src/deployment/deployment-context-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,yCAAyC,CAAC;AAwBjD,MAAM,OAAO,wBAAwB;IAClB,sBAAsB,CAAyB;IAEhE,YAAmB,eAAqD,EAAE;QACxE,IAAI,CAAC,sBAAsB,GAAG,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,UAAyC,EAAE;QACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1E,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"deployment-context-service.js","sourceRoot":"","sources":["../../src/deployment/deployment-context-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,yCAAyC,CAAC;AA2BjD,MAAM,OAAO,wBAAwB;IAClB,sBAAsB,CAAyB;IAEhE,YAAmB,eAAqD,EAAE;QACxE,IAAI,CAAC,sBAAsB,GAAG,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,UAAyC,EAAE;QACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1E,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/lib/deployment/deployment-error-diagnostics.d.ts

@@ -0,0 +1,11 @@
+export type DeploymentDiagnosticCategory = 'missing-field' | 'missing-object' | 'duplicate-metadata' | 'permission' | 'invalid-reference' | 'source-tracking-conflict' | 'unknown';
+export type DeploymentDiagnostic = {
+    component: string;
+    problem: string;
+    probableCause: string;
+    remediation: string;
+    rawDetails: string;
+    category: DeploymentDiagnosticCategory;
+};
+export declare function normalizeDeploymentDiagnostics(output: string): DeploymentDiagnostic[];
+export declare function formatDeploymentDiagnostics(diagnostics: readonly DeploymentDiagnostic[]): string;

package/lib/deployment/deployment-error-diagnostics.js

@@ -0,0 +1,187 @@
+const UNKNOWN_COMPONENT = 'Unknown component';
+const UNKNOWN_NEXT_STEP = 'Review the raw Salesforce deploy output, confirm the metadata exists in the target org, and retry with a focused validation for the affected component.';
+export function normalizeDeploymentDiagnostics(output) {
+    const records = extractFailureRecords(output);
+    const sourceRecords = records.length > 0
+        ? records
+        : [
+            {
+                component: UNKNOWN_COMPONENT,
+                problem: output.trim() || 'Salesforce deployment failed without a detailed error message.',
+                rawDetails: output,
+            },
+        ];
+    return sourceRecords.map((record) => classifyFailure(record));
+}
+export function formatDeploymentDiagnostics(diagnostics) {
+    if (diagnostics.length === 0) {
+        return '';
+    }
+    return diagnostics
+        .map((item, index) => [
+        `Diagnostic ${index + 1}: ${item.component}`,
+        `Problem: ${item.problem}`,
+        `Probable cause: ${item.probableCause}`,
+        `Remediation: ${item.remediation}`,
+    ].join('\n'))
+        .join('\n\n');
+}
+function extractFailureRecords(output) {
+    const parsed = parseJsonObject(output);
+    if (parsed === undefined) {
+        return extractTextFailureRecords(output);
+    }
+    const failures = [
+        ...asArray(readPath(parsed, ['result', 'details', 'componentFailures'])),
+        ...asArray(readPath(parsed, ['result', 'details', 'runTestResult', 'failures'])),
+        ...asArray(readPath(parsed, ['result', 'componentFailures'])),
+    ];
+    return failures
+        .map((failure) => buildFailureRecord(failure))
+        .filter((record) => record !== undefined);
+}
+function parseJsonObject(output) {
+    const jsonMatch = output.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(jsonMatch[0]);
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readPath(value, path) {
+    return path.reduce((current, key) => (isRecord(current) ? current[key] : undefined), value);
+}
+function asArray(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    return value === undefined || value === null ? [] : [value];
+}
+function buildFailureRecord(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const failure = value;
+    const problem = stringValue(failure.problem);
+    if (problem === undefined) {
+        return undefined;
+    }
+    const componentParts = [
+        stringValue(failure.componentType),
+        stringValue(failure.fullName),
+        stringValue(failure.fileName),
+    ].filter((part) => part !== undefined && part.length > 0);
+    const location = [numberValue(failure.lineNumber), numberValue(failure.columnNumber)]
+        .filter((part) => part !== undefined)
+        .join(':');
+    return {
+        component: componentParts.length > 0 ? componentParts.join(':') : UNKNOWN_COMPONENT,
+        problem,
+        rawDetails: JSON.stringify({ ...value, location: location || undefined }),
+    };
+}
+function extractTextFailureRecords(output) {
+    const trimmed = output.trim();
+    if (trimmed.length === 0) {
+        return [];
+    }
+    return trimmed
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .map((line) => ({
+        component: inferComponentFromText(line),
+        problem: line,
+        rawDetails: line,
+    }));
+}
+function classifyFailure(record) {
+    const normalized = record.problem.toLowerCase();
+    if (matchesMissingField(normalized)) {
+        return diagnostic(record, 'missing-field', {
+            probableCause: 'A referenced field is not present in the target org or is deployed in a later wave.',
+            remediation: 'Deploy the missing CustomField before this component, add it to the same or earlier wave, or remove the stale field reference.',
+        });
+    }
+    if (matchesMissingObject(normalized)) {
+        return diagnostic(record, 'missing-object', {
+            probableCause: 'A referenced object is not present in the target org or the object metadata is missing from the package.',
+            remediation: 'Deploy the CustomObject before dependent metadata, include the object in the manifest, or correct the object API name.',
+        });
+    }
+    if (matchesDuplicateMetadata(normalized)) {
+        return diagnostic(record, 'duplicate-metadata', {
+            probableCause: 'The package contains duplicate metadata members or a component conflicts with metadata already owned elsewhere.',
+            remediation: 'Remove duplicate package entries, consolidate the metadata source, then rerun validation with one authoritative component path.',
+        });
+    }
+    if (matchesPermission(normalized)) {
+        return diagnostic(record, 'permission', {
+            probableCause: 'The deployment user lacks metadata, object, field, Apex, or setup permissions required for this change.',
+            remediation: 'Grant the deployment user the required permission set or org permission, then validate again with the same target org.',
+        });
+    }
+    if (matchesSourceTrackingConflict(normalized)) {
+        return diagnostic(record, 'source-tracking-conflict', {
+            probableCause: 'Local source tracking is out of sync with the target org or conflicts with remote changes.',
+            remediation: 'Pull or reset source tracking for the org, reconcile conflicts, then rerun the deployment validation.',
+        });
+    }
+    if (matchesInvalidReference(normalized)) {
+        return diagnostic(record, 'invalid-reference', {
+            probableCause: 'The metadata references a component, value, label, class, flow, layout, or relationship that cannot be resolved.',
+            remediation: 'Deploy the referenced component first, correct the API name, or remove the stale reference from this metadata.',
+        });
+    }
+    return diagnostic(record, 'unknown', {
+        probableCause: 'Salesforce returned an error that does not match a known smart-deployment diagnostic pattern.',
+        remediation: UNKNOWN_NEXT_STEP,
+    });
+}
+function diagnostic(record, category, details) {
+    return {
+        component: record.component ?? UNKNOWN_COMPONENT,
+        problem: record.problem,
+        rawDetails: record.rawDetails,
+        category,
+        ...details,
+    };
+}
+function matchesMissingField(problem) {
+    return (/no such column|invalid field|field .* does not exist|unknown field|could not resolve standard field/i.test(problem) || /in field: field - no customfield named/i.test(problem));
+}
+function matchesMissingObject(problem) {
+    return (/entity is not org-accessible|invalid type|sobject type .* is not supported|no customobject named/i.test(problem) ||
+        /reference to undefined object|object .* does not exist/i.test(problem));
+}
+function matchesDuplicateMetadata(problem) {
+    return /duplicate value|duplicate name|duplicate full name|already exists|more than one/i.test(problem);
+}
+function matchesPermission(problem) {
+    return /insufficient access|insufficient privileges|not authorized|required permission|permission denied|invalid cross reference id/i.test(problem);
+}
+function matchesInvalidReference(problem) {
+    return /invalid reference|invalid relationship|invalid definition|not found|does not exist|unknown user permission|invalid value/i.test(problem);
+}
+function matchesSourceTrackingConflict(problem) {
+    return /source tracking|conflict|sync.*source|source.*out of sync|tracking.*reset/i.test(problem);
+}
+function inferComponentFromText(line) {
+    const match = line.match(/(?:component|file|entity|object|field)\s+['"]?([A-Za-z0-9_.:-]+)['"]?/i);
+    return match?.[1] ?? UNKNOWN_COMPONENT;
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function numberValue(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=deployment-error-diagnostics.js.map

package/lib/deployment/deployment-error-diagnostics.js.map

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

package/lib/deployment/deployment-runner.d.ts

@@ -18,6 +18,7 @@ export type DeploymentRunnerParams = {
     componentMap: ReadonlyMap<NodeId, MetadataComponent>;
     apiVersion?: string;
     skipTests: boolean;
+    destructive: boolean;
     testExecutor: TestExecutor;
     tracker: DeploymentTracker;
     stateManager: StateManager;