punch-library 0.1.0

package/dist/payments/providers/square/square.gateway.js

@@ -0,0 +1,207 @@
+"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.SquareGateway = void 0;
+const common_1 = require("@nestjs/common");
+const node_crypto_1 = require("node:crypto");
+const errors_1 = require("../../domain/errors");
+const base_gateway_1 = require("../base-gateway");
+let SquareGateway = class SquareGateway extends base_gateway_1.BaseGateway {
+    constructor() {
+        super(...arguments);
+        this.provider = 'square';
+        this.envKey = 'PUNCH_SQUARE_API_KEY';
+    }
+    async createPayment(input) {
+        const token = this.getApiKeyOrThrow();
+        const locationId = process.env.PUNCH_SQUARE_LOCATION_ID?.trim();
+        if (!locationId) {
+            throw new errors_1.PaymentProviderConfigError(this.provider, 'PUNCH_SQUARE_LOCATION_ID is required');
+        }
+        if (token.startsWith('square_mock_')) {
+            return this.mockPayment(input);
+        }
+        const sourceId = input.metadata?.sourceId;
+        if (!sourceId) {
+            throw new errors_1.PaymentProviderConfigError(this.provider, "Square requires metadata.sourceId for createPayment");
+        }
+        const idempotencyKey = input.idempotencyKey || `square_create_${Date.now()}`;
+        const response = await fetch(`${this.getBaseUrl()}/v2/payments`, {
+            method: 'POST',
+            headers: this.buildHeaders(token),
+            body: JSON.stringify({
+                idempotency_key: idempotencyKey,
+                source_id: sourceId,
+                location_id: locationId,
+                amount_money: {
+                    amount: this.toMinorAmount(input.amount),
+                    currency: input.currency
+                }
+            })
+        });
+        if (!response.ok) {
+            throw new errors_1.PaymentProviderRequestError(this.provider, await response.text());
+        }
+        const raw = (await response.json());
+        return {
+            id: raw.payment?.id ?? `square_${Date.now()}`,
+            provider: this.provider,
+            amount: (raw.payment?.amount_money?.amount ?? this.toMinorAmount(input.amount)) / 100,
+            currency: raw.payment?.amount_money?.currency ?? input.currency,
+            status: this.mapPaymentStatus(raw.payment?.status),
+            raw
+        };
+    }
+    async capturePayment(input) {
+        const token = this.getApiKeyOrThrow();
+        if (token.startsWith('square_mock_')) {
+            return this.mockOperationResult('capture', input.paymentId);
+        }
+        const response = await fetch(`${this.getBaseUrl()}/v2/payments/${input.paymentId}/complete`, {
+            method: 'POST',
+            headers: this.buildHeaders(token),
+            body: JSON.stringify({ idempotency_key: input.idempotencyKey || `square_capture_${Date.now()}` })
+        });
+        if (!response.ok) {
+            throw new errors_1.PaymentProviderRequestError(this.provider, await response.text());
+        }
+        const raw = (await response.json());
+        return {
+            provider: this.provider,
+            paymentId: input.paymentId,
+            operationId: raw.payment?.id ?? `capture_${input.paymentId}`,
+            status: this.mapOperationStatus(raw.payment?.status),
+            raw
+        };
+    }
+    async cancelPayment(input) {
+        const token = this.getApiKeyOrThrow();
+        if (token.startsWith('square_mock_')) {
+            return this.mockOperationResult('cancel', input.paymentId, 'canceled');
+        }
+        const response = await fetch(`${this.getBaseUrl()}/v2/payments/${input.paymentId}/cancel`, {
+            method: 'POST',
+            headers: this.buildHeaders(token),
+            body: JSON.stringify({ idempotency_key: input.idempotencyKey || `square_cancel_${Date.now()}` })
+        });
+        if (!response.ok) {
+            throw new errors_1.PaymentProviderRequestError(this.provider, await response.text());
+        }
+        const raw = (await response.json());
+        return {
+            provider: this.provider,
+            paymentId: input.paymentId,
+            operationId: raw.payment?.id ?? `cancel_${input.paymentId}`,
+            status: this.mapOperationStatus(raw.payment?.status),
+            raw
+        };
+    }
+    async refundPayment(input) {
+        const token = this.getApiKeyOrThrow();
+        if (token.startsWith('square_mock_')) {
+            return this.mockOperationResult('refund', input.paymentId);
+        }
+        const response = await fetch(`${this.getBaseUrl()}/v2/refunds`, {
+            method: 'POST',
+            headers: this.buildHeaders(token),
+            body: JSON.stringify({
+                payment_id: input.paymentId,
+                amount_money: typeof input.amount === 'number'
+                    ? {
+                        amount: this.toMinorAmount(input.amount),
+                        currency: this.requireCurrencyForAmount(input.amount, input.currency)
+                    }
+                    : undefined,
+                idempotency_key: input.idempotencyKey || `square_refund_${Date.now()}`,
+                reason: input.reason
+            })
+        });
+        if (!response.ok) {
+            throw new errors_1.PaymentProviderRequestError(this.provider, await response.text());
+        }
+        const raw = (await response.json());
+        return {
+            provider: this.provider,
+            paymentId: input.paymentId,
+            operationId: raw.refund?.id ?? `refund_${input.paymentId}`,
+            status: this.mapOperationStatus(raw.refund?.status),
+            raw
+        };
+    }
+    async parseWebhook(headers, rawBody) {
+        const signature = this.normalizeHeaderValue(headers['x-square-hmacsha256-signature']);
+        if (!signature) {
+            throw new errors_1.PaymentWebhookSignatureError(this.provider, 'Missing x-square-hmacsha256-signature header');
+        }
+        const signatureKey = process.env.PUNCH_SQUARE_WEBHOOK_SIGNATURE_KEY?.trim();
+        const notificationUrl = process.env.PUNCH_SQUARE_WEBHOOK_NOTIFICATION_URL?.trim();
+        if (!signatureKey || !notificationUrl) {
+            throw new errors_1.PaymentProviderConfigError(this.provider, 'PUNCH_SQUARE_WEBHOOK_SIGNATURE_KEY and PUNCH_SQUARE_WEBHOOK_NOTIFICATION_URL are required');
+        }
+        const computed = (0, node_crypto_1.createHmac)('sha256', signatureKey).update(`${notificationUrl}${rawBody}`).digest('base64');
+        if (computed !== signature) {
+            throw new errors_1.PaymentWebhookSignatureError(this.provider, 'Square webhook signature mismatch');
+        }
+        const event = JSON.parse(rawBody);
+        return {
+            provider: this.provider,
+            eventId: event.event_id ?? `event_${Date.now()}`,
+            eventType: event.type ?? 'square.unknown',
+            receivedAt: event.created_at ?? new Date().toISOString(),
+            payload: event
+        };
+    }
+    getBaseUrl() {
+        return process.env.PUNCH_SQUARE_BASE_URL?.trim() || 'https://connect.squareupsandbox.com';
+    }
+    buildHeaders(token) {
+        return {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            'Square-Version': process.env.PUNCH_SQUARE_API_VERSION || '2024-06-04'
+        };
+    }
+    toMinorAmount(amount) {
+        return Math.round(amount * 100);
+    }
+    mapPaymentStatus(status) {
+        if (status === 'COMPLETED') {
+            return 'succeeded';
+        }
+        if (status === 'FAILED' || status === 'CANCELED') {
+            return 'failed';
+        }
+        if (status === 'PENDING') {
+            return 'processing';
+        }
+        return 'requires_payment_method';
+    }
+    mapOperationStatus(status) {
+        if (status === 'COMPLETED') {
+            return 'succeeded';
+        }
+        if (status === 'CANCELED') {
+            return 'canceled';
+        }
+        if (status === 'FAILED') {
+            return 'failed';
+        }
+        return 'processing';
+    }
+    requireCurrencyForAmount(amount, currency) {
+        if (!currency) {
+            throw new errors_1.PaymentProviderRequestError(this.provider, `Currency is required when amount (${amount}) is provided for refund`);
+        }
+        return currency;
+    }
+};
+exports.SquareGateway = SquareGateway;
+exports.SquareGateway = SquareGateway = __decorate([
+    (0, common_1.Injectable)()
+], SquareGateway);
+//# sourceMappingURL=square.gateway.js.map

package/dist/payments/providers/square/square.gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"square.gateway.js","sourceRoot":"","sources":["../../../../src/payments/providers/square/square.gateway.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAC5C,6CAAyC;AACzC,gDAA4H;AAS5H,kDAA8C;AAGvC,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,0BAAW;IAAvC;;QACI,aAAQ,GAAG,QAAiB,CAAC;QACnB,WAAM,GAAG,sBAAsB,CAAC;IAkOrD,CAAC;IAhOC,KAAK,CAAC,aAAa,CAAC,KAAyB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE,CAAC;QAEhE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,mCAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,sCAAsC,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,mCAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,qDAAqD,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,iBAAiB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,eAAe,EAAE,cAAc;gBAC/B,SAAS,EAAE,QAAQ;gBACnB,WAAW,EAAE,UAAU;gBACvB,YAAY,EAAE;oBACZ,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;oBACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB;aACF,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,oCAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAEjC,CAAC;QAEF,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE;YAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG;YACrF,QAAQ,EAAG,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,QAAgC,IAAI,KAAK,CAAC,QAAQ;YACxF,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;YAClD,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,KAAK,CAAC,SAAS,WAAW,EAAE;YAC3F,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,cAAc,IAAI,kBAAkB,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;SAClG,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,oCAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmD,CAAC;QAEtF,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,WAAW,KAAK,CAAC,SAAS,EAAE;YAC5D,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;YACpD,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAyB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,KAAK,CAAC,SAAS,SAAS,EAAE;YACzF,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,cAAc,IAAI,iBAAiB,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC;SACjG,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,oCAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmD,CAAC;QAEtF,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,UAAU,KAAK,CAAC,SAAS,EAAE;YAC3D,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;YACpD,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAyB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,UAAU,EAAE,KAAK,CAAC,SAAS;gBAC3B,YAAY,EACV,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAC9B,CAAC,CAAC;wBACE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;wBACxC,QAAQ,EAAE,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;qBACtE;oBACH,CAAC,CAAC,SAAS;gBACf,eAAe,EAAE,KAAK,CAAC,cAAc,IAAI,iBAAiB,IAAI,CAAC,GAAG,EAAE,EAAE;gBACtE,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,oCAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkD,CAAC;QAErF,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,UAAU,KAAK,CAAC,SAAS,EAAE;YAC1D,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;YACnD,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAsD,EAAE,OAAe;QACxF,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,qCAA4B,CAAC,IAAI,CAAC,QAAQ,EAAE,8CAA8C,CAAC,CAAC;QACxG,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,IAAI,EAAE,CAAC;QAC5E,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,IAAI,EAAE,CAAC;QAElF,IAAI,CAAC,YAAY,IAAI,CAAC,eAAe,EAAE,CAAC;YACtC,MAAM,IAAI,mCAA0B,CAClC,IAAI,CAAC,QAAQ,EACb,2FAA2F,CAC5F,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,wBAAU,EAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,GAAG,eAAe,GAAG,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE5G,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,qCAA4B,CAAC,IAAI,CAAC,QAAQ,EAAE,mCAAmC,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA8D,CAAC;QAE/F,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,EAAE;YAChD,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,gBAAgB;YACzC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACxD,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAEO,UAAU;QAChB,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,qCAAqC,CAAC;IAC5F,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,OAAO;YACL,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,cAAc,EAAE,kBAAkB;YAClC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,YAAY;SACvE,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,MAAc;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;IAEO,gBAAgB,CAAC,MAAe;QACtC,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YACjD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAEO,kBAAkB,CAAC,MAAe;QACxC,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,wBAAwB,CAAC,MAAc,EAAE,QAAiB;QAChE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,oCAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,qCAAqC,MAAM,0BAA0B,CAAC,CAAC;QAC9H,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAA;AApOY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;GACA,aAAa,CAoOzB"}

package/dist/payments/providers/stripe/stripe.gateway.d.ts

@@ -0,0 +1,22 @@
+import { CancelPaymentInput, CapturePaymentInput, CreatePaymentInput, Payment, PaymentOperationResult, RefundPaymentInput } from '../../domain/payment.types';
+import { BaseGateway } from '../base-gateway';
+export declare class StripeGateway extends BaseGateway {
+    readonly provider: "stripe";
+    protected readonly envKey = "PUNCH_STRIPE_API_KEY";
+    createPayment(input: CreatePaymentInput): Promise<Payment>;
+    capturePayment(input: CapturePaymentInput): Promise<PaymentOperationResult>;
+    cancelPayment(input: CancelPaymentInput): Promise<PaymentOperationResult>;
+    refundPayment(input: RefundPaymentInput): Promise<PaymentOperationResult>;
+    parseWebhook(headers: Record<string, string | string[] | undefined>, rawBody: string): Promise<{
+        provider: "stripe";
+        eventId: string;
+        eventType: string;
+        receivedAt: string;
+        payload: {
+            id: string;
+            type: string;
+            created?: number;
+        };
+    }>;
+    private buildHeaders;
+}

package/dist/payments/providers/stripe/stripe.gateway.js

@@ -0,0 +1,175 @@
+"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.StripeGateway = void 0;
+const common_1 = require("@nestjs/common");
+const node_crypto_1 = require("node:crypto");
+const errors_1 = require("../../domain/errors");
+const base_gateway_1 = require("../base-gateway");
+let StripeGateway = class StripeGateway extends base_gateway_1.BaseGateway {
+    constructor() {
+        super(...arguments);
+        this.provider = 'stripe';
+        this.envKey = 'PUNCH_STRIPE_API_KEY';
+    }
+    async createPayment(input) {
+        const apiKey = this.getApiKeyOrThrow();
+        if (apiKey.startsWith('sk_test_mock_')) {
+            return this.mockPayment(input);
+        }
+        const headers = this.buildHeaders(apiKey, input.idempotencyKey);
+        const response = await fetch('https://api.stripe.com/v1/payment_intents', {
+            method: 'POST',
+            headers,
+            body: new URLSearchParams({
+                amount: String(Math.round(input.amount * 100)),
+                currency: input.currency.toLowerCase(),
+                automatic_payment_methods: 'enabled'
+            }).toString()
+        });
+        if (!response.ok) {
+            const detail = await response.text();
+            throw new errors_1.PaymentProviderRequestError(this.provider, detail);
+        }
+        const raw = (await response.json());
+        return {
+            id: raw.id,
+            provider: this.provider,
+            amount: input.amount,
+            currency: input.currency,
+            status: raw.status ?? 'processing',
+            raw
+        };
+    }
+    async capturePayment(input) {
+        const apiKey = this.getApiKeyOrThrow();
+        if (apiKey.startsWith('sk_test_mock_')) {
+            return this.mockOperationResult('capture', input.paymentId);
+        }
+        const body = new URLSearchParams();
+        if (typeof input.amount === 'number') {
+            body.set('amount_to_capture', String(Math.round(input.amount * 100)));
+        }
+        const response = await fetch(`https://api.stripe.com/v1/payment_intents/${input.paymentId}/capture`, {
+            method: 'POST',
+            headers: this.buildHeaders(apiKey, input.idempotencyKey),
+            body: body.toString()
+        });
+        if (!response.ok) {
+            const detail = await response.text();
+            throw new errors_1.PaymentProviderRequestError(this.provider, detail);
+        }
+        const raw = (await response.json());
+        return {
+            provider: this.provider,
+            paymentId: input.paymentId,
+            operationId: raw.id ?? `capture_${input.paymentId}`,
+            status: raw.status ?? 'processing',
+            raw
+        };
+    }
+    async cancelPayment(input) {
+        const apiKey = this.getApiKeyOrThrow();
+        if (apiKey.startsWith('sk_test_mock_')) {
+            return this.mockOperationResult('cancel', input.paymentId, 'canceled');
+        }
+        const response = await fetch(`https://api.stripe.com/v1/payment_intents/${input.paymentId}/cancel`, {
+            method: 'POST',
+            headers: this.buildHeaders(apiKey, input.idempotencyKey),
+            body: ''
+        });
+        if (!response.ok) {
+            const detail = await response.text();
+            throw new errors_1.PaymentProviderRequestError(this.provider, detail);
+        }
+        const raw = (await response.json());
+        return {
+            provider: this.provider,
+            paymentId: input.paymentId,
+            operationId: raw.id ?? `cancel_${input.paymentId}`,
+            status: raw.status ?? 'canceled',
+            raw
+        };
+    }
+    async refundPayment(input) {
+        const apiKey = this.getApiKeyOrThrow();
+        if (apiKey.startsWith('sk_test_mock_')) {
+            return this.mockOperationResult('refund', input.paymentId);
+        }
+        const body = new URLSearchParams({ payment_intent: input.paymentId });
+        if (typeof input.amount === 'number') {
+            body.set('amount', String(Math.round(input.amount * 100)));
+        }
+        if (input.reason) {
+            body.set('reason', input.reason);
+        }
+        const response = await fetch('https://api.stripe.com/v1/refunds', {
+            method: 'POST',
+            headers: this.buildHeaders(apiKey, input.idempotencyKey),
+            body: body.toString()
+        });
+        if (!response.ok) {
+            const detail = await response.text();
+            throw new errors_1.PaymentProviderRequestError(this.provider, detail);
+        }
+        const raw = (await response.json());
+        return {
+            provider: this.provider,
+            paymentId: input.paymentId,
+            operationId: raw.id ?? `refund_${input.paymentId}`,
+            status: raw.status ?? 'processing',
+            raw
+        };
+    }
+    async parseWebhook(headers, rawBody) {
+        const signatureHeader = this.normalizeHeaderValue(headers['stripe-signature']);
+        if (!signatureHeader) {
+            throw new errors_1.PaymentWebhookSignatureError(this.provider, 'Missing stripe-signature header');
+        }
+        const webhookSecret = process.env.PUNCH_STRIPE_WEBHOOK_SECRET;
+        if (!webhookSecret) {
+            throw new errors_1.PaymentProviderConfigError(this.provider, 'PUNCH_STRIPE_WEBHOOK_SECRET is required');
+        }
+        const fragments = signatureHeader.split(',').map((value) => value.trim());
+        const timestamp = fragments.find((value) => value.startsWith('t='))?.slice(2);
+        const expectedSignature = fragments.find((value) => value.startsWith('v1='))?.slice(3);
+        if (!timestamp || !expectedSignature) {
+            throw new errors_1.PaymentWebhookSignatureError(this.provider, 'Invalid stripe-signature format');
+        }
+        const signedPayload = `${timestamp}.${rawBody}`;
+        const computedSignature = (0, node_crypto_1.createHmac)('sha256', webhookSecret).update(signedPayload).digest('hex');
+        const expectedBuffer = Buffer.from(expectedSignature, 'hex');
+        const computedBuffer = Buffer.from(computedSignature, 'hex');
+        if (expectedBuffer.length !== computedBuffer.length || !(0, node_crypto_1.timingSafeEqual)(expectedBuffer, computedBuffer)) {
+            throw new errors_1.PaymentWebhookSignatureError(this.provider, 'Signature mismatch');
+        }
+        const event = JSON.parse(rawBody);
+        return {
+            provider: this.provider,
+            eventId: event.id,
+            eventType: event.type,
+            receivedAt: new Date((event.created ?? Math.floor(Date.now() / 1000)) * 1000).toISOString(),
+            payload: event
+        };
+    }
+    buildHeaders(apiKey, idempotencyKey) {
+        const headers = {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/x-www-form-urlencoded'
+        };
+        if (idempotencyKey) {
+            headers['Idempotency-Key'] = idempotencyKey;
+        }
+        return headers;
+    }
+};
+exports.StripeGateway = StripeGateway;
+exports.StripeGateway = StripeGateway = __decorate([
+    (0, common_1.Injectable)()
+], StripeGateway);
+//# sourceMappingURL=stripe.gateway.js.map

package/dist/payments/providers/stripe/stripe.gateway.js.map

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

package/dist/payments/providers/stub-gateway.d.ts

@@ -0,0 +1,19 @@
+import { CancelPaymentInput, CapturePaymentInput, CreatePaymentInput, Payment, PaymentOperationResult, PaymentWebhookEvent, RefundPaymentInput } from '../domain/payment.types';
+import { BaseGateway } from './base-gateway';
+export declare abstract class StubGateway extends BaseGateway {
+    createPayment(input: CreatePaymentInput): Promise<Payment>;
+    capturePayment(input: CapturePaymentInput): Promise<PaymentOperationResult>;
+    cancelPayment(input: CancelPaymentInput): Promise<PaymentOperationResult>;
+    refundPayment(input: RefundPaymentInput): Promise<PaymentOperationResult>;
+    parseWebhook(_headers: Record<string, string | string[] | undefined>, rawBody: string): Promise<PaymentWebhookEvent>;
+    protected injectAutoAuthHeaders(headers: Record<string, string>): void;
+    protected injectIdempotencyHeaders(headers: Record<string, string>, idempotencyKey?: string): void;
+    private isMockKey;
+    private providerEnvPrefix;
+    private requireOperationEndpoint;
+    private getOperationMethod;
+    private readString;
+    private normalizePaymentStatus;
+    private normalizeOperationStatus;
+    private verifyStubWebhookSignature;
+}