@mostajs/audit

Fire-and-forget audit logging with paginated consultation. Author: Dr Hamid MADANI [email protected]

Install

npm install @mostajs/audit @mostajs/orm

How to Use

1. Log an Action

import { logAudit, getAuditUser } from '@mostajs/audit'

await logAudit({
  ...getAuditUser(session),
  action: 'user_create',
  module: 'users',
  resource: 'John Doe',
  resourceId: user.id,
  details: { email: '[email protected]' },
})
// Fire-and-forget — never throws, never blocks

2. API Handler (paginated consultation)

import { createAuditHandlers } from '@mostajs/audit/api/route'
export const { GET } = createAuditHandlers('audit:view', checkPermission)
// GET /api/audit-log?page=1&limit=50&module=users&action=create

3. Module Info (for @mostajs/setup)

import { getSchemas } from '@mostajs/audit/lib/module-info'
const schemas = getSchemas() // [AuditLogSchema]

4. Dual ORM/NET Mode

Works automatically via getAuditRepo() — reads MOSTA_DATA=orm|net from environment.