@neocleus/razorpay-firebase-functions 1.0.0

package/lib/triggers/syncClaims.js

@@ -0,0 +1,92 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSyncClaimsOnSubscriptionChange = void 0;
+const firestore_1 = require("firebase-functions/v2/firestore");
+const admin = __importStar(require("firebase-admin"));
+const logs_1 = require("../logs");
+const buildSyncClaimsOnSubscriptionChange = (config) => {
+    const syncClaimsHandler = async (event) => {
+        if (!config.syncCustomClaims) {
+            return;
+        }
+        const uid = event.params.uid;
+        try {
+            const allSubsSnap = await admin.firestore()
+                .collection(config.customersCollection)
+                .doc(uid)
+                .collection('subscriptions')
+                .get();
+            const activeRoles = new Set();
+            const allRazorpayRoles = new Set();
+            allSubsSnap.forEach(doc => {
+                const data = doc.data();
+                const role = data.firebaseRole;
+                const status = data.status;
+                if (role && typeof role === 'string') {
+                    allRazorpayRoles.add(role);
+                    if (status === 'active' || status === 'authenticated') {
+                        activeRoles.add(role);
+                    }
+                }
+            });
+            const userRec = await admin.auth().getUser(uid);
+            const mergedClaims = { ...(userRec.customClaims || {}) };
+            let updated = false;
+            allRazorpayRoles.forEach(role => {
+                if (!activeRoles.has(role) && mergedClaims[role]) {
+                    delete mergedClaims[role];
+                    updated = true;
+                }
+            });
+            activeRoles.forEach(role => {
+                if (!mergedClaims[role]) {
+                    mergedClaims[role] = true;
+                    updated = true;
+                }
+            });
+            if (updated) {
+                await admin.auth().setCustomUserClaims(uid, mergedClaims);
+                logs_1.logs.info(`Synced claims for ${uid}: [${Object.keys(mergedClaims).join(', ')}]`);
+            }
+        }
+        catch (error) {
+            logs_1.logs.error(new Error(`Failed to sync claims for ${uid}: ${error.message}`));
+        }
+    };
+    return (0, firestore_1.onDocumentWritten)(`${config.customersCollection}/{uid}/subscriptions/{subscriptionId}`, syncClaimsHandler);
+};
+exports.buildSyncClaimsOnSubscriptionChange = buildSyncClaimsOnSubscriptionChange;
+//# sourceMappingURL=syncClaims.js.map

package/lib/triggers/syncClaims.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,43 @@
+import * as admin from 'firebase-admin';
+import * as Shared from '@neocleus/razorpay-firebase-types';
+export type SanitizedPlan = Shared.SanitizedPlan<admin.firestore.FieldValue, admin.firestore.Timestamp>;
+export type ProductDoc = Shared.ProductDoc<admin.firestore.FieldValue, admin.firestore.Timestamp>;
+export type CustomerDoc = Shared.CustomerDoc<admin.firestore.FieldValue, admin.firestore.Timestamp>;
+export type CheckoutSessionDoc = Shared.CheckoutSessionDoc<admin.firestore.FieldValue, admin.firestore.Timestamp>;
+export type SubscriptionDoc = Shared.SubscriptionDoc<admin.firestore.FieldValue, admin.firestore.Timestamp>;
+export type WebhookEventDoc = Shared.WebhookEventDoc<admin.firestore.FieldValue, admin.firestore.Timestamp>;
+export interface RazorpayUserConfig {
+    keyId: string;
+    keySecret: string;
+    webhookSecret: string;
+    customersCollection?: string;
+    productsCollection?: string;
+    syncCustomers?: boolean;
+    eventarcChannel?: string;
+    allowedEventTypes?: string[];
+}
+export interface RazorpaySyncConfig {
+    keyId: string;
+    keySecret: string;
+    webhookSecret: string;
+    customersCollection: string;
+    productsCollection: string;
+    syncCustomers: boolean;
+    eventarcChannel?: string;
+    allowedEventTypes?: string[];
+}
+export interface WebhookEntityWrapper {
+    entity?: Record<string, any>;
+    id?: string;
+}
+export interface WebhookPayload {
+    payment?: WebhookEntityWrapper;
+    order?: WebhookEntityWrapper;
+    subscription?: WebhookEntityWrapper;
+}
+export interface WebhookEvent {
+    event: string;
+    id: string;
+    payload: WebhookPayload;
+    created_at?: number;
+}

package/lib/types.js

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

package/lib/types.js.map

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

package/lib/utils/customerMapping.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Look up a Firebase UID using the strictly mapped Razorpay Customer ID.
+ * This prevents notes.uid spoofing by enforcing a server-side verified mapping.
+ *
+ * NOTE: For production scale, you must create a single-field index in Firestore
+ * on the customers collection's `razorpay_customer_id` field (or a collection group index)
+ * to avoid full collection scans and ensure O(1) performance.
+ */
+export declare function getUidByCustomerId(customerId: string, customersCollectionPath: string): Promise<string | null>;

package/lib/utils/customerMapping.js

@@ -0,0 +1,68 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUidByCustomerId = getUidByCustomerId;
+const admin = __importStar(require("firebase-admin"));
+const typedFirestore_1 = require("./typedFirestore");
+/**
+ * Look up a Firebase UID using the strictly mapped Razorpay Customer ID.
+ * This prevents notes.uid spoofing by enforcing a server-side verified mapping.
+ *
+ * NOTE: For production scale, you must create a single-field index in Firestore
+ * on the customers collection's `razorpay_customer_id` field (or a collection group index)
+ * to avoid full collection scans and ensure O(1) performance.
+ */
+async function getUidByCustomerId(customerId, customersCollectionPath) {
+    if (!customerId)
+        return null;
+    const db = admin.firestore();
+    const typedFs = new typedFirestore_1.TypedFirestore(db, {
+        customersCollection: customersCollectionPath,
+        productsCollection: '',
+        keyId: '',
+        keySecret: '',
+        webhookSecret: '',
+        syncCustomers: true
+    });
+    const snap = await typedFs.getCustomersCollection()
+        .where('razorpay_customer_id', '==', customerId)
+        .limit(1)
+        .get();
+    if (snap.empty) {
+        return null;
+    }
+    return snap.docs[0].id;
+}
+//# sourceMappingURL=customerMapping.js.map

package/lib/utils/customerMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customerMapping.js","sourceRoot":"","sources":["../../src/utils/customerMapping.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,gDA0BC;AArCD,sDAAwC;AACxC,qDAAkD;AAElD;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CACpC,UAAkB,EAClB,uBAA+B;IAE/B,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,+BAAc,CAAC,EAAE,EAAE;QACnC,mBAAmB,EAAE,uBAAuB;QAC5C,kBAAkB,EAAE,EAAE;QACtB,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,IAAI;KACtB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,sBAAsB,EAAE;SAC9C,KAAK,CAAC,sBAAsB,EAAE,IAAI,EAAE,UAAU,CAAC;SAC/C,KAAK,CAAC,CAAC,CAAC;SACR,GAAG,EAAE,CAAC;IAEX,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3B,CAAC"}

package/lib/utils/ensureCustomer.d.ts

@@ -0,0 +1,10 @@
+import Razorpay from 'razorpay';
+import { RazorpaySyncConfig } from '../types';
+/**
+ * Ensures a Razorpay customer exists for the given Firebase UID.
+ * If no customer is linked and syncCustomers is enabled, creates one via the Razorpay API
+ * and stores the mapping in Firestore.
+ *
+ * @returns The Razorpay customer ID, or null if not found and creation is disabled/failed.
+ */
+export declare function ensureRazorpayCustomer(uid: string, config: RazorpaySyncConfig, rzp: Razorpay): Promise<string | null>;

package/lib/utils/ensureCustomer.js

@@ -0,0 +1,78 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureRazorpayCustomer = ensureRazorpayCustomer;
+const admin = __importStar(require("firebase-admin"));
+const firestore_1 = require("firebase-admin/firestore");
+const logs_1 = require("../logs");
+const typedFirestore_1 = require("./typedFirestore");
+/**
+ * Ensures a Razorpay customer exists for the given Firebase UID.
+ * If no customer is linked and syncCustomers is enabled, creates one via the Razorpay API
+ * and stores the mapping in Firestore.
+ *
+ * @returns The Razorpay customer ID, or null if not found and creation is disabled/failed.
+ */
+async function ensureRazorpayCustomer(uid, config, rzp) {
+    const db = admin.firestore();
+    const typedFs = new typedFirestore_1.TypedFirestore(db, config);
+    const customerDocRef = typedFs.getCustomerDoc(uid);
+    const customerDoc = await customerDocRef.get();
+    const customerData = customerDoc.data() || {};
+    const existingCustomerId = customerData.razorpay_customer_id;
+    if (existingCustomerId) {
+        return existingCustomerId;
+    }
+    if (!config.syncCustomers) {
+        logs_1.logs.info(`No linked Razorpay customer ID for UID ${uid} and syncCustomers is disabled.`);
+        return null;
+    }
+    const userRec = await admin.auth().getUser(uid).catch(() => null);
+    const newCustomer = await rzp.customers.create({
+        name: userRec?.displayName || customerData.name || 'Firebase User',
+        email: userRec?.email || customerData.email || undefined,
+        contact: userRec?.phoneNumber || customerData.phone || undefined,
+        fail_existing: 0,
+    });
+    const razorpayCustomerId = newCustomer.id;
+    const updateData = {
+        razorpay_customer_id: razorpayCustomerId,
+        updated_at: firestore_1.FieldValue.serverTimestamp()
+    };
+    await customerDocRef.set(updateData, { merge: true });
+    logs_1.logs.info(`Created Razorpay customer ${razorpayCustomerId} for UID ${uid}`);
+    return razorpayCustomerId;
+}
+//# sourceMappingURL=ensureCustomer.js.map

package/lib/utils/ensureCustomer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureCustomer.js","sourceRoot":"","sources":["../../src/utils/ensureCustomer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,wDAsCC;AApDD,sDAAwC;AACxC,wDAAsD;AAEtD,kCAA+B;AAE/B,qDAAkD;AAElD;;;;;;GAMG;AACI,KAAK,UAAU,sBAAsB,CACxC,GAAW,EACX,MAA0B,EAC1B,GAAa;IAEb,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,+BAAc,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,EAAE,IAAK,EAA2B,CAAC;IACxE,MAAM,kBAAkB,GAAG,YAAY,CAAC,oBAAoB,CAAC;IAE7D,IAAI,kBAAkB,EAAE,CAAC;QACrB,OAAO,kBAAkB,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACxB,WAAI,CAAC,IAAI,CAAC,0CAA0C,GAAG,iCAAiC,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC;QAC3C,IAAI,EAAE,OAAO,EAAE,WAAW,IAAI,YAAY,CAAC,IAAI,IAAI,eAAe;QAClE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,YAAY,CAAC,KAAK,IAAI,SAAS;QACxD,OAAO,EAAE,OAAO,EAAE,WAAW,IAAI,YAAY,CAAC,KAAK,IAAI,SAAS;QAChE,aAAa,EAAE,CAAC;KACnB,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,WAAW,CAAC,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAyB;QACrC,oBAAoB,EAAE,kBAAkB;QACxC,UAAU,EAAE,sBAAU,CAAC,eAAe,EAAE;KAC3C,CAAC;IACF,MAAM,cAAc,CAAC,GAAG,CAAC,UAAyB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,WAAI,CAAC,IAAI,CAAC,6BAA6B,kBAAkB,YAAY,GAAG,EAAE,CAAC,CAAC;IAE5E,OAAO,kBAAkB,CAAC;AAC9B,CAAC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,15 @@
+import * as admin from 'firebase-admin';
+import { Plans } from 'razorpay/dist/types/plans';
+import { RazorpaySyncConfig, SanitizedPlan, ProductDoc } from '../types';
+/**
+ * Helper to sanitize Razorpay plan data for Firestore storage.
+ */
+export declare const sanitizePlan: (plan: Plans.RazorPayPlans) => SanitizedPlan;
+export declare const generateProductId: (plan: Plans.RazorPayPlans) => string;
+export declare const generatePlanKey: (plan: Plans.RazorPayPlans) => string;
+/**
+ * Syncs a Razorpay plan to a Firestore product document.
+ * Creates or updates the product document with the plan's details.
+ * Shared between buildCreatePlan and buildSyncPlans.
+ */
+export declare const syncPlanToProduct: (plan: Plans.RazorPayPlans, db: admin.firestore.Firestore, config: RazorpaySyncConfig) => Promise<ProductDoc>;

package/lib/utils/index.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncPlanToProduct = exports.generatePlanKey = exports.generateProductId = exports.sanitizePlan = void 0;
+const firestore_1 = require("firebase-admin/firestore");
+const typedFirestore_1 = require("./typedFirestore");
+/**
+ * Helper to sanitize Razorpay plan data for Firestore storage.
+ */
+const sanitizePlan = (plan) => {
+    const sanitizedPlan = {
+        id: plan.id,
+        entity: plan.entity,
+        interval: plan.interval,
+        period: plan.period,
+        item: plan.item ? plan.item : null,
+        notes: plan.notes || {},
+        active: true, // Plans don't return an active boolean at the top level
+        created_at: plan.created_at,
+        updated_at: firestore_1.FieldValue.serverTimestamp(),
+        _synced_via: 'admin_api'
+    };
+    if (plan.item && plan.item.active !== undefined) {
+        sanitizedPlan.active = !!plan.item.active;
+    }
+    return sanitizedPlan;
+};
+exports.sanitizePlan = sanitizePlan;
+const generateProductId = (plan) => {
+    if (plan.notes && plan.notes.productId) {
+        return String(plan.notes.productId);
+    }
+    if (plan.item && plan.item.name) {
+        return plan.item.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-+)+/g, '');
+    }
+    return `prod_${plan.id}`;
+};
+exports.generateProductId = generateProductId;
+const generatePlanKey = (plan) => {
+    if (plan.interval > 1) {
+        return `${plan.interval}_${plan.period}`;
+    }
+    return plan.period;
+};
+exports.generatePlanKey = generatePlanKey;
+/**
+ * Syncs a Razorpay plan to a Firestore product document.
+ * Creates or updates the product document with the plan's details.
+ * Shared between buildCreatePlan and buildSyncPlans.
+ */
+const syncPlanToProduct = async (plan, db, config) => {
+    const productId = (0, exports.generateProductId)(plan);
+    const planKey = (0, exports.generatePlanKey)(plan);
+    const typedFs = new typedFirestore_1.TypedFirestore(db, config);
+    const docRef = typedFs.getProductDoc(productId);
+    const productSnap = await docRef.get();
+    const productData = productSnap.data() || {
+        id: productId,
+        name: plan.item?.name || 'Razorpay Product',
+        description: plan.item?.description || '',
+        active: true,
+        allowedPlans: {},
+        created_at: firestore_1.FieldValue.serverTimestamp(),
+    };
+    productData.allowedPlans = productData.allowedPlans || {};
+    productData.allowedPlans[planKey] = plan.id;
+    productData.plans = productData.plans || {};
+    productData.plans[planKey] = (0, exports.sanitizePlan)(plan);
+    productData.type = 'subscription';
+    productData.updated_at = firestore_1.FieldValue.serverTimestamp();
+    productData._synced_via = 'admin_api';
+    await docRef.set(productData, { merge: true });
+    return productData;
+};
+exports.syncPlanToProduct = syncPlanToProduct;
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

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

package/lib/utils/processingLock.d.ts

@@ -0,0 +1,12 @@
+import * as admin from 'firebase-admin';
+/**
+ * Acquires a processing lock on a Firestore document via a transaction.
+ * Prevents duplicate processing of the same document by multiple function invocations.
+ *
+ * @param docRef - The Firestore document reference to lock.
+ * @param isTerminal - A predicate that returns true if the document is already in a
+ *                     terminal state (e.g., has an order_id, subscription_id, or paid status).
+ * @returns true if the lock was successfully acquired, false if the document is already
+ *          processed or currently being processed within the timeout window.
+ */
+export declare function acquireProcessingLock(docRef: admin.firestore.DocumentReference, isTerminal: (data: admin.firestore.DocumentData) => boolean): Promise<boolean>;

package/lib/utils/processingLock.js

@@ -0,0 +1,78 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireProcessingLock = acquireProcessingLock;
+const admin = __importStar(require("firebase-admin"));
+const firestore_1 = require("firebase-admin/firestore");
+const PROCESSING_TIMEOUT_MS = 120_000; // 2 minutes
+/**
+ * Acquires a processing lock on a Firestore document via a transaction.
+ * Prevents duplicate processing of the same document by multiple function invocations.
+ *
+ * @param docRef - The Firestore document reference to lock.
+ * @param isTerminal - A predicate that returns true if the document is already in a
+ *                     terminal state (e.g., has an order_id, subscription_id, or paid status).
+ * @returns true if the lock was successfully acquired, false if the document is already
+ *          processed or currently being processed within the timeout window.
+ */
+async function acquireProcessingLock(docRef, isTerminal) {
+    let acquired = false;
+    await admin.firestore().runTransaction(async (transaction) => {
+        const docSnap = await transaction.get(docRef);
+        if (!docSnap.exists)
+            return;
+        const data = docSnap.data();
+        if (!data)
+            return;
+        if (isTerminal(data)) {
+            acquired = false;
+            return;
+        }
+        if (data.status === 'processing') {
+            const processingAt = data.processing_at?.toDate();
+            if (processingAt && (Date.now() - processingAt.getTime()) < PROCESSING_TIMEOUT_MS) {
+                acquired = false;
+                return; // Still processing within timeout window
+            }
+        }
+        transaction.update(docRef, {
+            status: 'processing',
+            processing_at: firestore_1.FieldValue.serverTimestamp(),
+        });
+        acquired = true;
+    });
+    return acquired;
+}
+//# sourceMappingURL=processingLock.js.map

package/lib/utils/processingLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processingLock.js","sourceRoot":"","sources":["../../src/utils/processingLock.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,sDAkCC;AAjDD,sDAAwC;AACxC,wDAAsD;AAEtD,MAAM,qBAAqB,GAAG,OAAO,CAAC,CAAC,YAAY;AAEnD;;;;;;;;;GASG;AACI,KAAK,UAAU,qBAAqB,CACvC,MAAyC,EACzC,UAA2D;IAE3D,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QACzD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QAE5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,QAAQ,GAAG,KAAK,CAAC;YACjB,OAAO;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;YAClD,IAAI,YAAY,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,qBAAqB,EAAE,CAAC;gBAChF,QAAQ,GAAG,KAAK,CAAC;gBACjB,OAAO,CAAC,yCAAyC;YACrD,CAAC;QACL,CAAC;QAED,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE;YACvB,MAAM,EAAE,YAAY;YACpB,aAAa,EAAE,sBAAU,CAAC,eAAe,EAAE;SAC9C,CAAC,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/lib/utils/retry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Retry a fetch function with exponential backoff on 429 (Rate Limited) responses.
+ * Shared across payment and subscription webhook handlers.
+ */
+export declare function fetchWithBackoff<T>(fetchFn: () => Promise<T>, retries?: number, backoffMs?: number): Promise<T>;
+/**
+ * Determine if an error is transient/retryable (e.g. rate limit, server error, network drop).
+ */
+export declare function isTransientError(err: any): boolean;

package/lib/utils/retry.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchWithBackoff = fetchWithBackoff;
+exports.isTransientError = isTransientError;
+const logs_1 = require("../logs");
+/**
+ * Retry a fetch function with exponential backoff on 429 (Rate Limited) responses.
+ * Shared across payment and subscription webhook handlers.
+ */
+async function fetchWithBackoff(fetchFn, retries = 3, backoffMs = 500) {
+    let attempt = 0;
+    while (attempt < retries) {
+        try {
+            return await fetchFn();
+        }
+        catch (err) {
+            attempt++;
+            if (err.statusCode === 429 && attempt < retries) {
+                logs_1.logs.info(`Rate limited (429). Retrying in ${backoffMs}ms (Attempt ${attempt} of ${retries})`);
+                await new Promise(resolve => setTimeout(resolve, backoffMs));
+                backoffMs *= 2; // Exponential backoff
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    throw new Error('Max retries reached');
+}
+/**
+ * Determine if an error is transient/retryable (e.g. rate limit, server error, network drop).
+ */
+function isTransientError(err) {
+    if (!err)
+        return false;
+    const statusCode = err.statusCode;
+    if (statusCode) {
+        return statusCode >= 500 || statusCode === 429;
+    }
+    // No status code — check for network, timeout, or connection errors
+    const message = (err.message || '').toLowerCase();
+    const code = err.code;
+    return (code === 'DEADLINE_EXCEEDED' ||
+        code === 'UNAVAILABLE' ||
+        code === 'ETIMEDOUT' ||
+        code === 'ECONNRESET' ||
+        code === 'ECONNREFUSED' ||
+        code === 'ENOTFOUND' ||
+        message.includes('timeout') ||
+        message.includes('network') ||
+        message.includes('fetch'));
+}
+//# sourceMappingURL=retry.js.map

package/lib/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":";;AAMA,4CAiBC;AAKD,4CAoBC;AAhDD,kCAA+B;AAE/B;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CAAI,OAAyB,EAAE,OAAO,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG;IAC7F,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;gBAC9C,WAAI,CAAC,IAAI,CAAC,mCAAmC,SAAS,eAAe,OAAO,OAAO,OAAO,GAAG,CAAC,CAAC;gBAC/F,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC7D,SAAS,IAAI,CAAC,CAAC,CAAC,sBAAsB;YAC1C,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,CAAC;YACd,CAAC;QACL,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAQ;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,UAAU,EAAE,CAAC;QACb,OAAO,UAAU,IAAI,GAAG,IAAI,UAAU,KAAK,GAAG,CAAC;IACnD,CAAC;IACD,oEAAoE;IACpE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,OAAO,CACH,IAAI,KAAK,mBAAmB;QAC5B,IAAI,KAAK,aAAa;QACtB,IAAI,KAAK,WAAW;QACpB,IAAI,KAAK,YAAY;QACrB,IAAI,KAAK,cAAc;QACvB,IAAI,KAAK,WAAW;QACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC5B,CAAC;AACN,CAAC"}

package/lib/utils/typedFirestore.d.ts

@@ -0,0 +1,25 @@
+import * as admin from 'firebase-admin';
+import { Orders } from 'razorpay/dist/types/orders';
+import { Payments } from 'razorpay/dist/types/payments';
+import { Subscriptions } from 'razorpay/dist/types/subscriptions';
+import { RazorpaySyncConfig, CustomerDoc, ProductDoc, CheckoutSessionDoc, SubscriptionDoc, WebhookEventDoc } from '../types';
+export declare class TypedFirestore {
+    private db;
+    private config;
+    constructor(db: admin.firestore.Firestore, config: RazorpaySyncConfig);
+    getCustomersCollection(): admin.firestore.CollectionReference<CustomerDoc, admin.firestore.DocumentData>;
+    getCustomerDoc(uid: string): admin.firestore.DocumentReference<CustomerDoc, admin.firestore.DocumentData>;
+    getProductsCollection(): admin.firestore.CollectionReference<ProductDoc, admin.firestore.DocumentData>;
+    getProductDoc(productId: string): admin.firestore.DocumentReference<ProductDoc, admin.firestore.DocumentData>;
+    getCheckoutSessionsCollection(uid: string): admin.firestore.CollectionReference<CheckoutSessionDoc, admin.firestore.DocumentData>;
+    getCheckoutSessionDoc(uid: string, sessionId: string): admin.firestore.DocumentReference<CheckoutSessionDoc, admin.firestore.DocumentData>;
+    getCheckoutSessionOrderDoc(uid: string, sessionId: string): admin.firestore.DocumentReference<Orders.RazorpayOrder, admin.firestore.DocumentData>;
+    getCheckoutSessionPaymentDoc(uid: string, sessionId: string): admin.firestore.DocumentReference<Payments.RazorpayPayment, admin.firestore.DocumentData>;
+    getSubscriptionsCollection(uid: string): admin.firestore.CollectionReference<SubscriptionDoc, admin.firestore.DocumentData>;
+    getSubscriptionDoc(uid: string, subscriptionId: string): admin.firestore.DocumentReference<SubscriptionDoc, admin.firestore.DocumentData>;
+    getSubscriptionDetailsDoc(uid: string, subscriptionId: string): admin.firestore.DocumentReference<Subscriptions.RazorpaySubscription, admin.firestore.DocumentData>;
+    getSubscriptionPaymentsCollection(uid: string, subscriptionId: string): admin.firestore.CollectionReference<Payments.RazorpayPayment, admin.firestore.DocumentData>;
+    getSubscriptionPaymentDoc(uid: string, subscriptionId: string, paymentId: string): admin.firestore.DocumentReference<Payments.RazorpayPayment, admin.firestore.DocumentData>;
+    getWebhookEventsCollection(): admin.firestore.CollectionReference<WebhookEventDoc, admin.firestore.DocumentData>;
+    getWebhookEventDoc(eventId: string): admin.firestore.DocumentReference<WebhookEventDoc, admin.firestore.DocumentData>;
+}