import { LifecycleHooks } from '@b64hub/sfpm-core';
import type { FeedTrackingHooksOptions } from './types.js';
/**
 * Creates lifecycle hooks for enabling feed tracking post-deployment.
 *
 * Registers a hook on `install:post` that ensures `trackFeedHistory` is
 * enabled on custom fields declared in the package source. The hook:
 *
 * 1. Reads the list of fields with `trackFeedHistory=true` from the package
 *    metadata (populated during build by the FT analyzer)
 * 2. Queries the target org to find which fields already have feed tracking
 * 3. Reads the remaining field metadata from the org via the Metadata API
 * 4. Enables `trackFeedHistory` on each field and updates the org
 *
 * Skips scratch orgs by default, since feed tracking behaves differently
 * in scratch org environments.
 *
 * @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 { feedTrackingHooks } from '@b64hub/sfpm-hooks';
 *
 * export default defineConfig({
 *   hooks: [
 *     feedTrackingHooks(),
 *   ],
 * });
 * ```
 */
export declare function feedTrackingHooks(options?: FeedTrackingHooksOptions): LifecycleHooks;