@almadar/server 2.1.4 → 2.2.0

package/LICENSE

@@ -1,21 +1,72 @@
-MIT License
-
-Copyright (c) 2026 Almadar Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Almadar FZE
+Licensed Work:        KFlow Builder / Almadar
+                      The Licensed Work is (c) 2025-2026 Almadar FZE.
+Additional Use Grant: You may make production use of the Licensed Work for
+                      non-commercial purposes and for internal evaluation.
+                      Production use for commercial purposes requires a
+                      commercial license from the Licensor.
+Change Date:          2030-02-01
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+---
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+ADDITIONAL TERMS:
+
+Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
+
+TRADEMARKS:
+
+"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
+Almadar FZE. You may not use these trademarks without prior written
+permission from Almadar FZE.
+
+For licensing inquiries: licensing@almadar.io

package/README.md

@@ -22,4 +22,4 @@ import { /* ... */ } from '@almadar/server';
 
 ## License
 
-MIT
+BSL 1.1 (Business Source License). Converts to Apache 2.0 on 2030-02-01. Non-production use is free.

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" });
   }