@salesforce/b2c-tooling-sdk 0.3.0 → 0.4.0

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

@@ -14,6 +14,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { getLogger } from '../logging/logger.js';
+import { normalizeConfigKeys } from './mapping.js';
 /**
  * Finds dw.json by searching upward from the starting directory.
  *
@@ -83,6 +84,164 @@ function selectConfig(json, instanceName) {
     logger.trace({ selection: 'root', instanceName: json.name }, `[DwJsonSource] Selected config "${json.name ?? 'root'}" (default to root)`);
     return json;
 }
+/**
+ * Load the raw dw.json file without selecting a specific instance.
+ *
+ * This is useful for instance management operations that need to work
+ * with the full configs array.
+ *
+ * @param options - Loading options
+ * @returns The raw multi-config structure and path, or undefined if not found
+ */
+export function loadFullDwJson(options = {}) {
+    const logger = getLogger();
+    const dwJsonPath = options.path ?? path.join(options.startDir || process.cwd(), 'dw.json');
+    logger.trace({ path: dwJsonPath }, '[DwJsonSource] Checking for config file');
+    if (!fs.existsSync(dwJsonPath)) {
+        logger.trace({ path: dwJsonPath }, '[DwJsonSource] No config file found');
+        return undefined;
+    }
+    try {
+        const content = fs.readFileSync(dwJsonPath, 'utf8');
+        const json = JSON.parse(content);
+        return { config: json, path: dwJsonPath };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.trace({ path: dwJsonPath, error: message }, '[DwJsonSource] Failed to parse config file');
+        throw error;
+    }
+}
+/**
+ * Save a dw.json configuration to disk.
+ *
+ * @param config - The configuration to save
+ * @param filePath - Path to save to
+ */
+export function saveDwJson(config, filePath) {
+    const content = JSON.stringify(config, null, 2) + '\n';
+    fs.writeFileSync(filePath, content, 'utf8');
+}
+/**
+ * Add a new instance to dw.json.
+ *
+ * If dw.json doesn't exist, creates a new one. If an instance with the same
+ * name already exists, throws an error.
+ *
+ * @param instance - The instance configuration to add
+ * @param options - Options for adding
+ * @throws Error if instance with same name already exists
+ */
+export function addInstance(instance, options = {}) {
+    const dwJsonPath = options.path ?? path.join(options.startDir || process.cwd(), 'dw.json');
+    let existing = {};
+    if (fs.existsSync(dwJsonPath)) {
+        const content = fs.readFileSync(dwJsonPath, 'utf8');
+        existing = JSON.parse(content);
+    }
+    // Check if instance name already exists
+    const instanceName = instance.name;
+    if (!instanceName) {
+        throw new Error('Instance must have a name');
+    }
+    // Check root config
+    if (existing.name === instanceName) {
+        throw new Error(`Instance "${instanceName}" already exists`);
+    }
+    // Check configs array
+    if (existing.configs?.some((c) => c.name === instanceName)) {
+        throw new Error(`Instance "${instanceName}" already exists`);
+    }
+    // Handle setActive - clear other active flags
+    if (options.setActive) {
+        instance.active = true;
+        // Clear active on root if it has it
+        if (existing.active !== undefined) {
+            existing.active = false;
+        }
+        // Clear active on all other configs
+        if (existing.configs) {
+            for (const c of existing.configs) {
+                if (c.active !== undefined) {
+                    c.active = false;
+                }
+            }
+        }
+    }
+    // Initialize configs array if needed
+    if (!existing.configs) {
+        existing.configs = [];
+    }
+    // Add the new instance
+    existing.configs.push(instance);
+    saveDwJson(existing, dwJsonPath);
+}
+/**
+ * Remove an instance from dw.json.
+ *
+ * @param name - Name of the instance to remove
+ * @param options - Options for removal
+ * @throws Error if instance not found or dw.json doesn't exist
+ */
+export function removeInstance(name, options = {}) {
+    const dwJsonPath = options.path ?? path.join(options.startDir || process.cwd(), 'dw.json');
+    if (!fs.existsSync(dwJsonPath)) {
+        throw new Error('No dw.json file found');
+    }
+    const content = fs.readFileSync(dwJsonPath, 'utf8');
+    const existing = JSON.parse(content);
+    // Check if trying to remove root config
+    if (existing.name === name) {
+        throw new Error(`Cannot remove root instance "${name}". Edit dw.json manually to remove root config.`);
+    }
+    // Find and remove from configs array
+    if (!existing.configs || !existing.configs.some((c) => c.name === name)) {
+        throw new Error(`Instance "${name}" not found`);
+    }
+    existing.configs = existing.configs.filter((c) => c.name !== name);
+    saveDwJson(existing, dwJsonPath);
+}
+/**
+ * Set an instance as the active default.
+ *
+ * @param name - Name of the instance to set as active
+ * @param options - Options
+ * @throws Error if instance not found or dw.json doesn't exist
+ */
+export function setActiveInstance(name, options = {}) {
+    const dwJsonPath = options.path ?? path.join(options.startDir || process.cwd(), 'dw.json');
+    if (!fs.existsSync(dwJsonPath)) {
+        throw new Error('No dw.json file found');
+    }
+    const content = fs.readFileSync(dwJsonPath, 'utf8');
+    const existing = JSON.parse(content);
+    // Find the target instance
+    let found = false;
+    // Check root config
+    if (existing.name === name) {
+        found = true;
+        existing.active = true;
+    }
+    else if (existing.active !== undefined) {
+        existing.active = false;
+    }
+    // Check and update configs array
+    if (existing.configs) {
+        for (const c of existing.configs) {
+            if (c.name === name) {
+                found = true;
+                c.active = true;
+            }
+            else if (c.active !== undefined) {
+                c.active = false;
+            }
+        }
+    }
+    if (!found) {
+        throw new Error(`Instance "${name}" not found`);
+    }
+    saveDwJson(existing, dwJsonPath);
+}
 /**
  * Loads configuration from a dw.json file.
  *
@@ -122,8 +281,14 @@ export function loadDwJson(options = {}) {
     }
     try {
         const content = fs.readFileSync(dwJsonPath, 'utf8');
-        const json = JSON.parse(content);
-        const config = selectConfig(json, options.instance);
+        const raw = JSON.parse(content);
+        // Normalize root-level keys to camelCase
+        const normalized = normalizeConfigKeys(raw);
+        // Normalize keys in each configs[] item
+        if (Array.isArray(normalized.configs)) {
+            normalized.configs = normalized.configs.map((item) => normalizeConfigKeys(item));
+        }
+        const config = selectConfig(normalized, options.instance);
         if (!config) {
             return undefined;
         }

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

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

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

@@ -90,7 +90,9 @@
  * @module config
  */
 export { resolveConfig, ConfigResolver, createConfigResolver } from './resolver.js';
-export type { NormalizedConfig, ConfigSource, ConfigLoadResult, ConfigSourceInfo, ConfigResolutionResult, ConfigWarning, ConfigWarningCode, ResolveConfigOptions, ResolvedB2CConfig, CreateOAuthOptions, } from './types.js';
-export { createInstanceFromConfig } from './mapping.js';
-export { loadDwJson, findDwJson } from './dw-json.js';
-export type { DwJsonConfig, DwJsonMultiConfig, LoadDwJsonOptions, LoadDwJsonResult } from './dw-json.js';
+export type { NormalizedConfig, ConfigSource, ConfigLoadResult, ConfigSourceInfo, ConfigResolutionResult, ConfigWarning, ConfigWarningCode, ResolveConfigOptions, ResolvedB2CConfig, CreateOAuthOptions, InstanceInfo, CreateInstanceOptions, } from './types.js';
+export { createInstanceFromConfig, normalizeConfigKeys } 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 { DwJsonSource } from './sources/dw-json-source.js';

package/dist/esm/config/index.js

@@ -97,7 +97,11 @@
 // High-level API (preferred)
 export { resolveConfig, ConfigResolver, createConfigResolver } from './resolver.js';
 // Instance creation utility (public API for CLI commands)
-export { createInstanceFromConfig } from './mapping.js';
+export { createInstanceFromConfig, normalizeConfigKeys } from './mapping.js';
 // Low-level dw.json API (still available for advanced use)
-export { loadDwJson, findDwJson } from './dw-json.js';
+export { loadDwJson, loadFullDwJson, findDwJson, saveDwJson, addInstance, removeInstance, setActiveInstance, } from './dw-json.js';
+// Instance management
+export { InstanceManager, createInstanceManager } from './instance-manager.js';
+// Config sources (for direct use)
+export { DwJsonSource } from './sources/dw-json-source.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"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;AAgBlF,0DAA0D;AAC1D,OAAO,EAAC,wBAAwB,EAAC,MAAM,cAAc,CAAC;AAEtD,2DAA2D;AAC3D,OAAO,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,cAAc,CAAC"}
+{"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;AAkBlF,0DAA0D;AAC1D,OAAO,EAAC,wBAAwB,EAAE,mBAAmB,EAAC,MAAM,cAAc,CAAC;AAE3E,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,kCAAkC;AAClC,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,97 @@
+/**
+ * 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): 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): 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): 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): 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): 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/esm/config/instance-manager.js

@@ -0,0 +1,166 @@
+/**
+ * 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
+     */
+    listAllInstances(options) {
+        const allInstances = [];
+        for (const source of this.sources) {
+            if (source.listInstances) {
+                const instances = 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
+     */
+    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];
+        }
+        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
+     */
+    removeInstance(name, options) {
+        // Find the source that has this instance
+        for (const source of this.sources) {
+            if (source.listInstances && source.removeInstance) {
+                const instances = source.listInstances(options);
+                if (instances.some((i) => i.name === name)) {
+                    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
+     */
+    setActiveInstance(name, options) {
+        // Find the source that has this instance
+        for (const source of this.sources) {
+            if (source.listInstances && source.setActiveInstance) {
+                const instances = source.listInstances(options);
+                if (instances.some((i) => i.name === name)) {
+                    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
+     */
+    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];
+        }
+        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/esm/config/instance-manager.js.map

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

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

@@ -10,27 +10,85 @@ import type { AuthConfig } from '../auth/types.js';
 import { B2CInstance } from '../instance/index.js';
 import type { DwJsonConfig } from './dw-json.js';
 import type { NormalizedConfig, ConfigWarning } from './types.js';
+/**
+ * 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>;
 /**
  * Maps dw.json fields to normalized config format.
  *
  * This is the SINGLE place where dw.json field mapping happens.
- * Handles multiple field name variants for backward compatibility:
- * - WebDAV hostname: `webdav-hostname`, `webdav-server`, `secureHostname`, `secure-server`
- * - Short code: `shortCode`, `short-code`, `scapi-shortcode`
+ * Keys are already normalized to camelCase by normalizeConfigKeys() in loadDwJson(),
+ * so this function only handles genuine renames (e.g., `name` → `instanceName`,
+ * `oauthScopes` → `scopes`).
  *
- * @param json - The raw dw.json config
+ * @param json - The normalized dw.json config (camelCase keys)
  * @returns Normalized configuration
  *
  * @example
  * ```typescript
  * import { mapDwJsonToNormalizedConfig } from '@salesforce/b2c-tooling-sdk/config';
  *
- * const dwJson = { hostname: 'example.com', 'code-version': 'v1' };
+ * const dwJson = { hostname: 'example.com', codeVersion: 'v1' };
  * const config = mapDwJsonToNormalizedConfig(dwJson);
  * // { hostname: 'example.com', codeVersion: 'v1' }
  * ```
  */
 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.
  */