@peac/audit provides structured audit logging in JSONL format, case bundle generation for dispute resolution, and commerce evidence bundling for multi-protocol payment observations. It includes trace correlation via W3C Trace Context, dispute bundle creation with cryptographic integrity verification, and privacy-safe logging patterns.

How Do I Use It?

Create and format audit entries

import { createAuditEntry, formatJsonl } from '@peac/audit';

const entry = createAuditEntry({
  event_type: 'receipt_issued',
  actor: { type: 'system', id: 'peac-issuer' },
  resource: { type: 'receipt', id: 'jti:rec_abc123' },
  outcome: { success: true, result: 'issued' },
});

const jsonl = formatJsonl([entry]);

Build a dispute bundle with integrity verification

import { createDisputeBundle, verifyBundle } from '@peac/audit';

const bundle = await createDisputeBundle({
  kind: 'dispute',
  receipts: [{ jws: compactJws, ref: receiptRef }],
  jwks: { keys: [publicJwk] },
});

const report = await verifyBundle({ bundle });
console.log(report.summary);

Correlate entries by trace

import { correlateByTrace, filterByTimeRange } from '@peac/audit';

const recent = filterByTimeRange(entries, {
  start: '2026-03-01T00:00:00Z',
  end: '2026-03-29T00:00:00Z',
});

const traces = correlateByTrace(recent);
for (const t of traces) {
  console.log(`Trace ${t.trace_id}: ${t.entries.length} events`);
}