feat: notification events v3 APIs

[borosr]

Greptile Summary

The PR introduces internal v3 APIs for listing, retrieving, filtering, and resending notification events.

• Defines notification-event schemas and operations in TypeSpec and generated clients.
• Adds v3 handlers, routes, model conversion, filtering, and delivery-status mapping.
• Extends notification persistence and reconciliation behavior to support the new APIs.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains within the eligible follow-up-review scope.

No blocking failure remains.

Important Files Changed

Filename	Overview
api/spec/packages/aip/src/notifications/event.tsp	Defines the v3 notification-event resource, polymorphic payloads, delivery statuses, and delivery-attempt responses.
api/spec/packages/aip/src/notifications/operations.tsp	Adds internal list, get, and asynchronous resend operations for notification events.
api/v3/handlers/notification/events/convert.go	Converts notification domain events, payloads, filters, and delivery metadata into the generated v3 API models.
api/v3/handlers/notification/events/list.go	Implements paginated notification-event listing with sorting and structured filters.
api/v3/handlers/notification/events/resend.go	Implements the bodyless asynchronous resend endpoint and delegates status transitions to the notification service.
openmeter/notification/adapter/event.go	Extends event repository queries with typed field, JSONB annotation, channel, status, and ordering filters.
openmeter/notification/eventhandler/reconcile.go	Migrates reconciliation event selection to the new delivery-status filter representation.
pkg/filter/jsonb.go	Adds reusable JSONB filter predicate construction used by notification-event queries.

Sequence Diagram

sequenceDiagram
    participant Client
    participant API as Notification Events API
    participant Service as Notification Service
    participant DB as Event Repository
    participant Worker as Reconciliation Worker
    participant Webhook

    Client->>API: GET /notification/events
    API->>Service: ListEvents(filters)
    Service->>DB: Query namespaced events
    DB-->>Service: Events and delivery statuses
    Service-->>API: Domain events
    API-->>Client: v3 event representations

    Client->>API: "POST /notification/events/{id}/resend"
    API->>Service: ResendEvent(event, channels)
    Service->>DB: Mark eligible statuses RESENDING
    API-->>Client: 202 Accepted
    Worker->>DB: Poll pending/resending events
    Worker->>Webhook: Re-send delivery
    Webhook-->>Worker: Delivery result
    Worker->>DB: Update delivery status

Loading

_{Reviews (6): Last reviewed commit: "fix: resolve notification type format to..." | Re-trigger Greptile}

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}