/**
 * Verify a Meta webhook challenge request.
 * Used in GET handler to respond to Meta's subscription verification.
 */
export declare function verifyWebhookChallenge(params: {
    "hub.mode"?: string;
    "hub.challenge"?: string;
    "hub.verify_token"?: string;
}, expectedVerifyToken: string): {
    valid: boolean;
    challenge?: string;
};
/**
 * Verify the HMAC-SHA256 signature on a webhook payload.
 * The signature is in the X-Hub-Signature-256 header as "sha256={hex}".
 */
export declare function verifyWebhookSignature(body: string | ArrayBuffer, signature: string, appSecret: string): Promise<boolean>;
import { type FBWebhookPayload, type IGWebhookPayload, type ThreadsWebhookPayload } from "./webhooks-schemas.ts";
export type { FBWebhookChange, FBWebhookMessagingEvent, FBWebhookPayload, IGWebhookChange, IGWebhookMessagingEvent, IGWebhookPayload, ThreadsWebhookPayload, } from "./webhooks-schemas.ts";
export interface WebhookParseOptions {
    body: string;
    signature: string;
    appSecret: string;
}
export type WebhookParseResult<T> = {
    success: true;
    data: T;
} | {
    success: false;
    error: WebhookParseError;
};
export declare class WebhookParseError extends Error {
    readonly code: "INVALID_SIGNATURE" | "INVALID_PAYLOAD" | "INVALID_JSON";
    readonly details?: unknown;
    constructor(code: WebhookParseError["code"], message: string, details?: unknown);
}
/**
 * Verify signature and parse an Instagram webhook payload.
 * Throws WebhookParseError on invalid signature, JSON, or payload shape.
 */
export declare function parseInstagramWebhook(opts: WebhookParseOptions): Promise<IGWebhookPayload>;
/**
 * Verify signature and parse a Facebook Page webhook payload.
 * Throws WebhookParseError on invalid signature, JSON, or payload shape.
 */
export declare function parseFacebookWebhook(opts: WebhookParseOptions): Promise<FBWebhookPayload>;
/**
 * Verify signature and parse a Threads webhook payload.
 * Throws WebhookParseError on invalid signature, JSON, or payload shape.
 */
export declare function parseThreadsWebhook(opts: WebhookParseOptions): Promise<ThreadsWebhookPayload>;
/**
 * Verify signature and parse an Instagram webhook payload.
 * Returns { success, data } or { success, error } — never throws.
 */
export declare function safeParseInstagramWebhook(opts: WebhookParseOptions): Promise<WebhookParseResult<IGWebhookPayload>>;
/**
 * Verify signature and parse a Facebook Page webhook payload.
 * Returns { success, data } or { success, error } — never throws.
 */
export declare function safeParseFacebookWebhook(opts: WebhookParseOptions): Promise<WebhookParseResult<FBWebhookPayload>>;
/**
 * Verify signature and parse a Threads webhook payload.
 * Returns { success, data } or { success, error } — never throws.
 */
export declare function safeParseThreadsWebhook(opts: WebhookParseOptions): Promise<WebhookParseResult<ThreadsWebhookPayload>>;
//# sourceMappingURL=webhooks.d.ts.map