@salesforce/b2c-tooling-sdk 0.0.8 → 0.2.0

package/dist/cjs/skills/parser.js

@@ -0,0 +1,131 @@
+/*
+ * 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 fs from 'node:fs';
+import * as path from 'node:path';
+import { getLogger } from '../logging/logger.js';
+/**
+ * Parse simple YAML-like frontmatter from SKILL.md content.
+ * Only supports basic key: value pairs (name and description).
+ *
+ * @param content - File content with frontmatter
+ * @returns Parsed frontmatter or null if invalid
+ */
+export function parseSkillFrontmatter(content) {
+    // Match frontmatter between --- delimiters
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match) {
+        return null;
+    }
+    const frontmatter = match[1];
+    const result = {};
+    // Parse simple key: value lines
+    for (const line of frontmatter.split('\n')) {
+        const keyValueMatch = line.match(/^(\w+):\s*(.+)$/);
+        if (keyValueMatch) {
+            const [, key, value] = keyValueMatch;
+            if (key === 'name') {
+                result.name = value.trim();
+            }
+            else if (key === 'description') {
+                result.description = value.trim();
+            }
+        }
+    }
+    if (!result.name || !result.description) {
+        return null;
+    }
+    return { name: result.name, description: result.description };
+}
+/**
+ * Scan a directory for skills and extract their metadata.
+ *
+ * @param skillsDir - Path to extracted skills directory (e.g., ~/.cache/b2c-cli/skills/v0.1.0/b2c/skills/)
+ * @param skillSet - The skill set being scanned ('b2c' or 'b2c-cli')
+ * @returns Array of skill metadata
+ */
+export async function scanSkills(skillsDir, skillSet) {
+    const logger = getLogger();
+    const skills = [];
+    // The extracted structure should be: skillsDir/skills/skill-name/SKILL.md
+    // Find the skills subdirectory
+    const skillsSubdir = path.join(skillsDir, 'skills');
+    if (!fs.existsSync(skillsSubdir)) {
+        logger.debug({ skillsDir, skillsSubdir }, 'Skills subdirectory not found');
+        return skills;
+    }
+    const entries = await fs.promises.readdir(skillsSubdir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const skillDir = path.join(skillsSubdir, entry.name);
+        const skillPath = path.join(skillDir, 'SKILL.md');
+        if (!fs.existsSync(skillPath)) {
+            logger.debug({ skillDir }, 'No SKILL.md found, skipping');
+            continue;
+        }
+        try {
+            const content = await fs.promises.readFile(skillPath, 'utf-8');
+            const frontmatter = parseSkillFrontmatter(content);
+            if (!frontmatter) {
+                logger.warn({ skillPath }, 'Invalid frontmatter in SKILL.md');
+                continue;
+            }
+            // Check for references directory
+            const referencesDir = path.join(skillDir, 'references');
+            const hasReferences = fs.existsSync(referencesDir);
+            skills.push({
+                name: frontmatter.name,
+                description: frontmatter.description,
+                skillSet,
+                path: entry.name, // Relative path within skills directory
+                hasReferences,
+            });
+        }
+        catch (error) {
+            logger.warn({ skillPath, error }, 'Failed to parse SKILL.md');
+        }
+    }
+    logger.debug({ count: skills.length, skillSet }, 'Scanned skills');
+    return skills;
+}
+/**
+ * Filter skills by name.
+ *
+ * @param skills - All available skills
+ * @param names - Skill names to include (if provided)
+ * @returns Filtered skills
+ */
+export function filterSkillsByName(skills, names) {
+    if (!names || names.length === 0) {
+        return skills;
+    }
+    const nameSet = new Set(names);
+    return skills.filter((skill) => nameSet.has(skill.name));
+}
+/**
+ * Find skills that match the given names, returning any that weren't found.
+ *
+ * @param skills - Available skills
+ * @param names - Requested skill names
+ * @returns Object with matched skills and names not found
+ */
+export function findSkillsByName(skills, names) {
+    const skillMap = new Map(skills.map((s) => [s.name, s]));
+    const found = [];
+    const notFound = [];
+    for (const name of names) {
+        const skill = skillMap.get(name);
+        if (skill) {
+            found.push(skill);
+        }
+        else {
+            notFound.push(name);
+        }
+    }
+    return { found, notFound };
+}
+//# sourceMappingURL=parser.js.map

package/dist/cjs/skills/parser.js.map

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

package/dist/cjs/skills/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Supported IDE types for skill installation.
+ */
+export type IdeType = 'claude-code' | 'cursor' | 'windsurf' | 'vscode' | 'codex' | 'opencode' | 'manual';
+/**
+ * Skill set categories matching the plugins directory structure.
+ */
+export type SkillSet = 'b2c' | 'b2c-cli';
+/**
+ * IDE path configuration for skill installation.
+ */
+export interface IdePaths {
+    /** Relative path for project-level installation (e.g., '.claude/skills') */
+    projectDir: string;
+    /** Absolute path for global/user-level installation (e.g., '~/.claude/skills') */
+    globalDir: string;
+}
+/**
+ * IDE configuration including paths and display name.
+ */
+export interface IdeConfig {
+    /** IDE identifier */
+    id: IdeType;
+    /** Human-readable display name */
+    displayName: string;
+    /** Installation paths */
+    paths: IdePaths;
+    /** Function to detect if IDE is installed */
+    detectInstalled: () => Promise<boolean>;
+    /** Optional documentation URL for skill configuration */
+    docsUrl?: string;
+}
+/**
+ * Skill metadata extracted from SKILL.md frontmatter.
+ */
+export interface SkillMetadata {
+    /** Skill identifier from frontmatter name field */
+    name: string;
+    /** Skill description from frontmatter */
+    description: string;
+    /** Skill set this skill belongs to (b2c or b2c-cli) */
+    skillSet: SkillSet;
+    /** Relative path within the skills archive */
+    path: string;
+    /** Whether this skill has a references/ subdirectory */
+    hasReferences: boolean;
+}
+/**
+ * GitHub release information.
+ */
+export interface ReleaseInfo {
+    /** Git tag name (e.g., 'v0.1.0') */
+    tagName: string;
+    /** Version number without 'v' prefix */
+    version: string;
+    /** ISO date string when release was published */
+    publishedAt: string;
+    /** Download URL for b2c-skills.zip asset, or null if not present */
+    b2cSkillsAssetUrl: string | null;
+    /** Download URL for b2c-cli-skills.zip asset, or null if not present */
+    b2cCliSkillsAssetUrl: string | null;
+}
+/**
+ * Options for downloading skills artifacts.
+ */
+export interface DownloadSkillsOptions {
+    /** Specific release version to download (default: 'latest') */
+    version?: string;
+    /** Custom cache directory (default: ~/.cache/b2c-cli/skills/) */
+    cacheDir?: string;
+    /** Force re-download even if cached */
+    forceDownload?: boolean;
+}
+/**
+ * Options for installing skills.
+ */
+export interface InstallSkillsOptions {
+    /** Specific skill names to install (default: all skills in skillset) */
+    skills?: string[];
+    /** Target IDEs to install to */
+    ides: IdeType[];
+    /** Install to global/user directory instead of project */
+    global: boolean;
+    /** Overwrite existing skills */
+    update: boolean;
+    /** Project root for project-level installations */
+    projectRoot?: string;
+}
+/**
+ * Result of a single skill installation.
+ */
+export interface SkillInstallation {
+    skill: string;
+    ide: IdeType;
+    path: string;
+}
+/**
+ * Reason for skipping a skill installation.
+ */
+export interface SkillSkipped {
+    skill: string;
+    ide: IdeType;
+    reason: string;
+}
+/**
+ * Error during skill installation.
+ */
+export interface SkillError {
+    skill: string;
+    ide: IdeType;
+    error: string;
+}
+/**
+ * Result of installing skills.
+ */
+export interface InstallSkillsResult {
+    /** Successfully installed skills */
+    installed: SkillInstallation[];
+    /** Skipped skills (already exist, no update flag) */
+    skipped: SkillSkipped[];
+    /** Failed installations */
+    errors: SkillError[];
+}
+/**
+ * Cached artifact metadata stored in manifest.json.
+ */
+export interface CachedArtifact {
+    /** Version of the cached artifact */
+    version: string;
+    /** Path to the extracted skills directory */
+    path: string;
+    /** ISO date string when artifact was downloaded */
+    downloadedAt: string;
+}

package/dist/cjs/skills/types.js

@@ -0,0 +1,7 @@
+/*
+ * 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 {};
+//# sourceMappingURL=types.js.map

package/dist/cjs/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cjs/test-utils/config-isolation.d.ts

@@ -0,0 +1,2 @@
+export declare function isolateConfig(): void;
+export declare function restoreConfig(): void;

package/dist/cjs/test-utils/config-isolation.js

@@ -0,0 +1,41 @@
+/*
+ * 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
+ */
+const ADDITIONAL_ENV_VARS = ['LANGUAGE', 'NO_COLOR'];
+let state = null;
+export function isolateConfig() {
+    if (state)
+        throw new Error('isolateConfig() called without cleanup - call restoreConfig() first');
+    const savedEnvVars = {};
+    for (const key of Object.keys(process.env)) {
+        if (key.startsWith('SFCC_') || key.startsWith('MRT_')) {
+            savedEnvVars[key] = process.env[key];
+            delete process.env[key];
+        }
+    }
+    for (const key of ADDITIONAL_ENV_VARS) {
+        savedEnvVars[key] = process.env[key];
+        delete process.env[key];
+    }
+    process.env.SFCC_CONFIG = '/dev/null';
+    process.env.MRT_CREDENTIALS_FILE = '/dev/null';
+    state = { savedEnvVars };
+}
+export function restoreConfig() {
+    if (!state)
+        return;
+    delete process.env.SFCC_CONFIG;
+    delete process.env.MRT_CREDENTIALS_FILE;
+    for (const [key, value] of Object.entries(state.savedEnvVars)) {
+        if (value === undefined) {
+            delete process.env[key];
+        }
+        else {
+            process.env[key] = value;
+        }
+    }
+    state = null;
+}
+//# sourceMappingURL=config-isolation.js.map

package/dist/cjs/test-utils/config-isolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-isolation.js","sourceRoot":"","sources":["../../../src/test-utils/config-isolation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAMrD,IAAI,KAAK,GAA0B,IAAI,CAAC;AAExC,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAElG,MAAM,YAAY,GAAuC,EAAE,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC;IAE/C,KAAK,GAAG,EAAC,YAAY,EAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAExC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/cjs/test-utils/index.d.ts

@@ -0,0 +1 @@
+export { isolateConfig, restoreConfig } from './config-isolation.js';

package/dist/cjs/test-utils/index.js

@@ -0,0 +1,7 @@
+/*
+ * 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 { isolateConfig, restoreConfig } from './config-isolation.js';
+//# sourceMappingURL=index.js.map

package/dist/cjs/test-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,uBAAuB,CAAC"}

package/dist/cjs/version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The SDK package name.
+ */
+export declare const SDK_NAME: string;
+/**
+ * The SDK package version.
+ */
+export declare const SDK_VERSION: string;
+/**
+ * Default User-Agent string for the SDK.
+ *
+ * Format: `b2c-tooling-sdk/0.1.0`
+ */
+export declare const SDK_USER_AGENT: string;

package/dist/cjs/version.js

@@ -0,0 +1,29 @@
+/*
+ * 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
+ */
+/**
+ * SDK version information and User-Agent string.
+ *
+ * @module version
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+// Use the package.json exports path to resolve correctly from both src/ and dist/
+const pkg = require('@salesforce/b2c-tooling-sdk/package.json');
+/**
+ * The SDK package name.
+ */
+export const SDK_NAME = pkg.name;
+/**
+ * The SDK package version.
+ */
+export const SDK_VERSION = pkg.version;
+/**
+ * Default User-Agent string for the SDK.
+ *
+ * Format: `b2c-tooling-sdk/0.1.0`
+ */
+export const SDK_USER_AGENT = `${SDK_NAME.replace(/^@salesforce\//, '')}/${SDK_VERSION}`;
+//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,kFAAkF;AAClF,MAAM,GAAG,GAAG,OAAO,CAAC,0CAA0C,CAAoC,CAAC;AAEnG;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC"}

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

@@ -63,3 +63,5 @@ export type { ImplicitOAuthConfig } from './oauth-implicit.js';
 export { ApiKeyStrategy } from './api-key.js';
 export { resolveAuthStrategy, checkAvailableAuthMethods } from './resolve.js';
 export type { ResolveAuthStrategyOptions, AvailableAuthMethods } from './resolve.js';
+export { globalAuthMiddlewareRegistry, AuthMiddlewareRegistry, applyAuthRequestMiddleware, applyAuthResponseMiddleware, } from './middleware.js';
+export type { AuthMiddleware, AuthMiddlewareProvider } from './middleware.js';

package/dist/esm/auth/index.js

@@ -66,4 +66,6 @@ export { ImplicitOAuthStrategy } from './oauth-implicit.js';
 export { ApiKeyStrategy } from './api-key.js';
 // Resolution helpers
 export { resolveAuthStrategy, checkAvailableAuthMethods } from './resolve.js';
+// Auth middleware
+export { globalAuthMiddlewareRegistry, AuthMiddlewareRegistry, applyAuthRequestMiddleware, applyAuthResponseMiddleware, } from './middleware.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAcH,OAAO,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAE5C,aAAa;AACb,OAAO,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C,qBAAqB;AACrB,OAAO,EAAC,mBAAmB,EAAE,yBAAyB,EAAC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAcH,OAAO,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAE5C,aAAa;AACb,OAAO,EAAC,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C,qBAAqB;AACrB,OAAO,EAAC,mBAAmB,EAAE,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAG5E,kBAAkB;AAClB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/esm/auth/middleware.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Auth Middleware Registry for B2C SDK.
+ *
+ * Provides a middleware system specifically for authentication requests (OAuth token requests).
+ * This is separate from the HTTP middleware registry because auth requests bypass the
+ * standard openapi-fetch client middleware chain.
+ *
+ * ## SDK Usage
+ *
+ * ```typescript
+ * import { globalAuthMiddlewareRegistry, AuthMiddlewareProvider } from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const loggingProvider: AuthMiddlewareProvider = {
+ *   name: 'auth-logger',
+ *   getMiddleware() {
+ *     return {
+ *       onRequest({ request }) {
+ *         console.log(`[Auth] ${request.method} ${request.url}`);
+ *         return request;
+ *       },
+ *       onResponse({ response }) {
+ *         console.log(`[Auth] ${response.status}`);
+ *         return response;
+ *       },
+ *     };
+ *   },
+ * };
+ *
+ * globalAuthMiddlewareRegistry.register(loggingProvider);
+ * ```
+ *
+ * ## CLI Plugin Usage
+ *
+ * Plugins can provide auth middleware via the `b2c:auth-middleware` hook.
+ *
+ * @module auth/middleware
+ */
+/**
+ * Middleware interface for authentication requests.
+ *
+ * Similar to openapi-fetch's Middleware interface, but simplified for auth requests.
+ */
+export interface AuthMiddleware {
+    /**
+     * Called before the auth request is sent.
+     * Can modify the request or return a new one.
+     *
+     * @param params - Object containing the request
+     * @returns Modified request, or void to use original
+     */
+    onRequest?(params: {
+        request: Request;
+    }): Promise<Request | void>;
+    /**
+     * Called after the auth response is received.
+     * Can modify the response or return a new one.
+     *
+     * @param params - Object containing request and response
+     * @returns Modified response, or void to use original
+     */
+    onResponse?(params: {
+        request: Request;
+        response: Response;
+    }): Promise<Response | void>;
+}
+/**
+ * Middleware provider that supplies middleware for auth requests.
+ *
+ * @example
+ * ```typescript
+ * const provider: AuthMiddlewareProvider = {
+ *   name: 'user-agent',
+ *   getMiddleware() {
+ *     return {
+ *       onRequest({ request }) {
+ *         request.headers.set('User-Agent', 'my-app/1.0');
+ *         return request;
+ *       },
+ *     };
+ *   },
+ * };
+ * ```
+ */
+export interface AuthMiddlewareProvider {
+    /**
+     * Human-readable name for the provider (used in logging/debugging).
+     */
+    readonly name: string;
+    /**
+     * Returns middleware for auth requests.
+     *
+     * @returns Middleware to apply, or undefined to skip
+     */
+    getMiddleware(): AuthMiddleware | undefined;
+}
+/**
+ * Registry for auth middleware providers.
+ *
+ * The registry collects middleware from multiple providers and returns
+ * them in registration order when requested during OAuth token requests.
+ *
+ * ## Usage Modes
+ *
+ * **SDK Mode**: Register providers directly via `register()`:
+ * ```typescript
+ * globalAuthMiddlewareRegistry.register(myProvider);
+ * ```
+ *
+ * **CLI Mode**: Providers are collected via the `b2c:auth-middleware` hook
+ * and registered during command initialization.
+ */
+export declare class AuthMiddlewareRegistry {
+    private providers;
+    /**
+     * Registers a middleware provider.
+     *
+     * Providers are called in registration order when middleware is requested.
+     *
+     * @param provider - The provider to register
+     */
+    register(provider: AuthMiddlewareProvider): void;
+    /**
+     * Unregisters a middleware provider by name.
+     *
+     * @param name - The name of the provider to remove
+     * @returns true if a provider was removed, false if not found
+     */
+    unregister(name: string): boolean;
+    /**
+     * Collects middleware from all providers.
+     *
+     * @returns Array of middleware in registration order
+     */
+    getMiddleware(): AuthMiddleware[];
+    /**
+     * Clears all registered providers.
+     *
+     * Primarily useful for testing.
+     */
+    clear(): void;
+    /**
+     * Returns the number of registered providers.
+     */
+    get size(): number;
+    /**
+     * Returns the names of all registered providers.
+     */
+    getProviderNames(): string[];
+}
+/**
+ * Global auth middleware registry instance.
+ *
+ * This is the default registry used by OAuth strategies. Register
+ * middleware providers here to have them applied to token requests.
+ *
+ * @example
+ * ```typescript
+ * import { globalAuthMiddlewareRegistry } from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * globalAuthMiddlewareRegistry.register({
+ *   name: 'user-agent',
+ *   getMiddleware() {
+ *     return {
+ *       onRequest({ request }) {
+ *         request.headers.set('User-Agent', 'my-app/1.0');
+ *         return request;
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare const globalAuthMiddlewareRegistry: AuthMiddlewareRegistry;
+/**
+ * Applies auth middleware to a request.
+ *
+ * This helper applies all registered `onRequest` middleware in order,
+ * accumulating modifications to the request.
+ *
+ * @param request - The original request
+ * @param middleware - Array of middleware to apply
+ * @returns The modified request
+ */
+export declare function applyAuthRequestMiddleware(request: Request, middleware: AuthMiddleware[]): Promise<Request>;
+/**
+ * Applies auth middleware to a response.
+ *
+ * This helper applies all registered `onResponse` middleware in order,
+ * accumulating modifications to the response.
+ *
+ * @param request - The original request (for context)
+ * @param response - The response to process
+ * @param middleware - Array of middleware to apply
+ * @returns The modified response
+ */
+export declare function applyAuthResponseMiddleware(request: Request, response: Response, middleware: AuthMiddleware[]): Promise<Response>;