@billkit-eu/sdk 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -8,6 +8,74 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 Versioning is independent of the Python SDK; the two ship on their own cadence,
 so the numbers will diverge after this first release.
 
+## [0.7.0] - 2026-09-23
+
+### Fixed
+- `CreateCouponParams.discount_type` now types the API's two literals, `"percent"` and `"fixed_cents"`; it had offered `"percentage"` / `"amount"`, neither of which the API accepts.
+- Every path id is percent-encoded, so an id containing `/`, `?` or `#` can no longer rewrite the request onto a different route.
+- `APIConnectionError` carries the original fetch failure as `cause`, including on the timeout path, so Node's "fetch failed" no longer hides the real reason.
+- `BaseListParams` lost its index signature, so a misspelled filter is a compile error instead of a query parameter the server ignores. `ListParams` stays exported as a deprecated alias.
+
+### Added
+- `apiKeys` resource: `create`, `retrieve`, `revoke`, `list`, `iter`.
+- `invoices.sendEmail(id)` for `POST /v1/invoices/{id}/email`.
+- `payments.retrieveProvider(id)` for `GET /v1/payments/{id}/provider`.
+- `tenant.billingProfile()` / `tenant.setBillingProfile(params)` for the seller's country, VAT id and invoice address; an explicit `null` clears a field.
+- `tenant.export()` returns the account's full JSON export as raw bytes.
+- `webhookEndpoints.listEventTypes()` for the deliverable-event catalogue.
+- `expand?: string[]` on `customers.list`, `products.list`, `subscriptions.list`, `payments.list`, `invoices.list` and `events.list`, and as an optional second argument on `products.retrieve`, `subscriptions.retrieve`, `payments.retrieve` and `invoices.retrieve`.
+- `payments.list` types `customer_id`; `invoices.list` types `customer_id`, `subscription_id`, `payment_id` and `status`; `disputes.list` types `status` and `payment_id`. All are carried onto every page by `iter()`.
+- `CreateCheckoutSessionParams.country`, so VAT applies to the first charge on the hosted flow.
+- `CreateBillingPortalSessionParams.deliver_email`, which also emails the portal link to the customer.
+- New exported types: `CreateApiKeyParams`, `SetTenantBillingProfileParams`, `ExpandOptions`, `DisputesListParams`, `InvoicesListParams`, `PaymentsListParams`, `ProductsListParams`, `SetCustomerVatNumberParams`, `UpdatePriceParams`.
+
+### Changed
+- `UpdatePriceParams` accepts every field `PriceUpdate` does (`active`, `metadata`, `tax_behavior`, `payment_methods`, `refund_on_cancel`, `refund_window_initial_days`, `refund_window_renewal_days`), all optional, where `active` was previously required and alone.
+- `SetCustomerVatNumberParams.vat_number` is `string | null`; an explicit `null` clears the registration and is not pruned.
+- `billingPortalSessions.create` prunes undefined fields instead of sending a fixed body.
+
+## [0.6.0] - 2026-09-23
+
+### Added
+- **`eps` and `paypal` can now start a subscription**, not just take a one-off
+  charge. Both are accepted wherever a payment method is named: the
+  `checkoutSessions.create` `method` union, a price's `payment_methods`
+  allowlist, and the one-shot union.
+  - **EPS** mints a *SEPA* mandate, exactly as iDEAL does, so the subscription
+    renews on `directdebit`.
+  - EPS is **Austria-only** and carries a **EUR 1.00 minimum** — a hundred
+    times iDEAL's. A fully-discounted first charge on a price offering it is
+    raised to that floor.
+  - **PayPal** mints a `paypal` mandate and renews on itself. No country
+    restriction.
+  - `bancontact` stays one-off only: Mollie's recurring guide and its
+    Bancontact method page disagree about whether it mints a mandate, and that
+    is being settled against a live profile rather than guessed.
+
+- **`banktransfer` joins the `oneShotPayments.create` method union.** One-off
+  only, for the same reason `bancontact` is.
+  - It mints no mandate, so it can neither anchor a subscription nor settle a
+    metered cycle. Mollie refuses it at `sequenceType=first` with "The payment
+    method does not support sequence type" — which is why the checkout union
+    stays narrower than the one-shot one rather than the two converging.
+  - **It settles in days, not seconds.** The payer is handed bank details and
+    pays on their own schedule, so Mollie holds the payment `open` for about a
+    fortnight and `expires_at` comes back roughly 13 days out.
+  - A pending bank transfer is **not a failure and not something to poll** —
+    wait for `one_shot_payment.succeeded` / `.failed`.
+  - Nothing expires early: the server's reaper keys on the `expires_at` copied
+    from Mollie's own answer, not on a BillKit-invented window.
+  - Minimum is EUR 0.01, measured against a live profile rather than read off
+    a page.
+
+- **`resource_id` filter on `auditLogs.list()` and `auditLogs.iter()`.**
+  - It answers "everything that ever happened to this customer", which is the
+    question an audit log mostly exists for.
+  - The API has always accepted it; this SDK named three of its four filters
+    and omitted this one.
+  - Matches exactly, and combines with `resource_type` rather than replacing
+    it.
+
 ## [0.5.0] - 2026-09-22
 
 ### Changed
@@ -187,5 +255,11 @@ First public release.
   back a one-shot paid with giropay before the shutdown works;
   `OneShotPayment.method` is a plain `string`.
 
-[Unreleased]: https://github.com/billkit-eu/billkit-node/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/billkit-eu/billkit-node/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/billkit-eu/billkit-node/compare/v0.5.0...v0.6.0
+[0.5.0]: https://github.com/billkit-eu/billkit-node/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/billkit-eu/billkit-node/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/billkit-eu/billkit-node/compare/v0.2.1...v0.3.0
+[0.2.1]: https://github.com/billkit-eu/billkit-node/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/billkit-eu/billkit-node/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/billkit-eu/billkit-node/releases/tag/v0.1.0

package/README.md

@@ -107,7 +107,7 @@ The client exposes one accessor per resource family. Each mirrors the verbs from
 | `client.taxRates` | `create`, `retrieve`, `update` (retire with `active: false`), `list`, `iter` |
 | `client.invoices` | `retrieve`, `retrievePdf`, `list`, `iter`, `void` |
 | `client.creditNotes` | `retrieve`, `retrievePdf`, `list`, `iter` (filter by `invoice_id`, `customer_id`) |
-| `client.auditLogs` | `retrieve`, `list`, `iter` (filter by `action`, `resource_type`, `actor_id`) |
+| `client.auditLogs` | `retrieve`, `list`, `iter` (filter by `action`, `resource_type`, `resource_id`, `actor_id`) |
 | `client.payments` | `retrieve`, `list`, `iter` |
 | `client.billingPortalSessions` | `create`, `revoke` |
 
@@ -422,8 +422,10 @@ import type {
 } from "@billkit-eu/sdk";
 
 const couponParams: CreateCouponParams = {
+  // "percent" reads discount_value as whole percent; "fixed_cents" reads
+  // it as minor units off the charge. Those are the only two values.
   code: "WELCOME10",
-  discount_type: "percentage",
+  discount_type: "percent",
   discount_value: 10,
   duration: "once",
 };