@salesforce/b2c-tooling-sdk 1.24.2 → 2.0.0

package/dist/esm/operations/mrt/deployment.js

@@ -1,5 +1,9 @@
 import { createMrtClient, DEFAULT_MRT_ORIGIN } from '../../clients/mrt.js';
+import { SCOPE_MODE_HEADER } from '../../clients/middleware.js';
+import { createScapiRequestError } from '../../clients/scapi-backend-utils.js';
+import { createStorefrontDeploymentsClient, toOrganizationId, } from '../../clients/storefront-deployments.js';
 import { getLogger } from '../../logging/logger.js';
+import { runMrtWithFallback, } from './mrt-backend.js';
 /**
  * Lists deployment history for an MRT environment.
  *
@@ -112,4 +116,239 @@ export async function createDeployment(options, auth) {
         warnings,
     };
 }
+// ---------------------------------------------------------------------------
+// Backend-neutral deployment view + SCAPI MRT operations
+// ---------------------------------------------------------------------------
+const READ_HEADERS = { [SCOPE_MODE_HEADER]: 'read' };
+const WRITE_HEADERS = { [SCOPE_MODE_HEADER]: 'write' };
+/**
+ * Thrown when a backend-aware operation resolves to the legacy backend but no
+ * legacy auth was supplied. `legacyAuth` is optional so SCAPI-only callers
+ * aren't forced to configure a `~/.mobify` API key; this guards the case where
+ * legacy is actually needed (explicit `legacy`, or `auto` falling back).
+ */
+const LEGACY_AUTH_REQUIRED_MESSAGE = 'Legacy MRT credentials are required for this backend but none were provided. ' +
+    'Provide an API key (--api-key / MRT_API_KEY / ~/.mobify) or use the SCAPI MRT backend.';
+/** SCAPI deployment statuses that end the poll loop. */
+const SCAPI_TERMINAL_STATUSES = new Set(['finished', 'failed']);
+/** Normalizes a legacy MRT deployment list item into an {@link MrtDeploymentView}. */
+export function normalizeLegacyDeployment(deploy) {
+    return {
+        bundleId: deploy.bundle?.id ?? undefined,
+        bundleMessage: deploy.bundle?.message ?? undefined,
+        status: deploy.status ?? undefined,
+        deploymentType: deploy.deploy_type ?? undefined,
+        creationDate: deploy.created_at ?? undefined,
+        createdBy: deploy.user ?? undefined,
+        backend: 'legacy',
+    };
+}
+/** Normalizes a SCAPI MRT {@link DeploymentScapi} into an {@link MrtDeploymentView}. */
+export function normalizeDeploymentScapi(deployment) {
+    return {
+        deploymentId: deployment.deploymentId ?? undefined,
+        bundleId: deployment.bundle?.bundleId ?? undefined,
+        bundleMessage: deployment.bundle?.description ?? undefined,
+        status: deployment.status ?? undefined,
+        deploymentType: deployment.deploymentType ?? undefined,
+        creationDate: deployment.creationDate ?? undefined,
+        createdBy: deployment.createdBy ?? undefined,
+        backend: 'scapi',
+    };
+}
+function buildScapiDeploymentsClient(conn) {
+    return createStorefrontDeploymentsClient({ shortCode: conn.shortCode, tenantId: conn.tenantId }, conn.auth);
+}
+/**
+ * Lists deployments for an environment via the SCAPI MRT Deployments API.
+ *
+ * Forwards the standard SCAPI `limit`/`offset` pagination query parameters when
+ * provided (max 200 per page, default 25 server-side; the response echoes the
+ * full `total`), mirroring the legacy list and the other SCAPI collection
+ * clients (`scapi-sites`, `scapi-catalogs`).
+ *
+ * @throws {ScapiRequestError} carrying the HTTP status on a non-2xx response.
+ */
+export async function listDeploymentsScapi(conn, params) {
+    const logger = getLogger();
+    const { storefrontId, environmentId, limit, offset } = params;
+    const organizationId = toOrganizationId(conn.tenantId);
+    logger.debug({ organizationId, storefrontId, environmentId, limit, offset }, '[MRT-SCAPI] Listing deployments');
+    const client = buildScapiDeploymentsClient(conn);
+    const { data, error, response } = await client.GET('/organizations/{organizationId}/storefronts/{storefrontId}/environments/{environmentId}/deployments', {
+        params: { path: { organizationId, storefrontId, environmentId }, query: { limit, offset } },
+        headers: READ_HEADERS,
+    });
+    if (error || !data) {
+        throw createScapiRequestError(error, response, 'Failed to list deployments');
+    }
+    return {
+        deployments: (data.data ?? []).map(normalizeDeploymentScapi),
+        count: data.total ?? data.data?.length ?? 0,
+        raw: data,
+    };
+}
+/**
+ * Creates (queues) a deployment via the SCAPI MRT Deployments API.
+ *
+ * @throws {ScapiRequestError} carrying the HTTP status on a non-2xx response
+ *   (including 409 Conflict — the caller decides whether that is fatal).
+ */
+export async function createDeploymentScapi(conn, params) {
+    const logger = getLogger();
+    const { storefrontId, environmentId, bundleId } = params;
+    const organizationId = toOrganizationId(conn.tenantId);
+    logger.debug({ organizationId, storefrontId, environmentId, bundleId }, '[MRT-SCAPI] Creating deployment');
+    const client = buildScapiDeploymentsClient(conn);
+    const { data, error, response } = await client.POST('/organizations/{organizationId}/storefronts/{storefrontId}/environments/{environmentId}/deployments', {
+        params: { path: { organizationId, storefrontId, environmentId } },
+        headers: WRITE_HEADERS,
+        body: { bundleId },
+    });
+    if (error || !data) {
+        throw createScapiRequestError(error, response, `Failed to deploy bundle ${bundleId}`);
+    }
+    return { deploymentId: data.deploymentId, status: data.status, bundleId, raw: data };
+}
+/**
+ * Fetches a single deployment by ID via the SCAPI MRT Deployments API.
+ *
+ * @throws {ScapiRequestError} carrying the HTTP status on a non-2xx response.
+ */
+export async function getDeploymentScapi(conn, params) {
+    const { storefrontId, environmentId, deploymentId } = params;
+    const organizationId = toOrganizationId(conn.tenantId);
+    const client = buildScapiDeploymentsClient(conn);
+    const { data, error, response } = await client.GET('/organizations/{organizationId}/storefronts/{storefrontId}/environments/{environmentId}/deployments/{deploymentId}', {
+        params: { path: { organizationId, storefrontId, environmentId, deploymentId } },
+        headers: READ_HEADERS,
+    });
+    if (error || !data) {
+        throw createScapiRequestError(error, response, `Failed to get deployment ${deploymentId}`);
+    }
+    return data;
+}
+async function defaultSleep(ms) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Polls a SCAPI deployment by ID until it reaches a terminal status
+ * (`finished` or `failed`) or the timeout elapses.
+ *
+ * Uses `getDeploymentById`, which shares the `sfcc.storefront.deployments` read
+ * scope with the list — a direct by-ID poll costs no extra scope over
+ * list-polling and avoids page-scanning ambiguity.
+ *
+ * @throws Error if the timeout is reached or the deployment fails.
+ */
+export async function waitForDeploymentScapi(conn, options) {
+    const logger = getLogger();
+    const { storefrontId, environmentId, deploymentId, pollIntervalSeconds = 30, timeoutSeconds = 600, onPoll } = options;
+    const sleepFn = options.sleep ?? defaultSleep;
+    const nowFn = options.now ?? Date.now;
+    const startTime = nowFn();
+    const pollIntervalMs = pollIntervalSeconds * 1000;
+    const timeoutMs = timeoutSeconds * 1000;
+    logger.debug({ deploymentId, pollIntervalSeconds, timeoutSeconds }, '[MRT-SCAPI] Waiting for deployment');
+    // Poll immediately (before any sleep) so an already-finished deployment
+    // returns without waiting a full interval, and so a timeout shorter than the
+    // poll interval still gets at least one status check.
+    while (true) {
+        const elapsedSeconds = Math.round((nowFn() - startTime) / 1000);
+        if (timeoutSeconds > 0 && nowFn() - startTime > timeoutMs) {
+            throw new Error(`Timeout waiting for deployment "${deploymentId}" after ${timeoutSeconds}s`);
+        }
+        const deployment = await getDeploymentScapi(conn, { storefrontId, environmentId, deploymentId });
+        const status = deployment.status ?? 'unknown';
+        logger.trace({ deploymentId, elapsedSeconds, status }, '[MRT-SCAPI] Deployment poll');
+        onPoll?.({
+            elapsedSeconds,
+            status,
+            description: deployment.progress?.description ?? undefined,
+            percentage: deployment.progress?.percentage ?? undefined,
+        });
+        if (deployment.status && SCAPI_TERMINAL_STATUSES.has(deployment.status)) {
+            if (deployment.status === 'failed') {
+                const detail = deployment.statusMessage ? `: ${deployment.statusMessage}` : '';
+                throw new Error(`Deployment ${deploymentId} failed${detail}`);
+            }
+            logger.debug({ deploymentId, status: deployment.status }, '[MRT-SCAPI] Deployment reached terminal status');
+            return deployment;
+        }
+        await sleepFn(pollIntervalMs);
+    }
+}
+/**
+ * Lists deployment history, routing to the SCAPI or legacy backend per the
+ * given preference (with safe `auto` fallback). Returns normalized rows.
+ */
+export async function listMrtDeployments(options) {
+    const { preference, scapiConnection, legacyAuth, projectSlug, targetSlug, limit, offset, origin, onFallback, onResolve, } = options;
+    const run = await runMrtWithFallback({
+        preference,
+        hasScapiConfig: Boolean(scapiConnection),
+        canFallbackToLegacy: Boolean(legacyAuth),
+        onFallback,
+        onResolve,
+    }, {
+        scapi: () => listDeploymentsScapi(scapiConnection, {
+            storefrontId: projectSlug,
+            environmentId: targetSlug,
+            limit,
+            offset,
+        }),
+        legacy: async () => {
+            if (!legacyAuth) {
+                throw new Error(LEGACY_AUTH_REQUIRED_MESSAGE);
+            }
+            const result = await listDeployments({ projectSlug, targetSlug, limit, offset, origin }, legacyAuth);
+            // The legacy list result already mirrors the raw MRT Cloud API shape
+            // (count/next/previous/deployments), so surface it verbatim under --json.
+            return { count: result.count, deployments: result.deployments.map(normalizeLegacyDeployment), raw: result };
+        },
+    });
+    return { backend: run.backend, count: run.value.count, deployments: run.value.deployments, raw: run.value.raw };
+}
+/**
+ * Deploys an existing bundle, routing to the SCAPI or legacy backend per the
+ * given preference (with safe `auto` fallback). The returned `backend` pins
+ * which `--wait` strategy the caller should use.
+ */
+export async function deployMrtBundle(options) {
+    const { preference, scapiConnection, legacyAuth, projectSlug, targetSlug, bundleId, origin, onFallback, onResolve } = options;
+    const run = await runMrtWithFallback({
+        preference,
+        hasScapiConfig: Boolean(scapiConnection),
+        canFallbackToLegacy: Boolean(legacyAuth),
+        onFallback,
+        onResolve,
+    }, {
+        scapi: async () => {
+            const result = await createDeploymentScapi(scapiConnection, {
+                storefrontId: projectSlug,
+                environmentId: targetSlug,
+                bundleId,
+            });
+            return {
+                backend: 'scapi',
+                bundleId,
+                deploymentId: result.deploymentId,
+                status: result.status ?? 'queued',
+                raw: result.raw,
+            };
+        },
+        legacy: async () => {
+            if (!legacyAuth) {
+                throw new Error(LEGACY_AUTH_REQUIRED_MESSAGE);
+            }
+            const result = await createDeployment({ projectSlug, targetSlug, bundleId, origin }, legacyAuth);
+            // `createDeployment` returns the synthesized legacy deploy result, which
+            // is the shape legacy `--json` emitted before the backend split.
+            return { backend: 'legacy', bundleId, status: result.status, warnings: result.warnings, raw: result };
+        },
+    });
+    return run.value;
+}
 //# sourceMappingURL=deployment.js.map

package/dist/esm/operations/mrt/deployment.js.map

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

package/dist/esm/operations/mrt/index.d.ts

@@ -39,16 +39,18 @@
  *
  * @module operations/mrt
  */
-export { createBundle, createGlobFilter, getDefaultMessage, DEFAULT_SSR_PARAMETERS, DEFAULT_SSR_ONLY, DEFAULT_SSR_SHARED, } from './bundle.js';
-export type { CreateBundleOptions, Bundle, MrtServerConfig } from './bundle.js';
-export { pushBundle, uploadBundle, listBundles, downloadBundle, deleteBundle, bulkDeleteBundles } from './push.js';
-export type { PushOptions, PushResult, ListBundlesOptions, ListBundlesResult, DownloadBundleOptions, DownloadBundleResult, DeleteBundleOptions, BulkDeleteBundlesOptions, BulkDeleteBundlesResult, BulkDeleteRejectedBundle, MrtBundle, } from './push.js';
+export { createBundle, createBundleV2, createGlobFilter, getDefaultMessage, DEFAULT_SSR_PARAMETERS, DEFAULT_SSR_ONLY, DEFAULT_SSR_SHARED, DEFAULT_V2_ROOT_DIR, DEFAULT_V2_CONFIG_PATH, DEFAULT_V2_MATCH_MODE, } from './bundle.js';
+export type { CreateBundleOptions, Bundle, MrtServerConfig, CreateBundleV2Options, BundleV2, BundleV2Config, BundleV2Metadata, BundleV2MatchMode, } from './bundle.js';
+export { pushBundle, uploadBundle, pushBundleV2, uploadBundleV2, listBundles, downloadBundle, deleteBundle, bulkDeleteBundles, } from './push.js';
+export type { PushOptions, PushResult, PushV2Options, PushV2Result, ListBundlesOptions, ListBundlesResult, DownloadBundleOptions, DownloadBundleResult, DeleteBundleOptions, BulkDeleteBundlesOptions, BulkDeleteBundlesResult, BulkDeleteRejectedBundle, MrtBundle, } from './push.js';
 export { listEnvVars, setEnvVar, setEnvVars, deleteEnvVar } from './env-var.js';
 export type { EnvVarOptions, SetEnvVarOptions, SetEnvVarsOptions, DeleteEnvVarOptions, ListEnvVarsResult, EnvironmentVariable, } from './env-var.js';
 export { cloneEnv, createEnv, deleteEnv, getEnv, waitForEnv, listEnvs, updateEnv } from './env.js';
 export type { CloneEnvOptions, CreateEnvOptions, DeleteEnvOptions, GetEnvOptions, WaitForEnvOptions, WaitForEnvPollInfo, ListEnvsOptions, ListEnvsResult, UpdateEnvOptions, MrtEnvironment, MrtEnvironmentState, MrtEnvironmentUpdate, PatchedMrtEnvironment, } from './env.js';
-export { listDeployments, createDeployment } from './deployment.js';
-export type { ListDeploymentsOptions, ListDeploymentsResult, CreateDeploymentOptions, CreateDeploymentResult, MrtDeployment, MrtDeploymentCreate, } from './deployment.js';
+export { listDeployments, createDeployment, listDeploymentsScapi, createDeploymentScapi, getDeploymentScapi, waitForDeploymentScapi, listMrtDeployments, deployMrtBundle, normalizeLegacyDeployment, normalizeDeploymentScapi, } from './deployment.js';
+export type { ListDeploymentsOptions, ListDeploymentsResult, CreateDeploymentOptions, CreateDeploymentResult, MrtDeployment, MrtDeploymentCreate, MrtDeploymentView, MrtDeploymentsView, MrtDeployResultView, CreateDeploymentScapiResult, DeploymentScapiPollInfo, WaitForDeploymentScapiOptions, ListMrtDeploymentsBackendOptions, DeployMrtBundleBackendOptions, } from './deployment.js';
+export { resolveMrtBackend, runMrtWithFallback, mrtScapiUnavailableMessage } from './mrt-backend.js';
+export type { MrtBackend, MrtBackendPreference, ScapiMrtConnection, MrtBackendBranches, MrtBackendRun, RunMrtWithFallbackOptions, } from './mrt-backend.js';
 export { listOrganizations } from './organization.js';
 export type { ListOrganizationsOptions, ListOrganizationsResult, MrtOrganization, OrganizationLimits, } from './organization.js';
 export { listCertificates, getCertificate, createCertificate, deleteCertificate, restartCertificateValidation, } from './certificate.js';

package/dist/esm/operations/mrt/index.js

@@ -45,15 +45,17 @@
  * @module operations/mrt
  */
 // Bundle creation
-export { createBundle, createGlobFilter, getDefaultMessage, DEFAULT_SSR_PARAMETERS, DEFAULT_SSR_ONLY, DEFAULT_SSR_SHARED, } from './bundle.js';
+export { createBundle, createBundleV2, createGlobFilter, getDefaultMessage, DEFAULT_SSR_PARAMETERS, DEFAULT_SSR_ONLY, DEFAULT_SSR_SHARED, DEFAULT_V2_ROOT_DIR, DEFAULT_V2_CONFIG_PATH, DEFAULT_V2_MATCH_MODE, } from './bundle.js';
 // Push and bundle operations
-export { pushBundle, uploadBundle, listBundles, downloadBundle, deleteBundle, bulkDeleteBundles } from './push.js';
+export { pushBundle, uploadBundle, pushBundleV2, uploadBundleV2, listBundles, downloadBundle, deleteBundle, bulkDeleteBundles, } from './push.js';
 // Environment variable operations
 export { listEnvVars, setEnvVar, setEnvVars, deleteEnvVar } from './env-var.js';
 // Environment (target) operations
 export { cloneEnv, createEnv, deleteEnv, getEnv, waitForEnv, listEnvs, updateEnv } from './env.js';
 // Deployment operations
-export { listDeployments, createDeployment } from './deployment.js';
+export { listDeployments, createDeployment, listDeploymentsScapi, createDeploymentScapi, getDeploymentScapi, waitForDeploymentScapi, listMrtDeployments, deployMrtBundle, normalizeLegacyDeployment, normalizeDeploymentScapi, } from './deployment.js';
+// MRT backend selection and fallback
+export { resolveMrtBackend, runMrtWithFallback, mrtScapiUnavailableMessage } from './mrt-backend.js';
 // Organization operations
 export { listOrganizations } from './organization.js';
 // Certificate operations (organization-scoped, used by env clone/create with custom domains)

package/dist/esm/operations/mrt/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/mrt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,6BAA6B;AAC7B,OAAO,EAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAejH,kCAAkC;AAClC,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AAU9E,kCAAkC;AAClC,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AAiBjG,wBAAwB;AACxB,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAUlE,0BAA0B;AAC1B,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAQpD,6FAA6F;AAC7F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAY1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,0BAA0B,CAAC;AAelC,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAcnG,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAaxG,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAa3B,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAevB,mCAAmC;AACnC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAU7B,mBAAmB;AACnB,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAG3C,kBAAkB;AAClB,OAAO,EAAC,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAC,MAAM,WAAW,CAAC;AAU/F,iCAAiC;AACjC,OAAO,EAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AAWvG,yBAAyB;AACzB,OAAO,EAAC,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/mrt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAYrB,6BAA6B;AAC7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAiBnB,kCAAkC;AAClC,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AAU9E,kCAAkC;AAClC,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AAiBjG,wBAAwB;AACxB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAkBzB,qCAAqC;AACrC,OAAO,EAAC,iBAAiB,EAAE,kBAAkB,EAAE,0BAA0B,EAAC,MAAM,kBAAkB,CAAC;AAUnG,0BAA0B;AAC1B,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAQpD,6FAA6F;AAC7F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAY1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,0BAA0B,CAAC;AAelC,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAcnG,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAaxG,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAa3B,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAevB,mCAAmC;AACnC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAU7B,mBAAmB;AACnB,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAG3C,kBAAkB;AAClB,OAAO,EAAC,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAC,MAAM,WAAW,CAAC;AAU/F,iCAAiC;AACjC,OAAO,EAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AAWvG,yBAAyB;AACzB,OAAO,EAAC,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/esm/operations/mrt/mrt-backend.d.ts

@@ -0,0 +1,117 @@
+/**
+ * MRT backend selection and legacy↔SCAPI fallback.
+ *
+ * Managed Runtime has two backends:
+ *   - **legacy** — the MRT Cloud API (`cloud.mobify.com`), per-user API key.
+ *   - **scapi** — the SCAPI Storefront APIs (`storefront/<api>/v1`), stateless
+ *     OAuth (client-credentials or JWT Bearer) with the `sfcc.storefront.*` scopes.
+ *
+ * This module is the MRT analogue of `clients/scapi-backend-utils.ts`
+ * (`resolveScapiOrOcapi`) and `compat/dispatcher.ts`: it resolves a user
+ * preference plus config availability into a concrete backend, and runs a
+ * SCAPI branch optimistically in `auto` mode with a one-shot, safe fallback to
+ * legacy. Unlike the OCAPI dispatcher, MRT resolves once per invocation (the
+ * supported surface — list and create — is single-call, and `--wait` pins to
+ * whichever backend the create resolved to), so a plain resolve + branch is
+ * clearer than the stateful `BackendDispatcher`.
+ *
+ * @module operations/mrt/mrt-backend
+ */
+import type { AuthStrategy } from '../../auth/types.js';
+/** User-facing MRT backend preference (`--mrt-backend` / `MRT_BACKEND` / `mrtBackend`). */
+export type MrtBackendPreference = 'auto' | 'legacy' | 'scapi';
+/** A concrete, resolved MRT backend. */
+export type MrtBackend = 'legacy' | 'scapi';
+/**
+ * SCAPI MRT connection bundle: everything a SCAPI MRT operation needs to build a
+ * client. The presence of one signals SCAPI eligibility to
+ * {@link resolveMrtBackend} / {@link runMrtWithFallback}.
+ */
+export interface ScapiMrtConnection {
+    /** SCAPI short code, e.g. `kv7kzm78`. */
+    shortCode: string;
+    /** Tenant identifier, e.g. `zzxy_prd` (the organization ID is derived from it). */
+    tenantId: string;
+    /**
+     * A SCAPI-capable OAuth strategy — client-credentials or JWT Bearer, whether
+     * configured directly or reused from a stored `b2c auth client` session.
+     */
+    auth: AuthStrategy;
+}
+/**
+ * Error message for when explicit `--mrt-backend scapi` is requested but the
+ * SCAPI MRT prerequisites are missing. Names both reasons the connection can
+ * be unavailable — missing coordinates OR an auth flow SCAPI Admin does not
+ * accept. Unlike the OCAPI {@link scapiUnavailableMessage}, MRT resolves auth
+ * through the shared `getOAuthStrategy()` path, so a stored `b2c auth client`
+ * session counts as a supported flow here.
+ */
+export declare function mrtScapiUnavailableMessage(): string;
+/**
+ * Resolves a preference plus SCAPI availability into a concrete backend.
+ *
+ * - `legacy` → always `legacy`.
+ * - `scapi` → `scapi`, throwing {@link mrtScapiUnavailableMessage} if the SCAPI
+ *   connection is missing (fail loud; never silently use legacy).
+ * - `auto` → `scapi` when a connection is available, otherwise `legacy`.
+ */
+export declare function resolveMrtBackend(opts: {
+    preference: MrtBackendPreference;
+    hasScapiConfig: boolean;
+}): MrtBackend;
+/** One async branch per backend, run by {@link runMrtWithFallback}. */
+export interface MrtBackendBranches<T> {
+    scapi: () => Promise<T>;
+    legacy: () => Promise<T>;
+}
+/** Options controlling {@link runMrtWithFallback}. */
+export interface RunMrtWithFallbackOptions {
+    /** Resolved user preference. */
+    preference: MrtBackendPreference;
+    /** True iff a {@link ScapiMrtConnection} is available. */
+    hasScapiConfig: boolean;
+    /**
+     * Whether a legacy fallback target actually exists (i.e. legacy credentials
+     * are configured). When `auto` would otherwise fall back but this is `false`,
+     * the original SCAPI error is rethrown instead of running the legacy branch —
+     * which would throw a misleading "provide an API key" error and bury the real
+     * SCAPI failure (e.g. a missing scope) that the user needs to fix. Defaults to
+     * `true`.
+     */
+    canFallbackToLegacy?: boolean;
+    /**
+     * Invoked once when `auto` mode falls back from SCAPI to legacy, with the
+     * SCAPI rejection reason. Use to warn the user.
+     */
+    onFallback?: (reason: string) => void;
+    /**
+     * Invoked with the backend that will actually serve the call — before the
+     * SCAPI attempt, and again with `'legacy'` if `auto` falls back. Use for
+     * `-D`/debug output.
+     */
+    onResolve?: (backend: MrtBackend) => void;
+}
+/** The backend that served a call and its result. */
+export interface MrtBackendRun<T> {
+    /** Backend that actually produced {@link value} (post-fallback in `auto`). */
+    backend: MrtBackend;
+    value: T;
+}
+/**
+ * Resolves the backend and runs the matching branch.
+ *
+ * - `legacy` (explicit or `auto` with no SCAPI config): runs the legacy branch.
+ * - `scapi` (explicit): runs the SCAPI branch with **no** fallback — every
+ *   error surfaces, including 409 Conflict.
+ * - `auto` with a SCAPI connection: runs SCAPI optimistically; on a
+ *   {@link isFallbackTrigger safe} rejection (a definite pre-execution client
+ *   error or `invalid_scope`) it warns and retries on legacy — but only when a
+ *   legacy target exists ({@link RunMrtWithFallbackOptions.canFallbackToLegacy}).
+ *   With no legacy credentials, the original SCAPI error is rethrown so the user
+ *   sees the real failure rather than a "provide an API key" message. Ambiguous
+ *   failures (429, 5xx, network) and 409 Conflict never fall back — a mutating
+ *   deploy must not cross backends after the request may have reached SCAPI.
+ *
+ * @returns the backend that served the call and its result.
+ */
+export declare function runMrtWithFallback<T>(options: RunMrtWithFallbackOptions, branches: MrtBackendBranches<T>): Promise<MrtBackendRun<T>>;

package/dist/esm/operations/mrt/mrt-backend.js

@@ -0,0 +1,84 @@
+import { isFallbackTrigger, resolvePreferredBackend, SCAPI_CAPABILITY_BASELINE_RELEASE, } from '../../clients/scapi-backend-utils.js';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Error message for when explicit `--mrt-backend scapi` is requested but the
+ * SCAPI MRT prerequisites are missing. Names both reasons the connection can
+ * be unavailable — missing coordinates OR an auth flow SCAPI Admin does not
+ * accept. Unlike the OCAPI {@link scapiUnavailableMessage}, MRT resolves auth
+ * through the shared `getOAuthStrategy()` path, so a stored `b2c auth client`
+ * session counts as a supported flow here.
+ */
+export function mrtScapiUnavailableMessage() {
+    return (`The SCAPI MRT backend requires shortCode, tenantId, and an OAuth flow SCAPI Admin accepts ` +
+        `that can request the sfcc.storefront.* scopes — client-credentials or JWT Bearer, configured ` +
+        `directly (--client-id/--client-secret or JWT) or as a stored \`b2c auth client\` session. ` +
+        `Browser user auth (Authorization Code + PKCE or the deprecated implicit flow) is not supported ` +
+        `for SCAPI Admin as of B2C Commerce release ${SCAPI_CAPABILITY_BASELINE_RELEASE}. ` +
+        `Provide --short-code and --tenant-id with a supported flow, or use --mrt-backend legacy ` +
+        `(per-user API key via --api-key / ~/.mobify).`);
+}
+/**
+ * Resolves a preference plus SCAPI availability into a concrete backend.
+ *
+ * - `legacy` → always `legacy`.
+ * - `scapi` → `scapi`, throwing {@link mrtScapiUnavailableMessage} if the SCAPI
+ *   connection is missing (fail loud; never silently use legacy).
+ * - `auto` → `scapi` when a connection is available, otherwise `legacy`.
+ */
+export function resolveMrtBackend(opts) {
+    const { preference, hasScapiConfig } = opts;
+    return resolvePreferredBackend({
+        preference,
+        primary: 'legacy',
+        hasScapiConfig,
+        unavailableMessage: mrtScapiUnavailableMessage,
+    });
+}
+/**
+ * Resolves the backend and runs the matching branch.
+ *
+ * - `legacy` (explicit or `auto` with no SCAPI config): runs the legacy branch.
+ * - `scapi` (explicit): runs the SCAPI branch with **no** fallback — every
+ *   error surfaces, including 409 Conflict.
+ * - `auto` with a SCAPI connection: runs SCAPI optimistically; on a
+ *   {@link isFallbackTrigger safe} rejection (a definite pre-execution client
+ *   error or `invalid_scope`) it warns and retries on legacy — but only when a
+ *   legacy target exists ({@link RunMrtWithFallbackOptions.canFallbackToLegacy}).
+ *   With no legacy credentials, the original SCAPI error is rethrown so the user
+ *   sees the real failure rather than a "provide an API key" message. Ambiguous
+ *   failures (429, 5xx, network) and 409 Conflict never fall back — a mutating
+ *   deploy must not cross backends after the request may have reached SCAPI.
+ *
+ * @returns the backend that served the call and its result.
+ */
+export async function runMrtWithFallback(options, branches) {
+    const { preference, hasScapiConfig, canFallbackToLegacy = true, onFallback, onResolve } = options;
+    const backend = resolveMrtBackend({ preference, hasScapiConfig });
+    if (backend === 'legacy') {
+        onResolve?.('legacy');
+        return { backend: 'legacy', value: await branches.legacy() };
+    }
+    onResolve?.('scapi');
+    // Explicit SCAPI: no fallback, surface all errors.
+    if (preference === 'scapi') {
+        return { backend: 'scapi', value: await branches.scapi() };
+    }
+    // auto + SCAPI available: optimistic SCAPI with a one-shot safe fallback.
+    try {
+        return { backend: 'scapi', value: await branches.scapi() };
+    }
+    catch (error) {
+        // Rethrow the real SCAPI error on ambiguous/non-safe failures, or when
+        // there is no legacy target to fall back to (falling back would only
+        // surface a misleading "provide an API key" error).
+        if (!isFallbackTrigger(error) || !canFallbackToLegacy) {
+            throw error;
+        }
+        const reason = error instanceof Error ? error.message : String(error);
+        getLogger().warn({ reason }, '[MRT] SCAPI backend rejected the request; falling back to legacy MRT');
+        onFallback?.(reason);
+        onResolve?.('legacy');
+        return { backend: 'legacy', value: await branches.legacy() };
+    }
+}
+//# sourceMappingURL=mrt-backend.js.map

package/dist/esm/operations/mrt/mrt-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrt-backend.js","sourceRoot":"","sources":["../../../../src/operations/mrt/mrt-backend.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAyBlD;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,CACL,4FAA4F;QAC5F,+FAA+F;QAC/F,4FAA4F;QAC5F,iGAAiG;QACjG,8CAA8C,iCAAiC,IAAI;QACnF,0FAA0F;QAC1F,+CAA+C,CAChD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiE;IACjG,MAAM,EAAC,UAAU,EAAE,cAAc,EAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,uBAAuB,CAAC;QAC7B,UAAU;QACV,OAAO,EAAE,QAAQ;QACjB,cAAc;QACd,kBAAkB,EAAE,0BAA0B;KAC/C,CAAC,CAAC;AACL,CAAC;AA2CD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkC,EAClC,QAA+B;IAE/B,MAAM,EAAC,UAAU,EAAE,cAAc,EAAE,mBAAmB,GAAG,IAAI,EAAE,UAAU,EAAE,SAAS,EAAC,GAAG,OAAO,CAAC;IAChG,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAC,UAAU,EAAE,cAAc,EAAC,CAAC,CAAC;IAEhE,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAC,CAAC;IAC7D,CAAC;IAED,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;IAErB,mDAAmD;IACnD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,EAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAC,CAAC;IAC3D,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC;QACH,OAAO,EAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,qEAAqE;QACrE,oDAAoD;QACpD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACtD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAC,MAAM,EAAC,EAAE,sEAAsE,CAAC,CAAC;QACnG,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;QACrB,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/esm/operations/mrt/push.d.ts

@@ -7,7 +7,7 @@
  */
 import type { AuthStrategy } from '../../auth/types.js';
 import type { MrtClient, components } from '../../clients/mrt.js';
-import type { CreateBundleOptions, Bundle } from './bundle.js';
+import type { CreateBundleOptions, Bundle, BundleV2, CreateBundleV2Options } from './bundle.js';
 /**
  * Options for pushing a bundle to MRT.
  */
@@ -99,6 +99,88 @@ export declare function pushBundle(options: PushOptions, auth: AuthStrategy): Pr
  * @returns Result of the upload
  */
 export declare function uploadBundle(client: MrtClient, projectSlug: string, bundle: Bundle, target?: string): Promise<PushResult>;
+/**
+ * Options for pushing a v2-format bundle to MRT.
+ */
+export interface PushV2Options extends CreateBundleV2Options {
+    /**
+     * The project slug to upload to.
+     */
+    projectSlug: string;
+    /**
+     * MRT API origin URL.
+     * @default "https://cloud.mobify.com"
+     */
+    origin?: string;
+}
+/**
+ * Result of a v2 push (upload) operation.
+ */
+export interface PushV2Result {
+    /**
+     * The bundle ID assigned by MRT.
+     */
+    bundleId: number;
+    /**
+     * The project slug the bundle was uploaded to.
+     */
+    projectSlug: string;
+    /**
+     * The bundle message.
+     */
+    message: string;
+    /**
+     * Non-blocking warnings returned by MRT (e.g. deprecated runtime).
+     */
+    warnings: string[];
+    /**
+     * Server-computed ssrOnly/ssrShared file matches.
+     */
+    matches: Record<string, unknown>;
+}
+/**
+ * Builds a v2-format archive from a build directory and uploads it to MRT.
+ *
+ * This is upload-only: it does not deploy the bundle. Deploy separately with
+ * {@link createDeployment} (or the `b2c mrt bundle deploy <bundleId>` command).
+ *
+ * @param options - v2 push configuration options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns Result of the upload operation
+ * @throws Error if the upload fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { pushBundleV2 } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const result = await pushBundleV2({
+ *   projectSlug: 'my-storefront',
+ *   ssrOnly: ['ssr.js'],
+ *   ssrShared: ['static/**\/*'],
+ *   buildDirectory: './build',
+ *   message: 'Release v1.0.0'
+ * }, auth);
+ *
+ * console.log(`Bundle ${result.bundleId} uploaded to ${result.projectSlug}`);
+ * ```
+ */
+export declare function pushBundleV2(options: PushV2Options, auth: AuthStrategy): Promise<PushV2Result>;
+/**
+ * Uploads a pre-built v2 bundle archive to MRT as multipart/form-data.
+ *
+ * Use this if you've already built a v2 bundle with {@link createBundleV2} and
+ * want to upload it separately.
+ *
+ * @param client - MRT client instance
+ * @param projectSlug - Project to upload to
+ * @param bundle - v2 bundle to upload
+ * @returns Result of the upload
+ * @throws Error if the upload fails or the response omits a bundle id
+ */
+export declare function uploadBundleV2(client: MrtClient, projectSlug: string, bundle: BundleV2): Promise<PushV2Result>;
 /**
  * Bundle list item from API.
  */