@adonis-agora/payments 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # @adonis-agora/payments
 
+## 0.9.0
+
+### Minor Changes
+
+- [#32](https://github.com/DavideCarvalho/adonis-agora-payments/pull/32) [`de9387c`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/de9387c89c9a850d91e4630a65e907994a1a1d92) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - The console can see — and be trusted about — library-managed subscriptions.
+  
+  Managed subscriptions shipped without the console catching up, and the gap was widest exactly
+  where it matters: a managed row has no `gatewayId`, so there is no gateway dashboard to fall
+  back to. The console WAS the fallback, and it showed a null id and nothing else.
+  
+  **A dead renewal cron is now visible.** `renewDue` only runs because something calls it; if the
+  cron stops, nothing renews, nothing fails, and nothing says so — the revenue just stops. New
+  health check `overdue_renewals` counts active managed subscriptions whose next charge came due
+  over 2 h ago (configurable via `overdueRenewalAfter`).
+  
+  **A failing renewal is now visible.** A failed cycle deliberately changes nothing on the row —
+  the period does not advance, so it retries — which is also why it was invisible: one failing for
+  a week looked identical to one due for the first time. The runner now records
+  `lastRenewalError`, `lastRenewalAttemptAt` and `renewalFailureCount` (a streak, reset on the
+  first success), surfaced as the `failing_renewals` check and in the subscriptions list. The two
+  checks are separate because the causes are opposite: one is the cron stopped, the other is the
+  cron running and the gateway saying no.
+  
+  **The subscriptions list carries the recurrence.** `amount`, `currency`, `cycle`,
+  `currentPeriodEnd`, `nextChargeAt`, `cancelAtPeriodEnd` and the renewal-failure fields, plus a
+  `managed` flag so an operator knows there is nothing to open at the gateway.
+  
+  **MRR.** `subscriptionAmountByCycle` groups active managed subscriptions by cycle and the new
+  `monthlyRecurringRevenue()` normalises to a month. Managed only — a gateway-owned subscription
+  keeps its price at the gateway, and summing both would present half the truth as the total. An
+  unknown cycle is skipped rather than counted as monthly: an MRR wrong upwards is worse than an
+  incomplete one, because nobody audits a number that looks good.
+  
+  **No more buttons that cannot work.** `GET <api>/providers` now returns per-provider
+  capabilities, and `refundable` on a payment row accounts for them. Every paid Woovi/OpenPix Pix
+  row offered a Refund the gateway has no API for; the operator found out by clicking. With no
+  reachable manager the action is still offered — the previous behaviour, and better than hiding a
+  working button because a lookup was unavailable.
+  
+  `BillingCountQuery` gains `managed`, `nextChargeBefore` and `minRenewalFailures`.
+
+## 0.8.1
+
+### Patch Changes
+
+- [#30](https://github.com/DavideCarvalho/adonis-agora-payments/pull/30) [`cc34e21`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/cc34e2158268616f66989e7906c9a65c11dfd213) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - An application with no payment providers configured can boot.
+  
+  `PaymentsManager` threw in its CONSTRUCTOR when the driver map was empty. The provider
+  resolves the manager during boot — to publish `getPayments()` and to check webhook
+  verification — so an app with no credentials configured could not start at all. Not "payments
+  are off": the process exits. The message also named `config/payments.ts` at an app that had
+  deliberately configured nothing there.
+  
+  That state is legitimate. An application can ship before it has a gateway, and one with a
+  "no credentials, subscriptions are simulated" mode runs its whole test suite and local
+  development that way.
+  
+  Building an empty manager is now fine; ASKING it for a driver is the error, and `driver()`
+  says so with its own message rather than `Driver "" is not configured. Available drivers:
+  (none)` — true, and useless.
+
 ## 0.8.0
 
 ### Minor Changes