@modernman00/shared-js-lib 1.2.81 → 1.2.82

package/ShowResponse.js

@@ -1,4 +1,5 @@
 import { id, qSel } from './UtilityHtml.js';
+import { swalToast, swalSuccess, swalError } from './Alert.js';
 
 export const showError = (e) =>
   console.error(
@@ -9,6 +10,23 @@ export const msgException = (errorMessage) => {
   throw new Error(errorMessage);
 };
 
+/**
+ * Drop-in SweetAlert-backed notification.
+ * If status is true or 'green', shows success toast; otherwise shows error toast/modal.
+ * 
+ * @param {string} message - Message to display
+ * @param {boolean|string} [status=true] - true/'green' for success, false/'red' for error
+ * @param {boolean} [asToast=true] - true to show as sleek toast, false for modal
+ * @returns {Promise<any>}
+ */
+export const swalNotification = async (message, status = true, asToast = true) => {
+  const isSuccess = status === true || status === 'green' || status === 'is-success' || status === 'w3-green';
+  if (isSuccess) {
+    return await swalSuccess(message, asToast);
+  }
+  return await swalError(message, !asToast);
+};
+
 /**
  *
  * @param {*} elementId - element id
@@ -55,3 +73,105 @@ export const showResponse = (theId, message, status) => {
     responseEl.innerHTML = '';
   }, 5000); // Disappear after 5 seconds
 };
+
+
+/**
+ * Defensive Error Unwrapping Utility
+ *
+ * Extracts a human-readable string message from any error shape
+ * (string, Error object, Axios/Fetch HTTP response, validation map).
+ * Mathematically guarantees that [object Object] is NEVER returned.
+ *
+ * @param {any} err - The error object, string, or HTTP response error
+ * @param {string} defaultMessage - Fallback message if extraction yields empty
+ * @returns {string} Clean human-readable error text
+ */
+export const extractErrorMessage = (err, defaultMessage = "An unexpected error occurred.") => {
+  if (err === null || err === undefined) {
+    return defaultMessage;
+  }
+
+  if (typeof err === "string") {
+    const trimmed = err.trim();
+    return trimmed && trimmed !== "[object Object]" ? trimmed : defaultMessage;
+  }
+
+  // 1. Check Axios / HTTP response envelope (err.response.data)
+  if (err && typeof err === "object") {
+    const resData = err.response ? err.response.data : (err.data || null);
+
+    if (resData) {
+      if (typeof resData === "string") {
+        const trimmed = resData.trim();
+        if (trimmed && trimmed !== "[object Object]") return trimmed;
+      } else if (typeof resData === "object") {
+        // Check standard envelope fields: error, message, msg
+        if (typeof resData.error === "string" && resData.error.trim() && resData.error.trim() !== "[object Object]") {
+          return resData.error.trim();
+        }
+        if (typeof resData.message === "string" && resData.message.trim() && resData.message.trim() !== "[object Object]") {
+          return resData.message.trim();
+        }
+        if (typeof resData.msg === "string" && resData.msg.trim() && resData.msg.trim() !== "[object Object]") {
+          return resData.msg.trim();
+        }
+
+        // Check validation errors map (e.g. { errors: { email: ["Invalid"], password: ["Too short"] } })
+        const errorsSource = resData.errors || resData.error;
+        if (errorsSource && typeof errorsSource === "object") {
+          if (Array.isArray(errorsSource)) {
+            const msgs = errorsSource.map(m => typeof m === "string" ? m : (m?.message || JSON.stringify(m))).filter(Boolean);
+            if (msgs.length > 0) return msgs.join(", ");
+          } else {
+            const values = Object.values(errorsSource).flat().map(v => typeof v === "string" ? v : (v?.message || JSON.stringify(v))).filter(Boolean);
+            if (values.length > 0) return values.join(", ");
+          }
+        }
+      }
+    }
+
+    // 2. Check standard Error instance message
+    if (typeof err.message === "string" && err.message.trim() && err.message.trim() !== "[object Object]") {
+      return err.message.trim();
+    }
+
+    // 3. Check direct error/msg properties on object
+    if (typeof err.error === "string" && err.error.trim() && err.error.trim() !== "[object Object]") {
+      return err.error.trim();
+    }
+    if (typeof err.msg === "string" && err.msg.trim() && err.msg.trim() !== "[object Object]") {
+      return err.msg.trim();
+    }
+
+    // 4. Check errors map directly on object
+    if (err.errors && typeof err.errors === "object") {
+      if (Array.isArray(err.errors)) {
+        const msgs = err.errors.map(m => typeof m === "string" ? m : (m?.message || JSON.stringify(m))).filter(Boolean);
+        if (msgs.length > 0) return msgs.join(", ");
+      } else {
+        const values = Object.values(err.errors).flat().map(v => typeof v === "string" ? v : (v?.message || JSON.stringify(v))).filter(Boolean);
+        if (values.length > 0) return values.join(", ");
+      }
+    }
+
+    // 5. Check custom toString if not default Object toString
+    try {
+      if (typeof err.toString === "function") {
+        const str = err.toString();
+        if (str && str !== "[object Object]" && typeof str === "string") {
+          return str;
+        }
+      }
+    } catch (_) {}
+
+    // 6. Safe JSON stringify fallback
+    try {
+      const jsonStr = JSON.stringify(err);
+      if (jsonStr && jsonStr !== "{}" && jsonStr.length < 200) {
+        return jsonStr;
+      }
+    } catch (_) {}
+  }
+
+  return defaultMessage;
+};

package/axiosWrapper.js

@@ -4,6 +4,9 @@ import axiosRetry from 'axios-retry';
 
 axiosRetry(axios, { retries: 3 });
 
+// Ensure Axios always sends cookies (like the HttpOnly auth token) with every request
+axios.defaults.withCredentials = true;
+
 axios.interceptors.request.use(config => {
     config.headers['X-Requested-With'] = 'XMLHttpRequest';
 

package/config/version.php

@@ -1,3 +1,3 @@
 <?php
-define('APP_VERSION', 'v1.2.75');
+define('APP_VERSION', 'v1.2.81');
 

package/index.js

@@ -2,6 +2,13 @@ export * from './Http.js';
 export * from './UtilityHtml.js';
 export * from './Utility.js';
 export * from './Loader.js';
+export * from './Alert.js';
+export * from './ButtonLoader.js';
+export * from './FormLock.js';
+export * from './NetworkGuard.js';
+export * from './InlineValidation.js';
+export * from './Clipboard.js';
+export * from './AuthInterceptor.js';
 export * from './Cookie.js';
 export * from './FormHelper.js'
 export * from './ShowResponse.js';
@@ -15,4 +22,5 @@ export * from './AcctMgt/processAll.js';
 export * from './AcctMgt/update.js';
 export * from './AcctMgt/registerHandler.js';
 export * from './AcctMgt/recaptchaToken.js';
+export * from './AcctMgt/AdminAuthForm.js';
 export * from './general.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modernman00/shared-js-lib",
-  "version": "1.2.81",
+  "version": "1.2.82",
   "description": "Reusable JS utilities for numerous js problems",
   "homepage": "https://github.com/modernman00/shared-js-lib#readme",
   "keywords": [
@@ -25,7 +25,8 @@
   "dependencies": {
     "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
-    "settings": "^0.1.1"
+    "settings": "^0.1.1",
+    "sweetalert2": "^11.26.25"
   },
   "publishConfig": {
     "access": "public"
@@ -40,6 +41,13 @@
     "FormHelper.js",
     "Http.js",
     "Loader.js",
+    "Alert.js",
+    "ButtonLoader.js",
+    "FormLock.js",
+    "NetworkGuard.js",
+    "InlineValidation.js",
+    "Clipboard.js",
+    "AuthInterceptor.js",
     "ShowResponse.js",
     "Utility.js",
     "UtilityHtml.js",

package/release-history.md

@@ -101,3 +101,23 @@
 
 - 🔖 Bump version to v1.2.74 _(by modernman00)_
 - 🧹 Auto-commit before release _(by modernman00)_
+
+## v1.2.76 — 2026-07-17 17:47
+### Changelog for v1.2.76
+
+- 🔖 Bump version to v1.2.76 _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- refactor: improve robustness of UI utilities and add comprehensive unit test coverage _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+
+## v1.2.77 — 2026-07-17 22:53
+### Changelog for v1.2.77
+
+- 🔖 Bump version to v1.2.77 _(by modernman00)_
+- 🧹 Auto-commit before release _(by modernman00)_
+- 🚀 feat: Enterprise-wide WebAuthn Biometric Login Rollout (FaceID / TouchID) across all 6 applications.
+- 🔒 sec: Enforced strict FIDO2 challenge invalidation, origin verification, and defensive degradation per TAT governance.