@strav/herald 1.0.0-alpha.42

package/src/webhook/herald_webhook_registry.ts

@@ -0,0 +1,65 @@
+/**
+ * Handler registry for normalized Herald webhook events.
+ *
+ * Apps register handlers at boot:
+ *
+ *   herald.onWebhookEvent('post.published', (ctx) => { ... })
+ *   herald.onWebhookEvent('engagement.review', { provider: 'gbp' }, (ctx) => { ... })
+ *
+ * Handlers fire in registration order. A thrown handler aborts the
+ * rest and surfaces a 500 (the provider retries). Multiple handlers
+ * per `(eventType, provider?)` are fine.
+ *
+ * Filter semantics: when `filter.provider` is set, the handler only
+ * fires for that provider-instance name; when omitted, the handler
+ * fires for any instance that emits the type.
+ */
+
+import type {
+  HeraldEventType,
+  WebhookHandler,
+  WebhookHandlerFilter,
+} from './herald_event.ts'
+
+interface RegisteredHandler {
+  filter: WebhookHandlerFilter
+  handler: WebhookHandler
+}
+
+export class HeraldWebhookRegistry {
+  private readonly handlers = new Map<HeraldEventType, RegisteredHandler[]>()
+
+  on(eventType: HeraldEventType, handler: WebhookHandler): void
+  on(
+    eventType: HeraldEventType,
+    filter: WebhookHandlerFilter,
+    handler: WebhookHandler,
+  ): void
+  on(
+    eventType: HeraldEventType,
+    filterOrHandler: WebhookHandlerFilter | WebhookHandler,
+    maybeHandler?: WebhookHandler,
+  ): void {
+    const { filter, handler } =
+      typeof filterOrHandler === 'function'
+        ? { filter: {}, handler: filterOrHandler }
+        : { filter: filterOrHandler, handler: maybeHandler! }
+    const existing = this.handlers.get(eventType) ?? []
+    existing.push({ filter, handler })
+    this.handlers.set(eventType, existing)
+  }
+
+  /** Remove every registered handler. Tests use this to keep cases isolated. */
+  clear(): void {
+    this.handlers.clear()
+  }
+
+  /** Resolve the handlers that match a given `(type, provider)` pair. */
+  resolve(eventType: HeraldEventType, provider: string): readonly WebhookHandler[] {
+    const matches = this.handlers.get(eventType)
+    if (!matches) return []
+    return matches
+      .filter((m) => !m.filter.provider || m.filter.provider === provider)
+      .map((m) => m.handler)
+  }
+}

package/src/webhook/index.ts

@@ -0,0 +1,24 @@
+export {
+  applyHeraldWebhookEventMigration,
+  type ApplyHeraldWebhookEventMigrationOptions,
+} from './apply_herald_webhook_event_migration.ts'
+export type {
+  CommentEvent,
+  HeraldEventType,
+  HeraldWebhookEvent,
+  HeraldWebhookEventBase,
+  PostDeletedEvent,
+  PostFailedEvent,
+  PostPublishedEvent,
+  ReactionEvent,
+  ReviewEvent,
+  UnknownEvent,
+  WebhookHandler,
+  WebhookHandlerContext,
+  WebhookHandlerFilter,
+} from './herald_event.ts'
+export { HeraldWebhookEventRecord } from './herald_webhook_event.ts'
+export { HeraldWebhookEventRepository } from './herald_webhook_event_repository.ts'
+export { heraldWebhookEventSchema } from './herald_webhook_event_schema.ts'
+export { heraldWebhook, type HeraldWebhookOptions } from './herald_webhook.ts'
+export { HeraldWebhookRegistry } from './herald_webhook_registry.ts'