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/kernel";
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
Start application
bash
bun devMigrations run automatically on boot via MigrationServiceProvider.
Keep 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
Veap Kernel
@veap/kernel (^0.1.0)
Required Veap Plugins
NPM Packages
lucide-react@^1.27.0
Authors & Maintainers
Veap Core Team
Maintainer
