import type { ConsentManager } from './consent-manager.js';
/**
 * A ServiceAdapter controls a third-party service that is managed
 * programmatically (via JavaScript API) rather than by script blocking.
 *
 * Many modern analytics libraries (PostHog, Matomo, Mixpanel,
 * Meta Pixel, etc.) provide their own opt-in/opt-out mechanisms. These
 * services are typically already loaded on the page and just need to be
 * told whether they have consent or not.
 *
 * This is fundamentally different from script blocking (where a `<script>`
 * tag is prevented from loading). Both approaches are supported by
 * Keksmeister:
 *
 * - **Script blocking:** `<script type="text/plain" data-keksmeister="analytics">`
 *   → handled by `ScriptBlocker`
 *
 * - **Programmatic consent:** `new PostHogAdapter(posthog)`
 *   → handled by `ServiceAdapter` + `ServiceRegistry`
 *
 * ## Creating a custom adapter
 *
 * ```ts
 * const myAdapter: ServiceAdapter = {
 *   id: 'my-tool',
 *   category: 'analytics',
 *   onConsent: () => myTool.startTracking(),
 *   onRevoke: () => myTool.stopTracking(),
 * };
 * ```
 */
export interface ServiceAdapter {
    /** Unique identifier for this service */
    id: string;
    /** Which consent category this service belongs to */
    category: string;
    /** Called when the user grants consent for this category */
    onConsent: () => void;
    /** Called when the user revokes consent for this category */
    onRevoke: () => void;
}
/**
 * Registry that connects ServiceAdapters to a ConsentManager.
 *
 * When consent changes, the registry automatically calls onConsent/onRevoke
 * on all registered adapters for the affected categories.
 */
export declare class ServiceRegistry {
    #private;
    constructor(manager: ConsentManager);
    /** Remove event listeners and clean up. */
    destroy(): void;
    /** Register a service adapter. Immediately syncs its state. */
    register(adapter: ServiceAdapter): void;
    /** Unregister a service adapter by id. */
    unregister(id: string): void;
    /** Get all registered adapters. */
    getAdapters(): readonly ServiceAdapter[];
    /** Sync all adapters with current consent state. */
    syncAll(): void;
}