@salesforce/b2c-tooling-sdk 0.3.0 → 0.4.0

package/dist/cjs/index.js

@@ -13,7 +13,7 @@ export { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, ApiKeyStrategy
 // Context Layer - Instance
 export { B2CInstance } from './instance/index.js';
 // Clients
-export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createCdnZonesClient, toOrganizationId, toTenantId, buildTenantScope, getApiErrorMessage, ORGANIZATION_ID_PREFIX, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, } from './clients/index.js';
+export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, toOrganizationId, toTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, } from './clients/index.js';
 // Operations - Code
 export { findCartridges, listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, findAndDeployCartridges, uploadCartridges, deleteCartridges, watchCartridges, } from './operations/code/index.js';
 // Operations - Jobs
@@ -21,9 +21,15 @@ export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunni
 // Docs - Documentation search
 export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex, listSchemas, readSchema, readSchemaByQuery, searchSchemas, downloadDocs, } from './docs/index.js';
 // Operations - ODS
-export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, } from './operations/ods/index.js';
+export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, } from './operations/ods/index.js';
+// Operations - Users
+export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
+// Operations - Roles
+export { getRole, listRoles } from './operations/roles/index.js';
+// Operations - Organizations
+export { getOrg, getOrgByName, listOrgs } from './operations/orgs/index.js';
 // Defaults
-export { DEFAULT_ACCOUNT_MANAGER_HOST, DEFAULT_ODS_HOST } from './defaults.js';
+export { DEFAULT_ACCOUNT_MANAGER_HOST, DEFAULT_ODS_HOST, DEFAULT_PUBLIC_CLIENT_ID } from './defaults.js';
 // Version info
 export { SDK_NAME, SDK_VERSION, SDK_USER_AGENT } from './version.js';
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAG7G,OAAO;AACP,OAAO,EAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGlH,SAAS;AACT,OAAO,EAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAe9G,yCAAyC;AACzC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAiBzB,2BAA2B;AAC3B,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAGhD,UAAU;AACV,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAsC5B,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAYpC,oBAAoB;AACpB,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAmBpC,8BAA8B;AAC9B,OAAO,EACL,UAAU,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,eAAe,EACf,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAYzB,mBAAmB;AACnB,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,WAAW;AACX,OAAO,EAAC,4BAA4B,EAAE,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE7E,eAAe;AACf,OAAO,EAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAG7G,OAAO;AACP,OAAO,EAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGlH,SAAS;AACT,OAAO,EAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAe9G,yCAAyC;AACzC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAiBzB,2BAA2B;AAC3B,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAGhD,UAAU;AACV,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,+BAA+B,EAC/B,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,EAC9B,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAiE5B,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAYpC,oBAAoB;AACpB,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAmBpC,8BAA8B;AAC9B,OAAO,EACL,UAAU,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,eAAe,EACf,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAYzB,mBAAmB;AACnB,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAInC,qBAAqB;AACrB,OAAO,EACL,OAAO,EACP,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,6BAA6B,CAAC;AAErC,qBAAqB;AACrB,OAAO,EAAC,OAAO,EAAE,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAE/D,6BAA6B;AAC7B,OAAO,EAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AAE1E,WAAW;AACX,OAAO,EAAC,4BAA4B,EAAE,gBAAgB,EAAE,wBAAwB,EAAC,MAAM,eAAe,CAAC;AAEvG,eAAe;AACf,OAAO,EAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAC,MAAM,cAAc,CAAC"}

package/dist/cjs/logging/logger.js

@@ -6,6 +6,7 @@
 /**
  * Logger using pino with pretty printing by default.
  */
+import { Writable } from 'node:stream';
 import pino from 'pino';
 import pretty from 'pino-pretty';
 const REDACT_FIELDS = [
@@ -54,6 +55,17 @@ function censor(value, path) {
     }
     return 'REDACTED';
 }
+/** Wrap a minimal LogDestination in a Node.js Writable so pino-pretty's transport pipeline works. */
+function toWritable(dest) {
+    if (dest instanceof Writable)
+        return dest;
+    return new Writable({
+        write(chunk, _encoding, callback) {
+            dest.write(chunk);
+            callback();
+        },
+    });
+}
 let globalLogger = null;
 let globalOptions = { level: 'silent' };
 function createPinoLogger(options) {
@@ -80,7 +92,7 @@ function createPinoLogger(options) {
         }
         const isVerbose = level === 'debug' || level === 'trace';
         const prettyStream = pretty({
-            destination: options.destination,
+            destination: toWritable(options.destination),
             sync: true,
             colorize,
             ignore: 'pid,hostname' + (isVerbose ? '' : ',time'),

package/dist/cjs/logging/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;GAEG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,MAAM,aAAa,GAAG;IACpB,UAAU;IACV,eAAe;IACf,cAAc;IACd,cAAc;IACd,aAAa;IACb,eAAe;IACf,cAAc;IACd,SAAS;IACT,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,eAAe;IACf,eAAe;CAChB,CAAC;AAEF,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC;AAE7E,SAAS,MAAM,CAAC,KAAc,EAAE,IAAc;IAC5C,6CAA6C;IAC7C,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,eAAe,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;YAEpC,yDAAyD;YACzD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBACrE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACxC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;wBACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;wBAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBACxE,OAAO,SAAS,QAAQ,EAAE,CAAC;oBAC7B,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,sDAAsD;gBACxD,CAAC;YACH,CAAC;YAED,kEAAkE;YAClE,OAAO,GAAG,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACnD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AACvC,IAAI,aAAa,GAAkB,EAAC,KAAK,EAAE,QAAQ,EAAC,CAAC;AAErD,SAAS,gBAAgB,CAAC,OAAsB;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,oBAAoB;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAE1C,MAAM,WAAW,GAAuB;QACtC,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QAC/B,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC;SACnC;KACF,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,WAAW,CAAC,MAAM,GAAG;YACnB,KAAK,EAAE,YAAY;YACnB,MAAM;SACP,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAsB,CAAC;QACrE,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC;QACzD,MAAM,YAAY,GAAG,MAAM,CAAC;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,IAAI,EAAE,IAAI;YACV,QAAQ;YACR,MAAM,EAAE,cAAc,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACnD,UAAU,EAAE,CAAC,SAAS;SACvB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,cAAc;IACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,EAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC,CAAsB,CAAC;IACpF,CAAC;IAED,yBAAyB;IACzB,MAAM,SAAS,GAAG,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC;IACzD,MAAM,YAAY,GAAG,MAAM,CAAC;QAC1B,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,IAAI;QACV,QAAQ;QACR,MAAM,EAAE,cAAc,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACnD,UAAU,EAAE,CAAC,SAAS;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,OAAO,gBAAgB,CAAC,EAAC,GAAG,aAAa,EAAE,GAAG,OAAO,EAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,aAAa,GAAG,EAAC,GAAG,aAAa,EAAE,GAAG,OAAO,EAAC,CAAC;IAC/C,YAAY,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,YAAY,GAAG,IAAI,CAAC;IACpB,aAAa,GAAG,EAAC,KAAK,EAAE,QAAQ,EAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,CAAC,EAAC,KAAK,EAAE,QAAQ,EAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logging/logger.ts"],"names":[],"mappings":"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"}

package/dist/cjs/operations/content/asset-query.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Extract static asset paths from component JSON data using dot-notation queries.
+ *
+ * Supports `*` as a wildcard segment to traverse arrays, allowing extraction
+ * from repeated structures like `banners.*.image.src`.
+ *
+ * @param data - Parsed JSON data from a component's `<data>` element
+ * @param queries - Dot-notation paths to extract (e.g. `['image.path', 'slides.*.image.src']`)
+ * @returns Array of extracted asset path strings
+ *
+ * @example
+ * ```typescript
+ * const data = { image: { path: '/images/hero.jpg' } };
+ * extractAssetPaths(data, ['image.path']);
+ * // => ['/images/hero.jpg']
+ *
+ * const data2 = { slides: [{ image: { src: '/a.jpg' } }, { image: { src: '/b.jpg' } }] };
+ * extractAssetPaths(data2, ['slides.*.image.src']);
+ * // => ['/a.jpg', '/b.jpg']
+ * ```
+ */
+export declare function extractAssetPaths(data: Record<string, unknown>, queries: string[]): string[];

package/dist/cjs/operations/content/asset-query.js

@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Extract static asset paths from component JSON data using dot-notation queries.
+ *
+ * Supports `*` as a wildcard segment to traverse arrays, allowing extraction
+ * from repeated structures like `banners.*.image.src`.
+ *
+ * @param data - Parsed JSON data from a component's `<data>` element
+ * @param queries - Dot-notation paths to extract (e.g. `['image.path', 'slides.*.image.src']`)
+ * @returns Array of extracted asset path strings
+ *
+ * @example
+ * ```typescript
+ * const data = { image: { path: '/images/hero.jpg' } };
+ * extractAssetPaths(data, ['image.path']);
+ * // => ['/images/hero.jpg']
+ *
+ * const data2 = { slides: [{ image: { src: '/a.jpg' } }, { image: { src: '/b.jpg' } }] };
+ * extractAssetPaths(data2, ['slides.*.image.src']);
+ * // => ['/a.jpg', '/b.jpg']
+ * ```
+ */
+export function extractAssetPaths(data, queries) {
+    const results = [];
+    for (const query of queries) {
+        const segments = query.split('.');
+        collectPaths(data, segments, 0, results);
+    }
+    return results;
+}
+/**
+ * Recursively walks the data object following the query segments.
+ * Wildcard `*` segments iterate over array elements.
+ */
+function collectPaths(current, segments, index, results) {
+    if (current == null || typeof current !== 'object') {
+        return;
+    }
+    if (index >= segments.length) {
+        return;
+    }
+    const segment = segments[index];
+    const isLast = index === segments.length - 1;
+    if (segment === '*') {
+        // Wildcard: iterate over array elements (or object values)
+        const items = Array.isArray(current) ? current : Object.values(current);
+        for (const item of items) {
+            if (isLast) {
+                if (typeof item === 'string' && item.length > 0) {
+                    results.push(item);
+                }
+            }
+            else {
+                collectPaths(item, segments, index + 1, results);
+            }
+        }
+    }
+    else {
+        const value = current[segment];
+        if (value === undefined || value === null) {
+            return;
+        }
+        if (isLast) {
+            if (typeof value === 'string' && value.length > 0) {
+                results.push(value);
+            }
+        }
+        else {
+            collectPaths(value, segments, index + 1, results);
+        }
+    }
+}
+//# sourceMappingURL=asset-query.js.map

package/dist/cjs/operations/content/asset-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-query.js","sourceRoot":"","sources":["../../../../src/operations/content/asset-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA6B,EAAE,OAAiB;IAChF,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,OAAgB,EAAE,QAAkB,EAAE,KAAa,EAAE,OAAiB;IAC1F,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE7C,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,2DAA2D;QAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAkC,CAAC,CAAC;QACnG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/operations/content/export.d.ts

@@ -0,0 +1,57 @@
+import type { B2CInstance } from '../../instance/index.js';
+import type { FetchContentLibraryOptions, FetchContentLibraryResult, ContentExportOptions, ContentExportResult } from './types.js';
+/**
+ * Fetch and parse a content library from an instance (or local file).
+ *
+ * Returns the parsed Library and optionally the raw archive data.
+ * No filesystem side effects.
+ *
+ * @param instance - B2C instance to fetch from
+ * @param libraryId - Library ID (or site ID if isSiteLibrary is true)
+ * @param options - Fetch options
+ * @returns Parsed library and optional archive data
+ *
+ * @example
+ * ```typescript
+ * // Fetch from instance
+ * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
+ *
+ * // Filter and traverse
+ * library.filter(n => n.id === 'homepage');
+ * const xml = await library.toXMLString({ traverseHidden: false });
+ *
+ * // Use local file instead
+ * const { library } = await fetchContentLibrary(instance, 'SharedLibrary', {
+ *   libraryFile: './library.xml'
+ * });
+ * ```
+ */
+export declare function fetchContentLibrary(instance: B2CInstance, libraryId: string, options?: FetchContentLibraryOptions): Promise<FetchContentLibraryResult>;
+/**
+ * Export specific pages (with component trees and assets) to a local directory.
+ *
+ * This is a convenience function that:
+ * 1. Fetches/parses the library via {@link fetchContentLibrary}
+ * 2. Filters by page ID (exact or regex), optionally by folder
+ * 3. Downloads static assets via WebDAV (concurrent, with progress)
+ * 4. Writes filtered XML and assets to the output directory
+ *
+ * @param instance - B2C instance
+ * @param pageIds - Page content IDs to export
+ * @param libraryId - Library ID (or site ID if isSiteLibrary)
+ * @param outputPath - Output directory path
+ * @param options - Export options
+ * @returns Export result with statistics
+ *
+ * @example
+ * ```typescript
+ * const result = await exportContent(
+ *   instance,
+ *   ['homepage', 'about-us'],
+ *   'SharedLibrary',
+ *   './export',
+ * );
+ * console.log(`Exported ${result.pageCount} pages, ${result.componentCount} components`);
+ * ```
+ */
+export declare function exportContent(instance: B2CInstance, pageIds: string[], libraryId: string, outputPath: string, options?: ContentExportOptions): Promise<ContentExportResult>;

package/dist/cjs/operations/content/export.js

@@ -0,0 +1,224 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import { getLogger } from '../../logging/logger.js';
+import { siteArchiveExport } from '../jobs/site-archive.js';
+import { Library } from './library.js';
+/**
+ * Fetch and parse a content library from an instance (or local file).
+ *
+ * Returns the parsed Library and optionally the raw archive data.
+ * No filesystem side effects.
+ *
+ * @param instance - B2C instance to fetch from
+ * @param libraryId - Library ID (or site ID if isSiteLibrary is true)
+ * @param options - Fetch options
+ * @returns Parsed library and optional archive data
+ *
+ * @example
+ * ```typescript
+ * // Fetch from instance
+ * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
+ *
+ * // Filter and traverse
+ * library.filter(n => n.id === 'homepage');
+ * const xml = await library.toXMLString({ traverseHidden: false });
+ *
+ * // Use local file instead
+ * const { library } = await fetchContentLibrary(instance, 'SharedLibrary', {
+ *   libraryFile: './library.xml'
+ * });
+ * ```
+ */
+export async function fetchContentLibrary(instance, libraryId, options = {}) {
+    const logger = getLogger();
+    const { libraryFile, isSiteLibrary = false, assetQuery = ['image.path'], keepOrphans = false, waitOptions } = options;
+    const libraryEntry = isSiteLibrary ? `sites/${libraryId}/library/library.xml` : `libraries/${libraryId}/library.xml`;
+    let libraryXML;
+    let archiveData;
+    if (libraryFile) {
+        logger.info({ libraryFile }, `Reading library from local file: ${libraryFile}`);
+        libraryXML = await fs.promises.readFile(libraryFile, 'utf8');
+    }
+    else {
+        logger.info({ libraryId, isSiteLibrary, hostname: instance.config.hostname }, `Exporting library ${libraryId} from ${instance.config.hostname}...`);
+        const dataUnits = isSiteLibrary ? { sites: { [libraryId]: { content: true } } } : { libraries: { [libraryId]: true } };
+        const result = await siteArchiveExport(instance, dataUnits, { waitOptions });
+        if (!result.data) {
+            throw new Error('No archive data returned from export');
+        }
+        archiveData = result.data;
+        const zip = await JSZip.loadAsync(result.data);
+        // Find the library XML in the archive (it's nested under a timestamped directory)
+        let libraryFile_ = null;
+        for (const [filePath, entry] of Object.entries(zip.files)) {
+            if (filePath.endsWith(libraryEntry)) {
+                libraryFile_ = entry;
+                break;
+            }
+        }
+        if (!libraryFile_) {
+            throw new Error(`Library ${libraryId} not found in archive; for non-shared libraries use the --site-library option`);
+        }
+        libraryXML = await libraryFile_.async('string');
+    }
+    logger.debug('Parsing library content...');
+    const library = await Library.parse(libraryXML, { assetQuery, keepOrphans });
+    return { library, archiveData };
+}
+/**
+ * Export specific pages (with component trees and assets) to a local directory.
+ *
+ * This is a convenience function that:
+ * 1. Fetches/parses the library via {@link fetchContentLibrary}
+ * 2. Filters by page ID (exact or regex), optionally by folder
+ * 3. Downloads static assets via WebDAV (concurrent, with progress)
+ * 4. Writes filtered XML and assets to the output directory
+ *
+ * @param instance - B2C instance
+ * @param pageIds - Page content IDs to export
+ * @param libraryId - Library ID (or site ID if isSiteLibrary)
+ * @param outputPath - Output directory path
+ * @param options - Export options
+ * @returns Export result with statistics
+ *
+ * @example
+ * ```typescript
+ * const result = await exportContent(
+ *   instance,
+ *   ['homepage', 'about-us'],
+ *   'SharedLibrary',
+ *   './export',
+ * );
+ * console.log(`Exported ${result.pageCount} pages, ${result.componentCount} components`);
+ * ```
+ */
+export async function exportContent(instance, pageIds, libraryId, outputPath, options = {}) {
+    const logger = getLogger();
+    const { isSiteLibrary = false, assetQuery = ['image.path'], libraryFile, offline = false, folders = [], regex = false, keepOrphans = false, waitOptions, onAssetProgress, } = options;
+    // Step 1: Fetch and parse library
+    const { library } = await fetchContentLibrary(instance, libraryId, {
+        libraryFile,
+        isSiteLibrary,
+        assetQuery,
+        keepOrphans,
+        waitOptions,
+    });
+    // Step 2: Build matchers from content IDs
+    const matchers = regex ? pageIds.map((p) => new RegExp(p)) : pageIds;
+    function matchesId(id) {
+        return matchers.some((matcher) => (matcher instanceof RegExp ? matcher.test(id) : id === matcher));
+    }
+    // Step 3: Filter root children (pages/content) by ID and optionally by folder
+    library.filter((node) => {
+        if (node.type !== 'PAGE' && node.type !== 'CONTENT') {
+            return false;
+        }
+        if (!matchesId(node.id)) {
+            return false;
+        }
+        // Optional folder filtering
+        if (folders.length > 0) {
+            const xmlData = node.xml;
+            if (!xmlData)
+                return false;
+            const folderLinks = xmlData['folder-links'];
+            const classificationLink = folderLinks?.find((l) => l['classification-link']?.[0]);
+            const folderId = classificationLink?.['classification-link']?.[0]?.['$']?.['folder-id'];
+            if (!folderId || !folders.includes(folderId)) {
+                return false;
+            }
+        }
+        return true;
+    });
+    // Step 3b: Promote matching components to root level
+    const allNodes = [...library.nodes({ traverseHidden: true, callbackHidden: true })];
+    for (const node of allNodes) {
+        if (node.type === 'COMPONENT' && matchesId(node.id)) {
+            library.promoteToRoot(node);
+        }
+    }
+    // Step 4: Count pages, content, and components
+    let pageCount = 0;
+    let contentCount = 0;
+    let componentCount = 0;
+    library.traverse((node) => {
+        if (node.type === 'PAGE')
+            pageCount++;
+        else if (node.type === 'CONTENT')
+            contentCount++;
+        else if (node.type === 'COMPONENT')
+            componentCount++;
+    }, { traverseHidden: false });
+    // Step 5: Collect static asset paths
+    const filesToDownload = new Set();
+    library.traverse((node) => {
+        if (node.type === 'STATIC') {
+            filesToDownload.add(node.id);
+        }
+    }, { traverseHidden: false });
+    // Step 6: Generate output structure
+    const libraryEntry = isSiteLibrary ? `sites/${libraryId}/library/library.xml` : `libraries/${libraryId}/library.xml`;
+    const downloadedAssets = [];
+    const failedAssets = [];
+    // Step 7: Download assets (unless offline)
+    if (!offline && filesToDownload.size > 0) {
+        logger.info({ count: filesToDownload.size }, `Downloading ${filesToDownload.size} asset(s)...`);
+        const assetArray = [...filesToDownload];
+        const concurrency = 5;
+        // Process assets with limited concurrency
+        for (let i = 0; i < assetArray.length; i += concurrency) {
+            const batch = assetArray.slice(i, i + concurrency);
+            const results = await Promise.allSettled(batch.map(async (filename) => {
+                const cleanFilename = filename.startsWith('/') ? filename.slice(1) : filename;
+                const webdavPath = isSiteLibrary
+                    ? `Libraries/${libraryId}/default/${cleanFilename}`
+                    : `Libraries/${libraryId}/default/${cleanFilename}`;
+                logger.debug({ filename: cleanFilename }, `Downloading ${cleanFilename}`);
+                const data = await instance.webdav.get(webdavPath);
+                // Write to output directory
+                const outputFilePath = isSiteLibrary
+                    ? path.join(outputPath, 'sites', libraryId, 'library', 'static', 'default', cleanFilename)
+                    : path.join(outputPath, 'libraries', libraryId, 'static', 'default', cleanFilename);
+                await fs.promises.mkdir(path.dirname(outputFilePath), { recursive: true });
+                await fs.promises.writeFile(outputFilePath, Buffer.from(data));
+                return cleanFilename;
+            }));
+            for (let j = 0; j < results.length; j++) {
+                const result = results[j];
+                const filename = batch[j];
+                const idx = i + j;
+                if (result.status === 'fulfilled') {
+                    downloadedAssets.push(result.value);
+                    onAssetProgress?.(filename, idx, assetArray.length, true);
+                }
+                else {
+                    const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                    logger.warn({ filename, error: errorMessage }, `Failed to download asset: ${filename}`);
+                    failedAssets.push({ path: filename, error: errorMessage });
+                    onAssetProgress?.(filename, idx, assetArray.length, false);
+                }
+            }
+        }
+    }
+    // Step 8: Write filtered library XML
+    const xmlString = await library.toXMLString({ traverseHidden: false });
+    const xmlOutputPath = path.join(outputPath, libraryEntry);
+    await fs.promises.mkdir(path.dirname(xmlOutputPath), { recursive: true });
+    await fs.promises.writeFile(xmlOutputPath, xmlString, 'utf8');
+    return {
+        library,
+        outputPath,
+        downloadedAssets,
+        failedAssets,
+        pageCount,
+        contentCount,
+        componentCount,
+    };
+}
+//# sourceMappingURL=export.js.map

package/dist/cjs/operations/content/export.js.map

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

package/dist/cjs/operations/content/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Content library operations for B2C Commerce.
+ *
+ * This module provides functions for exporting and manipulating
+ * Page Designer content libraries including pages, components, and assets.
+ *
+ * ## Core Classes
+ *
+ * - {@link Library} - Parse and manipulate content library trees
+ * - {@link LibraryNode} - Individual nodes in the library tree
+ *
+ * ## Operations
+ *
+ * - {@link fetchContentLibrary} - Fetch and parse a content library
+ * - {@link exportContent} - Export filtered pages with assets to disk
+ *
+ * ## Utilities
+ *
+ * - {@link extractAssetPaths} - Extract asset paths from component JSON data
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {
+ *   Library,
+ *   fetchContentLibrary,
+ *   exportContent,
+ * } from '@salesforce/b2c-tooling-sdk/operations/content';
+ *
+ * // Fetch and filter a library
+ * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
+ * library.filter(n => n.id === 'homepage');
+ *
+ * // Or use the high-level export
+ * const result = await exportContent(instance, ['homepage'], 'SharedLibrary', './export');
+ * ```
+ *
+ * @module operations/content
+ */
+export { Library, LibraryNode } from './library.js';
+export { extractAssetPaths } from './asset-query.js';
+export { fetchContentLibrary, exportContent } from './export.js';
+export type { ColorizeFn, ContentExportOptions, ContentExportResult, FetchContentLibraryOptions, FetchContentLibraryResult, FilterCallback, LibraryNodeType, LibraryParseOptions, TraverseCallback, TraverseOptions, TreeStringOptions, } from './types.js';

package/dist/cjs/operations/content/index.js

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Content library operations for B2C Commerce.
+ *
+ * This module provides functions for exporting and manipulating
+ * Page Designer content libraries including pages, components, and assets.
+ *
+ * ## Core Classes
+ *
+ * - {@link Library} - Parse and manipulate content library trees
+ * - {@link LibraryNode} - Individual nodes in the library tree
+ *
+ * ## Operations
+ *
+ * - {@link fetchContentLibrary} - Fetch and parse a content library
+ * - {@link exportContent} - Export filtered pages with assets to disk
+ *
+ * ## Utilities
+ *
+ * - {@link extractAssetPaths} - Extract asset paths from component JSON data
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {
+ *   Library,
+ *   fetchContentLibrary,
+ *   exportContent,
+ * } from '@salesforce/b2c-tooling-sdk/operations/content';
+ *
+ * // Fetch and filter a library
+ * const { library } = await fetchContentLibrary(instance, 'SharedLibrary');
+ * library.filter(n => n.id === 'homepage');
+ *
+ * // Or use the high-level export
+ * const result = await exportContent(instance, ['homepage'], 'SharedLibrary', './export');
+ * ```
+ *
+ * @module operations/content
+ */
+export { Library, LibraryNode } from './library.js';
+export { extractAssetPaths } from './asset-query.js';
+export { fetchContentLibrary, exportContent } from './export.js';
+//# sourceMappingURL=index.js.map

package/dist/cjs/operations/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/content/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAC,OAAO,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAElD,OAAO,EAAC,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,mBAAmB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC"}