nestjs-monobank 1.2.8

package/dist/common/enums/discount.enum.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Тип знижки або надбавки.
+ */
+export interface Discount {
+    /**
+     * Тип:
+     * - DISCOUNT — знижка
+     * - EXTRA_CHARGE — надбавка
+     * Обов’язкове поле.
+     */
+    type: "DISCOUNT" | "EXTRA_CHARGE";
+    /**
+     * Режим:
+     * - PERCENT — у відсотках
+     * - VALUE — фіксоване значення
+     * Обов’язкове поле.
+     */
+    mode: "PERCENT" | "VALUE";
+    /**
+     * Значення знижки або надбавки.
+     * Обов’язкове поле.
+     */
+    value: number;
+}

package/dist/common/enums/discount.enum.js

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

package/dist/common/enums/index.d.ts

@@ -0,0 +1 @@
+export * from './discount.enum';

package/dist/common/enums/index.js

@@ -0,0 +1,17 @@
+"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("./discount.enum"), exports);

package/dist/common/interfaces/common.interface.d.ts

@@ -0,0 +1,177 @@
+import { InvoiceStatusEnum } from '../../modules/invoice/enums';
+import { Discount } from '../enums/discount.enum';
+/**
+ * Позиція в кошику замовлення.
+ */
+export interface BasketItem {
+    /**
+     * Назва товару або послуги.
+     * Обов’язкове поле.
+     */
+    name: string;
+    /**
+     * Кількість одиниць товару.
+     * Обов’язкове поле.
+     */
+    qty: number;
+    /**
+     * Ціна за одиницю товару у мінімальних одиницях валюти (наприклад, копійки для гривні).
+     * Обов’язкове поле.
+     */
+    sum: number;
+    /**
+     * Загальна сума за позицію (sum * qty).
+     * Якщо не передано — може бути обрахована на бекенді.
+     * Необов’язкове поле.
+     */
+    total?: number;
+    /**
+     * Посилання на зображення товару.
+     * Необов’язкове поле.
+     */
+    icon?: string;
+    /**
+     * Назва одиниці виміру товару (наприклад: шт, кг, м).
+     * Необов’язкове поле.
+     */
+    unit?: string;
+    /**
+     * Код товару (обов’язкове поле для фіскалізації).
+     * Обов’язкове поле.
+     */
+    code: string;
+    /**
+     * Значення штрих-коду, яке може бути використане при фіскалізації.
+     * Необов’язкове поле.
+     */
+    barcode?: string;
+    /**
+     * Текст, що буде виводитись перед назвою товару (наприклад, категорія).
+     * Необов’язкове поле.
+     */
+    header?: string;
+    /**
+     * Текст, що буде виводитись після назви товару.
+     * Необов’язкове поле.
+     */
+    footer?: string;
+    /**
+     * Масив податкових ставок, вибраних під час налаштування каси в Checkbox.
+     * У випадку з ПРРО monopay ставки поки що не використовуються.
+     * Необов’язкове поле.
+     */
+    tax?: number[];
+    /**
+     * Код УКТ ЗЕД для товару.
+     * Необов’язкове поле.
+     */
+    uktzed?: string;
+    /**
+     * Знижки або надбавки, що застосовуються саме до цієї позиції.
+     * Необов’язкове поле.
+     */
+    discounts?: Discount[];
+}
+/**
+ * Інформація про платіж для клієнта та фіскалізації.
+ */
+export interface MerchantPaymInfoItem {
+    /**
+     * Номер замовлення або чека, який задає продавець.
+     * Необов’язкове поле.
+     */
+    reference?: string;
+    /**
+     * Призначення платежу, що буде відображене у чеку.
+     * Максимальна довжина — 280 символів.
+     * Необов’язкове поле.
+     */
+    destination?: string;
+    /**
+     * Службове поле для додаткової інформації.
+     * Не відображається клієнту. Максимум 280 символів.
+     * Необов’язкове поле.
+     */
+    comment?: string;
+    /**
+     * Масив email-адрес клієнтів, на які буде відправлено фіскальний чек.
+     * Працює лише за наявності зв’язки з checkbox.
+     * Необов’язкове поле.
+     */
+    customerEmails?: string[];
+    /**
+     * Знижки або надбавки, які застосовуються до всього кошика.
+     * Враховуються під час фіскалізації (checkbox).
+     * Необов’язкове поле.
+     */
+    discounts?: Discount[];
+    /**
+     * Склад замовлення — деталі позицій у кошику.
+     * Обов’язкове поле при активній зв’язці з ПРРО.
+     */
+    basketOrder?: BasketItem[];
+}
+/**
+ * Дані про токенізовану картку у гаманці користувача.
+ */
+export interface WalletData {
+    /**
+     * Токен картки.
+     */
+    cardToken: string;
+    /**
+     * Ідентифікатор гаманця покупця.
+     */
+    walletId: string;
+    /**
+     * Статус токенізації картки.
+     */
+    status: "new" | "created" | "failed";
+}
+/**
+ * Статистика платежів по підписці
+ */
+export interface SubscriptionSummary {
+    /** Загальна сума успішно сплачених платежів */
+    totalPaid: number;
+    /** Загальна сума невдалих платежів */
+    totalFailed: number;
+}
+/**
+ * Інформація про виплату чайових співробітнику.
+ */
+export interface TipsInfo {
+    /**
+     * Ідентифікатор співробітника, якому можна виплатити чайові.
+     */
+    employeeId: string;
+    /**
+     * Сума успішно сплачених чайових у мінімальних одиницях валюти.
+     */
+    amount: number;
+}
+/**
+ * Дані для пагінації
+ */
+export interface Pagination {
+    /** Загальна кількість елементів */
+    totalItems: number;
+    /** Кількість елементів на сторінці */
+    itemsPerPage: number;
+    /** Поточна сторінка (починаючи з 1) */
+    currentPage: number;
+    /** Загальна кількість сторінок */
+    totalPages: number;
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+    pagination: Pagination;
+}
+/**
+ * Інформація про оплату, включаючи дані щодо токенізації картки та чайових.
+ */
+export interface InvoiceCancelItem {
+    status: Exclude<InvoiceStatusEnum, InvoiceStatusEnum.CREATED>;
+    walletData: WalletData;
+    tipsInfo?: TipsInfo;
+}

package/dist/common/interfaces/common.interface.js

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

package/dist/common/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./common.interface";
+export * from "./monobank-options.interface";

package/dist/common/interfaces/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("./common.interface"), exports);
+__exportStar(require("./monobank-options.interface"), exports);

package/dist/common/interfaces/monobank-options.interface.d.ts

@@ -0,0 +1,15 @@
+import type { FactoryProvider, ModuleMetadata } from "@nestjs/common";
+export declare const MonobankOptionsSymbol: unique symbol;
+/**
+ * Тип, що представляє параметри для налаштування Monobank.
+ */
+export type MonobankModuleOptions = {
+    /**
+     * Ключ API для автентифікації в Monobank.
+     */
+    apiKey: string;
+};
+/**
+ * Тип для асинхронного налаштування Monobank.
+ */
+export type MonobankModuleAsyncOptions = Pick<ModuleMetadata, "imports"> & Pick<FactoryProvider<MonobankModuleOptions>, "useFactory" | "inject">;

package/dist/common/interfaces/monobank-options.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonobankOptionsSymbol = void 0;
+exports.MonobankOptionsSymbol = Symbol();

package/dist/core/config/monobank.constants.d.ts

@@ -0,0 +1 @@
+export declare const MONOBANK_API_URL = "https://api.monobank.ua/api";

package/dist/core/config/monobank.constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MONOBANK_API_URL = void 0;
+exports.MONOBANK_API_URL = "https://api.monobank.ua/api";

package/dist/core/http/monobank.error.d.ts

@@ -0,0 +1,6 @@
+export declare class MonobankError extends Error {
+    code: string;
+    description: string;
+    data?: any;
+    constructor(code: string, description: string, data?: any);
+}

package/dist/core/http/monobank.error.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonobankError = void 0;
+class MonobankError extends Error {
+    constructor(code, description, data) {
+        super(description);
+        this.code = code;
+        this.description = description;
+        this.data = data;
+        this.name = "MonobankError";
+    }
+}
+exports.MonobankError = MonobankError;

package/dist/core/http/monobank.http-client.d.ts

@@ -0,0 +1,16 @@
+import { Dispatcher } from 'undici';
+import { type MonobankModuleOptions } from '../../common/interfaces';
+export declare class MonobankHttpClient {
+    private readonly config;
+    constructor(config: MonobankModuleOptions);
+    request<T>(options: {
+        method: Dispatcher.HttpMethod;
+        url: string;
+        data?: any;
+        params?: any;
+    }): Promise<T>;
+    get<T>(url: string, params?: any): Promise<T>;
+    post<T>(url: string, data?: any): Promise<T>;
+    delete<T>(url: string, params?: any): Promise<T>;
+    private buildUrl;
+}

package/dist/core/http/monobank.http-client.js

@@ -0,0 +1,66 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonobankHttpClient = void 0;
+const monobank_constants_1 = require("../config/monobank.constants");
+const monobank_error_1 = require("./monobank.error");
+const common_1 = require("@nestjs/common");
+const undici_1 = require("undici");
+const interfaces_1 = require("../../common/interfaces");
+let MonobankHttpClient = class MonobankHttpClient {
+    constructor(config) {
+        this.config = config;
+    }
+    async request(options) {
+        const url = this.buildUrl(options.url, options.params);
+        const response = await (0, undici_1.request)(url, {
+            method: options.method,
+            headersTimeout: 15000,
+            bodyTimeout: 15000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Token': this.config.apiKey,
+            },
+            body: options.data ? JSON.stringify(options.data) : undefined
+        });
+        if (response.statusCode >= 400) {
+            const text = await response.body.text();
+            throw new monobank_error_1.MonobankError('monobank_error', text, text);
+        }
+        return (await response.body.json());
+    }
+    get(url, params) {
+        return this.request({ method: 'GET', url, params });
+    }
+    post(url, data) {
+        return this.request({ method: 'POST', url, data });
+    }
+    delete(url, params) {
+        return this.request({ method: 'DELETE', url, params });
+    }
+    buildUrl(url, params) {
+        let fullUrl = `${monobank_constants_1.MONOBANK_API_URL}${url}`;
+        if (params && typeof params === 'object') {
+            const qp = new URLSearchParams(params);
+            fullUrl += `?${qp.toString()}`;
+        }
+        return fullUrl;
+    }
+};
+exports.MonobankHttpClient = MonobankHttpClient;
+exports.MonobankHttpClient = MonobankHttpClient = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(interfaces_1.MonobankOptionsSymbol)),
+    __metadata("design:paramtypes", [Object])
+], MonobankHttpClient);

package/dist/core/http/monobank.interceptor.d.ts

@@ -0,0 +1,2 @@
+import { AxiosInstance } from 'axios';
+export declare function attachMonobankInterceptors(http: AxiosInstance): void;

package/dist/core/http/monobank.interceptor.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachMonobankInterceptors = attachMonobankInterceptors;
+function attachMonobankInterceptors(http) {
+    http.interceptors.request.use(config => {
+        var _a;
+        console.log(`[Monobank Request] → ${(_a = config.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()} ${config.url}`);
+        return config;
+    });
+    http.interceptors.response.use(res => res, async (error) => {
+        var _a;
+        const status = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.status;
+        if (status >= 500) {
+            console.log('[Monobank] Retrying request after server error...');
+            return await http.request(error.config);
+        }
+        return Promise.reject(error);
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./common/interfaces";
+export * from "./monobank.module";
+export * from "./monobank.service";

package/dist/index.js

@@ -0,0 +1,19 @@
+"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("./common/interfaces"), exports);
+__exportStar(require("./monobank.module"), exports);
+__exportStar(require("./monobank.service"), exports);

package/dist/modules/invoice/enums/cancel-status.enum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Статус операції скасування інвойсу.
+ * @enum {string}
+ */
+export declare enum CancelStatusEnum {
+    /**
+     * Заявка на скасування знаходиться в обробці.
+     */
+    PROCESSING = "processing",
+    /**
+     * Заявка на скасування виконана успішно.
+     */
+    SUCCESS = "success",
+    /**
+     * Неуспішна заявка на скасування.
+     */
+    FAILURE = "failure"
+}

package/dist/modules/invoice/enums/cancel-status.enum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelStatusEnum = void 0;
+/**
+ * Статус операції скасування інвойсу.
+ * @enum {string}
+ */
+var CancelStatusEnum;
+(function (CancelStatusEnum) {
+    /**
+     * Заявка на скасування знаходиться в обробці.
+     */
+    CancelStatusEnum["PROCESSING"] = "processing";
+    /**
+     * Заявка на скасування виконана успішно.
+     */
+    CancelStatusEnum["SUCCESS"] = "success";
+    /**
+     * Неуспішна заявка на скасування.
+     */
+    CancelStatusEnum["FAILURE"] = "failure";
+})(CancelStatusEnum || (exports.CancelStatusEnum = CancelStatusEnum = {}));

package/dist/modules/invoice/enums/charge-status.enum.d.ts

@@ -0,0 +1,14 @@
+export declare enum ChargeStatusEnum {
+    /**
+     * Платіж обробляється.
+     */
+    PROCESSING = "processing",
+    /**
+     * Платіж успішний.
+     */
+    SUCCESS = "success",
+    /**
+     * Платіж неуспішний.
+     */
+    FAILURE = "failure"
+}

package/dist/modules/invoice/enums/charge-status.enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChargeStatusEnum = void 0;
+var ChargeStatusEnum;
+(function (ChargeStatusEnum) {
+    /**
+     * Платіж обробляється.
+     */
+    ChargeStatusEnum["PROCESSING"] = "processing";
+    /**
+     * Платіж успішний.
+     */
+    ChargeStatusEnum["SUCCESS"] = "success";
+    /**
+     * Платіж неуспішний.
+     */
+    ChargeStatusEnum["FAILURE"] = "failure";
+})(ChargeStatusEnum || (exports.ChargeStatusEnum = ChargeStatusEnum = {}));

package/dist/modules/invoice/enums/index.d.ts

@@ -0,0 +1,3 @@
+export * from './invoice-status.enum';
+export * from './cancel-status.enum';
+export * from './charge-status.enum';

package/dist/modules/invoice/enums/index.js

@@ -0,0 +1,19 @@
+"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("./invoice-status.enum"), exports);
+__exportStar(require("./cancel-status.enum"), exports);
+__exportStar(require("./charge-status.enum"), exports);

package/dist/modules/invoice/enums/invoice-status.enum.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Перечисление возможных статусов инвойса.
+ * @enum {string}
+ */
+export declare enum InvoiceStatusEnum {
+    /**
+     * Інвойс створено, очікується оплата.
+     */
+    CREATED = "created",
+    /**
+     * Платіж обробляється.
+     */
+    PROCESSING = "processing",
+    /**
+     * Сума заблокована.
+     */
+    HOLD = "hold",
+    /**
+     * Успішна оплата.
+     */
+    SUCCESS = "success",
+    /**
+     * Неуспішна оплата.
+     */
+    FAILURE = "failure",
+    /**
+     * Оплата повернена після успіху.
+     */
+    REVERSED = "reversed",
+    /**
+     * Час дії інвойсу вичерпано.
+     */
+    EXPIRED = "expired"
+}

package/dist/modules/invoice/enums/invoice-status.enum.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoiceStatusEnum = void 0;
+/**
+ * Перечисление возможных статусов инвойса.
+ * @enum {string}
+ */
+var InvoiceStatusEnum;
+(function (InvoiceStatusEnum) {
+    /**
+     * Інвойс створено, очікується оплата.
+     */
+    InvoiceStatusEnum["CREATED"] = "created";
+    /**
+     * Платіж обробляється.
+     */
+    InvoiceStatusEnum["PROCESSING"] = "processing";
+    /**
+     * Сума заблокована.
+     */
+    InvoiceStatusEnum["HOLD"] = "hold";
+    /**
+     * Успішна оплата.
+     */
+    InvoiceStatusEnum["SUCCESS"] = "success";
+    /**
+     * Неуспішна оплата.
+     */
+    InvoiceStatusEnum["FAILURE"] = "failure";
+    /**
+     * Оплата повернена після успіху.
+     */
+    InvoiceStatusEnum["REVERSED"] = "reversed";
+    /**
+     * Час дії інвойсу вичерпано.
+     */
+    InvoiceStatusEnum["EXPIRED"] = "expired";
+})(InvoiceStatusEnum || (exports.InvoiceStatusEnum = InvoiceStatusEnum = {}));

package/dist/modules/invoice/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './requests';
+export * from './responses';

package/dist/modules/invoice/interfaces/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("./requests"), exports);
+__exportStar(require("./responses"), exports);