@ambushsoftworks/nestjs-payments-graphql 0.1.0

package/dist/dto/upsert-payment-provider.input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-payment-provider.input.js","sourceRoot":"","sources":["../../src/dto/upsert-payment-provider.input.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6CAAmD;AACnD,0EAA4C;AAC5C,qDAMyB;AAGlB,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;CAetC,CAAA;AAfY,gEAA0B;AAKrC;IAJC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;;gEACO;AAKrB;IAHC,IAAA,eAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;4DACO;AAInB;IAFC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,2BAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAA,4BAAU,GAAE;;0DACoB;qCAdtB,0BAA0B;IADtC,IAAA,mBAAS,GAAE;GACC,0BAA0B,CAetC"}

package/dist/dto/validators/is-metadata.d.ts

@@ -0,0 +1 @@
+export declare function IsMetadata(): PropertyDecorator;

package/dist/dto/validators/is-metadata.js

@@ -0,0 +1,41 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsMetadata = IsMetadata;
+const class_validator_1 = require("class-validator");
+const MAX_KEYS = 20;
+const MAX_KEY_LENGTH = 200;
+const MAX_VALUE_LENGTH = 2000;
+let IsMetadataConstraint = class IsMetadataConstraint {
+    validate(value) {
+        if (value === null || value === undefined)
+            return true;
+        if (typeof value !== 'object' || Array.isArray(value))
+            return false;
+        const entries = Object.entries(value);
+        if (entries.length > MAX_KEYS)
+            return false;
+        for (const [key, val] of entries) {
+            if (typeof key !== 'string' || key.length > MAX_KEY_LENGTH)
+                return false;
+            if (typeof val !== 'string' || val.length > MAX_VALUE_LENGTH)
+                return false;
+        }
+        return true;
+    }
+    defaultMessage() {
+        return `Metadata must be a flat object with string values (max ${MAX_KEYS} keys, key length <= ${MAX_KEY_LENGTH}, value length <= ${MAX_VALUE_LENGTH})`;
+    }
+};
+IsMetadataConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isMetadata', async: false })
+], IsMetadataConstraint);
+function IsMetadata() {
+    return (0, class_validator_1.Validate)(IsMetadataConstraint);
+}
+//# sourceMappingURL=is-metadata.js.map

package/dist/dto/validators/is-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-metadata.js","sourceRoot":"","sources":["../../../src/dto/validators/is-metadata.ts"],"names":[],"mappings":";;;;;;;;AAiCA,gCAEC;AAnCD,qDAIyB;AAEzB,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpB,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAG9B,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACxB,QAAQ,CAAC,KAAc;QACrB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,GAAG,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,cAAc;gBAAE,OAAO,KAAK,CAAC;YACzE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,gBAAgB;gBAC1D,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;QACZ,OAAO,0DAA0D,QAAQ,wBAAwB,cAAc,qBAAqB,gBAAgB,GAAG,CAAC;IAC1J,CAAC;CACF,CAAA;AApBK,oBAAoB;IADzB,IAAA,qCAAmB,EAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;GACpD,oBAAoB,CAoBzB;AAED,SAAgB,UAAU;IACxB,OAAO,IAAA,0BAAQ,EAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,34 @@
+export declare class PaymentException extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class InvalidInvoiceStateException extends PaymentException {
+    constructor(message: string);
+}
+export declare class PaymentAmountExceededException extends PaymentException {
+    constructor(message: string);
+}
+export declare class PaymentGatewayException extends PaymentException {
+    constructor(message: string);
+}
+export declare class DuplicatePaymentException extends PaymentException {
+    constructor(message: string);
+}
+export declare class InvoiceNotPayableException extends PaymentException {
+    constructor(message: string);
+}
+export declare class InvoiceNumberExhaustedException extends PaymentException {
+    constructor(message: string);
+}
+export declare class RefundNotAllowedException extends PaymentException {
+    constructor(message: string);
+}
+export declare class InvalidPaymentStateException extends PaymentException {
+    constructor(message: string);
+}
+export declare class InvalidRecurringInvoiceStateException extends PaymentException {
+    constructor(message: string);
+}
+export declare class UniqueConstraintViolationException extends PaymentException {
+    constructor(message?: string);
+}

package/dist/exceptions/index.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UniqueConstraintViolationException = exports.InvalidRecurringInvoiceStateException = exports.InvalidPaymentStateException = exports.RefundNotAllowedException = exports.InvoiceNumberExhaustedException = exports.InvoiceNotPayableException = exports.DuplicatePaymentException = exports.PaymentGatewayException = exports.PaymentAmountExceededException = exports.InvalidInvoiceStateException = exports.PaymentException = void 0;
+class PaymentException extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = this.constructor.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.PaymentException = PaymentException;
+class InvalidInvoiceStateException extends PaymentException {
+    constructor(message) {
+        super(message, 'INVALID_INVOICE_STATE');
+    }
+}
+exports.InvalidInvoiceStateException = InvalidInvoiceStateException;
+class PaymentAmountExceededException extends PaymentException {
+    constructor(message) {
+        super(message, 'PAYMENT_AMOUNT_EXCEEDED');
+    }
+}
+exports.PaymentAmountExceededException = PaymentAmountExceededException;
+class PaymentGatewayException extends PaymentException {
+    constructor(message) {
+        super(message, 'PAYMENT_GATEWAY_ERROR');
+    }
+}
+exports.PaymentGatewayException = PaymentGatewayException;
+class DuplicatePaymentException extends PaymentException {
+    constructor(message) {
+        super(message, 'DUPLICATE_PAYMENT');
+    }
+}
+exports.DuplicatePaymentException = DuplicatePaymentException;
+class InvoiceNotPayableException extends PaymentException {
+    constructor(message) {
+        super(message, 'INVOICE_NOT_PAYABLE');
+    }
+}
+exports.InvoiceNotPayableException = InvoiceNotPayableException;
+class InvoiceNumberExhaustedException extends PaymentException {
+    constructor(message) {
+        super(message, 'INVOICE_NUMBER_EXHAUSTED');
+    }
+}
+exports.InvoiceNumberExhaustedException = InvoiceNumberExhaustedException;
+class RefundNotAllowedException extends PaymentException {
+    constructor(message) {
+        super(message, 'REFUND_NOT_ALLOWED');
+    }
+}
+exports.RefundNotAllowedException = RefundNotAllowedException;
+class InvalidPaymentStateException extends PaymentException {
+    constructor(message) {
+        super(message, 'INVALID_PAYMENT_STATE');
+    }
+}
+exports.InvalidPaymentStateException = InvalidPaymentStateException;
+class InvalidRecurringInvoiceStateException extends PaymentException {
+    constructor(message) {
+        super(message, 'INVALID_RECURRING_INVOICE_STATE');
+    }
+}
+exports.InvalidRecurringInvoiceStateException = InvalidRecurringInvoiceStateException;
+class UniqueConstraintViolationException extends PaymentException {
+    constructor(message = 'Unique constraint violation') {
+        super(message, 'UNIQUE_CONSTRAINT_VIOLATION');
+    }
+}
+exports.UniqueConstraintViolationException = UniqueConstraintViolationException;
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":";;;AAQA,MAAa,gBAAiB,SAAQ,KAAK;IAGzC,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAElC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAVD,4CAUC;AAMD,MAAa,4BAA6B,SAAQ,gBAAgB;IAChE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1C,CAAC;CACF;AAJD,oEAIC;AAKD,MAAa,8BAA+B,SAAQ,gBAAgB;IAClE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAC5C,CAAC;CACF;AAJD,wEAIC;AAKD,MAAa,uBAAwB,SAAQ,gBAAgB;IAC3D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1C,CAAC;CACF;AAJD,0DAIC;AAKD,MAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IACtC,CAAC;CACF;AAJD,8DAIC;AAMD,MAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACxC,CAAC;CACF;AAJD,gEAIC;AAMD,MAAa,+BAAgC,SAAQ,gBAAgB;IACnE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,0EAIC;AAMD,MAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACvC,CAAC;CACF;AAJD,8DAIC;AAMD,MAAa,4BAA6B,SAAQ,gBAAgB;IAChE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1C,CAAC;CACF;AAJD,oEAIC;AAMD,MAAa,qCAAsC,SAAQ,gBAAgB;IACzE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC;IACpD,CAAC;CACF;AAJD,sFAIC;AASD,MAAa,kCAAmC,SAAQ,gBAAgB;IACtE,YAAY,UAAkB,6BAA6B;QACzD,KAAK,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;IAChD,CAAC;CACF;AAJD,gFAIC"}

package/dist/gateways/gateway-registry.service.d.ts

@@ -0,0 +1,10 @@
+import type { PaymentGateway } from './payment-gateway.interface';
+import type { RecurringPaymentGateway } from './recurring-payment-gateway.interface';
+export declare class GatewayRegistryService {
+    private readonly gateways;
+    register(gateway: PaymentGateway): void;
+    get(providerType: string): PaymentGateway;
+    getRecurring(providerType: string): PaymentGateway & RecurringPaymentGateway;
+    getAvailable(): string[];
+    private isRecurringCapable;
+}

package/dist/gateways/gateway-registry.service.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GatewayRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+let GatewayRegistryService = class GatewayRegistryService {
+    constructor() {
+        this.gateways = new Map();
+    }
+    register(gateway) {
+        this.gateways.set(gateway.providerType, gateway);
+    }
+    get(providerType) {
+        const gateway = this.gateways.get(providerType);
+        if (!gateway) {
+            throw new Error(`No payment gateway registered for provider type "${providerType}"`);
+        }
+        return gateway;
+    }
+    getRecurring(providerType) {
+        const gateway = this.get(providerType);
+        if (!this.isRecurringCapable(gateway)) {
+            throw new Error(`Gateway "${providerType}" does not support recurring payments`);
+        }
+        return gateway;
+    }
+    getAvailable() {
+        return Array.from(this.gateways.keys());
+    }
+    isRecurringCapable(gateway) {
+        return ('createOrRetrieveCustomer' in gateway &&
+            'createOffSessionPayment' in gateway &&
+            'createSetupSession' in gateway);
+    }
+};
+exports.GatewayRegistryService = GatewayRegistryService;
+exports.GatewayRegistryService = GatewayRegistryService = __decorate([
+    (0, common_1.Injectable)()
+], GatewayRegistryService);
+//# sourceMappingURL=gateway-registry.service.js.map

package/dist/gateways/gateway-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-registry.service.js","sourceRoot":"","sources":["../../src/gateways/gateway-registry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAYrC,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAA5B;QACY,aAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IA+ChE,CAAC;IA5CC,QAAQ,CAAC,OAAuB;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAMD,GAAG,CAAC,YAAoB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,oDAAoD,YAAY,GAAG,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAMD,YAAY,CAAC,YAAoB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,YAAY,YAAY,uCAAuC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,OAAmD,CAAC;IAC7D,CAAC;IAGD,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAEO,kBAAkB,CAAC,OAAuB;QAChD,OAAO,CACL,0BAA0B,IAAI,OAAO;YACrC,yBAAyB,IAAI,OAAO;YACpC,oBAAoB,IAAI,OAAO,CAChC,CAAC;IACJ,CAAC;CACF,CAAA;AAhDY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAgDlC"}

package/dist/gateways/payment-gateway.interface.d.ts

@@ -0,0 +1,50 @@
+export interface PaymentGateway {
+    readonly providerType: string;
+    createPaymentSession(params: {
+        invoiceId: string;
+        amount: number;
+        currency: string;
+        customerEmail?: string;
+        description?: string;
+        successUrl: string;
+        cancelUrl: string;
+        metadata?: Record<string, string>;
+        expiresAt?: Date;
+    }): Promise<{
+        checkoutUrl: string;
+        providerPaymentId: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    createRefund(params: {
+        providerPaymentId: string;
+        amount: number;
+        reason?: string;
+    }): Promise<{
+        providerRefundId: string;
+        status: 'PENDING' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED';
+    }>;
+    getPaymentStatus(providerPaymentId: string): Promise<{
+        status: 'pending' | 'processing' | 'succeeded' | 'failed' | 'cancelled';
+        amount: number;
+        currency: string;
+        receiptUrl?: string;
+    }>;
+    cancelPayment(providerPaymentId: string): Promise<{
+        success: boolean;
+    }>;
+    handleWebhook(params: {
+        headers: Record<string, string>;
+        body: Buffer;
+    }): Promise<PaymentWebhookEvent>;
+}
+export type PaymentWebhookEventType = 'payment.processing' | 'payment.succeeded' | 'payment.failed' | 'payment.cancelled' | 'refund.succeeded' | 'refund.failed' | 'setup.succeeded';
+export interface PaymentWebhookEvent {
+    type: PaymentWebhookEventType;
+    eventId: string;
+    providerPaymentId: string;
+    providerRefundId?: string;
+    amount: number;
+    currency: string;
+    receiptUrl?: string;
+    providerData: Record<string, unknown>;
+}

package/dist/gateways/payment-gateway.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-gateway.interface.js.map

package/dist/gateways/payment-gateway.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-gateway.interface.js","sourceRoot":"","sources":["../../src/gateways/payment-gateway.interface.ts"],"names":[],"mappings":""}

package/dist/gateways/recurring-payment-gateway.interface.d.ts

@@ -0,0 +1,32 @@
+export interface RecurringPaymentGateway {
+    readonly providerType: string;
+    createOrRetrieveCustomer(params: {
+        email: string;
+        name?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        providerCustomerId: string;
+    }>;
+    createOffSessionPayment(params: {
+        providerCustomerId: string;
+        amount: number;
+        currency: string;
+        description?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        providerPaymentId: string;
+        status: 'succeeded' | 'requires_action' | 'failed';
+        failureReason?: string;
+        clientSecret?: string;
+        receiptUrl?: string;
+    }>;
+    createSetupSession(params: {
+        providerCustomerId: string;
+        successUrl: string;
+        cancelUrl: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        setupUrl: string;
+        providerSetupId: string;
+    }>;
+}

package/dist/gateways/recurring-payment-gateway.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=recurring-payment-gateway.interface.js.map

package/dist/gateways/recurring-payment-gateway.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring-payment-gateway.interface.js","sourceRoot":"","sources":["../../src/gateways/recurring-payment-gateway.interface.ts"],"names":[],"mappings":""}

package/dist/gateways/stripe/stripe-webhook.controller.d.ts

@@ -0,0 +1,24 @@
+import { OnModuleInit } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import type { RawBodyRequest } from '@nestjs/common';
+import type { Request } from 'express';
+import { GatewayRegistryService } from '../gateway-registry.service';
+import { PaymentService } from '../../services/payment.service';
+import { RefundService } from '../../services/refund.service';
+export declare const PAYMENTS_WEBHOOK = "payments_webhook";
+export declare const PaymentsWebhook: () => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare class StripeWebhookController implements OnModuleInit {
+    private readonly moduleRef;
+    private readonly gatewayRegistry;
+    private readonly paymentService;
+    private readonly refundService;
+    private readonly logger;
+    private errorReporter;
+    constructor(moduleRef: ModuleRef, gatewayRegistry: GatewayRegistryService, paymentService: PaymentService, refundService: RefundService);
+    onModuleInit(): void;
+    handleStripeWebhook(req: RawBodyRequest<Request>): Promise<{
+        received: boolean;
+    }>;
+    private routeEvent;
+    private handleWithRetry;
+}

package/dist/gateways/stripe/stripe-webhook.controller.js

@@ -0,0 +1,150 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var StripeWebhookController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeWebhookController = exports.PaymentsWebhook = exports.PAYMENTS_WEBHOOK = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const gateway_registry_service_1 = require("../gateway-registry.service");
+const payment_service_1 = require("../../services/payment.service");
+const refund_service_1 = require("../../services/refund.service");
+const constants_1 = require("../../constants");
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 2000;
+exports.PAYMENTS_WEBHOOK = 'payments_webhook';
+const PaymentsWebhook = () => (0, common_1.applyDecorators)((0, common_1.SetMetadata)(exports.PAYMENTS_WEBHOOK, true), (0, common_1.SetMetadata)('isPublic', true), (0, common_1.SetMetadata)('skipTenant', true));
+exports.PaymentsWebhook = PaymentsWebhook;
+let StripeWebhookController = StripeWebhookController_1 = class StripeWebhookController {
+    constructor(moduleRef, gatewayRegistry, paymentService, refundService) {
+        this.moduleRef = moduleRef;
+        this.gatewayRegistry = gatewayRegistry;
+        this.paymentService = paymentService;
+        this.refundService = refundService;
+        this.logger = new common_1.Logger(StripeWebhookController_1.name);
+        this.errorReporter = null;
+    }
+    onModuleInit() {
+        try {
+            this.errorReporter = this.moduleRef.get(constants_1.WEBHOOK_ERROR_REPORTER, {
+                strict: false,
+            });
+        }
+        catch {
+            this.errorReporter = null;
+        }
+    }
+    async handleStripeWebhook(req) {
+        let stripeGateway;
+        try {
+            stripeGateway = this.gatewayRegistry.get('stripe');
+        }
+        catch {
+            throw new common_1.BadRequestException('Stripe gateway is not configured');
+        }
+        const rawBody = req.rawBody;
+        if (!rawBody) {
+            throw new common_1.BadRequestException('Missing raw body for webhook verification');
+        }
+        const headers = {};
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (typeof value === 'string') {
+                headers[key] = value;
+            }
+        }
+        let event;
+        try {
+            event = await stripeGateway.handleWebhook({
+                headers,
+                body: rawBody,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Stripe webhook signature verification failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            throw new common_1.BadRequestException('Webhook signature verification failed');
+        }
+        try {
+            await this.routeEvent(event);
+        }
+        catch (error) {
+            this.logger.error(`Error processing Stripe webhook event ${event.eventId} (${event.type}): ${error instanceof Error ? error.message : 'Unknown error'}`);
+            this.errorReporter?.(error, {
+                tags: {
+                    webhookEventType: event.type,
+                    webhookEventId: event.eventId,
+                    providerPaymentId: event.providerPaymentId,
+                },
+            });
+        }
+        return { received: true };
+    }
+    async routeEvent(event) {
+        switch (event.type) {
+            case 'payment.succeeded':
+                await this.handleWithRetry(() => this.paymentService.handlePaymentSucceeded(event), event);
+                break;
+            case 'payment.failed':
+                await this.paymentService.handlePaymentFailed(event);
+                break;
+            case 'payment.processing':
+                await this.paymentService.handlePaymentProcessing(event);
+                break;
+            case 'refund.succeeded':
+                await this.refundService.handleRefundSucceeded(event);
+                break;
+            case 'refund.failed':
+                await this.refundService.handleRefundFailed(event);
+                break;
+            case 'setup.succeeded':
+                this.logger.log(`Payment method setup succeeded (event ${event.eventId})`);
+                break;
+            default:
+                this.logger.warn(`Unhandled webhook event type: ${event.type}`);
+        }
+    }
+    async handleWithRetry(handler, event) {
+        for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                await handler();
+                return;
+            }
+            catch (error) {
+                if (attempt < MAX_RETRIES) {
+                    this.logger.warn(`Attempt ${attempt}/${MAX_RETRIES} failed for event ${event.eventId}: ${error instanceof Error ? error.message : 'Unknown error'}. Retrying in ${RETRY_DELAY_MS}ms...`);
+                    await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+    }
+};
+exports.StripeWebhookController = StripeWebhookController;
+__decorate([
+    (0, common_1.Post)('stripe'),
+    (0, common_1.HttpCode)(200),
+    __param(0, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], StripeWebhookController.prototype, "handleStripeWebhook", null);
+exports.StripeWebhookController = StripeWebhookController = StripeWebhookController_1 = __decorate([
+    (0, common_1.Controller)('webhooks'),
+    (0, exports.PaymentsWebhook)(),
+    __metadata("design:paramtypes", [core_1.ModuleRef,
+        gateway_registry_service_1.GatewayRegistryService,
+        payment_service_1.PaymentService,
+        refund_service_1.RefundService])
+], StripeWebhookController);
+//# sourceMappingURL=stripe-webhook.controller.js.map

package/dist/gateways/stripe/stripe-webhook.controller.js.map

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

package/dist/gateways/stripe/stripe.gateway.d.ts

@@ -0,0 +1,84 @@
+import type { PaymentGateway, PaymentWebhookEvent } from '../payment-gateway.interface';
+import type { RecurringPaymentGateway } from '../recurring-payment-gateway.interface';
+export declare class StripeGateway implements PaymentGateway, RecurringPaymentGateway {
+    readonly providerType = "stripe";
+    private readonly stripe;
+    private readonly webhookSecret;
+    private readonly logger;
+    constructor(secretKey: string, webhookSecret?: string);
+    createPaymentSession(params: {
+        invoiceId: string;
+        amount: number;
+        currency: string;
+        customerEmail?: string;
+        description?: string;
+        successUrl: string;
+        cancelUrl: string;
+        metadata?: Record<string, string>;
+        expiresAt?: Date;
+    }): Promise<{
+        checkoutUrl: string;
+        providerPaymentId: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    createRefund(params: {
+        providerPaymentId: string;
+        amount: number;
+        reason?: string;
+    }): Promise<{
+        providerRefundId: string;
+        status: 'PENDING' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED';
+    }>;
+    getPaymentStatus(providerPaymentId: string): Promise<{
+        status: 'pending' | 'processing' | 'succeeded' | 'failed' | 'cancelled';
+        amount: number;
+        currency: string;
+        receiptUrl?: string;
+        paymentIntentId?: string;
+    }>;
+    private getCheckoutSessionStatus;
+    cancelPayment(providerPaymentId: string): Promise<{
+        success: boolean;
+    }>;
+    handleWebhook(params: {
+        headers: Record<string, string>;
+        body: Buffer;
+    }): Promise<PaymentWebhookEvent>;
+    createOrRetrieveCustomer(params: {
+        email: string;
+        name?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        providerCustomerId: string;
+    }>;
+    createOffSessionPayment(params: {
+        providerCustomerId: string;
+        amount: number;
+        currency: string;
+        description?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        providerPaymentId: string;
+        status: 'succeeded' | 'requires_action' | 'failed';
+        failureReason?: string;
+        clientSecret?: string;
+        receiptUrl?: string;
+    }>;
+    createSetupSession(params: {
+        providerCustomerId: string;
+        successUrl: string;
+        cancelUrl: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        setupUrl: string;
+        providerSetupId: string;
+    }>;
+    private normalizeWebhookEvent;
+    private handleCheckoutSessionCompleted;
+    private handleSetupSessionCompleted;
+    private handlePaymentIntentProcessing;
+    private handlePaymentIntentFailed;
+    private handleChargeRefunded;
+    private mapPaymentIntentStatus;
+    private mapRefundStatus;
+}