@salesforce/b2c-tooling-sdk 0.0.1 → 0.0.2

package/dist/cjs/cli/lifecycle.d.ts

@@ -0,0 +1,189 @@
+import type { Hook } from '@oclif/core';
+import type { B2CInstance } from '../instance/index.js';
+import type { Logger } from '../logging/index.js';
+/**
+ * Types of B2C operations that support lifecycle hooks.
+ */
+export type B2COperationType = 'job:run' | 'job:import' | 'job:export' | 'code:deploy' | 'code:activate' | 'site-archive:import' | 'site-archive:export';
+/**
+ * Context provided to lifecycle hooks for a B2C operation.
+ *
+ * Includes the B2CInstance so plugins can access API clients and configuration
+ * without needing to construct their own instance.
+ */
+export interface B2COperationContext {
+    /** Type of operation being executed */
+    operationType: B2COperationType;
+    /** Unique ID for this operation invocation */
+    operationId: string;
+    /** B2C instance with configured API clients */
+    instance: B2CInstance;
+    /** Start timestamp */
+    startTime: number;
+    /** Operation-specific metadata (jobId, codeVersion, parameters, etc.) */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Result returned by a beforeOperation hook.
+ */
+export interface BeforeB2COperationResult {
+    /** Set to true to skip the operation */
+    skip?: boolean;
+    /** Reason for skipping (logged to user) */
+    skipReason?: string;
+    /** Modified context to pass through to afterOperation */
+    context?: Partial<B2COperationContext>;
+}
+/**
+ * Result of a B2C operation execution.
+ */
+export interface B2COperationResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Error if operation failed */
+    error?: Error;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Operation-specific result data */
+    data?: unknown;
+}
+/**
+ * Result returned by an afterOperation hook.
+ */
+export interface AfterB2COperationResult {
+    /** Additional metadata to include */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Provider interface for B2C operation lifecycle hooks.
+ *
+ * Plugins implement this interface to observe and control B2C operation execution.
+ * The context includes the B2CInstance, giving plugins access to:
+ * - `context.instance.ocapi` - OCAPI client for API calls
+ * - `context.instance.webdav` - WebDAV client for file operations
+ * - `context.instance.config` - Resolved configuration (hostname, credentials, etc.)
+ */
+export interface B2COperationLifecycleProvider {
+    /** Human-readable name for the provider (used in logging/debugging) */
+    readonly name: string;
+    /**
+     * Called before an operation executes.
+     *
+     * Can return `{ skip: true }` to prevent the operation from executing.
+     *
+     * @param context - Operation context with B2CInstance and metadata
+     * @returns Optional result to skip or modify the operation
+     */
+    beforeOperation?(context: B2COperationContext): Promise<BeforeB2COperationResult | void>;
+    /**
+     * Called after an operation completes (success or failure).
+     *
+     * @param context - Operation context with B2CInstance and metadata
+     * @param result - Operation result with success/failure info
+     * @returns Optional result with additional metadata
+     */
+    afterOperation?(context: B2COperationContext, result: B2COperationResult): Promise<AfterB2COperationResult | void>;
+}
+/**
+ * Options passed to the `b2c:operation-lifecycle` hook.
+ */
+export interface B2COperationLifecycleHookOptions {
+    /**
+     * All parsed CLI flags from the current command.
+     */
+    flags?: Record<string, unknown>;
+    /** Index signature for oclif hook compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Result returned by the `b2c:operation-lifecycle` hook.
+ */
+export interface B2COperationLifecycleHookResult {
+    /** Lifecycle providers to register */
+    providers: B2COperationLifecycleProvider[];
+}
+/**
+ * Hook type for `b2c:operation-lifecycle`.
+ *
+ * Implement this hook in your oclif plugin to receive B2C operation lifecycle events
+ * for jobs, deployments, and other B2C Commerce operations.
+ *
+ * ## Plugin Registration
+ *
+ * Register the hook in your plugin's package.json:
+ *
+ * ```json
+ * {
+ *   "oclif": {
+ *     "hooks": {
+ *       "b2c:operation-lifecycle": "./dist/hooks/operation-lifecycle.js"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import type { B2COperationLifecycleHook } from '@salesforce/b2c-tooling-sdk/cli';
+ *
+ * const hook: B2COperationLifecycleHook = async function(options) {
+ *   return {
+ *     providers: [{
+ *       name: 'my-audit-provider',
+ *       async beforeOperation(context) {
+ *         // Access context.instance for API calls
+ *         // Log or check policies before operation
+ *       },
+ *       async afterOperation(context, result) {
+ *         // Log results, send notifications, etc.
+ *       },
+ *     }],
+ *   };
+ * };
+ *
+ * export default hook;
+ * ```
+ */
+export type B2COperationLifecycleHook = Hook<'b2c:operation-lifecycle'>;
+/**
+ * Creates a new B2C operation context for lifecycle hooks.
+ *
+ * @param operationType - Type of B2C operation
+ * @param metadata - Operation-specific metadata
+ * @param instance - B2C instance with configured clients
+ * @returns New operation context
+ */
+export declare function createB2COperationContext(operationType: B2COperationType, metadata: Record<string, unknown>, instance: B2CInstance): B2COperationContext;
+/**
+ * Helper class for running B2C lifecycle hooks in CLI commands.
+ *
+ * This class is used internally by CLI commands to collect and invoke
+ * lifecycle providers from plugins.
+ */
+export declare class B2CLifecycleRunner {
+    private providers;
+    private logger?;
+    constructor(logger?: Logger);
+    /**
+     * Adds providers to this runner.
+     */
+    addProviders(providers: B2COperationLifecycleProvider[]): void;
+    /**
+     * Runs beforeOperation hooks for all providers.
+     *
+     * @param context - Operation context
+     * @returns Aggregated result (skip if any provider requests skip)
+     */
+    runBefore(context: B2COperationContext): Promise<BeforeB2COperationResult>;
+    /**
+     * Runs afterOperation hooks for all providers.
+     *
+     * @param context - Operation context
+     * @param result - Operation result
+     */
+    runAfter(context: B2COperationContext, result: B2COperationResult): Promise<void>;
+    /**
+     * Returns the number of registered providers.
+     */
+    get size(): number;
+}

package/dist/cjs/cli/lifecycle.js

@@ -0,0 +1,130 @@
+/*
+ * 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
+ */
+/**
+ * B2C operation lifecycle types for CLI plugin extensibility.
+ *
+ * This module defines the interfaces for B2C-specific operation lifecycle hooks
+ * that allow CLI plugins to observe and control operation execution for jobs,
+ * deployments, and other B2C Commerce operations.
+ *
+ * ## Plugin Usage
+ *
+ * Plugins implement the `b2c:operation-lifecycle` hook to receive lifecycle events:
+ *
+ * ```typescript
+ * import type { B2COperationLifecycleHook, B2COperationLifecycleProvider } from '@salesforce/b2c-tooling-sdk/cli';
+ *
+ * const auditProvider: B2COperationLifecycleProvider = {
+ *   name: 'audit-logger',
+ *   async beforeOperation(context) {
+ *     console.log(`Starting ${context.operationType}: ${context.operationId}`);
+ *     // Return { skip: true } to prevent execution
+ *   },
+ *   async afterOperation(context, result) {
+ *     console.log(`Completed ${context.operationType}: ${result.success ? 'SUCCESS' : 'FAILED'}`);
+ *   },
+ * };
+ *
+ * const hook: B2COperationLifecycleHook = async function() {
+ *   return { providers: [auditProvider] };
+ * };
+ *
+ * export default hook;
+ * ```
+ *
+ * @module cli/lifecycle
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Creates a new B2C operation context for lifecycle hooks.
+ *
+ * @param operationType - Type of B2C operation
+ * @param metadata - Operation-specific metadata
+ * @param instance - B2C instance with configured clients
+ * @returns New operation context
+ */
+export function createB2COperationContext(operationType, metadata, instance) {
+    return {
+        operationType,
+        operationId: randomUUID(),
+        instance,
+        startTime: Date.now(),
+        metadata,
+    };
+}
+/**
+ * Helper class for running B2C lifecycle hooks in CLI commands.
+ *
+ * This class is used internally by CLI commands to collect and invoke
+ * lifecycle providers from plugins.
+ */
+export class B2CLifecycleRunner {
+    providers = [];
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Adds providers to this runner.
+     */
+    addProviders(providers) {
+        this.providers.push(...providers);
+    }
+    /**
+     * Runs beforeOperation hooks for all providers.
+     *
+     * @param context - Operation context
+     * @returns Aggregated result (skip if any provider requests skip)
+     */
+    async runBefore(context) {
+        const aggregatedResult = {};
+        for (const provider of this.providers) {
+            if (!provider.beforeOperation)
+                continue;
+            try {
+                const result = await provider.beforeOperation(context);
+                if (result?.skip) {
+                    this.logger?.debug(`Provider ${provider.name} requested skip: ${result.skipReason}`);
+                    return result; // First skip wins
+                }
+                if (result?.context) {
+                    Object.assign(context.metadata, result.context);
+                }
+            }
+            catch (error) {
+                // Don't fail the operation on hook errors
+                this.logger?.warn(`Lifecycle provider ${provider.name} beforeOperation failed: ${error}`);
+            }
+        }
+        return aggregatedResult;
+    }
+    /**
+     * Runs afterOperation hooks for all providers.
+     *
+     * @param context - Operation context
+     * @param result - Operation result
+     */
+    async runAfter(context, result) {
+        for (const provider of this.providers) {
+            if (!provider.afterOperation)
+                continue;
+            try {
+                await provider.afterOperation(context, result);
+            }
+            catch (error) {
+                // Don't fail on hook errors
+                this.logger?.warn(`Lifecycle provider ${provider.name} afterOperation failed: ${error}`);
+            }
+        }
+    }
+    /**
+     * Returns the number of registered providers.
+     */
+    get size() {
+        return this.providers.length;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/cjs/cli/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/cli/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAuKvC;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAA+B,EAC/B,QAAiC,EACjC,QAAqB;IAErB,OAAO;QACL,aAAa;QACb,WAAW,EAAE,UAAU,EAAE;QACzB,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACrB,SAAS,GAAoC,EAAE,CAAC;IAChD,MAAM,CAAU;IAExB,YAAY,MAAe;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAA0C;QACrD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,OAA4B;QAC1C,MAAM,gBAAgB,GAA6B,EAAE,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,eAAe;gBAAE,SAAS;YAExC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACvD,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;oBACjB,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;oBACrF,OAAO,MAAM,CAAC,CAAC,kBAAkB;gBACnC,CAAC;gBACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0CAA0C;gBAC1C,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,4BAA4B,KAAK,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA4B,EAAE,MAA0B;QACrE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,cAAc;gBAAE,SAAS;YAEvC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,4BAA4B;gBAC5B,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,QAAQ,CAAC,IAAI,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF"}

package/dist/cjs/cli/mrt-command.d.ts

@@ -0,0 +1,61 @@
+import { Command } from '@oclif/core';
+import { BaseCommand } from './base-command.js';
+import type { ResolvedB2CConfig } from '../config/index.js';
+import type { AuthStrategy } from '../auth/types.js';
+import { MrtClient } from '../platform/mrt.js';
+import type { MrtProject } from '../platform/mrt.js';
+/**
+ * Base command for Managed Runtime (MRT) operations.
+ * Uses API key authentication.
+ *
+ * API key resolution order:
+ * 1. --api-key flag
+ * 2. SFCC_MRT_API_KEY environment variable
+ * 3. ~/.mobify config file (api_key field), or ~/.mobify--[hostname] if --cloud-origin is set
+ *
+ * Project/environment resolution order:
+ * 1. --project / --environment flags
+ * 2. SFCC_MRT_PROJECT / SFCC_MRT_ENVIRONMENT environment variables
+ * 3. dw.json (mrtProject / mrtEnvironment fields)
+ *
+ * Cloud origin resolution:
+ * 1. --cloud-origin flag
+ * 2. SFCC_MRT_CLOUD_ORIGIN environment variable
+ * 3. Default: https://cloud.mobify.com
+ */
+export declare abstract class MrtCommand<T extends typeof Command> extends BaseCommand<T> {
+    static baseFlags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'cloud-origin': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'credentials-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected loadConfiguration(): ResolvedB2CConfig;
+    /**
+     * Gets an API key auth strategy for MRT.
+     */
+    protected getMrtAuth(): AuthStrategy;
+    /**
+     * Check if MRT credentials are available.
+     */
+    protected hasMrtCredentials(): boolean;
+    /**
+     * Validates that MRT credentials are configured, errors if not.
+     */
+    protected requireMrtCredentials(): void;
+    /**
+     * Creates an MRT client for the given project.
+     */
+    protected createMrtClient(project: MrtProject): MrtClient;
+}

package/dist/cjs/cli/mrt-command.js

@@ -0,0 +1,113 @@
+/*
+ * 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 { Flags } from '@oclif/core';
+import { BaseCommand } from './base-command.js';
+import { loadConfig } from './config.js';
+import { MrtClient } from '../platform/mrt.js';
+import { t } from '../i18n/index.js';
+import { DEFAULT_MRT_ORIGIN } from '../clients/mrt.js';
+/**
+ * Base command for Managed Runtime (MRT) operations.
+ * Uses API key authentication.
+ *
+ * API key resolution order:
+ * 1. --api-key flag
+ * 2. SFCC_MRT_API_KEY environment variable
+ * 3. ~/.mobify config file (api_key field), or ~/.mobify--[hostname] if --cloud-origin is set
+ *
+ * Project/environment resolution order:
+ * 1. --project / --environment flags
+ * 2. SFCC_MRT_PROJECT / SFCC_MRT_ENVIRONMENT environment variables
+ * 3. dw.json (mrtProject / mrtEnvironment fields)
+ *
+ * Cloud origin resolution:
+ * 1. --cloud-origin flag
+ * 2. SFCC_MRT_CLOUD_ORIGIN environment variable
+ * 3. Default: https://cloud.mobify.com
+ */
+export class MrtCommand extends BaseCommand {
+    static baseFlags = {
+        ...BaseCommand.baseFlags,
+        'api-key': Flags.string({
+            description: 'MRT API key',
+            env: 'SFCC_MRT_API_KEY',
+            helpGroup: 'AUTH',
+        }),
+        project: Flags.string({
+            char: 'p',
+            description: 'MRT project slug (or set mrtProject in dw.json)',
+            env: 'SFCC_MRT_PROJECT',
+        }),
+        environment: Flags.string({
+            char: 'e',
+            description: 'MRT environment (e.g., staging, production; or set mrtEnvironment in dw.json)',
+            env: 'SFCC_MRT_ENVIRONMENT',
+        }),
+        'cloud-origin': Flags.string({
+            description: `MRT cloud origin URL (default: ${DEFAULT_MRT_ORIGIN})`,
+            env: 'SFCC_MRT_CLOUD_ORIGIN',
+        }),
+        'credentials-file': Flags.string({
+            description: 'Path to MRT credentials file (overrides default ~/.mobify)',
+            env: 'MRT_CREDENTIALS_FILE',
+        }),
+    };
+    loadConfiguration() {
+        const cloudOrigin = this.flags['cloud-origin'];
+        const credentialsFile = this.flags['credentials-file'];
+        const options = {
+            instance: this.flags.instance,
+            configPath: this.flags.config,
+            cloudOrigin, // MobifySource uses this to load ~/.mobify--[hostname] if set
+            credentialsFile, // Override path to MRT credentials file
+        };
+        const flagConfig = {
+            // Flag/env takes precedence, ConfigResolver handles ~/.mobify fallback
+            mrtApiKey: this.flags['api-key'],
+            // Project/environment from flags
+            mrtProject: this.flags.project,
+            mrtEnvironment: this.flags.environment,
+            // Cloud origin override
+            mrtOrigin: cloudOrigin,
+        };
+        const pluginSources = {
+            before: this.pluginSourcesBefore,
+            after: this.pluginSourcesAfter,
+        };
+        return loadConfig(flagConfig, options, pluginSources);
+    }
+    /**
+     * Gets an API key auth strategy for MRT.
+     */
+    getMrtAuth() {
+        if (this.resolvedConfig.hasMrtConfig()) {
+            return this.resolvedConfig.createMrtAuth();
+        }
+        throw new Error(t('error.mrtApiKeyRequired', 'MRT API key required. Provide --api-key, set SFCC_MRT_API_KEY, or configure ~/.mobify'));
+    }
+    /**
+     * Check if MRT credentials are available.
+     */
+    hasMrtCredentials() {
+        return this.resolvedConfig.hasMrtConfig();
+    }
+    /**
+     * Validates that MRT credentials are configured, errors if not.
+     */
+    requireMrtCredentials() {
+        if (!this.hasMrtCredentials()) {
+            this.error(t('error.mrtApiKeyRequired', 'MRT API key required. Provide --api-key, set SFCC_MRT_API_KEY, or configure ~/.mobify'));
+        }
+    }
+    /**
+     * Creates an MRT client for the given project.
+     */
+    createMrtClient(project) {
+        this.requireMrtCredentials();
+        return new MrtClient(project, this.getMrtAuth());
+    }
+}
+//# sourceMappingURL=mrt-command.js.map

package/dist/cjs/cli/mrt-command.js.map

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

package/dist/cjs/cli/oauth-command.d.ts

@@ -0,0 +1,70 @@
+import { Command } from '@oclif/core';
+import { BaseCommand } from './base-command.js';
+import type { AuthMethod } from './config.js';
+import type { ResolvedB2CConfig } from '../config/index.js';
+import { OAuthStrategy } from '../auth/oauth.js';
+import { ImplicitOAuthStrategy } from '../auth/oauth-implicit.js';
+/**
+ * Base command for operations requiring OAuth authentication.
+ * Use this for platform-level operations like ODS, APIs.
+ *
+ * Environment variables:
+ * - SFCC_CLIENT_ID: OAuth client ID
+ * - SFCC_CLIENT_SECRET: OAuth client secret
+ *
+ * For B2C instance specific operations, use InstanceCommand instead.
+ */
+export declare abstract class OAuthCommand<T extends typeof Command> extends BaseCommand<T> {
+    static baseFlags: {
+        'client-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-secret': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        scope: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'short-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'auth-methods': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'account-manager-host': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<"trace" | "debug" | "info" | "warn" | "error" | "silent" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        debug: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Parses auth methods from flags.
+     * Returns methods in the order specified (priority order).
+     */
+    protected parseAuthMethods(): AuthMethod[] | undefined;
+    protected loadConfiguration(): ResolvedB2CConfig;
+    /**
+     * Gets the configured Account Manager host.
+     */
+    protected get accountManagerHost(): string;
+    /**
+     * Gets an OAuth auth strategy based on allowed auth methods and available credentials.
+     *
+     * Iterates through allowed methods (in priority order) and returns the first
+     * strategy for which the required credentials are available.
+     *
+     * @throws Error if no allowed method has the required credentials configured
+     */
+    protected getOAuthStrategy(): OAuthStrategy | ImplicitOAuthStrategy;
+    /**
+     * Check if OAuth credentials are available.
+     * Returns true if clientId is configured (with or without clientSecret).
+     */
+    protected hasOAuthCredentials(): boolean;
+    /**
+     * Check if full OAuth credentials (client credentials flow) are available.
+     * Returns true only if both clientId and clientSecret are configured.
+     */
+    protected hasFullOAuthCredentials(): boolean;
+    /**
+     * Validates that OAuth credentials are configured, errors if not.
+     * Only clientId is required (implicit flow can be used without clientSecret).
+     */
+    protected requireOAuthCredentials(): void;
+}