@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/operations/sites/index.js

@@ -1,51 +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
- */
-/**
- * Site operations for B2C Commerce instances.
- *
- * This module provides functions for managing site cartridge paths
- * on B2C Commerce instances. Operations work via OCAPI Data API with
- * automatic fallback to site archive import/export when OCAPI permissions
- * are unavailable. Business Manager (Sites-Site) is supported via the
- * import/export mechanism.
- *
- * ## Cartridge Path Functions
- *
- * - {@link getCartridgePath} - Get the current cartridge path for a site
- * - {@link addCartridge} - Add a cartridge at a specific position
- * - {@link removeCartridge} - Remove a cartridge from the path
- * - {@link setCartridgePath} - Replace the entire cartridge path
- *
- * ## Usage
- *
- * ```typescript
- * import {getCartridgePath, addCartridge, setCartridgePath} from '@salesforce/b2c-tooling-sdk/operations/sites';
- * import {resolveConfig} from '@salesforce/b2c-tooling-sdk/config';
- *
- * const config = resolveConfig();
- * const instance = config.createB2CInstance();
- *
- * // List cartridge path
- * const result = await getCartridgePath(instance, 'RefArch');
- * console.log(result.cartridgeList);
- *
- * // Add a cartridge
- * await addCartridge(instance, 'RefArch', { name: 'my_cartridge', position: 'first' });
- *
- * // Business Manager
- * await addCartridge(instance, 'Sites-Site', { name: 'bm_ext', position: 'first' });
- * ```
- *
- * ## Authentication
- *
- * Cartridge path operations require OAuth authentication. For OCAPI direct updates,
- * grant POST/PUT/DELETE on `/sites/∗/cartridges`. For import/export fallback,
- * grant job execution permissions and WebDAV write access.
- *
- * @module operations/sites
- */
-export { getCartridgePath, addCartridge, removeCartridge, setCartridgePath, BM_SITE_ID } from './cartridges.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/operations/sites/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/sites/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,EAAC,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAC,MAAM,iBAAiB,CAAC"}

package/dist/cjs/operations/users/index.d.ts

@@ -1,153 +0,0 @@
-/**
- * Account Manager user management operations.
- *
- * This module provides high-level functions for managing users in Account Manager,
- * including CRUD operations, role management, and user lifecycle operations.
- *
- * ## Core User Functions
- *
- * - {@link getUser} - Get user details by ID
- * - {@link getUserByLogin} - Get user details by login (email)
- * - {@link listUsers} - List users with pagination
- * - {@link createUser} - Create a new user
- * - {@link updateUser} - Update an existing user
- * - {@link deleteUser} - Disable a user (soft delete)
- * - {@link purgeUser} - Purge a disabled user (hard delete)
- * - {@link resetUser} - Reset a user to INITIAL state
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   getUserByLogin,
- *   listUsers,
- *   createUser,
- *   grantRole,
- * } from '@salesforce/b2c-tooling-sdk/operations/users';
- * import { createAccountManagerUsersClient } from '@salesforce/b2c-tooling-sdk/clients';
- * import { OAuthStrategy } from '@salesforce/b2c-tooling-sdk/auth';
- *
- * const auth = new OAuthStrategy({
- *   clientId: 'your-client-id',
- *   clientSecret: 'your-client-secret',
- * });
- *
- * const client = createAccountManagerUsersClient({}, auth);
- *
- * // Get a user by login
- * const user = await getUserByLogin(client, 'user@example.com');
- *
- * // List users
- * const users = await listUsers(client, { size: 25, page: 0 });
- *
- * // Create a new user
- * const newUser = await createUser(client, {
- *   mail: 'newuser@example.com',
- *   firstName: 'John',
- *   lastName: 'Doe',
- *   organizations: ['org-id'],
- *   primaryOrganization: 'org-id',
- * });
- * ```
- *
- * ## Authentication
- *
- * User operations require OAuth authentication with appropriate Account Manager permissions.
- *
- * @module operations/users
- */
-import type { AccountManagerUsersClient, AccountManagerUser, UserCreate, UserUpdate } from '../../clients/am-api.js';
-import { getUser, listUsers, deleteUser, purgeUser, resetUser } from '../../clients/am-api.js';
-/**
- * Options for creating a user.
- */
-export interface CreateUserOptions {
-    /** User details */
-    user: UserCreate;
-}
-/**
- * Options for updating a user.
- */
-export interface UpdateUserOptions {
-    /** User ID */
-    userId: string;
-    /** Changes to apply */
-    changes: UserUpdate;
-}
-/**
- * Options for granting a role.
- *
- * The AM API uses mixed formats: role IDs (e.g. 'bm-admin') in the `roles` array,
- * and roleEnumNames (e.g. 'ECOM_ADMIN') in the `roleTenantFilter` string.
- * Both must be provided. Use `resolveToInternalRole` / `resolveFromInternalRole` to convert.
- */
-export interface GrantRoleOptions {
-    /** User ID */
-    userId: string;
-    /** Role ID as used in the roles array (e.g. 'bm-admin'). */
-    role: string;
-    /** Role enum name as used in roleTenantFilter (e.g. 'ECOM_ADMIN'). */
-    roleEnumName: string;
-    /** Optional scope for the role (tenant IDs, comma-separated) */
-    scope?: string;
-}
-/**
- * Options for revoking a role.
- *
- * See {@link GrantRoleOptions} for details on the mixed role ID formats.
- */
-export interface RevokeRoleOptions {
-    /** User ID */
-    userId: string;
-    /** Role ID as used in the roles array (e.g. 'bm-admin'). */
-    role: string;
-    /** Role enum name as used in roleTenantFilter (e.g. 'ECOM_ADMIN'). */
-    roleEnumName: string;
-    /** Optional scope to remove (if not provided, removes entire role) */
-    scope?: string;
-}
-export { getUser, listUsers, deleteUser, purgeUser, resetUser };
-/**
- * Retrieves details of a user by login (email).
- * This searches through paginated results to find the user.
- *
- * @param client - Account Manager client
- * @param login - User login (email)
- * @returns User details
- * @throws Error if user is not found
- */
-export declare function getUserByLogin(client: AccountManagerUsersClient, login: string): Promise<AccountManagerUser>;
-/**
- * Creates a new user.
- *
- * @param client - Account Manager client
- * @param options - Create options (user details)
- * @returns Created user
- */
-export declare function createUser(client: AccountManagerUsersClient, options: CreateUserOptions): Promise<AccountManagerUser>;
-/**
- * Updates an existing user.
- *
- * @param client - Account Manager client
- * @param options - Update options (userId, changes)
- * @returns Updated user
- */
-export declare function updateUser(client: AccountManagerUsersClient, options: UpdateUserOptions): Promise<AccountManagerUser>;
-/**
- * Grants a role to a user, optionally with scope.
- * This updates the user's roles and roleTenantFilter.
- *
- * @param client - Account Manager client
- * @param options - Grant options (userId, role, optional scope)
- * @returns Updated user
- */
-export declare function grantRole(client: AccountManagerUsersClient, options: GrantRoleOptions): Promise<AccountManagerUser>;
-/**
- * Revokes a role from a user, optionally removing specific scope.
- *
- * @param client - Account Manager client
- * @param options - Revoke options (userId, role, optional scope)
- * @returns Updated user
- */
-export declare function revokeRole(client: AccountManagerUsersClient, options: RevokeRoleOptions): Promise<AccountManagerUser>;
-export type { AccountManagerUser, UserCreate, UserUpdate, UserCollection } from '../../clients/am-api.js';

package/dist/cjs/operations/users/index.js

@@ -1,139 +0,0 @@
-import { getUser, listUsers, createUser as createUserApi, updateUser as updateUserApi, deleteUser, purgeUser, resetUser, findUserByLogin, } from '../../clients/am-api.js';
-// Re-export primary API operations from client
-export { getUser, listUsers, deleteUser, purgeUser, resetUser };
-/**
- * Retrieves details of a user by login (email).
- * This searches through paginated results to find the user.
- *
- * @param client - Account Manager client
- * @param login - User login (email)
- * @returns User details
- * @throws Error if user is not found
- */
-export async function getUserByLogin(client, login) {
-    const user = await findUserByLogin(client, login);
-    if (!user) {
-        throw new Error(`User ${login} not found`);
-    }
-    return user;
-}
-/**
- * Creates a new user.
- *
- * @param client - Account Manager client
- * @param options - Create options (user details)
- * @returns Created user
- */
-export async function createUser(client, options) {
-    return createUserApi(client, options.user);
-}
-/**
- * Updates an existing user.
- *
- * @param client - Account Manager client
- * @param options - Update options (userId, changes)
- * @returns Updated user
- */
-export async function updateUser(client, options) {
-    return updateUserApi(client, options.userId, options.changes);
-}
-/**
- * Grants a role to a user, optionally with scope.
- * This updates the user's roles and roleTenantFilter.
- *
- * @param client - Account Manager client
- * @param options - Grant options (userId, role, optional scope)
- * @returns Updated user
- */
-export async function grantRole(client, options) {
-    const { role, roleEnumName } = options;
-    // First get the current user
-    const user = await getUser(client, options.userId);
-    // Build updated roles (uses role ID format, e.g. 'bm-admin')
-    const currentRoles = Array.isArray(user.roles) ? user.roles.map((r) => (typeof r === 'string' ? r : r.id || '')) : [];
-    const updatedRoles = currentRoles.includes(role) ? currentRoles : [...currentRoles, role];
-    // Build updated roleTenantFilter (uses roleEnumName format, e.g. 'ECOM_ADMIN')
-    let roleTenantFilter = user.roleTenantFilter || '';
-    if (options.scope) {
-        const scopes = options.scope.split(',');
-        // Parse existing filter
-        const filters = roleTenantFilter.split(';').filter(Boolean);
-        const filterMap = new Map();
-        for (const filter of filters) {
-            const [r, tenants] = filter.split(':');
-            if (tenants) {
-                filterMap.set(r, tenants.split(','));
-            }
-        }
-        // Add new scopes
-        const existingScopes = filterMap.get(roleEnumName) || [];
-        const allScopes = [...new Set([...existingScopes, ...scopes])];
-        filterMap.set(roleEnumName, allScopes);
-        // Rebuild filter string
-        roleTenantFilter = Array.from(filterMap.entries())
-            .map(([r, tenants]) => `${r}:${tenants.join(',')}`)
-            .join(';');
-    }
-    return updateUser(client, {
-        userId: options.userId,
-        changes: {
-            roles: updatedRoles,
-            roleTenantFilter: roleTenantFilter || undefined,
-        },
-    });
-}
-/**
- * Revokes a role from a user, optionally removing specific scope.
- *
- * @param client - Account Manager client
- * @param options - Revoke options (userId, role, optional scope)
- * @returns Updated user
- */
-export async function revokeRole(client, options) {
-    const { role, roleEnumName } = options;
-    // First get the current user
-    const user = await getUser(client, options.userId);
-    // Build updated roles (uses role ID format, e.g. 'bm-admin')
-    const currentRoles = Array.isArray(user.roles) ? user.roles.map((r) => (typeof r === 'string' ? r : r.id || '')) : [];
-    let updatedRoles = currentRoles;
-    // Build updated roleTenantFilter (uses roleEnumName format, e.g. 'ECOM_ADMIN')
-    let roleTenantFilter = user.roleTenantFilter || '';
-    if (!options.scope) {
-        // Remove entire role
-        updatedRoles = currentRoles.filter((r) => r !== role);
-        // Remove all scopes for this role
-        const filters = roleTenantFilter.split(';').filter(Boolean);
-        roleTenantFilter = filters.filter((f) => !f.startsWith(`${roleEnumName}:`)).join(';');
-    }
-    else {
-        // Remove specific scope
-        const scopes = options.scope.split(',');
-        const filters = roleTenantFilter.split(';').filter(Boolean);
-        const filterMap = new Map();
-        for (const filter of filters) {
-            const [r, tenants] = filter.split(':');
-            if (tenants) {
-                filterMap.set(r, tenants.split(','));
-            }
-        }
-        const existingScopes = filterMap.get(roleEnumName) || [];
-        const updatedScopes = existingScopes.filter((s) => !scopes.includes(s));
-        if (updatedScopes.length > 0) {
-            filterMap.set(roleEnumName, updatedScopes);
-        }
-        else {
-            filterMap.delete(roleEnumName);
-        }
-        roleTenantFilter = Array.from(filterMap.entries())
-            .map(([r, tenants]) => `${r}:${tenants.join(',')}`)
-            .join(';');
-    }
-    return updateUser(client, {
-        userId: options.userId,
-        changes: {
-            roles: updatedRoles.length > 0 ? updatedRoles : undefined,
-            roleTenantFilter: roleTenantFilter || undefined,
-        },
-    });
-}
-//# sourceMappingURL=index.js.map

package/dist/cjs/operations/users/index.js.map

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

package/dist/cjs/operations/util/zip.d.ts

@@ -1,5 +0,0 @@
-import JSZip from 'jszip';
-/**
- * Recursively adds directory contents to a JSZip folder.
- */
-export declare function addDirectoryToZip(zipFolder: JSZip, dirPath: string): Promise<void>;

package/dist/cjs/operations/util/zip.js

@@ -1,25 +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 fs from 'node:fs';
-import * as path from 'node:path';
-/**
- * Recursively adds directory contents to a JSZip folder.
- */
-export async function addDirectoryToZip(zipFolder, dirPath) {
-    const entries = await fs.promises.readdir(dirPath, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path.join(dirPath, entry.name);
-        if (entry.isDirectory()) {
-            const subFolder = zipFolder.folder(entry.name);
-            await addDirectoryToZip(subFolder, fullPath);
-        }
-        else if (entry.isFile()) {
-            const content = await fs.promises.readFile(fullPath);
-            zipFolder.file(entry.name, content);
-        }
-    }
-}
-//# sourceMappingURL=zip.js.map

package/dist/cjs/operations/util/zip.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../../../src/operations/util/zip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAgB,EAAE,OAAe;IACvE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC;YAChD,MAAM,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/package.json

@@ -1 +0,0 @@
-{"type":"commonjs"}

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

@@ -1,46 +0,0 @@
-import type { Logger } from '../logging/types.js';
-/**
- * Hook names that the plugin system supports.
- */
-declare const SUPPORTED_HOOKS: readonly ["b2c:config-sources", "b2c:http-middleware", "b2c:auth-middleware"];
-export type SupportedHookName = (typeof SUPPORTED_HOOKS)[number];
-/**
- * A discovered plugin with its hook file paths.
- */
-export interface DiscoveredPlugin {
-    /** Plugin package name */
-    name: string;
-    /** Absolute path to the plugin's package directory */
-    packageDir: string;
-    /** Map of hook name to relative file path(s) within the plugin package */
-    hooks: Partial<Record<SupportedHookName, string[]>>;
-}
-/**
- * Options for plugin discovery.
- */
-export interface PluginDiscoveryOptions {
-    /** Override the oclif data directory (for testing) */
-    dataDir?: string;
-    /** Override the dirname used to resolve the data directory (default: 'b2c') */
-    dirname?: string;
-    /** Logger for warnings */
-    logger?: Logger;
-}
-/**
- * Resolves the oclif data directory for the CLI.
- *
- * Cross-platform: uses `$XDG_DATA_HOME/<dirname>` or `~/.local/share/<dirname>`
- * on POSIX; `$LOCALAPPDATA\<dirname>` on Windows.
- */
-export declare function resolveOclifDataDir(dirname?: string): string;
-/**
- * Discovers installed b2c-cli plugins by reading the oclif data directory.
- *
- * Reads `<dataDir>/package.json` -> `oclif.plugins` array -> each plugin's
- * `package.json` -> `oclif.hooks` -> returns `DiscoveredPlugin[]`.
- *
- * Only hooks matching `b2c:config-sources`, `b2c:http-middleware`, and
- * `b2c:auth-middleware` are included.
- */
-export declare function discoverPlugins(options?: PluginDiscoveryOptions): DiscoveredPlugin[];
-export {};

package/dist/cjs/plugins/discovery.js

@@ -1,122 +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 fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-/**
- * Hook names that the plugin system supports.
- */
-const SUPPORTED_HOOKS = ['b2c:config-sources', 'b2c:http-middleware', 'b2c:auth-middleware'];
-/**
- * Resolves the oclif data directory for the CLI.
- *
- * Cross-platform: uses `$XDG_DATA_HOME/<dirname>` or `~/.local/share/<dirname>`
- * on POSIX; `$LOCALAPPDATA\<dirname>` on Windows.
- */
-export function resolveOclifDataDir(dirname = 'b2c') {
-    if (process.platform === 'win32') {
-        const localAppData = process.env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local');
-        return path.join(localAppData, dirname);
-    }
-    const xdgDataHome = process.env.XDG_DATA_HOME ?? path.join(os.homedir(), '.local', 'share');
-    return path.join(xdgDataHome, dirname);
-}
-/**
- * Reads a JSON file, returning undefined on any error.
- */
-function readJsonSafe(filePath) {
-    try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Normalizes a hook value (string or string[]) to a string array.
- */
-function normalizeHookPaths(value) {
-    if (typeof value === 'string')
-        return [value];
-    if (Array.isArray(value))
-        return value.filter((v) => typeof v === 'string');
-    return [];
-}
-/**
- * Extracts the plugin name from an oclif plugins entry.
- *
- * Oclif stores user-installed plugins as objects: `{name, type, url}`,
- * while linked/dev plugins may appear as plain strings.
- */
-function resolvePluginName(entry) {
-    if (typeof entry === 'string')
-        return entry;
-    if (typeof entry === 'object' && entry !== null && 'name' in entry) {
-        const name = entry.name;
-        if (typeof name === 'string')
-            return name;
-    }
-    return undefined;
-}
-/**
- * Discovers installed b2c-cli plugins by reading the oclif data directory.
- *
- * Reads `<dataDir>/package.json` -> `oclif.plugins` array -> each plugin's
- * `package.json` -> `oclif.hooks` -> returns `DiscoveredPlugin[]`.
- *
- * Only hooks matching `b2c:config-sources`, `b2c:http-middleware`, and
- * `b2c:auth-middleware` are included.
- */
-export function discoverPlugins(options = {}) {
-    const { logger } = options;
-    const dataDir = options.dataDir ?? resolveOclifDataDir(options.dirname);
-    const plugins = [];
-    // Read the root package.json in the data directory
-    const rootPkgPath = path.join(dataDir, 'package.json');
-    const rootPkg = readJsonSafe(rootPkgPath);
-    if (!rootPkg?.oclif?.plugins?.length) {
-        return plugins;
-    }
-    const nodeModulesDir = path.join(dataDir, 'node_modules');
-    for (const pluginEntry of rootPkg.oclif.plugins) {
-        const pluginName = resolvePluginName(pluginEntry);
-        if (!pluginName)
-            continue;
-        try {
-            const pluginDir = path.join(nodeModulesDir, ...pluginName.split('/'));
-            const pluginPkgPath = path.join(pluginDir, 'package.json');
-            const pluginPkg = readJsonSafe(pluginPkgPath);
-            if (!pluginPkg?.oclif?.hooks)
-                continue;
-            const hookEntries = pluginPkg.oclif.hooks;
-            const discoveredHooks = {};
-            let hasHooks = false;
-            for (const hookName of SUPPORTED_HOOKS) {
-                if (hookName in hookEntries) {
-                    const paths = normalizeHookPaths(hookEntries[hookName]);
-                    if (paths.length > 0) {
-                        discoveredHooks[hookName] = paths;
-                        hasHooks = true;
-                    }
-                }
-            }
-            if (hasHooks) {
-                plugins.push({
-                    name: pluginName,
-                    packageDir: pluginDir,
-                    hooks: discoveredHooks,
-                });
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            logger?.warn(`Failed to discover plugin ${pluginName}: ${message}`);
-        }
-    }
-    return plugins;
-}
-//# sourceMappingURL=discovery.js.map

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

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

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

@@ -1,26 +0,0 @@
-/**
- * Plugin discovery and loading for non-oclif consumers.
- *
- * This module enables VS Code extensions, MCP servers, and other non-CLI consumers
- * to load b2c-cli plugins installed via `b2c plugins:install`. It discovers plugins
- * from the oclif data directory and invokes their hooks without requiring `@oclif/core`.
- *
- * ## Quick Start
- *
- * ```typescript
- * import { B2CPluginManager } from '@salesforce/b2c-tooling-sdk/plugins';
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const manager = new B2CPluginManager();
- * await manager.initialize();
- * manager.applyMiddleware();
- *
- * const { sourcesBefore, sourcesAfter } = manager.getConfigSources();
- * const config = resolveConfig({}, { sourcesBefore, sourcesAfter });
- * ```
- *
- * @module plugins
- */
-export { B2CPluginManager, type PluginHookOptions } from './manager.js';
-export { discoverPlugins, resolveOclifDataDir, type DiscoveredPlugin, type PluginDiscoveryOptions, type SupportedHookName, } from './discovery.js';
-export { createHookContext, invokeHook, type HookContext, type HookContextOptions } from './loader.js';

package/dist/cjs/plugins/index.js

@@ -1,32 +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
- */
-/**
- * Plugin discovery and loading for non-oclif consumers.
- *
- * This module enables VS Code extensions, MCP servers, and other non-CLI consumers
- * to load b2c-cli plugins installed via `b2c plugins:install`. It discovers plugins
- * from the oclif data directory and invokes their hooks without requiring `@oclif/core`.
- *
- * ## Quick Start
- *
- * ```typescript
- * import { B2CPluginManager } from '@salesforce/b2c-tooling-sdk/plugins';
- * import { resolveConfig } from '@salesforce/b2c-tooling-sdk/config';
- *
- * const manager = new B2CPluginManager();
- * await manager.initialize();
- * manager.applyMiddleware();
- *
- * const { sourcesBefore, sourcesAfter } = manager.getConfigSources();
- * const config = resolveConfig({}, { sourcesBefore, sourcesAfter });
- * ```
- *
- * @module plugins
- */
-export { B2CPluginManager } from './manager.js';
-export { discoverPlugins, resolveOclifDataDir, } from './discovery.js';
-export { createHookContext, invokeHook } from './loader.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAC,gBAAgB,EAAyB,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,eAAe,EACf,mBAAmB,GAIpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAC,iBAAiB,EAAE,UAAU,EAA4C,MAAM,aAAa,CAAC"}