@billkit-eu/sdk 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,63 @@ 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.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
+- `webhookEndpoints.getDelivery()` is now `retrieveDelivery()`. Every other
+  single-row fetch in every BillKit SDK is `retrieve`, and python and php
+  already spelled this one `retrieve_delivery` / `retrieveDelivery`, so node
+  was the outlier and the obvious name was a type error. `getDelivery` stays as
+  a deprecated alias — removing it would break callers over a naming
+  preference — and goes in the next major.
+
+### Fixed
+- `CustomerListParams` is exported from the package entry point. The interface
+  documented the `provisional` filter but could not be imported, so callers
+  building the params object ahead of the call had nothing to type it with.
+
 ## [0.4.0]
 
 ### Added
@@ -172,5 +229,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

@@ -92,20 +92,22 @@ The client exposes one accessor per resource family. Each mirrors the verbs from
 
 | Accessor | Verbs |
 | --- | --- |
-| `client.customers` | `create`, `retrieve`, `update`, `delete`, `list`, `iter` |
+| `client.customers` | `create`, `retrieve`, `update`, `delete`, `list` (filter by `provisional`), `iter`, `setVatNumber`, `purge` |
 | `client.products` | `create`, `retrieve`, `update` (archive with `active: false`), `list`, `iter` |
 | `client.prices` | `create`, `retrieve`, `update` (archive with `active: false`, restore with `active: true`), `list`, `iter` |
 | `client.checkoutSessions` | `create`, `retrieve` |
 | `client.oneShotPayments` | `create`, `retrieve` |
 | `client.subscriptions` | `retrieve`, `list`, `iter` (filter by `customer_id`, `status`, `renewal_state`), `cancel`, `pause`, `resume`, `reactivate`, `previewUpdate`, `update`, `reauthorizePaymentMethod`, `createUsageRecord`, `listUsageRecords`, `iterUsageRecords`, `retrieveUsageSummary` |
 | `client.refunds` | `create`, `retrieve`, `list`, `iter` |
-| `client.webhookEndpoints` | `create`, `retrieve`, `update` (stop delivery with `status: "disabled"`), `delete`, `rotateSecret`, `list`, `iter`, `listDeliveries`, `iterDeliveries`, `getDelivery`, `redeliver` |
+| `client.disputes` | `retrieve`, `list`, `iter` |
+| `client.webhookEndpoints` | `create`, `retrieve`, `update` (stop delivery with `status: "disabled"`), `delete`, `rotateSecret`, `list`, `iter`, `listDeliveries`, `iterDeliveries`, `retrieveDelivery`, `redeliver` |
 | `client.events` | `retrieve`, `list`, `iter` (filter by `type`) |
 | `client.tenant` | `capabilities`, `portalBranding`, `setPortalBranding`, `rotateProviderCredential` |
 | `client.coupons` | `create`, `retrieve`, `update` (withdraw with `active: false`), `validate`, `list`, `iter` |
 | `client.taxRates` | `create`, `retrieve`, `update` (retire with `active: false`), `list`, `iter` |
-| `client.invoices` | `retrieve`, `retrievePdf`, `list`, `iter` |
-| `client.auditLogs` | `retrieve`, `list`, `iter` (filter by `action`, `resource_type`, `actor_id`) |
+| `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`, `resource_id`, `actor_id`) |
 | `client.payments` | `retrieve`, `list`, `iter` |
 | `client.billingPortalSessions` | `create`, `revoke` |
 
@@ -225,14 +227,16 @@ const session = await client.checkoutSessions.create<{ client_secret: string }>(
 });
 ```
 
-### Invoice PDFs
+### Invoice and credit-note PDFs
 
 ```ts
 const pdf = await client.invoices.retrievePdf("inv_123");
 await writeFile("invoice.pdf", Buffer.from(pdf));
+
+const credit = await client.creditNotes.retrievePdf("cn_123");
 ```
 
-Returns the raw bytes. S3-backed deployments answer with a redirect to a presigned URL, which is followed transparently under the SDK's own timeout and retry policy, so both storage adapters look the same from here. A deployment with PDF rendering disabled throws a `ServerError` with `code: "rendering_pending"`; `retrieve()` still gives you the structured invoice to render yourself.
+Returns the raw bytes. S3-backed deployments answer with a redirect to a presigned URL, which is followed transparently under the SDK's own timeout and retry policy, so both storage adapters look the same from here — and the API key is never sent to the storage host, because the presigned URL carries its own credential. A deployment with PDF rendering disabled throws a `ServerError` with `code: "rendering_pending"`; `retrieve()` still gives you the structured document to render yourself.
 
 ## Auto-pagination
 

package/dist/index.cjs

@@ -462,9 +462,23 @@ var WebhookEndpoints = class extends BaseResource {
     );
   }
   /** Fetch one delivery row for inspection before deciding to redeliver. */
-  getDelivery(endpointId, deliveryId) {
+  retrieveDelivery(endpointId, deliveryId) {
     return this.get(`/v1/webhook_endpoints/${endpointId}/deliveries/${deliveryId}`);
   }
+  /**
+   * @deprecated Renamed to {@link WebhookEndpoints.retrieveDelivery}.
+   *
+   * Every other single-row fetch in every BillKit SDK is `retrieve`; this
+   * one method was `get`, which meant reaching for the obvious name and
+   * getting a type error. The python and php clients already spell it
+   * `retrieve_delivery` / `retrieveDelivery`, so node was the outlier.
+   *
+   * Kept as an alias because removing it would break callers for a naming
+   * preference. It will go in the next major.
+   */
+  getDelivery(endpointId, deliveryId) {
+    return this.retrieveDelivery(endpointId, deliveryId);
+  }
   /**
    * Re-enqueue a delivery row for the dispatcher.
    *
@@ -674,6 +688,7 @@ var AuditLogs = class extends BaseResource {
       filters: {
         action: options.action,
         resource_type: options.resource_type,
+        resource_id: options.resource_id,
         actor_id: options.actor_id
       }
     });
@@ -837,7 +852,7 @@ function sleep(ms) {
 }
 
 // src/version.ts
-var VERSION = "0.4.0";
+var VERSION = "0.6.0";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.billkit.eu";