@adonis-agora/payments 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @adonis-agora/payments
 
+## 0.12.0
+
+### Minor Changes
+
+- [#43](https://github.com/DavideCarvalho/adonis-agora-payments/pull/43) [`ea598e8`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/ea598e840aa85e4b2634863165da6bd4fcde90f8) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Pagination is now `{ page, size }` everywhere, matching `@adonis-agora/filter`.
+  
+  **Breaking rename.** Every list read took `{ limit?, offset? }` with a **0-based** `offset`; it now
+  takes `{ page?, size? }` with a **1-based** `page` (default `1`) and `size` as the page size
+  (default 50, capped at 200 — the same numbers as before). The 0-based SQL offset became an internal
+  detail computed by the store, so it can no longer leak into a public type or a query string.
+  
+  The reason is ecosystem consistency, not taste: `@adonis-agora/filter` exposes `FilterInput.page`
+  /`.size` and resolves them to `{ page, size }`, and every `@adonis-agora/*` library is being moved
+  onto that one shape so an app (or a console) never has to remember which library counts from zero.
+  The match is **structural** — this package still depends on no filter package.
+  
+  ```ts
+  // before
+  await store.listPayments({ status: 'failed', limit: 20, offset: 40 })
+  // after — page 3 of 20, 1-based
+  await store.listPayments({ status: 'failed', size: 20, page: 3 })
+  ```
+  
+  What changed, concretely:
+  
+  - `BillingListQuery`, `PaymentListQuery`, `WebhookEventListQuery`, `CustomerListQuery`,
+    `AuditEventQuery`, `DisputeDeadlineQuery`, `OpenDisputeQuery` and
+    `listWebhookEventsForPayment`'s options: `limit`/`offset` → `size`/`page`.
+  - `AuditEventCountQuery` is now `Omit<AuditEventQuery, 'page' | 'size'>`, and
+    `countDisputesDueWithin` takes `Omit<DisputeDeadlineQuery, 'page' | 'size'>`.
+  - `BILLING_LIST_DEFAULT_LIMIT` → `BILLING_LIST_DEFAULT_SIZE` (still 50);
+    `BILLING_LIST_MAX_LIMIT` → `BILLING_LIST_MAX_SIZE` (still 200).
+  - `clampLimit`/`clampOffset` → `clampSize`/`clampPage`, plus `listOffset(page, size)` for stores
+    that need the SQL offset.
+  - Dashboard JSON API: lists read `?page=1&size=25` instead of `?limit=25&offset=0`, and echo the
+    paging back under `meta: { page, size, count, … }` instead of `page: { limit, offset, … }`.
+    `count === size` is still the only "there might be more" signal. `meta` is Lucid's own spelling —
+    `.paginate()` answers `{ meta, data }` — and it is the envelope key every `@adonis-agora` console
+    now uses.
+  - Dashboard SPA: `paymentsClient` list options take `{ page, size }`, the `Page` wire type is now
+    `ListMeta` and every list response carries it as `meta`, and the `Pager` control is page-based
+    (`page`/`size`/`onPage`). `ScanNotice` takes a `meta` prop.
+
+## 0.11.0
+
+### Minor Changes
+
+- [#36](https://github.com/DavideCarvalho/adonis-agora-payments/pull/36) [`1bcff3b`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/1bcff3bc62edbbdf4a8e972782dca407d92fe278) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - `payments:sync --subscriptions` — backfill and drift-correct subscription price, cycle and status.
+  
+  A subscription's price only reaches the store when a `subscription.created`/`updated` delivery
+  carries it. Every subscription created before that shipped therefore has no `amount`/`cycle` on
+  its row, and recurring-revenue maths skips it until the gateway happens to send an update —
+  which for a healthy subscription nobody edits is never.
+  
+  This is the backfill. Afterwards it is the drift correction: an amount changed in the gateway's
+  own dashboard produces no webhook on some gateways, and a reconcile is the only thing that
+  would notice.
+  
+  Two kinds of row are skipped, for opposite reasons. **Managed** ones: the library owns that
+  recurrence, the gateway has never heard of it, and "correcting" it from a gateway answer would
+  overwrite the only authority there is. **Rows with no gateway id**: a free plan or an admin
+  courtesy, with nothing to ask about.
+  
+  A subscription the gateway does not recognise is reported and left alone — never cancelled. A
+  rotated API key and a wrong environment both produce exactly that answer, and cancelling in bulk
+  from it would be worse than the problem this command solves.
+  
+  The reconcile is exported as `reconcileSubscriptions(manager, store, { provider, log })`, so it
+  can be driven from a job or a test without an ace kernel.
+
 ## 0.10.0
 
 ### Minor Changes