fiber-firebase-functions 1.0.3 → 1.0.4

package/lib/middleware/rate_limiter.js

@@ -104,13 +104,13 @@ async function isRateLimited(identifier, rule) {
     if (!rule)
         return RateLimitCheckStatus.MISSING_RULE;
     const config = (0, config_1.appInitialize)();
-    const middleware = config.middleware;
-    if (!middleware)
+    const rateLimiter = config.rateLimiter;
+    if (!rateLimiter)
         return RateLimitCheckStatus.MISSING_DATABASE_CONFIG;
     try {
         const databaseConfig = {
-            appName: middleware.appName,
-            url: middleware.url,
+            appName: rateLimiter.appName,
+            url: rateLimiter.url,
         };
         const database = (0, realtime_database_1.realtimeDatabase)(databaseConfig);
         const reference = database.ref("__fbs__limiter").child(identifier.id).child(identifier.target).child("__fbs__timestamps");
@@ -142,13 +142,13 @@ async function recordRateLimitHit(identifier, rule) {
     if (!rule)
         return SetRateLimitStatus.MISSING_RULE;
     const config = (0, config_1.appInitialize)();
-    const middleware = config.middleware;
-    if (!middleware)
+    const rateLimiter = config.rateLimiter;
+    if (!rateLimiter)
         return SetRateLimitStatus.MISSING_DATABASE_CONFIG;
     try {
         const databaseConfig = {
-            appName: middleware.appName,
-            url: middleware.url,
+            appName: rateLimiter.appName,
+            url: rateLimiter.url,
         };
         const database = (0, realtime_database_1.realtimeDatabase)(databaseConfig);
         const reference = database.ref("__fbs__limiter").child(identifier.id).child(identifier.target).child("__fbs__timestamps");

package/lib/middleware/rate_limiter.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate_limiter.js","sourceRoot":"","sources":["../../src/middleware/rate_limiter.ts"],"names":[],"mappings":"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"}
+{"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.3",
+  "version": "1.0.4",
   "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",
@@ -20,10 +20,12 @@
   ],
   "dependencies": {
     "firebase-admin": "^13.6.0",
-    "firebase-functions": "^7.0.0"
+    "firebase-functions": "^7.0.0",
+    "validator": "^13.15.23"
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "ts-node": "^10.9.2"
+    "@types/validator": "^13.15.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
   }
 }

package/src/auth/is_user_disabled.ts

@@ -39,7 +39,7 @@ export enum UserDisabledByIdStatus {
     MISSING_USER_ID = "MISSING_USER_ID",
     ENABLED = "ENABLED",
     DISABLED = "DISABLED",
-    NOT_FOUND = "NOT_FOUND",
+    USER_NOT_FOUND = "USER_NOT_FOUND",
     INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
@@ -47,46 +47,48 @@ export enum UserDisabledByEmailStatus {
     MISSING_USER_ID = "MISSING_USER_ID",
     ENABLED = "ENABLED",
     DISABLED = "DISABLED",
-    NOT_FOUND = "NOT_FOUND",
+    USER_NOT_FOUND = "USER_NOT_FOUND",
     INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
-export async function isUserDisabledById(userId: string): Promise<UserDisabledByIdStatus> {
-    userId = userId.trim();
+export class IsUserDisabled {
+    static async withId(userId: string): Promise<UserDisabledByIdStatus> {
+        userId = userId.trim();
 
-    if (!userId) return UserDisabledByIdStatus.MISSING_USER_ID;
+        if (!userId || userId === "") return UserDisabledByIdStatus.MISSING_USER_ID;
 
-    try {
-        const user = await admin.auth().getUser(userId);
-        const isUserDisabled = user.disabled;
+        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 isUserDisabled
+                ? UserDisabledByIdStatus.DISABLED
+                : UserDisabledByIdStatus.ENABLED;
+        } catch (error: any) {
+            if (error.code === "auth/user-not-found") {
+                return UserDisabledByIdStatus.USER_NOT_FOUND;
+            }
+            return UserDisabledByIdStatus.INTERNAL_ERROR;
         }
-        return UserDisabledByIdStatus.INTERNAL_ERROR;
     }
-}
 
-export async function isUserDisabledByEmail(email: string): Promise<UserDisabledByEmailStatus> {
-    email = email.trim();
+    static async withEmail(email: string): Promise<UserDisabledByEmailStatus> {
+        email = email.trim();
 
-    if (!email) return UserDisabledByEmailStatus.MISSING_USER_ID;
+        if (!email || email === "") return UserDisabledByEmailStatus.MISSING_USER_ID;
 
-    try {
-        const user = await admin.auth().getUserByEmail(email);
-        const isUserDisabled = user.disabled;
+        try {
+            const user = await admin.auth().getUserByEmail(email);
+            const isUserDisabled = user.disabled;
 
-        return isUserDisabled
-            ? UserDisabledByEmailStatus.DISABLED
-            : UserDisabledByEmailStatus.ENABLED;
-    } catch (error: any) {
-        if (error.code === "auth/user-not-found") {
-            return UserDisabledByEmailStatus.NOT_FOUND;
+            return isUserDisabled
+                ? UserDisabledByEmailStatus.DISABLED
+                : UserDisabledByEmailStatus.ENABLED;
+        } catch (error: any) {
+            if (error.code === "auth/user-not-found") {
+                return UserDisabledByEmailStatus.USER_NOT_FOUND;
+            }
+            return UserDisabledByEmailStatus.INTERNAL_ERROR;
         }
-        return UserDisabledByEmailStatus.INTERNAL_ERROR;
     }
 }

package/src/auth/is_user_exists.ts

@@ -38,47 +38,49 @@ if (admin.apps.length === 0) {
 export enum UserExistsByIdStatus {
     MISSING_USER_ID = "MISSING_USER_ID",
     EXISTS = "EXISTS",
-    NOT_FOUND = "NOT_FOUND",
+    USER_NOT_FOUND = "USER_NOT_FOUND",
     INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
 export enum UserExistsByEmailStatus {
     MISSING_USER_EMAIL = "MISSING_USER_EMAIL",
     EXISTS = "EXISTS",
-    NOT_FOUND = "NOT_FOUND",
+    USER_NOT_FOUND = "USER_NOT_FOUND",
     INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
-export async function isUserExistsById(userId: string): Promise<UserExistsByIdStatus> {
-    userId = userId.trim();
+export class IsUserExists {
+    static async withId(userId: string): Promise<UserExistsByIdStatus> {
+        userId = userId.trim();
 
-    if (!userId || userId === "") return UserExistsByIdStatus.MISSING_USER_ID;
+        if (!userId || userId === "") return UserExistsByIdStatus.MISSING_USER_ID;
 
-    try {
-        await admin.auth().getUser(userId);
+        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.EXISTS;
+        } catch (error: any) {
+            if (error.code === "auth/user-not-found") {
+                return UserExistsByIdStatus.USER_NOT_FOUND;
+            }
+            return UserExistsByIdStatus.INTERNAL_ERROR;
         }
-        return UserExistsByIdStatus.INTERNAL_ERROR;
     }
-}
 
-export async function isUserExistsByEmail(email: string): Promise<UserExistsByEmailStatus> {
-    email = email.trim();
+    static async withEmail(email: string): Promise<UserExistsByEmailStatus> {
+        email = email.trim();
 
-    if (!email || email === "") return UserExistsByEmailStatus.MISSING_USER_EMAIL;
+        if (!email || email === "") return UserExistsByEmailStatus.MISSING_USER_EMAIL;
 
-    try {
-        await admin.auth().getUserByEmail(email);
+        try {
+            await admin.auth().getUserByEmail(email);
 
-        return UserExistsByEmailStatus.EXISTS;
-    } catch (error: any) {
-        if (error.code === "auth/user-not-found") {
-            return UserExistsByEmailStatus.NOT_FOUND;
+            return UserExistsByEmailStatus.EXISTS;
+        } catch (error: any) {
+            if (error.code === "auth/user-not-found") {
+                return UserExistsByEmailStatus.USER_NOT_FOUND;
+            }
+            return UserExistsByEmailStatus.INTERNAL_ERROR;
         }
-        return UserExistsByEmailStatus.INTERNAL_ERROR;
     }
 }

package/src/auth/otp.ts

@@ -29,42 +29,107 @@
  * in legal action.
  */
 
+import crypto from 'crypto';
 import * as admin from "firebase-admin";
+import { appInitialize } from "../common/config";
 
 if (admin.apps.length === 0) {
     admin.initializeApp();
 }
 
-export enum GenerateOTPStatus {
-    MISSING_DATABASE_CONFIG = "MISSING_DATABASE_CONFIG",
-    TOO_MANY_REQUEST = "TOO_MANY_REQUEST",
+export enum GenerateStatus {
+    MISSING_OTP_CONFIG = "MISSING_OTP_CONFIG",
     SUCCESS = "SUCCESS",
-    INTERNAL_ERROR = "INTERNAL_ERROR",
 }
 
-export interface GenerateOTPIdentifier {
-    id: string;
-    target: string;
+export enum GetOTPStatus {
+    MISSING_OTP_CONFIG = "MISSING_OTP_CONFIG",
+    OTP_NOT_FOUND = "OTP_NOT_FOUND",
+    OTP_FOUND = "OTP_FOUND",
 }
 
-// export async function generateOTP(identifier: GenerateOTPIdentifier): Promise<GenerateOTPStatus> {
-//     const config = appInitialize();
-//     const security = config.security;
+export class Otp {
+    static async generate(userId: string, type: string): Promise<GenerateStatus> {
+        const config = appInitialize();
+        const otp = config.otp;
 
-//     if (!security) return GenerateOTPStatus.MISSING_DATABASE_CONFIG;
+        if (otp.collection === undefined) return GenerateStatus.MISSING_OTP_CONFIG;
 
-//     if (await isRateLimited(identifier, rule, databaseConfig) !== RateLimitCheckStatus.LIMIT_NOT_FOUND) {
-//         return GenerateOTPStatus.TOO_MANY_REQUEST;
-//     }
-//     await recordRateLimitHit(identifier, rule, databaseConfig);
+        const now = Date.now();
+        const otpCode = OTPUtils.generate();
+        const hashOtp = OTPUtils.hash(otpCode);
 
-//     try {
-//         const database = realtimeDatabase(databaseConfig);
-//         const reference = database.ref("__fbs__otp").child("feature");
-//         const query = await reference.get();
+        await admin.firestore().collection(otp.collection).add({
+            __fbs__user_id: userId,
+            __fbs__created_at: now,
+            __fbs__otp_type: type,
+            __fbs__otp: hashOtp,
+        });
 
-//         return GenerateOTPStatus.SUCCESS;
-//     } catch (e) {
-//         return GenerateOTPStatus.INTERNAL_ERROR;
-//     }
-// }
+        return GenerateStatus.SUCCESS;
+    }
+
+    static async get(userId: string, type: string): Promise<{ status: GetOTPStatus; otp?: string; }> {
+        const config = appInitialize();
+        const otp = config.otp;
+
+        if (otp.collection === undefined) return { status: GetOTPStatus.MISSING_OTP_CONFIG };
+
+        const snapshot = await admin.firestore()
+            .collection(otp.collection)
+            .where("__fbs__user_id", "==", userId)
+            .where("__fbs__otp_type", "==", type)
+            .orderBy("__fbs__created_at", "desc")
+            .limit(1)
+            .get();
+
+        if (snapshot.docs.length === 0) return { status: GetOTPStatus.OTP_NOT_FOUND };
+
+        const doc = snapshot.docs[0];
+        const data = doc?.data();
+        const otpCode = data?.__fbs__otp as string;
+
+        return { status: GetOTPStatus.MISSING_OTP_CONFIG, otp: otpCode };
+    }
+}
+
+class OTPUtils {
+    static generate(): string {
+        while (true) {
+            const buffer = crypto.randomBytes(4);
+            const number = buffer.readUInt32BE();
+            const otp = (number % 1000000).toString().padStart(6, '0');
+
+            if (this.hasAllIdenticalDigits(otp)) continue;
+            if (this.hasRepeatingPattern(otp)) continue;
+            if (this.hasMoreThanThreeConsecutiveIdenticalDigits(otp)) continue;
+
+            return otp;
+        }
+    }
+
+    static hash(otp: string): string {
+        return crypto.createHash('sha256').update(otp).digest('hex');
+    }
+
+    private static hasAllIdenticalDigits(str: string): boolean {
+        return /^(\d)\1{5}$/.test(str);
+    }
+
+    private static hasMoreThanThreeConsecutiveIdenticalDigits(str: string): boolean {
+        return /(\d)\1{3,}/.test(str);
+    }
+
+    private static hasRepeatingPattern(str: string): boolean {
+        const half = str.slice(0, 3);
+        if (half.repeat(2) === str) return true;
+
+        const pairs = str.match(/(..)/g);
+        if (pairs && pairs.length === 3 && new Set(pairs).size === 1) return true;
+
+        const mirror = half + half.split('').reverse().join('');
+        if (str === mirror) return true;
+
+        return false;
+    }
+}