@mostajs/audit 2.0.3 → 2.1.0

package/dist/index.d.ts

@@ -5,4 +5,9 @@ export { createAuditHandlers } from './api/route';
 export { auditMenuContribution } from './lib/menu';
 export { default as AuditPage } from './pages/AuditPage';
 export { t as auditT } from './lib/i18n';
+export { auditToCsv, auditToJson } from './lib/export';
+export type { ExportOptions } from './lib/export';
+export { createAuditExportHandler } from './lib/handlers/audit-export';
+export { getAuditStats } from './lib/audit-stats';
+export type { AuditStats } from './lib/audit-stats';
 export type { MostaAuditConfig, AuditParams, AuditFilters, AuditLogDTO, } from './types/index';

package/dist/index.js

@@ -13,3 +13,10 @@ export { auditMenuContribution } from './lib/menu';
 export { default as AuditPage } from './pages/AuditPage';
 // I18n
 export { t as auditT } from './lib/i18n';
+// Cloud modules
+// Export
+export { auditToCsv, auditToJson } from './lib/export';
+// Export handler
+export { createAuditExportHandler } from './lib/handlers/audit-export';
+// Audit stats
+export { getAuditStats } from './lib/audit-stats';

package/dist/lib/audit-factory.js

@@ -15,6 +15,10 @@ export async function getAuditRepo() {
     const { AuditLogRepository } = await import('../repositories/audit-log.repository.js');
     registerSchemas([AuditLogSchema]);
     const dialect = await getDialect();
+    if (typeof dialect.initSchema === 'function') {
+        const { getAllSchemas } = await import('@mostajs/orm');
+        await dialect.initSchema(getAllSchemas());
+    }
     _cached = new AuditLogRepository(dialect);
     return _cached;
 }

package/dist/lib/audit-stats.d.ts

@@ -0,0 +1,15 @@
+export interface AuditStats {
+    totalLogs: number;
+    byModule: Record<string, number>;
+    byAction: Record<string, number>;
+    byStatus: {
+        success: number;
+        failure: number;
+    };
+    topUsers: {
+        userName: string;
+        count: number;
+    }[];
+    recentErrors: any[];
+}
+export declare function getAuditStats(repo: any, days?: number): Promise<AuditStats>;

package/dist/lib/audit-stats.js

@@ -0,0 +1,33 @@
+// @mostajs/audit — Audit statistics helpers
+// Author: Dr Hamid MADANI drmdh@msn.com
+export async function getAuditStats(repo, days = 30) {
+    const cutoff = new Date(Date.now() - days * 86400000);
+    // Get all logs in period
+    const { data, total } = await repo.findPaginated({
+        page: 1,
+        limit: 10000,
+        dateFrom: cutoff.toISOString(),
+    });
+    const byModule = {};
+    const byAction = {};
+    const byStatus = { success: 0, failure: 0 };
+    const userCounts = {};
+    for (const log of data) {
+        byModule[log.module] = (byModule[log.module] ?? 0) + 1;
+        byAction[log.action] = (byAction[log.action] ?? 0) + 1;
+        if (log.status === 'success')
+            byStatus.success++;
+        else
+            byStatus.failure++;
+        if (log.userName)
+            userCounts[log.userName] = (userCounts[log.userName] ?? 0) + 1;
+    }
+    const topUsers = Object.entries(userCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([userName, count]) => ({ userName, count }));
+    const recentErrors = data
+        .filter((l) => l.status === 'failure')
+        .slice(0, 20);
+    return { totalLogs: total, byModule, byAction, byStatus, topUsers, recentErrors };
+}

package/dist/lib/export.d.ts

@@ -0,0 +1,10 @@
+export interface ExportOptions {
+    format: 'csv' | 'json';
+    from?: string;
+    to?: string;
+    module?: string;
+    action?: string;
+    limit?: number;
+}
+export declare function auditToCsv(logs: any[]): string;
+export declare function auditToJson(logs: any[]): string;

package/dist/lib/export.js

@@ -0,0 +1,26 @@
+// @mostajs/audit — Export audit logs to CSV/JSON
+// Author: Dr Hamid MADANI drmdh@msn.com
+export function auditToCsv(logs) {
+    if (logs.length === 0)
+        return '';
+    const headers = ['timestamp', 'userName', 'userRole', 'module', 'action', 'resource', 'resourceId', 'status', 'ipAddress', 'details'];
+    const rows = logs.map(log => {
+        return headers.map(h => {
+            let val = log[h] ?? '';
+            if (h === 'details' && typeof val === 'object')
+                val = JSON.stringify(val);
+            if (h === 'timestamp' && val instanceof Date)
+                val = val.toISOString();
+            // Escape CSV
+            const str = String(val);
+            if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+                return '"' + str.replace(/"/g, '""') + '"';
+            }
+            return str;
+        }).join(',');
+    });
+    return [headers.join(','), ...rows].join('\n');
+}
+export function auditToJson(logs) {
+    return JSON.stringify(logs, null, 2);
+}

package/dist/lib/handlers/audit-export.d.ts

@@ -0,0 +1 @@
+export declare function createAuditExportHandler(getRepo: () => any, checkPermission?: (perm: string) => Promise<any>): (req: Request) => Promise<Response>;

package/dist/lib/handlers/audit-export.js

@@ -0,0 +1,47 @@
+// @mostajs/audit — Export handler
+// Author: Dr Hamid MADANI drmdh@msn.com
+import { auditToCsv, auditToJson } from '../export.js';
+export function createAuditExportHandler(getRepo, checkPermission) {
+    return async function GET(req) {
+        // Check permission if provided
+        if (checkPermission) {
+            const check = await checkPermission('audit:export');
+            if (check?.error)
+                return check.error;
+        }
+        const url = new URL(req.url);
+        const format = url.searchParams.get('format') ?? 'json';
+        const from = url.searchParams.get('from') ?? undefined;
+        const to = url.searchParams.get('to') ?? undefined;
+        const module = url.searchParams.get('module') ?? undefined;
+        const limit = parseInt(url.searchParams.get('limit') ?? '10000', 10);
+        const repo = getRepo();
+        const filter = {};
+        if (module)
+            filter.module = module;
+        if (from || to) {
+            filter.timestamp = {};
+            if (from)
+                filter.timestamp.$gte = new Date(from);
+            if (to)
+                filter.timestamp.$lte = new Date(to);
+        }
+        const { data } = await repo.findPaginated({ ...filter, page: 1, limit });
+        if (format === 'csv') {
+            const csv = auditToCsv(data);
+            return new Response(csv, {
+                headers: {
+                    'Content-Type': 'text/csv; charset=utf-8',
+                    'Content-Disposition': `attachment; filename="audit-export-${new Date().toISOString().slice(0, 10)}.csv"`,
+                },
+            });
+        }
+        const json = auditToJson(data);
+        return new Response(json, {
+            headers: {
+                'Content-Type': 'application/json; charset=utf-8',
+                'Content-Disposition': `attachment; filename="audit-export-${new Date().toISOString().slice(0, 10)}.json"`,
+            },
+        });
+    };
+}

package/dist/test-scripts/test-unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-scripts/test-unit.js

@@ -0,0 +1,75 @@
+// @mostajs/audit — Tests unitaires (no DB needed)
+// Author: Dr Hamid MADANI drmdh@msn.com
+import { auditToCsv, auditToJson, } from '../lib/export.js';
+let passed = 0;
+let failed = 0;
+function assert(condition, label) {
+    if (condition) {
+        passed++;
+        console.log('  ✅', label);
+    }
+    else {
+        failed++;
+        console.error('  ❌', label);
+    }
+}
+async function run() {
+    // ── T1 — CSV export ──
+    console.log('T1 — CSV export');
+    const sampleLogs = [
+        {
+            timestamp: '2026-04-01T10:00:00.000Z',
+            userName: 'admin', userRole: 'superadmin',
+            module: 'cloud', action: 'project_create',
+            resource: 'Project', resourceId: 'proj-1',
+            status: 'success', ipAddress: '192.168.1.1',
+            details: { name: 'MyProject' },
+        },
+        {
+            timestamp: '2026-04-02T12:00:00.000Z',
+            userName: 'user1', userRole: 'admin',
+            module: 'billing', action: 'payment_success',
+            resource: 'Subscription', resourceId: 'sub-42',
+            status: 'success', ipAddress: '10.0.0.5',
+            details: null,
+        },
+    ];
+    const csv = auditToCsv(sampleLogs);
+    const lines = csv.split('\n');
+    assert(lines.length === 3, 'CSV has 3 lines (header + 2 rows)');
+    assert(lines[0] === 'timestamp,userName,userRole,module,action,resource,resourceId,status,ipAddress,details', 'CSV header correct');
+    assert(lines[1].includes('admin'), 'row 1 contains admin');
+    assert(lines[2].includes('user1'), 'row 2 contains user1');
+    console.log('');
+    // ── T2 — JSON export ──
+    console.log('T2 — JSON export');
+    const json = auditToJson(sampleLogs);
+    const parsed = JSON.parse(json);
+    assert(Array.isArray(parsed), 'JSON output is array');
+    assert(parsed.length === 2, 'JSON has 2 entries');
+    assert(parsed[0].userName === 'admin', 'first entry userName = admin');
+    console.log('');
+    // ── T3 — CSV empty ──
+    console.log('T3 — CSV empty');
+    assert(auditToCsv([]) === '', 'empty array → empty string');
+    console.log('');
+    // ── T4 — CSV escaping ──
+    console.log('T4 — CSV escaping');
+    const logsWithComma = [{
+            timestamp: '2026-04-01T10:00:00.000Z',
+            userName: 'user, with comma', userRole: 'admin',
+            module: 'cloud', action: 'project_create',
+            resource: 'Project', resourceId: 'proj-1',
+            status: 'success', ipAddress: '192.168.1.1', details: null,
+        }];
+    const csvEscaped = auditToCsv(logsWithComma);
+    assert(csvEscaped.includes('"user, with comma"'), 'value with comma is quoted');
+    console.log('');
+    // ── Summary ──
+    console.log('════════════════════════════════════════');
+    console.log(`  Resultats: ${passed} passed, ${failed} failed`);
+    console.log('════════════════════════════════════════');
+    if (failed > 0)
+        process.exit(1);
+}
+run().catch(e => { console.error('❌ Fatal:', e.message); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/audit",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "Reusable audit logging module — fire-and-forget logAudit() with paginated consultation",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "MIT",
@@ -52,6 +52,21 @@
       "types": "./dist/lib/module-info.d.ts",
       "import": "./dist/lib/module-info.js",
       "default": "./dist/lib/module-info.js"
+    },
+    "./lib/export": {
+      "types": "./dist/lib/export.d.ts",
+      "import": "./dist/lib/export.js",
+      "default": "./dist/lib/export.js"
+    },
+    "./lib/audit-stats": {
+      "types": "./dist/lib/audit-stats.d.ts",
+      "import": "./dist/lib/audit-stats.js",
+      "default": "./dist/lib/audit-stats.js"
+    },
+    "./lib/handlers/audit-export": {
+      "types": "./dist/lib/handlers/audit-export.d.ts",
+      "import": "./dist/lib/handlers/audit-export.js",
+      "default": "./dist/lib/handlers/audit-export.js"
     }
   },
   "files": [