Merge test to main

[sweetmantech]

Merge test branch into main after admin privy endpoint changes.

Summary by CodeRabbit

Release Notes

• New Features
  • Added admin API endpoint to retrieve Privy login statistics filtered by time period (daily, weekly, monthly, or all-time)
  • Endpoint includes metrics for total users, new accounts, and active accounts
  • Requires admin authentication and supports CORS

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
recoup-api	Building	Preview	Mar 17, 2026 5:35pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 4ea7abc2-e94b-41ce-b033-53e2188a3075

📥 Commits

Reviewing files that changed from the base of the PR and between 0b5421f and e3e7983.

⛔ Files ignored due to path filters (2)

• lib/admins/privy/__tests__/getPrivyLoginsHandler.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/admins/privy/__tests__/validateGetPrivyLoginsQuery.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**

📒 Files selected for processing (12)

• app/api/admins/privy/route.ts
• lib/admins/privy/countActiveAccounts.ts
• lib/admins/privy/countNewAccounts.ts
• lib/admins/privy/fetchPrivyLogins.ts
• lib/admins/privy/fetchPrivyUsersPage.ts
• lib/admins/privy/getCutoffMs.ts
• lib/admins/privy/getLatestVerifiedAt.ts
• lib/admins/privy/getPrivyLoginsHandler.ts
• lib/admins/privy/periodDays.ts
• lib/admins/privy/privyLoginsPeriod.ts
• lib/admins/privy/toMs.ts
• lib/admins/privy/validateGetPrivyLoginsQuery.ts

---

📝 Walkthrough

Walkthrough

Introduces a new admin API endpoint for Privy login statistics at /api/admins/privy, along with supporting utilities to fetch Privy users via pagination, filter by time periods (daily, weekly, monthly, or all-time), validate admin authorization, and count active and new accounts.

Changes

Cohort / File(s)	Summary
API Route Handler app/api/admins/privy/route.ts	Exposes GET and OPTIONS handlers for the admin Privy endpoint; GET delegates to getPrivyLoginsHandler and OPTIONS responds with CORS headers and 204 status.
Data Fetching & Pagination lib/admins/privy/fetchPrivyUsersPage.ts, lib/admins/privy/fetchPrivyLogins.ts	Implements paginated Privy API calls with Basic auth, 10-second timeout enforcement, and user aggregation; filters users by created_at and latest_verified_at timestamps based on the requested period.
Account Counting Logic lib/admins/privy/countNewAccounts.ts, lib/admins/privy/countActiveAccounts.ts	Counts new accounts (by created_at) and active accounts (by latest verified timestamp) within a specified period cutoff.
Request Handling & Validation lib/admins/privy/getPrivyLoginsHandler.ts, lib/admins/privy/validateGetPrivyLoginsQuery.ts	Main handler orchestrates data fetching and counting; validation function enforces admin auth and parses/validates period query parameter with Zod schema.
Timestamp & Period Utilities lib/admins/privy/toMs.ts, lib/admins/privy/getCutoffMs.ts, lib/admins/privy/periodDays.ts, lib/admins/privy/getLatestVerifiedAt.ts	Converts timestamps between seconds/milliseconds, computes UTC midnight cutoffs aligned with Privy dashboard behavior, maps periods to day counts, and extracts latest verified timestamps from user linked accounts.
Types & Schemas lib/admins/privy/privyLoginsPeriod.ts	Defines Zod-validated PrivyLoginsPeriod enum ("all", "daily", "weekly", "monthly") with inferred TypeScript type for runtime and compile-time validation.

Sequence Diagram

sequenceDiagram
actor Client
participant Route as API Route<br/>(GET/OPTIONS)
participant Handler as getPrivyLoginsHandler
participant Validator as Validation
participant Fetcher as fetchPrivyLogins
participant Privy as Privy API
participant Counter as Counting Logic
participant Response as JSON Response
Client->>Route: GET /api/admins/privy?period=weekly
Route->>Handler: invoke with request
Handler->>Validator: validateGetPrivyLoginsQuery()
Validator->>Response: return 401 if unauthorized
Validator->>Handler: return { period: "weekly" }
Handler->>Fetcher: fetchPrivyLogins("weekly")
loop Pagination
Fetcher->>Privy: fetchPrivyUsersPage(cursor)
Privy->>Fetcher: { data: User[], next_cursor? }
Fetcher->>Fetcher: filter & aggregate by cutoff
end
Fetcher->>Handler: { users, totalPrivyUsers }
Handler->>Counter: countNewAccounts(users, period)
Counter->>Handler: total_new count
Handler->>Counter: countActiveAccounts(users, period)
Counter->>Handler: total_active count
Handler->>Response: { status, total, total_new,<br/>total_active, total_privy_users, logins }
Response->>Client: 200 JSON + CORS headers

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Possibly related PRs

• feat: add GET /api/admins/privy endpoint #306: Directly related; adds identical admin Privy endpoint and all supporting utilities (getPrivyLoginsHandler, fetchPrivyLogins, validation, account counting, timestamp helpers) to the same directory structure.

Poem

📊 A Privy glimpse through admin's eyes,
Logins tallied by time's disguise—
Periods parsed, accounts now known,
Active seeds and newborns shown! 🌱✨

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch test

📝 Coding Plan

• Generate coding plan for human review comments

---

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 and usage tips.}