@adonis-agora/payments 0.15.0 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @adonis-agora/payments
 
+## 0.15.1
+
+### Patch Changes
+
+- [#64](https://github.com/DavideCarvalho/adonis-agora-payments/pull/64) [`4a633fb`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/4a633fb53585a7bdb1dce09e05e63cbd87710b56) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Corrects what the `'payments.billingStore'` binding actually gives you.
+  
+  The 0.15.0 note showed `container.swap('payments.billingStore', ...)` as the testing seam. That is wrong twice, and both matter to anyone who tried it:
+  
+  1. `container.swap()` is typed for **class** tokens only. A string binding is replaced by re-registering it.
+  2. Re-registering it does **not** reach `PaymentsManager`. The manager takes its store as a thunk built at boot (`() => getBillingStore()`), reading the module-level accessor — so `payments.arrears()` and every other manager read keep using the store the provider resolved.
+  
+  The token is for code that receives a store by injection. For the manager path, the seam is still `setBillingStore()` from `services/main`. Documented on the binding itself so the next reader does not have to find this out from a failing test.
+
 ## 0.15.0
 
 ### Minor Changes

package/dist/src/container_bindings.d.ts

@@ -4,9 +4,7 @@ import type { BillingStore } from './billing/billing_store.js';
  *
  * `'payments.billingStore'` exists because `BillingStore` is an interface: there is no class
  * to hand `@inject()` when the app configured a custom store. AdonisJS solves the same
- * problem the same way — `'lucid.db'` is a string alias for the `Database` singleton — and it
- * is what makes the store swappable in tests through the container rather than through a
- * package-specific setter.
+ * problem the same way — `'lucid.db'` is a string alias for the `Database` singleton.
  *
  * ```ts
  * import { inject } from '@adonisjs/core'
@@ -15,10 +13,21 @@ import type { BillingStore } from './billing/billing_store.js';
  * export class Cobranca {
  *   constructor(private store: BillingStore) {}
  * }
- *
- * // in a test
- * app.container.swap('payments.billingStore', () => new InMemoryBillingStore())
  * ```
+ *
+ * WHAT THIS TOKEN DOES NOT DO, because the obvious assumption is wrong in two ways:
+ *
+ * 1. `container.swap()` does not take it. Swap is typed for CLASS tokens only; a string
+ *    binding is replaced by re-registering it (`container.singleton('payments.billingStore',
+ *    () => other)`).
+ * 2. Re-registering it does not reach `PaymentsManager`. The manager receives its store as a
+ *    thunk built at boot (`() => getBillingStore()`), which reads the module-level accessor
+ *    on `services/main` — so `payments.arrears()` and every other manager read keep using the
+ *    store the provider resolved. To substitute the store on THAT path, use
+ *    `setBillingStore()` from `services/main` and restore it afterwards.
+ *
+ * In short: the token is for code that receives a store by injection; `setBillingStore` is
+ * for code that goes through the manager.
  */
 declare module '@adonisjs/core/types' {
     interface ContainerBindings {

package/dist/src/container_bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container_bindings.d.ts","sourceRoot":"","sources":["../../src/container_bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,uBAAuB,EAAE,YAAY,CAAC;KACvC;CACF"}
+{"version":3,"file":"container_bindings.d.ts","sourceRoot":"","sources":["../../src/container_bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,uBAAuB,EAAE,YAAY,CAAC;KACvC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/payments",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Billing library for AdonisJS — 18 payment gateways behind one driver contract, with a Cashier-style subscription billing layer: Billable mixin, Lucid stores, idempotent webhook processing and an optional Durable-backed dispatcher. Part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {