@salesforce/b2c-tooling-sdk 1.24.2 → 2.0.0

package/dist/esm/guidance/markdown.js

@@ -0,0 +1,52 @@
+/*
+ * 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
+ */
+/** Stable ATX heading IDs, excluding frontmatter and fenced code examples. */
+export function guidanceHeadings(content) {
+    const headings = [];
+    const used = new Set();
+    let offset = 0;
+    let fence;
+    let frontmatter = content.startsWith('---\n') || content.startsWith('---\r\n');
+    for (const line of content.split(/(?<=\n)/)) {
+        const trimmed = line.trim();
+        if (frontmatter) {
+            if (offset > 0 && trimmed === '---')
+                frontmatter = false;
+        }
+        else {
+            const marker = /^ {0,3}(`{3,}|~{3,})/.exec(line)?.[1];
+            if (fence) {
+                if (marker?.[0] === fence[0] && marker.length >= fence.length && trimmed === marker)
+                    fence = undefined;
+            }
+            else if (marker) {
+                fence = marker;
+            }
+            else {
+                const match = /^ {0,3}(#{1,6})\s+(.+?)(?:\s+#+)?\s*$/.exec(line);
+                if (match) {
+                    const title = match[2];
+                    const base = title
+                        .toLowerCase()
+                        .replace(/[^\p{L}\p{N}\s_-]/gu, '')
+                        .replace(/\s+/g, '-') || 'section';
+                    let id = base;
+                    let suffix = 0;
+                    while (used.has(id))
+                        id = `${base}-${++suffix}`;
+                    used.add(id);
+                    headings.push({ id, title, level: match[1].length, start: offset, end: content.length });
+                }
+            }
+        }
+        offset += line.length;
+    }
+    for (const [index, heading] of headings.entries()) {
+        heading.end = headings.slice(index + 1).find((next) => next.level <= heading.level)?.start ?? content.length;
+    }
+    return headings;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/esm/guidance/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/guidance/markdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAAyB,CAAC;IAC9B,IAAI,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK;gBAAE,WAAW,GAAG,KAAK,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,OAAO,KAAK,MAAM;oBAAE,KAAK,GAAG,SAAS,CAAC;YACzG,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,uCAAuC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjE,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACvB,MAAM,IAAI,GACR,KAAK;yBACF,WAAW,EAAE;yBACb,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;yBAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;oBACvC,IAAI,EAAE,GAAG,IAAI,CAAC;oBACd,IAAI,MAAM,GAAG,CAAC,CAAC;oBACf,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBAAE,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;oBAChD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACb,QAAQ,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,EAAC,CAAC,CAAC;gBACzF,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAC/G,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/esm/guidance/types.d.ts

@@ -0,0 +1,92 @@
+/** Authored source collection, independent of native plugin installation. */
+export interface GuidanceCollection {
+    id: string;
+    title: string;
+    isGA: boolean;
+    workspaces?: string[];
+}
+/** Inventoried Markdown file. Hashes cover the exact shipped UTF-8 bytes. */
+export interface GuidanceFile {
+    path: string;
+    bytes: number;
+}
+/** One workflow entrypoint and its progressively disclosed supporting files. */
+export interface GuidanceEntry {
+    id: string;
+    collection: string;
+    title: string;
+    description: string;
+    entrypoint: string;
+    /** Advertise this entrypoint individually in resources/list. Does not restrict reads. */
+    featured?: boolean;
+    source: string;
+    headings: string;
+    files: GuidanceFile[];
+}
+/** Deterministic distribution manifest; no absolute source paths or timestamps. */
+export interface GuidanceManifest {
+    version: 1;
+    collections: GuidanceCollection[];
+    entries: GuidanceEntry[];
+}
+/** List/search pagination and exact file or section selectors with optional slicing. */
+export interface GuidanceRequest {
+    id?: string;
+    uri?: string;
+    file?: string;
+    section?: string;
+    query?: string;
+    collection?: string;
+    workspace?: string | string[];
+    limit?: number;
+    offset?: number;
+    maxLength?: number;
+}
+/** Compact discovery entry; supporting files appear only when reading. */
+export interface GuidanceSummary {
+    id: string;
+    title: string;
+    description: string;
+    /** Readable through the resource template, whether or not individually advertised. */
+    uri: string;
+    score?: number;
+}
+/** Bounded directory or ranked search page. */
+export interface GuidancePage {
+    kind: 'directory' | 'search';
+    collections: GuidanceCollection[];
+    entries: GuidanceSummary[];
+    total: number;
+    offset: number;
+    nextOffset?: number;
+}
+/** Skill content with explicit position and length within the selected file or section. */
+export interface GuidanceRead {
+    kind: 'read';
+    id: string;
+    /** Readable through the resource template, whether or not individually advertised. */
+    uri: string;
+    source: string;
+    content: string;
+    totalLength: number;
+    offset: number;
+    truncated?: boolean;
+    nextOffset?: number;
+    sections: {
+        id: string;
+        title: string;
+    }[];
+    references: string[];
+}
+/** Guidance errors are safe for clients and contain no host filesystem paths. */
+export declare class GuidanceError extends Error {
+    readonly code: string;
+    readonly sections?: {
+        id: string;
+        title: string;
+    }[] | undefined;
+    constructor(code: string, message: string, sections?: {
+        id: string;
+        title: string;
+    }[] | undefined);
+}

package/dist/esm/guidance/types.js

@@ -0,0 +1,17 @@
+/*
+ * 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
+ */
+/** Guidance errors are safe for clients and contain no host filesystem paths. */
+export class GuidanceError extends Error {
+    code;
+    sections;
+    constructor(code, message, sections) {
+        super(message);
+        this.code = code;
+        this.sections = sections;
+        this.name = 'GuidanceError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/guidance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/guidance/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuFH,iFAAiF;AACjF,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,QAAwC;QAExD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,aAAQ,GAAR,QAAQ,CAAgC;QAGxD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -3,17 +3,26 @@ export type { Logger, LoggerOptions, LogLevel, LogContext } from './logging/inde
 export { t, setLanguage, getLanguage, getI18nInstance, registerTranslations, B2C_NAMESPACE } from './i18n/index.js';
 export type { TOptions } from './i18n/index.js';
 export { loadDwJson, findDwJson, resolveConfig, ConfigResolver, createConfigResolver } from './config/index.js';
-export type { DwJsonConfig, DwJsonMultiConfig, LoadDwJsonOptions, NormalizedConfig, ResolvedB2CConfig, ConfigWarning, ConfigWarningCode, ConfigSourceInfo, ConfigSource, ResolveConfigOptions, CreateOAuthOptions, } from './config/index.js';
+export type { DwJsonConfig, DwJsonMultiConfig, LoadDwJsonOptions, NormalizedConfig, ResolvedB2CConfig, ConfigWarning, ConfigWarningCode, ConfigSourceInfo, ConfigSource, ResolveConfigOptions, CreateOAuthOptions, CreateB2CInstanceOptions, } from './config/index.js';
 export { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, PkceOAuthStrategy, JwtOAuthStrategy, ApiKeyStrategy, decodeJWT, resolveAuthStrategy, checkAvailableAuthMethods, ALL_AUTH_METHODS, } from './auth/index.js';
 export type { AuthStrategy, AccessTokenResponse, DecodedJWT, OAuthConfig, ImplicitOAuthConfig, PkceOAuthConfig, JwtOAuthConfig, AuthConfig, BasicAuthConfig, OAuthAuthConfig, ApiKeyAuthConfig, AuthMethod, AuthCredentials, ResolveAuthStrategyOptions, AvailableAuthMethods, } from './auth/index.js';
 export { B2CInstance } from './instance/index.js';
-export type { InstanceConfig } from './instance/index.js';
-export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createPreferencesClient, createGranularReplicationsClient, createCipClient, createMetricsClient, METRICS_DEFAULT_SCOPES, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, PREFERENCES_READ_SCOPES, PREFERENCES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
+export type { B2CInstanceOptions, InstanceConfig, ScapiClientConfig } from './instance/index.js';
+export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createPreferencesClient, createGranularReplicationsClient, createCipClient, createMetricsClient, METRICS_DEFAULT_SCOPES, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isOcapiDeprecatedFault, throwOcapiError, OcapiDeprecatedError, OCAPI_DEPRECATED_MESSAGE, ocapiDeprecatedMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, PREFERENCES_READ_SCOPES, PREFERENCES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
 export type { PropfindEntry, ExtraParamsConfig, OcapiClient, OcapiError, OcapiResponse, OcapiPaths, OcapiComponents, SlasClient, SlasClientConfig, SlasError, SlasResponse, SlasPaths, SlasComponents, OdsClient, OdsClientConfig, OdsError, OdsResponse, OdsPaths, OdsComponents, CustomApisClient, CustomApisClientConfig, CustomApisError, CustomApisResponse, CustomApisPaths, CustomApisComponents, AccountManagerUsersClient, AccountManagerClientConfig, AccountManagerUser, AccountManagerResponse, AccountManagerError, UserCreate, UserUpdate, UserCollection, UserState, UserExpandOption, AccountManagerRolesClient, AccountManagerRole, AccountManagerRolesResponse, AccountManagerRolesError, RoleCollection, ListRolesOptions, RoleMapping, OrgMapping, AccountManagerApiClientsClient, AccountManagerApiClient, APIClientCreate, APIClientUpdate, APIClientCollection, ApiClientExpandOption, ListApiClientsOptions, AccountManagerOrgsClient, AccountManagerOrganization, OrganizationCollection, ListOrgsOptions, CdnZonesClient, CdnZonesClientConfig, CdnZonesClientOptions, CdnZonesError, CdnZonesResponse, Zone, ZonesEnvelope, CdnZonesPaths, CdnZonesComponents, PreferencesClient, PreferencesClientConfig, PreferencesClientOptions, PreferencesError, PreferencesResponse, PreferenceInstanceType, CustomPreference, CustomPreferenceList, OrganizationPreferences, SitePreferences, PreferenceValue, PreferenceValueSearchResult, PreferencesSearchRequest, PreferencesPaths, PreferencesComponents, GranularReplicationsClient, GranularReplicationsClientConfig, GranularReplicationsError, GranularReplicationsResponse, ProductItem, PriceTableItem, ContentAssetItemPrivate, ContentAssetItemShared, PublishProcessResponse, PublishProcessListResponse, PublishIdResponse, GranularReplicationsPaths, GranularReplicationsComponents, CipClient, CipClientConfig, CipColumn, CipExecuteResponse, CipFetchResponse, CipFrame, CipQueryOptions, CipQueryResult, MetricsClient, MetricsClientConfig, MetricsResponse, MetricsDataResponse, Metric, MetricDataSeries, MetricDataPoint, MetricsError, } from './clients/index.js';
 export { findCartridges, listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, findAndDeployCartridges, uploadCartridges, deleteCartridges, watchCartridges, } from './operations/code/index.js';
 export type { CartridgeMapping, FindCartridgesOptions, CodeVersion, CodeVersionActivationResult, CodeVersionResult, DeployOptions, DeployResult, WatchOptions, WatchResult, } from './operations/code/index.js';
-export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, siteArchiveImport, siteArchiveExport, siteArchiveExportToPath, } from './operations/jobs/index.js';
-export type { JobExecution, JobStepExecution, JobExecutionStatus, JobExecutionParameter, ExecuteJobOptions, WaitForJobOptions, WaitForJobPollInfo, SearchJobExecutionsOptions, JobExecutionSearchResult, SiteArchiveImportOptions, SiteArchiveImportResult, SiteArchiveExportOptions, SiteArchiveExportResult, ExportDataUnitsConfiguration, ExportSitesConfiguration, ExportGlobalDataConfiguration, } from './operations/jobs/index.js';
+export { createScriptsBackend, OcapiScriptsBackend, ScapiScriptsBackend } from './operations/code/index.js';
+export type { ScriptsBackend, ScriptsBackendConfig, CodeVersionInfo, ScapiScriptsBackendConfig, } from './operations/code/index.js';
+export { createUsersBackend, OcapiUsersBackend, ScapiUsersBackend } from './operations/bm-users/index.js';
+export type { UsersBackend, UsersBackendConfig, UserInfo, ListUsersResult, ListUsersOptions, SearchUsersOptions, CreateUserInput, UpdateUserChanges, ScapiUsersBackendConfig, } from './operations/bm-users/index.js';
+export { createRolesBackend, OcapiRolesBackend, ScapiRolesBackend } from './operations/bm-roles/index.js';
+export type { RolesBackend, RolesBackendConfig, RoleInfo, RolePermissionsInfo, ListRolesResult, ListRolesOptions as ListBmRolesScopedOptions, CreateRoleInput, ScapiRolesBackendConfig, } from './operations/bm-roles/index.js';
+export { createCatalogsBackend, OcapiCatalogsBackend, ScapiCatalogsBackend } from './operations/catalogs/index.js';
+export type { CatalogsBackend, CatalogsBackendConfig, CatalogInfo, ListCatalogsOptions, ScapiCatalogsBackendConfig, } from './operations/catalogs/index.js';
+export { createJobsCompatibilityBackend, JobsCompatibilityBackend } from './compat/index.js';
+export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, siteArchiveImport, siteArchiveExport, siteArchiveExportToPath, scapiExecuteJob, scapiGetJobExecution, scapiSearchJobExecutions, scapiDeleteJobExecution, scapiGetJobLog, waitForJobExecution, CanonicalJobExecutionError, } from './operations/jobs/index.js';
+export type { JobExecution, JobStepExecution, JobExecutionStatus, JobExecutionParameter, ExecuteJobOptions, WaitForJobOptions, WaitForJobPollInfo, SearchJobExecutionsOptions, JobExecutionSearchResult, JobExecutionInfo, JobStepExecutionResult, JobExecutionSearchResults, ExecuteJobScapiOptions, SearchJobExecutionsScapiOptions, SiteArchiveImportOptions, SiteArchiveImportResult, SiteArchiveExportOptions, SiteArchiveExportResult, ExportDataUnitsConfiguration, ExportSitesConfiguration, ExportGlobalDataConfiguration, } from './operations/jobs/index.js';
 export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex, listSchemas, readSchema, readSchemaByQuery, searchSchemas, downloadDocs, } from './docs/index.js';
 export type { DocEntry, SearchIndex, SearchResult, SchemaEntry, SchemaIndex, SchemaSearchResult, DownloadDocsOptions, DownloadDocsResult, } from './docs/index.js';
 export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, waitForClone, ClonePollingTimeoutError, ClonePollingError, CloneFailedError, buildSandboxSettings, DEFAULT_OCAPI_RESOURCES, DEFAULT_WEBDAV_PERMISSIONS, waitForClones, CloneBatchPollingTimeoutError, CloneBatchPollingError, CloneBatchFailedError, } from './operations/ods/index.js';

package/dist/esm/index.js

@@ -13,11 +13,23 @@ export { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, PkceOAuthStrat
 // Context Layer - Instance
 export { B2CInstance } from './instance/index.js';
 // Clients
-export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createPreferencesClient, createGranularReplicationsClient, createCipClient, createMetricsClient, METRICS_DEFAULT_SCOPES, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, PREFERENCES_READ_SCOPES, PREFERENCES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
+export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createPreferencesClient, createGranularReplicationsClient, createCipClient, createMetricsClient, METRICS_DEFAULT_SCOPES, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isOcapiDeprecatedFault, throwOcapiError, OcapiDeprecatedError, OCAPI_DEPRECATED_MESSAGE, ocapiDeprecatedMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, PREFERENCES_READ_SCOPES, PREFERENCES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
 // Operations - Code
 export { findCartridges, listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, findAndDeployCartridges, uploadCartridges, deleteCartridges, watchCartridges, } from './operations/code/index.js';
+// Scripts (code versions) backend abstraction
+export { createScriptsBackend, OcapiScriptsBackend, ScapiScriptsBackend } from './operations/code/index.js';
+// Users (BM) backend abstraction
+export { createUsersBackend, OcapiUsersBackend, ScapiUsersBackend } from './operations/bm-users/index.js';
+// Roles (BM) backend abstraction
+export { createRolesBackend, OcapiRolesBackend, ScapiRolesBackend } from './operations/bm-roles/index.js';
+// Catalog backend abstraction
+export { createCatalogsBackend, OcapiCatalogsBackend, ScapiCatalogsBackend } from './operations/catalogs/index.js';
+// Explicit transitional fallback surfaces
+export { createJobsCompatibilityBackend, JobsCompatibilityBackend } from './compat/index.js';
 // Operations - Jobs
-export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, siteArchiveImport, siteArchiveExport, siteArchiveExportToPath, } from './operations/jobs/index.js';
+export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, siteArchiveImport, siteArchiveExport, siteArchiveExportToPath, 
+// Canonical surface (SCAPI free functions + canonical helpers)
+scapiExecuteJob, scapiGetJobExecution, scapiSearchJobExecutions, scapiDeleteJobExecution, scapiGetJobLog, waitForJobExecution, CanonicalJobExecutionError, } from './operations/jobs/index.js';
 // Docs - Documentation search
 export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex, listSchemas, readSchema, readSchemaByQuery, searchSchemas, downloadDocs, } from './docs/index.js';
 // Operations - ODS

package/dist/esm/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,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAmBzB,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,uBAAuB,EACvB,gCAAgC,EAChC,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AA+G5B,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;AAapC,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;AAoBpC,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,EACzB,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAOnC,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,yBAAyB,EACzB,YAAY,EACZ,aAAa,GACd,MAAM,2BAA2B,CAAC;AAiBnC,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAgBvC,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,2CAA2C;AAC3C,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,6BAA6B,EAC7B,YAAY,EACZ,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAoBnC,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,qDAAqD;AACrD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAI3B,WAAW;AACX,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,eAAe,CAAC;AAEvB,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":"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"}

package/dist/esm/instance/index.d.ts

@@ -37,10 +37,36 @@
  *
  * @module instance
  */
-import type { AuthConfig } from '../auth/types.js';
+import type { AuthConfig, AuthStrategy } from '../auth/types.js';
 import { WebDavClient } from '../clients/webdav.js';
 import { type OcapiClient } from '../clients/ocapi.js';
 import { type TlsOptions } from '../clients/tls-dispatcher.js';
+/**
+ * SCAPI connection coordinates plus an auth strategy able to request the
+ * `sfcc.*` scopes each Commerce API operation needs.
+ *
+ * Returned by {@link B2CInstance.scapiClientConfig} when — and only when — the
+ * instance carries both a shortCode and tenantId and is configured with a
+ * stateless OAuth flow (client-credentials or JWT Bearer) that can go back to
+ * Account Manager per request for arbitrary scopes. This is the single handle
+ * every SCAPI client factory consumes, so SCAPI operations need nothing beyond
+ * a {@link B2CInstance}.
+ */
+export interface ScapiClientConfig {
+    shortCode: string;
+    tenantId: string;
+    auth: AuthStrategy;
+}
+/**
+ * Optional runtime dependencies for a {@link B2CInstance}.
+ *
+ * The OAuth strategy factory lets CLI commands reuse their session-aware auth
+ * resolution (including PKCE refresh and the temporary implicit fallback)
+ * without eagerly starting browser authentication for Basic-only WebDAV work.
+ */
+export interface B2CInstanceOptions {
+    oauthStrategy?: AuthStrategy | (() => AuthStrategy);
+}
 /**
  * Instance configuration (hostname, code version, etc.)
  */
@@ -53,6 +79,22 @@ export interface InstanceConfig {
     webdavHostname?: string;
     /** TLS options for mTLS/self-signed certificate support */
     tlsOptions?: TlsOptions;
+    /**
+     * SCAPI short code (e.g. `kv7kzm78`). Required, together with {@link tenantId},
+     * to reach the Salesforce Commerce API. Populated from resolved configuration.
+     */
+    shortCode?: string;
+    /**
+     * SCAPI tenant/organization ID (e.g. `zzxy_prd`). Required, together with
+     * {@link shortCode}, to reach the Salesforce Commerce API.
+     */
+    tenantId?: string;
+    /**
+     * Backend preference for operations that support both OCAPI (legacy) and
+     * SCAPI. Defaults to `'auto'` when unset. Lets the instance answer "should
+     * this operation prefer SCAPI?" without the caller re-reading config.
+     */
+    apiBackend?: 'ocapi' | 'scapi' | 'auto';
 }
 /**
  * Represents a connection to a B2C Commerce instance.
@@ -79,20 +121,54 @@ export interface InstanceConfig {
 export declare class B2CInstance {
     readonly config: InstanceConfig;
     readonly auth: AuthConfig;
+    private readonly options;
     private _webdav?;
     private _ocapi?;
+    private _oauthStrategy?;
     /**
      * Creates a new B2CInstance.
      *
      * @param config - Instance configuration (hostname, code version)
      * @param auth - Authentication configuration
+     * @param options - Optional runtime dependencies, including a pre-resolved OAuth strategy
      */
-    constructor(config: InstanceConfig, auth: AuthConfig);
+    constructor(config: InstanceConfig, auth: AuthConfig, options?: B2CInstanceOptions);
     /**
      * The hostname to use for WebDAV operations.
      * Falls back to main hostname if not specified.
      */
     get webdavHostname(): string;
+    /**
+     * Backend preference for operations that support both OCAPI and SCAPI.
+     * Defaults to `'auto'` when not configured.
+     */
+    get apiBackend(): 'ocapi' | 'scapi' | 'auto';
+    /**
+     * SCAPI connection coordinates + a scope-flexible auth strategy, or
+     * `undefined` when this instance cannot reach SCAPI under `auto` mode.
+     *
+     * This is the forward-looking seam for the OCAPI → SCAPI transition: a SCAPI
+     * client factory (jobs, sites, scripts, …) needs only a {@link B2CInstance},
+     * not a separately-threaded shortCode/tenantId/auth bundle. When OCAPI is
+     * eventually removed, the OCAPI accessors disappear and this stays.
+     *
+     * Returns `undefined` unless **all** of the following hold:
+     *   1. `shortCode` and `tenantId` are configured, and
+     *   2. the configured OAuth flow is stateless and scope-flexible —
+     *      client-credentials (clientId + clientSecret) or JWT Bearer
+     *      (clientId + cert/key).
+     *
+     * Browser user-auth flows (Authorization Code + PKCE and deprecated
+     * implicit) are excluded on purpose because SCAPI Admin APIs currently only
+     * support system authentication. Fixed-token stored sessions are also
+     * excluded because they cannot request the `sfcc.*` scopes SCAPI needs.
+     * This is not an `auto`-only restriction —
+     * because both consumers (the dual-backend factory and the system-job runner)
+     * gate on this getter, even explicit `--api-backend scapi` cannot use SCAPI
+     * with implicit/stateful auth; it fails with a clear error naming the flow
+     * requirement. SCAPI requires client-credentials or JWT Bearer.
+     */
+    get scapiClientConfig(): ScapiClientConfig | undefined;
     /**
      * WebDAV client for file operations.
      *
@@ -135,6 +211,24 @@ export declare class B2CInstance {
      * @throws Error if no valid OAuth method is available
      */
     private getOAuthStrategy;
+    /**
+     * Builds the scope-flexible OAuth strategy used for SCAPI, or `undefined`
+     * when the configured credentials are not eligible for `auto`-mode SCAPI.
+     *
+     * Only the stateless flows qualify, because only they can request arbitrary
+     * `sfcc.*` scopes from Account Manager per call (via the cascade / additional
+     * scopes hooks the SCAPI client factories rely on):
+     *   - **client-credentials**: clientId + clientSecret.
+     *   - **JWT Bearer**: clientId + cert/key paths.
+     *
+     * Honors `authMethods` ordering, defaulting to client-credentials before JWT
+     * to match the CLI's auth priority. Returns `undefined` for implicit- or
+     * basic-only configs.
+     */
+    private buildScapiAuthStrategy;
+    /** Builds a configured non-interactive OAuth strategy for SCAPI or OCAPI. */
+    private buildSystemOAuthStrategy;
 }
 export type { AuthConfig };
 export type { TlsOptions };
+export type { AuthStrategy };

package/dist/esm/instance/index.js

@@ -1,5 +1,5 @@
 import { BasicAuthStrategy } from '../auth/basic.js';
-import { resolveAuthStrategy } from '../auth/resolve.js';
+import { resolveAuthStrategy, resolveSystemOAuthStrategy } from '../auth/resolve.js';
 import { WebDavClient } from '../clients/webdav.js';
 import { createOcapiClient } from '../clients/ocapi.js';
 import { createTlsDispatcher } from '../clients/tls-dispatcher.js';
@@ -28,17 +28,21 @@ import { createTlsDispatcher } from '../clients/tls-dispatcher.js';
 export class B2CInstance {
     config;
     auth;
+    options;
     _webdav;
     _ocapi;
+    _oauthStrategy;
     /**
      * Creates a new B2CInstance.
      *
      * @param config - Instance configuration (hostname, code version)
      * @param auth - Authentication configuration
+     * @param options - Optional runtime dependencies, including a pre-resolved OAuth strategy
      */
-    constructor(config, auth) {
+    constructor(config, auth, options = {}) {
         this.config = config;
         this.auth = auth;
+        this.options = options;
     }
     /**
      * The hostname to use for WebDAV operations.
@@ -47,6 +51,49 @@ export class B2CInstance {
     get webdavHostname() {
         return this.config.webdavHostname || this.config.hostname;
     }
+    /**
+     * Backend preference for operations that support both OCAPI and SCAPI.
+     * Defaults to `'auto'` when not configured.
+     */
+    get apiBackend() {
+        return this.config.apiBackend ?? 'auto';
+    }
+    /**
+     * SCAPI connection coordinates + a scope-flexible auth strategy, or
+     * `undefined` when this instance cannot reach SCAPI under `auto` mode.
+     *
+     * This is the forward-looking seam for the OCAPI → SCAPI transition: a SCAPI
+     * client factory (jobs, sites, scripts, …) needs only a {@link B2CInstance},
+     * not a separately-threaded shortCode/tenantId/auth bundle. When OCAPI is
+     * eventually removed, the OCAPI accessors disappear and this stays.
+     *
+     * Returns `undefined` unless **all** of the following hold:
+     *   1. `shortCode` and `tenantId` are configured, and
+     *   2. the configured OAuth flow is stateless and scope-flexible —
+     *      client-credentials (clientId + clientSecret) or JWT Bearer
+     *      (clientId + cert/key).
+     *
+     * Browser user-auth flows (Authorization Code + PKCE and deprecated
+     * implicit) are excluded on purpose because SCAPI Admin APIs currently only
+     * support system authentication. Fixed-token stored sessions are also
+     * excluded because they cannot request the `sfcc.*` scopes SCAPI needs.
+     * This is not an `auto`-only restriction —
+     * because both consumers (the dual-backend factory and the system-job runner)
+     * gate on this getter, even explicit `--api-backend scapi` cannot use SCAPI
+     * with implicit/stateful auth; it fails with a clear error naming the flow
+     * requirement. SCAPI requires client-credentials or JWT Bearer.
+     */
+    get scapiClientConfig() {
+        const { shortCode, tenantId } = this.config;
+        if (!shortCode || !tenantId) {
+            return undefined;
+        }
+        const auth = this.buildScapiAuthStrategy();
+        if (!auth) {
+            return undefined;
+        }
+        return { shortCode, tenantId, auth };
+    }
     /**
      * WebDAV client for file operations.
      *
@@ -112,6 +159,14 @@ export class B2CInstance {
      * @throws Error if no valid OAuth method is available
      */
     getOAuthStrategy() {
+        if (this._oauthStrategy) {
+            return this._oauthStrategy;
+        }
+        if (this.options.oauthStrategy) {
+            this._oauthStrategy =
+                typeof this.options.oauthStrategy === 'function' ? this.options.oauthStrategy() : this.options.oauthStrategy;
+            return this._oauthStrategy;
+        }
         if (!this.auth.oauth) {
             throw new Error('OAuth credentials required. Provide at least clientId.');
         }
@@ -124,12 +179,50 @@ export class B2CInstance {
             redirectUri: this.auth.oauth.redirectUri,
             openBrowser: this.auth.oauth.openBrowser,
         };
-        // Filter to only OAuth methods (client-credentials, user, implicit)
-        const oauthMethods = (this.auth.authMethods || ['client-credentials', 'user']).filter((m) => m === 'client-credentials' || m === 'user' || m === 'implicit');
+        // Filter to OAuth methods while preserving the configured priority. JWT
+        // is equivalent to client credentials once it has obtained an AM token,
+        // so it must remain eligible for OCAPI and WebDAV OAuth calls as well as
+        // SCAPI.
+        const oauthMethods = (this.auth.authMethods || ['client-credentials', 'jwt', 'user']).filter((m) => m === 'client-credentials' || m === 'jwt' || m === 'user' || m === 'implicit');
         if (oauthMethods.length === 0) {
             throw new Error('No OAuth methods allowed. Check authMethods configuration.');
         }
-        return resolveAuthStrategy(credentials, { allowedMethods: oauthMethods });
+        for (const method of oauthMethods) {
+            if (method === 'client-credentials' || method === 'jwt') {
+                const systemStrategy = this.buildSystemOAuthStrategy(method);
+                if (systemStrategy) {
+                    this._oauthStrategy = systemStrategy;
+                    return this._oauthStrategy;
+                }
+                continue;
+            }
+            if (credentials.clientId) {
+                this._oauthStrategy = resolveAuthStrategy(credentials, { allowedMethods: [method] });
+                return this._oauthStrategy;
+            }
+        }
+        throw new Error(`No valid OAuth method available. Allowed methods: [${oauthMethods.join(', ')}].`);
+    }
+    /**
+     * Builds the scope-flexible OAuth strategy used for SCAPI, or `undefined`
+     * when the configured credentials are not eligible for `auto`-mode SCAPI.
+     *
+     * Only the stateless flows qualify, because only they can request arbitrary
+     * `sfcc.*` scopes from Account Manager per call (via the cascade / additional
+     * scopes hooks the SCAPI client factories rely on):
+     *   - **client-credentials**: clientId + clientSecret.
+     *   - **JWT Bearer**: clientId + cert/key paths.
+     *
+     * Honors `authMethods` ordering, defaulting to client-credentials before JWT
+     * to match the CLI's auth priority. Returns `undefined` for implicit- or
+     * basic-only configs.
+     */
+    buildScapiAuthStrategy() {
+        return this.auth.oauth ? resolveSystemOAuthStrategy(this.auth.oauth, this.auth.authMethods) : undefined;
+    }
+    /** Builds a configured non-interactive OAuth strategy for SCAPI or OCAPI. */
+    buildSystemOAuthStrategy(method) {
+        return this.auth.oauth ? resolveSystemOAuthStrategy(this.auth.oauth, [method]) : undefined;
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/esm/instance/index.js.map

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

package/dist/esm/operations/bm-roles/backend.d.ts

@@ -0,0 +1,4 @@
+import type { RolesBackend } from './types.js';
+import { type DualBackendConfig } from '../../clients/dual-backend-factory.js';
+export type RolesBackendConfig = DualBackendConfig;
+export declare function createRolesBackend(config: RolesBackendConfig): RolesBackend;

package/dist/esm/operations/bm-roles/backend.js

@@ -0,0 +1,11 @@
+import { OcapiRolesBackend } from './ocapi-backend.js';
+import { ScapiRolesBackend } from './scapi-backend.js';
+import { createDualBackend } from '../../clients/dual-backend-factory.js';
+export function createRolesBackend(config) {
+    return createDualBackend(config, {
+        domainName: 'Roles',
+        Scapi: ScapiRolesBackend,
+        Ocapi: OcapiRolesBackend,
+    });
+}
+//# sourceMappingURL=backend.js.map

package/dist/esm/operations/bm-roles/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../../src/operations/bm-roles/backend.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAC,iBAAiB,EAAyB,MAAM,uCAAuC,CAAC;AAIhG,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,OAAO,iBAAiB,CAAe,MAAM,EAAE;QAC7C,UAAU,EAAE,OAAO;QACnB,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,iBAAiB;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/operations/bm-roles/index.d.ts

@@ -50,3 +50,9 @@
  */
 export { listBmRoles, getBmRole, createBmRole, deleteBmRole, grantBmRole, revokeBmRole, getBmRolePermissions, setBmRolePermissions, } from './roles.js';
 export type { BmRole, BmRoles, BmRolePermissions, ListBmRolesOptions, GetBmRoleOptions } from './roles.js';
+export { createRolesBackend } from './backend.js';
+export type { RolesBackendConfig } from './backend.js';
+export { OcapiRolesBackend } from './ocapi-backend.js';
+export { ScapiRolesBackend } from './scapi-backend.js';
+export type { ScapiRolesBackendConfig } from './scapi-backend.js';
+export type { RolesBackend, RoleInfo, RolePermissionsInfo, ListRolesResult, ListRolesOptions, CreateRoleInput, } from './types.js';

package/dist/esm/operations/bm-roles/index.js

@@ -54,4 +54,8 @@
  * @module operations/bm-roles
  */
 export { listBmRoles, getBmRole, createBmRole, deleteBmRole, grantBmRole, revokeBmRole, getBmRolePermissions, setBmRolePermissions, } from './roles.js';
+// Roles backend abstraction — supports OCAPI + SCAPI
+export { createRolesBackend } from './backend.js';
+export { OcapiRolesBackend } from './ocapi-backend.js';
+export { ScapiRolesBackend } from './scapi-backend.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/operations/bm-roles/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/bm-roles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,EACL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/bm-roles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,EACL,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAIpB,qDAAqD;AACrD,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAC"}