liqpay-nestjs 0.3.6 → 0.3.8

package/README.md

@@ -313,7 +313,7 @@ Useful optional fields include:
 - sender metadata such as `senderFirstName`, `senderLastName`, `senderAddress`, and `senderCountryCode`
 - product metadata such as `productName`, `productDescription`, `productCategory`, and `productUrl`
 
-The source repository keeps the full request and response models under `src/core/types` if you need exact field-level reference.
+The source repository keeps the full request and response models under `src/core/types` if you need exact field-level reference, including the internal refund models.
 
 ## Type Exports
 
@@ -323,11 +323,15 @@ The package root exports TypeScript types for request and response modeling, for
 import type {
 	CheckoutCallback,
 	CheckoutInput,
+	Currency,
 	LiqPayEnvelope,
 	LiqPayError,
+	LiqPayRequest,
+	LiqPayResponse,
 	PaymentStatusInput,
 	PaymentStatusResponse,
 	Result,
+	SplitRule,
 } from 'liqpay-nestjs'
 ```
 
@@ -340,6 +344,17 @@ It also exports these runtime values:
 
 Note: the package root currently exports types, not Zod schema values. The schema implementations live in the source under `src/core/types`.
 
+## Refunds Status
+
+The repository currently contains refund-related source files under `src/core/types/refund`, `src/core/clients/refunds.client.ts`, and `src/nest/services/refunds.service.ts`.
+
+That refund code is not part of the current public package API:
+
+- `LiqpayService` does not expose a `refunds` property
+- the package root does not export `RefundInput`, `RefundRequest`, `RefundResponse`, or `RefundsService`
+
+This README documents the public API that consumers can actually import from `liqpay-nestjs` today.
+
 ## Result Contract and Error Handling
 
 Methods that parse LiqPay responses return this shape:
@@ -376,6 +391,8 @@ The package root exports:
 - `LiqPayOptions`
 - `LiqPayAsyncOptions`
 
+It does not currently export `RefundsService` or refund-specific request and response types from the package root.
+
 ## Build
 
 ```bash

package/dist/core/clients/index.d.ts

@@ -1,4 +1 @@
 export * from './liqpay.client';
-export * from './payments.client';
-export * from './utils.client';
-export * from './webhooks.client';

package/dist/core/clients/index.js

@@ -15,6 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./liqpay.client"), exports);
-__exportStar(require("./payments.client"), exports);
-__exportStar(require("./utils.client"), exports);
-__exportStar(require("./webhooks.client"), exports);

package/dist/core/clients/liqpay.client.d.ts

@@ -1,8 +1,10 @@
 import { PaymentsClient } from './payments.client';
+import { RefundsClient } from './refunds.client';
 import { WebhooksClient } from './webhooks.client';
 export declare class LiqPayClient {
     payments: PaymentsClient;
     webhooks: WebhooksClient;
+    refunds: RefundsClient;
     constructor(options: {
         publicKey: string;
         privateKey: string;

package/dist/core/clients/liqpay.client.js

@@ -2,16 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LiqPayClient = void 0;
 const payments_client_1 = require("./payments.client");
+const refunds_client_1 = require("./refunds.client");
 const utils_client_1 = require("./utils.client");
 const webhooks_client_1 = require("./webhooks.client");
 class LiqPayClient {
     payments;
     webhooks;
+    refunds;
     constructor(options) {
         const { publicKey, privateKey, resultUrl, serverUrl } = options;
         const utils = new utils_client_1.UtilsClient(publicKey, privateKey, resultUrl ?? '', serverUrl ?? '');
         this.payments = new payments_client_1.PaymentsClient(utils);
         this.webhooks = new webhooks_client_1.WebhooksClient(utils);
+        this.refunds = new refunds_client_1.RefundsClient(utils);
     }
 }
 exports.LiqPayClient = LiqPayClient;

package/dist/core/clients/payments.client.js

@@ -82,7 +82,7 @@ class PaymentsClient {
             version: 7,
             publicKey: this.utils.publicKey,
         };
-        return await this.utils.call(request, payment_status_1.RawPaymentStatusRequestSchema, payment_status_1.PaymentStatusResponseSchema, common_1.REQUEST_URL);
+        return await this.utils.call(request, payment_status_1.RawPaymentStatusRequestSchema, payment_status_1.PaymentStatusResponseSchema);
     }
 }
 exports.PaymentsClient = PaymentsClient;

package/dist/core/clients/refunds.client.d.ts

@@ -0,0 +1,7 @@
+import { RefundInput } from '../types/refund';
+import { UtilsClient } from './utils.client';
+export declare class RefundsClient {
+    private readonly utils;
+    constructor(utils: UtilsClient);
+    refund(payload: RefundInput): void;
+}

package/dist/core/clients/refunds.client.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundsClient = void 0;
+const refund_1 = require("../types/refund");
+class RefundsClient {
+    utils;
+    constructor(utils) {
+        this.utils = utils;
+    }
+    refund(payload) {
+        const request = {
+            ...payload,
+            version: 7,
+            publicKey: this.utils.publicKey,
+            action: 'refund',
+        };
+        this.utils.call(request, refund_1.RawRefundRequestSchema, refund_1.RefundResponseSchema);
+    }
+}
+exports.RefundsClient = RefundsClient;

package/dist/core/clients/utils.client.d.ts

@@ -16,5 +16,5 @@ export declare class UtilsClient {
     parseData<T>(schema: z.ZodType<T>, data: unknown): Result<T>;
     parseError(data: unknown): Result<never> | null;
     parseEnvelope<TResponse extends LiqPayResponse>(envelope: LiqPayEnvelope, schema: z.ZodType<TResponse>): Result<TResponse>;
-    call<TRequest extends LiqPayRequest, TRawRequest extends LiqPayRawRequest, TResponse extends LiqPayResponse>(payload: TRequest, rawSchema: z.ZodType<TRawRequest>, responseSchema: z.ZodType<TResponse>, url: string): Promise<Result<TResponse>>;
+    call<TRequest extends LiqPayRequest, TRawRequest extends LiqPayRawRequest, TResponse extends LiqPayResponse>(payload: TRequest, rawSchema: z.ZodType<TRawRequest>, responseSchema: z.ZodType<TResponse>, url?: string): Promise<Result<TResponse>>;
 }

package/dist/core/clients/utils.client.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UtilsClient = void 0;
 const node_crypto_1 = require("node:crypto");
+const common_1 = require("../types/common");
 const error_1 = require("../types/error");
 class UtilsClient {
     publicKey;
@@ -70,7 +71,7 @@ class UtilsClient {
         }
         return this.parseData(schema, rawData);
     }
-    async call(payload, rawSchema, responseSchema, url) {
+    async call(payload, rawSchema, responseSchema, url = common_1.REQUEST_URL) {
         const raw = rawSchema.parse(payload);
         const envelope = this.toEnvelope(raw);
         const response = await fetch(url, {

package/dist/core/types/base/request.type.d.ts

@@ -1,4 +1,5 @@
 import { CheckoutRequest, RawCheckoutRequest } from '../checkout';
 import { PaymentStatusRequest, RawPaymentStatusRequest } from '../payment-status';
-export type LiqPayRequest = CheckoutRequest | PaymentStatusRequest;
-export type LiqPayRawRequest = RawCheckoutRequest | RawPaymentStatusRequest;
+import { RawRefundRequest, RefundRequest } from '../refund';
+export type LiqPayRequest = CheckoutRequest | PaymentStatusRequest | RefundRequest;
+export type LiqPayRawRequest = RawCheckoutRequest | RawPaymentStatusRequest | RawRefundRequest;

package/dist/core/types/base/response.type.d.ts

@@ -1,8 +1,9 @@
 import { CheckoutCallback, RawCheckoutCallback } from '../checkout';
 import { LiqPayErrorResponse } from '../error';
 import { PaymentStatusResponse, RawPaymentStatusResponse } from '../payment-status';
-export type LiqPayResponse = CheckoutCallback | PaymentStatusResponse;
-export type LiqPayRawResponse = RawCheckoutCallback | RawPaymentStatusResponse | LiqPayErrorResponse;
+import { RawRefundResponse, RefundResponse } from '../refund';
+export type LiqPayResponse = CheckoutCallback | PaymentStatusResponse | RefundResponse;
+export type LiqPayRawResponse = RawCheckoutCallback | RawPaymentStatusResponse | RawRefundResponse | LiqPayErrorResponse;
 export type Result<T> = {
     data: T;
     error?: null;

package/dist/core/types/refund/index.d.ts

@@ -0,0 +1,2 @@
+export * from './refund.request';
+export * from './refund.response';

package/dist/core/types/refund/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./refund.request"), exports);
+__exportStar(require("./refund.response"), exports);

package/dist/nest/liqpay.service.d.ts

@@ -1,8 +1,9 @@
 import type { LiqPayOptions } from './interfaces';
-import { PaymentsService, WebhooksService } from './services';
+import { PaymentsService, RefundsService, WebhooksService } from './services';
 export declare class LiqpayService {
     private readonly options;
     readonly payments: PaymentsService;
     readonly webhooks: WebhooksService;
+    readonly refunds: RefundsService;
     constructor(options: LiqPayOptions);
 }

package/dist/nest/liqpay.service.js

@@ -21,11 +21,13 @@ let LiqpayService = class LiqpayService {
     options;
     payments;
     webhooks;
+    refunds;
     constructor(options) {
         this.options = options;
         const client = new clients_1.LiqPayClient(options);
         this.payments = new services_1.PaymentsService(client);
         this.webhooks = new services_1.WebhooksService(client);
+        this.refunds = new services_1.RefundsService(client);
     }
 };
 exports.LiqpayService = LiqpayService;

package/dist/nest/services/index.d.ts

@@ -1,2 +1,3 @@
 export * from './payments.service';
 export * from './webhooks.service';
+export * from './refunds.service';

package/dist/nest/services/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./payments.service"), exports);
 __exportStar(require("./webhooks.service"), exports);
+__exportStar(require("./refunds.service"), exports);

package/dist/nest/services/refunds.service.d.ts

@@ -0,0 +1,7 @@
+import { LiqPayClient } from '../../core/clients';
+import { RefundInput } from '../../core/types/refund';
+export declare class RefundsService {
+    private readonly client;
+    constructor(client: LiqPayClient);
+    refund(payload: RefundInput): Promise<void>;
+}

package/dist/nest/services/refunds.service.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundsService = void 0;
+class RefundsService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async refund(payload) {
+        return this.client.refunds.refund(payload);
+    }
+}
+exports.RefundsService = RefundsService;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "liqpay-nestjs",
 	"description": "LiqPay integration module for NestJS with support for payments, callbacks, and configuration via DI.",
-	"version": "0.3.6",
+	"version": "0.3.8",
 	"type": "commonjs",
 	"module": "dist/index.js",
 	"main": "dist/index.js",

package/dist/core/__devtypes/documented/checkout.callback.d.ts

@@ -1,250 +0,0 @@
-import { Action, Currency, MpiEci, PaymentStatus, Paytype } from './types';
-/**
- * Contract of decoded format of API parameters received in a request from LiqPay after payment
- */
-export interface CheckoutCallback {
-    /**
-     * Acquirer ID
-     */
-    acq_id: number;
-    /**
-     * Operation type. Possible values:
-     * - `pay` - payment
-     * - `hold` - blocking of funds on the sender's account
-     * - `subscribe` - creation of a regular payment
-     * - `regular` - regular payment
-     */
-    action: Action;
-    /**
-     * Agent commission in payment currency
-     */
-    agent_commission: number;
-    /**
-     * Payment amount
-     */
-    amount: number;
-    /**
-     * Sender bonus in debit payment currency
-     */
-    amount_bonus: number;
-    /**
-     * Transaction amount credit in currency `currency_credit`
-     */
-    amount_credit: number;
-    /**
-     * Transaction amount debit in currency `currency_debit`
-     */
-    amount_debit: number;
-    /**
-     * Authorization code for credit transaction
-     */
-    authcode_credit: string;
-    /**
-     * Authorization code for debit transaction
-     */
-    authcode_debit: string;
-    /**
-     * Sender card token
-     */
-    card_token: string;
-    /**
-     * Recipient fee in `currency_credit` currency
-     */
-    commission_credit: number;
-    /**
-     * Sender fee in `currency_debit`
-     */
-    commission_debit: number;
-    /**
-     * Date of debiting funds
-     */
-    completion_date: Date;
-    /**
-     * Payment creation date
-     */
-    create_date: Date;
-    /**
-     * Payment currency
-     */
-    currency: Currency;
-    /**
-     * Transaction currency credit
-     */
-    currency_credit: Currency;
-    /**
-     * Transaction currency debit
-     */
-    currency_debit: Currency;
-    /**
-     * A unique user identifier on the merchant's website. Maximum length __100__ characters.
-     */
-    customer: string;
-    /**
-     * Payment comment
-     */
-    description: string;
-    /**
-     * Payment completion/change date
-     */
-    end_date: Date;
-    /**
-     * Error code
-     */
-    err_code: string;
-    /**
-     * Error description
-     */
-    err_description: string;
-    /**
-     * Additional payment information
-     */
-    info: string;
-    /**
-     * Sender IP address
-     */
-    ip: string;
-    /**
-     * Represents whether 3D-Secure verification was performed during payment. Possible values: `true` - the transaction went through with 3DS verification, `false` - the transaction went through without 3DS verification
-     */
-    is_3ds: boolean;
-    /**
-     * `Order_id` of payment in the LiqPay system
-     */
-    liqpay_order_id: string;
-    /**
-     * Code that represents whether 3D-Secure verification was performed during payment. Possible values:
-     * - `5` - the transaction was completed with 3DS (the issuer and acquirer support 3D-Secure technology)
-     * - `6` - the payer's card issuer does not support 3D-Secure technology
-     * - `7` - the transaction was completed without 3D-Secure
-     */
-    mpi_eci: MpiEci;
-    /**
-     * Payment `Order_id`
-     */
-    order_id: string;
-    /**
-     * Payment ID in the LiqPay system
-     */
-    payment_id: number;
-    /**
-     * Payment method. Possible values:
-     * - card - payment by card
-     * - privat24 - through the Privat24 account
-     * - moment_part - installment
-     * - invoice - invoice to e-mail
-     * - qr - scan qr code
-     */
-    paytype: Paytype;
-    /**
-     * Store public key
-     */
-    public_key: string;
-    /**
-     * Recipient fee in payment currency
-     */
-    receiver_commission: number;
-    /**
-     * Link to which the client must be redirected to complete 3DS verification
-     */
-    redirect_to: string;
-    /**
-     * Date of last payment refund
-     */
-    refund_date_last: Date;
-    /**
-     * Unique transaction number in the authorization and settlement system of the servicing bank `Retrieval Reference number`
-     */
-    rrn_credit: string;
-    /**
-     * Unique transaction number in the authorization and settlement system of the servicing bank `Retrieval Reference number`
-     */
-    rrn_debit: string;
-    /**
-     * Sender bonus in payment currency
-     */
-    sender_bonus: number;
-    /**
-     * Sender's bank
-     */
-    sender_card_bank: string;
-    /**
-     * Country of the sender's card. Numeric __ISO 3166-1__ code
-     */
-    sender_card_country: string;
-    /**
-     * Sender's card mask
-     */
-    sender_card_mask2: string;
-    /**
-     * Sender's IBAN
-     */
-    sender_iban: string;
-    /**
-     * Sender's card type MC/Visa
-     */
-    sender_card_type: string;
-    /**
-     * Sender's fee in payment currency
-     */
-    sender_commission: number;
-    /**
-     * Sender's first name
-     */
-    sender_first_name: string;
-    /**
-     * Sender's last name
-     */
-    sender_last_name: string;
-    /**
-     * Sender's phone number
-     */
-    sender_phone: string;
-    /**
-     * Payment status
-     */
-    status: PaymentStatus;
-    /**
-     * An additional payment status indicating that the current payment is reserved for a refund on your store. Possible values: `true` - the payment is reserved for a refund
-     */
-    wait_reserve_status?: boolean;
-    /**
-     * Payment Token
-     */
-    token: string;
-    /**
-     * Payment type
-     */
-    type: string;
-    /**
-     * API version. Current value is `7`
-     */
-    version: 7;
-    /**
-     * Error code
-     */
-    err_erc: string;
-    /**
-     * Product category
-     */
-    product_category: string;
-    /**
-     * Product description
-     */
-    product_description: string;
-    /**
-     * Product name
-     */
-    product_name: string;
-    /**
-     * Product page address
-     */
-    product_url: string;
-    /**
-     * Refund amount
-     */
-    refund_amount: number;
-    /**
-     * Verification code
-     */
-    verifycode?: string;
-}

package/dist/core/__devtypes/documented/checkout.callback.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });