@almadar/server 2.1.5 → 2.2.0

package/dist/almadarLogger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Almadar Structured Logger (Server copy)
+ *
+ * Namespace-based logging with level gating.
+ * Duplicated from @almadar/ui/lib/logger because @almadar/server
+ * does not depend on @almadar/ui.
+ *
+ * @packageDocumentation
+ */
+export interface Logger {
+    debug: (msg: string, data?: Record<string, unknown>) => void;
+    info: (msg: string, data?: Record<string, unknown>) => void;
+    warn: (msg: string, data?: Record<string, unknown>) => void;
+    error: (msg: string, data?: Record<string, unknown>) => void;
+}
+export declare function createLogger(namespace: string): Logger;
+//# sourceMappingURL=almadarLogger.d.ts.map

package/dist/almadarLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"almadarLogger.d.ts","sourceRoot":"","sources":["../src/almadarLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC9D;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAuBtD"}

package/dist/index.js

@@ -861,6 +861,50 @@ var EventPersistence = class {
 
 // src/services/DataService.ts
 init_db();
+
+// src/almadarLogger.ts
+var LEVEL_PRIORITY = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
+var ENV = typeof process !== "undefined" && process.env ? process.env : {};
+var NODE_ENV = ENV.NODE_ENV ?? "development";
+var CONFIGURED_LEVEL = (ENV.LOG_LEVEL ?? (NODE_ENV === "production" ? "info" : "debug")).toUpperCase();
+var MIN_PRIORITY = LEVEL_PRIORITY[CONFIGURED_LEVEL] ?? 0;
+var DEBUG_FILTER = (ENV.ALMADAR_DEBUG ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+function matchesNamespace(namespace) {
+  if (DEBUG_FILTER.length === 0) return true;
+  return DEBUG_FILTER.some((pattern) => {
+    if (pattern === "*" || pattern === "almadar:*") return true;
+    if (pattern.endsWith(":*")) return namespace.startsWith(pattern.slice(0, -1));
+    return namespace === pattern;
+  });
+}
+function createLogger(namespace) {
+  const nsAllowed = matchesNamespace(namespace);
+  const log = (level, message, data) => {
+    if (LEVEL_PRIORITY[level] < MIN_PRIORITY) return;
+    if (level === "DEBUG" && !nsAllowed) return;
+    const prefix = `[${namespace}]`;
+    switch (level) {
+      case "DEBUG":
+        console.debug(prefix, message, data ?? "");
+        break;
+      case "INFO":
+        console.info(prefix, message, data ?? "");
+        break;
+      case "WARN":
+        console.warn(prefix, message, data ?? "");
+        break;
+      case "ERROR":
+        console.error(prefix, message, data ?? "");
+        break;
+    }
+  };
+  return {
+    debug: (msg, data) => log("DEBUG", msg, data),
+    info: (msg, data) => log("INFO", msg, data),
+    warn: (msg, data) => log("WARN", msg, data),
+    error: (msg, data) => log("ERROR", msg, data)
+  };
+}
 var MockDataService = class {
   stores = /* @__PURE__ */ new Map();
   schemas = /* @__PURE__ */ new Map();
@@ -1274,6 +1318,7 @@ function extractPaginationParams(query, defaults = {}) {
 }
 
 // src/services/DataService.ts
+var dataLog = createLogger("almadar:server:data");
 function applyFilterCondition(value, operator, filterValue) {
   if (value === null || value === void 0) {
     return operator === "!=" ? filterValue !== null : false;
@@ -1305,7 +1350,9 @@ function applyFilterCondition(value, operator, filterValue) {
 }
 var MockDataServiceAdapter = class {
   async list(collection) {
-    return getMockDataService().list(collection);
+    const result = getMockDataService().list(collection);
+    dataLog.debug("list", { entity: collection, count: result.length });
+    return result;
   }
   async listPaginated(collection, options = {}) {
     const {
@@ -1357,16 +1404,24 @@ var MockDataServiceAdapter = class {
     return { data, total, page, pageSize, totalPages };
   }
   async getById(collection, id) {
-    return getMockDataService().getById(collection, id);
+    const result = getMockDataService().getById(collection, id);
+    dataLog.debug("getById", { entity: collection, id, found: result !== null });
+    return result;
   }
   async create(collection, data) {
-    return getMockDataService().create(collection, data);
+    const result = getMockDataService().create(collection, data);
+    dataLog.info("create", { entity: collection, id: result.id });
+    return result;
   }
   async update(collection, id, data) {
-    return getMockDataService().update(collection, id, data);
+    const result = getMockDataService().update(collection, id, data);
+    dataLog.info("update", { entity: collection, id, found: result !== null });
+    return result;
   }
   async delete(collection, id) {
-    return getMockDataService().delete(collection, id);
+    const result = getMockDataService().delete(collection, id);
+    dataLog.info("delete", { entity: collection, id, success: result });
+    return result;
   }
   async query(collection, filters) {
     let items = getMockDataService().list(collection);
@@ -1404,10 +1459,12 @@ var MockDataServiceAdapter = class {
 var FirebaseDataService = class {
   async list(collection) {
     const snapshot = await db.collection(collection).get();
-    return snapshot.docs.map((doc) => ({
+    const items = snapshot.docs.map((doc) => ({
       id: doc.id,
       ...doc.data()
     }));
+    dataLog.debug("list", { entity: collection, count: items.length });
+    return items;
   }
   async listPaginated(collection, options = {}) {
     const {
@@ -1462,6 +1519,7 @@ var FirebaseDataService = class {
   }
   async getById(collection, id) {
     const doc = await db.collection(collection).doc(id).get();
+    dataLog.debug("getById", { entity: collection, id, found: doc.exists });
     if (!doc.exists) {
       return null;
     }
@@ -1474,6 +1532,7 @@ var FirebaseDataService = class {
       createdAt: now,
       updatedAt: now
     });
+    dataLog.info("create", { entity: collection, id: docRef.id });
     return {
       ...data,
       id: docRef.id,
@@ -1492,6 +1551,7 @@ var FirebaseDataService = class {
       ...data,
       updatedAt: now
     });
+    dataLog.info("update", { entity: collection, id });
     return {
       ...doc.data(),
       ...data,
@@ -1503,9 +1563,11 @@ var FirebaseDataService = class {
     const docRef = db.collection(collection).doc(id);
     const doc = await docRef.get();
     if (!doc.exists) {
+      dataLog.debug("delete", { entity: collection, id, found: false });
       return false;
     }
     await docRef.delete();
+    dataLog.info("delete", { entity: collection, id, success: true });
     return true;
   }
   async query(collection, filters) {
@@ -1851,6 +1913,7 @@ var validateParams = (schema) => async (req, res, next) => {
 
 // src/middleware/authenticateFirebase.ts
 init_db();
+var authLog = createLogger("almadar:server:auth");
 var BEARER_PREFIX = "Bearer ";
 var DEV_USER = {
   uid: "dev-user-001",
@@ -1870,6 +1933,7 @@ var DEV_USER = {
 async function authenticateFirebase(req, res, next) {
   const authorization = req.headers.authorization;
   if (env.NODE_ENV === "development" && (!authorization || !authorization.startsWith(BEARER_PREFIX))) {
+    authLog.debug("auth:devBypass", { uid: DEV_USER.uid });
     req.firebaseUser = DEV_USER;
     res.locals.firebaseUser = DEV_USER;
     return next();
@@ -1880,10 +1944,12 @@ async function authenticateFirebase(req, res, next) {
     }
     const token = authorization.slice(BEARER_PREFIX.length);
     const decodedToken = await getAuth().verifyIdToken(token);
+    authLog.info("auth:verified", { uid: decodedToken.uid, email: decodedToken.email });
     req.firebaseUser = decodedToken;
     res.locals.firebaseUser = decodedToken;
     return next();
   } catch (error) {
+    authLog.warn("auth:failed", { error: error instanceof Error ? error.message : String(error) });
     console.error("Firebase authentication failed:", error);
     return res.status(401).json({ error: "Unauthorized" });
   }