@misterhomer1992/miit-bot-payment 1.0.2 → 1.0.4

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":"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"}

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/dist/modules/user/index.d.ts

@@ -0,0 +1,4 @@
+export * from './userRepository';
+export * from './userService';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/user/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC"}