hazo_audit 2.0.1 → 2.1.0

package/dist/index.d.ts

@@ -26,7 +26,50 @@ export interface FieldAuditProps {
     subjectId: string;
     /** Base path for audit routes. Defaults to `/api/audit`. */
     api_base?: string;
+    /**
+     * Map of intent `event_name` → display label.  When an intent event shares a
+     * `correlation_id` with a field event, the field event's actor line is
+     * suffixed with ` (via <label>)` so users can see when a value came from
+     * prefill / import / export rather than direct typing.
+     *
+     * Apps emit intents via `auditIntent(adapter, name, callback, opts)` from
+     * `hazo_audit/server`; the package handles the correlation lookup.
+     *
+     * Example:
+     * ```ts
+     * intentLabels={{
+     *   survey_prefill_key_info: 'auto-fill',
+     *   wp_pdf_prefill: 'PDF import',
+     * }}
+     * ```
+     *
+     * `.completed` and `.failed` suffixes are stripped before lookup, so the map
+     * only needs the bare event names.
+     */
+    intentLabels?: Record<string, string>;
+    /**
+     * Override the op badge labels rendered next to each event in the trail.
+     * Defaults to `{ insert: 'Added', update: 'Changed', delete: 'Removed' }`.
+     *
+     * Pass any subset to override individual ops; unspecified ops keep the
+     * defaults. Pass an empty string to fall back to the raw DB op (lowercased).
+     */
+    opLabels?: OpLabels;
 }
+/**
+ * Friendly op label overrides for the audit trail badge. Keys correspond to
+ * the database `op` value on `hazo_audit_field` rows.
+ */
+export interface OpLabels {
+    insert?: string;
+    update?: string;
+    delete?: string;
+}
+/**
+ * Default friendly labels for the op badge. Action-oriented, past-tense so
+ * the badge reads naturally next to the actor: "Added by Pubs Abayasiri".
+ */
+export declare const DEFAULT_OP_LABELS: Required<OpLabels>;
 /**
  * Canonicalises a JSONB path (e.g., `working_paper.sections.0.name`) into a
  * stable, human-readable identifier. Apps register these by name in

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -17,4 +17,13 @@
 export const AUDIT_VIEW_HISTORY = 'view_audit_history';
 export const AUDIT_VIEW_SENSITIVE = 'view_sensitive_audit';
 export const AUDIT_VIEW_ACROSS_SCOPES = 'view_audit_across_scopes';
+/**
+ * Default friendly labels for the op badge. Action-oriented, past-tense so
+ * the badge reads naturally next to the actor: "Added by Pubs Abayasiri".
+ */
+export const DEFAULT_OP_LABELS = {
+    insert: 'Added',
+    update: 'Changed',
+    delete: 'Removed',
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,2EAA2E;AAC3E,+DAA+D;AAC/D,gFAAgF;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAA6B,CAAC;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAA+B,CAAC;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,2EAA2E;AAC3E,+DAA+D;AAC/D,gFAAgF;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAA6B,CAAC;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAA+B,CAAC;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAAmC,CAAC;AAuE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CAClB,CAAC"}

package/dist/lib/config/hazo_audit_config.d.ts

@@ -0,0 +1,99 @@
+/**
+ * hazo_audit standard workspace-configuration schema + loader.
+ *
+ * Wraps hazo_core's `loadConfig` with a Zod schema that mirrors the
+ * `[general]` and `[log.overrides]` sections of `config/hazo_audit_config.ini`.
+ *
+ * Capture / retention / worker / overrides sections continue to be loaded
+ * by `src/server/config.ts::loadAuditConfig()` — that's the package-specific
+ * runtime config layer and is kept separate so the workspace-standard loader
+ * stays a thin Zod wrapper.
+ *
+ * Resolution order (per hazo_core/loadConfig):
+ *   1. <pkg>_config.ini at process.cwd()/config/ or package root
+ *   2. <pkg>_config.<HAZO_ENV>.ini overlay
+ *   3. HAZO_AUDIT_<SECTION>_<KEY> env-var overrides
+ */
+import { z } from 'zod';
+declare const schema: z.ZodNullable<z.ZodObject<{
+    general: z.ZodOptional<z.ZodObject<{
+        env: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        env?: string | undefined;
+    }, {
+        env?: string | undefined;
+    }>>;
+    log: z.ZodOptional<z.ZodObject<{
+        overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        overrides?: Record<string, string> | undefined;
+    }, {
+        overrides?: Record<string, string> | undefined;
+    }>>;
+    retention: z.ZodOptional<z.ZodObject<{
+        outbox_drained_ttl_days: z.ZodOptional<z.ZodString>;
+        outbox_failed_ttl_days: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        outbox_drained_ttl_days?: string | undefined;
+        outbox_failed_ttl_days?: string | undefined;
+    }, {
+        outbox_drained_ttl_days?: string | undefined;
+        outbox_failed_ttl_days?: string | undefined;
+    }>>;
+    worker: z.ZodOptional<z.ZodObject<{
+        poll_ms: z.ZodOptional<z.ZodString>;
+        max_attempts: z.ZodOptional<z.ZodString>;
+        backoff_initial_ms: z.ZodOptional<z.ZodString>;
+        reaper_interval_ms: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        poll_ms?: string | undefined;
+        max_attempts?: string | undefined;
+        backoff_initial_ms?: string | undefined;
+        reaper_interval_ms?: string | undefined;
+    }, {
+        poll_ms?: string | undefined;
+        max_attempts?: string | undefined;
+        backoff_initial_ms?: string | undefined;
+        reaper_interval_ms?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    log?: {
+        overrides?: Record<string, string> | undefined;
+    } | undefined;
+    general?: {
+        env?: string | undefined;
+    } | undefined;
+    retention?: {
+        outbox_drained_ttl_days?: string | undefined;
+        outbox_failed_ttl_days?: string | undefined;
+    } | undefined;
+    worker?: {
+        poll_ms?: string | undefined;
+        max_attempts?: string | undefined;
+        backoff_initial_ms?: string | undefined;
+        reaper_interval_ms?: string | undefined;
+    } | undefined;
+}, {
+    log?: {
+        overrides?: Record<string, string> | undefined;
+    } | undefined;
+    general?: {
+        env?: string | undefined;
+    } | undefined;
+    retention?: {
+        outbox_drained_ttl_days?: string | undefined;
+        outbox_failed_ttl_days?: string | undefined;
+    } | undefined;
+    worker?: {
+        poll_ms?: string | undefined;
+        max_attempts?: string | undefined;
+        backoff_initial_ms?: string | undefined;
+        reaper_interval_ms?: string | undefined;
+    } | undefined;
+}>>;
+export type AuditStandardConfig = NonNullable<z.infer<typeof schema>>;
+export declare function getAuditConfig(): AuditStandardConfig;
+/** Reset the in-memory cache. Mainly for tests. */
+export declare function resetAuditConfigCache(): void;
+export {};
+//# sourceMappingURL=hazo_audit_config.d.ts.map

package/dist/lib/config/hazo_audit_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_audit_config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/hazo_audit_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BC,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AAItE,wBAAgB,cAAc,IAAI,mBAAmB,CAYpD;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/lib/config/hazo_audit_config.js

@@ -0,0 +1,67 @@
+/**
+ * hazo_audit standard workspace-configuration schema + loader.
+ *
+ * Wraps hazo_core's `loadConfig` with a Zod schema that mirrors the
+ * `[general]` and `[log.overrides]` sections of `config/hazo_audit_config.ini`.
+ *
+ * Capture / retention / worker / overrides sections continue to be loaded
+ * by `src/server/config.ts::loadAuditConfig()` — that's the package-specific
+ * runtime config layer and is kept separate so the workspace-standard loader
+ * stays a thin Zod wrapper.
+ *
+ * Resolution order (per hazo_core/loadConfig):
+ *   1. <pkg>_config.ini at process.cwd()/config/ or package root
+ *   2. <pkg>_config.<HAZO_ENV>.ini overlay
+ *   3. HAZO_AUDIT_<SECTION>_<KEY> env-var overrides
+ */
+import { loadConfig } from 'hazo_core';
+import { z } from 'zod';
+const schema = z
+    .object({
+    general: z
+        .object({
+        env: z.string().optional(),
+    })
+        .optional(),
+    log: z
+        .object({
+        overrides: z.record(z.string(), z.string()).optional(),
+    })
+        .optional(),
+    retention: z
+        .object({
+        outbox_drained_ttl_days: z.string().optional(),
+        outbox_failed_ttl_days: z.string().optional(),
+    })
+        .optional(),
+    worker: z
+        .object({
+        poll_ms: z.string().optional(),
+        max_attempts: z.string().optional(),
+        backoff_initial_ms: z.string().optional(),
+        reaper_interval_ms: z.string().optional(),
+    })
+        .optional(),
+})
+    .nullable();
+let _cached = null;
+export function getAuditConfig() {
+    if (_cached !== null)
+        return _cached;
+    try {
+        _cached =
+            loadConfig({
+                pkg: 'hazo_audit',
+                schema: schema,
+            }) ?? {};
+    }
+    catch {
+        _cached = {};
+    }
+    return _cached;
+}
+/** Reset the in-memory cache. Mainly for tests. */
+export function resetAuditConfigCache() {
+    _cached = null;
+}
+//# sourceMappingURL=hazo_audit_config.js.map

package/dist/lib/config/hazo_audit_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_audit_config.js","sourceRoot":"","sources":["../../../src/lib/config/hazo_audit_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC;KACb,MAAM,CAAC;IACN,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC3B,CAAC;SACD,QAAQ,EAAE;IACb,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC;SACD,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9C,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9C,CAAC;SACD,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC1C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,QAAQ,EAAE,CAAC;AAId,IAAI,OAAO,GAA+B,IAAI,CAAC;AAE/C,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IACrC,IAAI,CAAC;QACH,OAAO;YACL,UAAU,CAAsB;gBAC9B,GAAG,EAAE,YAAY;gBACjB,MAAM,EAAE,MAAe;aACxB,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,qBAAqB;IACnC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/nextjs/index.d.ts

@@ -5,6 +5,12 @@
  * their existing auth system (typically hazo_auth's hazo_get_tenant_auth)
  * without a hard module dep at this layer.
  *
+ * Every handler wraps its body with hazo_core's `withContext` so the
+ * correlation ID flows through every nested log call and downstream
+ * `fetchWithRequestId` outbound request. Errors are routed through
+ * `handleError()` which is HazoError-aware: 5xx → logger.error, 4xx →
+ * logger.warn.
+ *
  * Mounting (Next.js App Router):
  *
  *   // app/api/audit/events/route.ts
@@ -46,6 +52,7 @@ export interface AuditRequest extends Request {
     nextUrl?: URL;
 }
 import type { HazoConnectAdapter } from 'hazo_connect';
+import { type Logger } from '../utils/logger.js';
 export interface AuditAuth {
     user_id: string;
     scope_id: string | null;
@@ -65,6 +72,11 @@ export interface AuditEventsRoutesOptions {
     /** Default page size for list. Defaults to 50, capped at 200. */
     default_limit?: number;
     max_limit?: number;
+    /**
+     * Optional logger override. Defaults to `get_logger()` (hazo_core's
+     * `createLogger('hazo_audit')`).
+     */
+    logger?: Logger;
 }
 type NextHandler = (req: AuditRequest, ctx?: {
     params: Promise<Record<string, string>> | Record<string, string>;

package/dist/nextjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nextjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IAC/D,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AACD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAYvD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,kBAAkB,CAAC;IAClC,qEAAqE;IACrE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,WAAW,GAAG,CACjB,GAAG,EAAE,YAAY,EACjB,GAAG,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACvE,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAC9B,MAAM,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC;CAC9B;AAuCD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,iBAAiB,CA4PnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nextjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IAC/D,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AACD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAWvD,OAAO,EAA0B,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,kBAAkB,CAAC;IAClC,qEAAqE;IACrE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,CACjB,GAAG,EAAE,YAAY,EACjB,GAAG,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACvE,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAC9B,MAAM,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC;CAC9B;AAqED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,iBAAiB,CA4TnB"}