@salesforce/b2c-tooling-sdk 1.24.2 → 2.1.0

package/dist/esm/operations/sites/cartridges.js

@@ -7,13 +7,13 @@
  * Site cartridge path operations for B2C Commerce instances.
  *
  * Provides functions for managing the ordered list of active cartridges
- * on a site via OCAPI Data API, with automatic fallback to site archive
- * import/export when OCAPI permissions are unavailable.
+ * on a site via SCAPI with temporary OCAPI fallback, plus site archive
+ * import/export when neither direct API is available.
  */
 import JSZip from 'jszip';
-import { getApiErrorMessage } from '../../clients/error-utils.js';
 import { getLogger } from '../../logging/logger.js';
 import { siteArchiveImport, siteArchiveExportToBuffer } from '../jobs/site-archive.js';
+import { createSitesBackend } from './sites-backend.js';
 /** The special site ID for Business Manager. */
 export const BM_SITE_ID = 'Sites-Site';
 /**
@@ -30,7 +30,8 @@ function toResult(siteId, cartridges) {
 /**
  * Gets the cartridge path for a site.
  *
- * Uses OCAPI `GET /sites/{site_id}` to read the cartridge path.
+ * Uses the configured Sites backend to read the cartridge path. Auto mode
+ * prefers SCAPI and temporarily falls back to OCAPI.
  * Works for all sites including Business Manager (Sites-Site).
  *
  * @param instance - B2C instance to query
@@ -47,22 +48,20 @@ function toResult(siteId, cartridges) {
  * ```
  */
 export async function getCartridgePath(instance, siteId) {
-    const { data, error, response } = await instance.ocapi.GET('/sites/{site_id}', {
-        params: { path: { site_id: siteId } },
-    });
-    if (error) {
-        throw new Error(`Failed to get cartridge path for site "${siteId}": ${getApiErrorMessage(error, response)}`, {
-            cause: error,
-        });
+    try {
+        const cartridges = await createSitesBackend({ instance }).getCartridgePath(siteId);
+        return toResult(siteId, cartridges);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to get cartridge path for site "${siteId}": ${message}`, { cause: error });
     }
-    const site = data;
-    return toResult(siteId, site.cartridges ?? '');
 }
 /**
  * Adds a cartridge to a site's cartridge path.
  *
- * For regular sites, tries OCAPI `POST /sites/{site_id}/cartridges` first,
- * falling back to site archive import if OCAPI permissions are unavailable.
+ * For regular sites, uses the SCAPI-first Sites backend and falls back to site
+ * archive import if neither direct backend is available.
  * For Business Manager (Sites-Site), always uses site archive import.
  *
  * @param instance - B2C instance
@@ -91,27 +90,19 @@ export async function addCartridge(instance, siteId, options, updateOptions) {
         logger.debug({ siteId }, 'Business Manager site — using site archive import for cartridge add');
         return addCartridgeViaImport(instance, siteId, options, updateOptions);
     }
-    // Try OCAPI first for regular sites
+    const backend = createSitesBackend({ instance });
     try {
-        const { data, error, response } = await instance.ocapi.POST('/sites/{site_id}/cartridges', {
-            params: { path: { site_id: siteId } },
-            body: options,
-        });
-        if (error) {
-            throw new OcapiError(getApiErrorMessage(error, response), response.status);
-        }
-        const result = data;
-        return toResult(siteId, result.cartridges ?? '');
+        return toResult(siteId, await backend.addCartridge(siteId, options.name, options.position, options.target));
     }
-    catch (ocapiError) {
-        return handleFallback(instance, siteId, 'add', ocapiError, () => addCartridgeViaImport(instance, siteId, options, updateOptions));
+    catch (backendError) {
+        return handleFallback(instance, siteId, 'add', backendError, () => addCartridgeViaImport(instance, siteId, options, updateOptions));
     }
 }
 /**
  * Removes a cartridge from a site's cartridge path.
  *
- * For regular sites, tries OCAPI `DELETE /sites/{site_id}/cartridges/{cartridge_name}`
- * first, falling back to site archive import if OCAPI permissions are unavailable.
+ * For regular sites, uses the SCAPI-first Sites backend and falls back to site
+ * archive import if neither direct backend is available.
  * For Business Manager (Sites-Site), always uses site archive import.
  *
  * @param instance - B2C instance
@@ -130,25 +121,19 @@ export async function removeCartridge(instance, siteId, cartridgeName, updateOpt
         logger.debug({ siteId }, 'Business Manager site — using site archive import for cartridge remove');
         return removeCartridgeViaImport(instance, siteId, cartridgeName, updateOptions);
     }
+    const backend = createSitesBackend({ instance });
     try {
-        const { data, error, response } = await instance.ocapi.DELETE('/sites/{site_id}/cartridges/{cartridge_name}', {
-            params: { path: { site_id: siteId, cartridge_name: cartridgeName } },
-        });
-        if (error) {
-            throw new OcapiError(getApiErrorMessage(error, response), response.status);
-        }
-        const result = data;
-        return toResult(siteId, result.cartridges ?? '');
+        return toResult(siteId, await backend.removeCartridge(siteId, cartridgeName));
     }
-    catch (ocapiError) {
-        return handleFallback(instance, siteId, 'remove', ocapiError, () => removeCartridgeViaImport(instance, siteId, cartridgeName, updateOptions));
+    catch (backendError) {
+        return handleFallback(instance, siteId, 'remove', backendError, () => removeCartridgeViaImport(instance, siteId, cartridgeName, updateOptions));
     }
 }
 /**
  * Replaces the entire cartridge path for a site.
  *
- * For regular sites, tries OCAPI `PUT /sites/{site_id}/cartridges` first,
- * falling back to site archive import if OCAPI permissions are unavailable.
+ * For regular sites, uses the SCAPI-first Sites backend and falls back to site
+ * archive import if neither direct backend is available.
  * For Business Manager (Sites-Site), always uses site archive import.
  *
  * @param instance - B2C instance
@@ -167,39 +152,21 @@ export async function setCartridgePath(instance, siteId, cartridges, updateOptio
         logger.debug({ siteId }, 'Business Manager site — using site archive import for cartridge set');
         return setCartridgePathViaImport(instance, siteId, cartridges, updateOptions);
     }
+    const backend = createSitesBackend({ instance });
     try {
-        const { data, error, response } = await instance.ocapi.PUT('/sites/{site_id}/cartridges', {
-            params: { path: { site_id: siteId } },
-            body: { cartridges },
-        });
-        if (error) {
-            throw new OcapiError(getApiErrorMessage(error, response), response.status);
-        }
-        const result = data;
-        return toResult(siteId, result.cartridges ?? '');
+        return toResult(siteId, await backend.setCartridgePath(siteId, cartridges));
     }
-    catch (ocapiError) {
-        return handleFallback(instance, siteId, 'set', ocapiError, () => setCartridgePathViaImport(instance, siteId, cartridges, updateOptions));
-    }
-}
-// ---------------------------------------------------------------------------
-// Internal: OCAPI error wrapper
-// ---------------------------------------------------------------------------
-class OcapiError extends Error {
-    statusCode;
-    constructor(message, statusCode) {
-        super(message);
-        this.name = 'OcapiError';
-        this.statusCode = statusCode;
+    catch (backendError) {
+        return handleFallback(instance, siteId, 'set', backendError, () => setCartridgePathViaImport(instance, siteId, cartridges, updateOptions));
     }
 }
 // ---------------------------------------------------------------------------
 // Internal: Fallback handler
 // ---------------------------------------------------------------------------
-async function handleFallback(instance, siteId, operation, ocapiError, fallbackFn) {
+async function handleFallback(instance, siteId, operation, backendError, fallbackFn) {
     const logger = getLogger();
-    const ocapiMessage = ocapiError instanceof Error ? ocapiError.message : String(ocapiError);
-    logger.warn({ siteId, operation, error: ocapiMessage }, `OCAPI ${operation} failed, trying site archive import fallback`);
+    const backendMessage = backendError instanceof Error ? backendError.message : String(backendError);
+    logger.warn({ siteId, operation, error: backendMessage }, `Direct API ${operation} failed, trying site archive import fallback`);
     try {
         return await fallbackFn();
     }
@@ -208,10 +175,11 @@ async function handleFallback(instance, siteId, operation, ocapiError, fallbackF
         throw new Error([
             `Failed to ${operation} cartridge path for site "${siteId}".`,
             '',
-            `OCAPI direct update failed: ${ocapiMessage}`,
+            `SCAPI/OCAPI direct update failed: ${backendMessage}`,
             `Site archive import fallback also failed: ${importMessage}`,
             '',
             'To fix, configure one of:',
+            '  • SCAPI Sites API: Grant sfcc.sites.rw',
             '  • OCAPI Data API: Grant POST/PUT/DELETE on /sites/*/cartridges',
             '  • Site import: Grant job execution permissions for sfcc-site-archive-import and WebDAV write access to Impex/',
             '',

package/dist/esm/operations/sites/cartridges.js.map

@@ -1 +1 @@
-{"version":3,"file":"cartridges.js","sourceRoot":"","sources":["../../../../src/operations/sites/cartridges.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cartridges.js","sourceRoot":"","sources":["../../../../src/operations/sites/cartridges.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAC,iBAAiB,EAAE,yBAAyB,EAAC,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAGtD,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AAiCvC;;GAEG;AACH,SAAS,QAAQ,CAAC,MAAc,EAAE,UAAkB;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO;QACL,MAAM;QACN,UAAU,EAAE,OAAO;QACnB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAqB,EAAE,MAAc;IAC1E,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACjF,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,MAAM,OAAO,EAAE,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;IACnG,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAqB,EACrB,MAAc,EACd,OAA4B,EAC5B,aAAsC;IAEtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,EAAC,MAAM,EAAC,EAAE,qEAAqE,CAAC,CAAC;QAC9F,OAAO,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9G,CAAC;IAAC,OAAO,YAAY,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAChE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAqB,EACrB,MAAc,EACd,aAAqB,EACrB,aAAsC;IAEtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,EAAC,MAAM,EAAC,EAAE,wEAAwE,CAAC,CAAC;QACjG,OAAO,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,YAAY,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,CACnE,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAqB,EACrB,MAAc,EACd,UAAkB,EAClB,aAAsC;IAEtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,EAAC,MAAM,EAAC,EAAE,qEAAqE,CAAC,CAAC;QAC9F,OAAO,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,YAAY,EAAE,CAAC;QACtB,OAAO,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAChE,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,KAAK,UAAU,cAAc,CAC3B,QAAqB,EACrB,MAAc,EACd,SAAiB,EACjB,YAAqB,EACrB,UAA8C;IAE9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,cAAc,GAAG,YAAY,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAEnG,MAAM,CAAC,IAAI,CACT,EAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAC,EAC1C,cAAc,SAAS,8CAA8C,CACtE,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,WAAW,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/F,MAAM,IAAI,KAAK,CACb;YACE,aAAa,SAAS,6BAA6B,MAAM,IAAI;YAC7D,EAAE;YACF,qCAAqC,cAAc,EAAE;YACrD,6CAA6C,aAAa,EAAE;YAC5D,EAAE;YACF,2BAA2B;YAC3B,0CAA0C;YAC1C,kEAAkE;YAClE,iHAAiH;YACjH,EAAE;YACF,gGAAgG;SACjG,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,EAAC,KAAK,EAAE,WAAW,EAAC,CACrB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E;;;GAGG;AACH,KAAK,UAAU,yBAAyB,CACtC,QAAqB,EACrB,MAAc,EACd,aAAsC;IAEtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAC,GAAG,EAAE,WAAW,EAAC,GAAG,aAAa,IAAI,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,CAAC,EAAC,MAAM,EAAC,EAAE,gDAAgD,CAAC,CAAC;IACzE,GAAG,EAAE,CACH,aAAa,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,iBAAiB,4BAA4B,CAChH,CAAC;IAEF,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,EAAC,WAAW,EAAE,EAAC,WAAW,EAAE,IAAI,EAAC,EAAC,EAAE,EAAC,WAAW,EAAC,CAAC,CAAC;QAC5G,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,mCAAmC,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,EAAC,KAAK,EAAE,EAAC,CAAC,MAAM,CAAC,EAAE,EAAC,eAAe,EAAE,IAAI,EAAC,EAAC,EAAC,EAAE,EAAC,WAAW,EAAC,CAAC,CAAC;IACtH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kDAAkD,MAAM,GAAG,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,oCAAoC,CAAC,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,QAAqB,EACrB,MAAc,EACd,UAAkB,EAClB,aAAsC;IAEtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAC,GAAG,EAAE,WAAW,EAAC,GAAG,aAAa,IAAI,EAAE,CAAC;IAC/C,MAAM,CAAC,KAAK,CAAC,EAAC,MAAM,EAAE,UAAU,EAAC,EAAE,gDAAgD,CAAC,CAAC;IACrF,GAAG,EAAE,CAAC,qCAAqC,CAAC,CAAC;IAE7C,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IAExB,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,CAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,EAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAC,CAAC,CAAC;IACrF,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAC,WAAW,EAAC,CAAC,CAAC;IAEzD,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,QAAqB,EACrB,MAAc,EACd,OAA4B,EAC5B,aAAsC;IAEtC,oBAAoB;IACpB,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxD,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhE,0BAA0B;IAC1B,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,cAAc,OAAO,CAAC,IAAI,oDAAoD,MAAM,GAAG,CAAC,CAAC;IAC3G,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAG,sBAAsB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAE/D,OAAO,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;AACvF,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,QAAqB,EACrB,MAAc,EACd,aAAqB,EACrB,aAAsC;IAEtC,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxD,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,MAAM,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,cAAc,aAAa,+CAA+C,MAAM,GAAG,CAAC,CAAC;IACvG,CAAC;IAED,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,OAAO,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;AAC7F,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,aAAuB,EAAE,OAA4B;IACnF,MAAM,IAAI,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC;IAChC,MAAM,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IAEzC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnB,MAAM;QACR,KAAK,MAAM;YACT,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,MAAM;QACR,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,mCAAmC,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,mCAAmC,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC9B,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,SAAS,wBAAwB,CAAC,UAAkB;IAClD,OAAO;;;;2DAIkD,SAAS,CAAC,UAAU,CAAC;;;;CAI/E,CAAC;AACF,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAc,EAAE,UAAkB;IACnE,OAAO;6EACoE,SAAS,CAAC,MAAM,CAAC;kBAC5E,SAAS,CAAC,UAAU,CAAC;;CAEtC,CAAC;AACF,CAAC;AAED,SAAS,mCAAmC,CAAC,GAAW;IACtD,4CAA4C;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IACrG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,oCAAoC,CAAC,GAAW;IACvD,mCAAmC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC7D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACxG,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAU,EAAE,QAAgB;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -2,10 +2,9 @@
  * Site operations for B2C Commerce instances.
  *
  * This module provides functions for managing site cartridge paths
- * on B2C Commerce instances. Operations work via OCAPI Data API with
- * automatic fallback to site archive import/export when OCAPI permissions
- * are unavailable. Business Manager (Sites-Site) is supported via the
- * import/export mechanism.
+ * on B2C Commerce instances. Operations use SCAPI first, with temporary
+ * OCAPI and site-archive fallbacks. Business Manager (Sites-Site) is
+ * supported via the import/export mechanism.
  *
  * ## Cartridge Path Functions
  *
@@ -36,11 +35,16 @@
  *
  * ## Authentication
  *
- * Cartridge path operations require OAuth authentication. For OCAPI direct updates,
- * grant POST/PUT/DELETE on `/sites/∗/cartridges`. For import/export fallback,
+ * Cartridge path operations require OAuth authentication. For SCAPI direct updates,
+ * grant `sfcc.sites.rw`; for OCAPI grant POST/PUT/DELETE on `/sites/∗/cartridges`. For import/export fallback,
  * grant job execution permissions and WebDAV write access.
  *
  * @module operations/sites
  */
 export { getCartridgePath, addCartridge, removeCartridge, setCartridgePath, BM_SITE_ID } from './cartridges.js';
 export type { CartridgePathResult, AddCartridgeOptions, CartridgePosition, CartridgeUpdateOptions, } from './cartridges.js';
+export { createSitesBackend } from './sites-backend.js';
+export type { SitesBackendConfig } from './sites-backend.js';
+export { ScapiSitesBackend } from './scapi-sites-backend.js';
+export { OcapiSitesBackend } from './ocapi-sites-backend.js';
+export type { SitesBackend, SiteInfo, ListSitesOptions } from './sites-types.js';

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

@@ -7,10 +7,9 @@
  * Site operations for B2C Commerce instances.
  *
  * This module provides functions for managing site cartridge paths
- * on B2C Commerce instances. Operations work via OCAPI Data API with
- * automatic fallback to site archive import/export when OCAPI permissions
- * are unavailable. Business Manager (Sites-Site) is supported via the
- * import/export mechanism.
+ * on B2C Commerce instances. Operations use SCAPI first, with temporary
+ * OCAPI and site-archive fallbacks. Business Manager (Sites-Site) is
+ * supported via the import/export mechanism.
  *
  * ## Cartridge Path Functions
  *
@@ -41,11 +40,15 @@
  *
  * ## Authentication
  *
- * Cartridge path operations require OAuth authentication. For OCAPI direct updates,
- * grant POST/PUT/DELETE on `/sites/∗/cartridges`. For import/export fallback,
+ * Cartridge path operations require OAuth authentication. For SCAPI direct updates,
+ * grant `sfcc.sites.rw`; for OCAPI grant POST/PUT/DELETE on `/sites/∗/cartridges`. For import/export fallback,
  * grant job execution permissions and WebDAV write access.
  *
  * @module operations/sites
  */
 export { getCartridgePath, addCartridge, removeCartridge, setCartridgePath, BM_SITE_ID } from './cartridges.js';
+// Site read operations (list/get) — SCAPI with OCAPI fallback
+export { createSitesBackend } from './sites-backend.js';
+export { ScapiSitesBackend } from './scapi-sites-backend.js';
+export { OcapiSitesBackend } from './ocapi-sites-backend.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/sites/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,EAAC,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/sites/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,EAAC,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAS9G,8DAA8D;AAC9D,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC"}

package/dist/esm/operations/sites/ocapi-sites-backend.d.ts

@@ -0,0 +1,20 @@
+import type { B2CInstance } from '../../instance/index.js';
+import type { SitesBackend, SiteInfo, ListSitesOptions } from './sites-types.js';
+import type { CartridgePosition } from './sites-types.js';
+/**
+ * OCAPI Sites backend (legacy/fallback). Reads sites and per-site detail via
+ * the OCAPI Data API `/sites` resource.
+ */
+export declare class OcapiSitesBackend implements SitesBackend {
+    private instance;
+    readonly name: "ocapi";
+    constructor(instance: B2CInstance);
+    listSites(options?: ListSitesOptions): Promise<SiteInfo[]>;
+    private fetchSitePage;
+    private fetchSitePageWithTotal;
+    getSite(siteId: string): Promise<SiteInfo>;
+    getCartridgePath(siteId: string): Promise<string>;
+    setCartridgePath(siteId: string, cartridges: string): Promise<string>;
+    addCartridge(siteId: string, name: string, position: CartridgePosition, target?: string): Promise<string>;
+    removeCartridge(siteId: string, name: string): Promise<string>;
+}

package/dist/esm/operations/sites/ocapi-sites-backend.js

@@ -0,0 +1,98 @@
+import { throwOcapiError } from '../../clients/error-utils.js';
+import { SCAPI_SITES_READ_AND_RW_SCOPES } from './sites-scopes.js';
+function mapOcapiSite(ocapi) {
+    return {
+        id: ocapi.id ?? '',
+        displayName: ocapi.display_name?.default ?? ocapi.id ?? '',
+        storefrontStatus: ocapi.storefront_status,
+        cartridges: ocapi.cartridges,
+        _raw: ocapi,
+    };
+}
+/**
+ * OCAPI Sites backend (legacy/fallback). Reads sites and per-site detail via
+ * the OCAPI Data API `/sites` resource.
+ */
+export class OcapiSitesBackend {
+    instance;
+    name = 'ocapi';
+    constructor(instance) {
+        this.instance = instance;
+    }
+    async listSites(options = {}) {
+        // When the caller bounds the result (start/count), honor it as a single
+        // page. Otherwise page through the whole collection so callers that need
+        // *all* sites (export-unit discovery, CAP feature listing) don't silently
+        // truncate at the OCAPI default page size.
+        if (options.start !== undefined || options.count !== undefined) {
+            return this.fetchSitePage(options.start, options.count);
+        }
+        const all = [];
+        const pageSize = 200;
+        let start = 0;
+        for (;;) {
+            const { sites, total } = await this.fetchSitePageWithTotal(start, pageSize);
+            all.push(...sites);
+            start += pageSize;
+            if (sites.length === 0 || start >= total)
+                break;
+        }
+        return all;
+    }
+    async fetchSitePage(start, count) {
+        return (await this.fetchSitePageWithTotal(start, count)).sites;
+    }
+    async fetchSitePageWithTotal(start, count) {
+        const { data, error, response } = await this.instance.ocapi.GET('/sites', {
+            params: { query: { start, count, select: '(**)' } },
+        });
+        if (error || !data) {
+            throwOcapiError(error, response, 'Failed to list sites', SCAPI_SITES_READ_AND_RW_SCOPES);
+        }
+        const body = data;
+        const sites = (body.data ?? []).map(mapOcapiSite);
+        return { sites, total: body.total ?? (start ?? 0) + sites.length };
+    }
+    async getSite(siteId) {
+        const { data, error, response } = await this.instance.ocapi.GET('/sites/{site_id}', {
+            params: { path: { site_id: siteId } },
+        });
+        if (error || !data) {
+            throwOcapiError(error, response, `Failed to get site ${siteId}`, SCAPI_SITES_READ_AND_RW_SCOPES);
+        }
+        return mapOcapiSite(data);
+    }
+    async getCartridgePath(siteId) {
+        return (await this.getSite(siteId)).cartridges ?? '';
+    }
+    async setCartridgePath(siteId, cartridges) {
+        const { data, error, response } = await this.instance.ocapi.PUT('/sites/{site_id}/cartridges', {
+            params: { path: { site_id: siteId } },
+            body: { cartridges },
+        });
+        if (error || !data) {
+            throwOcapiError(error, response, `Failed to set cartridge path for site ${siteId}`, SCAPI_SITES_READ_AND_RW_SCOPES);
+        }
+        return data.cartridges ?? cartridges;
+    }
+    async addCartridge(siteId, name, position, target) {
+        const { data, error, response } = await this.instance.ocapi.POST('/sites/{site_id}/cartridges', {
+            params: { path: { site_id: siteId } },
+            body: { name, position, target },
+        });
+        if (error || !data) {
+            throwOcapiError(error, response, `Failed to add cartridge ${name} to site ${siteId}`, SCAPI_SITES_READ_AND_RW_SCOPES);
+        }
+        return data.cartridges ?? '';
+    }
+    async removeCartridge(siteId, name) {
+        const { data, error, response } = await this.instance.ocapi.DELETE('/sites/{site_id}/cartridges/{cartridge_name}', {
+            params: { path: { site_id: siteId, cartridge_name: name } },
+        });
+        if (error || !data) {
+            throwOcapiError(error, response, `Failed to remove cartridge ${name} from site ${siteId}`, SCAPI_SITES_READ_AND_RW_SCOPES);
+        }
+        return data.cartridges ?? '';
+    }
+}
+//# sourceMappingURL=ocapi-sites-backend.js.map

package/dist/esm/operations/sites/ocapi-sites-backend.js.map

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

package/dist/esm/operations/sites/scapi-sites-backend.d.ts

@@ -0,0 +1,33 @@
+import type { AuthStrategy } from '../../auth/types.js';
+import type { SitesBackend, SiteInfo, ListSitesOptions, CartridgePosition } from './sites-types.js';
+export interface ScapiSitesBackendConfig {
+    shortCode: string;
+    tenantId: string;
+    auth: AuthStrategy;
+    /** Unused by Sites; accepted for compatibility with the dual-backend factory. */
+    instance?: unknown;
+}
+/**
+ * SCAPI Sites backend. Reads sites and manages custom cartridge paths via the
+ * `site/sites/v1` Admin API.
+ */
+export declare class ScapiSitesBackend implements SitesBackend {
+    readonly name: "scapi";
+    private organizationId;
+    private client;
+    constructor(config: ScapiSitesBackendConfig);
+    listSites(options?: ListSitesOptions): Promise<SiteInfo[]>;
+    /**
+     * Fetches the requested window of sites, paginating across 50-item SCAPI
+     * pages. `start` is the offset into the full result set; `count` bounds how
+     * many are returned (unbounded when omitted).
+     */
+    private fetchSitePage;
+    /** Maps sites, fetching per-site detail (bounded concurrency) for sparse items. */
+    private enrichSites;
+    getSite(siteId: string): Promise<SiteInfo>;
+    getCartridgePath(siteId: string): Promise<string>;
+    setCartridgePath(siteId: string, cartridges: string): Promise<string>;
+    addCartridge(siteId: string, name: string, position: CartridgePosition, target?: string): Promise<string>;
+    removeCartridge(siteId: string, name: string): Promise<string>;
+}

package/dist/esm/operations/sites/scapi-sites-backend.js

@@ -0,0 +1,166 @@
+import { createScapiSitesClient, toOrganizationId, } from '../../clients/scapi-sites.js';
+import { SCOPE_MODE_HEADER } from '../../clients/middleware.js';
+import { createScapiRequestError } from '../../clients/scapi-backend-utils.js';
+const READ_HEADERS = { [SCOPE_MODE_HEADER]: 'read' };
+const WRITE_HEADERS = { [SCOPE_MODE_HEADER]: 'write' };
+/** SCAPI `getSites` caps `limit` at 50 (spec `site-sites-v1.yaml`). */
+const SCAPI_SITES_MAX_PAGE = 50;
+/** Concurrency for per-site detail enrichment; bounds rate-limit pressure. */
+const ENRICH_CONCURRENCY = 5;
+function defaultLocaleValue(map) {
+    if (!map)
+        return undefined;
+    return map.default ?? Object.values(map)[0];
+}
+function mapScapiSite(scapi) {
+    return {
+        id: scapi.id,
+        displayName: defaultLocaleValue(scapi.displayName) ?? scapi.id,
+        storefrontStatus: scapi.storefrontStatus,
+        cartridges: scapi.cartridges,
+        _raw: scapi,
+    };
+}
+/**
+ * SCAPI Sites backend. Reads sites and manages custom cartridge paths via the
+ * `site/sites/v1` Admin API.
+ */
+export class ScapiSitesBackend {
+    name = 'scapi';
+    organizationId;
+    client;
+    constructor(config) {
+        this.organizationId = toOrganizationId(config.tenantId);
+        const clientConfig = { shortCode: config.shortCode, tenantId: config.tenantId };
+        this.client = createScapiSitesClient(clientConfig, config.auth);
+    }
+    async listSites(options = {}) {
+        // Page through `getSites` on the server (limit capped at 50) rather than
+        // relying on the default single 25-item page — otherwise instances with
+        // more than 25 sites silently lose the rest. The caller's start/count map
+        // to SCAPI offset/limit.
+        const rawSites = await this.fetchSitePage(options);
+        // `getSites` returns items that carry only the id (display name, storefront
+        // status, and cartridges live on the per-site detail endpoint). Enrich any
+        // sparse item via `getSite`, with bounded concurrency to limit rate-limit
+        // pressure. Items that already arrive rich (future-proofing if the platform
+        // starts populating list fields) are mapped directly with no extra call.
+        return this.enrichSites(rawSites);
+    }
+    /**
+     * Fetches the requested window of sites, paginating across 50-item SCAPI
+     * pages. `start` is the offset into the full result set; `count` bounds how
+     * many are returned (unbounded when omitted).
+     */
+    async fetchSitePage(options) {
+        const startOffset = options.start ?? 0;
+        const target = options.count; // undefined → all remaining
+        const collected = [];
+        let offset = startOffset;
+        while (true) {
+            const remaining = target === undefined ? SCAPI_SITES_MAX_PAGE : target - collected.length;
+            if (remaining <= 0)
+                break;
+            const limit = Math.min(SCAPI_SITES_MAX_PAGE, remaining);
+            const { data, error, response } = await this.client.GET('/organizations/{organizationId}/sites', {
+                params: { path: { organizationId: this.organizationId }, query: { limit, offset } },
+                headers: READ_HEADERS,
+            });
+            if (error || !data) {
+                throw createScapiRequestError(error, response, 'Failed to list sites');
+            }
+            const page = data;
+            const items = page.data ?? [];
+            collected.push(...items);
+            offset += items.length;
+            // Stop when the server has no more items, or we've reached the reported
+            // total, or the page came back short (defensive against a missing total).
+            const total = page.total ?? startOffset + collected.length;
+            if (items.length === 0 || offset >= total)
+                break;
+        }
+        return collected;
+    }
+    /** Maps sites, fetching per-site detail (bounded concurrency) for sparse items. */
+    async enrichSites(sites) {
+        const results = [];
+        for (let i = 0; i < sites.length; i += ENRICH_CONCURRENCY) {
+            const batch = sites.slice(i, i + ENRICH_CONCURRENCY);
+            const mapped = await Promise.all(batch.map((site) => {
+                // If the list item is already rich, avoid the extra detail call.
+                if (site.displayName !== undefined || site.storefrontStatus !== undefined) {
+                    return Promise.resolve(mapScapiSite(site));
+                }
+                return site.id ? this.getSite(site.id) : Promise.resolve(mapScapiSite(site));
+            }));
+            results.push(...mapped);
+        }
+        return results;
+    }
+    async getSite(siteId) {
+        const { data, error, response } = await this.client.GET('/organizations/{organizationId}/sites/{siteId}', {
+            params: { path: { organizationId: this.organizationId, siteId } },
+            headers: READ_HEADERS,
+        });
+        if (error || !data) {
+            throw createScapiRequestError(error, response, `Failed to get site ${siteId}`);
+        }
+        return mapScapiSite(data);
+    }
+    async getCartridgePath(siteId) {
+        const { data, error, response } = await this.client.GET('/organizations/{organizationId}/sites/{siteId}/custom-cartridges', {
+            params: { path: { organizationId: this.organizationId, siteId } },
+            headers: READ_HEADERS,
+        });
+        if (error || !data) {
+            throw createScapiRequestError(error, response, `Failed to get cartridge path for site ${siteId}`);
+        }
+        return data.customCartridges;
+    }
+    async setCartridgePath(siteId, cartridges) {
+        const { data, error, response } = await this.client.PUT('/organizations/{organizationId}/sites/{siteId}/custom-cartridges', {
+            params: { path: { organizationId: this.organizationId, siteId } },
+            headers: WRITE_HEADERS,
+            body: { customCartridges: cartridges },
+        });
+        if (error || !data) {
+            throw createScapiRequestError(error, response, `Failed to set cartridge path for site ${siteId}`);
+        }
+        return data.customCartridges;
+    }
+    async addCartridge(siteId, name, position, target) {
+        const current = await this.getCartridgePath(siteId);
+        const cartridges = current ? current.split(':') : [];
+        if (cartridges.includes(name)) {
+            throw new Error(`Cartridge "${name}" already exists in the cartridge path for site "${siteId}"`);
+        }
+        insertCartridge(cartridges, name, position, target);
+        return this.setCartridgePath(siteId, cartridges.join(':'));
+    }
+    async removeCartridge(siteId, name) {
+        const current = await this.getCartridgePath(siteId);
+        const cartridges = current ? current.split(':') : [];
+        const index = cartridges.indexOf(name);
+        if (index < 0)
+            throw new Error(`Cartridge "${name}" not found in the cartridge path for site "${siteId}"`);
+        cartridges.splice(index, 1);
+        return this.setCartridgePath(siteId, cartridges.join(':'));
+    }
+}
+function insertCartridge(cartridges, name, position, target) {
+    if (position === 'first') {
+        cartridges.unshift(name);
+        return;
+    }
+    if (position === 'last') {
+        cartridges.push(name);
+        return;
+    }
+    if (!target)
+        throw new Error(`Target cartridge is required for position "${position}"`);
+    const targetIndex = cartridges.indexOf(target);
+    if (targetIndex < 0)
+        throw new Error(`Target cartridge "${target}" not found in cartridge path`);
+    cartridges.splice(position === 'before' ? targetIndex : targetIndex + 1, 0, name);
+}
+//# sourceMappingURL=scapi-sites-backend.js.map