tupay 0.5.2

package/dist/cjs/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Objets exposés par l'API Tupay.
+ *
+ * Règle de lecture des montants : `amountXpf` est un ENTIER de francs
+ * pacifiques. Le XPF n'a pas de centimes — ne jamais diviser par 100.
+ * `amountEurCents` n'existe que pour la réconciliation bancaire.
+ */
+export type TransactionStatus = 'pending' | 'processing' | 'succeeded' | 'failed' | 'refunded';
+export interface Transaction {
+    id: string;
+    object: 'transaction';
+    amountXpf: number;
+    amountEurCents: number;
+    currency: 'XPF';
+    status: TransactionStatus;
+    paymentIntentId: string;
+    paymentLinkId: string | null;
+    livemode: boolean;
+    /**
+     * Cumul remboursé. **C'est ce champ qui fait foi**, pas `status` :
+     * un remboursement partiel laisse `status` à `succeeded`.
+     */
+    refundedAmountXpf: number;
+    refundedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PaymentLink {
+    id: string;
+    object: 'payment_link';
+    amountXpf: number;
+    currency: 'XPF';
+    description: string;
+    slug: string;
+    /** URL publique à transmettre au client. */
+    url: string;
+    returnUrl: string | null;
+    metadata: Record<string, string>;
+    active: boolean;
+    livemode: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PaymentIntent {
+    intentId: string;
+    /** Identifiant Tupay — à conserver : remboursements, webhooks, export. */
+    transactionId: string;
+    clientSecret: string | null;
+    amountXpf: number;
+    amountEurCents: number;
+    livemode: boolean;
+}
+export type RefundStatus = 'pending' | 'succeeded' | 'failed';
+export interface Refund {
+    id: string;
+    object: 'refund';
+    transactionId: string;
+    amountXpf: number;
+    currency: 'XPF';
+    status: RefundStatus;
+    reason: string | null;
+    livemode: boolean;
+    createdAt: string;
+}
+export type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.processing' | 'payment.refunded';
+export interface WebhookEndpoint {
+    id: string;
+    object: 'webhook_endpoint';
+    url: string;
+    description: string | null;
+    enabledEvents: (WebhookEventType | '*')[];
+    status: 'enabled' | 'disabled';
+    livemode: boolean;
+    createdAt: string;
+    updatedAt: string;
+    disabledAt: string | null;
+}
+/** Seule la création renvoie `secret` — il n'est plus jamais lisible ensuite. */
+export interface WebhookEndpointWithSecret extends WebhookEndpoint {
+    secret: string;
+}
+export interface WebhookDelivery {
+    id: string;
+    object: 'webhook_delivery';
+    eventId: string;
+    eventType: string;
+    status: 'pending' | 'succeeded' | 'failed' | 'exhausted';
+    attempts: number;
+    responseStatus: number | null;
+    responseBody: string | null;
+    lastError: string | null;
+    nextRetryAt: string | null;
+    deliveredAt: string | null;
+    createdAt: string;
+}
+export interface Merchant {
+    id: string;
+    object: 'merchant';
+    email: string;
+    name: string;
+    /** Doit valoir `validated` pour encaisser en mode live. */
+    kyb_status: 'pending' | 'validated' | 'rejected';
+    iban_xpf: string | null;
+    tgc_rate: 'exempt' | '5' | '10' | '16';
+    livemode: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** Enveloppe reçue sur un endpoint de webhook. */
+export interface WebhookEvent {
+    /** Dédupliquez sur cet identifiant : une livraison peut se répéter. */
+    id: string;
+    object: 'event';
+    type: WebhookEventType;
+    apiVersion: string;
+    /** Horodatage Unix en secondes. */
+    created: number;
+    livemode: boolean;
+    data: {
+        object: Transaction;
+    };
+}
+/**
+ * Événement tel que l'API le RESTITUE (`tupay.events.list/retrieve`).
+ *
+ * ⚠️ À ne pas confondre avec `WebhookEvent`, l'enveloppe REÇUE sur votre
+ * endpoint. Les deux décrivent le même fait, mais l'enveloppe porte en
+ * plus `apiVersion` — elle est construite au moment de la livraison,
+ * pour la version de l'endpoint destinataire. Un même événement peut
+ * donc être livré sous deux formes à deux endpoints.
+ */
+export interface TupayEvent {
+    id: string;
+    object: 'event';
+    type: WebhookEventType;
+    /** Horodatage Unix en secondes. */
+    created: number;
+    livemode: boolean;
+    data: {
+        object: Transaction;
+    };
+}
+/** Retour de `tupay.events.resend`. */
+export interface ResendResult {
+    object: 'event_resend';
+    eventId: string;
+    /** Nombre de livraisons créées — une par endpoint actif. */
+    deliveries: number;
+}
+/**
+ * Une page de collection.
+ *
+ * Les deux clés portent la MÊME valeur, quelle que soit celle rendue par
+ * l'API : `normaliserListe` (`src/liste.ts`) lit `has_more` avec repli
+ * sur `hasMore` et remplit les deux. Un SDK neuf parle donc à une API
+ * ancienne, et un SDK ancien à une API neuve.
+ */
+export interface ListResult<T> {
+    data: T[];
+    /** Vrai s'il reste au moins un élément dans le sens du parcours. */
+    has_more: boolean;
+    /** @deprecated Doublon de `has_more`, de même valeur. Lisez `has_more`. */
+    hasMore: boolean;
+}
+export type { ListParams } from './liste.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Objets exposés par l'API Tupay.
+ *
+ * Règle de lecture des montants : `amountXpf` est un ENTIER de francs
+ * pacifiques. Le XPF n'a pas de centimes — ne jamais diviser par 100.
+ * `amountEurCents` n'existe que pour la réconciliation bancaire.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/cjs/webhooks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Vérification des webhooks entrants (Tupay → votre serveur).
+ *
+ * ⚠️ Le point qui casse le plus souvent : il faut passer le corps **brut**
+ * de la requête, pas un objet déjà parsé puis re-sérialisé. Le HMAC porte
+ * sur les octets exacts qu'on a envoyés ; un espace d'écart le casse.
+ *
+ *   Express  → app.post('/hook', express.raw({ type: 'application/json' }), …)
+ *   Next.js  → const raw = await request.text()
+ *   Fastify  → config: { rawBody: true }
+ */
+import type { WebhookEvent } from './types.js';
+/** Écart maximum toléré entre l'horodatage signé et l'heure locale. */
+export declare const DEFAULT_TOLERANCE_SECONDS = 300;
+export interface ConstructEventOptions {
+    /** Défaut 300 s. Mettre 0 désactive le contrôle (déconseillé). */
+    toleranceSeconds?: number;
+    /** Injectable pour les tests. */
+    nowSeconds?: number;
+}
+/**
+ * Vérifie la signature et renvoie l'événement typé.
+ *
+ * @param payload corps BRUT de la requête (string ou Buffer)
+ * @param header  valeur de l'en-tête `Tupay-Signature`
+ * @param secret  secret de l'endpoint (`whsec_…`)
+ * @throws {TupaySignatureVerificationError} si la signature ou l'horodatage
+ *         est invalide — répondez alors 400 sans traiter l'événement.
+ */
+export declare function constructEvent(payload: string | Buffer, header: string | null | undefined, secret: string, options?: ConstructEventOptions): WebhookEvent;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/cjs/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,YAAY,CAiDd"}

package/dist/cjs/webhooks.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Vérification des webhooks entrants (Tupay → votre serveur).
+ *
+ * ⚠️ Le point qui casse le plus souvent : il faut passer le corps **brut**
+ * de la requête, pas un objet déjà parsé puis re-sérialisé. Le HMAC porte
+ * sur les octets exacts qu'on a envoyés ; un espace d'écart le casse.
+ *
+ *   Express  → app.post('/hook', express.raw({ type: 'application/json' }), …)
+ *   Next.js  → const raw = await request.text()
+ *   Fastify  → config: { rawBody: true }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOLERANCE_SECONDS = void 0;
+exports.constructEvent = constructEvent;
+const node_crypto_1 = require("node:crypto");
+const errors_js_1 = require("./errors.js");
+/** Écart maximum toléré entre l'horodatage signé et l'heure locale. */
+exports.DEFAULT_TOLERANCE_SECONDS = 300;
+function parseHeader(header) {
+    let timestamp = null;
+    let v1 = null;
+    for (const part of header.split(',')) {
+        const separator = part.indexOf('=');
+        if (separator === -1)
+            continue;
+        const key = part.slice(0, separator).trim();
+        const value = part.slice(separator + 1).trim();
+        if (key === 't') {
+            const parsed = Number.parseInt(value, 10);
+            if (Number.isFinite(parsed))
+                timestamp = parsed;
+        }
+        else if (key === 'v1') {
+            v1 = value;
+        }
+    }
+    return timestamp === null || v1 === null ? null : { timestamp, v1 };
+}
+/**
+ * Vérifie la signature et renvoie l'événement typé.
+ *
+ * @param payload corps BRUT de la requête (string ou Buffer)
+ * @param header  valeur de l'en-tête `Tupay-Signature`
+ * @param secret  secret de l'endpoint (`whsec_…`)
+ * @throws {TupaySignatureVerificationError} si la signature ou l'horodatage
+ *         est invalide — répondez alors 400 sans traiter l'événement.
+ */
+function constructEvent(payload, header, secret, options = {}) {
+    if (!secret) {
+        throw new errors_js_1.TupaySignatureVerificationError('Secret de webhook manquant. Récupérez-le à la création de l’endpoint (whsec_…).');
+    }
+    if (!header) {
+        throw new errors_js_1.TupaySignatureVerificationError('En-tête Tupay-Signature absent de la requête.');
+    }
+    const parts = parseHeader(header);
+    if (!parts) {
+        throw new errors_js_1.TupaySignatureVerificationError('En-tête Tupay-Signature malformé — format attendu : t=<unix>,v1=<hex>.');
+    }
+    const tolerance = options.toleranceSeconds ?? exports.DEFAULT_TOLERANCE_SECONDS;
+    const now = options.nowSeconds ?? Math.floor(Date.now() / 1000);
+    if (tolerance > 0 && Math.abs(now - parts.timestamp) > tolerance) {
+        throw new errors_js_1.TupaySignatureVerificationError(`Horodatage hors tolérance (${tolerance} s) — possible rejeu d’une livraison capturée.`);
+    }
+    const raw = typeof payload === 'string' ? payload : payload.toString('utf8');
+    const expected = (0, node_crypto_1.createHmac)('sha256', secret)
+        .update(`${parts.timestamp}.${raw}`, 'utf8')
+        .digest('hex');
+    // Longueurs comparées d'abord : timingSafeEqual lève si elles diffèrent.
+    if (expected.length !== parts.v1.length ||
+        !(0, node_crypto_1.timingSafeEqual)(Buffer.from(expected, 'utf8'), Buffer.from(parts.v1, 'utf8'))) {
+        throw new errors_js_1.TupaySignatureVerificationError('Signature invalide — la charge utile ne correspond pas au secret de cet endpoint.');
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new errors_js_1.TupaySignatureVerificationError('Signature valide mais corps illisible : le JSON est malformé.');
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/cjs/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"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"}

package/dist/esm/client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Cœur HTTP du SDK : authentification, idempotence, reprises, erreurs.
+ *
+ * Aucune dépendance runtime — `fetch` global (Node 18+) et `node:crypto`.
+ */
+export interface TupayOptions {
+    /** Défaut : l’hôte de production Tupay. Surchargez pour pointer un environnement local. */
+    baseUrl?: string;
+    /** Timeout par tentative, en millisecondes. Défaut 20 000. */
+    timeout?: number;
+    /** Nombre de reprises après la tentative initiale. Défaut 2. */
+    maxRetries?: number;
+    /** En-têtes ajoutés à chaque requête (traçage, proxy d'entreprise…). */
+    headers?: Record<string, string>;
+    /**
+     * Version d'API à demander, au format `AAAA-MM-JJ`.
+     *
+     * Facultative : sans elle, la version figée à la création de la clé
+     * s'applique, et les formes de réponse restent stables dans le temps.
+     * La préciser sert à coder explicitement contre une version donnée —
+     * une valeur inconnue est refusée par un `400`, jamais silencieusement
+     * ignorée.
+     */
+    apiVersion?: string;
+    /** Injectable pour les tests. Défaut : `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    /**
+     * Clé d'idempotence. Sa présence rend la requête rejouable en toute
+     * sécurité : c'est elle qui autorise le SDK à retenter un POST.
+     */
+    idempotencyKey?: string;
+}
+export declare class TupayClient {
+    #private;
+    /** `true` si la clé est une `tpk_live_`. Déduit du préfixe, sans appel réseau. */
+    readonly livemode: boolean;
+    constructor(apiKey: string, options?: TupayOptions);
+    /** Génère une clé d'idempotence. Exposé pour que l'appelant puisse la réutiliser. */
+    static idempotencyKey(): string;
+    request<T>(options: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAsBD,qBAAa,WAAW;;IAQtB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;gBAEd,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;IAkCtD,qFAAqF;IACrF,MAAM,CAAC,cAAc,IAAI,MAAM;IAIzB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAmHtD"}

package/dist/esm/client.js

@@ -0,0 +1,161 @@
+/**
+ * Cœur HTTP du SDK : authentification, idempotence, reprises, erreurs.
+ *
+ * Aucune dépendance runtime — `fetch` global (Node 18+) et `node:crypto`.
+ */
+import { randomUUID } from 'node:crypto';
+import { errorFromResponse, TupayConnectionError, TupayError } from './errors.js';
+/**
+ * Hôte de production.
+ *
+ * ⚠️ `api.tupay.pf` ne résout pas — le domaine n'est pas enregistré. Un
+ * SDK publié avec cette valeur échouerait en erreur DNS au tout premier
+ * appel, ce qui est la pire première impression possible. On pointe donc
+ * l'hôte qui répond réellement aujourd'hui.
+ *
+ * Le jour où `api.tupay.pf` existe, changer cette constante est un
+ * changement de comportement pour quiconque s'est reposé sur le défaut :
+ * il devra donc sortir en version MAJEURE, avec les deux hôtes servis en
+ * parallèle le temps de la transition.
+ */
+const DEFAULT_BASE_URL = 'https://tupay.apps.lepetittahitien.dev';
+const DEFAULT_TIMEOUT_MS = 20_000;
+const DEFAULT_MAX_RETRIES = 2;
+/** Statuts qui méritent une reprise : surcharge passagère ou incident serveur. */
+const RETRYABLE_STATUSES = new Set([429, 500, 502, 503, 504]);
+export class TupayClient {
+    #apiKey;
+    #baseUrl;
+    #timeout;
+    #maxRetries;
+    #headers;
+    #fetch;
+    /** `true` si la clé est une `tpk_live_`. Déduit du préfixe, sans appel réseau. */
+    livemode;
+    constructor(apiKey, options = {}) {
+        if (!apiKey) {
+            throw new TupayError('Clé API manquante. Passez-la au constructeur : new Tupay(process.env.TUPAY_SECRET_KEY).', { code: 'missing_api_key' });
+        }
+        if (!apiKey.startsWith('tpk_live_') && !apiKey.startsWith('tpk_test_')) {
+            throw new TupayError('Clé API invalide : elle doit commencer par tpk_live_ ou tpk_test_.', { code: 'invalid_api_key' });
+        }
+        const fetchImpl = options.fetch ?? globalThis.fetch;
+        if (typeof fetchImpl !== 'function') {
+            throw new TupayError('fetch global introuvable. Node 18+ est requis, ou passez une implémentation via l’option `fetch`.', { code: 'fetch_unavailable' });
+        }
+        this.#apiKey = apiKey;
+        this.#baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.#timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
+        this.#maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.#headers = {
+            ...(options.apiVersion ? { 'tupay-version': options.apiVersion } : {}),
+            ...(options.headers ?? {}),
+        };
+        this.#fetch = fetchImpl;
+        this.livemode = apiKey.startsWith('tpk_live_');
+    }
+    /** Génère une clé d'idempotence. Exposé pour que l'appelant puisse la réutiliser. */
+    static idempotencyKey() {
+        return randomUUID();
+    }
+    async request(options) {
+        const url = this.#buildUrl(options.path, options.query);
+        const headers = {
+            authorization: `Bearer ${this.#apiKey}`,
+            accept: 'application/json',
+            'user-agent': 'tupay-node',
+            ...this.#headers,
+        };
+        if (options.body !== undefined) {
+            headers['content-type'] = 'application/json';
+        }
+        if (options.idempotencyKey) {
+            headers['idempotency-key'] = options.idempotencyKey;
+        }
+        // Une requête n'est rejouable que si elle est sûre à répéter :
+        // lecture pure, ou écriture protégée par une clé d'idempotence.
+        // Sans ça, une reprise sur timeout créerait un doublon.
+        const retryable = options.method === 'GET' || options.idempotencyKey !== undefined;
+        const attempts = retryable ? this.#maxRetries + 1 : 1;
+        let lastError;
+        for (let attempt = 1; attempt <= attempts; attempt++) {
+            try {
+                const response = await this.#fetch(url, {
+                    method: options.method,
+                    headers,
+                    body: options.body === undefined ? undefined : JSON.stringify(options.body),
+                    signal: AbortSignal.timeout(this.#timeout),
+                });
+                const requestId = response.headers.get('x-request-id') ?? undefined;
+                if (response.ok) {
+                    if (response.status === 204)
+                        return undefined;
+                    const text = await response.text();
+                    if (!text)
+                        return undefined;
+                    return JSON.parse(text);
+                }
+                const body = await this.#safeJson(response);
+                const error = errorFromResponse(response.status, body, requestId);
+                if (attempt < attempts && RETRYABLE_STATUSES.has(response.status)) {
+                    lastError = error;
+                    await this.#sleep(this.#backoffMs(attempt, response));
+                    continue;
+                }
+                throw error;
+            }
+            catch (err) {
+                // Erreur API déjà typée : la logique de reprise a été appliquée
+                // dans le `try` (on n'arrive ici qu'une fois les essais épuisés,
+                // ou sur un statut non rejouable).
+                if (err instanceof TupayError)
+                    throw err;
+                // Panne réseau, DNS, TLS ou timeout — aucune réponse reçue.
+                const connectionError = new TupayConnectionError(err instanceof Error && err.name === 'TimeoutError'
+                    ? `La requête a dépassé le délai de ${this.#timeout} ms.`
+                    : `Impossible de joindre l'API Tupay : ${err instanceof Error ? err.message : String(err)}`, err);
+                if (attempt >= attempts)
+                    throw connectionError;
+                lastError = connectionError;
+                await this.#sleep(this.#backoffMs(attempt));
+            }
+        }
+        throw lastError ?? new TupayError('Requête échouée.', { code: 'server_error' });
+    }
+    #buildUrl(path, query) {
+        const url = new URL(`${this.#baseUrl}/api/v1${path}`);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        return url.toString();
+    }
+    /**
+     * Backoff exponentiel avec gigue, pour ne pas faire repartir tous les
+     * clients en même temps après un incident. Respecte `Retry-After`
+     * quand le serveur l'envoie.
+     */
+    #backoffMs(attempt, response) {
+        const retryAfter = response?.headers.get('retry-after');
+        if (retryAfter) {
+            const seconds = Number.parseInt(retryAfter, 10);
+            if (Number.isFinite(seconds) && seconds >= 0) {
+                return Math.min(seconds * 1000, 20_000);
+            }
+        }
+        const base = Math.min(500 * 2 ** (attempt - 1), 8_000);
+        return base + Math.random() * 250;
+    }
+    async #safeJson(response) {
+        try {
+            return (await response.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    #sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Hiérarchie d'erreurs du SDK.
+ *
+ * Toutes héritent de `TupayError` : un `catch (err)` unique suffit, et
+ * `err instanceof TupayRateLimitError` permet d'affiner si besoin.
+ *
+ * `code` est le code machine renvoyé par l'API (`validation_error`,
+ * `livemode_mismatch`, …). C'est lui qu'il faut tester — le `message`
+ * est en français, destiné à un humain, et peut changer sans préavis.
+ */
+export interface TupayErrorOptions {
+    code: string;
+    statusCode?: number;
+    requestId?: string;
+    cause?: unknown;
+}
+export declare class TupayError extends Error {
+    /** Code machine stable renvoyé par l'API. */
+    readonly code: string;
+    /** Statut HTTP, absent si l'erreur est survenue avant toute réponse. */
+    readonly statusCode?: number;
+    /** Identifiant de requête, à citer au support. */
+    readonly requestId?: string;
+    constructor(message: string, options: TupayErrorOptions);
+}
+/** 401 — clé absente, invalide ou révoquée. */
+export declare class TupayAuthenticationError extends TupayError {
+}
+/** 403 — opération interdite dans ce contexte (dont `livemode_mismatch`). */
+export declare class TupayPermissionError extends TupayError {
+}
+/** 404 — ressource inexistante ou hors du périmètre de la clé. */
+export declare class TupayNotFoundError extends TupayError {
+}
+/** 400 / 422 — corps de requête invalide. */
+export declare class TupayValidationError extends TupayError {
+}
+/** 409 — état incompatible (déjà remboursé, limite atteinte). */
+export declare class TupayConflictError extends TupayError {
+}
+/** 429 — 100 req/min par marchand dépassées. */
+export declare class TupayRateLimitError extends TupayError {
+}
+/** 5xx — incident côté Tupay. */
+export declare class TupayApiError extends TupayError {
+}
+/** 502 — le prestataire bancaire a refusé l'opération. */
+export declare class TupayBaasError extends TupayError {
+}
+/** Panne réseau, DNS, TLS ou dépassement du timeout. Aucune réponse reçue. */
+export declare class TupayConnectionError extends TupayError {
+    constructor(message: string, cause?: unknown);
+}
+/** La signature d'un webhook n'a pas pu être vérifiée. */
+export declare class TupaySignatureVerificationError extends TupayError {
+    constructor(message: string);
+}
+/**
+ * Construit l'erreur typée correspondant à une réponse HTTP.
+ * Le mapping suit le catalogue documenté dans `docs/api-integration.md`.
+ */
+export declare function errorFromResponse(status: number, body: {
+    error?: string;
+    message?: string;
+} | null, requestId?: string): TupayError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;CAOxD;AAED,+CAA+C;AAC/C,qBAAa,wBAAyB,SAAQ,UAAU;CAAG;AAE3D,6EAA6E;AAC7E,qBAAa,oBAAqB,SAAQ,UAAU;CAAG;AAEvD,kEAAkE;AAClE,qBAAa,kBAAmB,SAAQ,UAAU;CAAG;AAErD,6CAA6C;AAC7C,qBAAa,oBAAqB,SAAQ,UAAU;CAAG;AAEvD,iEAAiE;AACjE,qBAAa,kBAAmB,SAAQ,UAAU;CAAG;AAErD,gDAAgD;AAChD,qBAAa,mBAAoB,SAAQ,UAAU;CAAG;AAEtD,iCAAiC;AACjC,qBAAa,aAAc,SAAQ,UAAU;CAAG;AAEhD,0DAA0D;AAC1D,qBAAa,cAAe,SAAQ,UAAU;CAAG;AAEjD,8EAA8E;AAC9E,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,0DAA0D;AAC1D,qBAAa,+BAAgC,SAAQ,UAAU;gBACjD,OAAO,EAAE,MAAM;CAG5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACjD,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU,CAwBZ"}