Purpose & Overview
Records tamper-evident audit logs of user actions, model changes, authentication events, and administrative overrides.
Installation & Setup
1
Install the package
bash
bun veap add @veap/activity-plugin2
Register in lib/veap.ts (or auto via lib/plugins.gen.ts)
lib/veap.ts
typescript
// lib/veap.ts
import { Application } from "@veap/core/core/server";
import activityPlugin from "@veap/activity-plugin";
export const app = Application.configure()
.withPlugins([activityPlugin])
.create();
// Recording an audit activity programmatically:
import { ActivityLog } from "@veap/activity-plugin";
await ActivityLog.record({
userId: "user-uuid",
action: "settings:update",
description: "Updated billing email",
ipAddress: "127.0.0.1"
});3
Run database migrations
bash
bun run veap migrateKeep in mind
- Runs in the background via EventBus, listening for system events and model mutations.
- Provides an activity log dashboard view with filtering by date, user, and event type.
- Delivers an audit trail to meet enterprise application compliance and security requirements.
Dependencies
Authors & Maintainers
Veap Core Team
Maintainer
Specifications
- License
- MIT
- Type
- plugin
- Status
- official
- Repository
- GitHub →
- Issues
- Report issue →
