chore: sync test → main (subscription endpoint refactor)

[sweetmantech]

Summary

• Brings test up to main for the subscription endpoint refactor (feat(api): add GET /api/subscriptions/status #506)

Test plan

• Manual preview testing on feat(api): add GET /api/subscriptions/status #506 against the deployed preview (results)
• Full unit suite green (2461 tests)

---

Summary by cubic

Adds GET /api/accounts/[id]/subscription to return an account’s subscription (account or org coverage) with a stable { isPro, status, plan, source } payload. Includes CORS preflight, no caching, strict UUID + auth validation, and resilient Stripe pagination.

• New Features
  • New route with OPTIONS; thin shell delegates to getAccountSubscriptionHandler.
  • Prefers account subscription; falls back to org; normalizes Stripe status via toStatus.
  • Stripe helpers: getActiveSubscriptions (cursor pagination until match), getOrgSubscription (first match), isActiveSubscription.
  • Error handling: forwards auth/validation failures as 4xx with { error }; 500 guarded.
  • Tests added for the route, handler, and all helpers.

^{Written for commit d0aa31d. Summary will update on new commits.}

Summary by CodeRabbit

• New Features
  • Added API endpoint for retrieving account subscription information with support for both account-level and organization-level subscriptions.
  • Subscription status tracking including active, trialing, canceled, past_due, and inactive states.
  • CORS support enabled for subscription endpoint requests.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
api	Ready	Preview	May 6, 2026 2:07pm

[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: 0ebe4b14-b5be-4ee5-8633-54a741760c4e

📥 Commits

Reviewing files that changed from the base of the PR and between 51723d7 and d0aa31d.

⛔ Files ignored due to path filters (10)

• app/api/accounts/[id]/subscription/__tests__/route.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by app/**
• app/api/accounts/[id]/subscription/__tests__/routeTestMocks.ts is excluded by !**/__tests__/** and included by app/**
• lib/stripe/__tests__/buildSubscriptionResponse.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/getAccountSubscriptionHandler.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/getActiveSubscriptions.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/getActiveSubscriptionsTestHelpers.ts is excluded by !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/getOrgSubscription.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/isActiveSubscription.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/toStatus.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/stripe/__tests__/validateAccountSubscriptionParams.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**

📒 Files selected for processing (9)

• app/api/accounts/[id]/subscription/route.ts
• lib/stripe/buildSubscriptionResponse.ts
• lib/stripe/getAccountSubscriptionHandler.ts
• lib/stripe/getActiveSubscriptionDetails.ts
• lib/stripe/getActiveSubscriptions.ts
• lib/stripe/getOrgSubscription.ts
• lib/stripe/isActiveSubscription.ts
• lib/stripe/toStatus.ts
• lib/stripe/validateAccountSubscriptionParams.ts

---

📝 Walkthrough

Walkthrough

This PR introduces a new per-account subscription retrieval API endpoint with supporting Stripe utilities. It adds route handlers, subscription status mapping, subscription queries, and response builders to enable unified access to account- and organization-level subscription data.

Changes

Subscription Retrieval API

Layer / File(s)	Summary
Type & Status Utilities lib/stripe/toStatus.ts, lib/stripe/isActiveSubscription.ts	SubscriptionStatus type and status mapping are defined; isActiveSubscription checks if a subscription qualifies as active based on status and cancellation state.
Subscription Querying lib/stripe/getActiveSubscriptions.ts, lib/stripe/getActiveSubscriptionDetails.ts, lib/stripe/getOrgSubscription.ts	Stripe subscriptions are fetched with pagination and filtering by account metadata; individual active subscriptions are retrieved; organization-linked subscriptions are discovered via account-organization associations.
Response Builder lib/stripe/buildSubscriptionResponse.ts	Account and organization subscriptions are normalized into a unified SubscriptionResponse shape with pro status, derived status code, plan name, and source attribution.
Validation & Handler lib/stripe/validateAccountSubscriptionParams.ts, lib/stripe/getAccountSubscriptionHandler.ts	Route parameters are validated as UUIDs with authorization checks; the handler orchestrates parallel subscription retrieval and response building with error mapping and CORS headers.
API Route app/api/accounts/[id]/subscription/route.ts	Next.js route handler exposes the GET endpoint with OPTIONS support for CORS preflight and revalidation configuration.

Sequence Diagram

sequenceDiagram
    participant Client
    participant Route as Route Handler
    participant Validator as Validator
    participant Handler as Handler
    participant StripeUtil as Stripe Utilities
    participant Stripe as Stripe API
    
    Client->>Route: GET /accounts/[id]/subscription
    Route->>Validator: validateAccountSubscriptionParams()
    Validator->>Validator: Parse UUID & check auth context
    Validator-->>Route: Validated accountId
    Route->>Handler: getAccountSubscriptionHandler()
    
    Handler->>StripeUtil: Parallel fetch
    StripeUtil->>StripeUtil: getActiveSubscriptionDetails(accountId)
    StripeUtil->>Stripe: List subscriptions by metadata
    Stripe-->>StripeUtil: Active subscription or null
    StripeUtil->>StripeUtil: getOrgSubscription(accountId)
    StripeUtil->>StripeUtil: getAccountOrganizations()
    loop For each org
        StripeUtil->>StripeUtil: getActiveSubscriptionDetails(orgId)
    end
    StripeUtil-->>Handler: account sub, org sub
    
    Handler->>Handler: buildSubscriptionResponse()
    Handler->>Handler: Select active sub, map status
    Handler-->>Route: SubscriptionResponse with CORS headers
    Route-->>Client: 200 OK + JSON

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Possibly related PRs

• recoupable/api#506: Introduces overlapping Stripe subscription utilities and handlers that are directly connected to this subscription endpoint.

Poem

📋 Account subscriptions now flow free,
With Stripe and status mapped with glee—
Status codes sing, CORS headers dance,
A unified subscription endpoint stance. 🎉

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

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

---

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