@billkit-eu/sdk 0.4.0 → 0.6.0

package/dist/index.d.cts

@@ -420,7 +420,7 @@ interface CreatePriceParams extends IdempotencyOptions {
     metadata?: Record<string, string>;
     trial_days?: number;
     trial_verification_cents?: number;
-    payment_methods?: Array<"creditcard" | "directdebit" | "ideal" | "applepay" | (string & {})>;
+    payment_methods?: Array<"creditcard" | "directdebit" | "ideal" | "eps" | "applepay" | "paypal" | (string & {})>;
     /**
      * What a cancellation refunds without being asked. `"none"` (the default)
      * nothing; `"full"` the whole last charge; `"prorated"` the unused part
@@ -531,8 +531,14 @@ interface CreateCheckoutSessionParams extends IdempotencyOptions {
      * Pin the Mollie payment method. `undefined` lets Mollie pick from
      * the customer's available methods; when set, must be in the price's
      * `payment_methods` allowlist.
+     *
+     * Subscription-starting only, so this is deliberately NARROWER than the
+     * one-shot union: `bancontact` and `banktransfer` are absent because
+     * neither can mint the mandate a renewal needs. Mollie refuses the
+     * latter outright with "The payment method does not support sequence
+     * type".
      */
-    method?: "creditcard" | "directdebit" | "ideal" | "applepay" | (string & {});
+    method?: "creditcard" | "directdebit" | "ideal" | "eps" | "applepay" | "paypal" | (string & {});
     /** Optional coupon code applied at checkout; atomically claimed. */
     coupon_code?: string;
     /**
@@ -588,8 +594,12 @@ interface CreateOneShotPaymentParams extends IdempotencyOptions {
     /**
      * Concrete Mollie method to charge with. Required, because a one-shot commits
      * up front). Validated against the tenant's capability allowlist for
-     * `currency`; one-off methods like `bancontact`/`eps` are allowed here
-     * even though they can't back a subscription.
+     * `currency`; one-off methods like `bancontact` and `banktransfer` are
+     * allowed here even though they can't back a subscription.
+     *
+     * `banktransfer` settles in DAYS, not seconds: the payer is handed bank
+     * details and Mollie holds the payment `open` for about a fortnight. Expect
+     * `one_shot_payment.paid` long after the call returns.
      *
      * `giropay` was removed: the scheme shut down at the end of 2024 and the
      * server now 422s it. The `(string & {})` tail keeps this open on
@@ -597,7 +607,7 @@ interface CreateOneShotPaymentParams extends IdempotencyOptions {
      * *request* type the server validates, so an SDK that lags a newly-added
      * method should not be the thing that blocks the call.
      */
-    method: "creditcard" | "directdebit" | "ideal" | "bancontact" | "eps" | "applepay" | (string & {});
+    method: "creditcard" | "directdebit" | "ideal" | "bancontact" | "eps" | "applepay" | "paypal" | "banktransfer" | (string & {});
     /** Where Mollie returns the payer after the hosted checkout. */
     success_url: string;
     /** Optional page for an abandoned/cancelled payment. */
@@ -700,9 +710,18 @@ interface UpdateTaxRateParams extends IdempotencyOptions {
     inclusive?: boolean;
     active?: boolean;
 }
+/**
+ * `auditLogs.list` params. All four filters match exactly and combine.
+ *
+ * `resource_type` narrows to a kind (`"customer"`, `"price"`);
+ * `resource_id` narrows to one row, which is the "everything that ever
+ * happened to this customer" question an audit log mostly exists for.
+ * Pair them or use `resource_id` alone — ids are already unique.
+ */
 interface AuditLogsListParams extends BaseListParams {
     action?: string;
     resource_type?: string;
+    resource_id?: string;
     actor_id?: string;
 }
 /**
@@ -1025,6 +1044,18 @@ declare class WebhookEndpoints extends BaseResource {
         pageSize?: number;
     }): AsyncIterableIterator<T>;
     /** Fetch one delivery row for inspection before deciding to redeliver. */
+    retrieveDelivery<T = unknown>(endpointId: string, deliveryId: string): Promise<T>;
+    /**
+     * @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<T = unknown>(endpointId: string, deliveryId: string): Promise<T>;
     /**
      * Re-enqueue a delivery row for the dispatcher.
@@ -1202,6 +1233,7 @@ declare class AuditLogs extends BaseResource {
         pageSize?: number;
         action?: string;
         resource_type?: string;
+        resource_id?: string;
         actor_id?: string;
     }): AsyncIterableIterator<T>;
 }
@@ -1318,7 +1350,7 @@ declare class RateLimitError extends BillKitError {
     });
 }
 
-declare const VERSION = "0.4.0";
+declare const VERSION = "0.6.0";
 
 /**
  * Verify `BillKit-Signature: t=<unix>,v1=<hex>` headers.
@@ -1350,4 +1382,4 @@ interface VerifyWebhookOptions {
 }
 declare function verifyWebhookSignature<T = unknown>(options: VerifyWebhookOptions): Promise<T>;
 
-export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EventsListParams, type IdempotencyOptions, InvalidRequestError, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type PaginateOptions, PermissionError, type PriceTier, type PricesListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetPortalBrandingParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };
+export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, type CustomerListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EventsListParams, type IdempotencyOptions, InvalidRequestError, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type PaginateOptions, PermissionError, type PriceTier, type PricesListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetPortalBrandingParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };

package/dist/index.d.ts

@@ -420,7 +420,7 @@ interface CreatePriceParams extends IdempotencyOptions {
     metadata?: Record<string, string>;
     trial_days?: number;
     trial_verification_cents?: number;
-    payment_methods?: Array<"creditcard" | "directdebit" | "ideal" | "applepay" | (string & {})>;
+    payment_methods?: Array<"creditcard" | "directdebit" | "ideal" | "eps" | "applepay" | "paypal" | (string & {})>;
     /**
      * What a cancellation refunds without being asked. `"none"` (the default)
      * nothing; `"full"` the whole last charge; `"prorated"` the unused part
@@ -531,8 +531,14 @@ interface CreateCheckoutSessionParams extends IdempotencyOptions {
      * Pin the Mollie payment method. `undefined` lets Mollie pick from
      * the customer's available methods; when set, must be in the price's
      * `payment_methods` allowlist.
+     *
+     * Subscription-starting only, so this is deliberately NARROWER than the
+     * one-shot union: `bancontact` and `banktransfer` are absent because
+     * neither can mint the mandate a renewal needs. Mollie refuses the
+     * latter outright with "The payment method does not support sequence
+     * type".
      */
-    method?: "creditcard" | "directdebit" | "ideal" | "applepay" | (string & {});
+    method?: "creditcard" | "directdebit" | "ideal" | "eps" | "applepay" | "paypal" | (string & {});
     /** Optional coupon code applied at checkout; atomically claimed. */
     coupon_code?: string;
     /**
@@ -588,8 +594,12 @@ interface CreateOneShotPaymentParams extends IdempotencyOptions {
     /**
      * Concrete Mollie method to charge with. Required, because a one-shot commits
      * up front). Validated against the tenant's capability allowlist for
-     * `currency`; one-off methods like `bancontact`/`eps` are allowed here
-     * even though they can't back a subscription.
+     * `currency`; one-off methods like `bancontact` and `banktransfer` are
+     * allowed here even though they can't back a subscription.
+     *
+     * `banktransfer` settles in DAYS, not seconds: the payer is handed bank
+     * details and Mollie holds the payment `open` for about a fortnight. Expect
+     * `one_shot_payment.paid` long after the call returns.
      *
      * `giropay` was removed: the scheme shut down at the end of 2024 and the
      * server now 422s it. The `(string & {})` tail keeps this open on
@@ -597,7 +607,7 @@ interface CreateOneShotPaymentParams extends IdempotencyOptions {
      * *request* type the server validates, so an SDK that lags a newly-added
      * method should not be the thing that blocks the call.
      */
-    method: "creditcard" | "directdebit" | "ideal" | "bancontact" | "eps" | "applepay" | (string & {});
+    method: "creditcard" | "directdebit" | "ideal" | "bancontact" | "eps" | "applepay" | "paypal" | "banktransfer" | (string & {});
     /** Where Mollie returns the payer after the hosted checkout. */
     success_url: string;
     /** Optional page for an abandoned/cancelled payment. */
@@ -700,9 +710,18 @@ interface UpdateTaxRateParams extends IdempotencyOptions {
     inclusive?: boolean;
     active?: boolean;
 }
+/**
+ * `auditLogs.list` params. All four filters match exactly and combine.
+ *
+ * `resource_type` narrows to a kind (`"customer"`, `"price"`);
+ * `resource_id` narrows to one row, which is the "everything that ever
+ * happened to this customer" question an audit log mostly exists for.
+ * Pair them or use `resource_id` alone — ids are already unique.
+ */
 interface AuditLogsListParams extends BaseListParams {
     action?: string;
     resource_type?: string;
+    resource_id?: string;
     actor_id?: string;
 }
 /**
@@ -1025,6 +1044,18 @@ declare class WebhookEndpoints extends BaseResource {
         pageSize?: number;
     }): AsyncIterableIterator<T>;
     /** Fetch one delivery row for inspection before deciding to redeliver. */
+    retrieveDelivery<T = unknown>(endpointId: string, deliveryId: string): Promise<T>;
+    /**
+     * @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<T = unknown>(endpointId: string, deliveryId: string): Promise<T>;
     /**
      * Re-enqueue a delivery row for the dispatcher.
@@ -1202,6 +1233,7 @@ declare class AuditLogs extends BaseResource {
         pageSize?: number;
         action?: string;
         resource_type?: string;
+        resource_id?: string;
         actor_id?: string;
     }): AsyncIterableIterator<T>;
 }
@@ -1318,7 +1350,7 @@ declare class RateLimitError extends BillKitError {
     });
 }
 
-declare const VERSION = "0.4.0";
+declare const VERSION = "0.6.0";
 
 /**
  * Verify `BillKit-Signature: t=<unix>,v1=<hex>` headers.
@@ -1350,4 +1382,4 @@ interface VerifyWebhookOptions {
 }
 declare function verifyWebhookSignature<T = unknown>(options: VerifyWebhookOptions): Promise<T>;
 
-export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EventsListParams, type IdempotencyOptions, InvalidRequestError, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type PaginateOptions, PermissionError, type PriceTier, type PricesListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetPortalBrandingParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };
+export { APIConnectionError, APIError, type AuditLogsListParams, AuthenticationError, type BaseListParams, BillKit, BillKitError, type BillKitLogger, type BillKitOptions, ConflictError, type CreateBillingPortalSessionParams, type CreateCheckoutSessionParams, type CreateCouponParams, type CreateCustomerParams, type CreateOneShotPaymentParams, type CreatePriceParams, type CreateProductParams, type CreateRefundParams, type CreateTaxRateParams, type CreateUsageRecordParams, type CreateWebhookEndpointParams, type CreditNotesListParams, type CustomerListParams, DEFAULT_RETRY_POLICY, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EventsListParams, type IdempotencyOptions, InvalidRequestError, type ListParams, type ListResponseEnvelope, type LogContext, NOOP_LOGGER, type PaginateOptions, PermissionError, type PriceTier, type PricesListParams, RateLimitError, ResourceMissingError, type RetryPolicy, type RotateProviderCredentialParams, ServerError, type SetPortalBrandingParams, type SubscriptionsListParams, type UpdateCouponParams, type UpdateCustomerParams, type UpdateProductParams, type UpdateTaxRateParams, type UpdateWebhookEndpointParams, type UsageRecordsListParams, VERSION, type ValidateCouponParams, type VerifyWebhookOptions, type VoidInvoiceParams, WebhookVerificationError, paginate, verifyWebhookSignature };

package/dist/index.js

@@ -460,9 +460,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.
    *
@@ -672,6 +686,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
       }
     });
@@ -835,7 +850,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";