@misterhomer1992/miit-bot-payment 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './modules/payments';
 export * from './modules/invoice';
+export * from './modules/subscription';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./modules/payments"), exports);
 __exportStar(require("./modules/invoice"), exports);
+__exportStar(require("./modules/subscription"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,oDAAkC;AAClC,yDAAuC"}

package/dist/modules/invoice/types.d.ts

@@ -5,8 +5,8 @@ type InvoiceEntity = {
     merchantSignature: string;
     reasonCode: number;
     reason: string;
-    createdDate: number;
-    processingDate: number;
+    createdDate: string;
+    processingDate: string;
     currency: string;
     amount: number;
 };

package/dist/modules/payments/api.d.ts

@@ -0,0 +1,34 @@
+import { AppNamespace } from '../app/types';
+/**
+ * Creates a payment API URL for regular purchases via Wayforpay.
+ * Generates a unique order reference and creates a payment URL with the provided parameters.
+ *
+ * @param params - Payment creation parameters
+ * @param params.userId - The unique identifier of the user making the payment
+ * @param params.appNamespace - The application namespace (e.g., 'app' or 'telegram')
+ * @param params.productName - The name of the product being purchased
+ * @param params.productPrice - The price of the product
+ * @param params.planId - The identifier of the subscription plan
+ * @param params.dateNext - Optional date for the next payment in the regular purchase cycle
+ * @param params.currency - The currency code (e.g., 'UAH', 'USD')
+ * @param params.regularCount - Optional number of regular payments (defaults to 3)
+ * @returns Promise resolving to an object containing the payment URL and order reference, or null
+ * @throws Error with code 'CREATE_PAYMENT_API' if the API response is invalid or missing URL
+ */
+declare function createPaymentAPI({ userId, appNamespace, productName, productPrice, planId, dateNext, currency, regularCount, regularMode, language, }: {
+    userId: string;
+    appNamespace: AppNamespace;
+    productName: string;
+    productPrice: number;
+    planId: string;
+    dateNext?: string;
+    currency: string;
+    regularCount?: number;
+    regularMode?: 'daily' | 'weekly' | 'monthly' | 'yearly';
+    language?: string;
+}): Promise<{
+    url: string;
+    orderReference: string;
+} | null>;
+export { createPaymentAPI };
+//# sourceMappingURL=api.d.ts.map

package/dist/modules/payments/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/api.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5C;;;;;;;;;;;;;;;GAeG;AACH,iBAAe,gBAAgB,CAAC,EAC5B,MAAM,EACN,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,YAAgB,EAChB,WAAqB,EACrB,QAAe,GAClB,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAoC1D;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/modules/payments/api.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPaymentAPI = createPaymentAPI;
+const moment_1 = __importDefault(require("moment"));
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - Package may not have type declarations
+const wayforpay_api_1 = require("@misterhomer1992/wayforpay-api");
+const utils_1 = require("../../utils");
+const utils_2 = require("./utils");
+/**
+ * Creates a payment API URL for regular purchases via Wayforpay.
+ * Generates a unique order reference and creates a payment URL with the provided parameters.
+ *
+ * @param params - Payment creation parameters
+ * @param params.userId - The unique identifier of the user making the payment
+ * @param params.appNamespace - The application namespace (e.g., 'app' or 'telegram')
+ * @param params.productName - The name of the product being purchased
+ * @param params.productPrice - The price of the product
+ * @param params.planId - The identifier of the subscription plan
+ * @param params.dateNext - Optional date for the next payment in the regular purchase cycle
+ * @param params.currency - The currency code (e.g., 'UAH', 'USD')
+ * @param params.regularCount - Optional number of regular payments (defaults to 3)
+ * @returns Promise resolving to an object containing the payment URL and order reference, or null
+ * @throws Error with code 'CREATE_PAYMENT_API' if the API response is invalid or missing URL
+ */
+async function createPaymentAPI({ userId, appNamespace, productName, productPrice, planId, dateNext, currency, regularCount = 3, regularMode = 'daily', language = 'UA', }) {
+    const orderDate = Date.now();
+    const formattedUtc = moment_1.default.utc().toISOString();
+    const orderReference = (0, utils_2.createOrderReference)({
+        userId,
+        appNamespace,
+        planId,
+        utcDate: formattedUtc,
+    });
+    const response = (await (0, wayforpay_api_1.generateRegularPurchaseUrl)({
+        merchantAccount: process.env.WAYFORPAY_MERCHANT_ACCOUNT,
+        merchantDomainName: process.env.WAYFORPAY_MERCHANT_DOMAIN,
+        merchantSecretKey: process.env.WAYFORPAY_MERCHANT_SECRET_KEY,
+        orderDate,
+        orderReference,
+        productName: [productName],
+        productPrice: [productPrice],
+        currency,
+        language,
+        serviceUrl: process.env.WAYFORPAY_SERVICE_URL,
+        regularMode,
+        regularCount,
+        dateNext,
+    }));
+    if (!(0, utils_1.isObject)(response) || (0, utils_1.isBadOrEmptyString)(response.url)) {
+        throw {
+            code: 'CREATE_PAYMENT_API',
+        };
+    }
+    return {
+        url: response.url,
+        orderReference,
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/modules/payments/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/modules/payments/api.ts"],"names":[],"mappings":";;;;;AAyFS,4CAAgB;AAzFzB,oDAA4B;AAC5B,6DAA6D;AAC7D,sDAAsD;AACtD,kEAA4E;AAE5E,uCAA2D;AAC3D,mCAA+C;AAO/C;;;;;;;;;;;;;;;GAeG;AACH,KAAK,UAAU,gBAAgB,CAAC,EAC5B,MAAM,EACN,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,YAAY,GAAG,CAAC,EAChB,WAAW,GAAG,OAAO,EACrB,QAAQ,GAAG,IAAI,GAYlB;IACG,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAG,gBAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,cAAc,GAAG,IAAA,4BAAoB,EAAC;QACxC,MAAM;QACN,YAAY;QACZ,MAAM;QACN,OAAO,EAAE,YAAY;KACxB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAA,0CAA0B,EAAC;QAC/C,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,0BAAoC;QACjE,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAmC;QACnE,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,6BAAuC;QACtE,SAAS;QACT,cAAc;QACd,WAAW,EAAE,CAAC,WAAW,CAAC;QAC1B,YAAY,EAAE,CAAC,YAAY,CAAC;QAC5B,QAAQ;QACR,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,qBAA+B;QACvD,WAAW;QACX,YAAY;QACZ,QAAQ;KACX,CAAC,CAAsB,CAAC;IAEzB,IAAI,CAAC,IAAA,gBAAQ,EAAC,QAAQ,CAAC,IAAI,IAAA,0BAAkB,EAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM;YACF,IAAI,EAAE,oBAAoB;SAC7B,CAAC;IACN,CAAC;IAED,OAAO;QACH,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,cAAc;KACjB,CAAC;AACN,CAAC"}

package/dist/modules/payments/index.d.ts

@@ -2,4 +2,5 @@ export * from './repository';
 export * from './service';
 export * from './types';
 export * from './const';
+export * from './api';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/payments/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/modules/payments/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./repository"), exports);
 __exportStar(require("./service"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./const"), exports);
+__exportStar(require("./api"), exports);
 //# sourceMappingURL=index.js.map

package/dist/modules/payments/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/payments/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/payments/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,wCAAsB"}

package/dist/modules/payments/service.d.ts

@@ -61,5 +61,36 @@ export declare class PaymentService {
     getExpiredPendingPayments(params?: {
         hoursOld?: number;
     }): Promise<PaymentEntity[]>;
+    /**
+     * Creates a payment intent for a user subscription.
+     * This method orchestrates the payment creation process by:
+     * 1. Creating a payment URL via Wayforpay API
+     * 2. Storing the payment record in the database
+     * 3. Returning the complete payment entity with the payment link
+     *
+     * @param params - Payment intent parameters
+     * @param params.userId - The unique identifier of the user
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.productName - The name of the product/plan being purchased
+     * @param params.productPrice - The price of the product
+     * @param params.currency - The currency code ('UAH' or 'USD')
+     * @param params.regularCount - Optional number of regular payments (defaults to 3)
+     * @param params.regularMode - Optional payment frequency ('daily', 'weekly', 'monthly', 'yearly')
+     * @param params.language - Optional language code for the payment page (defaults to 'UA')
+     * @returns Promise resolving to the created PaymentEntity with payment link
+     * @throws Error if payment URL generation or database creation fails
+     */
+    createPaymentIntent(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        planId: string;
+        productName: string;
+        productPrice: number;
+        currency: 'UAH' | 'USD';
+        regularCount?: number;
+        regularMode?: 'daily' | 'weekly' | 'monthly' | 'yearly';
+        language?: string;
+    }): Promise<PaymentEntity>;
 }
 //# sourceMappingURL=service.d.ts.map

package/dist/modules/payments/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAqB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAK1B;;;;OAIG;IACU,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAevF;;;;;;;OAOG;IACU,WAAW,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiB5B;;;;;OAKG;IACU,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBnF;;;;;;OAMG;IACU,YAAY,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3G;;;;;;OAMG;IACU,yBAAyB,CAClC,MAAM,GAAE;QACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;KAChB,GACP,OAAO,CAAC,aAAa,EAAE,CAAC;CAc9B"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAqB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAK1B;;;;OAIG;IACU,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAevF;;;;;;;OAOG;IACU,WAAW,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiB5B;;;;;OAKG;IACU,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBnF;;;;;;OAMG;IACU,YAAY,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3G;;;;;;OAMG;IACU,yBAAyB,CAClC,MAAM,GAAE;QACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;KAChB,GACP,OAAO,CAAC,aAAa,EAAE,CAAC;IAe3B;;;;;;;;;;;;;;;;;;;OAmBG;IACU,mBAAmB,CAAC,MAAM,EAAE;QACrC,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;QACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,aAAa,CAAC;CAgE7B"}

package/dist/modules/payments/service.js

@@ -1,7 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentService = void 0;
+const moment_1 = __importDefault(require("moment"));
 const repository_1 = require("./repository");
+const api_1 = require("./api");
 /**
  * PaymentService class handles business logic related to payments.
  * Acts as an intermediary between controllers/handlers and the repository layer.
@@ -127,6 +132,76 @@ class PaymentService {
             return [];
         }
     }
+    /**
+     * Creates a payment intent for a user subscription.
+     * This method orchestrates the payment creation process by:
+     * 1. Creating a payment URL via Wayforpay API
+     * 2. Storing the payment record in the database
+     * 3. Returning the complete payment entity with the payment link
+     *
+     * @param params - Payment intent parameters
+     * @param params.userId - The unique identifier of the user
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.productName - The name of the product/plan being purchased
+     * @param params.productPrice - The price of the product
+     * @param params.currency - The currency code ('UAH' or 'USD')
+     * @param params.regularCount - Optional number of regular payments (defaults to 3)
+     * @param params.regularMode - Optional payment frequency ('daily', 'weekly', 'monthly', 'yearly')
+     * @param params.language - Optional language code for the payment page (defaults to 'UA')
+     * @returns Promise resolving to the created PaymentEntity with payment link
+     * @throws Error if payment URL generation or database creation fails
+     */
+    async createPaymentIntent(params) {
+        const { userId, appNamespace, planId, productName, productPrice, currency, regularCount, regularMode, language, } = params;
+        try {
+            // Step 1: Create payment URL from Wayforpay API
+            // This also generates a unique order reference
+            const paymentResponse = await (0, api_1.createPaymentAPI)({
+                userId,
+                appNamespace,
+                productName,
+                productPrice,
+                planId,
+                currency,
+                regularCount,
+                regularMode,
+                language,
+            });
+            if (!paymentResponse?.url || !paymentResponse?.orderReference) {
+                throw new Error('Failed to get payment URL or order reference from Wayforpay');
+            }
+            // Step 2: Create payment record in database
+            const paymentEntity = await this.repository.create({
+                orderReference: paymentResponse.orderReference,
+                userId,
+                status: 'pending',
+                paymentLink: paymentResponse.url,
+                planId,
+                amount: productPrice,
+                currency,
+                createdAt: moment_1.default.utc().toISOString(),
+                platform: appNamespace,
+                provider: 'wayforpay',
+            });
+            return paymentEntity;
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in payment service createPaymentIntent',
+                payload: {
+                    userId,
+                    appNamespace,
+                    planId,
+                    productName,
+                    productPrice,
+                    currency,
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
 }
 exports.PaymentService = PaymentService;
 //# sourceMappingURL=service.js.map

package/dist/modules/payments/service.js.map

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

package/dist/modules/payments/utils.d.ts

@@ -0,0 +1,9 @@
+import { AppNamespace } from '../app/types';
+declare function createOrderReference({ userId, appNamespace, planId, utcDate, }: {
+    userId: string;
+    appNamespace: AppNamespace;
+    planId: string;
+    utcDate: string;
+}): string;
+export { createOrderReference };
+//# sourceMappingURL=utils.d.ts.map

package/dist/modules/payments/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/payments/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,iBAAS,oBAAoB,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,MAAM,EACN,OAAO,GACV,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAET;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/modules/payments/utils.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOrderReference = createOrderReference;
+function createOrderReference({ userId, appNamespace, planId, utcDate, }) {
+    return `miia_${appNamespace}_bot_${userId}_${planId}_v1_${utcDate}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/modules/payments/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/modules/payments/utils.ts"],"names":[],"mappings":";;AAgBS,oDAAoB;AAd7B,SAAS,oBAAoB,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,MAAM,EACN,OAAO,GAMV;IACG,OAAO,QAAQ,YAAY,QAAQ,MAAM,IAAI,MAAM,OAAO,OAAO,EAAE,CAAC;AACxE,CAAC"}

package/dist/modules/subscription/const.d.ts

@@ -0,0 +1,4 @@
+import { SubscriptionEntity } from './types';
+declare const DEFAULT_SUBSCRIPTION_ENTITY: Partial<SubscriptionEntity>;
+export { DEFAULT_SUBSCRIPTION_ENTITY };
+//# sourceMappingURL=const.d.ts.map

package/dist/modules/subscription/const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,QAAA,MAAM,2BAA2B,EAAE,OAAO,CAAC,kBAAkB,CAI5D,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/modules/subscription/const.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SUBSCRIPTION_ENTITY = void 0;
+const DEFAULT_SUBSCRIPTION_ENTITY = {
+    status: 'active',
+    platform: 'telegram',
+    provider: 'wayforpay',
+};
+exports.DEFAULT_SUBSCRIPTION_ENTITY = DEFAULT_SUBSCRIPTION_ENTITY;
+//# sourceMappingURL=const.js.map

package/dist/modules/subscription/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../../src/modules/subscription/const.ts"],"names":[],"mappings":";;;AAEA,MAAM,2BAA2B,GAAgC;IAC7D,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,WAAW;CACxB,CAAC;AAEO,kEAA2B"}

package/dist/modules/subscription/index.d.ts

@@ -0,0 +1,5 @@
+export * from './utils';
+export * from './types';
+export * from './service';
+export { SUBSCRIPTION_PLAN } from './subscriptionPlan';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/subscription/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/modules/subscription/index.js

@@ -0,0 +1,23 @@
+"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 });
+exports.SUBSCRIPTION_PLAN = void 0;
+__exportStar(require("./utils"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./service"), exports);
+var subscriptionPlan_1 = require("./subscriptionPlan");
+Object.defineProperty(exports, "SUBSCRIPTION_PLAN", { enumerable: true, get: function () { return subscriptionPlan_1.SUBSCRIPTION_PLAN; } });
+//# sourceMappingURL=index.js.map

package/dist/modules/subscription/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/subscription/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,4CAA0B;AAC1B,uDAAuD;AAA9C,qHAAA,iBAAiB,OAAA"}

package/dist/modules/subscription/repository.d.ts

@@ -0,0 +1,91 @@
+import { FieldValue } from 'firebase-admin/firestore';
+import { SubscriptionEntity, SubscriptionFieldPath } from './types';
+import { AppNamespace } from '../app/types';
+export type UpdateDBSubscriptionFields = [
+    SubscriptionFieldPath,
+    FieldValue | string | number | boolean | Date | [] | {}
+][];
+/**
+ * SubscriptionRepository class handles all database operations related to subscriptions.
+ * Implements repository pattern for subscription data access.
+ */
+export declare class SubscriptionRepository {
+    private readonly db;
+    private readonly collectionName;
+    /**
+     * Creates an instance of SubscriptionRepository.
+     */
+    constructor();
+    /**
+     * Retrieves an active subscription for a specific user.
+     * @param params - Query parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @returns Promise resolving to SubscriptionEntity or null if not found
+     */
+    getByUserId(params: {
+        userId: string;
+        appNamespace: string;
+    }): Promise<SubscriptionEntity | null>;
+    /**
+     * Creates a new subscription record in the database.
+     * @param params - Subscription creation parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.expiresAt - ISO timestamp when subscription expires
+     * @param params.startedAt - ISO timestamp when subscription started
+     * @returns Promise resolving to created SubscriptionEntity with ID
+     * @throws Error if subscription creation fails
+     */
+    create(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        planId: string;
+        expiresAt: string;
+        startedAt: string;
+    }): Promise<SubscriptionEntity>;
+    /**
+     * Updates specific fields of a subscription identified by userId and appNamespace.
+     * @param params - Update parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if subscription not found or update fails
+     */
+    updateFieldsByUserId(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        fields: UpdateDBSubscriptionFields;
+    }): Promise<void>;
+    /**
+     * Retrieves all active subscriptions that have expired.
+     * Used for batch processing to update subscription statuses.
+     * @returns Promise resolving to array of expired SubscriptionEntity
+     */
+    getExpiredActiveSubscriptions(): Promise<SubscriptionEntity[]>;
+    /**
+     * Updates specific fields of a subscription identified by subscription ID.
+     * @param params - Update parameters
+     * @param params.subscriptionId - The subscription document ID
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if update fails
+     */
+    updateFieldsById(params: {
+        subscriptionId: string;
+        fields: UpdateDBSubscriptionFields;
+    }): Promise<void>;
+    /**
+     * Maps a Firestore document to a SubscriptionEntity.
+     * @param doc - Firestore document snapshot
+     * @returns SubscriptionEntity with document ID
+     */
+    private mapDocumentToEntity;
+    /**
+     * Builds an update object from field tuples.
+     * @param fields - Array of field paths and values
+     * @returns Object with field paths as keys and values to update
+     */
+    private buildUpdateObject;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/modules/subscription/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAkD,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,0BAA0B,GAAG;IACrC,qBAAqB;IACrB,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE;CAC1D,EAAE,CAAC;AAEJ;;;GAGG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAElD;;OAEG;;IAKH;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAmB9G;;;;;;;;;;OAUG;IACU,MAAM,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwB/B;;;;;;;OAOG;IACU,oBAAoB,CAAC,MAAM,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,0BAA0B,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjB;;;;OAIG;IACU,6BAA6B,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgB3E;;;;;;OAMG;IACU,gBAAgB,CAAC,MAAM,EAAE;QAClC,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,0BAA0B,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAS5B"}

package/dist/modules/subscription/repository.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionRepository = void 0;
+const firestore_1 = require("firebase-admin/firestore");
+const const_1 = require("./const");
+/**
+ * SubscriptionRepository class handles all database operations related to subscriptions.
+ * Implements repository pattern for subscription data access.
+ */
+class SubscriptionRepository {
+    /**
+     * Creates an instance of SubscriptionRepository.
+     */
+    constructor() {
+        this.collectionName = 'subscriptions';
+        this.db = (0, firestore_1.getFirestore)();
+    }
+    /**
+     * Retrieves an active subscription for a specific user.
+     * @param params - Query parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @returns Promise resolving to SubscriptionEntity or null if not found
+     */
+    async getByUserId(params) {
+        const { userId, appNamespace } = params;
+        const querySnapshot = await this.db
+            .collection(this.collectionName)
+            .where('platform', '==', appNamespace)
+            .where('userId', '==', userId)
+            .where('status', '==', 'active')
+            .limit(1)
+            .get();
+        if (querySnapshot.empty) {
+            return null;
+        }
+        const doc = querySnapshot.docs[0];
+        return this.mapDocumentToEntity(doc);
+    }
+    /**
+     * Creates a new subscription record in the database.
+     * @param params - Subscription creation parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.expiresAt - ISO timestamp when subscription expires
+     * @param params.startedAt - ISO timestamp when subscription started
+     * @returns Promise resolving to created SubscriptionEntity with ID
+     * @throws Error if subscription creation fails
+     */
+    async create(params) {
+        const { userId, appNamespace, planId, expiresAt, startedAt } = params;
+        const subscriptionEntity = {
+            ...const_1.DEFAULT_SUBSCRIPTION_ENTITY,
+            userId,
+            platform: appNamespace,
+            planId,
+            expiresAt,
+            startedAt,
+        };
+        const docRef = await this.db.collection(this.collectionName).add(subscriptionEntity);
+        if (!docRef.id) {
+            throw new Error(`Failed to create subscription for userId: ${userId}`);
+        }
+        return {
+            id: docRef.id,
+            ...subscriptionEntity,
+        };
+    }
+    /**
+     * Updates specific fields of a subscription identified by userId and appNamespace.
+     * @param params - Update parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if subscription not found or update fails
+     */
+    async updateFieldsByUserId(params) {
+        const { userId, appNamespace, fields } = params;
+        const updateObject = this.buildUpdateObject(fields);
+        const querySnapshot = await this.db
+            .collection(this.collectionName)
+            .where('platform', '==', appNamespace)
+            .where('userId', '==', userId)
+            .limit(1)
+            .get();
+        if (querySnapshot.empty) {
+            throw new Error(`Subscription not found for userId: ${userId}`);
+        }
+        await querySnapshot.docs[0].ref.update(updateObject);
+    }
+    /**
+     * Retrieves all active subscriptions that have expired.
+     * Used for batch processing to update subscription statuses.
+     * @returns Promise resolving to array of expired SubscriptionEntity
+     */
+    async getExpiredActiveSubscriptions() {
+        const now = new Date().toISOString();
+        const querySnapshot = await this.db
+            .collection(this.collectionName)
+            .where('status', '==', 'active')
+            .where('expiresAt', '<', now)
+            .get();
+        if (querySnapshot.empty) {
+            return [];
+        }
+        return querySnapshot.docs.map((doc) => this.mapDocumentToEntity(doc));
+    }
+    /**
+     * Updates specific fields of a subscription identified by subscription ID.
+     * @param params - Update parameters
+     * @param params.subscriptionId - The subscription document ID
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if update fails
+     */
+    async updateFieldsById(params) {
+        const { subscriptionId, fields } = params;
+        const updateObject = this.buildUpdateObject(fields);
+        await this.db.collection(this.collectionName).doc(subscriptionId).update(updateObject);
+    }
+    /**
+     * Maps a Firestore document to a SubscriptionEntity.
+     * @param doc - Firestore document snapshot
+     * @returns SubscriptionEntity with document ID
+     */
+    mapDocumentToEntity(doc) {
+        return {
+            id: doc.id,
+            ...doc.data(),
+        };
+    }
+    /**
+     * Builds an update object from field tuples.
+     * @param fields - Array of field paths and values
+     * @returns Object with field paths as keys and values to update
+     */
+    buildUpdateObject(fields) {
+        const updateObject = {};
+        fields.forEach(([fieldPath, value]) => {
+            updateObject[fieldPath] = value;
+        });
+        return updateObject;
+    }
+}
+exports.SubscriptionRepository = SubscriptionRepository;
+//# sourceMappingURL=repository.js.map

package/dist/modules/subscription/repository.js.map

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

package/dist/modules/subscription/service.d.ts

@@ -0,0 +1,101 @@
+import { Logger } from '../logger/types';
+import { UpdateDBSubscriptionFields } from './repository';
+import { SubscriptionEntity } from './types';
+import { AppNamespace } from '../app/types';
+/**
+ * SubscriptionService class handles business logic related to subscriptions.
+ * Acts as an intermediary between controllers/handlers and the repository layer.
+ */
+export declare class SubscriptionService {
+    private readonly logger;
+    private readonly repository;
+    private readonly paymentService;
+    /**
+     * Creates an instance of SubscriptionService.
+     * @param logger - Application logger instance for logging operations
+     */
+    constructor(logger: Logger);
+    /**
+     * Retrieves an active subscription for a specific user.
+     * @param params - Query parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @returns Promise resolving to SubscriptionEntity or null if not found
+     */
+    getByUserId(params: {
+        userId: string;
+        appNamespace: string;
+    }): Promise<SubscriptionEntity | null>;
+    /**
+     * Creates a new subscription record in the database.
+     * @param params - Subscription creation parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.expiresAt - ISO timestamp when subscription expires
+     * @param params.startedAt - ISO timestamp when subscription started
+     * @returns Promise resolving to created SubscriptionEntity with ID
+     * @throws Error if subscription creation fails
+     */
+    create(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        planId: string;
+        expiresAt: string;
+        startedAt: string;
+    }): Promise<SubscriptionEntity>;
+    /**
+     * Updates specific fields of a subscription identified by userId and appNamespace.
+     * @param params - Update parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if subscription not found or update fails
+     */
+    updateFieldsByUserId(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        fields: UpdateDBSubscriptionFields;
+    }): Promise<void>;
+    /**
+     * Retrieves all active subscriptions that have expired.
+     * Used for batch processing to update subscription statuses.
+     * @returns Promise resolving to array of expired SubscriptionEntity
+     */
+    getExpiredActiveSubscriptions(): Promise<SubscriptionEntity[]>;
+    /**
+     * Updates specific fields of a subscription identified by subscription ID.
+     * @param params - Update parameters
+     * @param params.subscriptionId - The subscription document ID
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if update fails
+     */
+    updateFieldsById(params: {
+        subscriptionId: string;
+        fields: UpdateDBSubscriptionFields;
+    }): Promise<void>;
+    /**
+     * Gets or creates a subscription payment URL.
+     * Checks for recent pending payments (within 3 minutes) and reuses the payment link if found.
+     * Otherwise creates a new payment intent for the subscription.
+     * @param params - Payment URL creation parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.languageCode - Language code for translations
+     * @param params.translate - Translation function
+     * @returns Promise resolving to the payment URL string
+     * @throws Error if subscription plan not found or payment creation fails
+     */
+    getOrCreateSubscriptionPaymentUrl(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        planId: string;
+        languageCode: string;
+        translate: (params: {
+            code: string;
+            path: string;
+        }) => string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/subscription/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAA0B,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEhD;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAM1B;;;;;;OAMG;IACU,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAgB9G;;;;;;;;;;OAUG;IACU,MAAM,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkB/B;;;;;;;OAOG;IACU,oBAAoB,CAAC,MAAM,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,0BAA0B,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjB;;;;OAIG;IACU,6BAA6B,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAc3E;;;;;;OAMG;IACU,gBAAgB,CAAC,MAAM,EAAE;QAClC,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,0BAA0B,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjB;;;;;;;;;;;;OAYG;IACU,iCAAiC,CAAC,MAAM,EAAE;QACnD,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;KACjE,GAAG,OAAO,CAAC,MAAM,CAAC;CAwDtB"}

package/dist/modules/subscription/service.js

@@ -0,0 +1,205 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionService = void 0;
+const moment_1 = __importDefault(require("moment"));
+const repository_1 = require("./repository");
+const utils_1 = require("./utils");
+const service_1 = require("../payments/service");
+/**
+ * SubscriptionService class handles business logic related to subscriptions.
+ * Acts as an intermediary between controllers/handlers and the repository layer.
+ */
+class SubscriptionService {
+    /**
+     * Creates an instance of SubscriptionService.
+     * @param logger - Application logger instance for logging operations
+     */
+    constructor(logger) {
+        this.logger = logger;
+        this.repository = new repository_1.SubscriptionRepository();
+        this.paymentService = new service_1.PaymentService(logger);
+    }
+    /**
+     * Retrieves an active subscription for a specific user.
+     * @param params - Query parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @returns Promise resolving to SubscriptionEntity or null if not found
+     */
+    async getByUserId(params) {
+        try {
+            return await this.repository.getByUserId(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in subscription service getByUserId',
+                payload: {
+                    userId: params.userId,
+                    appNamespace: params.appNamespace,
+                    error: JSON.stringify(error),
+                },
+            });
+            return null;
+        }
+    }
+    /**
+     * Creates a new subscription record in the database.
+     * @param params - Subscription creation parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.expiresAt - ISO timestamp when subscription expires
+     * @param params.startedAt - ISO timestamp when subscription started
+     * @returns Promise resolving to created SubscriptionEntity with ID
+     * @throws Error if subscription creation fails
+     */
+    async create(params) {
+        try {
+            return await this.repository.create(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in subscription service create',
+                payload: {
+                    userId: params.userId,
+                    appNamespace: params.appNamespace,
+                    planId: params.planId,
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Updates specific fields of a subscription identified by userId and appNamespace.
+     * @param params - Update parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if subscription not found or update fails
+     */
+    async updateFieldsByUserId(params) {
+        try {
+            await this.repository.updateFieldsByUserId(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in subscription service updateFieldsByUserId',
+                payload: {
+                    userId: params.userId,
+                    appNamespace: params.appNamespace,
+                    fields: JSON.stringify(params.fields),
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Retrieves all active subscriptions that have expired.
+     * Used for batch processing to update subscription statuses.
+     * @returns Promise resolving to array of expired SubscriptionEntity
+     */
+    async getExpiredActiveSubscriptions() {
+        try {
+            return await this.repository.getExpiredActiveSubscriptions();
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in subscription service getExpiredActiveSubscriptions',
+                payload: {
+                    error: JSON.stringify(error),
+                },
+            });
+            return [];
+        }
+    }
+    /**
+     * Updates specific fields of a subscription identified by subscription ID.
+     * @param params - Update parameters
+     * @param params.subscriptionId - The subscription document ID
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if update fails
+     */
+    async updateFieldsById(params) {
+        try {
+            await this.repository.updateFieldsById(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in subscription service updateFieldsById',
+                payload: {
+                    subscriptionId: params.subscriptionId,
+                    fields: JSON.stringify(params.fields),
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Gets or creates a subscription payment URL.
+     * Checks for recent pending payments (within 3 minutes) and reuses the payment link if found.
+     * Otherwise creates a new payment intent for the subscription.
+     * @param params - Payment URL creation parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.planId - The subscription plan identifier
+     * @param params.languageCode - Language code for translations
+     * @param params.translate - Translation function
+     * @returns Promise resolving to the payment URL string
+     * @throws Error if subscription plan not found or payment creation fails
+     */
+    async getOrCreateSubscriptionPaymentUrl(params) {
+        try {
+            // Check for existing pending payments for this plan
+            const existingPayments = await this.paymentService.getByUserId({
+                userId: params.userId,
+                appNamespace: params.appNamespace,
+                status: 'pending',
+            });
+            const recentPayment = existingPayments
+                .filter((payment) => payment.planId === params.planId)
+                .find((payment) => moment_1.default.utc().diff(moment_1.default.utc(payment.createdAt), 'minutes') < 10);
+            if (recentPayment && recentPayment.paymentLink) {
+                return recentPayment.paymentLink;
+            }
+            const subscriptionPlan = (0, utils_1.getSubscriptionById)(params.planId);
+            if (!subscriptionPlan) {
+                throw new Error(`Subscription plan not found: ${params.planId}`);
+            }
+            const productName = (0, utils_1.getSubscriptionTitle)(params.translate({
+                code: params.languageCode,
+                path: subscriptionPlan.titleCode,
+            }));
+            const paymentEntity = await this.paymentService.createPaymentIntent({
+                userId: params.userId,
+                appNamespace: params.appNamespace,
+                planId: subscriptionPlan.id,
+                productName,
+                productPrice: subscriptionPlan.amount,
+                currency: subscriptionPlan.currency,
+                language: params.languageCode,
+                regularMode: subscriptionPlan.regularMode,
+            });
+            return paymentEntity.paymentLink;
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in subscription service getOrCreateSubscriptionPaymentUrl',
+                payload: {
+                    userId: params.userId,
+                    appNamespace: params.appNamespace,
+                    planId: params.planId,
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
+}
+exports.SubscriptionService = SubscriptionService;
+//# sourceMappingURL=service.js.map

package/dist/modules/subscription/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/modules/subscription/service.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAE5B,6CAAkF;AAGlF,mCAAoE;AACpE,iDAAqD;AAErD;;;GAGG;AACH,MAAa,mBAAmB;IAK5B;;;OAGG;IACH,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,mCAAsB,EAAE,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,IAAI,wBAAc,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,WAAW,CAAC,MAAgD;QACrE,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,2CAA2C;gBACpD,OAAO,EAAE;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,MAAM,CAAC,MAMnB;QACG,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,sCAAsC;gBAC/C,OAAO,EAAE;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,oBAAoB,CAAC,MAIjC;QACG,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,oDAAoD;gBAC7D,OAAO,EAAE;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;oBACrC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,6BAA6B;QACtC,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,6DAA6D;gBACtE,OAAO,EAAE;oBACL,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAG7B;QACG,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,gDAAgD;gBACzD,OAAO,EAAE;oBACL,cAAc,EAAE,MAAM,CAAC,cAAc;oBACrC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;oBACrC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,iCAAiC,CAAC,MAM9C;QACG,IAAI,CAAC;YACD,oDAAoD;YACpD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;gBAC3D,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,MAAM,EAAE,SAAS;aACpB,CAAC,CAAC;YAEH,MAAM,aAAa,GAAG,gBAAgB;iBACjC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;iBACrD,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAM,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;YAEzF,IAAI,aAAa,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;gBAC7C,OAAO,aAAa,CAAC,WAAW,CAAC;YACrC,CAAC;YAED,MAAM,gBAAgB,GAAG,IAAA,2BAAmB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE5D,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,WAAW,GAAG,IAAA,4BAAoB,EACpC,MAAM,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,MAAM,CAAC,YAAY;gBACzB,IAAI,EAAE,gBAAgB,CAAC,SAAS;aACnC,CAAC,CACL,CAAC;YAEF,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC;gBAChE,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,MAAM,EAAE,gBAAgB,CAAC,EAAE;gBAC3B,WAAW;gBACX,YAAY,EAAE,gBAAgB,CAAC,MAAM;gBACrC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;gBACnC,QAAQ,EAAE,MAAM,CAAC,YAAY;gBAC7B,WAAW,EAAE,gBAAgB,CAAC,WAAW;aAC5C,CAAC,CAAC;YAEH,OAAO,aAAa,CAAC,WAAW,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,OAAO,EAAE,iEAAiE;gBAC1E,OAAO,EAAE;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ;AAhOD,kDAgOC"}

package/dist/modules/subscription/subscriptionPlan.d.ts

@@ -0,0 +1,4 @@
+import { SubscriptionPlan } from './types';
+declare const SUBSCRIPTION_PLAN: SubscriptionPlan[];
+export { SUBSCRIPTION_PLAN };
+//# sourceMappingURL=subscriptionPlan.d.ts.map

package/dist/modules/subscription/subscriptionPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionPlan.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/subscriptionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,QAAA,MAAM,iBAAiB,EAAE,gBAAgB,EAyDxC,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/modules/subscription/subscriptionPlan.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUBSCRIPTION_PLAN = void 0;
+const SUBSCRIPTION_PLAN = [
+    {
+        id: 'basic',
+        titleCode: 'subscription.plan.1.title',
+        descriptionCode: 'subscription.plan.1.description',
+        amount: 7,
+        currency: 'UAH',
+        features: {
+            messages: 1000,
+            images: 0,
+            voice: 50,
+            study: 2,
+        },
+        regularMode: 'monthly',
+    },
+    {
+        id: 'pro',
+        titleCode: 'subscription.plan.2.title',
+        descriptionCode: 'subscription.plan.2.description',
+        amount: 10,
+        currency: 'UAH',
+        features: {
+            messages: 2000,
+            images: 20,
+            voice: 50,
+            study: 2,
+        },
+        regularMode: 'monthly',
+    },
+    {
+        id: 'basic-daily',
+        titleCode: 'subscription.plan.3.title',
+        descriptionCode: 'subscription.plan.1.description',
+        amount: 7,
+        currency: 'UAH',
+        features: {
+            messages: 10,
+            images: 0,
+            voice: 50,
+            study: 2,
+        },
+        regularMode: 'daily',
+    },
+    {
+        id: 'pro-daily',
+        titleCode: 'subscription.plan.3.title',
+        descriptionCode: 'subscription.plan.2.description',
+        amount: 10,
+        currency: 'UAH',
+        features: {
+            messages: 20,
+            images: 20,
+            voice: 50,
+            study: 2,
+        },
+        regularMode: 'daily',
+    },
+];
+exports.SUBSCRIPTION_PLAN = SUBSCRIPTION_PLAN;
+//# sourceMappingURL=subscriptionPlan.js.map

package/dist/modules/subscription/subscriptionPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionPlan.js","sourceRoot":"","sources":["../../../src/modules/subscription/subscriptionPlan.ts"],"names":[],"mappings":";;;AAEA,MAAM,iBAAiB,GAAuB;IAC1C;QACI,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,2BAA2B;QACtC,eAAe,EAAE,iCAAiC;QAClD,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC;SACX;QACD,WAAW,EAAE,SAAS;KACzB;IACD;QACI,EAAE,EAAE,KAAK;QACT,SAAS,EAAE,2BAA2B;QACtC,eAAe,EAAE,iCAAiC;QAClD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC;SACX;QACD,WAAW,EAAE,SAAS;KACzB;IACD;QACI,EAAE,EAAE,aAAa;QACjB,SAAS,EAAE,2BAA2B;QACtC,eAAe,EAAE,iCAAiC;QAClD,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE;YACN,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC;SACX;QACD,WAAW,EAAE,OAAO;KACvB;IACD;QACI,EAAE,EAAE,WAAW;QACf,SAAS,EAAE,2BAA2B;QACtC,eAAe,EAAE,iCAAiC;QAClD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE;YACN,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,CAAC;SACX;QACD,WAAW,EAAE,OAAO;KACvB;CACJ,CAAC;AAEO,8CAAiB"}

package/dist/modules/subscription/types.d.ts

@@ -0,0 +1,37 @@
+import { NestedPathsAccess } from '../../types/utilities';
+import { AppNamespace } from '../app/types';
+type SubscriptionEntity = {
+    /** Auto-generated unique ID (document ID) */
+    id?: string;
+    /** The Telegram User ID this subscription belongs to. Links back to users. */
+    userId: string;
+    /** An identifier for the subscription plan (e.g., "basic-daily", "pro-monthly") */
+    planId: string;
+    /** The lifecycle state of this service period */
+    status: 'active' | 'expired' | 'cancelled';
+    /** The key field for the cron job. Timestamp when this paid-for period ends. */
+    expiresAt: string;
+    /** Timestamp when this period began */
+    startedAt: string;
+    /** Platform/app namespace */
+    platform: AppNamespace;
+    /** Payment provider */
+    provider: 'wayforpay';
+};
+type SubscriptionPlan = {
+    id: string;
+    titleCode: string;
+    descriptionCode: string;
+    amount: number;
+    currency: 'UAH' | 'USD';
+    features: {
+        messages: number;
+        images: number;
+        voice: number;
+        study: number;
+    };
+    regularMode: 'daily' | 'monthly' | 'yearly';
+};
+type SubscriptionFieldPath = NestedPathsAccess<SubscriptionEntity>;
+export type { SubscriptionEntity, SubscriptionPlan, SubscriptionFieldPath };
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/subscription/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,KAAK,kBAAkB,GAAG;IACtB,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3C,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,uBAAuB;IACvB,QAAQ,EAAE,WAAW,CAAC;CACzB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;IACxB,QAAQ,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC/C,CAAC;AAEF,KAAK,qBAAqB,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;AAEnE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/modules/subscription/types.js

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

package/dist/modules/subscription/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/subscription/types.ts"],"names":[],"mappings":""}

package/dist/modules/subscription/utils.d.ts

@@ -0,0 +1,5 @@
+declare function getSubscriptionById(planId: string): import("./types").SubscriptionPlan;
+declare function getSubscriptionTitle(planTitle: string): string;
+declare function subscriptionPlanExists(planId: string): boolean;
+export { getSubscriptionById, getSubscriptionTitle, subscriptionPlanExists };
+//# sourceMappingURL=utils.d.ts.map

package/dist/modules/subscription/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/subscription/utils.ts"],"names":[],"mappings":"AAEA,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,sCAE1C;AAED,iBAAS,oBAAoB,CAAC,SAAS,EAAE,MAAM,UAE9C;AAED,iBAAS,sBAAsB,CAAC,MAAM,EAAE,MAAM,WAE7C;AAED,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/modules/subscription/utils.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSubscriptionById = getSubscriptionById;
+exports.getSubscriptionTitle = getSubscriptionTitle;
+exports.subscriptionPlanExists = subscriptionPlanExists;
+const subscriptionPlan_1 = require("./subscriptionPlan");
+function getSubscriptionById(planId) {
+    return subscriptionPlan_1.SUBSCRIPTION_PLAN.find((plan) => plan.id === planId);
+}
+function getSubscriptionTitle(planTitle) {
+    return `Miia telegram bot: ${planTitle}`;
+}
+function subscriptionPlanExists(planId) {
+    return subscriptionPlan_1.SUBSCRIPTION_PLAN.some((plan) => plan.id === planId);
+}
+//# sourceMappingURL=utils.js.map

package/dist/modules/subscription/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/modules/subscription/utils.ts"],"names":[],"mappings":";;AAcS,kDAAmB;AAAE,oDAAoB;AAAE,wDAAsB;AAd1E,yDAAuD;AAEvD,SAAS,mBAAmB,CAAC,MAAc;IACvC,OAAO,oCAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC3C,OAAO,sBAAsB,SAAS,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC1C,OAAO,oCAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@misterhomer1992/miit-bot-payment",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "description": "A TypeScript utility library for payment validation and formatting",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -28,7 +28,8 @@
         "moment": "2.30.1",
         "dotenv": "17.2.2",
         "axios": "1.12.2",
-        "firebase-admin": "^11.6.0"
+        "firebase-admin": "^11.6.0",
+        "@misterhomer1992/wayforpay-api": "2.0.1"
     },
     "devDependencies": {
         "@types/node": "^20.10.0",