tupay 0.5.2

package/dist/cjs/resources/merchants.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Merchants = void 0;
+class Merchants {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Profil du marchand associé à la clé.
+     *
+     * Utile au démarrage : `kyb_status` doit valoir `validated` pour
+     * encaisser en mode live, et `id` est le `merchantId` attendu par
+     * `paymentIntents.create`.
+     *
+     * La mise à jour du profil (nom, IBAN) n'est pas exposée : elle exige
+     * une session humaine sur le dashboard, parce que changer l'IBAN
+     * redirige les virements.
+     */
+    async me() {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: '/merchants/me',
+        });
+        return data;
+    }
+}
+exports.Merchants = Merchants;
+//# sourceMappingURL=merchants.js.map

package/dist/cjs/resources/merchants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchants.js","sourceRoot":"","sources":["../../../src/resources/merchants.ts"],"names":[],"mappings":";;;AAGA,MAAa,SAAS;IACS;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB;YAC7D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe;SACtB,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AArBD,8BAqBC"}

package/dist/cjs/resources/payment-intents.d.ts

@@ -0,0 +1,29 @@
+import { TupayClient } from '../client.js';
+import type { PaymentIntent } from '../types.js';
+export interface CreatePaymentIntentParams {
+    /** Entier XPF, entre 100 et 10 000 000. */
+    amountXpf: number;
+    /**
+     * Facultatif — le marchand est déduit de votre clé API.
+     *
+     * Ne le fournissez que si vous tenez à ce que le serveur vérifie que
+     * vous visez bien le compte attendu : un `merchantId` qui ne
+     * correspond pas à la clé répond 403.
+     */
+    merchantId?: string;
+    paymentLinkId?: string;
+    metadata?: Record<string, string>;
+    /**
+     * Clé d'idempotence. Omise, le SDK en génère une (UUID v4) : la requête
+     * devient rejouable sans risque de double débit. Fournissez la vôtre si
+     * vous voulez qu'un retry applicatif ultérieur retombe sur le même
+     * résultat — par exemple une clé dérivée de votre numéro de commande.
+     */
+    idempotencyKey?: string;
+}
+export declare class PaymentIntents {
+    private readonly client;
+    constructor(client: TupayClient);
+    create(params: CreatePaymentIntentParams): Promise<PaymentIntent>;
+}
+//# sourceMappingURL=payment-intents.d.ts.map

package/dist/cjs/resources/payment-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-intents.d.ts","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;CAUxE"}

package/dist/cjs/resources/payment-intents.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentIntents = void 0;
+const client_js_1 = require("../client.js");
+class PaymentIntents {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params) {
+        const { idempotencyKey, ...body } = params;
+        const { data } = await this.client.request({
+            method: 'POST',
+            path: '/payments/intent',
+            body,
+            idempotencyKey: idempotencyKey ?? client_js_1.TupayClient.idempotencyKey(),
+        });
+        return data;
+    }
+}
+exports.PaymentIntents = PaymentIntents;
+//# sourceMappingURL=payment-intents.js.map

package/dist/cjs/resources/payment-intents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-intents.js","sourceRoot":"","sources":["../../../src/resources/payment-intents.ts"],"names":[],"mappings":";;;AAAA,4CAA0C;AAyB1C,MAAa,cAAc;IACI;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,MAAiC;QAC5C,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YAClE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI;YACJ,cAAc,EAAE,cAAc,IAAI,uBAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAbD,wCAaC"}

package/dist/cjs/resources/payment-links.d.ts

@@ -0,0 +1,38 @@
+import type { TupayClient } from '../client.js';
+import type { ListResult, PaymentLink } from '../types.js';
+import { type ListParams } from '../liste.js';
+export interface CreatePaymentLinkParams {
+    /** Entier XPF, entre 100 et 10 000 000. Le XPF n'a pas de centimes. */
+    amountXpf: number;
+    description: string;
+    /**
+     * Où renvoyer le client après paiement. Tupay y ajoute
+     * `?tupay_transaction=<uuid>&tupay_status=<statut>`.
+     *
+     * ⚠️ Ces paramètres transitent par le navigateur du client : ils sont
+     * falsifiables. Ne validez jamais une commande dessus — seul le
+     * webhook signé fait foi.
+     */
+    returnUrl?: string;
+    /** Vos identifiants (n° de commande…), relisibles via `retrieve()`. */
+    metadata?: Record<string, string>;
+}
+export declare class PaymentLinks {
+    #private;
+    private readonly client;
+    constructor(client: TupayClient);
+    /**
+     * Crée un lien de paiement partageable.
+     *
+     * Non rejouable automatiquement : l'API n'accepte pas d'en-tête
+     * d'idempotence ici, une reprise créerait un second lien. En cas de
+     * timeout, listez avant de recréer.
+     */
+    create(params: CreatePaymentLinkParams): Promise<PaymentLink>;
+    retrieve(id: string): Promise<PaymentLink>;
+    list(params?: ListParams): Promise<ListResult<PaymentLink>>;
+    /** Désactive le lien : il n'est plus payable, mais reste consultable. */
+    deactivate(id: string): Promise<PaymentLink>;
+    activate(id: string): Promise<PaymentLink>;
+}
+//# sourceMappingURL=payment-links.d.ts.map

package/dist/cjs/resources/payment-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-links.d.ts","sourceRoot":"","sources":["../../../src/resources/payment-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,qBAAa,YAAY;;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAS7D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ1C,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAUrE,yEAAyE;IACnE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAYjD"}

package/dist/cjs/resources/payment-links.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentLinks = void 0;
+const liste_js_1 = require("../liste.js");
+class PaymentLinks {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Crée un lien de paiement partageable.
+     *
+     * Non rejouable automatiquement : l'API n'accepte pas d'en-tête
+     * d'idempotence ici, une reprise créerait un second lien. En cas de
+     * timeout, listez avant de recréer.
+     */
+    async create(params) {
+        const { data } = await this.client.request({
+            method: 'POST',
+            path: '/payment-links',
+            body: params,
+        });
+        return data;
+    }
+    async retrieve(id) {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: `/payment-links/${encodeURIComponent(id)}`,
+        });
+        return data;
+    }
+    async list(params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: '/payment-links',
+            query: (0, liste_js_1.parametresListe)(params),
+        }));
+    }
+    /** Désactive le lien : il n'est plus payable, mais reste consultable. */
+    async deactivate(id) {
+        return this.#setActive(id, false);
+    }
+    async activate(id) {
+        return this.#setActive(id, true);
+    }
+    async #setActive(id, active) {
+        const { data } = await this.client.request({
+            method: 'PATCH',
+            path: `/payment-links/${encodeURIComponent(id)}`,
+            body: { active },
+        });
+        return data;
+    }
+}
+exports.PaymentLinks = PaymentLinks;
+//# sourceMappingURL=payment-links.js.map

package/dist/cjs/resources/payment-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-links.js","sourceRoot":"","sources":["../../../src/resources/payment-links.ts"],"names":[],"mappings":";;;AAEA,0CAKoB;AAmBpB,MAAa,YAAY;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,MAA+B;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB;YAChE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,MAAM;SACb,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB;YAChE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE;SACjD,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAqB,EAAE;QAChC,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YACjD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,IAAA,0BAAe,EAAC,MAAM,CAAC;SAC/B,CAAC,CACH,CAAA;IACH,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,MAAe;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB;YAChE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAChD,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAtDD,oCAsDC"}

package/dist/cjs/resources/refunds.d.ts

@@ -0,0 +1,27 @@
+import { TupayClient } from '../client.js';
+import type { ListResult, Refund } from '../types.js';
+import { type ListParams } from '../liste.js';
+export interface CreateRefundParams {
+    transactionId: string;
+    /**
+     * Montant à rembourser, en XPF entiers. **Omis = tout le reliquat.**
+     *
+     * Les remboursements partiels s'accumulent : après un remboursement
+     * partiel, `transaction.status` reste `succeeded` et c'est
+     * `refundedAmountXpf` qui reflète le cumul.
+     */
+    amountXpf?: number;
+    reason?: string;
+    /** Omise, le SDK génère un UUID v4 — la requête devient rejouable. */
+    idempotencyKey?: string;
+}
+export interface ListRefundsParams extends ListParams {
+    transactionId?: string;
+}
+export declare class Refunds {
+    private readonly client;
+    constructor(client: TupayClient);
+    create(params: CreateRefundParams): Promise<Refund>;
+    list(params?: ListRefundsParams): Promise<ListResult<Refund>>;
+}
+//# sourceMappingURL=refunds.d.ts.map

package/dist/cjs/resources/refunds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refunds.d.ts","sourceRoot":"","sources":["../../../src/resources/refunds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAWnD,IAAI,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;CAYxE"}

package/dist/cjs/resources/refunds.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Refunds = void 0;
+const client_js_1 = require("../client.js");
+const liste_js_1 = require("../liste.js");
+class Refunds {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params) {
+        const { idempotencyKey, ...body } = params;
+        const { data } = await this.client.request({
+            method: 'POST',
+            path: '/refunds',
+            body,
+            idempotencyKey: idempotencyKey ?? client_js_1.TupayClient.idempotencyKey(),
+        });
+        return data;
+    }
+    async list(params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: '/refunds',
+            query: {
+                ...(0, liste_js_1.parametresListe)(params),
+                transactionId: params.transactionId,
+            },
+        }));
+    }
+}
+exports.Refunds = Refunds;
+//# sourceMappingURL=refunds.js.map

package/dist/cjs/resources/refunds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refunds.js","sourceRoot":"","sources":["../../../src/resources/refunds.ts"],"names":[],"mappings":";;;AAAA,4CAA0C;AAE1C,0CAKoB;AAqBpB,MAAa,OAAO;IACW;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,MAA0B;QACrC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAmB;YAC3D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,cAAc,EAAE,cAAc,IAAI,uBAAW,CAAC,cAAc,EAAE;SAC/D,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA4B,EAAE;QACvC,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE;gBACL,GAAG,IAAA,0BAAe,EAAC,MAAM,CAAC;gBAC1B,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC;SACF,CAAC,CACH,CAAA;IACH,CAAC;CACF;AA1BD,0BA0BC"}

package/dist/cjs/resources/test-helpers.d.ts

@@ -0,0 +1,42 @@
+import type { TupayClient } from '../client.js';
+import type { Transaction } from '../types.js';
+export type SimulateOutcome = 'succeeded' | 'failed' | 'processing';
+export interface SimulateResult extends Transaction {
+    simulated: true;
+    eventId?: string;
+    endpointsNotified?: number;
+    alreadyInState?: boolean;
+}
+/**
+ * Utilitaires réservés au **mode test**.
+ *
+ * Le bac à sable ne résout pas les paiements tout seul : c'est vous qui
+ * décidez de l'issue. C'est ce qui permet de tester les chemins d'échec
+ * et de recevoir de vrais webhooks signés sans qu'un centime bouge.
+ */
+export declare class TestHelpers {
+    private readonly client;
+    constructor(client: TupayClient);
+    /**
+     * Force l'issue d'un paiement de test et déclenche le webhook associé.
+     *
+     * Rejouer la même issue ne réémet pas d'événement (`alreadyInState`).
+     *
+     * @throws {TupayError} si le client a été construit avec une clé live —
+     *         on échoue localement plutôt que d'envoyer une requête vouée au 403.
+     */
+    simulatePayment(transactionId: string, outcome: SimulateOutcome): Promise<SimulateResult>;
+    /**
+     * Montants XPF qui provoquent un échec **dès la création** de l'intent.
+     * Pratique pour tester vos écrans d'erreur.
+     */
+    static readonly magicAmounts: {
+        /** → `card_declined` */
+        readonly cardDeclined: 402;
+        /** → `insufficient_funds` */
+        readonly insufficientFunds: 403;
+        /** → `rate_limited` (marquée réessayable) */
+        readonly rateLimited: 429;
+    };
+}
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/cjs/resources/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/resources/test-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEnE,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;OAOG;IACG,eAAe,CACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC;IAgB1B;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,YAAY;QAC1B,wBAAwB;;QAExB,6BAA6B;;QAE7B,6CAA6C;;MAErC;CACX"}

package/dist/cjs/resources/test-helpers.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestHelpers = void 0;
+const errors_js_1 = require("../errors.js");
+/**
+ * Utilitaires réservés au **mode test**.
+ *
+ * Le bac à sable ne résout pas les paiements tout seul : c'est vous qui
+ * décidez de l'issue. C'est ce qui permet de tester les chemins d'échec
+ * et de recevoir de vrais webhooks signés sans qu'un centime bouge.
+ */
+class TestHelpers {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Force l'issue d'un paiement de test et déclenche le webhook associé.
+     *
+     * Rejouer la même issue ne réémet pas d'événement (`alreadyInState`).
+     *
+     * @throws {TupayError} si le client a été construit avec une clé live —
+     *         on échoue localement plutôt que d'envoyer une requête vouée au 403.
+     */
+    async simulatePayment(transactionId, outcome) {
+        if (this.client.livemode) {
+            throw new errors_js_1.TupayError('simulatePayment est réservé au mode test. Construisez le client avec une clé tpk_test_.', { code: 'livemode_mismatch' });
+        }
+        const { data } = await this.client.request({
+            method: 'POST',
+            path: '/test/simulate',
+            body: { transactionId, outcome },
+        });
+        return data;
+    }
+    /**
+     * Montants XPF qui provoquent un échec **dès la création** de l'intent.
+     * Pratique pour tester vos écrans d'erreur.
+     */
+    static magicAmounts = {
+        /** → `card_declined` */
+        cardDeclined: 402,
+        /** → `insufficient_funds` */
+        insufficientFunds: 403,
+        /** → `rate_limited` (marquée réessayable) */
+        rateLimited: 429,
+    };
+}
+exports.TestHelpers = TestHelpers;
+//# sourceMappingURL=test-helpers.js.map

package/dist/cjs/resources/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/resources/test-helpers.ts"],"names":[],"mappings":";;;AAAA,4CAAyC;AAazC;;;;;;GAMG;AACH,MAAa,WAAW;IACO;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,aAAqB,EACrB,OAAwB;QAExB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,sBAAU,CAClB,yFAAyF,EACzF,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAC9B,CAAA;QACH,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA2B;YACnE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE;SACjC,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,YAAY,GAAG;QAC7B,wBAAwB;QACxB,YAAY,EAAE,GAAG;QACjB,6BAA6B;QAC7B,iBAAiB,EAAE,GAAG;QACtB,6CAA6C;QAC7C,WAAW,EAAE,GAAG;KACR,CAAA;;AAzCZ,kCA0CC"}

package/dist/cjs/resources/transactions.d.ts

@@ -0,0 +1,29 @@
+import type { TupayClient } from '../client.js';
+import type { ListResult, Transaction, TransactionStatus } from '../types.js';
+import { type ListParams } from '../liste.js';
+export interface ListTransactionsParams extends ListParams {
+    status?: TransactionStatus;
+    /** Date ISO 8601 — ne renvoie que les transactions postérieures. */
+    createdAfter?: string;
+}
+export declare class Transactions {
+    private readonly client;
+    constructor(client: TupayClient);
+    retrieve(id: string): Promise<Transaction>;
+    list(params?: ListTransactionsParams): Promise<ListResult<Transaction>>;
+    /**
+     * Parcourt toutes les pages, une transaction à la fois.
+     *
+     * Avance par CURSEUR et non plus par décalage : une transaction qui
+     * naît pendant le parcours ne décale plus la fenêtre, et rien n'est
+     * sauté. `offset` reste accepté par `list()`, mais l'itérateur ne s'y
+     * appuie plus.
+     *
+     * @example
+     * for await (const tx of tupay.transactions.autoPagingEach({ status: 'succeeded' })) {
+     *   total += tx.amountXpf
+     * }
+     */
+    autoPagingEach(params?: ListTransactionsParams): AsyncGenerator<Transaction, void, undefined>;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/cjs/resources/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ1C,IAAI,CAAC,MAAM,GAAE,sBAA2B,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAcjF;;;;;;;;;;;;OAYG;IACI,cAAc,CACnB,MAAM,GAAE,sBAA2B,GAClC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;CAqBhD"}

package/dist/cjs/resources/transactions.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transactions = void 0;
+const liste_js_1 = require("../liste.js");
+class Transactions {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async retrieve(id) {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: `/transactions/${encodeURIComponent(id)}`,
+        });
+        return data;
+    }
+    async list(params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: '/transactions',
+            query: {
+                ...(0, liste_js_1.parametresListe)(params),
+                status: params.status,
+                created_after: params.createdAfter,
+            },
+        }));
+    }
+    /**
+     * Parcourt toutes les pages, une transaction à la fois.
+     *
+     * Avance par CURSEUR et non plus par décalage : une transaction qui
+     * naît pendant le parcours ne décale plus la fenêtre, et rien n'est
+     * sauté. `offset` reste accepté par `list()`, mais l'itérateur ne s'y
+     * appuie plus.
+     *
+     * @example
+     * for await (const tx of tupay.transactions.autoPagingEach({ status: 'succeeded' })) {
+     *   total += tx.amountXpf
+     * }
+     */
+    async *autoPagingEach(params = {}) {
+        const limit = params.limit ?? 100;
+        let startingAfter = params.startingAfter;
+        let precedent;
+        for (;;) {
+            const page = await this.list({ ...params, limit, offset: undefined, startingAfter });
+            for (const transaction of page.data)
+                yield transaction;
+            const dernier = page.data[page.data.length - 1];
+            // Une page vide signifie la fin, même si le serveur annonçait
+            // `hasMore` : ceinture et bretelles contre une boucle infinie.
+            if (!page.hasMore || !dernier)
+                return;
+            // Et si le curseur n'avance pas, on s'arrête aussi. Une API plus
+            // ancienne que ce SDK ignorerait `starting_after` et rendrait
+            // indéfiniment la première page.
+            if (dernier.id === precedent)
+                return;
+            precedent = dernier.id;
+            startingAfter = dernier.id;
+        }
+    }
+}
+exports.Transactions = Transactions;
+//# sourceMappingURL=transactions.js.map

package/dist/cjs/resources/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":";;;AAEA,0CAKoB;AAQpB,MAAa,YAAY;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB;YAChE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE;SAChD,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiC,EAAE;QAC5C,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B;YACjD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE;gBACL,GAAG,IAAA,0BAAe,EAAC,MAAM,CAAC;gBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,aAAa,EAAE,MAAM,CAAC,YAAY;aACnC;SACF,CAAC,CACH,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,CAAC,cAAc,CACnB,SAAiC,EAAE;QAEnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAA;QACjC,IAAI,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;QACxC,IAAI,SAA6B,CAAA;QAEjC,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAA;YACpF,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,WAAW,CAAA;YAEtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YAC/C,8DAA8D;YAC9D,+DAA+D;YAC/D,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO;gBAAE,OAAM;YACrC,iEAAiE;YACjE,8DAA8D;YAC9D,iCAAiC;YACjC,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS;gBAAE,OAAM;YACpC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAA;YACtB,aAAa,GAAG,OAAO,CAAC,EAAE,CAAA;QAC5B,CAAC;IACH,CAAC;CACF;AA7DD,oCA6DC"}

package/dist/cjs/resources/webhook-endpoints.d.ts

@@ -0,0 +1,43 @@
+import type { TupayClient } from '../client.js';
+import type { ListResult, WebhookDelivery, WebhookEndpoint, WebhookEndpointWithSecret, WebhookEventType } from '../types.js';
+import { type ListParams } from '../liste.js';
+export interface CreateWebhookEndpointParams {
+    /** HTTPS et port 443 obligatoires en mode live. */
+    url: string;
+    description?: string;
+    /** Défaut `['*']` (tout recevoir). */
+    enabledEvents?: (WebhookEventType | '*')[];
+}
+export interface UpdateWebhookEndpointParams {
+    url?: string;
+    description?: string | null;
+    enabledEvents?: (WebhookEventType | '*')[];
+    status?: 'enabled' | 'disabled';
+}
+export interface ListDeliveriesParams extends ListParams {
+    status?: WebhookDelivery['status'];
+    eventType?: string;
+}
+export declare class WebhookEndpoints {
+    private readonly client;
+    constructor(client: TupayClient);
+    /**
+     * Déclare un endpoint.
+     *
+     * ⚠️ La réponse est le **seul** endroit où `secret` apparaît. Stockez-le
+     * immédiatement (variable d'environnement, coffre) : il n'est plus jamais
+     * lisible ensuite. Perdu = supprimer l'endpoint et en recréer un.
+     */
+    create(params: CreateWebhookEndpointParams): Promise<WebhookEndpointWithSecret>;
+    retrieve(id: string): Promise<WebhookEndpoint>;
+    list(params?: ListParams): Promise<ListResult<WebhookEndpoint>>;
+    update(id: string, params: UpdateWebhookEndpointParams): Promise<WebhookEndpoint>;
+    /** Désactivation logique — l'historique de livraison reste consultable. */
+    del(id: string): Promise<void>;
+    /**
+     * Historique de livraison — l'outil de débogage n°1 d'une intégration.
+     * Filtrez sur `status: 'failed'` pour voir ce que votre serveur a renvoyé.
+     */
+    listDeliveries(id: string, params?: ListDeliveriesParams): Promise<ListResult<WebhookDelivery>>;
+}
+//# sourceMappingURL=webhook-endpoints.d.ts.map

package/dist/cjs/resources/webhook-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-endpoints.d.ts","sourceRoot":"","sources":["../../../src/resources/webhook-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,aAAa,CAAC,EAAE,CAAC,gBAAgB,GAAG,GAAG,CAAC,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,aAAa,CAAC,EAAE,CAAC,gBAAgB,GAAG,GAAG,CAAC,EAAE,CAAA;IAC1C,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CAChC;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;OAMG;IACG,MAAM,CACV,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,yBAAyB,CAAC;IAW/B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ9C,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAUnE,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,eAAe,CAAC;IAS3B,2EAA2E;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpC;;;OAGG;IACG,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;CAaxC"}

package/dist/cjs/resources/webhook-endpoints.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookEndpoints = void 0;
+const liste_js_1 = require("../liste.js");
+class WebhookEndpoints {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Déclare un endpoint.
+     *
+     * ⚠️ La réponse est le **seul** endroit où `secret` apparaît. Stockez-le
+     * immédiatement (variable d'environnement, coffre) : il n'est plus jamais
+     * lisible ensuite. Perdu = supprimer l'endpoint et en recréer un.
+     */
+    async create(params) {
+        const { data } = await this.client.request({
+            method: 'POST',
+            path: '/webhook-endpoints',
+            body: params,
+        });
+        return data;
+    }
+    async retrieve(id) {
+        const { data } = await this.client.request({
+            method: 'GET',
+            path: `/webhook-endpoints/${encodeURIComponent(id)}`,
+        });
+        return data;
+    }
+    async list(params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: '/webhook-endpoints',
+            query: (0, liste_js_1.parametresListe)(params),
+        }));
+    }
+    async update(id, params) {
+        const { data } = await this.client.request({
+            method: 'PATCH',
+            path: `/webhook-endpoints/${encodeURIComponent(id)}`,
+            body: params,
+        });
+        return data;
+    }
+    /** Désactivation logique — l'historique de livraison reste consultable. */
+    async del(id) {
+        await this.client.request({
+            method: 'DELETE',
+            path: `/webhook-endpoints/${encodeURIComponent(id)}`,
+        });
+    }
+    /**
+     * Historique de livraison — l'outil de débogage n°1 d'une intégration.
+     * Filtrez sur `status: 'failed'` pour voir ce que votre serveur a renvoyé.
+     */
+    async listDeliveries(id, params = {}) {
+        return (0, liste_js_1.normaliserListe)(await this.client.request({
+            method: 'GET',
+            path: `/webhook-endpoints/${encodeURIComponent(id)}/deliveries`,
+            query: {
+                ...(0, liste_js_1.parametresListe)(params),
+                status: params.status,
+                eventType: params.eventType,
+            },
+        }));
+    }
+}
+exports.WebhookEndpoints = WebhookEndpoints;
+//# sourceMappingURL=webhook-endpoints.js.map

package/dist/cjs/resources/webhook-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-endpoints.js","sourceRoot":"","sources":["../../../src/resources/webhook-endpoints.ts"],"names":[],"mappings":";;;AAQA,0CAKoB;AAsBpB,MAAa,gBAAgB;IACE;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,MAAmC;QAEnC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAEvC;YACD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,MAAM;SACb,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA4B;YACpE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,EAAE,CAAC,EAAE;SACrD,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAqB,EAAE;QAChC,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA8B;YACrD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB;YAC1B,KAAK,EAAE,IAAA,0BAAe,EAAC,MAAM,CAAC;SAC/B,CAAC,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,MAAmC;QAEnC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA4B;YACpE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,EAAE,CAAC,EAAE;YACpD,IAAI,EAAE,MAAM;SACb,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU;YACjC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,EAAE,CAAC,EAAE;SACrD,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,EAAU,EACV,SAA+B,EAAE;QAEjC,OAAO,IAAA,0BAAe,EACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA8B;YACrD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,sBAAsB,kBAAkB,CAAC,EAAE,CAAC,aAAa;YAC/D,KAAK,EAAE;gBACL,GAAG,IAAA,0BAAe,EAAC,MAAM,CAAC;gBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B;SACF,CAAC,CACH,CAAA;IACH,CAAC;CACF;AAjFD,4CAiFC"}