@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/i18n/locales/index.js

@@ -1,25 +0,0 @@
-/*
- * 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
- */
-/**
- * Locale resources for b2c-tooling.
- *
- * Each locale file exports a translation object matching the structure
- * of keys used in t() calls. English defaults are defined inline at
- * the point of use, so no en.ts is needed.
- *
- * To add a new language:
- * 1. Create a new file (e.g., fr.ts) with translations
- * 2. Import and add to the resources object below
- */
-import { de } from './de.js';
-/**
- * All locale resources for the 'b2c' namespace.
- * Keys are language codes, values are translation objects.
- */
-export const locales = {
-    de,
-};
-//# sourceMappingURL=index.js.map

package/dist/cjs/i18n/locales/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/i18n/locales/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;GAUG;AAEH,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAC;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,EAAE;CACH,CAAC"}

package/dist/cjs/index.d.ts

@@ -1,33 +0,0 @@
-export { createLogger, configureLogger, getLogger, resetLogger, createSilentLogger } from './logging/index.js';
-export type { Logger, LoggerOptions, LogLevel, LogContext } from './logging/index.js';
-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 { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, JwtOAuthStrategy, ApiKeyStrategy, decodeJWT, resolveAuthStrategy, checkAvailableAuthMethods, ALL_AUTH_METHODS, } from './auth/index.js';
-export type { AuthStrategy, AccessTokenResponse, DecodedJWT, OAuthConfig, ImplicitOAuthConfig, 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, createGranularReplicationsClient, createCipClient, 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, 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, GranularReplicationsClient, GranularReplicationsClientConfig, GranularReplicationsError, GranularReplicationsResponse, ProductItem, PriceTableItem, ContentAssetItemPrivate, ContentAssetItemShared, PublishProcessResponse, PublishProcessListResponse, PublishIdResponse, GranularReplicationsPaths, GranularReplicationsComponents, CipClient, CipClientConfig, CipColumn, CipExecuteResponse, CipFetchResponse, CipFrame, CipQueryOptions, CipQueryResult, } 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, 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 { 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, } from './operations/ods/index.js';
-export type { SandboxState, WaitForSandboxOptions, WaitForSandboxPollInfo } from './operations/ods/index.js';
-export type { CloneState, WaitForCloneOptions, WaitForClonePollInfo } from './operations/ods/index.js';
-export { buildCipReportSql, describeCipTable, executeCipReport, getCipReportByName, listCipReports, listCipTables, } from './operations/cip/index.js';
-export type { CipColumnMetadata, CipDescribeTableOptions, CipDescribeTableResult, CipListTablesOptions, CipListTablesResult, CipReportDefinition, CipReportExecutionOptions, CipReportParamType, CipReportParamDefinition, CipReportQueryExecutor, CipReportQueryResult, CipReportSqlResult, CipTableMetadata, } from './operations/cip/index.js';
-export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
-export { validateCap, commerceAppInstall, commerceAppUninstall, commerceAppPackage, discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml, readManifest, pullCommerceApps, } from './operations/cap/index.js';
-export type { CapValidationResult, CommerceAppManifest, CommerceAppInstallOptions, CommerceAppInstallResult, CommerceAppUninstallOptions, CommerceAppUninstallResult, CommerceAppPackageOptions, CommerceAppPackageResult, CommerceFeatureState, LocalCommerceApp, ListInstalledAppsOptions, ListInstalledAppsResult, PullCommerceAppsOptions, PullCommerceAppsResult, PulledApp, PullSource, } from './operations/cap/index.js';
-export { getRole, listRoles } from './operations/roles/index.js';
-export { getOrg, getOrgByName, listOrgs } from './operations/orgs/index.js';
-export { getSafetyLevel, describeSafetyLevel, checkSafetyViolation, checkLevelViolation, SafetyBlockedError, SafetyConfirmationRequired, SafetyGuard, extractJobIdFromPath, maxSafetyLevel, isValidSafetyLevel, parseSafetyLevelString, resolveEffectiveSafetyConfig, loadGlobalSafetyConfig, isValidSafetyAction, VALID_SAFETY_ACTIONS, withSafetyConfirmation, } from './safety/index.js';
-export type { SafetyLevel, SafetyConfig, SafetyConfigFragment } from './safety/index.js';
-export type { SafetyAction, SafetyRule, SafetyOperation, SafetyEvaluation, ConfirmHandler } from './safety/index.js';
-export { DEFAULT_ACCOUNT_MANAGER_HOST, DEFAULT_ODS_HOST, DEFAULT_PUBLIC_CLIENT_ID, getDefaultPublicClientId, } from './defaults.js';
-export { SDK_NAME, SDK_VERSION, SDK_USER_AGENT } from './version.js';

package/dist/cjs/index.js

@@ -1,41 +0,0 @@
-/*
- * 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
- */
-export { createLogger, configureLogger, getLogger, resetLogger, createSilentLogger } from './logging/index.js';
-// i18n
-export { t, setLanguage, getLanguage, getI18nInstance, registerTranslations, B2C_NAMESPACE } from './i18n/index.js';
-// Config
-export { loadDwJson, findDwJson, resolveConfig, ConfigResolver, createConfigResolver } from './config/index.js';
-// Auth Layer - Strategies and Resolution
-export { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, JwtOAuthStrategy, ApiKeyStrategy, decodeJWT, resolveAuthStrategy, checkAvailableAuthMethods, ALL_AUTH_METHODS, } from './auth/index.js';
-// Context Layer - Instance
-export { B2CInstance } from './instance/index.js';
-// Clients
-export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createGranularReplicationsClient, createCipClient, 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, 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';
-// Operations - Jobs
-export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, siteArchiveImport, siteArchiveExport, siteArchiveExportToPath, } 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
-export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, waitForClone, ClonePollingTimeoutError, ClonePollingError, CloneFailedError, } from './operations/ods/index.js';
-// Operations - CIP
-export { buildCipReportSql, describeCipTable, executeCipReport, getCipReportByName, listCipReports, listCipTables, } from './operations/cip/index.js';
-// Operations - Users
-export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
-// Operations - CAP (Commerce App Packages)
-export { validateCap, commerceAppInstall, commerceAppUninstall, commerceAppPackage, discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml, readManifest, pullCommerceApps, } from './operations/cap/index.js';
-// Operations - Roles
-export { getRole, listRoles } from './operations/roles/index.js';
-// Operations - Organizations
-export { getOrg, getOrgByName, listOrgs } from './operations/orgs/index.js';
-// Safety - Protection against destructive operations
-export { getSafetyLevel, describeSafetyLevel, checkSafetyViolation, checkLevelViolation, SafetyBlockedError, SafetyConfirmationRequired, SafetyGuard, extractJobIdFromPath, maxSafetyLevel, isValidSafetyLevel, parseSafetyLevelString, resolveEffectiveSafetyConfig, loadGlobalSafetyConfig, isValidSafetyAction, VALID_SAFETY_ACTIONS, withSafetyConfirmation, } from './safety/index.js';
-// Defaults
-export { DEFAULT_ACCOUNT_MANAGER_HOST, DEFAULT_ODS_HOST, DEFAULT_PUBLIC_CLIENT_ID, getDefaultPublicClientId, } 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 +0,0 @@
-{"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,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAkBzB,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,gCAAgC,EAChC,eAAe,EACf,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,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAwF5B,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;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,GACjB,MAAM,2BAA2B,CAAC;AAKnC,mBAAmB;AACnB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,2BAA2B,CAAC;AAiBnC,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,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAEvB,eAAe;AACf,OAAO,EAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAC,MAAM,cAAc,CAAC"}

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

@@ -1,136 +0,0 @@
-/**
- * B2C Instance management.
- *
- * This module provides the {@link B2CInstance} class which represents a connection
- * to a specific B2C Commerce instance. It combines instance configuration with
- * authentication to provide typed API clients.
- *
- * ## Usage
- *
- * ### From configuration (recommended)
- *
- * Use {@link resolveConfig} to load configuration from dw.json and create an instance:
- *
- * ```typescript
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig({
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   clientSecret: process.env.SFCC_CLIENT_SECRET,
- * });
- *
- * const instance = config.createB2CInstance();
- *
- * // Use typed clients
- * await instance.webdav.put('Cartridges/v1/app.zip', content);
- * const { data } = await instance.ocapi.GET('/sites', {});
- * ```
- *
- * ### Direct construction
- *
- * ```typescript
- * const instance = new B2CInstance(
- *   { hostname: 'your-sandbox.demandware.net', codeVersion: 'v1' },
- *   { oauth: { clientId: '...', clientSecret: '...' } }
- * );
- * ```
- *
- * @module instance
- */
-import type { AuthConfig } 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';
-/**
- * Instance configuration (hostname, code version, etc.)
- */
-export interface InstanceConfig {
-    /** B2C instance hostname */
-    hostname: string;
-    /** Code version for deployments */
-    codeVersion?: string;
-    /** Separate hostname for WebDAV (if different from main hostname) */
-    webdavHostname?: string;
-    /** TLS options for mTLS/self-signed certificate support */
-    tlsOptions?: TlsOptions;
-}
-/**
- * Represents a connection to a B2C Commerce instance.
- *
- * Provides lazy-loaded, typed API clients for WebDAV and OCAPI operations.
- * Authentication is handled automatically based on the configured credentials.
- *
- * @example
- * // From configuration (recommended)
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig({
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   clientSecret: process.env.SFCC_CLIENT_SECRET,
- * });
- * const instance = config.createB2CInstance();
- *
- * // WebDAV uses Basic auth if available, falls back to OAuth
- * await instance.webdav.mkcol('Cartridges/v1');
- *
- * // OCAPI always uses OAuth
- * const { data } = await instance.ocapi.GET('/sites', {});
- */
-export declare class B2CInstance {
-    readonly config: InstanceConfig;
-    readonly auth: AuthConfig;
-    private _webdav?;
-    private _ocapi?;
-    /**
-     * Creates a new B2CInstance.
-     *
-     * @param config - Instance configuration (hostname, code version)
-     * @param auth - Authentication configuration
-     */
-    constructor(config: InstanceConfig, auth: AuthConfig);
-    /**
-     * The hostname to use for WebDAV operations.
-     * Falls back to main hostname if not specified.
-     */
-    get webdavHostname(): string;
-    /**
-     * WebDAV client for file operations.
-     *
-     * Uses Basic auth if username/password are configured,
-     * otherwise falls back to OAuth.
-     *
-     * @example
-     * await instance.webdav.mkcol('Cartridges/v1');
-     * await instance.webdav.put('Cartridges/v1/app.zip', content);
-     * const entries = await instance.webdav.propfind('Cartridges');
-     */
-    get webdav(): WebDavClient;
-    /**
-     * OCAPI Data API client.
-     *
-     * Returns the openapi-fetch client directly with full type safety.
-     * Always uses OAuth authentication.
-     *
-     * @example
-     * const { data, error } = await instance.ocapi.GET('/sites', {});
-     * const { data, error } = await instance.ocapi.PATCH('/code_versions/{code_version_id}', {
-     *   params: { path: { code_version_id: 'v1' } },
-     *   body: { active: true }
-     * });
-     */
-    get ocapi(): OcapiClient;
-    /**
-     * Gets the auth strategy for WebDAV operations.
-     * Uses authMethods to determine priority, defaulting to basic then OAuth methods.
-     */
-    private getWebDavAuthStrategy;
-    /**
-     * Gets the OAuth auth strategy based on allowed methods and available credentials.
-     * Uses resolveAuthStrategy to automatically select the best OAuth method.
-     *
-     * @throws Error if no valid OAuth method is available
-     */
-    private getOAuthStrategy;
-}
-export type { AuthConfig };
-export type { TlsOptions };

package/dist/cjs/instance/index.js

@@ -1,131 +0,0 @@
-import { BasicAuthStrategy } from '../auth/basic.js';
-import { resolveAuthStrategy } from '../auth/resolve.js';
-import { WebDavClient } from '../clients/webdav.js';
-import { createOcapiClient } from '../clients/ocapi.js';
-import { createTlsDispatcher } from '../clients/tls-dispatcher.js';
-/**
- * Represents a connection to a B2C Commerce instance.
- *
- * Provides lazy-loaded, typed API clients for WebDAV and OCAPI operations.
- * Authentication is handled automatically based on the configured credentials.
- *
- * @example
- * // From configuration (recommended)
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig({
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   clientSecret: process.env.SFCC_CLIENT_SECRET,
- * });
- * const instance = config.createB2CInstance();
- *
- * // WebDAV uses Basic auth if available, falls back to OAuth
- * await instance.webdav.mkcol('Cartridges/v1');
- *
- * // OCAPI always uses OAuth
- * const { data } = await instance.ocapi.GET('/sites', {});
- */
-export class B2CInstance {
-    config;
-    auth;
-    _webdav;
-    _ocapi;
-    /**
-     * Creates a new B2CInstance.
-     *
-     * @param config - Instance configuration (hostname, code version)
-     * @param auth - Authentication configuration
-     */
-    constructor(config, auth) {
-        this.config = config;
-        this.auth = auth;
-    }
-    /**
-     * The hostname to use for WebDAV operations.
-     * Falls back to main hostname if not specified.
-     */
-    get webdavHostname() {
-        return this.config.webdavHostname || this.config.hostname;
-    }
-    /**
-     * WebDAV client for file operations.
-     *
-     * Uses Basic auth if username/password are configured,
-     * otherwise falls back to OAuth.
-     *
-     * @example
-     * await instance.webdav.mkcol('Cartridges/v1');
-     * await instance.webdav.put('Cartridges/v1/app.zip', content);
-     * const entries = await instance.webdav.propfind('Cartridges');
-     */
-    get webdav() {
-        if (!this._webdav) {
-            // Create TLS dispatcher if TLS options are configured
-            const dispatcher = this.config.tlsOptions ? createTlsDispatcher(this.config.tlsOptions) : undefined;
-            this._webdav = new WebDavClient(this.webdavHostname, this.getWebDavAuthStrategy(), {
-                dispatcher,
-            });
-        }
-        return this._webdav;
-    }
-    /**
-     * OCAPI Data API client.
-     *
-     * Returns the openapi-fetch client directly with full type safety.
-     * Always uses OAuth authentication.
-     *
-     * @example
-     * const { data, error } = await instance.ocapi.GET('/sites', {});
-     * const { data, error } = await instance.ocapi.PATCH('/code_versions/{code_version_id}', {
-     *   params: { path: { code_version_id: 'v1' } },
-     *   body: { active: true }
-     * });
-     */
-    get ocapi() {
-        if (!this._ocapi) {
-            this._ocapi = createOcapiClient(this.config.hostname, this.getOAuthStrategy());
-        }
-        return this._ocapi;
-    }
-    /**
-     * Gets the auth strategy for WebDAV operations.
-     * Uses authMethods to determine priority, defaulting to basic then OAuth methods.
-     */
-    getWebDavAuthStrategy() {
-        // For WebDAV, default priority is basic first, then OAuth methods
-        const webdavMethods = this.auth.authMethods || ['basic', 'client-credentials', 'implicit'];
-        // If basic auth is allowed and configured, use it directly
-        if (webdavMethods.includes('basic') && this.auth.basic) {
-            return new BasicAuthStrategy(this.auth.basic.username, this.auth.basic.password);
-        }
-        // Otherwise try OAuth methods
-        return this.getOAuthStrategy();
-    }
-    /**
-     * Gets the OAuth auth strategy based on allowed methods and available credentials.
-     * Uses resolveAuthStrategy to automatically select the best OAuth method.
-     *
-     * @throws Error if no valid OAuth method is available
-     */
-    getOAuthStrategy() {
-        if (!this.auth.oauth) {
-            throw new Error('OAuth credentials required. Provide at least clientId.');
-        }
-        // Build credentials for resolution
-        const credentials = {
-            clientId: this.auth.oauth.clientId,
-            clientSecret: this.auth.oauth.clientSecret,
-            scopes: this.auth.oauth.scopes,
-            accountManagerHost: this.auth.oauth.accountManagerHost,
-            redirectUri: this.auth.oauth.redirectUri,
-            openBrowser: this.auth.oauth.openBrowser,
-        };
-        // Filter to only OAuth methods (client-credentials, implicit)
-        const oauthMethods = (this.auth.authMethods || ['client-credentials', 'implicit']).filter((m) => m === 'client-credentials' || m === 'implicit');
-        if (oauthMethods.length === 0) {
-            throw new Error('No OAuth methods allowed. Check authMethods configuration.');
-        }
-        return resolveAuthStrategy(credentials, { allowedMethods: oauthMethods });
-    }
-}
-//# sourceMappingURL=index.js.map

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

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

package/dist/cjs/logging/index.d.ts

@@ -1,116 +0,0 @@
-/**
- * Structured logging module using [pino](https://github.com/pinojs/pino).
- *
- * This module provides a logging interface for library consumers. It does **not**
- * read environment variables directly—that is the responsibility of the CLI layer
- * or the consuming application.
- *
- * ## Basic Usage
- *
- * ```typescript
- * import { createLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * const logger = createLogger({ level: 'debug' });
- * logger.info('Hello world');
- * logger.debug({ file: 'data.json' }, 'Processing file');
- * ```
- *
- * ## Configuration Options
- *
- * | Option | Type | Default | Description |
- * |--------|------|---------|-------------|
- * | `level` | `LogLevel` | `'info'` | Minimum log level |
- * | `fd` | `number` | `2` | File descriptor (1=stdout, 2=stderr) |
- * | `json` | `boolean` | `false` | Output JSON lines instead of pretty print |
- * | `colorize` | `boolean` | `true` | Enable colors in pretty print mode |
- * | `redact` | `boolean` | `true` | Redact sensitive fields |
- * | `baseContext` | `object` | `{}` | Context included in all log entries |
- *
- * ## Output Modes
- *
- * **Pretty print** (default): Human-readable with colors
- * ```
- * [18:31:58] INFO: Hello world
- * ```
- *
- * **JSON lines** (`json: true`): Machine-readable for log aggregation
- * ```json
- * {"level":"info","time":1764113529411,"msg":"Hello world"}
- * ```
- *
- * ## Log Levels
- *
- * From most to least verbose: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent`
- *
- * ## Context and Child Loggers
- *
- * Add structured context to log entries:
- *
- * ```typescript
- * // Inline context
- * logger.info({ operation: 'deploy', file: 'app.zip' }, 'Starting deployment');
- *
- * // Child logger with bound context
- * const deployLogger = logger.child({ operation: 'deploy' });
- * deployLogger.info('Step 1 complete');  // Includes operation: 'deploy'
- * deployLogger.info('Step 2 complete');
- * ```
- *
- * ## Secret Redaction
- *
- * Sensitive fields are automatically redacted:
- *
- * ```typescript
- * logger.info({ username: 'admin', password: 'secret' }, 'Auth attempt');
- * // Output: { username: 'admin', password: '[REDACTED]' }
- * ```
- *
- * Redacted fields: `password`, `secret`, `token`, `client_secret`, `access_token`,
- * `refresh_token`, `api_key`, `authorization`
- *
- * ## Global Logger
- *
- * For CLI applications, use the global logger pattern:
- *
- * ```typescript
- * import { configureLogger, getLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * // Configure once at startup
- * configureLogger({
- *   level: 'debug',
- *   json: process.env.SFCC_JSON_LOGS === 'true',
- *   colorize: process.stdout.isTTY,
- * });
- *
- * // Get anywhere in your app
- * const logger = getLogger();
- * logger.info('Ready');
- * ```
- *
- * ## Library vs CLI Usage
- *
- * **Library code** should accept a logger as a parameter:
- *
- * ```typescript
- * import type { Logger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * export function myOperation(options: { logger?: Logger }) {
- *   const log = options.logger ?? console;
- *   log.info('Starting operation');
- * }
- * ```
- *
- * **CLI code** reads environment variables and passes the configured logger:
- *
- * ```typescript
- * const logger = createLogger({
- *   level: process.env.LOG_LEVEL ?? 'info',
- *   json: process.env.LOG_JSON === 'true',
- * });
- * myOperation({ logger });
- * ```
- *
- * @module logging
- */
-export type { Logger, LoggerOptions, LogLevel, LogContext, LogDestination } from './types.js';
-export { createLogger, configureLogger, getLogger, resetLogger, createSilentLogger } from './logger.js';

package/dist/cjs/logging/index.js

@@ -1,121 +0,0 @@
-/*
- * 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
- */
-/**
- * Structured logging module using [pino](https://github.com/pinojs/pino).
- *
- * This module provides a logging interface for library consumers. It does **not**
- * read environment variables directly—that is the responsibility of the CLI layer
- * or the consuming application.
- *
- * ## Basic Usage
- *
- * ```typescript
- * import { createLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * const logger = createLogger({ level: 'debug' });
- * logger.info('Hello world');
- * logger.debug({ file: 'data.json' }, 'Processing file');
- * ```
- *
- * ## Configuration Options
- *
- * | Option | Type | Default | Description |
- * |--------|------|---------|-------------|
- * | `level` | `LogLevel` | `'info'` | Minimum log level |
- * | `fd` | `number` | `2` | File descriptor (1=stdout, 2=stderr) |
- * | `json` | `boolean` | `false` | Output JSON lines instead of pretty print |
- * | `colorize` | `boolean` | `true` | Enable colors in pretty print mode |
- * | `redact` | `boolean` | `true` | Redact sensitive fields |
- * | `baseContext` | `object` | `{}` | Context included in all log entries |
- *
- * ## Output Modes
- *
- * **Pretty print** (default): Human-readable with colors
- * ```
- * [18:31:58] INFO: Hello world
- * ```
- *
- * **JSON lines** (`json: true`): Machine-readable for log aggregation
- * ```json
- * {"level":"info","time":1764113529411,"msg":"Hello world"}
- * ```
- *
- * ## Log Levels
- *
- * From most to least verbose: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent`
- *
- * ## Context and Child Loggers
- *
- * Add structured context to log entries:
- *
- * ```typescript
- * // Inline context
- * logger.info({ operation: 'deploy', file: 'app.zip' }, 'Starting deployment');
- *
- * // Child logger with bound context
- * const deployLogger = logger.child({ operation: 'deploy' });
- * deployLogger.info('Step 1 complete');  // Includes operation: 'deploy'
- * deployLogger.info('Step 2 complete');
- * ```
- *
- * ## Secret Redaction
- *
- * Sensitive fields are automatically redacted:
- *
- * ```typescript
- * logger.info({ username: 'admin', password: 'secret' }, 'Auth attempt');
- * // Output: { username: 'admin', password: '[REDACTED]' }
- * ```
- *
- * Redacted fields: `password`, `secret`, `token`, `client_secret`, `access_token`,
- * `refresh_token`, `api_key`, `authorization`
- *
- * ## Global Logger
- *
- * For CLI applications, use the global logger pattern:
- *
- * ```typescript
- * import { configureLogger, getLogger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * // Configure once at startup
- * configureLogger({
- *   level: 'debug',
- *   json: process.env.SFCC_JSON_LOGS === 'true',
- *   colorize: process.stdout.isTTY,
- * });
- *
- * // Get anywhere in your app
- * const logger = getLogger();
- * logger.info('Ready');
- * ```
- *
- * ## Library vs CLI Usage
- *
- * **Library code** should accept a logger as a parameter:
- *
- * ```typescript
- * import type { Logger } from '@salesforce/b2c-tooling-sdk/logging';
- *
- * export function myOperation(options: { logger?: Logger }) {
- *   const log = options.logger ?? console;
- *   log.info('Starting operation');
- * }
- * ```
- *
- * **CLI code** reads environment variables and passes the configured logger:
- *
- * ```typescript
- * const logger = createLogger({
- *   level: process.env.LOG_LEVEL ?? 'info',
- *   json: process.env.LOG_JSON === 'true',
- * });
- * myOperation({ logger });
- * ```
- *
- * @module logging
- */
-export { createLogger, configureLogger, getLogger, resetLogger, createSilentLogger } from './logger.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiHG;AAGH,OAAO,EAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,aAAa,CAAC"}

package/dist/cjs/logging/logger.d.ts

@@ -1,9 +0,0 @@
-/**
- * Logger using pino with pretty printing by default.
- */
-import type { Logger, LoggerOptions } from './types.js';
-export declare function createLogger(options?: LoggerOptions): Logger;
-export declare function configureLogger(options: LoggerOptions): void;
-export declare function getLogger(): Logger;
-export declare function resetLogger(): void;
-export declare function createSilentLogger(): Logger;