# @nestarc/audit-log

> NestJS audit logging with Prisma change tracking and PostgreSQL storage.

Use published @nestarc/audit-log@0.6.0 for the baseline Quick Start (npm verified 2026-09-29).
The current checkout has 0.7.0 Unreleased changes under a 0.7.0 manifest; candidate artifacts differ
from the registry release. actorRequired and defineAuditConfig are candidate-only. Check the
installed package source, declarations and [CHANGELOG](CHANGELOG.md) before choosing examples.

## Adoption and API guides

- [README](README.md): requirements, setup, first event, and guide index.
- [Adoption guide](docs/adoption-guide.md): manual events, one-model tracking, role changes, authorized reads, and verification.
- [Agent usage guide](docs/agent-guide.md): version boundaries and implementation recipes.
- [Runnable example](examples/quick-start/README.md): Nest HTTP, Prisma generation, migrations, and smoke verification.
- [API reference](docs/api-reference.md): public configuration and return contracts.
- [Transactions](docs/transactions.md): atomic-required, unsupported operations, and lifecycle integration.
- [Actor and tenancy](docs/context-and-tenancy.md): authenticated actors, jobs, and explicit query scope.
- [Storage and retention](docs/storage-and-retention.md): privileges, partitions, and maintenance.
- [Export and streams](docs/export-and-streams.md): checkpoints, delivery retries, and late-commit limitations.
- [Changelog](CHANGELOG.md): version changes.
- [Candidate installation](docs/maintaining.md#candidate-documentation-example): build/pack and isolated consumer checks.

## Release references

- [Published 0.5.0 README](https://github.com/nestarc/nestjs-audit-log/blob/v0.5.0/README.md)
- [Official documentation](https://nestarc.dev/packages/audit-log/)
- [npm package](https://www.npmjs.com/package/@nestarc/audit-log)

Historical dated plans and design documents are implementation history, not current API
instructions. Types are shipped at dist/index.d.ts. The llms.txt index is optional navigation;
it does not grant permissions or override an application's policies.