awesome-node-checkout 1.0.1 → 1.1.0

package/dist/providers/nexi/nexi.provider.js

@@ -0,0 +1,227 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NexiProvider = void 0;
+const crypto = __importStar(require("crypto"));
+const base_payment_provider_abstract_1 = require("../../abstract/base-payment-provider.abstract");
+/**
+ * Nexi eCommerce provider.
+ * Flow: `redirect` — builds a signed checkout URL, redirects the user to Nexi,
+ * then handles the POST-back via `handleRedirect`.
+ *
+ * Note: Nexi XPay mandates SHA-1 for MAC computation. This is a requirement of
+ * the Nexi API and cannot be changed on the client side.
+ */
+class NexiProvider extends base_payment_provider_abstract_1.BasePaymentProvider {
+    constructor(config) {
+        super();
+        this.config = config;
+        this.name = 'nexi';
+        this.flow = 'redirect';
+        this.apiUrl =
+            config.environment === 'production'
+                ? 'https://ecommerce.nexi.it'
+                : 'https://int-ecommerce.nexi.it';
+    }
+    /**
+     * Computes the SHA-1 MAC required by Nexi to authenticate the payment request.
+     * Format: `codTrans={val}divisa={val}importo={val}{macKey}`
+     *
+     * SHA-1 is used here because Nexi XPay mandates it for MAC computation.
+     */
+    generateMac(codTrans, divisa, importoCents) {
+        const raw = `codTrans=${codTrans}divisa=${divisa}importo=${importoCents}${this.config.macKey}`;
+        return crypto.createHash('sha1').update(raw).digest('hex');
+    }
+    /**
+     * Computes the SHA-1 MAC for the status (getPaymentDetails) API call.
+     * Format: `alias={alias}codTrans={codTrans}timestamp={timestamp}{macKey}`
+     */
+    generateStatusMac(alias, codTrans, timestamp) {
+        const raw = `alias=${alias}codTrans=${codTrans}timestamp=${timestamp}${this.config.macKey}`;
+        return crypto.createHash('sha1').update(raw).digest('hex');
+    }
+    /**
+     * Computes the SHA-1 MAC for the refund (storno) API call.
+     * Format: `alias={alias}codTrans={codTrans}importo={importo}timestamp={timestamp}{macKey}`
+     */
+    generateRefundMac(alias, codTrans, importo, timestamp) {
+        const raw = `alias=${alias}codTrans=${codTrans}importo=${importo}timestamp=${timestamp}${this.config.macKey}`;
+        return crypto.createHash('sha1').update(raw).digest('hex');
+    }
+    /**
+     * Verifies the SHA-1 MAC included in a Nexi POST-back response.
+     * Format: `codTrans={val}esito={val}importo={val}divisa={val}{macKey}`
+     */
+    verifyResponseMac(codTrans, esito, importo, divisa, mac) {
+        const raw = `codTrans=${codTrans}esito=${esito}importo=${importo}divisa=${divisa}${this.config.macKey}`;
+        const expected = crypto.createHash('sha1').update(raw).digest('hex');
+        return crypto.timingSafeEqual(Buffer.from(expected, 'hex'), Buffer.from(mac, 'hex'));
+    }
+    async createPayment(request) {
+        try {
+            const amountCents = Math.round(request.amount * 100);
+            const orderId = request.orderId ?? `ORD-${Date.now()}`;
+            const mac = this.generateMac(orderId, request.currency, amountCents);
+            const params = {
+                alias: this.config.merchantId,
+                importo: amountCents.toString(),
+                divisa: request.currency,
+                codTrans: orderId,
+                url: request.returnUrl,
+                url_back: request.cancelUrl,
+                mac,
+            };
+            if (this.config.group) {
+                params.gruppo = this.config.group;
+            }
+            const approvalUrl = `${this.apiUrl}/ecomm/ecomm/DispatcherServlet?${new URLSearchParams(params)}`;
+            return {
+                success: true,
+                paymentId: orderId,
+                approvalUrl,
+                status: 'CREATED',
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to create Nexi payment');
+        }
+    }
+    /**
+     * Validates the POST-back data from Nexi.
+     * `data` is the query/body object sent by Nexi to the returnUrl.
+     * The MAC is verified before the result is considered authoritative.
+     */
+    async executePayment(paymentId, data) {
+        try {
+            const esito = data?.esito ?? '';
+            const codTrans = data?.codTrans ?? paymentId;
+            const importo = data?.importo ?? '';
+            const divisa = data?.divisa ?? '';
+            const mac = data?.mac ?? '';
+            if (mac) {
+                let macValid;
+                try {
+                    macValid = this.verifyResponseMac(codTrans, esito, importo, divisa, mac);
+                }
+                catch {
+                    macValid = false;
+                }
+                if (!macValid) {
+                    return {
+                        success: false,
+                        paymentId: codTrans,
+                        status: 'FAILED',
+                        error: 'MAC verification failed: response may have been tampered with',
+                    };
+                }
+            }
+            return {
+                success: esito === 'OK',
+                paymentId: codTrans,
+                status: esito === 'OK' ? 'COMPLETED' : 'FAILED',
+                raw: data,
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to execute Nexi payment');
+        }
+    }
+    async getPaymentDetails(paymentId) {
+        try {
+            const timestamp = new Date().toISOString();
+            const mac = this.generateStatusMac(this.config.merchantId, paymentId, timestamp);
+            const params = {
+                alias: this.config.merchantId,
+                codTrans: paymentId,
+                timestamp,
+                mac,
+            };
+            const response = await fetch(`${this.apiUrl}/ecomm/api/vas/igfs/status/plain`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                body: new URLSearchParams(params),
+            });
+            if (!response.ok)
+                throw new Error(`Nexi API error: ${response.statusText}`);
+            const result = await response.json();
+            return { success: true, paymentId, status: result['status'], raw: result };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to get Nexi payment details');
+        }
+    }
+    async refundPayment(paymentId, amount) {
+        try {
+            const timestamp = new Date().toISOString();
+            const importo = amount ? Math.round(amount * 100).toString() : '';
+            const mac = this.generateRefundMac(this.config.merchantId, paymentId, importo, timestamp);
+            const params = {
+                alias: this.config.merchantId,
+                codTrans: paymentId,
+                importo,
+                timestamp,
+                mac,
+            };
+            const response = await fetch(`${this.apiUrl}/ecomm/api/vas/igfs/storno/plain`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+                body: new URLSearchParams(params),
+            });
+            if (!response.ok)
+                throw new Error(`Nexi API error: ${response.statusText}`);
+            const result = await response.json();
+            return {
+                success: result['esito'] === 'OK',
+                paymentId,
+                status: result['esito'] === 'OK' ? 'REFUNDED' : 'REFUND_FAILED',
+                raw: result,
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to refund Nexi payment');
+        }
+    }
+    /**
+     * Handles the POST-back from Nexi to the returnUrl.
+     * Nexi sends `esito`, `codTrans`, `importo`, `divisa`, `mac`, etc. as query/body params.
+     * The MAC is verified to ensure the response was not spoofed.
+     */
+    async handleRedirect(query) {
+        return this.executePayment(query['codTrans'] ?? '', query);
+    }
+}
+exports.NexiProvider = NexiProvider;
+//# sourceMappingURL=nexi.provider.js.map

package/dist/providers/nexi/nexi.provider.js.map

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

package/dist/providers/paypal/paypal.provider.d.ts

@@ -0,0 +1,33 @@
+import { BasePaymentProvider } from '../../abstract/base-payment-provider.abstract';
+import { PaymentRequest } from '../../models/payment-request.model';
+import { PaymentResult } from '../../models/payment-result.model';
+export interface PayPalProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    /** @default 'sandbox' */
+    environment?: 'sandbox' | 'live';
+}
+/**
+ * PayPal Checkout provider.
+ * Flow: `redirect` — creates an order, redirects the user to PayPal,
+ * then captures the payment on return via `handleRedirect`.
+ */
+export declare class PayPalProvider extends BasePaymentProvider {
+    private readonly config;
+    readonly name = "paypal";
+    readonly flow: "redirect";
+    private client;
+    private ordersController;
+    private paymentsController;
+    constructor(config: PayPalProviderConfig);
+    createPayment(request: PaymentRequest): Promise<PaymentResult>;
+    executePayment(paymentId: string): Promise<PaymentResult>;
+    getPaymentDetails(paymentId: string): Promise<PaymentResult>;
+    refundPayment(paymentId: string, amount?: number): Promise<PaymentResult>;
+    /**
+     * Handles the redirect from PayPal after the user approves the payment.
+     * PayPal appends `token` (order ID) and `PayerID` to the returnUrl.
+     */
+    handleRedirect(query: Record<string, string>): Promise<PaymentResult>;
+}
+//# sourceMappingURL=paypal.provider.d.ts.map

package/dist/providers/paypal/paypal.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paypal.provider.d.ts","sourceRoot":"","sources":["../../../src/providers/paypal/paypal.provider.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,mBAAmB;IAQzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,kBAAkB,CAAqB;gBAElB,MAAM,EAAE,oBAAoB;IAoBnD,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0C9D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBzD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiB5D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAuD/E;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CAU5E"}

package/dist/providers/paypal/paypal.provider.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayPalProvider = void 0;
+const paypal_server_sdk_1 = require("@paypal/paypal-server-sdk");
+const base_payment_provider_abstract_1 = require("../../abstract/base-payment-provider.abstract");
+/**
+ * PayPal Checkout provider.
+ * Flow: `redirect` — creates an order, redirects the user to PayPal,
+ * then captures the payment on return via `handleRedirect`.
+ */
+class PayPalProvider extends base_payment_provider_abstract_1.BasePaymentProvider {
+    constructor(config) {
+        super();
+        this.config = config;
+        this.name = 'paypal';
+        this.flow = 'redirect';
+        const { clientId, clientSecret, environment = 'sandbox' } = config;
+        this.client = new paypal_server_sdk_1.Client({
+            clientCredentialsAuthCredentials: {
+                oAuthClientId: clientId,
+                oAuthClientSecret: clientSecret,
+            },
+            environment: environment === 'live' ? paypal_server_sdk_1.Environment.Production : paypal_server_sdk_1.Environment.Sandbox,
+            logging: {
+                logLevel: paypal_server_sdk_1.LogLevel.Error,
+            },
+        });
+        this.ordersController = new paypal_server_sdk_1.OrdersController(this.client);
+        this.paymentsController = new paypal_server_sdk_1.PaymentsController(this.client);
+    }
+    async createPayment(request) {
+        try {
+            const { result: order } = await this.ordersController.createOrder({
+                body: {
+                    intent: 'CAPTURE',
+                    purchaseUnits: [
+                        {
+                            amount: {
+                                currencyCode: request.currency,
+                                value: request.amount.toFixed(2),
+                            },
+                            description: request.description,
+                        },
+                    ],
+                    paymentSource: {
+                        paypal: {
+                            experienceContext: {
+                                returnUrl: request.returnUrl,
+                                cancelUrl: request.cancelUrl,
+                            },
+                        },
+                    },
+                },
+                prefer: 'return=representation',
+            });
+            const approvalUrl = order.links?.find((l) => l.rel === 'payer-action' || l.rel === 'approve')?.href;
+            return {
+                success: true,
+                paymentId: order.id,
+                approvalUrl,
+                status: order.status,
+                raw: order,
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to create PayPal payment');
+        }
+    }
+    async executePayment(paymentId) {
+        try {
+            const { result: order } = await this.ordersController.captureOrder({
+                id: paymentId,
+                body: {},
+            });
+            return {
+                success: order.status === 'COMPLETED',
+                paymentId: order.id,
+                status: order.status,
+                raw: order,
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to execute PayPal payment');
+        }
+    }
+    async getPaymentDetails(paymentId) {
+        try {
+            const { result: order } = await this.ordersController.getOrder({
+                id: paymentId,
+            });
+            return {
+                success: true,
+                paymentId: order.id,
+                status: order.status,
+                raw: order,
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to get PayPal payment details');
+        }
+    }
+    async refundPayment(paymentId, amount) {
+        try {
+            // Retrieve order to find the capture ID and currency
+            const { result: order } = await this.ordersController.getOrder({ id: paymentId });
+            // The PayPal SDK types nested objects as `any`; extract with explicit guards
+            const purchaseUnit = Array.isArray(order?.purchaseUnits)
+                ? order.purchaseUnits[0]
+                : undefined;
+            const captureId = Array.isArray(purchaseUnit?.payments?.captures) && purchaseUnit.payments.captures.length > 0
+                ? String(purchaseUnit.payments.captures[0].id)
+                : undefined;
+            if (!captureId) {
+                return {
+                    success: false,
+                    error: 'No capture found for this order. Ensure the payment has been captured before refunding.',
+                    paymentId,
+                    status: 'REFUND_FAILED',
+                };
+            }
+            const refundBody = {};
+            if (amount !== undefined) {
+                const currencyCode = typeof purchaseUnit?.amount?.currencyCode === 'string'
+                    ? purchaseUnit.amount.currencyCode
+                    : undefined;
+                if (!currencyCode) {
+                    return {
+                        success: false,
+                        error: 'Cannot determine currency code from order. Refund a specific amount is not possible.',
+                        paymentId,
+                        status: 'REFUND_FAILED',
+                    };
+                }
+                refundBody['amount'] = { value: amount.toFixed(2), currencyCode };
+            }
+            const { result: refund } = await this.paymentsController.refundCapturedPayment({
+                captureId,
+                body: refundBody,
+            });
+            return {
+                success: refund?.status === 'COMPLETED',
+                paymentId: String(refund?.id ?? ''),
+                status: String(refund?.status ?? ''),
+                raw: refund,
+            };
+        }
+        catch (error) {
+            return this.errorResult(error, 'Failed to refund PayPal payment');
+        }
+    }
+    /**
+     * Handles the redirect from PayPal after the user approves the payment.
+     * PayPal appends `token` (order ID) and `PayerID` to the returnUrl.
+     */
+    async handleRedirect(query) {
+        const paymentId = query['token'];
+        if (!paymentId) {
+            return {
+                success: false,
+                error: 'Missing token in PayPal redirect query',
+            };
+        }
+        return this.executePayment(paymentId);
+    }
+}
+exports.PayPalProvider = PayPalProvider;
+//# sourceMappingURL=paypal.provider.js.map

package/dist/providers/paypal/paypal.provider.js.map

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

package/dist/providers/satispay/satispay.provider.d.ts

@@ -0,0 +1,79 @@
+import { BasePaymentProvider } from '../../abstract/base-payment-provider.abstract';
+import { PaymentRequest } from '../../models/payment-request.model';
+import { PaymentResult, WebhookResult } from '../../models/payment-result.model';
+import { ITransactionStore } from '../../interfaces/transaction-store.interface';
+export interface SatispayProviderConfig {
+    keyId: string;
+    /**
+     * RSA private key in PEM format (string content, not a file path).
+     * Load with: `fs.readFileSync('private.pem', 'utf8')`
+     */
+    privateKey: string;
+    /**
+     * Satispay RSA public key in PEM format, used to verify incoming webhook
+     * HTTP Signatures. Obtain it by calling GET /g_business/v1/consumers/{keyId}
+     * on Satispay's API for the keyId present in the webhook Authorization header.
+     * When provided, every inbound webhook whose signature cannot be verified is
+     * rejected before any business logic is executed.
+     */
+    webhookPublicKey?: string;
+    /** @default 'sandbox' */
+    environment?: 'sandbox' | 'production';
+    /**
+     * Base URL of the host application.
+     * Used to build the `callback_url` sent to Satispay.
+     * Example: 'https://myapp.com'
+     */
+    serverUrl?: string;
+    /**
+     * Custom transaction store for correlating webhooks with orders.
+     * Defaults to InMemoryTransactionStore.
+     * Use a persistent store (Redis, DB) in multi-instance deployments.
+     */
+    transactionStore?: ITransactionStore;
+}
+/**
+ * Satispay Business API provider.
+ * Flow: `webhook` — creates a MATCH_CODE payment, user pays via Satispay app,
+ * Satispay calls the `callback_url` webhook, which is correlated to the order
+ * via the `ITransactionStore`. The redirect is then verified via `handleRedirect`.
+ */
+export declare class SatispayProvider extends BasePaymentProvider {
+    private readonly config;
+    readonly name = "satispay";
+    readonly flow: "webhook";
+    private readonly apiUrl;
+    private readonly transactionStore;
+    constructor(config: SatispayProviderConfig);
+    private buildSignatureHeaders;
+    /**
+     * Verifies the HTTP Signature in an inbound Satispay webhook request.
+     * Satispay signs webhooks with their own RSA private key; we verify using
+     * the corresponding public key supplied in `config.webhookPublicKey`.
+     *
+     * Returns `true` if the signature is valid, `false` otherwise.
+     * If no `webhookPublicKey` is configured the check is skipped and `true`
+     * is returned — callers should treat this as an unverified state.
+     */
+    private verifyWebhookSignature;
+    private request;
+    createPayment(request: PaymentRequest): Promise<PaymentResult>;
+    /** For Satispay, execute is equivalent to a status check */
+    executePayment(paymentId: string): Promise<PaymentResult>;
+    getPaymentDetails(paymentId: string): Promise<PaymentResult>;
+    refundPayment(paymentId: string, amount?: number): Promise<PaymentResult>;
+    /**
+     * Handles the async webhook notification from Satispay.
+     * Satispay calls this URL with `payment_id` (the Satispay payment UUID).
+     * The HTTP Signature in the Authorization header is verified against
+     * `config.webhookPublicKey` (when configured) before processing.
+     * We then confirm the payment status via an authenticated API call.
+     */
+    handleWebhook(body: Record<string, unknown>, headers: Record<string, string>): Promise<WebhookResult>;
+    /**
+     * Handles the redirect back to the merchant app after the Satispay flow.
+     * Looks up the transaction by `order_id` in the store, then verifies status.
+     */
+    handleRedirect(query: Record<string, string>): Promise<PaymentResult>;
+}
+//# sourceMappingURL=satispay.provider.d.ts.map

package/dist/providers/satispay/satispay.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satispay.provider.d.ts","sourceRoot":"","sources":["../../../src/providers/satispay/satispay.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAGjF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IAO3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;gBAExB,MAAM,EAAE,sBAAsB;IAsB3D,OAAO,CAAC,qBAAqB;IAmC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;YAgEhB,OAAO;IAsBf,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAyCpE,4DAA4D;IACtD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAc5D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmB/E;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB3G;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CA4B5E"}