@salesforce/b2c-tooling-sdk 0.0.0-nightly.20260119053920

package/dist/esm/config/resolver.js

@@ -0,0 +1,323 @@
+import { mergeConfigsWithProtection, getPopulatedFields, createInstanceFromConfig } from './mapping.js';
+import { DwJsonSource, MobifySource } from './sources/index.js';
+import { ResolvedConfigImpl } from './resolved-config.js';
+/**
+ * Credential groups that must come from the same source.
+ *
+ * When merging configuration, if any field in a group is already set by a
+ * higher-priority source, all fields in that group from lower-priority
+ * sources are skipped. This prevents mixing credentials that don't belong together.
+ */
+const CREDENTIAL_GROUPS = [
+    ['clientId', 'clientSecret'],
+    ['username', 'password'],
+];
+/**
+ * Get the set of credential groups that are already claimed in the config.
+ *
+ * A group is "claimed" if any of its fields are set.
+ *
+ * @param config - The current configuration
+ * @returns Set of group indices that are claimed
+ */
+function getClaimedCredentialGroups(config) {
+    const claimed = new Set();
+    for (let i = 0; i < CREDENTIAL_GROUPS.length; i++) {
+        const group = CREDENTIAL_GROUPS[i];
+        if (group.some((f) => config[f] !== undefined)) {
+            claimed.add(i);
+        }
+    }
+    return claimed;
+}
+/**
+ * Check if a field belongs to a credential group in the claimed set.
+ *
+ * @param field - The field name to check
+ * @param claimedGroups - Set of group indices that are already claimed
+ * @returns true if the field's credential group is claimed
+ */
+function isFieldInClaimedGroup(field, claimedGroups) {
+    const groupIndex = CREDENTIAL_GROUPS.findIndex((g) => g.includes(field));
+    if (groupIndex === -1)
+        return false;
+    return claimedGroups.has(groupIndex);
+}
+/**
+ * Resolves configuration from multiple sources with consistent behavior.
+ *
+ * ConfigResolver is the preferred high-level API for loading B2C configuration.
+ * It provides:
+ * - Consistent hostname mismatch protection across SDK and CLI
+ * - Extensibility via the ConfigSource interface
+ * - Convenience methods for creating B2CInstance and auth credentials
+ *
+ * ## Resolution Priority
+ *
+ * Configuration is resolved with the following precedence (highest to lowest):
+ * 1. Explicit overrides (passed to resolve methods)
+ * 2. Sources in order (dw.json, ~/.mobify by default)
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { createConfigResolver } from '@salesforce/b2c-tooling-sdk/config';
+ *
+ * const resolver = createConfigResolver();
+ *
+ * // Simple resolution
+ * const { config, warnings } = resolver.resolve({
+ *   hostname: process.env.SFCC_SERVER,
+ *   clientId: process.env.SFCC_CLIENT_ID,
+ * });
+ *
+ * // Create B2CInstance directly
+ * const instance = resolver.createInstance({ hostname: '...' });
+ *
+ * // Get auth credentials for use with resolveAuthStrategy
+ * const credentials = resolver.createAuthCredentials({ clientId: '...' });
+ * ```
+ *
+ * ## Custom Sources
+ *
+ * You can provide custom configuration sources:
+ *
+ * ```typescript
+ * import { ConfigResolver } from '@salesforce/b2c-tooling-sdk/config';
+ *
+ * class MySource implements ConfigSource {
+ *   name = 'my-source';
+ *   load(options) { return { hostname: 'custom.example.com' }; }
+ * }
+ *
+ * const resolver = new ConfigResolver([new MySource()]);
+ * ```
+ */
+export class ConfigResolver {
+    sources;
+    /**
+     * Creates a new ConfigResolver.
+     *
+     * @param sources - Custom configuration sources. If not provided, uses default sources (dw.json, ~/.mobify).
+     */
+    constructor(sources) {
+        this.sources = sources ?? [new DwJsonSource(), new MobifySource()];
+    }
+    /**
+     * Resolves configuration from all sources.
+     *
+     * @param overrides - Explicit values that take highest priority
+     * @param options - Resolution options
+     * @returns Resolution result with config, warnings, and source info
+     *
+     * @example
+     * ```typescript
+     * const { config, warnings, sources } = resolver.resolve(
+     *   { hostname: process.env.SFCC_SERVER },
+     *   { instance: 'staging' }
+     * );
+     *
+     * if (warnings.length > 0) {
+     *   console.warn('Config warnings:', warnings);
+     * }
+     * ```
+     */
+    resolve(overrides = {}, options = {}) {
+        const sourceInfos = [];
+        const baseConfig = {};
+        // Create enriched options that will be updated with accumulated config values.
+        // This allows later sources (like plugins) to use values discovered by earlier sources (like dw.json).
+        // CLI-provided options always take precedence over accumulated values.
+        const enrichedOptions = { ...options };
+        // Load from each source in order, merging results
+        // Earlier sources have higher priority - later sources only fill in missing values
+        for (const source of this.sources) {
+            const result = source.load(enrichedOptions);
+            if (result) {
+                const { config: sourceConfig, location } = result;
+                const fields = getPopulatedFields(sourceConfig);
+                if (fields.length > 0) {
+                    // Capture which credential groups are already claimed BEFORE processing this source
+                    // This allows a single source to provide complete credential pairs
+                    const claimedGroups = getClaimedCredentialGroups(baseConfig);
+                    // Track which fields are ignored during merge
+                    const fieldsIgnored = [];
+                    // Merge: source values fill in gaps (don't override existing values)
+                    for (const [key, value] of Object.entries(sourceConfig)) {
+                        if (value === undefined)
+                            continue;
+                        const fieldKey = key;
+                        // Skip if already set by higher-priority source
+                        if (baseConfig[fieldKey] !== undefined) {
+                            fieldsIgnored.push(fieldKey);
+                            continue;
+                        }
+                        // Skip if this field's credential group was already claimed by a higher-priority source
+                        // This prevents mixing credentials from different sources
+                        if (isFieldInClaimedGroup(key, claimedGroups)) {
+                            fieldsIgnored.push(fieldKey);
+                            continue;
+                        }
+                        baseConfig[key] = value;
+                    }
+                    sourceInfos.push({
+                        name: source.name,
+                        location,
+                        fields,
+                        fieldsIgnored: fieldsIgnored.length > 0 ? fieldsIgnored : undefined,
+                    });
+                    // Enrich options with accumulated config values for subsequent sources.
+                    // Only set if not already provided via CLI options.
+                    if (!enrichedOptions.accountManagerHost && baseConfig.accountManagerHost) {
+                        enrichedOptions.accountManagerHost = baseConfig.accountManagerHost;
+                    }
+                }
+            }
+        }
+        // Apply overrides with hostname mismatch protection
+        const { config, warnings } = mergeConfigsWithProtection(overrides, baseConfig, {
+            hostnameProtection: options.hostnameProtection,
+        });
+        return { config, warnings, sources: sourceInfos };
+    }
+    /**
+     * Creates a B2CInstance from resolved configuration.
+     *
+     * This is a convenience method that combines configuration resolution
+     * with B2CInstance creation.
+     *
+     * @param overrides - Explicit values that take highest priority
+     * @param options - Resolution options
+     * @returns Configured B2CInstance
+     * @throws Error if hostname is not available in resolved config
+     *
+     * @example
+     * ```typescript
+     * const instance = resolver.createInstance({
+     *   clientId: process.env.SFCC_CLIENT_ID,
+     *   clientSecret: process.env.SFCC_CLIENT_SECRET,
+     * });
+     *
+     * await instance.webdav.put('path/file.txt', content);
+     * ```
+     */
+    createInstance(overrides = {}, options = {}) {
+        const { config, warnings } = this.resolve(overrides, options);
+        // Log warnings (in production, this would use the SDK logger)
+        for (const warning of warnings) {
+            // Could integrate with getLogger() here if desired
+            console.warn(`[ConfigResolver] ${warning.message}`);
+        }
+        return createInstanceFromConfig(config);
+    }
+    /**
+     * Creates auth credentials from resolved configuration.
+     *
+     * The returned credentials can be used with `resolveAuthStrategy()`
+     * to automatically select the best authentication method.
+     *
+     * @param overrides - Explicit values that take highest priority
+     * @param options - Resolution options
+     * @returns Auth credentials suitable for resolveAuthStrategy()
+     *
+     * @example
+     * ```typescript
+     * import { resolveAuthStrategy } from '@salesforce/b2c-tooling-sdk';
+     *
+     * const credentials = resolver.createAuthCredentials({
+     *   clientId: process.env.SFCC_CLIENT_ID,
+     * });
+     *
+     * const strategy = resolveAuthStrategy(credentials);
+     * ```
+     */
+    createAuthCredentials(overrides = {}, options = {}) {
+        const { config } = this.resolve(overrides, options);
+        return {
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+            scopes: config.scopes,
+            username: config.username,
+            password: config.password,
+            apiKey: config.mrtApiKey,
+        };
+    }
+}
+/**
+ * Creates a ConfigResolver with default sources (dw.json, ~/.mobify).
+ *
+ * This is the recommended way to create a ConfigResolver for most use cases.
+ *
+ * @returns ConfigResolver with default configuration sources
+ *
+ * @example
+ * ```typescript
+ * import { createConfigResolver } from '@salesforce/b2c-tooling-sdk/config';
+ *
+ * const resolver = createConfigResolver();
+ * const { config } = resolver.resolve({ hostname: 'example.com' });
+ * ```
+ */
+export function createConfigResolver() {
+    return new ConfigResolver();
+}
+/**
+ * Resolves configuration from multiple sources and returns a rich config object.
+ *
+ * This is the preferred high-level API for configuration resolution. It returns
+ * a {@link ResolvedB2CConfig} object with validation methods and factory methods
+ * for creating SDK objects.
+ *
+ * ## Resolution Priority
+ *
+ * 1. Explicit overrides (passed as first argument)
+ * 2. Default sources (dw.json, ~/.mobify)
+ * 3. Custom sources (via options.sources)
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
+ *
+ * const config = 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 mrtClient = config.createMrtClient({ project: 'my-project' });
+ * }
+ * ```
+ *
+ * @param overrides - Explicit configuration values (highest priority)
+ * @param options - Resolution options
+ * @returns Resolved configuration with factory methods
+ */
+export function resolveConfig(overrides = {}, options = {}) {
+    // Build sources list with priority ordering:
+    // 1. sourcesBefore (high priority - override defaults)
+    // 2. default sources (dw.json, ~/.mobify)
+    // 3. sourcesAfter (low priority - fill gaps)
+    let sources;
+    if (options.replaceDefaultSources) {
+        // Replace mode: only use provided sources (no default dw.json/~/.mobify)
+        sources = [...(options.sourcesBefore ?? []), ...(options.sourcesAfter ?? [])];
+    }
+    else {
+        // Normal mode: before + defaults + after
+        const defaultSources = [new DwJsonSource(), new MobifySource()];
+        // Combine: sourcesBefore > defaults > sourcesAfter
+        sources = [...(options.sourcesBefore ?? []), ...defaultSources, ...(options.sourcesAfter ?? [])];
+    }
+    const resolver = new ConfigResolver(sources);
+    const { config, warnings, sources: sourceInfos } = resolver.resolve(overrides, options);
+    return new ResolvedConfigImpl(config, warnings, sourceInfos);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/esm/config/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/config/resolver.ts"],"names":[],"mappings":"AAeA,OAAO,EAAC,0BAA0B,EAAE,kBAAkB,EAAE,wBAAwB,EAAC,MAAM,cAAc,CAAC;AACtG,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAS9D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAiC;IACtD,CAAC,UAAU,EAAE,cAAc,CAAC;IAC5B,CAAC,UAAU,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,0BAA0B,CAAC,MAAwB;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,KAAa,EAAE,aAA0B;IACtE,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAA+B,CAAC,CAAC,CAAC;IACnG,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,CAAiB;IAEhC;;;;OAIG;IACH,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,YAAY,EAAE,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,YAAuC,EAAE,EAAE,UAAgC,EAAE;QACnF,MAAM,WAAW,GAAuB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAqB,EAAE,CAAC;QAExC,+EAA+E;QAC/E,uGAAuG;QACvG,uEAAuE;QACvE,MAAM,eAAe,GAAyB,EAAC,GAAG,OAAO,EAAC,CAAC;QAE3D,kDAAkD;QAClD,mFAAmF;QACnF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,EAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAC,GAAG,MAAM,CAAC;gBAChD,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;gBAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,oFAAoF;oBACpF,mEAAmE;oBACnE,MAAM,aAAa,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;oBAE7D,8CAA8C;oBAC9C,MAAM,aAAa,GAA+B,EAAE,CAAC;oBAErD,qEAAqE;oBACrE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;wBACxD,IAAI,KAAK,KAAK,SAAS;4BAAE,SAAS;wBAElC,MAAM,QAAQ,GAAG,GAA6B,CAAC;wBAE/C,gDAAgD;wBAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;4BACvC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;4BAC7B,SAAS;wBACX,CAAC;wBAED,wFAAwF;wBACxF,0DAA0D;wBAC1D,IAAI,qBAAqB,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;4BAC9C,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;4BAC7B,SAAS;wBACX,CAAC;wBAEA,UAAsC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACvD,CAAC;oBAED,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,QAAQ;wBACR,MAAM;wBACN,aAAa,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;qBACpE,CAAC,CAAC;oBAEH,wEAAwE;oBACxE,oDAAoD;oBACpD,IAAI,CAAC,eAAe,CAAC,kBAAkB,IAAI,UAAU,CAAC,kBAAkB,EAAE,CAAC;wBACzE,eAAe,CAAC,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;oBACrE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,MAAM,EAAC,MAAM,EAAE,QAAQ,EAAC,GAAG,0BAA0B,CAAC,SAAS,EAAE,UAAU,EAAE;YAC3E,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;SAC/C,CAAC,CAAC;QAEH,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,YAAuC,EAAE,EAAE,UAAgC,EAAE;QAC1F,MAAM,EAAC,MAAM,EAAE,QAAQ,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE5D,8DAA8D;QAC9D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,mDAAmD;YACnD,OAAO,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,qBAAqB,CACnB,YAAuC,EAAE,EACzC,UAAgC,EAAE;QAElC,MAAM,EAAC,MAAM,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAElD,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,cAAc,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAuC,EAAE,EACzC,UAAgC,EAAE;IAElC,6CAA6C;IAC7C,uDAAuD;IACvD,0CAA0C;IAC1C,6CAA6C;IAC7C,IAAI,OAAuB,CAAC;IAE5B,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAClC,yEAAyE;QACzE,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,MAAM,cAAc,GAAmB,CAAC,IAAI,YAAY,EAAE,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;QAEhF,mDAAmD;QACnD,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEtF,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC"}

package/dist/esm/config/sources/dw-json-source.d.ts

@@ -0,0 +1,10 @@
+import type { ConfigSource, ConfigLoadResult, ResolveConfigOptions } from '../types.js';
+/**
+ * Configuration source that loads from dw.json files.
+ *
+ * @internal
+ */
+export declare class DwJsonSource implements ConfigSource {
+    readonly name = "DwJsonSource";
+    load(options: ResolveConfigOptions): ConfigLoadResult | undefined;
+}

package/dist/esm/config/sources/dw-json-source.js

@@ -0,0 +1,38 @@
+/*
+ * 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
+ */
+/**
+ * dw.json configuration source.
+ *
+ * @internal This module is internal to the SDK. Use ConfigResolver instead.
+ */
+import { loadDwJson } from '../dw-json.js';
+import { getPopulatedFields } from '../mapping.js';
+import { mapDwJsonToNormalizedConfig } from '../mapping.js';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Configuration source that loads from dw.json files.
+ *
+ * @internal
+ */
+export class DwJsonSource {
+    name = 'DwJsonSource';
+    load(options) {
+        const logger = getLogger();
+        const result = loadDwJson({
+            instance: options.instance,
+            path: options.configPath,
+            startDir: options.startDir,
+        });
+        if (!result) {
+            return undefined;
+        }
+        const config = mapDwJsonToNormalizedConfig(result.config);
+        const fields = getPopulatedFields(config);
+        logger.trace({ location: result.path, fields }, '[DwJsonSource] Loaded config');
+        return { config, location: result.path };
+    }
+}
+//# sourceMappingURL=dw-json-source.js.map

package/dist/esm/config/sources/dw-json-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dw-json-source.js","sourceRoot":"","sources":["../../../../src/config/sources/dw-json-source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACjD,OAAO,EAAC,2BAA2B,EAAC,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAElD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,cAAc,CAAC;IAE/B,IAAI,CAAC,OAA6B;QAChC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,UAAU;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAE1C,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAC,EAAE,8BAA8B,CAAC,CAAC;QAE9E,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/esm/config/sources/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Internal configuration sources.
+ *
+ * @internal This module is internal to the SDK. Use ConfigResolver instead.
+ */
+export { DwJsonSource } from './dw-json-source.js';
+export { MobifySource } from './mobify-source.js';

package/dist/esm/config/sources/index.js

@@ -0,0 +1,13 @@
+/*
+ * 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
+ */
+/**
+ * Internal configuration sources.
+ *
+ * @internal This module is internal to the SDK. Use ConfigResolver instead.
+ */
+export { DwJsonSource } from './dw-json-source.js';
+export { MobifySource } from './mobify-source.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/config/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/sources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC"}

package/dist/esm/config/sources/mobify-source.d.ts

@@ -0,0 +1,24 @@
+import type { ConfigSource, ConfigLoadResult, ResolveConfigOptions } from '../types.js';
+/**
+ * Configuration source that loads MRT API key from ~/.mobify file.
+ *
+ * The mobify config file is a JSON file located at ~/.mobify containing:
+ * ```json
+ * {
+ *   "username": "user@example.com",
+ *   "api_key": "your-api-key"
+ * }
+ * ```
+ *
+ * When a cloudOrigin is provided in options, looks for ~/.mobify--[hostname] instead.
+ *
+ * @internal
+ */
+export declare class MobifySource implements ConfigSource {
+    readonly name = "MobifySource";
+    load(options: ResolveConfigOptions): ConfigLoadResult | undefined;
+    /**
+     * Determines the mobify config file path based on cloud origin.
+     */
+    private getMobifyPath;
+}

package/dist/esm/config/sources/mobify-source.js

@@ -0,0 +1,79 @@
+/*
+ * 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
+ */
+/**
+ * Mobify (~/.mobify) configuration source for MRT API key.
+ *
+ * @internal This module is internal to the SDK. Use ConfigResolver instead.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Configuration source that loads MRT API key from ~/.mobify file.
+ *
+ * The mobify config file is a JSON file located at ~/.mobify containing:
+ * ```json
+ * {
+ *   "username": "user@example.com",
+ *   "api_key": "your-api-key"
+ * }
+ * ```
+ *
+ * When a cloudOrigin is provided in options, looks for ~/.mobify--[hostname] instead.
+ *
+ * @internal
+ */
+export class MobifySource {
+    name = 'MobifySource';
+    load(options) {
+        const logger = getLogger();
+        // Use explicit credentialsFile if provided, otherwise use default path
+        const mobifyPath = options.credentialsFile ?? this.getMobifyPath(options.cloudOrigin);
+        logger.trace({ location: mobifyPath }, '[MobifySource] Checking for credentials file');
+        if (!fs.existsSync(mobifyPath)) {
+            logger.trace({ location: mobifyPath }, '[MobifySource] No credentials file found');
+            return undefined;
+        }
+        try {
+            const content = fs.readFileSync(mobifyPath, 'utf8');
+            const config = JSON.parse(content);
+            if (!config.api_key) {
+                logger.trace({ location: mobifyPath }, '[MobifySource] Credentials file found but no api_key present');
+                return undefined;
+            }
+            logger.trace({ location: mobifyPath, fields: ['mrtApiKey'] }, '[MobifySource] Loaded credentials');
+            return {
+                config: { mrtApiKey: config.api_key },
+                location: mobifyPath,
+            };
+        }
+        catch (error) {
+            // Invalid JSON or read error
+            const message = error instanceof Error ? error.message : String(error);
+            logger.trace({ location: mobifyPath, error: message }, '[MobifySource] Failed to parse credentials file');
+            return undefined;
+        }
+    }
+    /**
+     * Determines the mobify config file path based on cloud origin.
+     */
+    getMobifyPath(cloudOrigin) {
+        if (cloudOrigin) {
+            // Extract hostname from origin URL for the config file suffix
+            try {
+                const url = new URL(cloudOrigin);
+                return path.join(os.homedir(), `.mobify--${url.hostname}`);
+            }
+            catch {
+                // If URL parsing fails, use the origin as-is
+                return path.join(os.homedir(), `.mobify--${cloudOrigin}`);
+            }
+        }
+        return path.join(os.homedir(), '.mobify');
+    }
+}
+//# sourceMappingURL=mobify-source.js.map

package/dist/esm/config/sources/mobify-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobify-source.js","sourceRoot":"","sources":["../../../../src/config/sources/mobify-source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAUlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,cAAc,CAAC;IAE/B,IAAI,CAAC,OAA6B;QAChC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,uEAAuE;QACvE,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEtF,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,UAAU,EAAC,EAAE,8CAA8C,CAAC,CAAC;QAErF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,UAAU,EAAC,EAAE,0CAA0C,CAAC,CAAC;YACjF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;YAEvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,UAAU,EAAC,EAAE,8DAA8D,CAAC,CAAC;gBACrG,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAC,EAAE,mCAAmC,CAAC,CAAC;YAEjG,OAAO;gBACL,MAAM,EAAE,EAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAC;gBACnC,QAAQ,EAAE,UAAU;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6BAA6B;YAC7B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAC,EAAE,iDAAiD,CAAC,CAAC;YACxG,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,WAAoB;QACxC,IAAI,WAAW,EAAE,CAAC;YAChB,8DAA8D;YAC9D,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;gBACjC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;gBAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,WAAW,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF"}