import { LifecycleHooks } from '@b64hub/sfpm-core';
import type { BrowserforceHooksOptions } from './types.js';
/**
 * Creates lifecycle hooks for sfdx-browserforce integration.
 *
 * Registers a hook on `install:post` that executes browserforce plans
 * against the target org. This enables automated configuration of
 * Salesforce settings that cannot be set via the Metadata or Tooling
 * APIs (e.g., org preferences, security settings, portal configuration).
 *
 * Requires `sfdx-browserforce-plugin` to be installed and available
 * on the system PATH.
 *
 * @see https://github.com/amtrack/sfdx-browserforce-plugin
 *
 * @param options - Hook configuration options
 * @returns A LifecycleHooks instance to pass to `defineConfig({ hooks: [...] })`
 *
 * @example
 * ```typescript
 * // sfpm.config.ts
 * import { defineConfig } from '@b64hub/sfpm-core';
 * import { browserforceHooks } from '@b64hub/sfpm-hooks';
 *
 * export default defineConfig({
 *   hooks: [
 *     browserforceHooks({ planFile: 'config/browserforce-plan.json' }),
 *   ],
 * });
 * ```
 */
export declare function browserforceHooks(options: BrowserforceHooksOptions): LifecycleHooks;