Overview
Production integrations for @absolutejs/audit. Install only the adapters your application needs; every package implements the core audit contracts without coupling the application to a storage or web framework.
Audit Adapters
audit-adaptersworkspacealphaObservabilityMonorepo root for @absolutejs/audit storage adapters. Subpackages live in ./<name>/ and publish independently.
#Installation
BASH
git clone https://github.com/absolutejs/audit-adapters.git#Capabilities
Overview
Production integrations for @absolutejs/audit. Install only the adapters your application needs; every package implements the core audit contracts without coupling the application to a storage or web framework.
Packages
Package — Purpose
@absolutejs/audit-elysia — Emits one structured audit event for every Elysia request, including error paths and optional OpenTelemetry correlation.
@absolutejs/audit-postgres — Durable PostgreSQL audit history with Drizzle and tagged-template adapters, JSONB metadata, and indexed queries.
Show 1 more
@absolutejs/audit-s3 — Buffered JSONL audit archives for S3-compatible storage, including R2, B2, and MinIO.
Choose an adapter
Use the Elysia adapter at the request boundary, PostgreSQL when operators need searchable history, and S3-compatible storage for inexpensive long-term or WORM retention. Applications can compose multiple sinks when they need both operational queries and compliance archives.
Each package has its own README with setup, configuration, and operational guidance.
Repository composition
3 public packages and 0 private workspace projects are versioned and developed together.
Outcomes
What you can build
Packages
Package — Purpose
Choose an adapter
Use the Elysia adapter at the request boundary, PostgreSQL when operators need searchable history, and S3-compatible storage for inexpensive long-term or WORM retention. Applications can compose multiple sinks when they need both operational queries and compliance archives.
Hardening checklist
Production guidance
OverviewProduction integrations for @absolutejs/audit. Install only the adapters your application needs; every package implements the core audit contracts without coupling the application to a storage or web framework.
Follow in order
Troubleshooting path
1
Trace from the first failed boundary
Reproduce the smallest canonical audit-adapters example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.
#Choose an adapter
Partial snippetUse the Elysia adapter at the request boundary, PostgreSQL when operators need searchable history, and S3-compatible storage for inexpensive long-term or WORM retention. Applications can compose multiple sinks when they need both operational queries and compliance archives.
SH
bun add @absolutejs/audit @absolutejs/audit-elysia @absolutejs/audit-postgres#Workspace contents
3 public packages and 0 private workspace projects are maintained in this repository.
@absolutejs/audit-elysiav0.1.2
Public package — Elysia plugin emitting one structured audit event per request into @absolutejs/audit. Wires into onRequest + onAfterResponse so success AND error paths are captured. Orthogonal to @elysiajs/server-timing (perf headers) and @elysiajs/opentelemetry (sampled tracing); optionally correlates with the active OTel trace id.
@absolutejs/audit-postgresv0.1.4
Public package — Postgres-backed AuditSink for @absolutejs/audit with first-class Drizzle and tagged-template adapters, native JSONB metadata, and indexed history.
@absolutejs/audit-s3v0.1.1
Public package — S3-compatible AuditSink for @absolutejs/audit. Buffered JSONL writes to AWS S3 / Cloudflare R2 / Backblaze B2 / MinIO. Time-sortable object keys; WORM-bucket-friendly for compliance retention.
Workspace project
This workspace project is not published as a standalone npm package. Use its repository and the accurately labeled public or private workspace contents below.