@mostajs/audit 2.1.2 → 2.2.0

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,6 +1,6 @@
 {
   "name": "@mostajs/audit",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Reusable audit logging module — fire-and-forget logAudit() with paginated consultation",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",