@salesforce/b2c-tooling-sdk 1.24.2 → 2.1.0

package/dist/esm/operations/code/upload-files.js

@@ -5,6 +5,7 @@
  */
 import path from 'node:path';
 import fs from 'node:fs';
+import { randomUUID } from 'node:crypto';
 import JSZip from 'jszip';
 import { getLogger } from '../../logging/logger.js';
 const UNZIP_BODY = new URLSearchParams({ method: 'UNZIP' }).toString();
@@ -16,12 +17,15 @@ const UNZIP_BODY = new URLSearchParams({ method: 'UNZIP' }).toString();
  * @returns The file change with src and dest, or undefined if the path is not inside any cartridge
  */
 export function fileToCartridgePath(absolutePath, cartridges) {
-    const cartridge = cartridges.find((c) => absolutePath.startsWith(c.src));
+    const cartridge = cartridges.find((c) => {
+        const relative = path.relative(c.src, absolutePath);
+        return relative !== '' && relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+    });
     if (!cartridge) {
         return undefined;
     }
-    const relativePath = absolutePath.substring(cartridge.src.length);
-    const destPath = path.join(cartridge.dest, relativePath);
+    const relativePath = path.relative(cartridge.src, absolutePath);
+    const destPath = path.join(cartridge.dest, relativePath).split(path.sep).join('/');
     return {
         src: absolutePath,
         dest: destPath,
@@ -50,21 +54,55 @@ export async function uploadFiles(instance, codeVersion, uploads, deletes, optio
     const webdavLocation = `Cartridges/${codeVersion}`;
     const validUploadFiles = uploads.filter((f) => {
         if (!fs.existsSync(f.src)) {
+            if (options?.strict)
+                throw new Error(`Upload source does not exist: ${f.src}`);
             logger.debug({ file: f.src }, 'Skipping missing file');
             return false;
         }
         return true;
     });
     if (validUploadFiles.length > 0) {
-        const uploadPath = `${webdavLocation}/_upload-${Date.now()}.zip`;
+        const uploadPath = `${webdavLocation}/_upload-${randomUUID()}.zip`;
+        let stage = 'preparing';
         try {
             const zip = new JSZip();
+            let totalBytes = 0;
             for (const f of validUploadFiles) {
                 try {
-                    const content = await fs.promises.readFile(f.src);
+                    let content;
+                    if (options?.maxBytes !== undefined) {
+                        const handle = await fs.promises.open(f.src, 'r');
+                        try {
+                            const stat = await handle.stat();
+                            const remaining = options.maxBytes - totalBytes;
+                            if (!stat.isFile() || stat.size > remaining)
+                                throw new Error('Upload exceeds the file/byte limit.');
+                            // A bounded read detects growth after stat without allocating an unbounded file.
+                            const buffer = Buffer.alloc(stat.size + 1);
+                            let length = 0;
+                            while (length < buffer.length) {
+                                const { bytesRead } = await handle.read(buffer, length, buffer.length - length);
+                                if (!bytesRead)
+                                    break;
+                                length += bytesRead;
+                            }
+                            if (length !== stat.size)
+                                throw new Error(`Upload source changed while reading: ${f.src}`);
+                            content = buffer.subarray(0, length);
+                        }
+                        finally {
+                            await handle.close();
+                        }
+                    }
+                    else {
+                        content = await fs.promises.readFile(f.src);
+                    }
+                    totalBytes += content.length;
                     zip.file(f.dest, content);
                 }
                 catch (error) {
+                    if (options?.strict)
+                        throw error;
                     logger.warn({ file: f.src, error }, 'Failed to add file to archive');
                 }
             }
@@ -73,8 +111,10 @@ export async function uploadFiles(instance, codeVersion, uploads, deletes, optio
                 compression: 'DEFLATE',
                 compressionOptions: { level: 5 },
             });
+            stage = 'uploading';
             await webdav.put(uploadPath, buffer, 'application/zip');
             logger.debug({ uploadPath }, 'Archive uploaded');
+            stage = 'extracting';
             const response = await webdav.request(uploadPath, {
                 method: 'POST',
                 body: UNZIP_BODY,
@@ -85,12 +125,23 @@ export async function uploadFiles(instance, codeVersion, uploads, deletes, optio
             if (!response.ok) {
                 throw new Error(`Unzip failed: ${response.status}`);
             }
-            await webdav.delete(uploadPath);
+            stage = 'cleaning';
+            try {
+                await webdav.delete(uploadPath);
+            }
+            catch (error) {
+                if (!options?.onWarning)
+                    throw error;
+                options.onWarning(`Files uploaded, but temporary archive cleanup failed at ${uploadPath}: ${String(error)}`);
+            }
             logger.debug({ fileCount: validUploadFiles.length, server: instance.config.hostname }, `Uploaded ${validUploadFiles.length} file(s)`);
             options?.onUpload?.(validUploadFiles.map((f) => f.dest));
         }
         catch (error) {
-            const err = error instanceof Error ? error : new Error(String(error));
+            const original = error instanceof Error ? error : new Error(String(error));
+            const err = options?.strict && stage !== 'preparing'
+                ? new Error(`Failed while ${stage} ${uploadPath}: ${original.message}. Remote files may have changed; inspect before retrying.`, { cause: original })
+                : original;
             logger.error({ error: err }, `Upload error: ${err.message}`);
             options?.onError?.(err);
             throw err;

package/dist/esm/operations/code/upload-files.js.map

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

package/dist/esm/operations/code/versions.d.ts

@@ -57,26 +57,6 @@ export declare function getActiveCodeVersion(instance: B2CInstance): Promise<Cod
  * ```
  */
 export declare function activateCodeVersion(instance: B2CInstance, codeVersionId: string): Promise<CodeVersionActivationResult>;
-/**
- * Reloads (re-activates) the current code version.
- *
- * This performs a "toggle" activation - first activating a different code version,
- * then re-activating the target version. This forces the instance to reload the code.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version to reload (defaults to current active)
- * @throws Error if reload fails or no alternate version is available
- *
- * @example
- * ```typescript
- * // Reload the currently active code version
- * await reloadCodeVersion(instance);
- *
- * // Reload a specific code version
- * await reloadCodeVersion(instance, 'v1');
- * ```
- */
-export declare function reloadCodeVersion(instance: B2CInstance, codeVersionId?: string): Promise<void>;
 /**
  * Deletes a code version from an instance.
  *

package/dist/esm/operations/code/versions.js

@@ -1,4 +1,6 @@
-import { getApiErrorMessage } from '../../clients/index.js';
+import {} from '../../clients/index.js';
+import { throwOcapiError } from '../../clients/error-utils.js';
+import { SCAPI_SCRIPTS_READ_SCOPES, SCAPI_SCRIPTS_RW_SCOPES } from '../../clients/scapi-scripts.js';
 import { getLogger } from '../../logging/logger.js';
 function isAlreadyActiveFault(error, status, codeVersionId) {
     if (status !== 400 || !error || typeof error !== 'object')
@@ -27,9 +29,12 @@ function isAlreadyActiveFault(error, status, codeVersionId) {
  * ```
  */
 export async function listCodeVersions(instance) {
-    const { data, error } = await instance.ocapi.GET('/code_versions', {});
+    const { data, error, response } = await instance.ocapi.GET('/code_versions', {});
     if (error) {
-        throw new Error('Failed to list code versions', { cause: error });
+        throwOcapiError(error, response, 'Failed to list code versions', [
+            ...SCAPI_SCRIPTS_READ_SCOPES,
+            ...SCAPI_SCRIPTS_RW_SCOPES,
+        ]);
     }
     return data.data ?? [];
 }
@@ -75,58 +80,18 @@ export async function activateCodeVersion(instance, codeVersionId) {
         body: { active: true },
     });
     if (error) {
+        // Activating the current active version is an idempotent success.
         if (isAlreadyActiveFault(error, response.status, codeVersionId)) {
             logger.debug({ codeVersionId }, `Code version ${codeVersionId} is already active`);
             return { alreadyActive: true };
         }
-        throw new Error(`Could not activate code version "${codeVersionId}": ${getApiErrorMessage(error, response)}`, {
-            cause: error,
-        });
+        // Deprecation-aware: names the SCAPI scope on OCAPI-disabled instances,
+        // otherwise throws a rich message via getApiErrorMessage.
+        throwOcapiError(error, response, `Could not activate code version "${codeVersionId}"`, SCAPI_SCRIPTS_RW_SCOPES);
     }
     logger.debug({ codeVersionId }, `Code version ${codeVersionId} activated`);
     return { alreadyActive: false };
 }
-/**
- * Reloads (re-activates) the current code version.
- *
- * This performs a "toggle" activation - first activating a different code version,
- * then re-activating the target version. This forces the instance to reload the code.
- *
- * @param instance - B2C instance
- * @param codeVersionId - Code version to reload (defaults to current active)
- * @throws Error if reload fails or no alternate version is available
- *
- * @example
- * ```typescript
- * // Reload the currently active code version
- * await reloadCodeVersion(instance);
- *
- * // Reload a specific code version
- * await reloadCodeVersion(instance, 'v1');
- * ```
- */
-export async function reloadCodeVersion(instance, codeVersionId) {
-    const logger = getLogger();
-    const versions = await listCodeVersions(instance);
-    const activeVersion = versions.find((v) => v.active);
-    const targetVersion = codeVersionId ?? activeVersion?.id;
-    if (!targetVersion) {
-        throw new Error('No code version specified and no active version found');
-    }
-    logger.debug({ codeVersionId: targetVersion }, `Reloading code version ${targetVersion}`);
-    // If the target is already active, we need to toggle to another version first
-    if (activeVersion?.id === targetVersion) {
-        const alternateVersion = versions.find((v) => v.id !== targetVersion);
-        if (!alternateVersion) {
-            throw new Error('Cannot reload: no alternate code version available for toggle');
-        }
-        logger.debug({ codeVersionId: alternateVersion.id }, `Temporarily activating ${alternateVersion.id}`);
-        await activateCodeVersion(instance, alternateVersion.id);
-    }
-    // Now activate the target version
-    await activateCodeVersion(instance, targetVersion);
-    logger.debug({ codeVersionId: targetVersion }, `Code version ${targetVersion} reloaded`);
-}
 /**
  * Deletes a code version from an instance.
  *
@@ -144,11 +109,11 @@ export async function reloadCodeVersion(instance, codeVersionId) {
 export async function deleteCodeVersion(instance, codeVersionId) {
     const logger = getLogger();
     logger.debug({ codeVersionId }, `Deleting code version ${codeVersionId}`);
-    const { error } = await instance.ocapi.DELETE('/code_versions/{code_version_id}', {
+    const { error, response } = await instance.ocapi.DELETE('/code_versions/{code_version_id}', {
         params: { path: { code_version_id: codeVersionId } },
     });
     if (error) {
-        throw new Error('Failed to delete code version', { cause: error });
+        throwOcapiError(error, response, 'Failed to delete code version', SCAPI_SCRIPTS_RW_SCOPES);
     }
     logger.debug({ codeVersionId }, `Code version ${codeVersionId} deleted`);
 }
@@ -169,11 +134,11 @@ export async function deleteCodeVersion(instance, codeVersionId) {
 export async function createCodeVersion(instance, codeVersionId) {
     const logger = getLogger();
     logger.debug({ codeVersionId }, `Creating code version ${codeVersionId}`);
-    const { error } = await instance.ocapi.PUT('/code_versions/{code_version_id}', {
+    const { error, response } = await instance.ocapi.PUT('/code_versions/{code_version_id}', {
         params: { path: { code_version_id: codeVersionId } },
     });
     if (error) {
-        throw new Error('Failed to create code version', { cause: error });
+        throwOcapiError(error, response, 'Failed to create code version', SCAPI_SCRIPTS_RW_SCOPES);
     }
     logger.debug({ codeVersionId }, `Code version ${codeVersionId} created`);
 }

package/dist/esm/operations/code/versions.js.map

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

package/dist/esm/operations/code/watch.d.ts

@@ -1,10 +1,13 @@
 import { type FSWatcher } from 'chokidar';
 import type { B2CInstance } from '../../instance/index.js';
 import { type CartridgeMapping, type FindCartridgesOptions } from './cartridges.js';
+import type { ScriptsBackend } from './scripts-types.js';
 /**
  * Options for watching cartridges.
  */
 export interface WatchOptions extends FindCartridgesOptions {
+    /** Explicit code-version backend. Defaults to OCAPI for SDK compatibility. */
+    scriptsBackend?: ScriptsBackend;
     /** Debounce time in ms for batching file changes */
     debounceTime?: number;
     /** Callback when files are uploaded */

package/dist/esm/operations/code/watch.js

@@ -8,7 +8,7 @@ import { watch } from 'chokidar';
 import { getLogger } from '../../logging/logger.js';
 import { findCartridges } from './cartridges.js';
 import { fileToCartridgePath, uploadFiles } from './upload-files.js';
-import { getActiveCodeVersion } from './versions.js';
+import { OcapiScriptsBackend } from './ocapi-scripts-backend.js';
 /** Default debounce time in ms for batching file uploads */
 const DEFAULT_DEBOUNCE_TIME = parseInt(process.env.SFCC_UPLOAD_DEBOUNCE_TIME ?? '100', 10);
 /**
@@ -58,10 +58,11 @@ export async function watchCartridges(instance, directory, options = {}) {
     const logger = getLogger();
     let codeVersion = instance.config.codeVersion;
     const debounceTime = options.debounceTime ?? DEFAULT_DEBOUNCE_TIME;
+    const scriptsBackend = options.scriptsBackend ?? new OcapiScriptsBackend(instance);
     // If no code version specified, get the active one
     if (!codeVersion) {
         logger.debug('No code version specified, getting active version...');
-        const active = await getActiveCodeVersion(instance);
+        const active = await scriptsBackend.getActiveCodeVersion();
         if (!active?.id) {
             throw new Error('No code version specified and no active code version found');
         }

package/dist/esm/operations/code/watch.js.map

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

package/dist/esm/operations/jobs/discover.d.ts

@@ -30,7 +30,7 @@ export interface ExportableUnits {
  * Discovers the data units that can be exported from an instance.
  *
  * Each category is read independently: a failure in one (e.g. the OCAPI client
- * lacks read permission for catalogs) records a warning and leaves that list
+ * lacks read permission for a category) records a warning and leaves that list
  * empty rather than failing the whole discovery, so the caller can still offer
  * the categories that succeeded.
  *

package/dist/esm/operations/jobs/discover.js

@@ -16,28 +16,27 @@
  */
 import { B2CInstance } from '../../instance/index.js';
 import { getLogger } from '../../logging/logger.js';
-/** A discoverable category and the OCAPI path used to list it. */
-const DISCOVERABLE = [
-    { key: 'sites', path: '/sites', label: 'sites' },
-    { key: 'catalogs', path: '/catalogs', label: 'catalogs' },
-    { key: 'inventoryLists', path: '/inventory_lists', label: 'inventory lists' },
-];
+import { assertOcapiCompatibilityAllowed } from '../../clients/scapi-backend-utils.js';
+import { createCatalogsBackend } from '../catalogs/index.js';
+import { createSitesBackend } from '../sites/index.js';
 /** Page size for paginated list endpoints (OCAPI default is 25). */
 const PAGE_COUNT = 200;
 /**
- * Lists one paginated OCAPI collection, following `start`/`count` until all
+ * Lists inventory lists through the remaining paginated OCAPI collection,
+ * following `start`/`count` until all
  * documents are read. Returns the `id` of each document.
  */
-async function listIds(instance, path) {
+async function listInventoryListIds(instance) {
+    assertOcapiCompatibilityAllowed(instance.apiBackend, 'inventory-list enumeration');
     const ids = [];
     let start = 0;
     // OCAPI collections page via start/count; `total` reports the full size.
     for (;;) {
-        const { data, error } = await instance.ocapi.GET(path, {
+        const { data, error } = await instance.ocapi.GET('/inventory_lists', {
             params: { query: { start, count: PAGE_COUNT } },
         });
         if (error || !data) {
-            throw new Error(error?.fault?.message ?? `Failed to list ${path}`);
+            throw new Error(error?.fault?.message ?? 'Failed to list inventory lists');
         }
         for (const item of data.data ?? []) {
             if (item.id) {
@@ -56,7 +55,7 @@ async function listIds(instance, path) {
  * Discovers the data units that can be exported from an instance.
  *
  * Each category is read independently: a failure in one (e.g. the OCAPI client
- * lacks read permission for catalogs) records a warning and leaves that list
+ * lacks read permission for a category) records a warning and leaves that list
  * empty rather than failing the whole discovery, so the caller can still offer
  * the categories that succeeded.
  *
@@ -72,16 +71,47 @@ async function listIds(instance, path) {
 export async function discoverExportableUnits(instance) {
     const logger = getLogger();
     const result = { sites: [], catalogs: [], inventoryLists: [], warnings: [] };
-    await Promise.all(DISCOVERABLE.map(async ({ key, path, label }) => {
-        try {
-            result[key] = (await listIds(instance, path)).sort((a, b) => a.localeCompare(b));
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            logger.debug({ path, err: message }, `Failed to discover ${label}`);
-            result.warnings.push(`Could not list ${label}: ${message}`);
-        }
-    }));
+    await Promise.all([
+        // Sites: SCAPI (site/sites) with OCAPI fallback.
+        (async () => {
+            try {
+                const sites = await createSitesBackend({ instance }).listSites();
+                result.sites = sites
+                    .map((s) => s.id)
+                    .filter((id) => !!id)
+                    .sort((a, b) => a.localeCompare(b));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.debug({ err: message }, 'Failed to discover sites');
+                result.warnings.push(`Could not list sites: ${message}`);
+            }
+        })(),
+        // Catalogs: SCAPI product/catalogs with OCAPI fallback.
+        (async () => {
+            try {
+                const catalogs = await createCatalogsBackend({ instance }).listCatalogs();
+                result.catalogs = catalogs.map(({ id }) => id).sort((a, b) => a.localeCompare(b));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.debug({ err: message }, 'Failed to discover catalogs');
+                result.warnings.push(`Could not list catalogs: ${message}`);
+            }
+        })(),
+        // The live SCAPI inventory APIs expose list detail/records but no
+        // organization-level inventory-list enumeration endpoint yet.
+        (async () => {
+            try {
+                result.inventoryLists = (await listInventoryListIds(instance)).sort((a, b) => a.localeCompare(b));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                logger.debug({ err: message }, 'Failed to discover inventory lists');
+                result.warnings.push(`Could not list inventory lists: ${message}`);
+            }
+        })(),
+    ]);
     return result;
 }
 //# sourceMappingURL=discover.js.map

package/dist/esm/operations/jobs/discover.js.map

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

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

@@ -1,69 +1,26 @@
 /**
  * Job execution operations for B2C Commerce.
  *
- * This module provides functions for running and monitoring jobs
- * on B2C Commerce instances via OCAPI.
+ * SDK consumers should call SCAPI ops directly via the free functions
+ * exported from `./scapi-ops` (or, for legacy code, the OCAPI free
+ * functions exported from `./run`). The CLI's `BackendDispatcher`
+ * arbitrates between them based on the user's `apiBackend` preference;
+ * that policy lives in the CLI layer.
  *
- * ## Core Job Functions
- *
- * - {@link executeJob} - Start a job execution
- * - {@link getJobExecution} - Get the status of a job execution
- * - {@link waitForJob} - Wait for a job to complete
- * - {@link searchJobExecutions} - Search for job executions
- * - {@link findRunningJobExecution} - Find a running execution
- * - {@link getJobLog} - Retrieve job log file content
- *
- * ## System Jobs
- *
- * - {@link siteArchiveImport} - Import a site archive
- * - {@link siteArchiveImportSet} - Apply an ordered, receipted set of site archives
- * - {@link siteArchiveImportSplit} - Import a large site archive in multiple parts
- * - {@link siteArchiveExport} - Export a site archive
- * - {@link siteArchiveExportToPath} - Export and save to local path
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   executeJob,
- *   waitForJob,
- *   searchJobExecutions,
- *   siteArchiveImport,
- *   siteArchiveExport,
- * } from '@salesforce/b2c-tooling-sdk/operations/jobs';
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig();
- * const instance = config.createB2CInstance();
- *
- * // Run a custom job and wait for completion
- * const execution = await executeJob(instance, 'my-job-id');
- * const result = await waitForJob(instance, 'my-job-id', execution.id);
- *
- * // Search for recent job executions
- * const results = await searchJobExecutions(instance, {
- *   jobId: 'my-job-id',
- *   count: 10
- * });
- *
- * // Import a site archive
- * await siteArchiveImport(instance, './my-import-data');
- *
- * // Export site data
- * const exportResult = await siteArchiveExport(instance, {
- *   global_data: { meta_data: true }
- * });
- * ```
- *
- * ## Authentication
- *
- * Job operations require OAuth authentication with appropriate OCAPI permissions
- * for the /jobs and /job_execution_search resources.
+ * Ordered import sets are exported from `./import-set` and continue to use
+ * the site-archive/WebDAV workflow.
  *
  * @module operations/jobs
  */
 export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, } from './run.js';
 export type { JobExecution, JobStepExecution, JobExecutionStatus, JobExecutionParameter, ExecuteJobOptions, WaitForJobOptions, WaitForJobPollInfo, SearchJobExecutionsOptions, JobExecutionSearchResult, } from './run.js';
+export { executeJob as scapiExecuteJob, getJobExecution as scapiGetJobExecution, searchJobExecutions as scapiSearchJobExecutions, deleteJobExecution as scapiDeleteJobExecution, getJobLog as scapiGetJobLog, ScapiJobStartError, } from './scapi-ops.js';
+export type { ExecuteJobScapiOptions, SearchJobExecutionsScapiOptions } from './scapi-ops.js';
+export type { JobExecutionInfo, JobStepExecutionResult, JobExecutionSearchResults } from './types.js';
+export { waitForJobExecution, CanonicalJobExecutionError } from './wait-canonical.js';
+export { mapOcapiExecution, mapOcapiSearchResult, mapCanonicalToOcapiExecution } from './ocapi-mapping.js';
+export { runSystemJob } from './run-system-job.js';
+export type { SystemJobSpec } from './run-system-job.js';
 export { siteArchiveImport, siteArchiveImportSplit, siteArchiveExport, siteArchiveExportToBuffer, siteArchiveExportToPath, } from './site-archive.js';
 export { discoverImportSet, siteArchiveImportSet, ImportSetStateError } from './import-set.js';
 export type { DiscoverImportSetOptions, ImportSetItem, ImportSetReceipt, ImportSetItemResult, ImportSetResult, ImportSetEvent, ImportSetLockOwner, SiteArchiveImportSetOptions, } from './import-set.js';