Scheduling infrastructure for absolutely everyone.
import type { WebhookTriggerEvents } from "@calcom/prisma/enums";
import type { WebhookTaskPayload } from "../types/webhookTask";
export interface SubscriberContext {
triggerEvent: WebhookTriggerEvents;
userId?: number;
eventTypeId?: number;
teamId?: number | null;
orgId?: number;
oAuthClientId?: string | null;
}
/**
* Strategy interface for fetching webhook event data
*
* Each webhook category (booking, form, recording, etc.) implements this interface
* to provide domain-specific data fetching logic.
*
* Benefits:
* - Open/Closed: Add new webhook types without modifying consumer
* - Single Responsibility: Each fetcher owns one domain's logic
* - Dependency Inversion: Consumer depends on this interface, not concrete implementations
*
* Note: Uses WebhookTaskPayload (discriminated union) directly instead of generics
* since type narrowing happens at runtime via canHandle().
*/
export interface IWebhookDataFetcher {
canHandle(triggerEvent: WebhookTriggerEvents): boolean;
fetchEventData(payload: WebhookTaskPayload): Promise<Record<string, unknown> | null>;
getSubscriberContext(payload: WebhookTaskPayload): SubscriberContext;
}