@billkit-eu/sdk 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -8,6 +8,41 @@ 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.1] - 2026-09-25
+
+### Added
+- `UpdateProductParams.default_price_id` (`string | null`) for the product's default price, the one the billing portal offers on that price's interval. It must be an active price of the same product. An explicit `null` clears it and is sent as a JSON null rather than pruned; omitting the field leaves the default alone.
+- `products.retrieve` and `products.list` document the `default_price` expansion alongside `prices` and `stats`.
+
+### Changed
+- `SetTenantBillingProfileParams` documents that the tenant `vat_id` is set once: changing it or clearing it with `null` afterwards is refused with a 400 `vat_id_locked` on `vat_id` and writes nothing, and support changes it. The address fields and `registration_number` still clear with `null`.
+
+## [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
@@ -229,7 +264,9 @@ 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.6.0...HEAD
+[Unreleased]: https://github.com/billkit-eu/billkit-node/compare/v0.7.1...HEAD
+[0.7.1]: https://github.com/billkit-eu/billkit-node/compare/v0.7.0...v0.7.1
+[0.7.0]: https://github.com/billkit-eu/billkit-node/compare/v0.6.0...v0.7.0
 [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

package/README.md

@@ -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",
 };