@mostajs/payment 0.4.2 → 0.5.0

package/dist/lib/webhook-helpers.d.ts

@@ -0,0 +1,62 @@
+import type { PaymentProvider, WebhookEvent } from '../core/provider.interface.js';
+export type ProviderName = 'chargily' | 'stripe' | 'satim' | 'paypal' | 'manual';
+/**
+ * Sélectionne le header signature attendu pour chaque provider.
+ * Headers normalisés en lowercase (Headers.get est case-insensitive).
+ */
+export declare function pickSignatureHeader(headers: Headers | Record<string, string>, providerName: ProviderName): string;
+/**
+ * Instancie un PaymentProvider à partir de son nom (lit env via le constructor).
+ * Utile pour le webhook handler qui n'a pas besoin de connaître la config.
+ */
+export declare function getProviderByName(name: ProviderName): PaymentProvider;
+export interface HandleProviderWebhookArgs {
+    /** Body brut de la requête (req.text() avant parse). Crucial : signature
+     *  computed sur les bytes exacts envoyés par le provider. */
+    body: string;
+    /** Headers de la requête HTTP. */
+    headers: Headers | Record<string, string>;
+    /** Nom du provider. */
+    providerName: ProviderName;
+}
+export type HandleProviderWebhookResult = {
+    ok: true;
+    event: WebhookEvent;
+} | {
+    ok: false;
+    reason: 'bad_signature' | 'malformed' | 'unknown_provider';
+    error: string;
+};
+/**
+ * Vérifie le webhook reçu d'un provider de paiement et retourne l'event
+ * normalisé. La logique métier (créer une Subscription, marquer une
+ * Registration, etc.) reste à la charge du caller.
+ *
+ * @example
+ *   const r = await handleProviderWebhook({
+ *     body: await req.text(),
+ *     headers: req.headers,
+ *     providerName: 'chargily',
+ *   })
+ *   if (!r.ok) return NextResponse.json({ error: r.error }, { status: 400 })
+ *   if (isPaidEvent(r.event)) {
+ *     // ... mettre à jour DB métier ...
+ *   }
+ */
+export declare function handleProviderWebhook(args: HandleProviderWebhookArgs): Promise<HandleProviderWebhookResult>;
+/**
+ * Vrai si l'event indique un paiement réussi, peu importe le provider.
+ * Couvre les variantes de naming entre Chargily / Stripe / Satim / PayPal.
+ */
+export declare function isPaidEvent(event: WebhookEvent): boolean;
+/** Vrai si l'event indique un échec ou une annulation de paiement. */
+export declare function isFailedEvent(event: WebhookEvent): boolean;
+/** Vrai si l'event indique un remboursement. */
+export declare function isRefundedEvent(event: WebhookEvent): boolean;
+/**
+ * Extrait l'`orderId` (= clef de matching côté app, ex: registrationId)
+ * depuis le payload event, peu importe le provider. Cherche dans plusieurs
+ * positions usuelles.
+ */
+export declare function extractOrderId(event: WebhookEvent): string | null;
+//# sourceMappingURL=webhook-helpers.d.ts.map

package/dist/lib/webhook-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/webhook-helpers.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAElF,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAsBjH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAQrE;AAED,MAAM,WAAW,yBAAyB;IACxC;iEAC6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC,uBAAuB;IACvB,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5F;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAgBjH;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAOxD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAS1D;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAK5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CASjE"}

package/dist/lib/webhook-helpers.js

@@ -0,0 +1,135 @@
+// @mostajs/payment — Webhook helpers (provider-agnostic) — v0.5.0+
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Mutualise le code de vérification signature + normalisation event
+// type entre les apps consumers (octonet-cloud, iquesta, etc.).
+// Chaque app garde sa logique métier (Subscription / Registration / …)
+// dans son route handler, mais la vérif HMAC et le mapping
+// event-type sont centralisés ici.
+import { createChargilyProvider } from '../providers/chargily.provider.js';
+import { createStripeProvider } from '../providers/stripe.provider.js';
+import { createSatimProvider } from '../providers/satim.provider.js';
+import { createPayPalProvider } from '../providers/paypal.provider.js';
+import { createManualProvider } from '../providers/manual.provider.js';
+/**
+ * Sélectionne le header signature attendu pour chaque provider.
+ * Headers normalisés en lowercase (Headers.get est case-insensitive).
+ */
+export function pickSignatureHeader(headers, providerName) {
+    const get = (key) => {
+        if (headers instanceof Headers)
+            return headers.get(key) ?? '';
+        return headers[key] ?? headers[key.toLowerCase()] ?? '';
+    };
+    switch (providerName) {
+        case 'chargily':
+            // Chargily envoie `signature` (header officiel docs) ;
+            // certains proxies passent `chargily-signature` (legacy).
+            return get('chargily-signature') || get('signature') || '';
+        case 'stripe':
+            return get('stripe-signature') || '';
+        case 'satim':
+            return get('x-satim-signature') || get('signature') || '';
+        case 'paypal':
+            // PayPal utilise plusieurs headers ; le caller doit traiter à part.
+            return get('paypal-transmission-sig') || '';
+        case 'manual':
+            return get('x-signature') || '';
+        default:
+            return '';
+    }
+}
+/**
+ * Instancie un PaymentProvider à partir de son nom (lit env via le constructor).
+ * Utile pour le webhook handler qui n'a pas besoin de connaître la config.
+ */
+export function getProviderByName(name) {
+    switch (name) {
+        case 'chargily': return createChargilyProvider();
+        case 'stripe': return createStripeProvider();
+        case 'satim': return createSatimProvider();
+        case 'paypal': return createPayPalProvider();
+        case 'manual': return createManualProvider();
+    }
+}
+/**
+ * Vérifie le webhook reçu d'un provider de paiement et retourne l'event
+ * normalisé. La logique métier (créer une Subscription, marquer une
+ * Registration, etc.) reste à la charge du caller.
+ *
+ * @example
+ *   const r = await handleProviderWebhook({
+ *     body: await req.text(),
+ *     headers: req.headers,
+ *     providerName: 'chargily',
+ *   })
+ *   if (!r.ok) return NextResponse.json({ error: r.error }, { status: 400 })
+ *   if (isPaidEvent(r.event)) {
+ *     // ... mettre à jour DB métier ...
+ *   }
+ */
+export async function handleProviderWebhook(args) {
+    let provider;
+    try {
+        provider = getProviderByName(args.providerName);
+    }
+    catch (e) {
+        return { ok: false, reason: 'unknown_provider', error: e?.message ?? String(e) };
+    }
+    const signature = pickSignatureHeader(args.headers, args.providerName);
+    try {
+        const event = await provider.verifyWebhook(args.body, signature);
+        return { ok: true, event };
+    }
+    catch (e) {
+        const msg = String(e?.message ?? e);
+        if (/signature/i.test(msg))
+            return { ok: false, reason: 'bad_signature', error: msg };
+        return { ok: false, reason: 'malformed', error: msg };
+    }
+}
+// ─── Event type normalization ─────────────────────────────────────────
+/**
+ * Vrai si l'event indique un paiement réussi, peu importe le provider.
+ * Couvre les variantes de naming entre Chargily / Stripe / Satim / PayPal.
+ */
+export function isPaidEvent(event) {
+    const t = String(event?.type ?? '');
+    return t === 'payment.success' // Chargily, Satim
+        || t === 'checkout.paid' // legacy alias
+        || t === 'checkout.session.completed' // Stripe Checkout
+        || t === 'payment_intent.succeeded' // Stripe PaymentIntent
+        || t === 'PAYMENT.CAPTURE.COMPLETED'; // PayPal
+}
+/** Vrai si l'event indique un échec ou une annulation de paiement. */
+export function isFailedEvent(event) {
+    const t = String(event?.type ?? '');
+    return t === 'payment.failed'
+        || t === 'payment.canceled'
+        || t === 'checkout.failed'
+        || t === 'checkout.session.expired'
+        || t === 'payment_intent.payment_failed'
+        || t === 'PAYMENT.CAPTURE.DENIED'
+        || t === 'PAYMENT.CAPTURE.REFUNDED';
+}
+/** Vrai si l'event indique un remboursement. */
+export function isRefundedEvent(event) {
+    const t = String(event?.type ?? '');
+    return t === 'payment.refunded'
+        || t === 'charge.refunded'
+        || t === 'PAYMENT.CAPTURE.REFUNDED';
+}
+/**
+ * Extrait l'`orderId` (= clef de matching côté app, ex: registrationId)
+ * depuis le payload event, peu importe le provider. Cherche dans plusieurs
+ * positions usuelles.
+ */
+export function extractOrderId(event) {
+    const data = event?.data ?? {};
+    return String(data?.metadata?.orderId
+        ?? data?.metadata?.registrationId
+        ?? data?.orderId
+        ?? data?.client_reference_id
+        ?? '') || null;
+}
+//# sourceMappingURL=webhook-helpers.js.map

package/dist/lib/webhook-helpers.js.map

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

package/dist/server.d.ts

@@ -15,6 +15,8 @@ export type { WebhookHandlers } from './lib/stripe.js';
 export { getPaymentRepo, resetPaymentRepo } from './lib/payment-factory.js';
 export { createCheckoutHandler } from './api/checkout.route.js';
 export { createPaymentHandlers } from './api/payments.route.js';
+export { handleProviderWebhook, pickSignatureHeader, getProviderByName, isPaidEvent, isFailedEvent, isRefundedEvent, extractOrderId, } from './lib/webhook-helpers.js';
+export type { ProviderName, HandleProviderWebhookArgs, HandleProviderWebhookResult, } from './lib/webhook-helpers.js';
 export { getSchemas, moduleInfo } from './lib/module-info.js';
 export { paymentModuleRegistration } from './register.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAC/D,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAClE,aAAa,EAAE,YAAY,GAC5B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EACjD,aAAa,EAAE,sBAAsB,EAAE,cAAc,GACtD,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAC3F,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAElE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAElE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAGlE,OAAO,EACL,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EACxD,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,GAChE,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAG3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAC/D,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAClE,aAAa,EAAE,YAAY,GAC5B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EACjD,aAAa,EAAE,sBAAsB,EAAE,cAAc,GACtD,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAC3F,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAElE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAElE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAGlE,OAAO,EACL,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EACxD,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,GAChE,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAG3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAG/D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA"}

package/dist/server.js

@@ -14,6 +14,8 @@ export { getPaymentRepo, resetPaymentRepo } from './lib/payment-factory.js';
 // ─── API handlers ───────────────────────────────
 export { createCheckoutHandler } from './api/checkout.route.js';
 export { createPaymentHandlers } from './api/payments.route.js';
+// ─── Webhook helpers (provider-agnostic) — v0.5.0+ ───
+export { handleProviderWebhook, pickSignatureHeader, getProviderByName, isPaidEvent, isFailedEvent, isRefundedEvent, extractOrderId, } from './lib/webhook-helpers.js';
 // ─── Module info ────────────────────────────────
 export { getSchemas, moduleInfo } from './lib/module-info.js';
 export { paymentModuleRegistration } from './register.js';

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,wCAAwC;AASxC,OAAO,EACL,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EACjD,aAAa,EAAE,sBAAsB,EAAE,cAAc,GACtD,MAAM,0BAA0B,CAAA;AAEjC,mDAAmD;AACnD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAGlF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAG3F,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrF,kDAAkD;AAClD,OAAO,EACL,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EACxD,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,GAChE,MAAM,iBAAiB,CAAA;AAGxB,mDAAmD;AACnD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3E,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,wCAAwC;AASxC,OAAO,EACL,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EACjD,aAAa,EAAE,sBAAsB,EAAE,cAAc,GACtD,MAAM,0BAA0B,CAAA;AAEjC,mDAAmD;AACnD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAGlF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAG3F,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrF,kDAAkD;AAClD,OAAO,EACL,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EACxD,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,GAChE,MAAM,iBAAiB,CAAA;AAGxB,mDAAmD;AACnD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3E,mDAAmD;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,wDAAwD;AACxD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,0BAA0B,CAAA;AAOjC,mDAAmD;AACnD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/payment",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Payment module for @mostajs — Multi-provider (Stripe, Satim/CIB, Chargily, PayPal), multi-method, multi-currency",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",