velirapay 0.1.1 → 0.2.1

package/dist/cjs/client.d.ts

@@ -36,7 +36,7 @@ export interface ClientOptions {
 export declare class VeliraPayClient {
     #private;
     /** The version of this library. */
-    static readonly VERSION = "0.1.1";
+    static readonly VERSION = "0.2.1";
     /** The address of the VeliraPay API. */
     static readonly DEFAULT_BASE_URL = "https://api.velirapay.com";
     /** The account the API key belongs to. */

package/dist/cjs/enums.d.ts

@@ -1,7 +1,7 @@
 /** A value the API defines, or one it adds after this version of the library. */
 export type OrString<T extends string> = T | (string & {});
 /** A coin on one particular network, such as USDT on Ethereum or USDT_TRON on Tron. The account lists the ones it accepts right now. */
-export declare const Asset: {
+export declare const Asset: Readonly<{
     readonly BTC: 'BTC';
     readonly BTC_LIGHTNING: 'BTC_LIGHTNING';
     readonly LTC: 'LTC';
@@ -25,47 +25,47 @@ export declare const Asset: {
     readonly ETH_BASE: 'ETH_BASE';
     readonly ETH_ARBITRUM: 'ETH_ARBITRUM';
     readonly POL: 'POL';
-};
+}>;
 export type Asset = (typeof Asset)[keyof typeof Asset];
 /** The states a charge moves through. */
-export declare const ChargeStatus: {
+export declare const ChargeStatus: Readonly<{
     readonly Pending: 'pending';
     readonly Underpaid: 'underpaid';
     readonly Paid: 'paid';
     readonly Expired: 'expired';
     readonly Canceled: 'canceled';
-};
+}>;
 export type ChargeStatus = (typeof ChargeStatus)[keyof typeof ChargeStatus];
 /** The states an invoice moves through. */
-export declare const InvoiceStatus: {
+export declare const InvoiceStatus: Readonly<{
     readonly Open: 'open';
     readonly Paid: 'paid';
     readonly Void: 'void';
-};
+}>;
 export type InvoiceStatus = (typeof InvoiceStatus)[keyof typeof InvoiceStatus];
 /** Where a payout has got to. */
-export declare const PayoutStatus: {
+export declare const PayoutStatus: Readonly<{
     readonly Pending: 'pending';
     readonly Sending: 'sending';
     readonly Sent: 'sent';
     readonly Failed: 'failed';
     readonly Manual: 'manual';
-};
+}>;
 export type PayoutStatus = (typeof PayoutStatus)[keyof typeof PayoutStatus];
 /** Whether a payment link takes payments. */
-export declare const PaymentLinkStatus: {
+export declare const PaymentLinkStatus: Readonly<{
     readonly Active: 'active';
     readonly Archived: 'archived';
-};
+}>;
 export type PaymentLinkStatus = (typeof PaymentLinkStatus)[keyof typeof PaymentLinkStatus];
 /** How a payment link is priced: at a set amount, or at one the customer names. */
-export declare const PricingType: {
+export declare const PricingType: Readonly<{
     readonly Fixed: 'fixed';
     readonly Open: 'open';
-};
+}>;
 export type PricingType = (typeof PricingType)[keyof typeof PricingType];
 /** The events a charge, an invoice or a payout reports, through webhooks and the events API. */
-export declare const EventType: {
+export declare const EventType: Readonly<{
     readonly ChargeCreated: 'charge.created';
     readonly ChargePaymentDetected: 'charge.payment_detected';
     readonly ChargePaid: 'charge.paid';
@@ -81,23 +81,23 @@ export declare const EventType: {
     readonly InvoiceVoided: 'invoice.voided';
     readonly PayoutSent: 'payout.sent';
     readonly PayoutConfirmed: 'payout.confirmed';
-};
+}>;
 export type EventType = (typeof EventType)[keyof typeof EventType];
 /** The mode an API key, object or webhook belongs to. */
-export declare const Mode: {
+export declare const Mode: Readonly<{
     readonly Live: 'live';
     readonly Test: 'test';
-};
+}>;
 export type Mode = (typeof Mode)[keyof typeof Mode];
 /** What kind of legal entity runs an account. */
-export declare const BusinessType: {
+export declare const BusinessType: Readonly<{
     readonly Individual: 'individual';
     readonly Company: 'company';
     readonly NonProfit: 'non_profit';
-};
+}>;
 export type BusinessType = (typeof BusinessType)[keyof typeof BusinessType];
 /** What an account sells, broadly. */
-export declare const Industry: {
+export declare const Industry: Readonly<{
     readonly DigitalProducts: 'digital_products';
     readonly Software: 'software';
     readonly Hosting: 'hosting';
@@ -110,19 +110,19 @@ export declare const Industry: {
     readonly Travel: 'travel';
     readonly Donations: 'donations';
     readonly Other: 'other';
-};
+}>;
 export type Industry = (typeof Industry)[keyof typeof Industry];
 /** How much an account expects to take in a month, in US dollars. */
-export declare const MonthlyVolume: {
+export declare const MonthlyVolume: Readonly<{
     readonly Under1k: 'under_1k';
     readonly Under10k: '1k_10k';
     readonly Under50k: '10k_50k';
     readonly Under250k: '50k_250k';
     readonly Over250k: 'over_250k';
-};
+}>;
 export type MonthlyVolume = (typeof MonthlyVolume)[keyof typeof MonthlyVolume];
 /** What a restricted API key may do. Full access gives every permission but the sensitive ones, which have to be ticked. */
-export declare const ApiKeyPermission: {
+export declare const ApiKeyPermission: Readonly<{
     readonly ChargesRead: 'charges:read';
     readonly ChargesWrite: 'charges:write';
     readonly ChargesAccept: 'charges:accept';
@@ -148,9 +148,141 @@ export declare const ApiKeyPermission: {
     readonly MembersRead: 'members:read';
     readonly MembersWrite: 'members:write';
     readonly BillingWrite: 'billing:write';
-};
+}>;
 export type ApiKeyPermission = (typeof ApiKeyPermission)[keyof typeof ApiKeyPermission];
 /** The fiat currencies prices can be set in. */
-export type Currency = 'USD' | 'EUR' | 'GBP' | 'CAD' | 'AUD' | 'CHF' | 'TRY';
-/** The roles a member can be given; an owner is never made through the API. */
-export type MemberRole = 'admin' | 'finance' | 'support' | 'viewer';
+export declare const Currency: Readonly<{
+    readonly USD: 'USD';
+    readonly EUR: 'EUR';
+    readonly GBP: 'GBP';
+    readonly CAD: 'CAD';
+    readonly AUD: 'AUD';
+    readonly CHF: 'CHF';
+    readonly TRY: 'TRY';
+}>;
+export type Currency = (typeof Currency)[keyof typeof Currency];
+/** The roles people have in an account. Owner only appears in answers: invitations and role changes take the others. */
+export declare const MemberRole: Readonly<{
+    readonly Owner: 'owner';
+    readonly Admin: 'admin';
+    readonly Finance: 'finance';
+    readonly Support: 'support';
+    readonly Viewer: 'viewer';
+}>;
+export type MemberRole = (typeof MemberRole)[keyof typeof MemberRole];
+/** The roles an invitation or a role change can give: every one but owner, which is never given through the API. */
+export type AssignableMemberRole = Exclude<MemberRole, typeof MemberRole.Owner>;
+/** The network families that each have one payout address, as payoutAddresses.update() and delete() name them. */
+export declare const AddressNetwork: Readonly<{
+    readonly Bitcoin: 'bitcoin';
+    readonly Litecoin: 'litecoin';
+    readonly Dogecoin: 'dogecoin';
+    readonly BitcoinCash: 'bitcoincash';
+    readonly Evm: 'evm';
+    readonly Bsc: 'bsc';
+    readonly Base: 'base';
+    readonly Arbitrum: 'arbitrum';
+    readonly Polygon: 'polygon';
+    readonly Tron: 'tron';
+    readonly Monero: 'monero';
+    readonly Solana: 'solana';
+    readonly Lightning: 'lightning';
+}>;
+export type AddressNetwork = (typeof AddressNetwork)[keyof typeof AddressNetwork];
+/** How the checkout looks: following the customer's device, or always light or dark. */
+export declare const CheckoutAppearance: Readonly<{
+    readonly Auto: 'auto';
+    readonly Light: 'light';
+    readonly Dark: 'dark';
+}>;
+export type CheckoutAppearance = (typeof CheckoutAppearance)[keyof typeof CheckoutAppearance];
+/** Where a webhook delivery has got to. */
+export declare const WebhookDeliveryStatus: Readonly<{
+    readonly Pending: 'pending';
+    readonly Succeeded: 'succeeded';
+    readonly Failed: 'failed';
+}>;
+export type WebhookDeliveryStatus = (typeof WebhookDeliveryStatus)[keyof typeof WebhookDeliveryStatus];
+/** The plans an account can be on: Free keeps a fee of every payment, Pro keeps none. */
+export declare const PlanName: Readonly<{
+    readonly Free: 'free';
+    readonly Pro: 'pro';
+}>;
+export type PlanName = (typeof PlanName)[keyof typeof PlanName];
+/** Whether an account is one person's or an organization's. */
+export declare const AccountType: Readonly<{
+    readonly Personal: 'personal';
+    readonly Organization: 'organization';
+}>;
+export type AccountType = (typeof AccountType)[keyof typeof AccountType];
+/** The languages the checkout can fall back on when the customer's browser asks for none of them. */
+export declare const CheckoutLocale: Readonly<{
+    readonly English: 'en';
+    readonly French: 'fr';
+    readonly German: 'de';
+    readonly Spanish: 'es';
+    readonly Turkish: 'tr';
+    readonly Portuguese: 'pt';
+    readonly Russian: 'ru';
+    readonly Arabic: 'ar';
+}>;
+export type CheckoutLocale = (typeof CheckoutLocale)[keyof typeof CheckoutLocale];
+/** What the activity log records. The API adds actions from time to time, so expect others too. */
+export declare const ActivityAction: Readonly<{
+    readonly WalletsChanged: 'wallets.changed';
+    readonly PayoutAddressAccessChanged: 'wallets.api_access_changed';
+    readonly SecondFactorRequirementChanged: 'team.second_factor_requirement_changed';
+    readonly PaymentSettingsUpdated: 'payment_settings.updated';
+    readonly ProfileUpdated: 'profile.updated';
+    readonly BusinessDetailsUpdated: 'business_details.updated';
+    readonly ApiKeyCreated: 'api_key.created';
+    readonly ApiKeyUpdated: 'api_key.updated';
+    readonly ApiKeyRevoked: 'api_key.revoked';
+    readonly WebhookCreated: 'webhook.created';
+    readonly WebhookUpdated: 'webhook.updated';
+    readonly WebhookDeleted: 'webhook.deleted';
+    readonly WebhookSecretRotated: 'webhook.secret_rotated';
+    readonly MemberInvited: 'member.invited';
+    readonly MemberJoined: 'member.joined';
+    readonly MemberRoleChanged: 'member.role_changed';
+    readonly MemberRemoved: 'member.removed';
+    readonly PaymentLinkCreated: 'payment_link.created';
+    readonly PaymentLinkUpdated: 'payment_link.updated';
+    readonly PaymentLinkArchived: 'payment_link.archived';
+    readonly PaymentLinkRestored: 'payment_link.restored';
+    readonly InvitationCanceled: 'member.invitation_canceled';
+    readonly ChargePaymentRequested: 'charge.payment_requested';
+    readonly WebhookDisabled: 'webhook.disabled';
+    readonly ChargeCanceled: 'charge.canceled';
+    readonly ChargeAccepted: 'charge.accepted';
+    readonly RefundRecorded: 'refund.recorded';
+    readonly InvoiceVoided: 'invoice.voided';
+    readonly PlanPaymentStarted: 'plan.payment_started';
+    readonly SubscriptionCanceled: 'plan.subscription_canceled';
+    readonly SubscriptionResumed: 'plan.subscription_resumed';
+    readonly SignedIn: 'auth.signed_in';
+    readonly SignInFailed: 'auth.sign_in_failed';
+    readonly PasswordChanged: 'auth.password_changed';
+    readonly TwoFactorEnabled: 'auth.two_factor_enabled';
+    readonly TwoFactorDisabled: 'auth.two_factor_disabled';
+    readonly SignedOutElsewhere: 'auth.signed_out_elsewhere';
+    readonly TwoFactorFailed: 'auth.two_factor_failed';
+    readonly EmailChanged: 'auth.email_changed';
+    readonly PasskeyAdded: 'auth.passkey_added';
+    readonly PasskeyRemoved: 'auth.passkey_removed';
+    readonly CouponCreated: 'coupon.created';
+    readonly CouponUpdated: 'coupon.updated';
+    readonly CouponDeleted: 'coupon.deleted';
+    readonly AppConnected: 'auth.app_connected';
+    readonly AppDisconnected: 'auth.app_disconnected';
+    readonly ChatConnected: 'chat.connected';
+    readonly ChatUpdated: 'chat.updated';
+    readonly ChatRemoved: 'chat.removed';
+    readonly ChatDisabled: 'chat.disabled';
+    readonly SanctionsMatched: 'sanctions.matched';
+    readonly SanctionsAccepted: 'sanctions.accepted';
+    readonly SanctionsReturnRequested: 'sanctions.return_requested';
+    readonly SocialAccountConnected: 'auth.social_connected';
+    readonly SocialAccountDisconnected: 'auth.social_disconnected';
+}>;
+export type ActivityAction = (typeof ActivityAction)[keyof typeof ActivityAction];

package/dist/cjs/enums.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiKeyPermission = exports.MonthlyVolume = exports.Industry = exports.BusinessType = exports.Mode = exports.EventType = exports.PricingType = exports.PaymentLinkStatus = exports.PayoutStatus = exports.InvoiceStatus = exports.ChargeStatus = exports.Asset = void 0;
+exports.ActivityAction = exports.CheckoutLocale = exports.AccountType = exports.PlanName = exports.WebhookDeliveryStatus = exports.CheckoutAppearance = exports.AddressNetwork = exports.MemberRole = exports.Currency = exports.ApiKeyPermission = exports.MonthlyVolume = exports.Industry = exports.BusinessType = exports.Mode = exports.EventType = exports.PricingType = exports.PaymentLinkStatus = exports.PayoutStatus = exports.InvoiceStatus = exports.ChargeStatus = exports.Asset = void 0;
 /** A coin on one particular network, such as USDT on Ethereum or USDT_TRON on Tron. The account lists the ones it accepts right now. */
-exports.Asset = {
+exports.Asset = Object.freeze({
     BTC: 'BTC',
     BTC_LIGHTNING: 'BTC_LIGHTNING',
     LTC: 'LTC',
@@ -26,41 +26,41 @@ exports.Asset = {
     ETH_BASE: 'ETH_BASE',
     ETH_ARBITRUM: 'ETH_ARBITRUM',
     POL: 'POL',
-};
+});
 /** The states a charge moves through. */
-exports.ChargeStatus = {
+exports.ChargeStatus = Object.freeze({
     Pending: 'pending',
     Underpaid: 'underpaid',
     Paid: 'paid',
     Expired: 'expired',
     Canceled: 'canceled',
-};
+});
 /** The states an invoice moves through. */
-exports.InvoiceStatus = {
+exports.InvoiceStatus = Object.freeze({
     Open: 'open',
     Paid: 'paid',
     Void: 'void',
-};
+});
 /** Where a payout has got to. */
-exports.PayoutStatus = {
+exports.PayoutStatus = Object.freeze({
     Pending: 'pending',
     Sending: 'sending',
     Sent: 'sent',
     Failed: 'failed',
     Manual: 'manual',
-};
+});
 /** Whether a payment link takes payments. */
-exports.PaymentLinkStatus = {
+exports.PaymentLinkStatus = Object.freeze({
     Active: 'active',
     Archived: 'archived',
-};
+});
 /** How a payment link is priced: at a set amount, or at one the customer names. */
-exports.PricingType = {
+exports.PricingType = Object.freeze({
     Fixed: 'fixed',
     Open: 'open',
-};
+});
 /** The events a charge, an invoice or a payout reports, through webhooks and the events API. */
-exports.EventType = {
+exports.EventType = Object.freeze({
     ChargeCreated: 'charge.created',
     ChargePaymentDetected: 'charge.payment_detected',
     ChargePaid: 'charge.paid',
@@ -76,20 +76,20 @@ exports.EventType = {
     InvoiceVoided: 'invoice.voided',
     PayoutSent: 'payout.sent',
     PayoutConfirmed: 'payout.confirmed',
-};
+});
 /** The mode an API key, object or webhook belongs to. */
-exports.Mode = {
+exports.Mode = Object.freeze({
     Live: 'live',
     Test: 'test',
-};
+});
 /** What kind of legal entity runs an account. */
-exports.BusinessType = {
+exports.BusinessType = Object.freeze({
     Individual: 'individual',
     Company: 'company',
     NonProfit: 'non_profit',
-};
+});
 /** What an account sells, broadly. */
-exports.Industry = {
+exports.Industry = Object.freeze({
     DigitalProducts: 'digital_products',
     Software: 'software',
     Hosting: 'hosting',
@@ -102,17 +102,17 @@ exports.Industry = {
     Travel: 'travel',
     Donations: 'donations',
     Other: 'other',
-};
+});
 /** How much an account expects to take in a month, in US dollars. */
-exports.MonthlyVolume = {
+exports.MonthlyVolume = Object.freeze({
     Under1k: 'under_1k',
     Under10k: '1k_10k',
     Under50k: '10k_50k',
     Under250k: '50k_250k',
     Over250k: 'over_250k',
-};
+});
 /** What a restricted API key may do. Full access gives every permission but the sensitive ones, which have to be ticked. */
-exports.ApiKeyPermission = {
+exports.ApiKeyPermission = Object.freeze({
     ChargesRead: 'charges:read',
     ChargesWrite: 'charges:write',
     ChargesAccept: 'charges:accept',
@@ -138,4 +138,129 @@ exports.ApiKeyPermission = {
     MembersRead: 'members:read',
     MembersWrite: 'members:write',
     BillingWrite: 'billing:write',
-};
+});
+/** The fiat currencies prices can be set in. */
+exports.Currency = Object.freeze({
+    USD: 'USD',
+    EUR: 'EUR',
+    GBP: 'GBP',
+    CAD: 'CAD',
+    AUD: 'AUD',
+    CHF: 'CHF',
+    TRY: 'TRY',
+});
+/** The roles people have in an account. Owner only appears in answers: invitations and role changes take the others. */
+exports.MemberRole = Object.freeze({
+    Owner: 'owner',
+    Admin: 'admin',
+    Finance: 'finance',
+    Support: 'support',
+    Viewer: 'viewer',
+});
+/** The network families that each have one payout address, as payoutAddresses.update() and delete() name them. */
+exports.AddressNetwork = Object.freeze({
+    Bitcoin: 'bitcoin',
+    Litecoin: 'litecoin',
+    Dogecoin: 'dogecoin',
+    BitcoinCash: 'bitcoincash',
+    Evm: 'evm',
+    Bsc: 'bsc',
+    Base: 'base',
+    Arbitrum: 'arbitrum',
+    Polygon: 'polygon',
+    Tron: 'tron',
+    Monero: 'monero',
+    Solana: 'solana',
+    Lightning: 'lightning',
+});
+/** How the checkout looks: following the customer's device, or always light or dark. */
+exports.CheckoutAppearance = Object.freeze({
+    Auto: 'auto',
+    Light: 'light',
+    Dark: 'dark',
+});
+/** Where a webhook delivery has got to. */
+exports.WebhookDeliveryStatus = Object.freeze({
+    Pending: 'pending',
+    Succeeded: 'succeeded',
+    Failed: 'failed',
+});
+/** The plans an account can be on: Free keeps a fee of every payment, Pro keeps none. */
+exports.PlanName = Object.freeze({
+    Free: 'free',
+    Pro: 'pro',
+});
+/** Whether an account is one person's or an organization's. */
+exports.AccountType = Object.freeze({
+    Personal: 'personal',
+    Organization: 'organization',
+});
+/** The languages the checkout can fall back on when the customer's browser asks for none of them. */
+exports.CheckoutLocale = Object.freeze({
+    English: 'en',
+    French: 'fr',
+    German: 'de',
+    Spanish: 'es',
+    Turkish: 'tr',
+    Portuguese: 'pt',
+    Russian: 'ru',
+    Arabic: 'ar',
+});
+/** What the activity log records. The API adds actions from time to time, so expect others too. */
+exports.ActivityAction = Object.freeze({
+    WalletsChanged: 'wallets.changed',
+    PayoutAddressAccessChanged: 'wallets.api_access_changed',
+    SecondFactorRequirementChanged: 'team.second_factor_requirement_changed',
+    PaymentSettingsUpdated: 'payment_settings.updated',
+    ProfileUpdated: 'profile.updated',
+    BusinessDetailsUpdated: 'business_details.updated',
+    ApiKeyCreated: 'api_key.created',
+    ApiKeyUpdated: 'api_key.updated',
+    ApiKeyRevoked: 'api_key.revoked',
+    WebhookCreated: 'webhook.created',
+    WebhookUpdated: 'webhook.updated',
+    WebhookDeleted: 'webhook.deleted',
+    WebhookSecretRotated: 'webhook.secret_rotated',
+    MemberInvited: 'member.invited',
+    MemberJoined: 'member.joined',
+    MemberRoleChanged: 'member.role_changed',
+    MemberRemoved: 'member.removed',
+    PaymentLinkCreated: 'payment_link.created',
+    PaymentLinkUpdated: 'payment_link.updated',
+    PaymentLinkArchived: 'payment_link.archived',
+    PaymentLinkRestored: 'payment_link.restored',
+    InvitationCanceled: 'member.invitation_canceled',
+    ChargePaymentRequested: 'charge.payment_requested',
+    WebhookDisabled: 'webhook.disabled',
+    ChargeCanceled: 'charge.canceled',
+    ChargeAccepted: 'charge.accepted',
+    RefundRecorded: 'refund.recorded',
+    InvoiceVoided: 'invoice.voided',
+    PlanPaymentStarted: 'plan.payment_started',
+    SubscriptionCanceled: 'plan.subscription_canceled',
+    SubscriptionResumed: 'plan.subscription_resumed',
+    SignedIn: 'auth.signed_in',
+    SignInFailed: 'auth.sign_in_failed',
+    PasswordChanged: 'auth.password_changed',
+    TwoFactorEnabled: 'auth.two_factor_enabled',
+    TwoFactorDisabled: 'auth.two_factor_disabled',
+    SignedOutElsewhere: 'auth.signed_out_elsewhere',
+    TwoFactorFailed: 'auth.two_factor_failed',
+    EmailChanged: 'auth.email_changed',
+    PasskeyAdded: 'auth.passkey_added',
+    PasskeyRemoved: 'auth.passkey_removed',
+    CouponCreated: 'coupon.created',
+    CouponUpdated: 'coupon.updated',
+    CouponDeleted: 'coupon.deleted',
+    AppConnected: 'auth.app_connected',
+    AppDisconnected: 'auth.app_disconnected',
+    ChatConnected: 'chat.connected',
+    ChatUpdated: 'chat.updated',
+    ChatRemoved: 'chat.removed',
+    ChatDisabled: 'chat.disabled',
+    SanctionsMatched: 'sanctions.matched',
+    SanctionsAccepted: 'sanctions.accepted',
+    SanctionsReturnRequested: 'sanctions.return_requested',
+    SocialAccountConnected: 'auth.social_connected',
+    SocialAccountDisconnected: 'auth.social_disconnected',
+});

package/dist/cjs/errors.d.ts

@@ -28,8 +28,17 @@ export declare class PermissionError extends ApiError {
 /** The object does not exist for this account and mode (404). */
 export declare class NotFoundError extends ApiError {
 }
-/** The object's state does not allow the action, or an idempotency key was reused for a different request or is held by one still being processed (409). */
+/**
+ * The object's state does not allow the action, or an idempotency key was reused for a different request, is held by one
+ * still being processed, or belongs to a request that succeeded but whose answer carried a secret, which wasReplayed() tells (409).
+ */
 export declare class ConflictError extends ApiError {
+    /**
+     * Whether the API answered from an earlier request with the same idempotency key that succeeded: one that made an API key or
+     * a webhook endpoint, or rotated an endpoint's signing secret, whose answer is never kept because it carried the key or
+     * secret. The library's own retry after a lost answer gets this too. The write was carried out, but its key or secret cannot be shown again.
+     */
+    wasReplayed(): boolean;
 }
 /** The request failed validation (422). */
 export declare class ValidationError extends ApiError {

package/dist/cjs/errors.js

@@ -66,8 +66,19 @@ exports.PermissionError = PermissionError;
 class NotFoundError extends ApiError {
 }
 exports.NotFoundError = NotFoundError;
-/** The object's state does not allow the action, or an idempotency key was reused for a different request or is held by one still being processed (409). */
+/**
+ * The object's state does not allow the action, or an idempotency key was reused for a different request, is held by one
+ * still being processed, or belongs to a request that succeeded but whose answer carried a secret, which wasReplayed() tells (409).
+ */
 class ConflictError extends ApiError {
+    /**
+     * Whether the API answered from an earlier request with the same idempotency key that succeeded: one that made an API key or
+     * a webhook endpoint, or rotated an endpoint's signing secret, whose answer is never kept because it carried the key or
+     * secret. The library's own retry after a lost answer gets this too. The write was carried out, but its key or secret cannot be shown again.
+     */
+    wasReplayed() {
+        return this.response.wasReplayed();
+    }
 }
 exports.ConflictError = ConflictError;
 /** The request failed validation (422). */

package/dist/cjs/http/transport.js

@@ -4,8 +4,10 @@ exports.HttpTransport = void 0;
 const node_crypto_1 = require("node:crypto");
 const errors_ts_1 = require("../errors.js");
 const api_response_ts_1 = require("./api-response.js");
-/** The statuses worth another attempt for any request. */
-const RETRYABLE_STATUSES = [429, 502, 503, 504];
+/** The statuses worth another attempt for any request, Cloudflare's 520 to 524 for an origin it got no answer from included. */
+const RETRYABLE_STATUSES = [429, 502, 503, 504, 520, 521, 522, 523, 524];
+/** The codes Node gives a connection that could not be made or was cut off, which a fetch implementation may throw as they are. */
+const NETWORK_ERROR_CODES = ['ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'EPIPE', 'EAI_AGAIN', 'ENOTFOUND', 'EHOSTUNREACH', 'ENETUNREACH'];
 /** Sends requests to the VeliraPay API and turns its answers into responses or errors. */
 class HttpTransport {
     #options;
@@ -18,6 +20,9 @@ class HttpTransport {
     /** Send a request and return the successful response. */
     async request(method, path, query = {}, body, idempotencyKey) {
         method = method.toUpperCase();
+        if (typeof idempotencyKey === 'string' && idempotencyKey.trim() === '') {
+            throw new errors_ts_1.InvalidArgumentError('An idempotency key cannot be blank: give one such as order-1042-attempt-1, or leave it out.');
+        }
         // A retried write must not be carried out twice, so every attempt carries the same key.
         if (method !== 'GET' && idempotencyKey === undefined && this.#options.maxRetries > 0) {
             idempotencyKey = (0, node_crypto_1.randomUUID)();
@@ -132,7 +137,17 @@ class HttpTransport {
 exports.HttpTransport = HttpTransport;
 /** Whether fetch failed to reach the API, or to read its answer, rather than the code calling it failing. */
 function isNetworkError(error) {
-    return error instanceof TypeError || (error instanceof Error && (error.name === 'TimeoutError' || error.name === 'AbortError'));
+    if (error instanceof TypeError) {
+        return true;
+    }
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    // node-fetch reports a connection or a body read that failed as a FetchError of the "system" type.
+    if (error.name === 'TimeoutError' || error.name === 'AbortError' || (error.name === 'FetchError' && 'type' in error && error.type === 'system')) {
+        return true;
+    }
+    return 'code' in error && typeof error.code === 'string' && NETWORK_ERROR_CODES.includes(error.code);
 }
 /** The wait before an attempt, in seconds: half a second, doubling each time, with some jitter. */
 function backoff(attempt) {

package/dist/cjs/index.d.ts

@@ -1,10 +1,10 @@
 export { VeliraPayClient, type ClientOptions } from './client.ts';
 export { VERSION } from './version.ts';
-export { ApiKeyPermission, Asset, BusinessType, ChargeStatus, EventType, Industry, InvoiceStatus, Mode, MonthlyVolume, PaymentLinkStatus, PayoutStatus, PricingType, type Currency, type MemberRole, type OrString, } from './enums.ts';
+export { AccountType, ActivityAction, AddressNetwork, ApiKeyPermission, Asset, BusinessType, ChargeStatus, CheckoutAppearance, CheckoutLocale, Currency, EventType, Industry, InvoiceStatus, MemberRole, Mode, MonthlyVolume, PaymentLinkStatus, PayoutStatus, PlanName, PricingType, WebhookDeliveryStatus, type AssignableMemberRole, type OrString, } from './enums.ts';
 export { ApiError, AuthenticationError, ConflictError, ConnectionError, InvalidArgumentError, InvalidRequestError, NotFoundError, PermissionError, RateLimitError, ServerError, SignatureVerificationError, UnexpectedResponseError, ValidationError, VeliraPayError, } from './errors.ts';
 export { ApiResponse } from './http/api-response.ts';
 export type { Fetch } from './http/transport.ts';
-export { Page, type PagePosition } from './page.ts';
+export { AssetPage, Page, type PagePosition } from './page.ts';
 export type * from './params.ts';
 export { Account, AccountBusiness, Address, type AccountCheckout, type AccountInvoices } from './resources/account.ts';
 export { Activity } from './resources/activity.ts';
@@ -15,7 +15,7 @@ export { Coupon } from './resources/coupon.ts';
 export { Event } from './resources/event.ts';
 export { Invoice, InvoiceItem, type InvoiceCharge } from './resources/invoice.ts';
 export { Invitation, Member } from './resources/member.ts';
-export { Overview } from './resources/overview.ts';
+export { Overview, type OverviewAsset, type OverviewAttention, type OverviewChargeAmount, type OverviewDay, type OverviewFunnel, type OverviewFunnelAsset, type OverviewPaymentLink, type OverviewPeriod, type OverviewSetup, type OverviewWaitingPayouts, } from './resources/overview.ts';
 export { PaymentLink, type CheckoutQuestion } from './resources/payment-link.ts';
 export { Payout, PayoutAddress, PayoutSummary } from './resources/payout.ts';
 export { ProPayment } from './resources/pro-payment.ts';