@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

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

@@ -1,100 +0,0 @@
-/**
- * Configuration loading utilities.
- *
- * This module provides utilities for loading B2C Commerce configuration.
- * The preferred high-level API is {@link resolveConfig}, which returns
- * a rich configuration object with factory methods.
- *
- * ## Quick Start
- *
- * ```typescript
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = await resolveConfig({
- *   hostname: process.env.SFCC_SERVER,
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   mrtApiKey: process.env.MRT_API_KEY,
- * });
- *
- * // Check what's available and create objects
- * if (config.hasB2CInstanceConfig()) {
- *   const instance = config.createB2CInstance();
- *   await instance.webdav.propfind('Cartridges');
- * }
- *
- * if (config.hasMrtConfig()) {
- *   const mrtAuth = config.createMrtAuth();
- * }
- * ```
- *
- * ## Resolution Priority
- *
- * Configuration is resolved with the following precedence (highest to lowest):
- *
- * 1. **Explicit overrides** - Values passed to `resolve()`, `createInstance()`, etc.
- * 2. **Configuration sources** - dw.json, ~/.mobify (in order)
- *
- * Later sources only fill in missing values—they do not override values from
- * higher-priority sources.
- *
- * ## Hostname Mismatch Protection
- *
- * The configuration system includes safety protection against accidentally using
- * credentials from one instance with a different hostname. When you explicitly
- * specify a hostname that differs from the dw.json hostname:
- *
- * - The entire base configuration from dw.json is ignored
- * - Only your explicit overrides are used
- * - A warning is included in the resolution result
- *
- * This prevents credential leakage between different B2C instances.
- *
- * ## Default Configuration Sources
- *
- * The default sources loaded by {@link createConfigResolver} are:
- *
- * - **dw.json** - Project configuration file, searched upward from cwd
- * - **~/.mobify** - Home directory file for MRT API key
- *
- * ## Custom Configuration Sources
- *
- * Implement the {@link ConfigSource} interface to create custom sources:
- *
- * ```typescript
- * import { ConfigResolver, type ConfigSource, type ConfigLoadResult } from '@salesforce/b2c-tooling-sdk/config';
- *
- * class MySource implements ConfigSource {
- *   name = 'my-source';
- *   load(options): ConfigLoadResult | undefined {
- *     return {
- *       config: { hostname: 'custom.example.com' },
- *       location: '/path/to/source',
- *     };
- *   }
- * }
- *
- * const resolver = new ConfigResolver([new MySource()]);
- * ```
- *
- * ## Lower-Level APIs
- *
- * For advanced use cases, you can use the lower-level dw.json loading functions:
- *
- * ```typescript
- * import { loadDwJson, findDwJson } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const dwJsonPath = findDwJson();
- * const config = loadDwJson({ path: dwJsonPath, instance: 'staging' });
- * ```
- *
- * @module config
- */
-export { resolveConfig, ConfigResolver, createConfigResolver } from './resolver.js';
-export type { MaybePromise, NormalizedConfig, LibraryEntry, ConfigSource, ConfigLoadResult, ConfigSourceInfo, ConfigResolutionResult, ConfigWarning, ConfigWarningCode, ResolveConfigOptions, ResolvedB2CConfig, CreateOAuthOptions, InstanceInfo, CreateInstanceOptions, } from './types.js';
-export { createInstanceFromConfig, normalizeConfigKeys, resolveLibraryEntries } from './mapping.js';
-export { loadDwJson, loadFullDwJson, findDwJson, saveDwJson, addInstance, removeInstance, setActiveInstance, } from './dw-json.js';
-export type { DwJsonConfig, DwJsonMultiConfig, LoadDwJsonOptions, LoadDwJsonResult, AddInstanceOptions, RemoveInstanceOptions, SetActiveInstanceOptions, } from './dw-json.js';
-export { InstanceManager, createInstanceManager } from './instance-manager.js';
-export { ConfigSourceRegistry, globalConfigSourceRegistry } from './config-source-registry.js';
-export { DwJsonSource } from './sources/dw-json-source.js';
-export { EnvSource } from './sources/env-source.js';

package/dist/cjs/config/index.js

@@ -1,110 +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
- */
-/**
- * Configuration loading utilities.
- *
- * This module provides utilities for loading B2C Commerce configuration.
- * The preferred high-level API is {@link resolveConfig}, which returns
- * a rich configuration object with factory methods.
- *
- * ## Quick Start
- *
- * ```typescript
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = await resolveConfig({
- *   hostname: process.env.SFCC_SERVER,
- *   clientId: process.env.SFCC_CLIENT_ID,
- *   mrtApiKey: process.env.MRT_API_KEY,
- * });
- *
- * // Check what's available and create objects
- * if (config.hasB2CInstanceConfig()) {
- *   const instance = config.createB2CInstance();
- *   await instance.webdav.propfind('Cartridges');
- * }
- *
- * if (config.hasMrtConfig()) {
- *   const mrtAuth = config.createMrtAuth();
- * }
- * ```
- *
- * ## Resolution Priority
- *
- * Configuration is resolved with the following precedence (highest to lowest):
- *
- * 1. **Explicit overrides** - Values passed to `resolve()`, `createInstance()`, etc.
- * 2. **Configuration sources** - dw.json, ~/.mobify (in order)
- *
- * Later sources only fill in missing values—they do not override values from
- * higher-priority sources.
- *
- * ## Hostname Mismatch Protection
- *
- * The configuration system includes safety protection against accidentally using
- * credentials from one instance with a different hostname. When you explicitly
- * specify a hostname that differs from the dw.json hostname:
- *
- * - The entire base configuration from dw.json is ignored
- * - Only your explicit overrides are used
- * - A warning is included in the resolution result
- *
- * This prevents credential leakage between different B2C instances.
- *
- * ## Default Configuration Sources
- *
- * The default sources loaded by {@link createConfigResolver} are:
- *
- * - **dw.json** - Project configuration file, searched upward from cwd
- * - **~/.mobify** - Home directory file for MRT API key
- *
- * ## Custom Configuration Sources
- *
- * Implement the {@link ConfigSource} interface to create custom sources:
- *
- * ```typescript
- * import { ConfigResolver, type ConfigSource, type ConfigLoadResult } from '@salesforce/b2c-tooling-sdk/config';
- *
- * class MySource implements ConfigSource {
- *   name = 'my-source';
- *   load(options): ConfigLoadResult | undefined {
- *     return {
- *       config: { hostname: 'custom.example.com' },
- *       location: '/path/to/source',
- *     };
- *   }
- * }
- *
- * const resolver = new ConfigResolver([new MySource()]);
- * ```
- *
- * ## Lower-Level APIs
- *
- * For advanced use cases, you can use the lower-level dw.json loading functions:
- *
- * ```typescript
- * import { loadDwJson, findDwJson } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const dwJsonPath = findDwJson();
- * const config = loadDwJson({ path: dwJsonPath, instance: 'staging' });
- * ```
- *
- * @module config
- */
-// High-level API (preferred)
-export { resolveConfig, ConfigResolver, createConfigResolver } from './resolver.js';
-// Instance creation utility (public API for CLI commands)
-export { createInstanceFromConfig, normalizeConfigKeys, resolveLibraryEntries } from './mapping.js';
-// Low-level dw.json API (still available for advanced use)
-export { loadDwJson, loadFullDwJson, findDwJson, saveDwJson, addInstance, removeInstance, setActiveInstance, } from './dw-json.js';
-// Instance management
-export { InstanceManager, createInstanceManager } from './instance-manager.js';
-// Config source registry (global, auto-included in resolveConfig)
-export { ConfigSourceRegistry, globalConfigSourceRegistry } from './config-source-registry.js';
-// Config sources (for direct use)
-export { DwJsonSource } from './sources/dw-json-source.js';
-export { EnvSource } from './sources/env-source.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AAEH,6BAA6B;AAC7B,OAAO,EAAC,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAC,MAAM,eAAe,CAAC;AAoBlF,0DAA0D;AAC1D,OAAO,EAAC,wBAAwB,EAAE,mBAAmB,EAAE,qBAAqB,EAAC,MAAM,cAAc,CAAC;AAElG,2DAA2D;AAC3D,OAAO,EACL,UAAU,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAWtB,sBAAsB;AACtB,OAAO,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAE7E,kEAAkE;AAClE,OAAO,EAAC,oBAAoB,EAAE,0BAA0B,EAAC,MAAM,6BAA6B,CAAC;AAE7F,kCAAkC;AAClC,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC"}

package/dist/cjs/config/instance-manager.d.ts

@@ -1,97 +0,0 @@
-/**
- * Instance management service.
- *
- * Aggregates instance management operations across multiple config sources.
- *
- * @module config/instance-manager
- */
-import type { ConfigSource, InstanceInfo, CreateInstanceOptions, ResolveConfigOptions, NormalizedConfig } from './types.js';
-/**
- * Service for managing B2C instances across multiple config sources.
- *
- * This class aggregates instance management operations from all sources
- * that implement the optional instance management methods.
- *
- * @example
- * ```typescript
- * import { InstanceManager, DwJsonSource } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const manager = new InstanceManager([new DwJsonSource()]);
- *
- * // List all instances
- * const instances = manager.listAllInstances();
- *
- * // Create a new instance
- * manager.createInstance({
- *   name: 'staging',
- *   config: { hostname: 'staging.example.com' },
- *   setActive: true,
- * });
- * ```
- */
-export declare class InstanceManager {
-    private readonly sources;
-    constructor(sources: ConfigSource[]);
-    /**
-     * List instances from all sources that implement listInstances().
-     *
-     * @param options - Resolution options
-     * @returns Array of all instances from all sources
-     */
-    listAllInstances(options?: ResolveConfigOptions): Promise<InstanceInfo[]>;
-    /**
-     * Get sources that can create instances.
-     *
-     * @returns Array of sources with createInstance() method
-     */
-    getInstanceSources(): ConfigSource[];
-    /**
-     * Get sources that can store a specific credential field.
-     *
-     * @param field - The credential field to check
-     * @returns Array of sources that can store the field
-     */
-    getCredentialSources(field: keyof NormalizedConfig): ConfigSource[];
-    /**
-     * Create an instance in the specified source (or default to first instance source).
-     *
-     * @param options - Instance creation options
-     * @param targetSource - Source name to use (optional, defaults to first available)
-     * @throws Error if no instance sources available or specified source not found
-     */
-    createInstance(options: CreateInstanceOptions & ResolveConfigOptions, targetSource?: string): Promise<void>;
-    /**
-     * Remove an instance from the source that contains it.
-     *
-     * @param name - Instance name to remove
-     * @param options - Resolution options
-     * @throws Error if instance not found in any source
-     */
-    removeInstance(name: string, options?: ResolveConfigOptions): Promise<void>;
-    /**
-     * Set an instance as active in the source that contains it.
-     *
-     * @param name - Instance name to set as active
-     * @param options - Resolution options
-     * @throws Error if instance not found in any source
-     */
-    setActiveInstance(name: string, options?: ResolveConfigOptions): Promise<void>;
-    /**
-     * Store a credential for an instance in the specified source.
-     *
-     * @param instanceName - Instance name
-     * @param field - Config field to store
-     * @param value - Value to store
-     * @param targetSource - Source name to use (optional)
-     * @param options - Resolution options
-     * @throws Error if no credential sources support the field
-     */
-    storeCredential(instanceName: string, field: keyof NormalizedConfig, value: string, targetSource?: string, options?: ResolveConfigOptions): Promise<void>;
-}
-/**
- * Create an InstanceManager with the given sources.
- *
- * @param sources - Config sources to use
- * @returns InstanceManager instance
- */
-export declare function createInstanceManager(sources: ConfigSource[]): InstanceManager;

package/dist/cjs/config/instance-manager.js

@@ -1,166 +0,0 @@
-/**
- * Service for managing B2C instances across multiple config sources.
- *
- * This class aggregates instance management operations from all sources
- * that implement the optional instance management methods.
- *
- * @example
- * ```typescript
- * import { InstanceManager, DwJsonSource } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const manager = new InstanceManager([new DwJsonSource()]);
- *
- * // List all instances
- * const instances = manager.listAllInstances();
- *
- * // Create a new instance
- * manager.createInstance({
- *   name: 'staging',
- *   config: { hostname: 'staging.example.com' },
- *   setActive: true,
- * });
- * ```
- */
-export class InstanceManager {
-    sources;
-    constructor(sources) {
-        this.sources = sources;
-    }
-    /**
-     * List instances from all sources that implement listInstances().
-     *
-     * @param options - Resolution options
-     * @returns Array of all instances from all sources
-     */
-    async listAllInstances(options) {
-        const allInstances = [];
-        for (const source of this.sources) {
-            if (source.listInstances) {
-                const instances = await source.listInstances(options);
-                allInstances.push(...instances);
-            }
-        }
-        return allInstances;
-    }
-    /**
-     * Get sources that can create instances.
-     *
-     * @returns Array of sources with createInstance() method
-     */
-    getInstanceSources() {
-        return this.sources.filter((s) => s.createInstance);
-    }
-    /**
-     * Get sources that can store a specific credential field.
-     *
-     * @param field - The credential field to check
-     * @returns Array of sources that can store the field
-     */
-    getCredentialSources(field) {
-        return this.sources.filter((s) => s.credentialFields?.includes(field));
-    }
-    /**
-     * Create an instance in the specified source (or default to first instance source).
-     *
-     * @param options - Instance creation options
-     * @param targetSource - Source name to use (optional, defaults to first available)
-     * @throws Error if no instance sources available or specified source not found
-     */
-    async createInstance(options, targetSource) {
-        const instanceSources = this.getInstanceSources();
-        if (instanceSources.length === 0) {
-            throw new Error('No config sources support instance creation');
-        }
-        let source;
-        if (targetSource) {
-            const found = instanceSources.find((s) => s.name === targetSource);
-            if (!found) {
-                throw new Error(`Source "${targetSource}" not found or does not support instance creation`);
-            }
-            source = found;
-        }
-        else {
-            // Default to first (highest priority) instance source
-            source = instanceSources[0];
-        }
-        await source.createInstance(options);
-    }
-    /**
-     * Remove an instance from the source that contains it.
-     *
-     * @param name - Instance name to remove
-     * @param options - Resolution options
-     * @throws Error if instance not found in any source
-     */
-    async removeInstance(name, options) {
-        // Find the source that has this instance
-        for (const source of this.sources) {
-            if (source.listInstances && source.removeInstance) {
-                const instances = await source.listInstances(options);
-                if (instances.some((i) => i.name === name)) {
-                    await source.removeInstance(name, options);
-                    return;
-                }
-            }
-        }
-        throw new Error(`Instance "${name}" not found in any source`);
-    }
-    /**
-     * Set an instance as active in the source that contains it.
-     *
-     * @param name - Instance name to set as active
-     * @param options - Resolution options
-     * @throws Error if instance not found in any source
-     */
-    async setActiveInstance(name, options) {
-        // Find the source that has this instance
-        for (const source of this.sources) {
-            if (source.listInstances && source.setActiveInstance) {
-                const instances = await source.listInstances(options);
-                if (instances.some((i) => i.name === name)) {
-                    await source.setActiveInstance(name, options);
-                    return;
-                }
-            }
-        }
-        throw new Error(`Instance "${name}" not found in any source`);
-    }
-    /**
-     * Store a credential for an instance in the specified source.
-     *
-     * @param instanceName - Instance name
-     * @param field - Config field to store
-     * @param value - Value to store
-     * @param targetSource - Source name to use (optional)
-     * @param options - Resolution options
-     * @throws Error if no credential sources support the field
-     */
-    async storeCredential(instanceName, field, value, targetSource, options) {
-        const credentialSources = this.getCredentialSources(field);
-        if (credentialSources.length === 0) {
-            throw new Error(`No config sources support storing credential field "${String(field)}"`);
-        }
-        let source;
-        if (targetSource) {
-            const found = credentialSources.find((s) => s.name === targetSource);
-            if (!found) {
-                throw new Error(`Source "${targetSource}" not found or does not support credential storage`);
-            }
-            source = found;
-        }
-        else {
-            source = credentialSources[0];
-        }
-        await source.storeCredential(instanceName, field, value, options);
-    }
-}
-/**
- * Create an InstanceManager with the given sources.
- *
- * @param sources - Config sources to use
- * @returns InstanceManager instance
- */
-export function createInstanceManager(sources) {
-    return new InstanceManager(sources);
-}
-//# sourceMappingURL=instance-manager.js.map

package/dist/cjs/config/instance-manager.js.map

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

package/dist/cjs/config/mapping.d.ts

@@ -1,199 +0,0 @@
-/**
- * Configuration mapping utilities.
- *
- * This module provides the single source of truth for mapping between
- * different configuration formats (dw.json, normalized config, etc.).
- *
- * @module config/mapping
- */
-import type { AuthConfig } from '../auth/types.js';
-import { B2CInstance } from '../instance/index.js';
-import type { DwJsonConfig } from './dw-json.js';
-import type { LibraryEntry, NormalizedConfig, ConfigWarning } from './types.js';
-/**
- * Normalizes a URL origin string by ensuring it has an `https://` protocol prefix.
- * Accepts both bare hostnames (`cloud.mobify.com`) and full URLs (`https://cloud.mobify.com`).
- * Strips trailing slashes for consistency.
- *
- * @param origin - A hostname or URL origin string
- * @returns The origin with `https://` protocol, or undefined if input is undefined
- */
-export declare function normalizeOriginUrl(origin: string | undefined): string | undefined;
-/**
- * Normalizes a {@link NormalizedConfig.libraries} value to an array of
- * {@link LibraryEntry} objects. Bare strings are treated as
- * `{id, siteLibrary: false}`. Returns an empty array when input is undefined.
- */
-export declare function resolveLibraryEntries(libraries: (string | LibraryEntry)[] | undefined): LibraryEntry[];
-/**
- * Converts a kebab-case string to camelCase.
- *
- * @param str - The kebab-case string to convert
- * @returns The camelCase equivalent
- *
- * @example
- * ```typescript
- * kebabToCamelCase('code-version'); // 'codeVersion'
- * kebabToCamelCase('client-id');    // 'clientId'
- * kebabToCamelCase('hostname');     // 'hostname' (no change)
- * ```
- */
-export declare function kebabToCamelCase(str: string): string;
-/**
- * Legacy/non-standard aliases that cannot be derived by kebab→camel conversion.
- * Maps alias → canonical camelCase field name.
- */
-export declare const CONFIG_KEY_ALIASES: Record<string, string>;
-/**
- * Normalizes config keys to canonical camelCase form.
- *
- * Resolution order for each key:
- * 1. Check CONFIG_KEY_ALIASES for legacy/non-standard names
- * 2. Fall back to kebab→camelCase conversion
- * 3. First value wins when multiple keys resolve to the same canonical name
- *
- * @param raw - The raw config object with potentially mixed key formats
- * @returns A new object with all keys in canonical camelCase
- *
- * @example
- * ```typescript
- * normalizeConfigKeys({ 'client-id': 'abc', 'code-version': 'v1' });
- * // { clientId: 'abc', codeVersion: 'v1' }
- *
- * normalizeConfigKeys({ server: 'example.com', hostname: 'other.com' });
- * // { hostname: 'example.com' } (first value wins)
- * ```
- */
-export declare function normalizeConfigKeys(raw: Record<string, unknown>): Record<string, unknown>;
-export declare function mapDwJsonToNormalizedConfig(json: DwJsonConfig): NormalizedConfig;
-/**
- * Maps normalized config to dw.json format.
- *
- * This is the reverse of mapDwJsonToNormalizedConfig. It converts normalized
- * config (camelCase) back to dw.json format (kebab-case).
- *
- * @param config - The normalized configuration
- * @param name - Optional instance name to include
- * @returns DwJsonConfig structure
- *
- * @example
- * ```typescript
- * const config = { hostname: 'example.com', codeVersion: 'v1', clientId: 'abc' };
- * const dwJson = mapNormalizedConfigToDwJson(config, 'staging');
- * // { name: 'staging', hostname: 'example.com', 'code-version': 'v1', 'client-id': 'abc' }
- * ```
- */
-export declare function mapNormalizedConfigToDwJson(config: Partial<NormalizedConfig>, name?: string): DwJsonConfig;
-/**
- * Options for merging configurations.
- */
-export interface MergeConfigOptions {
-    /**
-     * Whether to apply hostname mismatch protection.
-     * When true, if overrides.hostname differs from base.hostname,
-     * the entire base config is ignored.
-     * @default true
-     */
-    hostnameProtection?: boolean;
-}
-/**
- * Result of merging configurations.
- */
-export interface MergeConfigResult {
-    /** The merged configuration */
-    config: NormalizedConfig;
-    /** Warnings generated during merge (e.g., hostname mismatch) */
-    warnings: ConfigWarning[];
-    /** Whether a hostname mismatch was detected and base was ignored */
-    hostnameMismatch: boolean;
-}
-/**
- * Merges configurations with hostname mismatch protection.
- *
- * Applies the precedence rule: overrides > base.
- * If hostname protection is enabled and the override hostname differs from
- * the base hostname, the entire base config is ignored to prevent
- * credential leakage between different instances.
- *
- * @param overrides - Higher-priority config values (e.g., from CLI flags/env)
- * @param base - Lower-priority config values (e.g., from dw.json)
- * @param options - Merge options
- * @returns Merged config with warnings
- *
- * @example
- * ```typescript
- * import { mergeConfigsWithProtection } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const { config, warnings } = mergeConfigsWithProtection(
- *   { hostname: 'staging.example.com' },
- *   { hostname: 'prod.example.com', clientId: 'abc' },
- *   { hostnameProtection: true }
- * );
- * // config = { hostname: 'staging.example.com' }
- * // warnings = [{ code: 'HOSTNAME_MISMATCH', ... }]
- * ```
- */
-export declare function mergeConfigsWithProtection(overrides: Partial<NormalizedConfig>, base: NormalizedConfig, options?: MergeConfigOptions): MergeConfigResult;
-/**
- * Gets the list of fields that have values in a config.
- *
- * Used for tracking which sources contributed which fields during
- * configuration resolution.
- *
- * @param config - The configuration to inspect
- * @returns Array of field names that have non-empty values
- *
- * @example
- * ```typescript
- * const config = { hostname: 'example.com', clientId: 'abc' };
- * const fields = getPopulatedFields(config);
- * // ['hostname', 'clientId']
- * ```
- */
-export declare function getPopulatedFields(config: NormalizedConfig): (keyof NormalizedConfig)[];
-/**
- * Builds an AuthConfig from a NormalizedConfig.
- *
- * This is the single source of truth for converting normalized config
- * to the AuthConfig format expected by B2CInstance.
- *
- * @param config - The normalized configuration
- * @returns AuthConfig for B2CInstance
- *
- * @example
- * ```typescript
- * const config = {
- *   clientId: 'my-client-id',
- *   clientSecret: 'my-secret',
- *   username: 'admin',
- *   password: 'pass',
- * };
- * const authConfig = buildAuthConfigFromNormalized(config);
- * // { oauth: { clientId: '...', clientSecret: '...' }, basic: { username: '...', password: '...' } }
- * ```
- */
-export declare function buildAuthConfigFromNormalized(config: NormalizedConfig): AuthConfig;
-/**
- * Creates a B2CInstance from a NormalizedConfig.
- *
- * This utility provides a single source of truth for instance creation
- * from resolved configuration. It is used by both ConfigResolver.createInstance()
- * and CLI commands (e.g., InstanceCommand).
- *
- * @param config - The normalized configuration (must include hostname)
- * @returns Configured B2CInstance
- * @throws Error if hostname is not available in config
- *
- * @example
- * ```typescript
- * import { createInstanceFromConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = { hostname: 'example.demandware.net', clientId: 'abc' };
- * const instance = createInstanceFromConfig(config);
- * await instance.webdav.mkcol('Cartridges/v1');
- * ```
- */
-export declare function createInstanceFromConfig(config: NormalizedConfig, options?: {
-    redirectUri?: string;
-    openBrowser?: (url: string) => Promise<void>;
-}): B2CInstance;