fiberx-backend-toolkit 0.1.9 → 0.1.11

package/dist/mailer/utils/mailer_data_loader_util.d.ts

@@ -28,10 +28,10 @@ declare class MailerDataLoaderUtil<TMailerConfig, TBaseTemplate, TNotificationTy
     * ===============================
     */
     private getSnapshot;
-    getMailerConfig(): TMailerConfig | null;
-    getBaseTemplate(): TBaseTemplate | null;
-    getNotificationTypes(): TNotificationType[];
-    getEmailTemplates(): TEmailContentTempltae[];
+    getMailerConfig(): Promise<TMailerConfig | null>;
+    getBaseTemplate(): Promise<TBaseTemplate | null>;
+    getNotificationTypes(): Promise<TNotificationType[]>;
+    getEmailTemplates(): Promise<TEmailContentTempltae[]>;
     getTemplateByNotificationCode(code: string): Promise<TEmailContentTempltae | null>;
     refresh(): Promise<void>;
 }

package/dist/mailer/utils/mailer_data_loader_util.js

@@ -92,27 +92,41 @@ class MailerDataLoaderUtil {
     * ACCESSORS
     * ===============================
     */
-    getSnapshot() {
-        const snapshot = this.cache.get(this.CACHE_KEY);
+    async getSnapshot() {
+        let snapshot = this.cache.get(this.CACHE_KEY);
+        // ✅ If exists → return immediately
+        if (snapshot) {
+            return snapshot;
+        }
+        this.logger.alert("Mailer snapshot missing or expired. Rebuilding...");
+        // ✅ Trigger load (handles concurrency via loading_promise)
+        await this.load();
+        snapshot = this.cache.get(this.CACHE_KEY);
+        // ❌ Still missing → real failure
         if (!snapshot) {
-            throw new Error("Mailer Data Loader Util snapshot not loaded. Call load() first.");
+            throw new Error("Failed to rebuild Mailer snapshot.");
         }
         return snapshot;
     }
-    getMailerConfig() {
-        return this.getSnapshot().mailer_config;
+    async getMailerConfig() {
+        const snapshot = await this.getSnapshot();
+        return snapshot.mailer_config;
     }
-    getBaseTemplate() {
-        return this.getSnapshot().base_template;
+    async getBaseTemplate() {
+        const snapshot = await this.getSnapshot();
+        return snapshot.base_template;
     }
-    getNotificationTypes() {
-        return this.getSnapshot().notification_types;
+    async getNotificationTypes() {
+        const snapshot = await this.getSnapshot();
+        return snapshot.notification_types;
     }
-    getEmailTemplates() {
-        return this.getSnapshot().email_contents;
+    async getEmailTemplates() {
+        const snapshot = await this.getSnapshot();
+        return snapshot.email_contents;
     }
     async getTemplateByNotificationCode(code) {
-        const templates_by_notification_code = this.getSnapshot().templates_by_notification_code;
+        const snapshot = await this.getSnapshot();
+        const templates_by_notification_code = snapshot.templates_by_notification_code;
         if (templates_by_notification_code.has(code)) {
             return templates_by_notification_code.get(code) ?? null;
         }

package/dist/rbac/rbac_loader_util.d.ts

@@ -28,10 +28,10 @@ declare class RBACLoaderUtil<TSafeRole> {
      * ===============================
      */
     private getSnapshot;
-    getRoleById(role_id: number): TSafeRole | undefined;
-    getRoleBySymbol(symbol: string): TSafeRole | undefined;
-    getPermissionsForRole(role_id: number): string[];
-    roleHasPermission(role_id: number, permission_key: string): boolean;
+    getRoleById(role_id: number): Promise<TSafeRole | undefined>;
+    getRoleBySymbol(symbol: string): Promise<TSafeRole | undefined>;
+    getPermissionsForRole(role_id: number): Promise<string[]>;
+    roleHasPermission(role_id: number, permission_key: string): Promise<boolean>;
     refresh(): Promise<void>;
 }
 export default RBACLoaderUtil;

package/dist/rbac/rbac_loader_util.js

@@ -109,27 +109,35 @@ class RBACLoaderUtil {
      * ACCESSORS
      * ===============================
      */
-    getSnapshot() {
-        const snapshot = this.cache.get(this.RBAC_CACHE_KEY);
+    async getSnapshot() {
+        let snapshot = this.cache.get(this.RBAC_CACHE_KEY);
+        if (snapshot) {
+            return snapshot;
+        }
+        // Cache miss (expired or never loaded)
+        this.logger.alert("RBAC snapshot cache miss. Rebuilding...");
+        await this.load(); // <-- handles concurrency already
+        snapshot = this.cache.get(this.RBAC_CACHE_KEY);
         if (!snapshot) {
-            throw new Error("RBAC snapshot not loaded. Call load() first.");
+            throw new Error("RBAC snapshot rebuild failed.");
         }
         return snapshot;
     }
-    getRoleById(role_id) {
-        return this.getSnapshot().role_by_id.get(role_id);
+    async getRoleById(role_id) {
+        const snapshot = await this.getSnapshot();
+        return snapshot.role_by_id.get(role_id);
     }
-    getRoleBySymbol(symbol) {
-        return this.getSnapshot().role_by_symbol.get(symbol);
+    async getRoleBySymbol(symbol) {
+        const snapshot = await this.getSnapshot();
+        return snapshot.role_by_symbol.get(symbol);
     }
-    getPermissionsForRole(role_id) {
-        return Array.from(this.getSnapshot().permissions_by_role_id.get(role_id) ?? []);
+    async getPermissionsForRole(role_id) {
+        const snapshot = await this.getSnapshot();
+        return Array.from(snapshot.permissions_by_role_id.get(role_id) ?? []);
     }
-    roleHasPermission(role_id, permission_key) {
-        return (this.getSnapshot()
-            .permissions_by_role_id
-            .get(role_id)
-            ?.has(permission_key) ?? false);
+    async roleHasPermission(role_id, permission_key) {
+        const snapshot = await this.getSnapshot();
+        return (snapshot.permissions_by_role_id.get(role_id)?.has(permission_key) ?? false);
     }
     async refresh() {
         await this.load(true);

package/dist/utils/input_validator_util.d.ts

@@ -51,5 +51,6 @@ declare class InputValidatorUtil {
     static dirExists(directory: string, create_directory?: boolean, return_dir_path?: boolean): boolean | string;
     static isSafeHashCompare(a: string, b: string): boolean;
     static isDeepEqual(a: any, b: any): boolean;
+    static hasInputChanged(new_input: Record<string, any>, existing_data: Record<string, any>, keys_to_check: string[]): boolean;
 }
 export default InputValidatorUtil;

package/dist/utils/input_validator_util.js

@@ -174,5 +174,40 @@ class InputValidatorUtil {
         }
         return false;
     }
+    static hasInputChanged(new_input, existing_data, keys_to_check) {
+        // Normalize values (booleans, "true"/"false", "1"/"0", null-like)
+        const normalize = (val) => {
+            if (val === "true")
+                return true;
+            if (val === "false")
+                return false;
+            if (val === "1")
+                return true;
+            if (val === "0")
+                return false;
+            return val;
+        };
+        // Utility to get nested value by dot notation
+        const getNestedValue = (obj, path) => {
+            return path.split('.').reduce((acc, part) => {
+                if (acc && typeof acc === 'object' && part in acc) {
+                    return acc[part];
+                }
+                return undefined;
+            }, obj);
+        };
+        for (const key of keys_to_check) {
+            if (!(key in new_input)) {
+                continue;
+            }
+            const new_val = normalize(getNestedValue(new_input, key));
+            const old_val = normalize(getNestedValue(existing_data, key));
+            if (!InputValidatorUtil.isDeepEqual(new_val, old_val)) {
+                console.log("🔺 CHANGED:", key, { new_val, old_val });
+                return true;
+            }
+        }
+        return false;
+    }
 }
 exports.default = InputValidatorUtil;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fiberx-backend-toolkit",
-    "version": "0.1.9",
+    "version": "0.1.11",
     "description": "A TypeScript backend toolkit providing shared domain logic, infrastructure helpers, and utilities for FiberX server-side applications and services.",
     "type": "commonjs",
     "main": "./dist/index.js",