feat(payments): implement provider-backed subscription pause

[pharwasz]

Summary

This PR implements provider-backed subscription pausing to ensure that pausing a subscription suspends billing both locally and at the payment provider. close #1005

What Changed

• Added a PAUSED subscription status and migration support.

• Updated subscription pause/resume flow to:

  • Set the subscription status to PAUSED on pause.
  • Restore the status to ACTIVE on resume.
  • Call the payment provider's pause/resume API to suspend and resume billing.

• Added a scheduled job to automatically resume subscriptions at resumeAt.

• Updated renewal processing to skip paused subscriptions.

• Updated active subscription queries to exclude paused subscriptions.

• Added/updated tests covering pause and resume behavior.

• Fixed TypeScript issues related to the Stripe provider implementation and subscription processing.

Why

Previously, pausing a subscription only updated local metadata while the subscription remained active at the payment provider. As a result:

• Customers continued to be billed.
• Paused subscriptions were still treated as active.
• Renewal processing continued for paused subscriptions.

This implementation keeps the local subscription state and the payment provider in sync, ensuring paused subscriptions are not billed or renewed until they are resumed.

Testing

• ✅ npm run typecheck
• ✅ Updated unit tests for subscription pause/resume behavior

[drips-wave]

@pharwasz 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

[RUKAYAT-CODER]

Thank you for contributing to the project.

[pharwasz]

Thank you for contributing to the project.

Thanks for the opportunity 🙇