@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/plugins/loader.d.ts

@@ -1,34 +0,0 @@
-import type { Logger } from '../logging/types.js';
-/**
- * Minimal hook context that shims the `this` context oclif provides to hooks.
- *
- * Provides `debug()`, `log()`, `warn()`, `error()`, and a stub `config` object
- * so that existing hook implementations work without `@oclif/core`.
- */
-export interface HookContext {
-    debug(...args: unknown[]): void;
-    log(...args: unknown[]): void;
-    warn(...args: unknown[]): void;
-    error(...args: unknown[]): void;
-    config: Record<string, unknown>;
-}
-export interface HookContextOptions {
-    /** Logger to route debug/log/warn/error through */
-    logger?: Logger;
-    /** Extra properties to include on the stub config object */
-    config?: Record<string, unknown>;
-}
-/**
- * Creates a minimal hook context matching what oclif provides to hooks.
- */
-export declare function createHookContext(options?: HookContextOptions): HookContext;
-/**
- * Dynamically imports a hook file and invokes its default export.
- *
- * @param hookFilePath - Absolute path to the hook JS file
- * @param context - Hook context (`this` inside the hook)
- * @param hookOptions - Options passed as the first argument to the hook function
- * @param logger - Optional logger for warnings on failure
- * @returns The hook function's return value, or `undefined` on error
- */
-export declare function invokeHook<TResult>(hookFilePath: string, context: HookContext, hookOptions: Record<string, unknown>, logger?: Logger): Promise<TResult | undefined>;

package/dist/cjs/plugins/loader.js

@@ -1,59 +0,0 @@
-/**
- * Creates a minimal hook context matching what oclif provides to hooks.
- */
-export function createHookContext(options = {}) {
-    const { logger } = options;
-    return {
-        debug(...args) {
-            logger?.debug(args.map(String).join(' '));
-        },
-        log(...args) {
-            logger?.info(args.map(String).join(' '));
-        },
-        warn(...args) {
-            logger?.warn(args.map(String).join(' '));
-        },
-        error(...args) {
-            logger?.error(args.map(String).join(' '));
-        },
-        config: options.config ?? {},
-    };
-}
-/**
- * Dynamic import that survives esbuild CJS bundling.
- *
- * esbuild transforms `import()` to `require()` in CJS output, which cannot
- * load ESM plugins. Using `new Function` preserves the native dynamic import.
- */
-const dynamicImport = new Function('specifier', 'return import(specifier)');
-/**
- * Dynamically imports a hook file and invokes its default export.
- *
- * @param hookFilePath - Absolute path to the hook JS file
- * @param context - Hook context (`this` inside the hook)
- * @param hookOptions - Options passed as the first argument to the hook function
- * @param logger - Optional logger for warnings on failure
- * @returns The hook function's return value, or `undefined` on error
- */
-export async function invokeHook(hookFilePath, context, hookOptions, logger) {
-    try {
-        // On Windows, Node's dynamic import() rejects raw filesystem paths (backslashes,
-        // drive letters) and requires a file:// URL. pathToFileURL handles both POSIX
-        // and Windows correctly, so normalize before importing.
-        const { pathToFileURL } = await import('node:url');
-        const importSpecifier = pathToFileURL(hookFilePath).href;
-        const mod = await dynamicImport(importSpecifier);
-        const hookFn = (mod.default ?? mod);
-        if (typeof hookFn !== 'function') {
-            logger?.warn(`Hook file ${hookFilePath} does not export a function`);
-            return undefined;
-        }
-        return await hookFn.call(context, hookOptions);
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        logger?.warn(`Failed to invoke hook ${hookFilePath}: ${message}`);
-        return undefined;
-    }
-}
-//# sourceMappingURL=loader.js.map

package/dist/cjs/plugins/loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/plugins/loader.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAChE,MAAM,EAAC,MAAM,EAAC,GAAG,OAAO,CAAC;IAEzB,OAAO;QACL,KAAK,CAAC,GAAG,IAAe;YACtB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,GAAG,CAAC,GAAG,IAAe;YACpB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,GAAG,IAAe;YACrB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,GAAG,IAAe;YACtB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AAEH,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAErC,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAAoB,EACpB,OAAoB,EACpB,WAAoC,EACpC,MAAe;IAEf,IAAI,CAAC;QACH,iFAAiF;QACjF,8EAA8E;QAC9E,wDAAwD;QACxD,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,eAAe,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAA6C,CAAC;QAEhF,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,aAAa,YAAY,6BAA6B,CAAC,CAAC;YACrE,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,EAAE,IAAI,CAAC,yBAAyB,YAAY,KAAK,OAAO,EAAE,CAAC,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/cjs/plugins/manager.d.ts

@@ -1,70 +0,0 @@
-import type { ConfigSource } from '../config/types.js';
-import type { Logger } from '../logging/types.js';
-import { type PluginDiscoveryOptions } from './discovery.js';
-/**
- * Options passed to plugin hooks during initialization.
- * Mirrors the shape of the CLI hook options but without oclif-specific fields.
- */
-export interface PluginHookOptions {
-    /** Named instance (if known) */
-    instance?: string;
-    /** Explicit config file path (if known) */
-    configPath?: string;
-    /** Account Manager host override */
-    accountManagerHost?: string;
-    /** CLI flags or equivalent options */
-    flags?: Record<string, unknown>;
-}
-/**
- * Orchestrates plugin discovery, loading, and hook invocation for non-oclif consumers
- * (VS Code extension, MCP server, etc.).
- *
- * Replicates the hook collection logic from `base-command.ts:412-530` without
- * depending on `@oclif/core`.
- */
-export declare class B2CPluginManager {
-    private _initialized;
-    private _middlewareApplied;
-    private _pluginNames;
-    private _sourcesBefore;
-    private _sourcesAfter;
-    private _httpMiddleware;
-    private _authMiddleware;
-    private readonly logger?;
-    private readonly discoveryOptions?;
-    constructor(options?: {
-        logger?: Logger;
-        discoveryOptions?: PluginDiscoveryOptions;
-    });
-    /**
-     * Discovers installed plugins and invokes their hooks.
-     *
-     * Collects config sources, HTTP middleware, and auth middleware providers.
-     */
-    initialize(hookOptions?: PluginHookOptions): Promise<void>;
-    /**
-     * Collects config sources from a hook result, applying priority mapping
-     * matching `base-command.ts:434-457`.
-     */
-    private collectConfigSources;
-    /**
-     * Returns the collected config sources split by priority.
-     */
-    getConfigSources(): {
-        sourcesBefore: ConfigSource[];
-        sourcesAfter: ConfigSource[];
-    };
-    /**
-     * Registers collected middleware providers and config sources with the global registries.
-     *
-     * After calling this method:
-     * - HTTP middleware is available to all SDK client factories via {@link globalMiddlewareRegistry}
-     * - Auth middleware is available to OAuth strategies via {@link globalAuthMiddlewareRegistry}
-     * - Config sources are available to {@link resolveConfig} via {@link globalConfigSourceRegistry}
-     */
-    applyMiddleware(): void;
-    /** Names of all discovered plugins */
-    get pluginNames(): string[];
-    /** Whether initialize() has been called */
-    get initialized(): boolean;
-}

package/dist/cjs/plugins/manager.js

@@ -1,173 +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
- */
-import * as path from 'node:path';
-import { globalConfigSourceRegistry } from '../config/config-source-registry.js';
-import { globalMiddlewareRegistry } from '../clients/middleware-registry.js';
-import { globalAuthMiddlewareRegistry } from '../auth/middleware.js';
-import { discoverPlugins } from './discovery.js';
-import { createHookContext, invokeHook } from './loader.js';
-/**
- * Orchestrates plugin discovery, loading, and hook invocation for non-oclif consumers
- * (VS Code extension, MCP server, etc.).
- *
- * Replicates the hook collection logic from `base-command.ts:412-530` without
- * depending on `@oclif/core`.
- */
-export class B2CPluginManager {
-    _initialized = false;
-    _middlewareApplied = false;
-    _pluginNames = [];
-    _sourcesBefore = [];
-    _sourcesAfter = [];
-    _httpMiddleware = [];
-    _authMiddleware = [];
-    logger;
-    discoveryOptions;
-    constructor(options) {
-        this.logger = options?.logger;
-        this.discoveryOptions = options?.discoveryOptions;
-    }
-    /**
-     * Discovers installed plugins and invokes their hooks.
-     *
-     * Collects config sources, HTTP middleware, and auth middleware providers.
-     */
-    async initialize(hookOptions) {
-        if (this._initialized)
-            return;
-        this._initialized = true;
-        const plugins = discoverPlugins({
-            ...this.discoveryOptions,
-            logger: this.logger,
-        });
-        if (plugins.length === 0)
-            return;
-        this._pluginNames = plugins.map((p) => p.name);
-        this.logger?.debug(`Discovered ${plugins.length} plugin(s): ${this._pluginNames.join(', ')}`);
-        const context = createHookContext({ logger: this.logger });
-        for (const plugin of plugins) {
-            // Config sources hook
-            if (plugin.hooks['b2c:config-sources']) {
-                for (const hookPath of plugin.hooks['b2c:config-sources']) {
-                    const absPath = path.resolve(plugin.packageDir, hookPath);
-                    const options = {
-                        instance: hookOptions?.instance,
-                        configPath: hookOptions?.configPath,
-                        flags: hookOptions?.flags ?? {},
-                        resolveOptions: {
-                            instance: hookOptions?.instance,
-                            configPath: hookOptions?.configPath,
-                            accountManagerHost: hookOptions?.accountManagerHost,
-                        },
-                    };
-                    const result = await invokeHook(absPath, context, options, this.logger);
-                    if (result?.sources?.length) {
-                        this.collectConfigSources(result, plugin.name);
-                    }
-                }
-            }
-            // HTTP middleware hook
-            if (plugin.hooks['b2c:http-middleware']) {
-                for (const hookPath of plugin.hooks['b2c:http-middleware']) {
-                    const absPath = path.resolve(plugin.packageDir, hookPath);
-                    const options = { flags: hookOptions?.flags ?? {} };
-                    const result = await invokeHook(absPath, context, options, this.logger);
-                    if (result?.providers?.length) {
-                        this._httpMiddleware.push(...result.providers);
-                        for (const provider of result.providers) {
-                            this.logger?.debug(`Collected HTTP middleware provider: ${provider.name} (from ${plugin.name})`);
-                        }
-                    }
-                }
-            }
-            // Auth middleware hook
-            if (plugin.hooks['b2c:auth-middleware']) {
-                for (const hookPath of plugin.hooks['b2c:auth-middleware']) {
-                    const absPath = path.resolve(plugin.packageDir, hookPath);
-                    const options = { flags: hookOptions?.flags ?? {} };
-                    const result = await invokeHook(absPath, context, options, this.logger);
-                    if (result?.providers?.length) {
-                        this._authMiddleware.push(...result.providers);
-                        for (const provider of result.providers) {
-                            this.logger?.debug(`Collected auth middleware provider: ${provider.name} (from ${plugin.name})`);
-                        }
-                    }
-                }
-            }
-        }
-    }
-    /**
-     * Collects config sources from a hook result, applying priority mapping
-     * matching `base-command.ts:434-457`.
-     */
-    collectConfigSources(result, pluginName) {
-        // Priority mapping: 'before' -> -1, 'after' -> 10, number -> as-is, undefined -> 10
-        const numericPriority = result.priority === 'before'
-            ? -1
-            : result.priority === 'after'
-                ? 10
-                : typeof result.priority === 'number'
-                    ? result.priority
-                    : 10; // default 'after'
-        // Apply priority to sources that don't already have one set
-        for (const source of result.sources) {
-            if (source.priority === undefined) {
-                source.priority = numericPriority;
-            }
-        }
-        // Split into before/after arrays (same as base-command.ts:453-457)
-        if (numericPriority < 0) {
-            this._sourcesBefore.push(...result.sources);
-        }
-        else {
-            this._sourcesAfter.push(...result.sources);
-        }
-        this.logger?.debug(`Collected ${result.sources.length} config source(s) from ${pluginName} (priority: ${result.priority ?? 'default'})`);
-    }
-    /**
-     * Returns the collected config sources split by priority.
-     */
-    getConfigSources() {
-        return {
-            sourcesBefore: this._sourcesBefore,
-            sourcesAfter: this._sourcesAfter,
-        };
-    }
-    /**
-     * Registers collected middleware providers and config sources with the global registries.
-     *
-     * After calling this method:
-     * - HTTP middleware is available to all SDK client factories via {@link globalMiddlewareRegistry}
-     * - Auth middleware is available to OAuth strategies via {@link globalAuthMiddlewareRegistry}
-     * - Config sources are available to {@link resolveConfig} via {@link globalConfigSourceRegistry}
-     */
-    applyMiddleware() {
-        if (this._middlewareApplied)
-            return;
-        this._middlewareApplied = true;
-        for (const provider of this._httpMiddleware) {
-            globalMiddlewareRegistry.register(provider);
-            this.logger?.debug(`Registered HTTP middleware provider: ${provider.name}`);
-        }
-        for (const provider of this._authMiddleware) {
-            globalAuthMiddlewareRegistry.register(provider);
-            this.logger?.debug(`Registered auth middleware provider: ${provider.name}`);
-        }
-        for (const source of [...this._sourcesBefore, ...this._sourcesAfter]) {
-            globalConfigSourceRegistry.register(source);
-            this.logger?.debug(`Registered config source: ${source.name}`);
-        }
-    }
-    /** Names of all discovered plugins */
-    get pluginNames() {
-        return this._pluginNames;
-    }
-    /** Whether initialize() has been called */
-    get initialized() {
-        return this._initialized;
-    }
-}
-//# sourceMappingURL=manager.js.map

package/dist/cjs/plugins/manager.js.map

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

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

@@ -1,12 +0,0 @@
-/**
- * Safety module for preventing destructive operations.
- *
- * @module safety
- */
-export type { SafetyAction, SafetyRule, SafetyOperation, SafetyEvaluation } from './types.js';
-export { isValidSafetyAction, VALID_SAFETY_ACTIONS } from './types.js';
-export type { SafetyLevel, SafetyConfig, SafetyConfigFragment } from './safety-middleware.js';
-export { SafetyBlockedError, SafetyConfirmationRequired, checkSafetyViolation, checkLevelViolation, getSafetyLevel, describeSafetyLevel, maxSafetyLevel, isValidSafetyLevel, parseSafetyLevelString, resolveEffectiveSafetyConfig, loadGlobalSafetyConfig, } from './safety-middleware.js';
-export { SafetyGuard, extractJobIdFromPath } from './safety-guard.js';
-export type { ConfirmHandler } from './with-confirmation.js';
-export { withSafetyConfirmation } from './with-confirmation.js';

package/dist/cjs/safety/index.js

@@ -1,11 +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 { isValidSafetyAction, VALID_SAFETY_ACTIONS } from './types.js';
-export { SafetyBlockedError, SafetyConfirmationRequired, checkSafetyViolation, checkLevelViolation, getSafetyLevel, describeSafetyLevel, maxSafetyLevel, isValidSafetyLevel, parseSafetyLevelString, resolveEffectiveSafetyConfig, loadGlobalSafetyConfig, } from './safety-middleware.js';
-// SafetyGuard
-export { SafetyGuard, extractJobIdFromPath } from './safety-guard.js';
-export { withSafetyConfirmation } from './with-confirmation.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/safety/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAC,mBAAmB,EAAE,oBAAoB,EAAC,MAAM,YAAY,CAAC;AAIrE,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,cAAc;AACd,OAAO,EAAC,WAAW,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAIpE,OAAO,EAAC,sBAAsB,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/cjs/safety/safety-guard.d.ts

@@ -1,92 +0,0 @@
-import type { SafetyConfig } from './safety-middleware.js';
-import type { SafetyEvaluation, SafetyOperation, SafetyRule } from './types.js';
-/**
- * Extract a job ID from a URL path if it's a job execution endpoint.
- *
- * Matches patterns like:
- * - `/s/-/dw/data/v24_5/jobs/sfcc-site-archive-import/executions`
- * - `/jobs/sfcc-site-archive-export/executions`
- */
-export declare function extractJobIdFromPath(path: string): string | undefined;
-/**
- * SafetyGuard evaluates operations against safety rules and levels.
- *
- * The guard provides three levels of API:
- * - {@link evaluate} — returns a {@link SafetyEvaluation} describing what should happen
- * - {@link assert} — throws {@link SafetyBlockedError} or {@link SafetyConfirmationRequired}
- * - {@link temporarilyAllow} — creates a scoped exemption for confirmed operations
- *
- * The HTTP middleware uses the guard internally so all HTTP requests are
- * evaluated automatically. CLI commands and other consumers can use the
- * guard directly for richer safety interaction (command-level checks,
- * confirmation flows).
- *
- * @example
- * ```typescript
- * const guard = new SafetyGuard({
- *   level: 'NO_UPDATE',
- *   confirm: true,
- *   rules: [{ job: 'sfcc-site-archive-export', action: 'allow' }],
- * });
- *
- * const evaluation = guard.evaluate({ type: 'job', jobId: 'sfcc-site-archive-export' });
- * // evaluation.action === 'allow'
- * ```
- */
-export declare class SafetyGuard {
-    readonly config: SafetyConfig;
-    private temporaryAllows;
-    private readonly logger;
-    constructor(config: SafetyConfig);
-    /**
-     * Evaluate an operation against safety rules and level.
-     *
-     * Evaluation order:
-     * 1. Temporary allows (from confirmed retries) — if matched, allow
-     * 2. Config rules in order — first matching rule's action wins
-     * 3. Level-based default — confirm if `confirm: true`, otherwise block/allow
-     *
-     * All evaluations are trace-logged for diagnostics.
-     */
-    evaluate(operation: SafetyOperation): SafetyEvaluation;
-    /**
-     * Assert that an operation is allowed.
-     *
-     * @throws {SafetyBlockedError} if the operation is blocked
-     * @throws {SafetyConfirmationRequired} if the operation needs confirmation
-     */
-    assert(operation: SafetyOperation): void;
-    /**
-     * Create a temporary exemption for a confirmed operation.
-     *
-     * Returns a cleanup function that removes the exemption. Use this
-     * to retry an operation after the user has confirmed.
-     */
-    temporarilyAllow(operation: SafetyOperation): () => void;
-    /**
-     * Add a temporary safety rule for a scoped exemption.
-     *
-     * Unlike {@link temporarilyAllow} which derives a rule from an operation,
-     * this accepts an arbitrary rule — useful for granting broad temporary
-     * access (e.g., allowing WebDAV DELETE on Impex paths during a job export).
-     *
-     * Returns a cleanup function that removes the rule.
-     */
-    temporarilyAddRule(rule: SafetyRule): () => void;
-    /**
-     * Evaluate an operation using only the safety level (no rules).
-     */
-    private evaluateByLevel;
-    /**
-     * Convert an operation to a temporary allow rule for retry.
-     */
-    private operationToRule;
-    /**
-     * Describe why a rule matched, for user-facing messages.
-     */
-    private describeRuleMatch;
-    /**
-     * Describe why the level blocked an operation, for user-facing messages.
-     */
-    private describeLevelBlock;
-}