@mostajs/audit 2.1.1 → 2.2.0

package/LICENSE

@@ -1,21 +1,29 @@
-MIT License
-
-Copyright (c) 2024 Dr Hamid MADANI <drmdh@msn.com>
-
-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.
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (c) 2026 Dr Hamid MADANI <drmdh@msn.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+COMMERCIAL LICENSE
+
+For organizations that cannot comply with the AGPL open-source requirements,
+a commercial license is available. Contact: drmdh@msn.com
+
+The commercial license allows you to:
+- Use the software in proprietary/closed-source projects
+- Modify without publishing your source code
+- Get priority support and SLA
+
+Contact: Dr Hamid MADANI <drmdh@msn.com>

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { logAudit, getAuditUser } from './lib/audit';
+export { dlog, dwarn, createLogger, isDebugEnabled, type ScopedLogger } from './lib/debug-log';
 export { AuditLogRepository } from './repositories/audit-log.repository';
 export { AuditLogSchema } from './schemas/audit-log.schema';
 export { createAuditHandlers } from './api/route';

package/dist/index.js

@@ -2,6 +2,8 @@
 // Author: Dr Hamid MADANI drmdh@msn.com
 // Core
 export { logAudit, getAuditUser } from './lib/audit';
+// Volatile debug logger (complement de logAudit pour la trace pm2/stdout)
+export { dlog, dwarn, createLogger, isDebugEnabled } from './lib/debug-log';
 // Repository & Schema
 export { AuditLogRepository } from './repositories/audit-log.repository';
 export { AuditLogSchema } from './schemas/audit-log.schema';

package/dist/lib/debug-log.d.ts

@@ -0,0 +1,16 @@
+/** Log debug — actif uniquement si MOSTAJS_DEBUG=1 ou hors prod. */
+export declare function dlog(scope: string, data: Record<string, unknown>): void;
+/** Log warning — toujours actif (utile en prod pour les erreurs critiques). */
+export declare function dwarn(scope: string, data: Record<string, unknown>): void;
+export interface ScopedLogger {
+    dlog: (scope: string, data: Record<string, unknown>) => void;
+    dwarn: (scope: string, data: Record<string, unknown>) => void;
+}
+/**
+ * Crée un logger avec un préfixe namespace fixe — utile pour différencier
+ * les apps qui consomment le module dans le même environnement
+ * (ex: pm2 logs avec plusieurs services partageant la même console).
+ */
+export declare function createLogger(namespace: string): ScopedLogger;
+/** Pour les tests ou les apps qui veulent contrôler l'activation. */
+export declare function isDebugEnabled(): boolean;

package/dist/lib/debug-log.js

@@ -0,0 +1,69 @@
+// @mosta/audit — Volatile debug logger
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Logger de debug structuré complémentaire de `logAudit` :
+// - `logAudit` persiste en DB → traçabilité long-terme, consultation /admin.
+// - `dlog` / `dwarn` poussent sur stdout/stderr → grep en pm2 logs, désactivable.
+//
+// Activation :
+// - Si `MOSTAJS_DEBUG=1` ou `=true` → activé (toutes envs).
+// - Si `MOSTAJS_DEBUG=0` ou `=false` → désactivé explicitement.
+// - Sinon : activé en non-production (`NODE_ENV !== 'production'`).
+//
+// Usage générique :
+// ```ts
+// import { dlog, dwarn } from '@mostajs/audit'
+// dlog('myapp.scope', { key: 'value' })   // → [myapp.scope] { ... }
+// ```
+//
+// Usage avec namespace dédié à une app :
+// ```ts
+// import { createLogger } from '@mostajs/audit'
+// export const { dlog, dwarn } = createLogger('iquesta')
+// // dlog('magic.enter', { ... })          → [iquesta.magic.enter] { ... }
+// ```
+const ENABLED = (() => {
+    const flag = process.env.MOSTAJS_DEBUG;
+    if (flag === '1' || flag === 'true')
+        return true;
+    if (flag === '0' || flag === 'false')
+        return false;
+    return process.env.NODE_ENV !== 'production';
+})();
+function emit(level, scope, data) {
+    // dwarn s'affiche même en prod (utile pour les erreurs critiques).
+    // dlog est gated par ENABLED.
+    if (level === 'info' && !ENABLED)
+        return;
+    const payload = { ts: new Date().toISOString(), ...data };
+    const target = level === 'warn' ? console.warn : console.info;
+    try {
+        target(`[${scope}]`, JSON.stringify(payload));
+    }
+    catch {
+        target(`[${scope}]`, payload);
+    }
+}
+/** Log debug — actif uniquement si MOSTAJS_DEBUG=1 ou hors prod. */
+export function dlog(scope, data) {
+    emit('info', scope, data);
+}
+/** Log warning — toujours actif (utile en prod pour les erreurs critiques). */
+export function dwarn(scope, data) {
+    emit('warn', scope, data);
+}
+/**
+ * Crée un logger avec un préfixe namespace fixe — utile pour différencier
+ * les apps qui consomment le module dans le même environnement
+ * (ex: pm2 logs avec plusieurs services partageant la même console).
+ */
+export function createLogger(namespace) {
+    return {
+        dlog: (scope, data) => emit('info', `${namespace}.${scope}`, data),
+        dwarn: (scope, data) => emit('warn', `${namespace}.${scope}`, data),
+    };
+}
+/** Pour les tests ou les apps qui veulent contrôler l'activation. */
+export function isDebugEnabled() {
+    return ENABLED;
+}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@mostajs/audit",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Reusable audit logging module — fire-and-forget logAudit() with paginated consultation",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
-  "license": "MIT",
+  "license": "AGPL-3.0-or-later",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",