@misterhomer1992/miit-bot-payment 1.0.1 → 1.0.3

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

@@ -0,0 +1,96 @@
+import { Logger } from '../logger/types';
+import { UpdateDBPaymentFields } from './repository';
+import { PaymentEntity } from './types';
+import { AppNamespace } from '../app/types';
+/**
+ * PaymentService class handles business logic related to payments.
+ * Acts as an intermediary between controllers/handlers and the repository layer.
+ */
+export declare class PaymentService {
+    private readonly logger;
+    private readonly repository;
+    /**
+     * Creates an instance of PaymentService.
+     * @param logger - Application logger instance for logging operations
+     */
+    constructor(logger: Logger);
+    /**
+     * Retrieves a payment by its order reference.
+     * @param orderReference - The unique order reference identifier
+     * @returns Promise resolving to PaymentEntity or null if not found
+     */
+    getByOrderReference(orderReference: string): Promise<PaymentEntity | null>;
+    /**
+     * Retrieves all payments for a specific user.
+     * @param params - Query parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.status - Optional payment status filter
+     * @returns Promise resolving to array of PaymentEntity
+     */
+    getByUserId(params: {
+        userId: string;
+        appNamespace: AppNamespace;
+        status?: PaymentEntity['status'];
+    }): Promise<PaymentEntity[]>;
+    /**
+     * Creates a new payment record in the database.
+     * @param paymentData - Payment data without ID (ID will be auto-generated)
+     * @returns Promise resolving to created PaymentEntity with ID
+     * @throws Error if payment creation fails
+     */
+    create(paymentData: Omit<PaymentEntity, 'id'>): Promise<PaymentEntity>;
+    /**
+     * Updates specific fields of a payment identified by order reference.
+     * @param params - Update parameters
+     * @param params.orderReference - The order reference to identify the payment
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if payment not found or update fails
+     */
+    updateFields(params: {
+        orderReference: string;
+        fields: UpdateDBPaymentFields;
+    }): Promise<void>;
+    /**
+     * Retrieves all pending payments that are older than specified hours.
+     * Used for cleaning up expired payment attempts.
+     * @param params - Query parameters
+     * @param params.hoursOld - Number of hours after which a pending payment is considered expired (default: 24)
+     * @returns Promise resolving to array of expired PaymentEntity
+     */
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,207 @@
+"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.
+ */
+class PaymentService {
+    /**
+     * Creates an instance of PaymentService.
+     * @param logger - Application logger instance for logging operations
+     */
+    constructor(logger) {
+        this.logger = logger;
+        this.repository = new repository_1.PaymentRepository();
+    }
+    /**
+     * Retrieves a payment by its order reference.
+     * @param orderReference - The unique order reference identifier
+     * @returns Promise resolving to PaymentEntity or null if not found
+     */
+    async getByOrderReference(orderReference) {
+        try {
+            return await this.repository.getByOrderReference(orderReference);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in payment service getByOrderReference',
+                payload: {
+                    orderReference,
+                    error: JSON.stringify(error),
+                },
+            });
+            return null;
+        }
+    }
+    /**
+     * Retrieves all payments for a specific user.
+     * @param params - Query parameters
+     * @param params.userId - The user's unique identifier
+     * @param params.appNamespace - The application namespace/platform
+     * @param params.status - Optional payment status filter
+     * @returns Promise resolving to array of PaymentEntity
+     */
+    async getByUserId(params) {
+        try {
+            return await this.repository.getByUserId(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in payment service getByUserId',
+                payload: {
+                    userId: params.userId,
+                    appNamespace: params.appNamespace,
+                    status: params.status,
+                    error: JSON.stringify(error),
+                },
+            });
+            return [];
+        }
+    }
+    /**
+     * Creates a new payment record in the database.
+     * @param paymentData - Payment data without ID (ID will be auto-generated)
+     * @returns Promise resolving to created PaymentEntity with ID
+     * @throws Error if payment creation fails
+     */
+    async create(paymentData) {
+        try {
+            return await this.repository.create(paymentData);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in payment service create',
+                payload: {
+                    orderReference: paymentData.orderReference,
+                    userId: paymentData.userId,
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Updates specific fields of a payment identified by order reference.
+     * @param params - Update parameters
+     * @param params.orderReference - The order reference to identify the payment
+     * @param params.fields - Array of field paths and values to update
+     * @throws Error if payment not found or update fails
+     */
+    async updateFields(params) {
+        try {
+            await this.repository.updateFields(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in payment service updateFields',
+                payload: {
+                    orderReference: params.orderReference,
+                    fields: JSON.stringify(params.fields),
+                    error: JSON.stringify(error),
+                },
+            });
+            throw error;
+        }
+    }
+    /**
+     * Retrieves all pending payments that are older than specified hours.
+     * Used for cleaning up expired payment attempts.
+     * @param params - Query parameters
+     * @param params.hoursOld - Number of hours after which a pending payment is considered expired (default: 24)
+     * @returns Promise resolving to array of expired PaymentEntity
+     */
+    async getExpiredPendingPayments(params = {}) {
+        try {
+            return await this.repository.getExpiredPendingPayments(params);
+        }
+        catch (error) {
+            this.logger.error({
+                message: 'Error in payment service getExpiredPendingPayments',
+                payload: {
+                    hoursOld: params.hoursOld,
+                    error: JSON.stringify(error),
+                },
+            });
+            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

@@ -0,0 +1 @@
+{"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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"}