@peac/audit 0.10.9

package/dist/jsonl.d.ts

@@ -0,0 +1,111 @@
+/**
+ * JSONL Formatting and Parsing (v0.9.27+)
+ *
+ * JSONL (JSON Lines) is the normative format for PEAC audit logs.
+ * Each line is a complete, valid JSON object representing one audit entry.
+ *
+ * @see https://jsonlines.org/
+ */
+import type { AuditEntry, JsonlOptions, JsonlParseOptions } from './types.js';
+/**
+ * Format an audit entry to a single JSONL line.
+ *
+ * @param entry - Audit entry to format
+ * @param options - Formatting options
+ * @returns JSON string (single line unless pretty=true)
+ *
+ * @example
+ * ```typescript
+ * const line = formatJsonlLine(entry);
+ * // '{"version":"peac.audit/0.9","id":"01ARZ...","event_type":"receipt_issued",...}'
+ * ```
+ */
+export declare function formatJsonlLine(entry: AuditEntry, options?: JsonlOptions): string;
+/**
+ * Format multiple audit entries to JSONL format.
+ *
+ * @param entries - Array of audit entries
+ * @param options - Formatting options
+ * @returns JSONL string (one entry per line)
+ *
+ * @example
+ * ```typescript
+ * const jsonl = formatJsonl(entries);
+ * // '{"version":"peac.audit/0.9",...}\n{"version":"peac.audit/0.9",...}'
+ * ```
+ */
+export declare function formatJsonl(entries: AuditEntry[], options?: JsonlOptions): string;
+/**
+ * Parse result for a single JSONL line.
+ */
+export interface JsonlParseLineResult {
+    ok: true;
+    entry: AuditEntry;
+    lineNumber: number;
+}
+/**
+ * Parse error for a single JSONL line.
+ */
+export interface JsonlParseLineError {
+    ok: false;
+    error: string;
+    lineNumber: number;
+    raw?: string;
+}
+/**
+ * Parse a single JSONL line.
+ *
+ * @param line - JSON string to parse
+ * @param lineNumber - Line number for error reporting
+ * @returns Parse result with entry or error
+ */
+export declare function parseJsonlLine(line: string, lineNumber?: number): JsonlParseLineResult | JsonlParseLineError;
+/**
+ * Parse result for JSONL content.
+ */
+export interface JsonlParseResult {
+    /** Successfully parsed entries */
+    entries: AuditEntry[];
+    /** Parse errors (if skipInvalid=true) */
+    errors: JsonlParseLineError[];
+    /** Total lines processed */
+    totalLines: number;
+    /** Lines successfully parsed */
+    successCount: number;
+    /** Lines that failed to parse */
+    errorCount: number;
+}
+/**
+ * Parse JSONL content to audit entries.
+ *
+ * @param content - JSONL string content
+ * @param options - Parsing options
+ * @returns Parse result with entries and errors
+ *
+ * @example
+ * ```typescript
+ * const result = parseJsonl(jsonlContent, { skipInvalid: true });
+ * console.log(`Parsed ${result.successCount}/${result.totalLines} entries`);
+ * ```
+ */
+export declare function parseJsonl(content: string, options?: JsonlParseOptions): JsonlParseResult;
+/**
+ * Stream-friendly JSONL line appender.
+ *
+ * Creates a function that appends audit entries to a string buffer
+ * in JSONL format, suitable for streaming to files or network.
+ *
+ * @param options - Formatting options
+ * @returns Appender function
+ *
+ * @example
+ * ```typescript
+ * const appender = createJsonlAppender();
+ * for (const entry of entries) {
+ *   const line = appender(entry);
+ *   await stream.write(line);
+ * }
+ * ```
+ */
+export declare function createJsonlAppender(options?: JsonlOptions): (entry: AuditEntry) => string;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../src/jsonl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAKjF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CASjF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAU,GACrB,oBAAoB,GAAG,mBAAmB,CAqC5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB,yCAAyC;IACzC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAE9B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAkDzF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAKzF"}

package/dist/jsonl.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * JSONL Formatting and Parsing (v0.9.27+)
+ *
+ * JSONL (JSON Lines) is the normative format for PEAC audit logs.
+ * Each line is a complete, valid JSON object representing one audit entry.
+ *
+ * @see https://jsonlines.org/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatJsonlLine = formatJsonlLine;
+exports.formatJsonl = formatJsonl;
+exports.parseJsonlLine = parseJsonlLine;
+exports.parseJsonl = parseJsonl;
+exports.createJsonlAppender = createJsonlAppender;
+const entry_js_1 = require("./entry.js");
+/**
+ * Format an audit entry to a single JSONL line.
+ *
+ * @param entry - Audit entry to format
+ * @param options - Formatting options
+ * @returns JSON string (single line unless pretty=true)
+ *
+ * @example
+ * ```typescript
+ * const line = formatJsonlLine(entry);
+ * // '{"version":"peac.audit/0.9","id":"01ARZ...","event_type":"receipt_issued",...}'
+ * ```
+ */
+function formatJsonlLine(entry, options) {
+    if (options?.pretty) {
+        return JSON.stringify(entry, null, 2);
+    }
+    return JSON.stringify(entry);
+}
+/**
+ * Format multiple audit entries to JSONL format.
+ *
+ * @param entries - Array of audit entries
+ * @param options - Formatting options
+ * @returns JSONL string (one entry per line)
+ *
+ * @example
+ * ```typescript
+ * const jsonl = formatJsonl(entries);
+ * // '{"version":"peac.audit/0.9",...}\n{"version":"peac.audit/0.9",...}'
+ * ```
+ */
+function formatJsonl(entries, options) {
+    const lines = entries.map((entry) => formatJsonlLine(entry, { pretty: false }));
+    const result = lines.join('\n');
+    if (options?.trailingNewline && result.length > 0) {
+        return result + '\n';
+    }
+    return result;
+}
+/**
+ * Parse a single JSONL line.
+ *
+ * @param line - JSON string to parse
+ * @param lineNumber - Line number for error reporting
+ * @returns Parse result with entry or error
+ */
+function parseJsonlLine(line, lineNumber = 1) {
+    const trimmed = line.trim();
+    // Skip empty lines
+    if (trimmed.length === 0) {
+        return {
+            ok: false,
+            error: 'Empty line',
+            lineNumber,
+        };
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!(0, entry_js_1.isValidAuditEntry)(parsed)) {
+            return {
+                ok: false,
+                error: 'Invalid audit entry structure',
+                lineNumber,
+                raw: trimmed.length > 100 ? trimmed.substring(0, 100) + '...' : trimmed,
+            };
+        }
+        return {
+            ok: true,
+            entry: parsed,
+            lineNumber,
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: e instanceof Error ? e.message : 'JSON parse error',
+            lineNumber,
+            raw: trimmed.length > 100 ? trimmed.substring(0, 100) + '...' : trimmed,
+        };
+    }
+}
+/**
+ * Parse JSONL content to audit entries.
+ *
+ * @param content - JSONL string content
+ * @param options - Parsing options
+ * @returns Parse result with entries and errors
+ *
+ * @example
+ * ```typescript
+ * const result = parseJsonl(jsonlContent, { skipInvalid: true });
+ * console.log(`Parsed ${result.successCount}/${result.totalLines} entries`);
+ * ```
+ */
+function parseJsonl(content, options) {
+    const lines = content.split('\n');
+    const entries = [];
+    const errors = [];
+    const maxLines = options?.maxLines ?? 0;
+    let processed = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNumber = i + 1;
+        // Skip empty lines
+        if (line.trim().length === 0) {
+            continue;
+        }
+        // Check max lines limit
+        if (maxLines > 0 && processed >= maxLines) {
+            break;
+        }
+        processed++;
+        const result = parseJsonlLine(line, lineNumber);
+        if (result.ok) {
+            entries.push(result.entry);
+        }
+        else {
+            if (options?.skipInvalid) {
+                errors.push(result);
+            }
+            else {
+                // Return immediately on first error if not skipping
+                return {
+                    entries,
+                    errors: [result],
+                    totalLines: processed,
+                    successCount: entries.length,
+                    errorCount: 1,
+                };
+            }
+        }
+    }
+    return {
+        entries,
+        errors,
+        totalLines: processed,
+        successCount: entries.length,
+        errorCount: errors.length,
+    };
+}
+/**
+ * Stream-friendly JSONL line appender.
+ *
+ * Creates a function that appends audit entries to a string buffer
+ * in JSONL format, suitable for streaming to files or network.
+ *
+ * @param options - Formatting options
+ * @returns Appender function
+ *
+ * @example
+ * ```typescript
+ * const appender = createJsonlAppender();
+ * for (const entry of entries) {
+ *   const line = appender(entry);
+ *   await stream.write(line);
+ * }
+ * ```
+ */
+function createJsonlAppender(options) {
+    return (entry) => {
+        const line = formatJsonlLine(entry, { pretty: false });
+        return line + '\n';
+    };
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../src/jsonl.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * PEAC Audit Types (v0.9.27+)
+ *
+ * Type definitions for audit logging and case bundle generation.
+ * These types define the normative JSONL audit log format.
+ */
+/**
+ * Audit event categories aligned with PEAC operations.
+ */
+export type AuditEventType = 'receipt_issued' | 'receipt_verified' | 'receipt_denied' | 'access_decision' | 'dispute_filed' | 'dispute_acknowledged' | 'dispute_resolved' | 'dispute_rejected' | 'dispute_appealed' | 'dispute_final' | 'attribution_created' | 'attribution_verified' | 'identity_verified' | 'identity_rejected' | 'policy_evaluated';
+/**
+ * Audit event severity levels.
+ */
+export type AuditSeverity = 'info' | 'warn' | 'error' | 'critical';
+/**
+ * W3C Trace Context for correlation.
+ *
+ * @see https://www.w3.org/TR/trace-context/
+ */
+export interface TraceContext {
+    /** Trace ID (32 hex characters) */
+    trace_id: string;
+    /** Span ID (16 hex characters) */
+    span_id: string;
+    /** Parent span ID (optional) */
+    parent_span_id?: string;
+    /** Trace flags (optional, default 00) */
+    trace_flags?: string;
+}
+/**
+ * Actor information for audit entries.
+ * May be a user, agent, or system component.
+ */
+export interface AuditActor {
+    /** Actor type */
+    type: 'user' | 'agent' | 'system';
+    /** Actor identifier (URI, DID, or opaque ID) */
+    id: string;
+    /** Human-readable name (optional) */
+    name?: string;
+}
+/**
+ * Resource affected by the audit event.
+ */
+export interface AuditResource {
+    /** Resource type */
+    type: 'receipt' | 'attribution' | 'identity' | 'policy' | 'dispute' | 'content';
+    /** Resource identifier (jti, URL, ref, etc.) */
+    id: string;
+    /** Resource URI (optional) */
+    uri?: string;
+}
+/**
+ * Outcome of the audited operation.
+ */
+export interface AuditOutcome {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Result code (e.g., 'allowed', 'denied', 'upheld') */
+    result?: string;
+    /** Error code if failed */
+    error_code?: string;
+    /** Human-readable message */
+    message?: string;
+}
+/**
+ * Core audit entry structure (JSONL normative format).
+ *
+ * Each line in a JSONL audit log is one AuditEntry serialized as JSON.
+ * Fields are ordered for consistent serialization.
+ */
+export interface AuditEntry {
+    /** PEAC audit format version */
+    version: 'peac.audit/0.9';
+    /** Unique entry identifier (ULID recommended) */
+    id: string;
+    /** Event type from controlled vocabulary */
+    event_type: AuditEventType;
+    /** ISO 8601 timestamp with timezone */
+    timestamp: string;
+    /** Event severity level */
+    severity: AuditSeverity;
+    /** Optional trace context for distributed tracing */
+    trace?: TraceContext;
+    /** Actor who triggered the event */
+    actor: AuditActor;
+    /** Resource affected by the event */
+    resource: AuditResource;
+    /** Outcome of the operation */
+    outcome: AuditOutcome;
+    /** Additional context (privacy-safe, no PII) */
+    context?: Record<string, unknown>;
+    /** Dispute reference if related to a dispute (ULID format) */
+    dispute_ref?: string;
+}
+/**
+ * Case bundle containing related audit entries for a dispute.
+ *
+ * A case bundle gathers all relevant events for dispute resolution,
+ * organized chronologically with trace correlation.
+ */
+export interface CaseBundle {
+    /** PEAC case bundle format version */
+    version: 'peac.bundle/0.9';
+    /** Dispute reference this bundle is for (ULID) */
+    dispute_ref: string;
+    /** When the bundle was generated */
+    generated_at: string;
+    /** Who generated the bundle */
+    generated_by: string;
+    /** Audit entries in chronological order */
+    entries: AuditEntry[];
+    /** Unique trace IDs involved in this case */
+    trace_ids: string[];
+    /** Summary statistics */
+    summary: CaseBundleSummary;
+}
+/**
+ * Summary statistics for a case bundle.
+ */
+export interface CaseBundleSummary {
+    /** Total number of entries */
+    entry_count: number;
+    /** Count by event type */
+    by_event_type: Record<string, number>;
+    /** Count by severity */
+    by_severity: Record<AuditSeverity, number>;
+    /** Earliest event timestamp */
+    first_event: string;
+    /** Latest event timestamp */
+    last_event: string;
+    /** Unique actors involved */
+    actor_count: number;
+    /** Unique resources affected */
+    resource_count: number;
+}
+/**
+ * Options for creating audit entries.
+ */
+export interface CreateAuditEntryOptions {
+    /** Optional ID (generated if not provided) */
+    id?: string;
+    /** Event type */
+    event_type: AuditEventType;
+    /** Severity level (defaults to 'info') */
+    severity?: AuditSeverity;
+    /** Trace context for correlation */
+    trace?: TraceContext;
+    /** Actor information */
+    actor: AuditActor;
+    /** Resource affected */
+    resource: AuditResource;
+    /** Operation outcome */
+    outcome: AuditOutcome;
+    /** Additional context */
+    context?: Record<string, unknown>;
+    /** Dispute reference if applicable */
+    dispute_ref?: string;
+    /** Timestamp (current time if not provided) */
+    timestamp?: string;
+}
+/**
+ * Options for creating a case bundle.
+ */
+export interface CreateCaseBundleOptions {
+    /** Dispute reference (ULID) */
+    dispute_ref: string;
+    /** Who is generating the bundle */
+    generated_by: string;
+    /** Audit entries to include */
+    entries: AuditEntry[];
+}
+/**
+ * JSONL formatting options.
+ */
+export interface JsonlOptions {
+    /** Pretty print each entry (for debugging, not production) */
+    pretty?: boolean;
+    /** Include newline at end of output */
+    trailingNewline?: boolean;
+}
+/**
+ * JSONL parsing options.
+ */
+export interface JsonlParseOptions {
+    /** Skip invalid lines instead of throwing */
+    skipInvalid?: boolean;
+    /** Maximum lines to parse (0 = unlimited) */
+    maxLines?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * PEAC Audit Types (v0.9.27+)
+ *
+ * Type definitions for audit logging and case bundle generation.
+ * These types define the normative JSONL audit log format.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/verification-report.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Verification Report (v0.9.30+)
+ *
+ * Deterministic verification of dispute bundles with JCS-canonicalized reports.
+ * The report_hash enables cross-language parity: TS and Go implementations
+ * must produce identical hashes for the same bundle verification.
+ *
+ * Key design principles:
+ * 1. Real Ed25519 signature verification using @peac/crypto
+ * 2. No timestamps in deterministic output
+ * 3. All arrays sorted by stable keys for reproducibility
+ */
+import type { BundleResult, VerificationReport, VerifyBundleOptions } from './dispute-bundle-types.js';
+/**
+ * Verify all receipts in a dispute bundle and generate a deterministic report.
+ *
+ * @param zipBuffer - Buffer containing the ZIP archive
+ * @param options - Verification options
+ * @returns Promise resolving to a deterministic verification report
+ *
+ * @example
+ * ```typescript
+ * const zipData = fs.readFileSync('dispute-bundle.zip');
+ * const result = await verifyBundle(zipData, { offline: true });
+ *
+ * if (result.ok) {
+ *   console.log('Report hash:', result.value.report_hash);
+ *   console.log('Summary:', result.value.auditor_summary.headline);
+ * }
+ * ```
+ */
+export declare function verifyBundle(zipBuffer: Buffer, options: VerifyBundleOptions): Promise<BundleResult<VerificationReport>>;
+/**
+ * Serialize a verification report to JSON.
+ *
+ * @param report - Verification report
+ * @param pretty - Pretty print (default: false)
+ * @returns JSON string
+ */
+export declare function serializeReport(report: VerificationReport, pretty?: boolean): string;
+/**
+ * Format verification report as human-readable text.
+ *
+ * @param report - Verification report
+ * @returns Human-readable text summary
+ */
+export declare function formatReportText(report: VerificationReport): string;
+//# sourceMappingURL=verification-report.d.ts.map

package/dist/verification-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-report.d.ts","sourceRoot":"","sources":["../src/verification-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAGV,YAAY,EAMZ,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AA8anC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CA4E3C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAE,OAAe,GAAG,MAAM,CAK3F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuEnE"}