fiber-firebase-functions 1.0.1 → 1.0.3

package/lib/common/config.js

@@ -0,0 +1,60 @@
+"use strict";
+/*
+ * Copyright (C) 2025 Fiber
+ *
+ * All rights reserved. This script, including its code and logic, is the
+ * exclusive property of Fiber. Redistribution, reproduction,
+ * or modification of any part of this script is strictly prohibited
+ * without prior written permission from Fiber.
+ *
+ * Conditions of use:
+ * - The code may not be copied, duplicated, or used, in whole or in part,
+ *   for any purpose without explicit authorization.
+ * - Redistribution of this code, with or without modification, is not
+ *   permitted unless expressly agreed upon by Fiber.
+ * - The name "Fiber" and any associated branding, logos, or
+ *   trademarks may not be used to endorse or promote derived products
+ *   or services without prior written approval.
+ *
+ * Disclaimer:
+ * THIS SCRIPT AND ITS CODE ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL
+ * FIBER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING BUT NOT LIMITED TO LOSS OF USE,
+ * DATA, PROFITS, OR BUSINESS INTERRUPTION) ARISING OUT OF OR RELATED TO THE USE
+ * OR INABILITY TO USE THIS SCRIPT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Unauthorized copying or reproduction of this script, in whole or in part,
+ * is a violation of applicable intellectual property laws and will result
+ * in legal action.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appInitialize = appInitialize;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+let cachedConfig = null;
+function appInitialize() {
+    if (cachedConfig)
+        return cachedConfig;
+    const configPath = path_1.default.resolve(process.cwd(), "config", "app.json");
+    if (!fs_1.default.existsSync(configPath)) {
+        throw new Error(`Missing configuration file at: ${configPath}`);
+    }
+    const raw = fs_1.default.readFileSync(configPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    cachedConfig = {
+        middleware: {
+            appName: parsed.middleware.app_name,
+            url: parsed.middleware.url
+        },
+        security: {
+            url: parsed.security.url,
+        }
+    };
+    return cachedConfig;
+}
+//# sourceMappingURL=config.js.map

package/lib/common/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;;;AAqBH,sCAuBC;AA1CD,4CAAoB;AACpB,gDAAwB;AAgBxB,IAAI,YAAY,GAAqB,IAAI,CAAC;AAE1C,SAAgB,aAAa;IACzB,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,UAAU,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAErE,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,YAAY,GAAG;QACX,UAAU,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ;YACnC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG;SAC7B;QACD,QAAQ,EAAE;YACN,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG;SAC3B;KACJ,CAAC;IAEF,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/lib/common/realtime_database.js

@@ -34,27 +34,22 @@ exports.realtimeDatabase = realtimeDatabase;
 const app_1 = require("firebase-admin/app");
 const database_1 = require("firebase-admin/database");
 function realtimeDatabase(config) {
-    return function getRealtimeDatabase(name) {
-        const entry = config[name];
-        if (!entry) {
-            throw new Error(`Realtime DB config "${name}" not found`);
-        }
-        const { appName, url } = entry;
-        let app;
-        try {
-            app = (0, app_1.getApps)().find((a) => a.name === appName) || (0, app_1.initializeApp)({ databaseURL: url }, appName);
-        }
-        catch (e) {
-            console.error("[Error:getRealtimeDatabase]", {
-                appName,
-                url,
-                loadedApps: (0, app_1.getApps)().map((a) => a.name),
-                error: e.message,
-                stack: e.stack,
-            });
-            throw e;
-        }
-        return (0, database_1.getDatabase)(app);
-    };
+    const { appName, url } = config;
+    let app;
+    try {
+        app = (0, app_1.getApps)().find((a) => a.name === appName) || (0, app_1.initializeApp)({ databaseURL: url }, appName);
+    }
+    catch (e) {
+        console.error("[Error:getRealtimeDatabase]", {
+            appName,
+            url,
+            loadedApps: (0, app_1.getApps)().map((a) => a.name),
+            error: e.message,
+            stack: e.stack,
+        });
+        throw e;
+    }
+    return (0, database_1.getDatabase)(app);
 }
+;
 //# sourceMappingURL=realtime_database.js.map

package/lib/common/realtime_database.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime_database.js","sourceRoot":"","sources":["../../src/common/realtime_database.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;AAUH,4CA2BC;AAnCD,4CAAiE;AACjE,sDAAgE;AAOhE,SAAgB,gBAAgB,CAAC,MAAwC;IACrE,OAAO,SAAS,mBAAmB,CAAC,IAAY;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,aAAa,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QAE/B,IAAI,GAAQ,CAAC;QAEb,IAAI,CAAC;YACD,GAAG,GAAG,IAAA,aAAO,GAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,IAAA,mBAAa,EAAC,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QACpG,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE;gBACzC,OAAO;gBACP,GAAG;gBACH,UAAU,EAAE,IAAA,aAAO,GAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxC,KAAK,EAAG,CAAW,CAAC,OAAO;gBAC3B,KAAK,EAAG,CAAW,CAAC,KAAK;aAC5B,CAAC,CAAC;YAEH,MAAM,CAAC,CAAC;QACZ,CAAC;QAED,OAAO,IAAA,sBAAW,EAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"realtime_database.js","sourceRoot":"","sources":["../../src/common/realtime_database.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;AAUH,4CAoBC;AA5BD,4CAAiE;AACjE,sDAAgE;AAOhE,SAAgB,gBAAgB,CAAC,MAAwB;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAEhC,IAAI,GAAQ,CAAC;IAEb,IAAI,CAAC;QACD,GAAG,GAAG,IAAA,aAAO,GAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,IAAA,mBAAa,EAAC,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACpG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE;YACzC,OAAO;YACP,GAAG;YACH,UAAU,EAAE,IAAA,aAAO,GAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACxC,KAAK,EAAG,CAAW,CAAC,OAAO;YAC3B,KAAK,EAAG,CAAW,CAAC,KAAK;SAC5B,CAAC,CAAC;QAEH,MAAM,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,IAAA,sBAAW,EAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAAA,CAAC"}

package/lib/email/send_email.js

@@ -0,0 +1,81 @@
+"use strict";
+/*
+ * Copyright (C) 2025 Fiber
+ *
+ * All rights reserved. This script, including its code and logic, is the
+ * exclusive property of Fiber. Redistribution, reproduction,
+ * or modification of any part of this script is strictly prohibited
+ * without prior written permission from Fiber.
+ *
+ * Conditions of use:
+ * - The code may not be copied, duplicated, or used, in whole or in part,
+ *   for any purpose without explicit authorization.
+ * - Redistribution of this code, with or without modification, is not
+ *   permitted unless expressly agreed upon by Fiber.
+ * - The name "Fiber" and any associated branding, logos, or
+ *   trademarks may not be used to endorse or promote derived products
+ *   or services without prior written approval.
+ *
+ * Disclaimer:
+ * THIS SCRIPT AND ITS CODE ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL
+ * FIBER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING BUT NOT LIMITED TO LOSS OF USE,
+ * DATA, PROFITS, OR BUSINESS INTERRUPTION) ARISING OUT OF OR RELATED TO THE USE
+ * OR INABILITY TO USE THIS SCRIPT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Unauthorized copying or reproduction of this script, in whole or in part,
+ * is a violation of applicable intellectual property laws and will result
+ * in legal action.
+ */
+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.sendEmail = sendEmail;
+const admin = __importStar(require("firebase-admin"));
+if (admin.apps.length === 0) {
+    admin.initializeApp();
+}
+async function sendEmail(collection, to, subject, message) {
+    const firestore = admin.firestore();
+    await firestore.collection(collection).add({
+        to: [to],
+        message: {
+            subject: subject,
+            text: message,
+        },
+    });
+}
+//# sourceMappingURL=send_email.js.map

package/lib/email/send_email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send_email.js","sourceRoot":"","sources":["../../src/email/send_email.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQH,8BAUC;AAhBD,sDAAwC;AAExC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC1B,KAAK,CAAC,aAAa,EAAE,CAAC;AAC1B,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,UAAkB,EAAE,EAAU,EAAE,OAAe,EAAE,OAAe;IAC5F,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAEpC,MAAM,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC;QACvC,EAAE,EAAE,CAAC,EAAE,CAAC;QACR,OAAO,EAAE;YACL,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,OAAO;SAChB;KACJ,CAAC,CAAC;AACP,CAAC"}

package/lib/middleware/rate_limiter.js

@@ -0,0 +1,169 @@
+"use strict";
+/*
+ * Copyright (C) 2025 Fiber
+ *
+ * All rights reserved. This script, including its code and logic, is the
+ * exclusive property of Fiber. Redistribution, reproduction,
+ * or modification of any part of this script is strictly prohibited
+ * without prior written permission from Fiber.
+ *
+ * Conditions of use:
+ * - The code may not be copied, duplicated, or used, in whole or in part,
+ *   for any purpose without explicit authorization.
+ * - Redistribution of this code, with or without modification, is not
+ *   permitted unless expressly agreed upon by Fiber.
+ * - The name "Fiber" and any associated branding, logos, or
+ *   trademarks may not be used to endorse or promote derived products
+ *   or services without prior written approval.
+ *
+ * Disclaimer:
+ * THIS SCRIPT AND ITS CODE ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL
+ * FIBER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING BUT NOT LIMITED TO LOSS OF USE,
+ * DATA, PROFITS, OR BUSINESS INTERRUPTION) ARISING OUT OF OR RELATED TO THE USE
+ * OR INABILITY TO USE THIS SCRIPT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Unauthorized copying or reproduction of this script, in whole or in part,
+ * is a violation of applicable intellectual property laws and will result
+ * in legal action.
+ */
+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.SetRateLimitStatus = exports.RateLimitCheckStatus = void 0;
+exports.isRateLimited = isRateLimited;
+exports.recordRateLimitHit = recordRateLimitHit;
+const admin = __importStar(require("firebase-admin"));
+const config_1 = require("../common/config");
+const realtime_database_1 = require("../common/realtime_database");
+if (!admin.apps.length) {
+    admin.initializeApp();
+}
+var RateLimitCheckStatus;
+(function (RateLimitCheckStatus) {
+    RateLimitCheckStatus["MISSING_IDENTIFIER"] = "MISSING_IDENTIFIER";
+    RateLimitCheckStatus["MISSING_IDENTIFIER_ID"] = "MISSING_IDENTIFIER_ID";
+    RateLimitCheckStatus["MISSING_IDENTIFIER_TARGET"] = "MISSING_IDENTIFIER_TARGET";
+    RateLimitCheckStatus["MISSING_RULE"] = "MISSING_RULE";
+    RateLimitCheckStatus["MISSING_DATABASE_CONFIG"] = "MISSING_DATABASE_CONFIG";
+    RateLimitCheckStatus["LIMIT_EXISTS"] = "LIMIT_EXISTS";
+    RateLimitCheckStatus["LIMIT_NOT_FOUND"] = "LIMIT_NOT_FOUND";
+    RateLimitCheckStatus["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(RateLimitCheckStatus || (exports.RateLimitCheckStatus = RateLimitCheckStatus = {}));
+var SetRateLimitStatus;
+(function (SetRateLimitStatus) {
+    SetRateLimitStatus["MISSING_IDENTIFIER"] = "MISSING_IDENTIFIER";
+    SetRateLimitStatus["MISSING_IDENTIFIER_ID"] = "MISSING_IDENTIFIER_ID";
+    SetRateLimitStatus["MISSING_IDENTIFIER_TARGET"] = "MISSING_IDENTIFIER_TARGET";
+    SetRateLimitStatus["MISSING_RULE"] = "MISSING_RULE";
+    SetRateLimitStatus["MISSING_DATABASE_CONFIG"] = "MISSING_DATABASE_CONFIG";
+    SetRateLimitStatus["RATE_LIMITED"] = "RATE_LIMITED";
+    SetRateLimitStatus["ALLOWED"] = "ALLOWED";
+    SetRateLimitStatus["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(SetRateLimitStatus || (exports.SetRateLimitStatus = SetRateLimitStatus = {}));
+async function isRateLimited(identifier, rule) {
+    if (!identifier)
+        return RateLimitCheckStatus.MISSING_IDENTIFIER;
+    if (!identifier.id)
+        return RateLimitCheckStatus.MISSING_IDENTIFIER_ID;
+    if (!identifier.target)
+        return RateLimitCheckStatus.MISSING_IDENTIFIER_TARGET;
+    if (!rule)
+        return RateLimitCheckStatus.MISSING_RULE;
+    const config = (0, config_1.appInitialize)();
+    const middleware = config.middleware;
+    if (!middleware)
+        return RateLimitCheckStatus.MISSING_DATABASE_CONFIG;
+    try {
+        const databaseConfig = {
+            appName: middleware.appName,
+            url: middleware.url,
+        };
+        const database = (0, realtime_database_1.realtimeDatabase)(databaseConfig);
+        const reference = database.ref("__fbs__limiter").child(identifier.id).child(identifier.target).child("__fbs__timestamps");
+        const query = await reference.get();
+        if (!query.exists())
+            return RateLimitCheckStatus.LIMIT_NOT_FOUND;
+        const now = Date.now();
+        let timestamps = query.val();
+        timestamps = timestamps.filter((t) => now - t < rule.windowMs);
+        if (timestamps.length === 0) {
+            await reference.remove();
+            return RateLimitCheckStatus.LIMIT_NOT_FOUND;
+        }
+        if (timestamps.length >= rule.maxHits)
+            return RateLimitCheckStatus.LIMIT_EXISTS;
+        return RateLimitCheckStatus.LIMIT_NOT_FOUND;
+    }
+    catch (e) {
+        return RateLimitCheckStatus.INTERNAL_ERROR;
+    }
+}
+async function recordRateLimitHit(identifier, rule) {
+    if (!identifier)
+        return SetRateLimitStatus.MISSING_IDENTIFIER;
+    if (!identifier.id)
+        return SetRateLimitStatus.MISSING_IDENTIFIER_ID;
+    if (!identifier.target)
+        return SetRateLimitStatus.MISSING_IDENTIFIER_TARGET;
+    if (!rule)
+        return SetRateLimitStatus.MISSING_RULE;
+    const config = (0, config_1.appInitialize)();
+    const middleware = config.middleware;
+    if (!middleware)
+        return SetRateLimitStatus.MISSING_DATABASE_CONFIG;
+    try {
+        const databaseConfig = {
+            appName: middleware.appName,
+            url: middleware.url,
+        };
+        const database = (0, realtime_database_1.realtimeDatabase)(databaseConfig);
+        const reference = database.ref("__fbs__limiter").child(identifier.id).child(identifier.target).child("__fbs__timestamps");
+        const query = await reference.get();
+        let timestamps = query.exists() ? query.val() : [];
+        const now = Date.now();
+        timestamps = timestamps.filter((t) => now - t < rule.windowMs);
+        if (timestamps.length >= rule.maxHits)
+            return SetRateLimitStatus.RATE_LIMITED;
+        timestamps.push(now);
+        await reference.set(timestamps);
+        return SetRateLimitStatus.ALLOWED;
+    }
+    catch (e) {
+        return SetRateLimitStatus.INTERNAL_ERROR;
+    }
+}
+//# sourceMappingURL=rate_limiter.js.map

package/lib/middleware/rate_limiter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fiber-firebase-functions",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A collection of ready-to-use Firebase Cloud Functions utilities and wrappers designed for any application built by Fiber. Provides reusable helpers, common patterns, and production-grade modules to streamline backend development across all Fiber projects.",
   "author": "Fiber",
   "license": "FIBER-PROPRIETARY",

package/src/auth/is_user_disabled.ts

@@ -30,36 +30,63 @@
  */
 
 import * as admin from "firebase-admin";
-import { onCall } from "firebase-functions/v2/https";
 
 if (admin.apps.length === 0) {
     admin.initializeApp();
 }
 
-export enum UserDisabledStatus {
-    MISSING_UUID = "MISSING_UUID",
+export enum UserDisabledByIdStatus {
+    MISSING_USER_ID = "MISSING_USER_ID",
     ENABLED = "ENABLED",
     DISABLED = "DISABLED",
     NOT_FOUND = "NOT_FOUND",
     INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
-export const isUserDisabled = onCall(async (request) => {
-    const uid: string | undefined = request.data?.uid;
+export enum UserDisabledByEmailStatus {
+    MISSING_USER_ID = "MISSING_USER_ID",
+    ENABLED = "ENABLED",
+    DISABLED = "DISABLED",
+    NOT_FOUND = "NOT_FOUND",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+}
+
+export async function isUserDisabledById(userId: string): Promise<UserDisabledByIdStatus> {
+    userId = userId.trim();
+
+    if (!userId) return UserDisabledByIdStatus.MISSING_USER_ID;
+
+    try {
+        const user = await admin.auth().getUser(userId);
+        const isUserDisabled = user.disabled;
+
+        return isUserDisabled
+            ? UserDisabledByIdStatus.DISABLED
+            : UserDisabledByIdStatus.ENABLED;
+    } catch (error: any) {
+        if (error.code === "auth/user-not-found") {
+            return UserDisabledByIdStatus.NOT_FOUND;
+        }
+        return UserDisabledByIdStatus.INTERNAL_ERROR;
+    }
+}
+
+export async function isUserDisabledByEmail(email: string): Promise<UserDisabledByEmailStatus> {
+    email = email.trim();
 
-    if (!uid) return UserDisabledStatus.MISSING_UUID;
+    if (!email) return UserDisabledByEmailStatus.MISSING_USER_ID;
 
     try {
-        const user = await admin.auth().getUser(uid);
+        const user = await admin.auth().getUserByEmail(email);
         const isUserDisabled = user.disabled;
 
         return isUserDisabled
-            ? UserDisabledStatus.DISABLED
-            : UserDisabledStatus.ENABLED;
+            ? UserDisabledByEmailStatus.DISABLED
+            : UserDisabledByEmailStatus.ENABLED;
     } catch (error: any) {
         if (error.code === "auth/user-not-found") {
-            return UserDisabledStatus.NOT_FOUND;
+            return UserDisabledByEmailStatus.NOT_FOUND;
         }
-        return UserDisabledStatus.INTERNAL_ERROR;
+        return UserDisabledByEmailStatus.INTERNAL_ERROR;
     }
-});
+}

package/src/auth/is_user_exists.ts

@@ -30,32 +30,55 @@
  */
 
 import * as admin from "firebase-admin";
-import { onCall } from "firebase-functions/v2/https";
 
 if (admin.apps.length === 0) {
     admin.initializeApp();
 }
 
-export enum UserExistsStatus {
-    MISSING_UUID = "MISSING_UUID",
+export enum UserExistsByIdStatus {
+    MISSING_USER_ID = "MISSING_USER_ID",
     EXISTS = "EXISTS",
     NOT_FOUND = "NOT_FOUND",
     INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
-export const isUserExists = onCall(async (request) => {
-    const uid: string | undefined = request.data?.uid;
+export enum UserExistsByEmailStatus {
+    MISSING_USER_EMAIL = "MISSING_USER_EMAIL",
+    EXISTS = "EXISTS",
+    NOT_FOUND = "NOT_FOUND",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+}
+
+export async function isUserExistsById(userId: string): Promise<UserExistsByIdStatus> {
+    userId = userId.trim();
+
+    if (!userId || userId === "") return UserExistsByIdStatus.MISSING_USER_ID;
+
+    try {
+        await admin.auth().getUser(userId);
+
+        return UserExistsByIdStatus.EXISTS;
+    } catch (error: any) {
+        if (error.code === "auth/user-not-found") {
+            return UserExistsByIdStatus.NOT_FOUND;
+        }
+        return UserExistsByIdStatus.INTERNAL_ERROR;
+    }
+}
+
+export async function isUserExistsByEmail(email: string): Promise<UserExistsByEmailStatus> {
+    email = email.trim();
 
-    if (!uid) return UserExistsStatus.MISSING_UUID;
+    if (!email || email === "") return UserExistsByEmailStatus.MISSING_USER_EMAIL;
 
     try {
-        await admin.auth().getUser(uid);
+        await admin.auth().getUserByEmail(email);
 
-        return UserExistsStatus.EXISTS;
+        return UserExistsByEmailStatus.EXISTS;
     } catch (error: any) {
         if (error.code === "auth/user-not-found") {
-            return UserExistsStatus.NOT_FOUND;
+            return UserExistsByEmailStatus.NOT_FOUND;
         }
-        return UserExistsStatus.INTERNAL_ERROR;
+        return UserExistsByEmailStatus.INTERNAL_ERROR;
     }
-});
+}

package/src/auth/otp.ts

@@ -0,0 +1,70 @@
+/*
+ * Copyright (C) 2025 Fiber
+ *
+ * All rights reserved. This script, including its code and logic, is the
+ * exclusive property of Fiber. Redistribution, reproduction,
+ * or modification of any part of this script is strictly prohibited
+ * without prior written permission from Fiber.
+ *
+ * Conditions of use:
+ * - The code may not be copied, duplicated, or used, in whole or in part,
+ *   for any purpose without explicit authorization.
+ * - Redistribution of this code, with or without modification, is not
+ *   permitted unless expressly agreed upon by Fiber.
+ * - The name "Fiber" and any associated branding, logos, or
+ *   trademarks may not be used to endorse or promote derived products
+ *   or services without prior written approval.
+ *
+ * Disclaimer:
+ * THIS SCRIPT AND ITS CODE ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL
+ * FIBER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING BUT NOT LIMITED TO LOSS OF USE,
+ * DATA, PROFITS, OR BUSINESS INTERRUPTION) ARISING OUT OF OR RELATED TO THE USE
+ * OR INABILITY TO USE THIS SCRIPT, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Unauthorized copying or reproduction of this script, in whole or in part,
+ * is a violation of applicable intellectual property laws and will result
+ * in legal action.
+ */
+
+import * as admin from "firebase-admin";
+
+if (admin.apps.length === 0) {
+    admin.initializeApp();
+}
+
+export enum GenerateOTPStatus {
+    MISSING_DATABASE_CONFIG = "MISSING_DATABASE_CONFIG",
+    TOO_MANY_REQUEST = "TOO_MANY_REQUEST",
+    SUCCESS = "SUCCESS",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+}
+
+export interface GenerateOTPIdentifier {
+    id: string;
+    target: string;
+}
+
+// export async function generateOTP(identifier: GenerateOTPIdentifier): Promise<GenerateOTPStatus> {
+//     const config = appInitialize();
+//     const security = config.security;
+
+//     if (!security) return GenerateOTPStatus.MISSING_DATABASE_CONFIG;
+
+//     if (await isRateLimited(identifier, rule, databaseConfig) !== RateLimitCheckStatus.LIMIT_NOT_FOUND) {
+//         return GenerateOTPStatus.TOO_MANY_REQUEST;
+//     }
+//     await recordRateLimitHit(identifier, rule, databaseConfig);
+
+//     try {
+//         const database = realtimeDatabase(databaseConfig);
+//         const reference = database.ref("__fbs__otp").child("feature");
+//         const query = await reference.get();
+
+//         return GenerateOTPStatus.SUCCESS;
+//     } catch (e) {
+//         return GenerateOTPStatus.INTERNAL_ERROR;
+//     }
+// }