@salesforce/source-deploy-retrieve 13.7.0 → 13.7.1-compute.1

package/lib/src/client/transports/transportPipeline.d.ts

@@ -0,0 +1,51 @@
+import { TransportName } from '../../registry/types';
+import { SourceComponent } from '../../resolve/sourceComponent';
+import { FileResponse } from '../types';
+import { AsyncTransportHandle, TransportContext, TransportOperationResult, TransportProvider } from './types';
+export type TransportGroup = {
+    transport: TransportProvider;
+    components: SourceComponent[];
+};
+export type GroupedComponents = {
+    metadataApi: SourceComponent[];
+    transports: TransportGroup[];
+};
+export type TransportPlan = {
+    phases: TransportPlanPhase[];
+};
+export type TransportPlanPhase = {
+    phase: 'before-metadata' | 'metadata-api' | 'after-metadata';
+    label: string;
+    endpoint: string;
+    components: Array<{
+        fullName: string;
+        type: string;
+    }>;
+};
+export type TransportPipelineResult = {
+    fileResponses: FileResponse[];
+    asyncHandles: AsyncTransportHandle[];
+    operationResults: TransportOperationResult[];
+};
+export type TransportStageEvent = {
+    transportName: TransportName;
+    label: string;
+    operation: 'deploy' | 'retrieve';
+    stage: 'start' | 'complete' | 'error';
+    componentCount: number;
+    componentNames: string[];
+    errorMessage?: string;
+};
+export declare class TransportPipeline {
+    private readonly transports;
+    private readonly logger;
+    constructor(transports?: TransportProvider[]);
+    static withBuiltinTransports(): TransportPipeline;
+    groupByTransport(components: SourceComponent[]): GroupedComponents;
+    explain(components: SourceComponent[], operation?: 'deploy' | 'retrieve'): TransportPlan;
+    runBeforeMetadata(context: TransportContext, groups: TransportGroup[], operation?: 'deploy' | 'retrieve'): Promise<TransportPipelineResult>;
+    runAfterMetadata(context: TransportContext, groups: TransportGroup[], operation?: 'deploy' | 'retrieve'): Promise<TransportPipelineResult>;
+    hasTransports(components: SourceComponent[]): boolean;
+    private findTransportFor;
+    private runTransportGroups;
+}

package/lib/src/client/transports/transportPipeline.js

@@ -0,0 +1,180 @@
+"use strict";
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportPipeline = void 0;
+const core_1 = require("@salesforce/core");
+const herokuComputeTransport_1 = require("./herokuComputeTransport");
+class TransportPipeline {
+    transports = [];
+    logger;
+    constructor(transports) {
+        this.logger = core_1.Logger.childFromRoot('TransportPipeline');
+        if (transports) {
+            this.transports.push(...transports);
+        }
+    }
+    static withBuiltinTransports() {
+        return new TransportPipeline([new herokuComputeTransport_1.HerokuComputeTransport()]);
+    }
+    groupByTransport(components) {
+        const metadataApi = [];
+        const transportMap = new Map();
+        for (const component of components) {
+            const transport = this.findTransportFor(component);
+            if (transport) {
+                let group = transportMap.get(transport.name);
+                if (!group) {
+                    group = { transport, components: [] };
+                    transportMap.set(transport.name, group);
+                }
+                group.components.push(component);
+            }
+            // all components go through metadata api — transport components
+            // also have metadata portions (.compute-meta.xml) that need MDAPI
+            metadataApi.push(component);
+        }
+        return {
+            metadataApi,
+            transports: [...transportMap.values()],
+        };
+    }
+    explain(components, operation = 'deploy') {
+        const { metadataApi, transports } = this.groupByTransport(components);
+        const phases = [];
+        const beforeMetadata = transports.filter((group) => getStep(group.transport, operation, 'before') !== undefined);
+        const afterMetadata = transports.filter((group) => getStep(group.transport, operation, 'after') !== undefined);
+        for (const group of beforeMetadata) {
+            const desc = group.transport.describe();
+            phases.push({
+                phase: 'before-metadata',
+                label: desc.label,
+                endpoint: desc.endpoint,
+                components: group.components.map((c) => ({ fullName: c.fullName, type: c.type.name })),
+            });
+        }
+        phases.push({
+            phase: 'metadata-api',
+            label: 'Metadata API',
+            endpoint: 'SOAP/REST',
+            components: metadataApi.map((c) => ({ fullName: c.fullName, type: c.type.name })),
+        });
+        for (const group of afterMetadata) {
+            const desc = group.transport.describe();
+            phases.push({
+                phase: 'after-metadata',
+                label: desc.label,
+                endpoint: desc.endpoint,
+                components: group.components.map((c) => ({ fullName: c.fullName, type: c.type.name })),
+            });
+        }
+        return { phases };
+    }
+    async runBeforeMetadata(context, groups, operation = 'deploy') {
+        return this.runTransportGroups(groups, context, operation, 'before');
+    }
+    async runAfterMetadata(context, groups, operation = 'deploy') {
+        return this.runTransportGroups(groups, context, operation, 'after');
+    }
+    hasTransports(components) {
+        return components.some((component) => this.findTransportFor(component) !== undefined);
+    }
+    findTransportFor(component) {
+        const transportName = component.type.strategies?.transport;
+        if (!transportName)
+            return undefined;
+        const transport = this.transports.find((candidate) => candidate.name === transportName);
+        if (!transport) {
+            throw new core_1.SfError(`No transport provider is registered for '${transportName}' required by ${component.type.name}.`, 'MissingTransportProvider');
+        }
+        return transport;
+    }
+    async runTransportGroups(groups, context, operation, timing) {
+        const allFileResponses = [];
+        const allAsyncHandles = [];
+        const allOperationResults = [];
+        const lifecycle = core_1.Lifecycle.getInstance();
+        for (const group of groups) {
+            const step = getStep(group.transport, operation, timing);
+            if (!step)
+                continue;
+            this.logger.debug(`Running transport '${group.transport.name}' (${operation}) for ${group.components.length} component(s)`);
+            const desc = group.transport.describe();
+            const componentNames = group.components.map((c) => c.fullName);
+            const eventBase = {
+                transportName: group.transport.name,
+                label: desc.label,
+                operation,
+                componentCount: group.components.length,
+                componentNames,
+            };
+            // eslint-disable-next-line no-await-in-loop
+            await lifecycle.emit('transportStage', { ...eventBase, stage: 'start' });
+            const transportContext = {
+                ...context,
+                components: group.components,
+            };
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                const result = await step(transportContext);
+                allFileResponses.push(...result.fileResponses);
+                if (result.asyncResult) {
+                    allAsyncHandles.push(result.asyncResult);
+                }
+                allOperationResults.push(...(result.operationResults ?? []));
+                // eslint-disable-next-line no-await-in-loop
+                await lifecycle.emit('transportStage', { ...eventBase, stage: 'complete' });
+            }
+            catch (err) {
+                try {
+                    // eslint-disable-next-line no-await-in-loop
+                    await lifecycle.emit('transportStage', {
+                        ...eventBase,
+                        stage: 'error',
+                        errorMessage: err.message,
+                    });
+                }
+                catch {
+                    /* don't mask the transport error */
+                }
+                throw err;
+            }
+        }
+        return { fileResponses: allFileResponses, asyncHandles: allAsyncHandles, operationResults: allOperationResults };
+    }
+}
+exports.TransportPipeline = TransportPipeline;
+function getStep(transport, operation, timing) {
+    if (operation === 'deploy' && timing === 'before') {
+        return transport.beforeDeploy
+            ? async (context) => transport.beforeDeploy(context)
+            : undefined;
+    }
+    if (operation === 'deploy') {
+        return transport.afterDeploy
+            ? async (context) => transport.afterDeploy(context)
+            : undefined;
+    }
+    if (timing === 'before') {
+        return transport.beforeRetrieve
+            ? async (context) => transport.beforeRetrieve(context)
+            : undefined;
+    }
+    return transport.afterRetrieve
+        ? async (context) => transport.afterRetrieve(context)
+        : undefined;
+}
+//# sourceMappingURL=transportPipeline.js.map

package/lib/src/client/transports/transportPipeline.js.map

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

package/lib/src/client/transports/types.d.ts

@@ -0,0 +1,45 @@
+import { Connection, SfProject } from '@salesforce/core';
+import { TransportName } from '../../registry/types';
+import { SourceComponent } from '../../resolve/sourceComponent';
+import { FileResponse, PackageOptions } from '../types';
+export type TransportStatus = 'Pending' | 'InProgress' | 'Succeeded' | 'Failed' | 'Unknown';
+export type TransportDescription = {
+    label: string;
+    endpoint: string;
+};
+export type TransportContext = {
+    components: SourceComponent[];
+    connection: Connection;
+    project: SfProject;
+    orgId: string;
+    output?: string;
+    packageOptions?: PackageOptions;
+    /** Package name for each manifest-only transport member (`type#fullName`). */
+    transportPackageNames?: Record<string, string>;
+};
+export type TransportResult = {
+    fileResponses: FileResponse[];
+    asyncResult?: AsyncTransportHandle;
+    operationResults?: TransportOperationResult[];
+};
+export type TransportOperationResult = {
+    transportLabel: string;
+    operation: string;
+    status: TransportStatus;
+    message?: string;
+};
+export type AsyncTransportHandle = {
+    transportName: TransportName;
+    status: TransportStatus;
+    message?: string;
+    checkStatus(): Promise<AsyncTransportHandle>;
+};
+export type TransportProvider = {
+    readonly name: TransportName;
+    describe(): TransportDescription;
+    handles(component: SourceComponent): boolean;
+    beforeDeploy?(context: TransportContext): Promise<TransportResult>;
+    afterDeploy?(context: TransportContext): Promise<TransportResult>;
+    beforeRetrieve?(context: TransportContext): Promise<TransportResult>;
+    afterRetrieve?(context: TransportContext): Promise<TransportResult>;
+};

package/lib/src/client/transports/types.js

@@ -0,0 +1,18 @@
+"use strict";
+/*
+ * Copyright 2026, Salesforce, Inc.
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/src/client/transports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/client/transports/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/src/client/types.d.ts

@@ -352,5 +352,13 @@ export type BotVersionFilter = {
 export type MetadataApiRetrieveOptions = MetadataTransferOptions & RetrieveOptions & {
     registry?: RegistryAccess;
     botVersionFilters?: BotVersionFilter[];
+    /**
+     * Metadata type names whose transports should be skipped (e.g., `['PlatformComputeApp']`).
+     * Components of these types will still be retrieved via the Metadata API but their
+     * secondary transport (Connect API, presigned URL, etc.) will not run.
+     */
+    skipTransports?: string[];
+    /** Explicit package association for manifest-only transport members, keyed by `type#fullName`. */
+    transportPackageNames?: Record<string, string>;
 };
 export {};

package/lib/src/collections/componentSet.d.ts

@@ -1,6 +1,7 @@
 import { MetadataApiDeploy, MetadataApiDeployOptions } from '../client/metadataApiDeploy';
 import { MetadataApiRetrieve } from '../client/metadataApiRetrieve';
 import type { MetadataApiRetrieveOptions } from '../client/types';
+import { TransportPipeline } from '../client/transports/transportPipeline';
 import { SourceComponent } from '../resolve/sourceComponent';
 import { ComponentLike, MetadataComponent, MetadataMember } from '../resolve/types';
 import { RegistryAccess } from '../registry/registryAccess';
@@ -42,6 +43,8 @@ export declare class ComponentSet extends LazyCollection<MetadataComponent> {
         botName: string;
         versionFilter: 'all' | 'highest' | number;
     }>;
+    private manualTransportPipeline?;
+    private hasManualPipeline;
     private logger;
     private readonly registry;
     private components;
@@ -60,6 +63,8 @@ export declare class ComponentSet extends LazyCollection<MetadataComponent> {
     get size(): number;
     get destructiveChangesPre(): DecodeableMap<string, DecodeableMap<string, SourceComponent>>;
     get destructiveChangesPost(): DecodeableMap<string, DecodeableMap<string, SourceComponent>>;
+    get transportPipeline(): TransportPipeline | undefined;
+    set transportPipeline(pipeline: TransportPipeline | undefined);
     /**
      * Resolve metadata components from a file or directory path in a file system.
      *
@@ -206,6 +211,10 @@ export declare class ComponentSet extends LazyCollection<MetadataComponent> {
      * @return DestructiveChangesType[]
      */
     getTypesOfDestructiveChanges(): DestructiveChangesType[];
+    private deployWithPipeline;
+    private retrieveWithPipeline;
+    private getManifestSourceComponents;
+    private hasTransportEligibleTypes;
     /**
      * Returns an API version to use as the value of the `version` field
      * in a manifest (package.xml) for MDAPI calls in the following order

package/lib/src/collections/componentSet.js

@@ -23,6 +23,8 @@ const ts_types_1 = require("@salesforce/ts-types");
 const decomposed_1 = require("../utils/decomposed");
 const metadataApiDeploy_1 = require("../client/metadataApiDeploy");
 const metadataApiRetrieve_1 = require("../client/metadataApiRetrieve");
+const transportPipeline_1 = require("../client/transports/transportPipeline");
+const transportCoordinator_1 = require("../client/transports/transportCoordinator");
 const constants_1 = require("../common/constants");
 const sourceComponent_1 = require("../resolve/sourceComponent");
 const metadataResolver_1 = require("../resolve/metadataResolver");
@@ -66,6 +68,8 @@ class ComponentSet extends lazyCollection_1.LazyCollection {
     fullName;
     forceIgnoredPaths;
     botVersionFilters;
+    manualTransportPipeline;
+    hasManualPipeline = false;
     logger;
     registry;
     // all components stored here, regardless of what manifest they belong to
@@ -112,6 +116,15 @@ class ComponentSet extends lazyCollection_1.LazyCollection {
     get destructiveChangesPost() {
         return this.destructiveComponents[types_1.DestructiveChangesType.POST];
     }
+    get transportPipeline() {
+        if (this.hasManualPipeline)
+            return this.manualTransportPipeline;
+        return this.hasTransportEligibleTypes() ? transportPipeline_1.TransportPipeline.withBuiltinTransports() : undefined;
+    }
+    set transportPipeline(pipeline) {
+        this.manualTransportPipeline = pipeline;
+        this.hasManualPipeline = true;
+    }
     static fromSource(input) {
         const parseFromSourceInputs = (given) => {
             if (Array.isArray(given)) {
@@ -268,6 +281,10 @@ class ComponentSet extends lazyCollection_1.LazyCollection {
             options.usernameOrConnection.setApiVersion(this.apiVersion);
             this.logger.debug(`Received conflicting apiVersion values for deploy. Using option=${this.apiVersion}, Ignoring apiVersion on connection=${options.usernameOrConnection.version}.`);
         }
+        const pipeline = options.apiOptions?.checkOnly ? undefined : this.transportPipeline;
+        if (pipeline?.hasTransports(toDeploy)) {
+            return this.deployWithPipeline(options, toDeploy, pipeline);
+        }
         const operationOptions = Object.assign({}, options, {
             components: this,
             registry: this.registry,
@@ -298,6 +315,21 @@ class ComponentSet extends lazyCollection_1.LazyCollection {
             options.usernameOrConnection.setApiVersion(this.apiVersion);
             this.logger.debug(`Received conflicting apiVersion values for retrieve. Using option=${this.apiVersion}, Ignoring apiVersion on connection=${options.usernameOrConnection.version}.`);
         }
+        if (options.format !== 'metadata') {
+            const sourceComponents = this.getSourceComponents().toArray();
+            const sourceMembers = new Set(sourceComponents.map((component) => `${component.type.name}#${component.fullName}`));
+            const selected = this.getManifestSourceComponents().filter((component) => !sourceMembers.has(`${component.type.name}#${component.fullName}`));
+            const skipped = new Set(options.skipTransports);
+            const transportComponents = [...selected, ...sourceComponents].filter((component) => !skipped.has(component.type.name));
+            if (transportComponents.length > 0) {
+                const pipeline = transportComponents.some((component) => component.type.strategies?.transport)
+                    ? this.transportPipeline
+                    : undefined;
+                if (pipeline?.hasTransports(transportComponents)) {
+                    return this.retrieveWithPipeline(operationOptions, transportComponents, pipeline);
+                }
+            }
+        }
         const mdapiRetrieve = new metadataApiRetrieve_1.MetadataApiRetrieve(operationOptions);
         await mdapiRetrieve.start();
         return mdapiRetrieve;
@@ -569,6 +601,102 @@ class ComponentSet extends lazyCollection_1.LazyCollection {
         }
         return destructiveChangesTypes;
     }
+    async deployWithPipeline(options, components, pipeline) {
+        const { transports } = pipeline.groupByTransport(components);
+        const connection = typeof options.usernameOrConnection === 'string'
+            ? await core_1.Connection.create({ authInfo: await core_1.AuthInfo.create({ username: options.usernameOrConnection }) })
+            : options.usernameOrConnection;
+        if (typeof options.usernameOrConnection === 'string' && this.apiVersion && this.apiVersion !== connection.version) {
+            connection.setApiVersion(this.apiVersion);
+        }
+        const transportContext = {
+            components,
+            connection,
+            project: await core_1.SfProject.resolve(this.projectDirectory),
+            orgId: connection.getAuthInfoFields().orgId ?? '',
+        };
+        const coordinator = new transportCoordinator_1.TransportCoordinator(pipeline, transports, transportContext, 'deploy');
+        await coordinator.runBeforeMetadata();
+        const operationOptions = Object.assign({}, options, {
+            components: this,
+            registry: this.registry,
+            apiVersion: this.apiVersion,
+        });
+        const mdapiDeploy = new metadataApiDeploy_1.MetadataApiDeploy(operationOptions);
+        mdapiDeploy.addResultProcessor((result, status) => coordinator.processResult(result, status.status));
+        await mdapiDeploy.start();
+        return mdapiDeploy;
+    }
+    async retrieveWithPipeline(operationOptions, components, pipeline) {
+        const { transports } = pipeline.groupByTransport(components);
+        const connection = typeof operationOptions.usernameOrConnection === 'string'
+            ? await core_1.Connection.create({
+                authInfo: await core_1.AuthInfo.create({ username: operationOptions.usernameOrConnection }),
+            })
+            : operationOptions.usernameOrConnection;
+        if (typeof operationOptions.usernameOrConnection === 'string' &&
+            this.apiVersion &&
+            this.apiVersion !== connection.version) {
+            connection.setApiVersion(this.apiVersion);
+        }
+        const transportContext = {
+            components,
+            connection,
+            project: await core_1.SfProject.resolve(this.projectDirectory),
+            orgId: connection.getAuthInfoFields().orgId ?? '',
+            output: operationOptions.output,
+            packageOptions: operationOptions.packageOptions,
+            transportPackageNames: operationOptions.transportPackageNames,
+        };
+        const coordinator = new transportCoordinator_1.TransportCoordinator(pipeline, transports, transportContext, 'retrieve');
+        await coordinator.runBeforeMetadata();
+        const mdapiRetrieve = new metadataApiRetrieve_1.MetadataApiRetrieve(operationOptions);
+        mdapiRetrieve.addResultProcessor((result, status) => coordinator.processResult(result, status.status));
+        await mdapiRetrieve.start();
+        return mdapiRetrieve;
+    }
+    getManifestSourceComponents() {
+        const seen = new Set();
+        const results = [];
+        for (const component of this) {
+            if (!(component instanceof sourceComponent_1.SourceComponent) && component.type.strategies?.transport) {
+                const key = `${component.type.name}#${component.fullName}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    results.push(new sourceComponent_1.SourceComponent({ type: component.type, name: component.fullName }));
+                }
+            }
+        }
+        for (const [, members] of this.manifestComponents) {
+            for (const [, comp] of members) {
+                const key = `${comp.type.name}#${comp.fullName}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    results.push(comp);
+                }
+            }
+        }
+        return results;
+    }
+    hasTransportEligibleTypes() {
+        for (const comp of this.getSourceComponents()) {
+            if (comp.type.strategies?.transport)
+                return true;
+        }
+        for (const component of this) {
+            if (component.type.strategies?.transport)
+                return true;
+        }
+        // Also check manifestComponents for components without local source
+        // (e.g., -m retrieves where the component doesn't exist on disk yet)
+        for (const [, members] of this.manifestComponents) {
+            for (const [, comp] of members) {
+                if (comp.type.strategies?.transport)
+                    return true;
+            }
+        }
+        return false;
+    }
     /**
      * Returns an API version to use as the value of the `version` field
      * in a manifest (package.xml) for MDAPI calls in the following order
@@ -612,7 +740,8 @@ class ComponentSet extends lazyCollection_1.LazyCollection {
                 this.logger.warn(messages.getMessage('missingApiVersion'));
             }
         }
-        return version;
+        const hasPlatformComputeApp = Array.from(this).some((component) => component.type.name === 'PlatformComputeApp');
+        return hasPlatformComputeApp && +version < 68 ? '68.0' : version;
     }
 }
 exports.ComponentSet = ComponentSet;