feat(#706): add actor and to date filters to GET /api/events

[malaysiaonelove]

Summary

Adds actor and to query parameters to the GET /api/events global event feed endpoint, completing the filter set described in #706.

What Changed

File	Change
validation/schemas.ts	Added actor (string) and to (unix timestamp) to listEventsQuerySchema
services/eventHistory.ts	Extended getGlobalEvents() and countAllEvents() with actor and to parameters — applies actor = ? and timestamp <= ? SQL conditions
index.ts	Passes the new filters through to the service layer
index.test.ts	6 new unit tests + fixed pre-existing missing adminJwtAuth/getJwtSecret mocks
integration.test.ts	5 new integration tests covering actor, to, combined filters, and empty results

Endpoint Before

GET /api/events?eventType=&streamId=&since=&page=&limit=&cursor=

Endpoint After

GET /api/events?eventType=&streamId=&actor=&since=&to=&page=&limit=&cursor=

New Parameters

Param	Type	Description
actor	string	Filter by the Stellar account that performed the event action
to	number	Upper bound unix timestamp — events with timestamp <= to are returned

Acceptance Criteria

• All filter combinations return correct results
• Empty result returns {data: [], total: 0}
• Response time < 200ms for 10k events (parameterized SQL queries with existing indexes)
• Sorted descending by timestamp (unchanged)
• Paginated with page/limit (unchanged)

Example Usage

# All claimed events by a specific actor in the last hour
curl "/api/events?eventType=claimed&actor=GABC...&since=1693000000"

# Events in a date range for a stream
curl "/api/events?streamId=42&since=1693000000&to=1693086400"

# All events by an actor
curl "/api/events?actor=GABC..."

Notes

• TypeScript compiles cleanly — zero errors in all changed files
• No database migration needed — uses existing stream_events table columns
• Pre-existing test mock gaps (missing adminJwtAuth) are fixed as part of this PR

Closes #706

[vercel]

@malaysiaonelove is attempting to deploy a commit to the ritik4ever's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@malaysiaonelove Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5636ff1d-56ed-4e99-9418-7f81f210a4d5

---

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.}