@fonoster/common 0.15.7 → 0.15.8

package/dist/utils/passwordStrength.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type PasswordStrength = "weak" | "fair" | "strong";
+/**
+ * Assesses the strength of a password based on various criteria.
+ *
+ * @param password - The password to assess
+ * @returns PasswordStrength - 'weak', 'fair', or 'strong'
+ */
+export declare function assessPasswordStrength(password: string): PasswordStrength;
+/**
+ * Gets a user-friendly message describing the password strength.
+ *
+ * @param strength - The password strength level
+ * @returns A human-readable message about the password strength
+ */
+export declare function getPasswordStrengthMessage(strength: PasswordStrength): string;

package/dist/utils/passwordStrength.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assessPasswordStrength = assessPasswordStrength;
+exports.getPasswordStrengthMessage = getPasswordStrengthMessage;
+/**
+ * Assesses the strength of a password based on various criteria.
+ *
+ * @param password - The password to assess
+ * @returns PasswordStrength - 'weak', 'fair', or 'strong'
+ */
+function assessPasswordStrength(password) {
+    if (!password || password.length < 8) {
+        return "weak";
+    }
+    let score = 0;
+    // Length contribution
+    if (password.length >= 12)
+        score += 2;
+    else if (password.length >= 8)
+        score += 1;
+    // Character variety contribution
+    if (/[a-z]/.test(password))
+        score += 1; // lowercase
+    if (/[A-Z]/.test(password))
+        score += 1; // uppercase
+    if (/\d/.test(password))
+        score += 1; // numbers
+    if (/[^a-zA-Z0-9]/.test(password))
+        score += 1; // special characters
+    // Determine strength based on score
+    if (score >= 5)
+        return "strong";
+    if (score >= 3)
+        return "fair";
+    return "weak";
+}
+/**
+ * Gets a user-friendly message describing the password strength.
+ *
+ * @param strength - The password strength level
+ * @returns A human-readable message about the password strength
+ */
+function getPasswordStrengthMessage(strength) {
+    if (strength === "strong") {
+        return "Ahoy! Your password is strong!";
+    }
+    if (strength === "fair") {
+        return "Fair password - consider adding more variety";
+    }
+    if (strength === "weak") {
+        return "Weak password - try a longer password with more variety";
+    }
+    return "Please enter your new password";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/common",
-  "version": "0.15.7",
+  "version": "0.15.8",
   "description": "Common library for Fonoster projects",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -49,5 +49,5 @@
   "devDependencies": {
     "@types/nodemailer": "^6.4.14"
   },
-  "gitHead": "ee046e3e244bfdbf60064ddab2e9f9318e04b4dc"
+  "gitHead": "495f3f9135aae42d8d0867fac272f95df63d155b"
 }