# @nestarc/audit-log

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

Check the installed package version and CHANGELOG before using examples. The current checkout
is version 0.6.0. Version 0.6.0 introduces actorExtractionStage
and corrects nested-parent guards, caught-audit-error rollback, and completed-scan replay handling.
These changes are not in the published 0.5.0 tarball. Use the installed README and declarations
for the installed artifact, or the v0.5.0 tag for that release.

## Current checkout

- [README](README.md): requirements, setup, first event, and guide index.
- [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.

## 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.