[{"data":1,"prerenderedAt":4671},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-audit-recording":505,"-use-cases-audit-recording-surround":4666},[4,30,80,123,288,420,475],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"children":127,"page":29},"Integrate","\u002Fintegrate","4.integrate",[128,132,200],{"title":36,"path":129,"stem":130,"icon":131},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":133,"path":134,"stem":135,"children":136,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[137,140,180],{"title":36,"path":138,"stem":139,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":141,"path":142,"stem":143,"children":144,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[145,150,155,160,165,170,175],{"title":146,"path":147,"stem":148,"icon":149},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":151,"path":152,"stem":153,"icon":154},"OTLP","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fotlp","4.integrate\u002Fadapters\u002Fcloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F03.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F04.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F06.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"icon":179},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fhyperdx","4.integrate\u002Fadapters\u002Fcloud\u002F07.hyperdx","i-custom-hyperdx",{"title":181,"path":182,"stem":183,"children":184,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[185,190,195],{"title":186,"path":187,"stem":188,"icon":189},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":191,"path":192,"stem":193,"icon":194},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":196,"path":197,"stem":198,"icon":199},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[205,209,214,219,224,229,234,239,244,249,254,259,264,269,273,278,283],{"title":36,"path":206,"stem":207,"icon":208},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":210,"path":211,"stem":212,"icon":213},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":215,"path":216,"stem":217,"icon":218},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":220,"path":221,"stem":222,"icon":223},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":225,"path":226,"stem":227,"icon":228},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":230,"path":231,"stem":232,"icon":233},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":235,"path":236,"stem":237,"icon":238},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":240,"path":241,"stem":242,"icon":243},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":245,"path":246,"stem":247,"icon":248},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":250,"path":251,"stem":252,"icon":253},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":255,"path":256,"stem":257,"icon":258},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":260,"path":261,"stem":262,"icon":263},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":265,"path":266,"stem":267,"icon":268},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":270,"path":271,"stem":272,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":274,"path":275,"stem":276,"icon":277},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":279,"path":280,"stem":281,"icon":282},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":284,"path":285,"stem":286,"icon":287},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":289,"path":290,"stem":291,"children":292,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[293,296,301,330,357,389,410,415],{"title":36,"path":294,"stem":295,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":297,"path":298,"stem":299,"icon":300},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":302,"icon":303,"path":304,"stem":305,"children":306,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[307,310,315,320,325],{"title":36,"path":308,"stem":309,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":311,"path":312,"stem":313,"icon":314},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":316,"path":317,"stem":318,"icon":319},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":321,"path":322,"stem":323,"icon":324},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":326,"path":327,"stem":328,"icon":329},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":331,"icon":332,"path":333,"stem":334,"children":335,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[336,339,344,349,353],{"title":36,"path":337,"stem":338,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":340,"path":341,"stem":342,"icon":343},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":345,"path":346,"stem":347,"icon":348},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":350,"path":351,"stem":352,"icon":300},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":354,"path":355,"stem":356,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":358,"icon":359,"path":360,"stem":361,"children":362,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[363,366,371,376,381,385],{"title":36,"path":364,"stem":365,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":367,"path":368,"stem":369,"icon":370},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":372,"path":373,"stem":374,"icon":375},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":377,"path":378,"stem":379,"icon":380},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":382,"path":383,"stem":384,"icon":359},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":386,"path":387,"stem":388,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":326,"icon":107,"path":390,"stem":391,"children":392,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[393,396,401,406],{"title":36,"path":394,"stem":395,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":397,"path":398,"stem":399,"icon":400},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":402,"path":403,"stem":404,"icon":405},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":407,"path":408,"stem":409,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":411,"path":412,"stem":413,"icon":414},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":416,"path":417,"stem":418,"icon":419},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":421,"path":422,"stem":423,"children":424,"page":29},"Extend","\u002Fextend","6.extend",[425,429,434,439,444,448,452,456,460,465,470],{"title":36,"path":426,"stem":427,"icon":428},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":430,"path":431,"stem":432,"icon":433},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":435,"path":436,"stem":437,"icon":438},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":440,"path":441,"stem":442,"icon":443},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":386,"path":445,"stem":446,"icon":447},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":449,"path":450,"stem":451,"icon":428},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":453,"path":454,"stem":455,"icon":414},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":457,"path":458,"stem":459,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":461,"path":462,"stem":463,"icon":464},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":466,"path":467,"stem":468,"icon":469},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":471,"path":472,"stem":473,"icon":474},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":407,"path":476,"stem":477,"children":478,"page":29},"\u002Freference","7.reference",[479,484,487,492,496,501],{"title":480,"path":481,"stem":482,"icon":483},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":354,"path":485,"stem":486,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":488,"path":489,"stem":490,"icon":491},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":493,"path":494,"stem":495,"icon":359},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":497,"path":498,"stem":499,"icon":500},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":502,"path":503,"stem":504,"icon":414},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":506,"title":507,"body":508,"description":4654,"extension":4655,"links":4656,"meta":4662,"navigation":4663,"path":373,"seo":4664,"stem":374,"__hash__":4665},"docs\u002F5.use-cases\u002F4.audit\u002F03.recording.md","Recording Events",{"type":509,"value":510,"toc":4639},"minimark",[511,515,523,532,762,765,771,777,1399,1406,1411,1778,1798,1804,1809,1975,1983,1989,2015,2399,2412,2510,2610,2621,2624,2675,2689,2693,2699,2776,2782,2795,2801,2807,2842,3510,3517,3523,3541,4595,4598,4635],[512,513,514],"p",{},"Five APIs cover every shape of audit recording: in-request, denied, standalone, auto-instrumented, and typed.",[516,517,519],"h2",{"id":518},"logaudit",[520,521,522],"code",{},"log.audit()",[512,524,525,527,528,531],{},[520,526,522],{}," is sugar over ",[520,529,530],{},"log.set({ audit: ... })"," plus tail-sample force-keep:",[533,534,539],"pre",{"className":535,"code":536,"language":537,"meta":538,"style":538},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","log.audit({\n  action: 'invoice.refund',\n  actor: { type: 'user', id: user.id },\n  target: { type: 'invoice', id: 'inv_889' },\n  outcome: 'success',\n})\n\n\u002F\u002F Strictly equivalent to:\nlog.set({ audit: { action: 'invoice.refund', \u002F* ... *\u002F, version: 1 } })\n","typescript","",[520,540,541,564,587,629,666,683,692,699,706],{"__ignoreMap":538},[542,543,546,550,554,558,561],"span",{"class":544,"line":545},"line",1,[542,547,549],{"class":548},"sTEyZ","log",[542,551,553],{"class":552},"sMK4o",".",[542,555,557],{"class":556},"s2Zo4","audit",[542,559,560],{"class":548},"(",[542,562,563],{"class":552},"{\n",[542,565,567,571,574,577,581,584],{"class":544,"line":566},2,[542,568,570],{"class":569},"swJcz","  action",[542,572,573],{"class":552},":",[542,575,576],{"class":552}," '",[542,578,580],{"class":579},"sfazB","invoice.refund",[542,582,583],{"class":552},"'",[542,585,586],{"class":552},",\n",[542,588,590,593,595,598,601,603,605,608,610,613,616,618,621,623,626],{"class":544,"line":589},3,[542,591,592],{"class":569},"  actor",[542,594,573],{"class":552},[542,596,597],{"class":552}," {",[542,599,600],{"class":569}," type",[542,602,573],{"class":552},[542,604,576],{"class":552},[542,606,607],{"class":579},"user",[542,609,583],{"class":552},[542,611,612],{"class":552},",",[542,614,615],{"class":569}," id",[542,617,573],{"class":552},[542,619,620],{"class":548}," user",[542,622,553],{"class":552},[542,624,625],{"class":548},"id ",[542,627,628],{"class":552},"},\n",[542,630,632,635,637,639,641,643,645,648,650,652,654,656,658,661,663],{"class":544,"line":631},4,[542,633,634],{"class":569},"  target",[542,636,573],{"class":552},[542,638,597],{"class":552},[542,640,600],{"class":569},[542,642,573],{"class":552},[542,644,576],{"class":552},[542,646,647],{"class":579},"invoice",[542,649,583],{"class":552},[542,651,612],{"class":552},[542,653,615],{"class":569},[542,655,573],{"class":552},[542,657,576],{"class":552},[542,659,660],{"class":579},"inv_889",[542,662,583],{"class":552},[542,664,665],{"class":552}," },\n",[542,667,669,672,674,676,679,681],{"class":544,"line":668},5,[542,670,671],{"class":569},"  outcome",[542,673,573],{"class":552},[542,675,576],{"class":552},[542,677,678],{"class":579},"success",[542,680,583],{"class":552},[542,682,586],{"class":552},[542,684,686,689],{"class":544,"line":685},6,[542,687,688],{"class":552},"}",[542,690,691],{"class":548},")\n",[542,693,695],{"class":544,"line":694},7,[542,696,698],{"emptyLinePlaceholder":697},true,"\n",[542,700,702],{"class":544,"line":701},8,[542,703,705],{"class":704},"sHwdD","\u002F\u002F Strictly equivalent to:\n",[542,707,709,711,713,716,718,721,724,726,728,731,733,735,737,739,741,744,746,749,751,755,758,760],{"class":544,"line":708},9,[542,710,549],{"class":548},[542,712,553],{"class":552},[542,714,715],{"class":556},"set",[542,717,560],{"class":548},[542,719,720],{"class":552},"{",[542,722,723],{"class":569}," audit",[542,725,573],{"class":552},[542,727,597],{"class":552},[542,729,730],{"class":569}," action",[542,732,573],{"class":552},[542,734,576],{"class":552},[542,736,580],{"class":579},[542,738,583],{"class":552},[542,740,612],{"class":552},[542,742,743],{"class":704}," \u002F* ... *\u002F",[542,745,612],{"class":552},[542,747,748],{"class":569}," version",[542,750,573],{"class":552},[542,752,754],{"class":753},"sbssI"," 1",[542,756,757],{"class":552}," }",[542,759,757],{"class":552},[542,761,691],{"class":548},[512,763,764],{},"This is the form you'll use most. The audit event lands on the same wide event as the rest of the request.",[516,766,768],{"id":767},"logauditdeny",[520,769,770],{},"log.audit.deny()",[512,772,773,776],{},[520,774,775],{},"log.audit.deny(reason, fields)"," records AuthZ-denied actions. Most teams forget to log denials, but they're exactly what auditors and security teams ask for:",[778,779,780,971],"code-group",{},[533,781,784],{"className":535,"code":782,"filename":783,"language":537,"meta":538,"style":538},"if (!user.canRefund(invoice)) {\n  log.audit.deny('Insufficient permissions', {\n    action: 'invoice.refund',\n    actor: { type: 'user', id: user.id },\n    target: { type: 'invoice', id: invoice.id },\n  })\n  throw createError({ status: 403, message: 'Forbidden' })\n}\n","Input",[520,785,786,810,838,853,887,921,928,966],{"__ignoreMap":538},[542,787,788,792,795,798,800,802,805,808],{"class":544,"line":545},[542,789,791],{"class":790},"s7zQu","if",[542,793,794],{"class":548}," (",[542,796,797],{"class":552},"!",[542,799,607],{"class":548},[542,801,553],{"class":552},[542,803,804],{"class":556},"canRefund",[542,806,807],{"class":548},"(invoice)) ",[542,809,563],{"class":552},[542,811,812,815,817,819,821,824,826,828,831,833,835],{"class":544,"line":566},[542,813,814],{"class":548},"  log",[542,816,553],{"class":552},[542,818,557],{"class":548},[542,820,553],{"class":552},[542,822,823],{"class":556},"deny",[542,825,560],{"class":569},[542,827,583],{"class":552},[542,829,830],{"class":579},"Insufficient permissions",[542,832,583],{"class":552},[542,834,612],{"class":552},[542,836,837],{"class":552}," {\n",[542,839,840,843,845,847,849,851],{"class":544,"line":589},[542,841,842],{"class":569},"    action",[542,844,573],{"class":552},[542,846,576],{"class":552},[542,848,580],{"class":579},[542,850,583],{"class":552},[542,852,586],{"class":552},[542,854,855,858,860,862,864,866,868,870,872,874,876,878,880,882,885],{"class":544,"line":631},[542,856,857],{"class":569},"    actor",[542,859,573],{"class":552},[542,861,597],{"class":552},[542,863,600],{"class":569},[542,865,573],{"class":552},[542,867,576],{"class":552},[542,869,607],{"class":579},[542,871,583],{"class":552},[542,873,612],{"class":552},[542,875,615],{"class":569},[542,877,573],{"class":552},[542,879,620],{"class":548},[542,881,553],{"class":552},[542,883,884],{"class":548},"id",[542,886,665],{"class":552},[542,888,889,892,894,896,898,900,902,904,906,908,910,912,915,917,919],{"class":544,"line":668},[542,890,891],{"class":569},"    target",[542,893,573],{"class":552},[542,895,597],{"class":552},[542,897,600],{"class":569},[542,899,573],{"class":552},[542,901,576],{"class":552},[542,903,647],{"class":579},[542,905,583],{"class":552},[542,907,612],{"class":552},[542,909,615],{"class":569},[542,911,573],{"class":552},[542,913,914],{"class":548}," invoice",[542,916,553],{"class":552},[542,918,884],{"class":548},[542,920,665],{"class":552},[542,922,923,926],{"class":544,"line":685},[542,924,925],{"class":552},"  }",[542,927,691],{"class":569},[542,929,930,933,936,938,940,943,945,948,950,953,955,957,960,962,964],{"class":544,"line":694},[542,931,932],{"class":790},"  throw",[542,934,935],{"class":556}," createError",[542,937,560],{"class":569},[542,939,720],{"class":552},[542,941,942],{"class":569}," status",[542,944,573],{"class":552},[542,946,947],{"class":753}," 403",[542,949,612],{"class":552},[542,951,952],{"class":569}," message",[542,954,573],{"class":552},[542,956,576],{"class":552},[542,958,959],{"class":579},"Forbidden",[542,961,583],{"class":552},[542,963,757],{"class":552},[542,965,691],{"class":569},[542,967,968],{"class":544,"line":701},[542,969,970],{"class":552},"}\n",[533,972,977],{"className":973,"code":974,"filename":975,"language":976,"meta":538,"style":538},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"level\": \"warn\",\n  \"service\": \"billing-api\",\n  \"method\": \"POST\",\n  \"path\": \"\u002Fapi\u002Finvoices\u002Finv_889\u002Frefund\",\n  \"status\": 403,\n  \"duration\": \"12ms\",\n  \"requestId\": \"9c3f7d12-8a45-4e60-b8a9-1f0d4c5e6e7d\",\n  \"audit\": {\n    \"action\": \"invoice.refund\",\n    \"actor\": { \"type\": \"user\", \"id\": \"usr_intruder\" },\n    \"target\": { \"type\": \"invoice\", \"id\": \"inv_889\" },\n    \"outcome\": \"denied\",\n    \"reason\": \"Insufficient permissions\",\n    \"version\": 1,\n    \"idempotencyKey\": \"ak_d12c3a4f5b6e7d8c\",\n    \"context\": {\n      \"requestId\": \"9c3f7d12-8a45-4e60-b8a9-1f0d4c5e6e7d\",\n      \"ip\": \"203.0.113.7\"\n    }\n  }\n}\n","Output — denied","json",[520,978,979,983,1007,1027,1047,1067,1082,1102,1122,1134,1156,1204,1250,1271,1291,1307,1328,1342,1362,1382,1388,1394],{"__ignoreMap":538},[542,980,981],{"class":544,"line":545},[542,982,563],{"class":552},[542,984,985,988,992,995,997,1000,1003,1005],{"class":544,"line":566},[542,986,987],{"class":552},"  \"",[542,989,991],{"class":990},"spNyl","level",[542,993,994],{"class":552},"\"",[542,996,573],{"class":552},[542,998,999],{"class":552}," \"",[542,1001,1002],{"class":579},"warn",[542,1004,994],{"class":552},[542,1006,586],{"class":552},[542,1008,1009,1011,1014,1016,1018,1020,1023,1025],{"class":544,"line":589},[542,1010,987],{"class":552},[542,1012,1013],{"class":990},"service",[542,1015,994],{"class":552},[542,1017,573],{"class":552},[542,1019,999],{"class":552},[542,1021,1022],{"class":579},"billing-api",[542,1024,994],{"class":552},[542,1026,586],{"class":552},[542,1028,1029,1031,1034,1036,1038,1040,1043,1045],{"class":544,"line":631},[542,1030,987],{"class":552},[542,1032,1033],{"class":990},"method",[542,1035,994],{"class":552},[542,1037,573],{"class":552},[542,1039,999],{"class":552},[542,1041,1042],{"class":579},"POST",[542,1044,994],{"class":552},[542,1046,586],{"class":552},[542,1048,1049,1051,1054,1056,1058,1060,1063,1065],{"class":544,"line":668},[542,1050,987],{"class":552},[542,1052,1053],{"class":990},"path",[542,1055,994],{"class":552},[542,1057,573],{"class":552},[542,1059,999],{"class":552},[542,1061,1062],{"class":579},"\u002Fapi\u002Finvoices\u002Finv_889\u002Frefund",[542,1064,994],{"class":552},[542,1066,586],{"class":552},[542,1068,1069,1071,1074,1076,1078,1080],{"class":544,"line":685},[542,1070,987],{"class":552},[542,1072,1073],{"class":990},"status",[542,1075,994],{"class":552},[542,1077,573],{"class":552},[542,1079,947],{"class":753},[542,1081,586],{"class":552},[542,1083,1084,1086,1089,1091,1093,1095,1098,1100],{"class":544,"line":694},[542,1085,987],{"class":552},[542,1087,1088],{"class":990},"duration",[542,1090,994],{"class":552},[542,1092,573],{"class":552},[542,1094,999],{"class":552},[542,1096,1097],{"class":579},"12ms",[542,1099,994],{"class":552},[542,1101,586],{"class":552},[542,1103,1104,1106,1109,1111,1113,1115,1118,1120],{"class":544,"line":701},[542,1105,987],{"class":552},[542,1107,1108],{"class":990},"requestId",[542,1110,994],{"class":552},[542,1112,573],{"class":552},[542,1114,999],{"class":552},[542,1116,1117],{"class":579},"9c3f7d12-8a45-4e60-b8a9-1f0d4c5e6e7d",[542,1119,994],{"class":552},[542,1121,586],{"class":552},[542,1123,1124,1126,1128,1130,1132],{"class":544,"line":708},[542,1125,987],{"class":552},[542,1127,557],{"class":990},[542,1129,994],{"class":552},[542,1131,573],{"class":552},[542,1133,837],{"class":552},[542,1135,1137,1140,1144,1146,1148,1150,1152,1154],{"class":544,"line":1136},10,[542,1138,1139],{"class":552},"    \"",[542,1141,1143],{"class":1142},"sBMFI","action",[542,1145,994],{"class":552},[542,1147,573],{"class":552},[542,1149,999],{"class":552},[542,1151,580],{"class":579},[542,1153,994],{"class":552},[542,1155,586],{"class":552},[542,1157,1159,1161,1164,1166,1168,1170,1172,1175,1177,1179,1181,1183,1185,1187,1189,1191,1193,1195,1197,1200,1202],{"class":544,"line":1158},11,[542,1160,1139],{"class":552},[542,1162,1163],{"class":1142},"actor",[542,1165,994],{"class":552},[542,1167,573],{"class":552},[542,1169,597],{"class":552},[542,1171,999],{"class":552},[542,1173,1174],{"class":753},"type",[542,1176,994],{"class":552},[542,1178,573],{"class":552},[542,1180,999],{"class":552},[542,1182,607],{"class":579},[542,1184,994],{"class":552},[542,1186,612],{"class":552},[542,1188,999],{"class":552},[542,1190,884],{"class":753},[542,1192,994],{"class":552},[542,1194,573],{"class":552},[542,1196,999],{"class":552},[542,1198,1199],{"class":579},"usr_intruder",[542,1201,994],{"class":552},[542,1203,665],{"class":552},[542,1205,1207,1209,1212,1214,1216,1218,1220,1222,1224,1226,1228,1230,1232,1234,1236,1238,1240,1242,1244,1246,1248],{"class":544,"line":1206},12,[542,1208,1139],{"class":552},[542,1210,1211],{"class":1142},"target",[542,1213,994],{"class":552},[542,1215,573],{"class":552},[542,1217,597],{"class":552},[542,1219,999],{"class":552},[542,1221,1174],{"class":753},[542,1223,994],{"class":552},[542,1225,573],{"class":552},[542,1227,999],{"class":552},[542,1229,647],{"class":579},[542,1231,994],{"class":552},[542,1233,612],{"class":552},[542,1235,999],{"class":552},[542,1237,884],{"class":753},[542,1239,994],{"class":552},[542,1241,573],{"class":552},[542,1243,999],{"class":552},[542,1245,660],{"class":579},[542,1247,994],{"class":552},[542,1249,665],{"class":552},[542,1251,1253,1255,1258,1260,1262,1264,1267,1269],{"class":544,"line":1252},13,[542,1254,1139],{"class":552},[542,1256,1257],{"class":1142},"outcome",[542,1259,994],{"class":552},[542,1261,573],{"class":552},[542,1263,999],{"class":552},[542,1265,1266],{"class":579},"denied",[542,1268,994],{"class":552},[542,1270,586],{"class":552},[542,1272,1274,1276,1279,1281,1283,1285,1287,1289],{"class":544,"line":1273},14,[542,1275,1139],{"class":552},[542,1277,1278],{"class":1142},"reason",[542,1280,994],{"class":552},[542,1282,573],{"class":552},[542,1284,999],{"class":552},[542,1286,830],{"class":579},[542,1288,994],{"class":552},[542,1290,586],{"class":552},[542,1292,1294,1296,1299,1301,1303,1305],{"class":544,"line":1293},15,[542,1295,1139],{"class":552},[542,1297,1298],{"class":1142},"version",[542,1300,994],{"class":552},[542,1302,573],{"class":552},[542,1304,754],{"class":753},[542,1306,586],{"class":552},[542,1308,1310,1312,1315,1317,1319,1321,1324,1326],{"class":544,"line":1309},16,[542,1311,1139],{"class":552},[542,1313,1314],{"class":1142},"idempotencyKey",[542,1316,994],{"class":552},[542,1318,573],{"class":552},[542,1320,999],{"class":552},[542,1322,1323],{"class":579},"ak_d12c3a4f5b6e7d8c",[542,1325,994],{"class":552},[542,1327,586],{"class":552},[542,1329,1331,1333,1336,1338,1340],{"class":544,"line":1330},17,[542,1332,1139],{"class":552},[542,1334,1335],{"class":1142},"context",[542,1337,994],{"class":552},[542,1339,573],{"class":552},[542,1341,837],{"class":552},[542,1343,1345,1348,1350,1352,1354,1356,1358,1360],{"class":544,"line":1344},18,[542,1346,1347],{"class":552},"      \"",[542,1349,1108],{"class":753},[542,1351,994],{"class":552},[542,1353,573],{"class":552},[542,1355,999],{"class":552},[542,1357,1117],{"class":579},[542,1359,994],{"class":552},[542,1361,586],{"class":552},[542,1363,1365,1367,1370,1372,1374,1376,1379],{"class":544,"line":1364},19,[542,1366,1347],{"class":552},[542,1368,1369],{"class":753},"ip",[542,1371,994],{"class":552},[542,1373,573],{"class":552},[542,1375,999],{"class":552},[542,1377,1378],{"class":579},"203.0.113.7",[542,1380,1381],{"class":552},"\"\n",[542,1383,1385],{"class":544,"line":1384},20,[542,1386,1387],{"class":552},"    }\n",[542,1389,1391],{"class":544,"line":1390},21,[542,1392,1393],{"class":552},"  }\n",[542,1395,1397],{"class":544,"line":1396},22,[542,1398,970],{"class":552},[516,1400,1402,1403],{"id":1401},"standalone-audit","Standalone ",[520,1404,1405],{},"audit()",[512,1407,1408,1409,573],{},"For non-request contexts (jobs, scripts, CLIs), use the standalone ",[520,1410,1405],{},[778,1412,1413,1556],{},[533,1414,1417],{"className":535,"code":1415,"filename":1416,"language":537,"meta":538,"style":538},"import { audit } from 'evlog'\n\naudit({\n  action: 'cron.cleanup',\n  actor: { type: 'system', id: 'cron' },\n  target: { type: 'job', id: 'cleanup-stale-sessions' },\n  outcome: 'success',\n})\n","scripts\u002Fcleanup.ts",[520,1418,1419,1441,1445,1453,1468,1502,1536,1550],{"__ignoreMap":538},[542,1420,1421,1424,1426,1428,1430,1433,1435,1438],{"class":544,"line":545},[542,1422,1423],{"class":790},"import",[542,1425,597],{"class":552},[542,1427,723],{"class":548},[542,1429,757],{"class":552},[542,1431,1432],{"class":790}," from",[542,1434,576],{"class":552},[542,1436,1437],{"class":579},"evlog",[542,1439,1440],{"class":552},"'\n",[542,1442,1443],{"class":544,"line":566},[542,1444,698],{"emptyLinePlaceholder":697},[542,1446,1447,1449,1451],{"class":544,"line":589},[542,1448,557],{"class":556},[542,1450,560],{"class":548},[542,1452,563],{"class":552},[542,1454,1455,1457,1459,1461,1464,1466],{"class":544,"line":631},[542,1456,570],{"class":569},[542,1458,573],{"class":552},[542,1460,576],{"class":552},[542,1462,1463],{"class":579},"cron.cleanup",[542,1465,583],{"class":552},[542,1467,586],{"class":552},[542,1469,1470,1472,1474,1476,1478,1480,1482,1485,1487,1489,1491,1493,1495,1498,1500],{"class":544,"line":668},[542,1471,592],{"class":569},[542,1473,573],{"class":552},[542,1475,597],{"class":552},[542,1477,600],{"class":569},[542,1479,573],{"class":552},[542,1481,576],{"class":552},[542,1483,1484],{"class":579},"system",[542,1486,583],{"class":552},[542,1488,612],{"class":552},[542,1490,615],{"class":569},[542,1492,573],{"class":552},[542,1494,576],{"class":552},[542,1496,1497],{"class":579},"cron",[542,1499,583],{"class":552},[542,1501,665],{"class":552},[542,1503,1504,1506,1508,1510,1512,1514,1516,1519,1521,1523,1525,1527,1529,1532,1534],{"class":544,"line":685},[542,1505,634],{"class":569},[542,1507,573],{"class":552},[542,1509,597],{"class":552},[542,1511,600],{"class":569},[542,1513,573],{"class":552},[542,1515,576],{"class":552},[542,1517,1518],{"class":579},"job",[542,1520,583],{"class":552},[542,1522,612],{"class":552},[542,1524,615],{"class":569},[542,1526,573],{"class":552},[542,1528,576],{"class":552},[542,1530,1531],{"class":579},"cleanup-stale-sessions",[542,1533,583],{"class":552},[542,1535,665],{"class":552},[542,1537,1538,1540,1542,1544,1546,1548],{"class":544,"line":694},[542,1539,671],{"class":569},[542,1541,573],{"class":552},[542,1543,576],{"class":552},[542,1545,678],{"class":579},[542,1547,583],{"class":552},[542,1549,586],{"class":552},[542,1551,1552,1554],{"class":544,"line":701},[542,1553,688],{"class":552},[542,1555,691],{"class":548},[533,1557,1560],{"className":973,"code":1558,"filename":1559,"language":976,"meta":538,"style":538},"{\n  \"level\": \"info\",\n  \"service\": \"billing-api\",\n  \"audit\": {\n    \"action\": \"cron.cleanup\",\n    \"actor\": { \"type\": \"system\", \"id\": \"cron\" },\n    \"target\": { \"type\": \"job\", \"id\": \"cleanup-stale-sessions\" },\n    \"outcome\": \"success\",\n    \"version\": 1,\n    \"idempotencyKey\": \"ak_2b8e1f9d4c6a7b3e\"\n  }\n}\n","Output — wide event",[520,1561,1562,1566,1585,1603,1615,1633,1677,1721,1739,1753,1770,1774],{"__ignoreMap":538},[542,1563,1564],{"class":544,"line":545},[542,1565,563],{"class":552},[542,1567,1568,1570,1572,1574,1576,1578,1581,1583],{"class":544,"line":566},[542,1569,987],{"class":552},[542,1571,991],{"class":990},[542,1573,994],{"class":552},[542,1575,573],{"class":552},[542,1577,999],{"class":552},[542,1579,1580],{"class":579},"info",[542,1582,994],{"class":552},[542,1584,586],{"class":552},[542,1586,1587,1589,1591,1593,1595,1597,1599,1601],{"class":544,"line":589},[542,1588,987],{"class":552},[542,1590,1013],{"class":990},[542,1592,994],{"class":552},[542,1594,573],{"class":552},[542,1596,999],{"class":552},[542,1598,1022],{"class":579},[542,1600,994],{"class":552},[542,1602,586],{"class":552},[542,1604,1605,1607,1609,1611,1613],{"class":544,"line":631},[542,1606,987],{"class":552},[542,1608,557],{"class":990},[542,1610,994],{"class":552},[542,1612,573],{"class":552},[542,1614,837],{"class":552},[542,1616,1617,1619,1621,1623,1625,1627,1629,1631],{"class":544,"line":668},[542,1618,1139],{"class":552},[542,1620,1143],{"class":1142},[542,1622,994],{"class":552},[542,1624,573],{"class":552},[542,1626,999],{"class":552},[542,1628,1463],{"class":579},[542,1630,994],{"class":552},[542,1632,586],{"class":552},[542,1634,1635,1637,1639,1641,1643,1645,1647,1649,1651,1653,1655,1657,1659,1661,1663,1665,1667,1669,1671,1673,1675],{"class":544,"line":685},[542,1636,1139],{"class":552},[542,1638,1163],{"class":1142},[542,1640,994],{"class":552},[542,1642,573],{"class":552},[542,1644,597],{"class":552},[542,1646,999],{"class":552},[542,1648,1174],{"class":753},[542,1650,994],{"class":552},[542,1652,573],{"class":552},[542,1654,999],{"class":552},[542,1656,1484],{"class":579},[542,1658,994],{"class":552},[542,1660,612],{"class":552},[542,1662,999],{"class":552},[542,1664,884],{"class":753},[542,1666,994],{"class":552},[542,1668,573],{"class":552},[542,1670,999],{"class":552},[542,1672,1497],{"class":579},[542,1674,994],{"class":552},[542,1676,665],{"class":552},[542,1678,1679,1681,1683,1685,1687,1689,1691,1693,1695,1697,1699,1701,1703,1705,1707,1709,1711,1713,1715,1717,1719],{"class":544,"line":694},[542,1680,1139],{"class":552},[542,1682,1211],{"class":1142},[542,1684,994],{"class":552},[542,1686,573],{"class":552},[542,1688,597],{"class":552},[542,1690,999],{"class":552},[542,1692,1174],{"class":753},[542,1694,994],{"class":552},[542,1696,573],{"class":552},[542,1698,999],{"class":552},[542,1700,1518],{"class":579},[542,1702,994],{"class":552},[542,1704,612],{"class":552},[542,1706,999],{"class":552},[542,1708,884],{"class":753},[542,1710,994],{"class":552},[542,1712,573],{"class":552},[542,1714,999],{"class":552},[542,1716,1531],{"class":579},[542,1718,994],{"class":552},[542,1720,665],{"class":552},[542,1722,1723,1725,1727,1729,1731,1733,1735,1737],{"class":544,"line":701},[542,1724,1139],{"class":552},[542,1726,1257],{"class":1142},[542,1728,994],{"class":552},[542,1730,573],{"class":552},[542,1732,999],{"class":552},[542,1734,678],{"class":579},[542,1736,994],{"class":552},[542,1738,586],{"class":552},[542,1740,1741,1743,1745,1747,1749,1751],{"class":544,"line":708},[542,1742,1139],{"class":552},[542,1744,1298],{"class":1142},[542,1746,994],{"class":552},[542,1748,573],{"class":552},[542,1750,754],{"class":753},[542,1752,586],{"class":552},[542,1754,1755,1757,1759,1761,1763,1765,1768],{"class":544,"line":1136},[542,1756,1139],{"class":552},[542,1758,1314],{"class":1142},[542,1760,994],{"class":552},[542,1762,573],{"class":552},[542,1764,999],{"class":552},[542,1766,1767],{"class":579},"ak_2b8e1f9d4c6a7b3e",[542,1769,1381],{"class":552},[542,1771,1772],{"class":544,"line":1158},[542,1773,1393],{"class":552},[542,1775,1776],{"class":544,"line":1206},[542,1777,970],{"class":552},[1779,1780,1402,1781,1783,1784,1786,1787,1786,1790,1793,1794,1797],"note",{},[520,1782,1405],{}," events have no ",[520,1785,1108],{},", no ",[520,1788,1789],{},"context.ip",[520,1791,1792],{},"userAgent"," — there is no request to enrich from. Add your own context manually (",[520,1795,1796],{},"context: { jobId, queue, runId }",") when it matters for forensics.",[516,1799,1801],{"id":1800},"defineauditaction",[520,1802,1803],{},"defineAuditAction()",[512,1805,1806,1807,573],{},"Define audit actions in one place to avoid magic strings and get full type-safety on ",[520,1808,1211],{},[533,1810,1812],{"className":535,"code":1811,"language":537,"meta":538,"style":538},"import { defineAuditAction } from 'evlog'\n\nconst refund = defineAuditAction('invoice.refund', { target: 'invoice' })\n\nlog.audit(refund({\n  actor: { type: 'user', id: user.id },\n  target: { id: 'inv_889' }, \u002F\u002F type inferred as 'invoice'\n  outcome: 'success',\n}))\n",[520,1813,1814,1833,1837,1877,1881,1898,1930,1954,1968],{"__ignoreMap":538},[542,1815,1816,1818,1820,1823,1825,1827,1829,1831],{"class":544,"line":545},[542,1817,1423],{"class":790},[542,1819,597],{"class":552},[542,1821,1822],{"class":548}," defineAuditAction",[542,1824,757],{"class":552},[542,1826,1432],{"class":790},[542,1828,576],{"class":552},[542,1830,1437],{"class":579},[542,1832,1440],{"class":552},[542,1834,1835],{"class":544,"line":566},[542,1836,698],{"emptyLinePlaceholder":697},[542,1838,1839,1842,1845,1848,1850,1852,1854,1856,1858,1860,1862,1865,1867,1869,1871,1873,1875],{"class":544,"line":589},[542,1840,1841],{"class":990},"const",[542,1843,1844],{"class":548}," refund ",[542,1846,1847],{"class":552},"=",[542,1849,1822],{"class":556},[542,1851,560],{"class":548},[542,1853,583],{"class":552},[542,1855,580],{"class":579},[542,1857,583],{"class":552},[542,1859,612],{"class":552},[542,1861,597],{"class":552},[542,1863,1864],{"class":569}," target",[542,1866,573],{"class":552},[542,1868,576],{"class":552},[542,1870,647],{"class":579},[542,1872,583],{"class":552},[542,1874,757],{"class":552},[542,1876,691],{"class":548},[542,1878,1879],{"class":544,"line":631},[542,1880,698],{"emptyLinePlaceholder":697},[542,1882,1883,1885,1887,1889,1891,1894,1896],{"class":544,"line":668},[542,1884,549],{"class":548},[542,1886,553],{"class":552},[542,1888,557],{"class":556},[542,1890,560],{"class":548},[542,1892,1893],{"class":556},"refund",[542,1895,560],{"class":548},[542,1897,563],{"class":552},[542,1899,1900,1902,1904,1906,1908,1910,1912,1914,1916,1918,1920,1922,1924,1926,1928],{"class":544,"line":685},[542,1901,592],{"class":569},[542,1903,573],{"class":552},[542,1905,597],{"class":552},[542,1907,600],{"class":569},[542,1909,573],{"class":552},[542,1911,576],{"class":552},[542,1913,607],{"class":579},[542,1915,583],{"class":552},[542,1917,612],{"class":552},[542,1919,615],{"class":569},[542,1921,573],{"class":552},[542,1923,620],{"class":548},[542,1925,553],{"class":552},[542,1927,625],{"class":548},[542,1929,628],{"class":552},[542,1931,1932,1934,1936,1938,1940,1942,1944,1946,1948,1951],{"class":544,"line":694},[542,1933,634],{"class":569},[542,1935,573],{"class":552},[542,1937,597],{"class":552},[542,1939,615],{"class":569},[542,1941,573],{"class":552},[542,1943,576],{"class":552},[542,1945,660],{"class":579},[542,1947,583],{"class":552},[542,1949,1950],{"class":552}," },",[542,1952,1953],{"class":704}," \u002F\u002F type inferred as 'invoice'\n",[542,1955,1956,1958,1960,1962,1964,1966],{"class":544,"line":701},[542,1957,671],{"class":569},[542,1959,573],{"class":552},[542,1961,576],{"class":552},[542,1963,678],{"class":579},[542,1965,583],{"class":552},[542,1967,586],{"class":552},[542,1969,1970,1972],{"class":544,"line":708},[542,1971,688],{"class":552},[542,1973,1974],{"class":548},"))\n",[512,1976,1977,1978,553],{},"Pair this with the action dictionary from ",[1979,1980,1982],"a",{"href":1981},"\u002Fuse-cases\u002Faudit\u002Fschema#action-naming","Schema → Action naming",[516,1984,1986],{"id":1985},"defineauditcatalog",[520,1987,1988],{},"defineAuditCatalog()",[512,1990,1991,1992,1996,1997,2000,2001,2004,2005,2008,2009,2011,2012,553],{},"For more than a handful of actions, group them in a typed ",[1993,1994,1995],"strong",{},"catalog"," instead of declaring ",[520,1998,1999],{},"defineAuditAction"," one-by-one. Same convention as error catalogs: ",[520,2002,2003],{},"UPPER_SNAKE_CASE"," keys, ",[520,2006,2007],{},"lower.dot.case"," prefix, wire ",[520,2010,1143],{}," is ",[520,2013,2014],{},"${prefix}.${KEY}",[778,2016,2017,2275],{},[533,2018,2021],{"className":535,"code":2019,"filename":2020,"language":537,"meta":538,"style":538},"import { defineAuditCatalog } from 'evlog'\n\nexport const billingAudit = defineAuditCatalog('billing', {\n  INVOICE_REFUND: {\n    target: 'invoice',\n    severity: 'high',\n    requiresChanges: true,\n    description: 'Refund an invoice to the customer',\n    redactPaths: ['cardNumber'],\n  },\n  INVOICE_CREATE:      { target: 'invoice' },\n  INVOICE_VOID:        { target: 'invoice', severity: 'high', requiresReason: true },\n  SUBSCRIPTION_CANCEL: { target: 'subscription', severity: 'high' },\n})\n","audit\u002Fbilling.ts",[520,2022,2023,2042,2046,2074,2083,2097,2113,2126,2142,2164,2169,2191,2235,2269],{"__ignoreMap":538},[542,2024,2025,2027,2029,2032,2034,2036,2038,2040],{"class":544,"line":545},[542,2026,1423],{"class":790},[542,2028,597],{"class":552},[542,2030,2031],{"class":548}," defineAuditCatalog",[542,2033,757],{"class":552},[542,2035,1432],{"class":790},[542,2037,576],{"class":552},[542,2039,1437],{"class":579},[542,2041,1440],{"class":552},[542,2043,2044],{"class":544,"line":566},[542,2045,698],{"emptyLinePlaceholder":697},[542,2047,2048,2051,2054,2057,2059,2061,2063,2065,2068,2070,2072],{"class":544,"line":589},[542,2049,2050],{"class":790},"export",[542,2052,2053],{"class":990}," const",[542,2055,2056],{"class":548}," billingAudit ",[542,2058,1847],{"class":552},[542,2060,2031],{"class":556},[542,2062,560],{"class":548},[542,2064,583],{"class":552},[542,2066,2067],{"class":579},"billing",[542,2069,583],{"class":552},[542,2071,612],{"class":552},[542,2073,837],{"class":552},[542,2075,2076,2079,2081],{"class":544,"line":631},[542,2077,2078],{"class":569},"  INVOICE_REFUND",[542,2080,573],{"class":552},[542,2082,837],{"class":552},[542,2084,2085,2087,2089,2091,2093,2095],{"class":544,"line":668},[542,2086,891],{"class":569},[542,2088,573],{"class":552},[542,2090,576],{"class":552},[542,2092,647],{"class":579},[542,2094,583],{"class":552},[542,2096,586],{"class":552},[542,2098,2099,2102,2104,2106,2109,2111],{"class":544,"line":685},[542,2100,2101],{"class":569},"    severity",[542,2103,573],{"class":552},[542,2105,576],{"class":552},[542,2107,2108],{"class":579},"high",[542,2110,583],{"class":552},[542,2112,586],{"class":552},[542,2114,2115,2118,2120,2124],{"class":544,"line":694},[542,2116,2117],{"class":569},"    requiresChanges",[542,2119,573],{"class":552},[542,2121,2123],{"class":2122},"sfNiH"," true",[542,2125,586],{"class":552},[542,2127,2128,2131,2133,2135,2138,2140],{"class":544,"line":701},[542,2129,2130],{"class":569},"    description",[542,2132,573],{"class":552},[542,2134,576],{"class":552},[542,2136,2137],{"class":579},"Refund an invoice to the customer",[542,2139,583],{"class":552},[542,2141,586],{"class":552},[542,2143,2144,2147,2149,2152,2154,2157,2159,2162],{"class":544,"line":708},[542,2145,2146],{"class":569},"    redactPaths",[542,2148,573],{"class":552},[542,2150,2151],{"class":548}," [",[542,2153,583],{"class":552},[542,2155,2156],{"class":579},"cardNumber",[542,2158,583],{"class":552},[542,2160,2161],{"class":548},"]",[542,2163,586],{"class":552},[542,2165,2166],{"class":544,"line":1136},[542,2167,2168],{"class":552},"  },\n",[542,2170,2171,2174,2176,2179,2181,2183,2185,2187,2189],{"class":544,"line":1158},[542,2172,2173],{"class":569},"  INVOICE_CREATE",[542,2175,573],{"class":552},[542,2177,2178],{"class":552},"      {",[542,2180,1864],{"class":569},[542,2182,573],{"class":552},[542,2184,576],{"class":552},[542,2186,647],{"class":579},[542,2188,583],{"class":552},[542,2190,665],{"class":552},[542,2192,2193,2196,2198,2201,2203,2205,2207,2209,2211,2213,2216,2218,2220,2222,2224,2226,2229,2231,2233],{"class":544,"line":1206},[542,2194,2195],{"class":569},"  INVOICE_VOID",[542,2197,573],{"class":552},[542,2199,2200],{"class":552},"        {",[542,2202,1864],{"class":569},[542,2204,573],{"class":552},[542,2206,576],{"class":552},[542,2208,647],{"class":579},[542,2210,583],{"class":552},[542,2212,612],{"class":552},[542,2214,2215],{"class":569}," severity",[542,2217,573],{"class":552},[542,2219,576],{"class":552},[542,2221,2108],{"class":579},[542,2223,583],{"class":552},[542,2225,612],{"class":552},[542,2227,2228],{"class":569}," requiresReason",[542,2230,573],{"class":552},[542,2232,2123],{"class":2122},[542,2234,665],{"class":552},[542,2236,2237,2240,2242,2244,2246,2248,2250,2253,2255,2257,2259,2261,2263,2265,2267],{"class":544,"line":1252},[542,2238,2239],{"class":569},"  SUBSCRIPTION_CANCEL",[542,2241,573],{"class":552},[542,2243,597],{"class":552},[542,2245,1864],{"class":569},[542,2247,573],{"class":552},[542,2249,576],{"class":552},[542,2251,2252],{"class":579},"subscription",[542,2254,583],{"class":552},[542,2256,612],{"class":552},[542,2258,2215],{"class":569},[542,2260,573],{"class":552},[542,2262,576],{"class":552},[542,2264,2108],{"class":579},[542,2266,583],{"class":552},[542,2268,665],{"class":552},[542,2270,2271,2273],{"class":544,"line":1273},[542,2272,688],{"class":552},[542,2274,691],{"class":548},[533,2276,2279],{"className":535,"code":2277,"filename":2278,"language":537,"meta":538,"style":538},"import { billingAudit } from '~\u002Faudit\u002Fbilling'\n\nlog.audit(billingAudit.INVOICE_REFUND({\n  actor: { type: 'user', id: user.id },\n  target: { id: 'inv_889' }, \u002F\u002F type inferred as 'invoice'\n  outcome: 'success',\n}))\n","server\u002Fapi\u002Frefund.post.ts",[520,2280,2281,2301,2305,2325,2357,2379,2393],{"__ignoreMap":538},[542,2282,2283,2285,2287,2290,2292,2294,2296,2299],{"class":544,"line":545},[542,2284,1423],{"class":790},[542,2286,597],{"class":552},[542,2288,2289],{"class":548}," billingAudit",[542,2291,757],{"class":552},[542,2293,1432],{"class":790},[542,2295,576],{"class":552},[542,2297,2298],{"class":579},"~\u002Faudit\u002Fbilling",[542,2300,1440],{"class":552},[542,2302,2303],{"class":544,"line":566},[542,2304,698],{"emptyLinePlaceholder":697},[542,2306,2307,2309,2311,2313,2316,2318,2321,2323],{"class":544,"line":589},[542,2308,549],{"class":548},[542,2310,553],{"class":552},[542,2312,557],{"class":556},[542,2314,2315],{"class":548},"(billingAudit",[542,2317,553],{"class":552},[542,2319,2320],{"class":556},"INVOICE_REFUND",[542,2322,560],{"class":548},[542,2324,563],{"class":552},[542,2326,2327,2329,2331,2333,2335,2337,2339,2341,2343,2345,2347,2349,2351,2353,2355],{"class":544,"line":631},[542,2328,592],{"class":569},[542,2330,573],{"class":552},[542,2332,597],{"class":552},[542,2334,600],{"class":569},[542,2336,573],{"class":552},[542,2338,576],{"class":552},[542,2340,607],{"class":579},[542,2342,583],{"class":552},[542,2344,612],{"class":552},[542,2346,615],{"class":569},[542,2348,573],{"class":552},[542,2350,620],{"class":548},[542,2352,553],{"class":552},[542,2354,625],{"class":548},[542,2356,628],{"class":552},[542,2358,2359,2361,2363,2365,2367,2369,2371,2373,2375,2377],{"class":544,"line":668},[542,2360,634],{"class":569},[542,2362,573],{"class":552},[542,2364,597],{"class":552},[542,2366,615],{"class":569},[542,2368,573],{"class":552},[542,2370,576],{"class":552},[542,2372,660],{"class":579},[542,2374,583],{"class":552},[542,2376,1950],{"class":552},[542,2378,1953],{"class":704},[542,2380,2381,2383,2385,2387,2389,2391],{"class":544,"line":685},[542,2382,671],{"class":569},[542,2384,573],{"class":552},[542,2386,576],{"class":552},[542,2388,678],{"class":579},[542,2390,583],{"class":552},[542,2392,586],{"class":552},[542,2394,2395,2397],{"class":544,"line":694},[542,2396,688],{"class":552},[542,2398,1974],{"class":548},[512,2400,2401,2402,2404,2405,2408,2409,573],{},"Each entry produces a thin wrapper around ",[520,2403,1999],{}," (target type is fixed at definition time, action name is auto-prefixed). Catalog metadata is exposed on each factory and on ",[520,2406,2407],{},"_actions"," \u002F ",[520,2410,2411],{},"_prefix",[533,2413,2415],{"className":535,"code":2414,"language":537,"meta":538,"style":538},"billingAudit.INVOICE_REFUND.action           \u002F\u002F 'billing.INVOICE_REFUND' (literal type)\nbillingAudit.INVOICE_REFUND.target           \u002F\u002F 'invoice'\nbillingAudit.INVOICE_REFUND.severity         \u002F\u002F 'high'\nbillingAudit.INVOICE_REFUND.requiresChanges \u002F\u002F true\nbillingAudit.INVOICE_REFUND.redactPaths      \u002F\u002F ['cardNumber']\nbillingAudit._actions                        \u002F\u002F readonly ['billing.INVOICE_REFUND', ...]\n",[520,2416,2417,2434,2450,2466,2482,2498],{"__ignoreMap":538},[542,2418,2419,2422,2424,2426,2428,2431],{"class":544,"line":545},[542,2420,2421],{"class":548},"billingAudit",[542,2423,553],{"class":552},[542,2425,2320],{"class":548},[542,2427,553],{"class":552},[542,2429,2430],{"class":548},"action           ",[542,2432,2433],{"class":704},"\u002F\u002F 'billing.INVOICE_REFUND' (literal type)\n",[542,2435,2436,2438,2440,2442,2444,2447],{"class":544,"line":566},[542,2437,2421],{"class":548},[542,2439,553],{"class":552},[542,2441,2320],{"class":548},[542,2443,553],{"class":552},[542,2445,2446],{"class":548},"target           ",[542,2448,2449],{"class":704},"\u002F\u002F 'invoice'\n",[542,2451,2452,2454,2456,2458,2460,2463],{"class":544,"line":589},[542,2453,2421],{"class":548},[542,2455,553],{"class":552},[542,2457,2320],{"class":548},[542,2459,553],{"class":552},[542,2461,2462],{"class":548},"severity         ",[542,2464,2465],{"class":704},"\u002F\u002F 'high'\n",[542,2467,2468,2470,2472,2474,2476,2479],{"class":544,"line":631},[542,2469,2421],{"class":548},[542,2471,553],{"class":552},[542,2473,2320],{"class":548},[542,2475,553],{"class":552},[542,2477,2478],{"class":548},"requiresChanges ",[542,2480,2481],{"class":704},"\u002F\u002F true\n",[542,2483,2484,2486,2488,2490,2492,2495],{"class":544,"line":668},[542,2485,2421],{"class":548},[542,2487,553],{"class":552},[542,2489,2320],{"class":548},[542,2491,553],{"class":552},[542,2493,2494],{"class":548},"redactPaths      ",[542,2496,2497],{"class":704},"\u002F\u002F ['cardNumber']\n",[542,2499,2500,2502,2504,2507],{"class":544,"line":685},[542,2501,2421],{"class":548},[542,2503,553],{"class":552},[542,2505,2506],{"class":548},"_actions                        ",[542,2508,2509],{"class":704},"\u002F\u002F readonly ['billing.INVOICE_REFUND', ...]\n",[2511,2512,2513,2526],"table",{},[2514,2515,2516],"thead",{},[2517,2518,2519,2523],"tr",{},[2520,2521,2522],"th",{},"Entry field",[2520,2524,2525],{},"Purpose",[2527,2528,2529,2543,2553,2566,2584,2596],"tbody",{},[2517,2530,2531,2536],{},[2532,2533,2534],"td",{},[520,2535,1211],{},[2532,2537,2538,2539,2542],{},"Default ",[520,2540,2541],{},"target.type"," injected at call sites",[2517,2544,2545,2550],{},[2532,2546,2547],{},[520,2548,2549],{},"description",[2532,2551,2552],{},"Human-readable label for docs, SIEM rules, review tooling",[2517,2554,2555,2560],{},[2532,2556,2557],{},[520,2558,2559],{},"severity",[2532,2561,2562,2565],{},[520,2563,2564],{},"'low' | 'medium' | 'high' | 'critical'"," — alerting and review priority",[2517,2567,2568,2573],{},[2532,2569,2570],{},[520,2571,2572],{},"requiresChanges",[2532,2574,2575,2576,2579,2580,2583],{},"Document that callers should attach ",[520,2577,2578],{},"changes"," (e.g. via ",[520,2581,2582],{},"auditDiff",")",[2517,2585,2586,2591],{},[2532,2587,2588],{},[520,2589,2590],{},"requiresReason",[2532,2592,2575,2593,2595],{},[520,2594,1278],{}," (especially denials)",[2517,2597,2598,2603],{},[2532,2599,2600],{},[520,2601,2602],{},"redactPaths",[2532,2604,2605,2606,2609],{},"Default paths for ",[520,2607,2608],{},"auditDiff({ redactPaths: [...] })"," on this action",[2611,2612,2614,2616,2617,2620],"h3",{"id":2613},"defineauditaction-vs-defineauditcatalog-when-to-choose",[520,2615,1999],{}," vs ",[520,2618,2619],{},"defineAuditCatalog"," — when to choose",[512,2622,2623],{},"Both produce the same call-site factory shape. Pick by scale:",[2625,2626,2627,2643],"ul",{},[2628,2629,2630,2635,2636,2639,2640,2642],"li",{},[1993,2631,2632],{},[520,2633,2634],{},"defineAuditAction(action, opts?)"," — one-off actions, or per-file organisation in very large repos. Mirrors ",[520,2637,2638],{},"defineError",". Equivalent to a catalog with a single entry but with no prefix derivation: you write the full wire ",[520,2641,1143],{}," directly.",[2628,2644,2645,2650,2651,2654,2655,2657,2658,2660,2661,2663,2664,2666,2667,2670,2671,2674],{},[1993,2646,2647],{},[520,2648,2649],{},"defineAuditCatalog(prefix, map)"," — group anything beyond a handful of related actions under one prefix. Mirrors ",[520,2652,2653],{},"defineErrorCatalog",". The wire ",[520,2656,1143],{}," is auto-derived as ",[520,2659,2014],{},", catalog metadata (",[520,2662,2407],{},", ",[520,2665,2411],{},") is exposed for introspection, and a single ",[520,2668,2669],{},"declare module 'evlog'"," line surfaces the whole bundle in the typed ",[520,2672,2673],{},"AuditAction"," union.",[512,2676,2677,2678,2680,2681,2663,2683,2663,2686,2688],{},"You can mix the two in the same codebase — keep cross-cutting one-off actions as ",[520,2679,1999],{},", group bounded contexts (",[520,2682,2067],{},[520,2684,2685],{},"auth",[520,2687,2252],{},") as catalogs.",[2611,2690,2692],{"id":2691},"type-safe-actions-everywhere-opt-in","Type-safe actions everywhere (opt-in)",[512,2694,2695,2696,573],{},"Mirror the error catalog augmentation by augmenting ",[520,2697,2698],{},"RegisteredAuditCatalogs",[533,2700,2702],{"className":535,"code":2701,"language":537,"meta":538,"style":538},"import type { billingAudit } from '.\u002Faudit\u002Fbilling'\n\ndeclare module 'evlog' {\n  interface RegisteredAuditCatalogs {\n    billing: typeof billingAudit\n  }\n}\n",[520,2703,2704,2725,2729,2745,2755,2768,2772],{"__ignoreMap":538},[542,2705,2706,2708,2710,2712,2714,2716,2718,2720,2723],{"class":544,"line":545},[542,2707,1423],{"class":790},[542,2709,600],{"class":790},[542,2711,597],{"class":552},[542,2713,2289],{"class":548},[542,2715,757],{"class":552},[542,2717,1432],{"class":790},[542,2719,576],{"class":552},[542,2721,2722],{"class":579},".\u002Faudit\u002Fbilling",[542,2724,1440],{"class":552},[542,2726,2727],{"class":544,"line":566},[542,2728,698],{"emptyLinePlaceholder":697},[542,2730,2731,2734,2737,2739,2741,2743],{"class":544,"line":589},[542,2732,2733],{"class":990},"declare",[542,2735,2736],{"class":990}," module",[542,2738,576],{"class":552},[542,2740,1437],{"class":579},[542,2742,583],{"class":552},[542,2744,837],{"class":552},[542,2746,2747,2750,2753],{"class":544,"line":631},[542,2748,2749],{"class":990},"  interface",[542,2751,2752],{"class":1142}," RegisteredAuditCatalogs",[542,2754,837],{"class":552},[542,2756,2757,2760,2762,2765],{"class":544,"line":668},[542,2758,2759],{"class":569},"    billing",[542,2761,573],{"class":552},[542,2763,2764],{"class":552}," typeof",[542,2766,2767],{"class":548}," billingAudit\n",[542,2769,2770],{"class":544,"line":685},[542,2771,1393],{"class":552},[542,2773,2774],{"class":544,"line":694},[542,2775,970],{"class":552},[512,2777,2778,2779,2781],{},"This surfaces the union of all registered actions on the typed ",[520,2780,2673],{}," export, useful for shared helpers, dashboards, and refactor-safe comparisons.",[2783,2784,2787,2790,2791,2794],"callout",{"color":2785,"icon":2786,"to":77},"primary","i-lucide-arrow-right",[1993,2788,2789],{},"Going further."," The dedicated ",[1979,2792,2793],{"href":77},"Catalogs page"," covers the scaling story (single file → folder → feature → npm package) for both error and audit catalogs, plus npm packaging, composition patterns, and the type-augmentation deep dive.",[516,2796,2798],{"id":2797},"auditdiff",[520,2799,2800],{},"auditDiff()",[512,2802,2803,2804,2806],{},"For mutating actions, use ",[520,2805,2800],{}," to produce a compact, redact-aware JSON Patch:",[2808,2809,2810,2815,2816,2011,2818,2822,2823,2826,2827,2830,2831,2834,2835,2838,2839,2841],"warning",{},[1993,2811,2812,2813,553],{},"Don't feed entire DB rows into ",[520,2814,2800],{}," Strip computed columns, hashed passwords, internal flags, and large JSON blobs before diffing. The point of ",[520,2817,2578],{},[2819,2820,2821],"em",{},"what changed semantically"," (status went from ",[520,2824,2825],{},"paid"," → ",[520,2828,2829],{},"refunded","), not ",[2819,2832,2833],{},"what bytes changed"," (a ",[520,2836,2837],{},"lastModified"," timestamp ticked). A noisy ",[520,2840,2578],{}," field is the fastest way to make audit logs unreadable.",[778,2843,2844,3088],{},[533,2845,2847],{"className":535,"code":2846,"filename":783,"language":537,"meta":538,"style":538},"import { auditDiff } from 'evlog'\n\nconst before = await db.users.byId(id)\nconst after = await db.users.update(id, patch)\n\nlog.audit({\n  action: 'user.update',\n  actor: { type: 'user', id: actorId },\n  target: { type: 'user', id },\n  outcome: 'success',\n  changes: auditDiff(before, after, { redactPaths: ['password', 'token'] }),\n})\n",[520,2848,2849,2868,2872,2900,2930,2934,2946,2961,2990,3015,3029,3082],{"__ignoreMap":538},[542,2850,2851,2853,2855,2858,2860,2862,2864,2866],{"class":544,"line":545},[542,2852,1423],{"class":790},[542,2854,597],{"class":552},[542,2856,2857],{"class":548}," auditDiff",[542,2859,757],{"class":552},[542,2861,1432],{"class":790},[542,2863,576],{"class":552},[542,2865,1437],{"class":579},[542,2867,1440],{"class":552},[542,2869,2870],{"class":544,"line":566},[542,2871,698],{"emptyLinePlaceholder":697},[542,2873,2874,2876,2879,2881,2884,2887,2889,2892,2894,2897],{"class":544,"line":589},[542,2875,1841],{"class":990},[542,2877,2878],{"class":548}," before ",[542,2880,1847],{"class":552},[542,2882,2883],{"class":790}," await",[542,2885,2886],{"class":548}," db",[542,2888,553],{"class":552},[542,2890,2891],{"class":548},"users",[542,2893,553],{"class":552},[542,2895,2896],{"class":556},"byId",[542,2898,2899],{"class":548},"(id)\n",[542,2901,2902,2904,2907,2909,2911,2913,2915,2917,2919,2922,2925,2927],{"class":544,"line":631},[542,2903,1841],{"class":990},[542,2905,2906],{"class":548}," after ",[542,2908,1847],{"class":552},[542,2910,2883],{"class":790},[542,2912,2886],{"class":548},[542,2914,553],{"class":552},[542,2916,2891],{"class":548},[542,2918,553],{"class":552},[542,2920,2921],{"class":556},"update",[542,2923,2924],{"class":548},"(id",[542,2926,612],{"class":552},[542,2928,2929],{"class":548}," patch)\n",[542,2931,2932],{"class":544,"line":668},[542,2933,698],{"emptyLinePlaceholder":697},[542,2935,2936,2938,2940,2942,2944],{"class":544,"line":685},[542,2937,549],{"class":548},[542,2939,553],{"class":552},[542,2941,557],{"class":556},[542,2943,560],{"class":548},[542,2945,563],{"class":552},[542,2947,2948,2950,2952,2954,2957,2959],{"class":544,"line":694},[542,2949,570],{"class":569},[542,2951,573],{"class":552},[542,2953,576],{"class":552},[542,2955,2956],{"class":579},"user.update",[542,2958,583],{"class":552},[542,2960,586],{"class":552},[542,2962,2963,2965,2967,2969,2971,2973,2975,2977,2979,2981,2983,2985,2988],{"class":544,"line":701},[542,2964,592],{"class":569},[542,2966,573],{"class":552},[542,2968,597],{"class":552},[542,2970,600],{"class":569},[542,2972,573],{"class":552},[542,2974,576],{"class":552},[542,2976,607],{"class":579},[542,2978,583],{"class":552},[542,2980,612],{"class":552},[542,2982,615],{"class":569},[542,2984,573],{"class":552},[542,2986,2987],{"class":548}," actorId ",[542,2989,628],{"class":552},[542,2991,2992,2994,2996,2998,3000,3002,3004,3006,3008,3010,3013],{"class":544,"line":708},[542,2993,634],{"class":569},[542,2995,573],{"class":552},[542,2997,597],{"class":552},[542,2999,600],{"class":569},[542,3001,573],{"class":552},[542,3003,576],{"class":552},[542,3005,607],{"class":579},[542,3007,583],{"class":552},[542,3009,612],{"class":552},[542,3011,3012],{"class":548}," id ",[542,3014,628],{"class":552},[542,3016,3017,3019,3021,3023,3025,3027],{"class":544,"line":1136},[542,3018,671],{"class":569},[542,3020,573],{"class":552},[542,3022,576],{"class":552},[542,3024,678],{"class":579},[542,3026,583],{"class":552},[542,3028,586],{"class":552},[542,3030,3031,3034,3036,3038,3041,3043,3046,3048,3050,3053,3055,3057,3059,3062,3064,3066,3068,3071,3073,3076,3078,3080],{"class":544,"line":1158},[542,3032,3033],{"class":569},"  changes",[542,3035,573],{"class":552},[542,3037,2857],{"class":556},[542,3039,3040],{"class":548},"(before",[542,3042,612],{"class":552},[542,3044,3045],{"class":548}," after",[542,3047,612],{"class":552},[542,3049,597],{"class":552},[542,3051,3052],{"class":569}," redactPaths",[542,3054,573],{"class":552},[542,3056,2151],{"class":548},[542,3058,583],{"class":552},[542,3060,3061],{"class":579},"password",[542,3063,583],{"class":552},[542,3065,612],{"class":552},[542,3067,576],{"class":552},[542,3069,3070],{"class":579},"token",[542,3072,583],{"class":552},[542,3074,3075],{"class":548},"] ",[542,3077,688],{"class":552},[542,3079,2583],{"class":548},[542,3081,586],{"class":552},[542,3083,3084,3086],{"class":544,"line":1206},[542,3085,688],{"class":552},[542,3087,691],{"class":548},[533,3089,3092],{"className":973,"code":3090,"filename":3091,"language":976,"meta":538,"style":538},"{\n  \"audit\": {\n    \"action\": \"user.update\",\n    \"actor\": { \"type\": \"user\", \"id\": \"usr_42\" },\n    \"target\": { \"type\": \"user\", \"id\": \"usr_99\" },\n    \"outcome\": \"success\",\n    \"changes\": [\n      { \"op\": \"replace\", \"path\": \"\u002Femail\", \"from\": \"old@example.com\", \"to\": \"new@example.com\" },\n      { \"op\": \"replace\", \"path\": \"\u002Frole\", \"from\": \"member\", \"to\": \"admin\" },\n      { \"op\": \"replace\", \"path\": \"\u002Fpassword\", \"from\": \"[REDACTED]\", \"to\": \"[REDACTED]\" }\n    ],\n    \"version\": 1,\n    \"idempotencyKey\": \"ak_5e7d8f9a0b1c2d3e\"\n  }\n}\n","Output — changes patch",[520,3093,3094,3098,3110,3128,3173,3218,3236,3249,3324,3395,3466,3471,3485,3502,3506],{"__ignoreMap":538},[542,3095,3096],{"class":544,"line":545},[542,3097,563],{"class":552},[542,3099,3100,3102,3104,3106,3108],{"class":544,"line":566},[542,3101,987],{"class":552},[542,3103,557],{"class":990},[542,3105,994],{"class":552},[542,3107,573],{"class":552},[542,3109,837],{"class":552},[542,3111,3112,3114,3116,3118,3120,3122,3124,3126],{"class":544,"line":589},[542,3113,1139],{"class":552},[542,3115,1143],{"class":1142},[542,3117,994],{"class":552},[542,3119,573],{"class":552},[542,3121,999],{"class":552},[542,3123,2956],{"class":579},[542,3125,994],{"class":552},[542,3127,586],{"class":552},[542,3129,3130,3132,3134,3136,3138,3140,3142,3144,3146,3148,3150,3152,3154,3156,3158,3160,3162,3164,3166,3169,3171],{"class":544,"line":631},[542,3131,1139],{"class":552},[542,3133,1163],{"class":1142},[542,3135,994],{"class":552},[542,3137,573],{"class":552},[542,3139,597],{"class":552},[542,3141,999],{"class":552},[542,3143,1174],{"class":753},[542,3145,994],{"class":552},[542,3147,573],{"class":552},[542,3149,999],{"class":552},[542,3151,607],{"class":579},[542,3153,994],{"class":552},[542,3155,612],{"class":552},[542,3157,999],{"class":552},[542,3159,884],{"class":753},[542,3161,994],{"class":552},[542,3163,573],{"class":552},[542,3165,999],{"class":552},[542,3167,3168],{"class":579},"usr_42",[542,3170,994],{"class":552},[542,3172,665],{"class":552},[542,3174,3175,3177,3179,3181,3183,3185,3187,3189,3191,3193,3195,3197,3199,3201,3203,3205,3207,3209,3211,3214,3216],{"class":544,"line":668},[542,3176,1139],{"class":552},[542,3178,1211],{"class":1142},[542,3180,994],{"class":552},[542,3182,573],{"class":552},[542,3184,597],{"class":552},[542,3186,999],{"class":552},[542,3188,1174],{"class":753},[542,3190,994],{"class":552},[542,3192,573],{"class":552},[542,3194,999],{"class":552},[542,3196,607],{"class":579},[542,3198,994],{"class":552},[542,3200,612],{"class":552},[542,3202,999],{"class":552},[542,3204,884],{"class":753},[542,3206,994],{"class":552},[542,3208,573],{"class":552},[542,3210,999],{"class":552},[542,3212,3213],{"class":579},"usr_99",[542,3215,994],{"class":552},[542,3217,665],{"class":552},[542,3219,3220,3222,3224,3226,3228,3230,3232,3234],{"class":544,"line":685},[542,3221,1139],{"class":552},[542,3223,1257],{"class":1142},[542,3225,994],{"class":552},[542,3227,573],{"class":552},[542,3229,999],{"class":552},[542,3231,678],{"class":579},[542,3233,994],{"class":552},[542,3235,586],{"class":552},[542,3237,3238,3240,3242,3244,3246],{"class":544,"line":694},[542,3239,1139],{"class":552},[542,3241,2578],{"class":1142},[542,3243,994],{"class":552},[542,3245,573],{"class":552},[542,3247,3248],{"class":552}," [\n",[542,3250,3251,3253,3255,3258,3260,3262,3264,3267,3269,3271,3273,3275,3277,3279,3281,3284,3286,3288,3290,3293,3295,3297,3299,3302,3304,3306,3308,3311,3313,3315,3317,3320,3322],{"class":544,"line":701},[542,3252,2178],{"class":552},[542,3254,999],{"class":552},[542,3256,3257],{"class":753},"op",[542,3259,994],{"class":552},[542,3261,573],{"class":552},[542,3263,999],{"class":552},[542,3265,3266],{"class":579},"replace",[542,3268,994],{"class":552},[542,3270,612],{"class":552},[542,3272,999],{"class":552},[542,3274,1053],{"class":753},[542,3276,994],{"class":552},[542,3278,573],{"class":552},[542,3280,999],{"class":552},[542,3282,3283],{"class":579},"\u002Femail",[542,3285,994],{"class":552},[542,3287,612],{"class":552},[542,3289,999],{"class":552},[542,3291,3292],{"class":753},"from",[542,3294,994],{"class":552},[542,3296,573],{"class":552},[542,3298,999],{"class":552},[542,3300,3301],{"class":579},"old@example.com",[542,3303,994],{"class":552},[542,3305,612],{"class":552},[542,3307,999],{"class":552},[542,3309,3310],{"class":753},"to",[542,3312,994],{"class":552},[542,3314,573],{"class":552},[542,3316,999],{"class":552},[542,3318,3319],{"class":579},"new@example.com",[542,3321,994],{"class":552},[542,3323,665],{"class":552},[542,3325,3326,3328,3330,3332,3334,3336,3338,3340,3342,3344,3346,3348,3350,3352,3354,3357,3359,3361,3363,3365,3367,3369,3371,3374,3376,3378,3380,3382,3384,3386,3388,3391,3393],{"class":544,"line":708},[542,3327,2178],{"class":552},[542,3329,999],{"class":552},[542,3331,3257],{"class":753},[542,3333,994],{"class":552},[542,3335,573],{"class":552},[542,3337,999],{"class":552},[542,3339,3266],{"class":579},[542,3341,994],{"class":552},[542,3343,612],{"class":552},[542,3345,999],{"class":552},[542,3347,1053],{"class":753},[542,3349,994],{"class":552},[542,3351,573],{"class":552},[542,3353,999],{"class":552},[542,3355,3356],{"class":579},"\u002Frole",[542,3358,994],{"class":552},[542,3360,612],{"class":552},[542,3362,999],{"class":552},[542,3364,3292],{"class":753},[542,3366,994],{"class":552},[542,3368,573],{"class":552},[542,3370,999],{"class":552},[542,3372,3373],{"class":579},"member",[542,3375,994],{"class":552},[542,3377,612],{"class":552},[542,3379,999],{"class":552},[542,3381,3310],{"class":753},[542,3383,994],{"class":552},[542,3385,573],{"class":552},[542,3387,999],{"class":552},[542,3389,3390],{"class":579},"admin",[542,3392,994],{"class":552},[542,3394,665],{"class":552},[542,3396,3397,3399,3401,3403,3405,3407,3409,3411,3413,3415,3417,3419,3421,3423,3425,3428,3430,3432,3434,3436,3438,3440,3442,3445,3447,3449,3451,3453,3455,3457,3459,3461,3463],{"class":544,"line":1136},[542,3398,2178],{"class":552},[542,3400,999],{"class":552},[542,3402,3257],{"class":753},[542,3404,994],{"class":552},[542,3406,573],{"class":552},[542,3408,999],{"class":552},[542,3410,3266],{"class":579},[542,3412,994],{"class":552},[542,3414,612],{"class":552},[542,3416,999],{"class":552},[542,3418,1053],{"class":753},[542,3420,994],{"class":552},[542,3422,573],{"class":552},[542,3424,999],{"class":552},[542,3426,3427],{"class":579},"\u002Fpassword",[542,3429,994],{"class":552},[542,3431,612],{"class":552},[542,3433,999],{"class":552},[542,3435,3292],{"class":753},[542,3437,994],{"class":552},[542,3439,573],{"class":552},[542,3441,999],{"class":552},[542,3443,3444],{"class":579},"[REDACTED]",[542,3446,994],{"class":552},[542,3448,612],{"class":552},[542,3450,999],{"class":552},[542,3452,3310],{"class":753},[542,3454,994],{"class":552},[542,3456,573],{"class":552},[542,3458,999],{"class":552},[542,3460,3444],{"class":579},[542,3462,994],{"class":552},[542,3464,3465],{"class":552}," }\n",[542,3467,3468],{"class":544,"line":1158},[542,3469,3470],{"class":552},"    ],\n",[542,3472,3473,3475,3477,3479,3481,3483],{"class":544,"line":1206},[542,3474,1139],{"class":552},[542,3476,1298],{"class":1142},[542,3478,994],{"class":552},[542,3480,573],{"class":552},[542,3482,754],{"class":753},[542,3484,586],{"class":552},[542,3486,3487,3489,3491,3493,3495,3497,3500],{"class":544,"line":1252},[542,3488,1139],{"class":552},[542,3490,1314],{"class":1142},[542,3492,994],{"class":552},[542,3494,573],{"class":552},[542,3496,999],{"class":552},[542,3498,3499],{"class":579},"ak_5e7d8f9a0b1c2d3e",[542,3501,1381],{"class":552},[542,3503,3504],{"class":544,"line":1273},[542,3505,1393],{"class":552},[542,3507,3508],{"class":544,"line":1293},[542,3509,970],{"class":552},[516,3511,3513,3516],{"id":3512},"withaudit-auto-instrumentation",[520,3514,3515],{},"withAudit()"," — auto-instrumentation",[512,3518,3519,3520,3522],{},"Devs forget to call ",[520,3521,522],{},". Wrap the function and never miss a record:",[3524,3525,3526,3529,3530,3533,3534,3536,3537,3540],"tip",{},[1993,3527,3528],{},"When to wrap vs. call manually."," Wrap functions that are ",[2819,3531,3532],{},"pure audit-worthy actions"," (refund, delete, role change, password reset) — outcome resolution is automatic and you can't accidentally skip the call. Stick to manual ",[520,3535,522],{}," when the audit is one of several decisions inside a larger handler, or when you need to emit the audit ",[2819,3538,3539],{},"before"," the action completes (e.g. \"user requested deletion\").",[778,3542,3543,3836,4041,4357],{},[533,3544,3546],{"className":535,"code":3545,"filename":783,"language":537,"meta":538,"style":538},"import { withAudit, AuditDeniedError } from 'evlog'\n\nconst refundInvoice = withAudit(\n  { action: 'invoice.refund', target: input => ({ type: 'invoice', id: input.id }) },\n  async (input: { id: string }, ctx) => {\n    if (!ctx.actor) throw new AuditDeniedError('Anonymous refund denied')\n    return await db.invoices.refund(input.id)\n  },\n)\n\nawait refundInvoice({ id: 'inv_889' }, {\n  actor: { type: 'user', id: user.id },\n  correlationId: requestId,\n})\n",[520,3547,3548,3572,3576,3590,3651,3683,3720,3748,3752,3756,3760,3786,3818,3830],{"__ignoreMap":538},[542,3549,3550,3552,3554,3557,3559,3562,3564,3566,3568,3570],{"class":544,"line":545},[542,3551,1423],{"class":790},[542,3553,597],{"class":552},[542,3555,3556],{"class":548}," withAudit",[542,3558,612],{"class":552},[542,3560,3561],{"class":548}," AuditDeniedError",[542,3563,757],{"class":552},[542,3565,1432],{"class":790},[542,3567,576],{"class":552},[542,3569,1437],{"class":579},[542,3571,1440],{"class":552},[542,3573,3574],{"class":544,"line":566},[542,3575,698],{"emptyLinePlaceholder":697},[542,3577,3578,3580,3583,3585,3587],{"class":544,"line":589},[542,3579,1841],{"class":990},[542,3581,3582],{"class":548}," refundInvoice ",[542,3584,1847],{"class":552},[542,3586,3556],{"class":556},[542,3588,3589],{"class":548},"(\n",[542,3591,3592,3595,3597,3599,3601,3603,3605,3607,3609,3611,3615,3618,3620,3622,3624,3626,3628,3630,3632,3634,3636,3638,3640,3642,3644,3646,3649],{"class":544,"line":631},[542,3593,3594],{"class":552},"  {",[542,3596,730],{"class":569},[542,3598,573],{"class":552},[542,3600,576],{"class":552},[542,3602,580],{"class":579},[542,3604,583],{"class":552},[542,3606,612],{"class":552},[542,3608,1864],{"class":556},[542,3610,573],{"class":552},[542,3612,3614],{"class":3613},"sHdIc"," input",[542,3616,3617],{"class":990}," =>",[542,3619,794],{"class":548},[542,3621,720],{"class":552},[542,3623,600],{"class":569},[542,3625,573],{"class":552},[542,3627,576],{"class":552},[542,3629,647],{"class":579},[542,3631,583],{"class":552},[542,3633,612],{"class":552},[542,3635,615],{"class":569},[542,3637,573],{"class":552},[542,3639,3614],{"class":548},[542,3641,553],{"class":552},[542,3643,625],{"class":548},[542,3645,688],{"class":552},[542,3647,3648],{"class":548},") ",[542,3650,628],{"class":552},[542,3652,3653,3656,3658,3661,3663,3665,3667,3669,3672,3674,3677,3679,3681],{"class":544,"line":668},[542,3654,3655],{"class":990},"  async",[542,3657,794],{"class":552},[542,3659,3660],{"class":3613},"input",[542,3662,573],{"class":552},[542,3664,597],{"class":552},[542,3666,615],{"class":569},[542,3668,573],{"class":552},[542,3670,3671],{"class":1142}," string",[542,3673,1950],{"class":552},[542,3675,3676],{"class":3613}," ctx",[542,3678,2583],{"class":552},[542,3680,3617],{"class":990},[542,3682,837],{"class":552},[542,3684,3685,3688,3690,3692,3695,3697,3699,3701,3704,3707,3709,3711,3713,3716,3718],{"class":544,"line":685},[542,3686,3687],{"class":790},"    if",[542,3689,794],{"class":569},[542,3691,797],{"class":552},[542,3693,3694],{"class":548},"ctx",[542,3696,553],{"class":552},[542,3698,1163],{"class":548},[542,3700,3648],{"class":569},[542,3702,3703],{"class":790},"throw",[542,3705,3706],{"class":552}," new",[542,3708,3561],{"class":556},[542,3710,560],{"class":569},[542,3712,583],{"class":552},[542,3714,3715],{"class":579},"Anonymous refund denied",[542,3717,583],{"class":552},[542,3719,691],{"class":569},[542,3721,3722,3725,3727,3729,3731,3734,3736,3738,3740,3742,3744,3746],{"class":544,"line":694},[542,3723,3724],{"class":790},"    return",[542,3726,2883],{"class":790},[542,3728,2886],{"class":548},[542,3730,553],{"class":552},[542,3732,3733],{"class":548},"invoices",[542,3735,553],{"class":552},[542,3737,1893],{"class":556},[542,3739,560],{"class":569},[542,3741,3660],{"class":548},[542,3743,553],{"class":552},[542,3745,884],{"class":548},[542,3747,691],{"class":569},[542,3749,3750],{"class":544,"line":701},[542,3751,2168],{"class":552},[542,3753,3754],{"class":544,"line":708},[542,3755,691],{"class":548},[542,3757,3758],{"class":544,"line":1136},[542,3759,698],{"emptyLinePlaceholder":697},[542,3761,3762,3765,3768,3770,3772,3774,3776,3778,3780,3782,3784],{"class":544,"line":1158},[542,3763,3764],{"class":790},"await",[542,3766,3767],{"class":556}," refundInvoice",[542,3769,560],{"class":548},[542,3771,720],{"class":552},[542,3773,615],{"class":569},[542,3775,573],{"class":552},[542,3777,576],{"class":552},[542,3779,660],{"class":579},[542,3781,583],{"class":552},[542,3783,1950],{"class":552},[542,3785,837],{"class":552},[542,3787,3788,3790,3792,3794,3796,3798,3800,3802,3804,3806,3808,3810,3812,3814,3816],{"class":544,"line":1206},[542,3789,592],{"class":569},[542,3791,573],{"class":552},[542,3793,597],{"class":552},[542,3795,600],{"class":569},[542,3797,573],{"class":552},[542,3799,576],{"class":552},[542,3801,607],{"class":579},[542,3803,583],{"class":552},[542,3805,612],{"class":552},[542,3807,615],{"class":569},[542,3809,573],{"class":552},[542,3811,620],{"class":548},[542,3813,553],{"class":552},[542,3815,625],{"class":548},[542,3817,628],{"class":552},[542,3819,3820,3823,3825,3828],{"class":544,"line":1252},[542,3821,3822],{"class":569},"  correlationId",[542,3824,573],{"class":552},[542,3826,3827],{"class":548}," requestId",[542,3829,586],{"class":552},[542,3831,3832,3834],{"class":544,"line":1273},[542,3833,688],{"class":552},[542,3835,691],{"class":548},[533,3837,3840],{"className":973,"code":3838,"filename":3839,"language":976,"meta":538,"style":538},"{\n  \"audit\": {\n    \"action\": \"invoice.refund\",\n    \"actor\": { \"type\": \"user\", \"id\": \"usr_42\" },\n    \"target\": { \"type\": \"invoice\", \"id\": \"inv_889\" },\n    \"outcome\": \"success\",\n    \"version\": 1,\n    \"idempotencyKey\": \"ak_8f3c4b2a1e5d6f7c\",\n    \"correlationId\": \"a566ef91-7765-4f59-b6f0-b9f40ce71599\"\n  }\n}\n","Output — success",[520,3841,3842,3846,3858,3876,3920,3964,3982,3996,4015,4033,4037],{"__ignoreMap":538},[542,3843,3844],{"class":544,"line":545},[542,3845,563],{"class":552},[542,3847,3848,3850,3852,3854,3856],{"class":544,"line":566},[542,3849,987],{"class":552},[542,3851,557],{"class":990},[542,3853,994],{"class":552},[542,3855,573],{"class":552},[542,3857,837],{"class":552},[542,3859,3860,3862,3864,3866,3868,3870,3872,3874],{"class":544,"line":589},[542,3861,1139],{"class":552},[542,3863,1143],{"class":1142},[542,3865,994],{"class":552},[542,3867,573],{"class":552},[542,3869,999],{"class":552},[542,3871,580],{"class":579},[542,3873,994],{"class":552},[542,3875,586],{"class":552},[542,3877,3878,3880,3882,3884,3886,3888,3890,3892,3894,3896,3898,3900,3902,3904,3906,3908,3910,3912,3914,3916,3918],{"class":544,"line":631},[542,3879,1139],{"class":552},[542,3881,1163],{"class":1142},[542,3883,994],{"class":552},[542,3885,573],{"class":552},[542,3887,597],{"class":552},[542,3889,999],{"class":552},[542,3891,1174],{"class":753},[542,3893,994],{"class":552},[542,3895,573],{"class":552},[542,3897,999],{"class":552},[542,3899,607],{"class":579},[542,3901,994],{"class":552},[542,3903,612],{"class":552},[542,3905,999],{"class":552},[542,3907,884],{"class":753},[542,3909,994],{"class":552},[542,3911,573],{"class":552},[542,3913,999],{"class":552},[542,3915,3168],{"class":579},[542,3917,994],{"class":552},[542,3919,665],{"class":552},[542,3921,3922,3924,3926,3928,3930,3932,3934,3936,3938,3940,3942,3944,3946,3948,3950,3952,3954,3956,3958,3960,3962],{"class":544,"line":668},[542,3923,1139],{"class":552},[542,3925,1211],{"class":1142},[542,3927,994],{"class":552},[542,3929,573],{"class":552},[542,3931,597],{"class":552},[542,3933,999],{"class":552},[542,3935,1174],{"class":753},[542,3937,994],{"class":552},[542,3939,573],{"class":552},[542,3941,999],{"class":552},[542,3943,647],{"class":579},[542,3945,994],{"class":552},[542,3947,612],{"class":552},[542,3949,999],{"class":552},[542,3951,884],{"class":753},[542,3953,994],{"class":552},[542,3955,573],{"class":552},[542,3957,999],{"class":552},[542,3959,660],{"class":579},[542,3961,994],{"class":552},[542,3963,665],{"class":552},[542,3965,3966,3968,3970,3972,3974,3976,3978,3980],{"class":544,"line":685},[542,3967,1139],{"class":552},[542,3969,1257],{"class":1142},[542,3971,994],{"class":552},[542,3973,573],{"class":552},[542,3975,999],{"class":552},[542,3977,678],{"class":579},[542,3979,994],{"class":552},[542,3981,586],{"class":552},[542,3983,3984,3986,3988,3990,3992,3994],{"class":544,"line":694},[542,3985,1139],{"class":552},[542,3987,1298],{"class":1142},[542,3989,994],{"class":552},[542,3991,573],{"class":552},[542,3993,754],{"class":753},[542,3995,586],{"class":552},[542,3997,3998,4000,4002,4004,4006,4008,4011,4013],{"class":544,"line":701},[542,3999,1139],{"class":552},[542,4001,1314],{"class":1142},[542,4003,994],{"class":552},[542,4005,573],{"class":552},[542,4007,999],{"class":552},[542,4009,4010],{"class":579},"ak_8f3c4b2a1e5d6f7c",[542,4012,994],{"class":552},[542,4014,586],{"class":552},[542,4016,4017,4019,4022,4024,4026,4028,4031],{"class":544,"line":708},[542,4018,1139],{"class":552},[542,4020,4021],{"class":1142},"correlationId",[542,4023,994],{"class":552},[542,4025,573],{"class":552},[542,4027,999],{"class":552},[542,4029,4030],{"class":579},"a566ef91-7765-4f59-b6f0-b9f40ce71599",[542,4032,1381],{"class":552},[542,4034,4035],{"class":544,"line":1136},[542,4036,1393],{"class":552},[542,4038,4039],{"class":544,"line":1158},[542,4040,970],{"class":552},[533,4042,4045],{"className":973,"code":4043,"filename":4044,"language":976,"meta":538,"style":538},"{\n  \"level\": \"error\",\n  \"audit\": {\n    \"action\": \"invoice.refund\",\n    \"actor\": { \"type\": \"user\", \"id\": \"usr_42\" },\n    \"target\": { \"type\": \"invoice\", \"id\": \"inv_889\" },\n    \"outcome\": \"failure\",\n    \"reason\": \"Stripe error: charge already refunded\",\n    \"version\": 1,\n    \"idempotencyKey\": \"ak_4c5d6e7f8a9b0c1d\",\n    \"correlationId\": \"a566ef91-7765-4f59-b6f0-b9f40ce71599\"\n  },\n  \"error\": {\n    \"name\": \"StripeError\",\n    \"message\": \"charge already refunded\",\n    \"stack\": \"...\"\n  }\n}\n","Output — failure",[520,4046,4047,4051,4070,4082,4100,4144,4188,4207,4226,4240,4259,4275,4279,4291,4311,4331,4349,4353],{"__ignoreMap":538},[542,4048,4049],{"class":544,"line":545},[542,4050,563],{"class":552},[542,4052,4053,4055,4057,4059,4061,4063,4066,4068],{"class":544,"line":566},[542,4054,987],{"class":552},[542,4056,991],{"class":990},[542,4058,994],{"class":552},[542,4060,573],{"class":552},[542,4062,999],{"class":552},[542,4064,4065],{"class":579},"error",[542,4067,994],{"class":552},[542,4069,586],{"class":552},[542,4071,4072,4074,4076,4078,4080],{"class":544,"line":589},[542,4073,987],{"class":552},[542,4075,557],{"class":990},[542,4077,994],{"class":552},[542,4079,573],{"class":552},[542,4081,837],{"class":552},[542,4083,4084,4086,4088,4090,4092,4094,4096,4098],{"class":544,"line":631},[542,4085,1139],{"class":552},[542,4087,1143],{"class":1142},[542,4089,994],{"class":552},[542,4091,573],{"class":552},[542,4093,999],{"class":552},[542,4095,580],{"class":579},[542,4097,994],{"class":552},[542,4099,586],{"class":552},[542,4101,4102,4104,4106,4108,4110,4112,4114,4116,4118,4120,4122,4124,4126,4128,4130,4132,4134,4136,4138,4140,4142],{"class":544,"line":668},[542,4103,1139],{"class":552},[542,4105,1163],{"class":1142},[542,4107,994],{"class":552},[542,4109,573],{"class":552},[542,4111,597],{"class":552},[542,4113,999],{"class":552},[542,4115,1174],{"class":753},[542,4117,994],{"class":552},[542,4119,573],{"class":552},[542,4121,999],{"class":552},[542,4123,607],{"class":579},[542,4125,994],{"class":552},[542,4127,612],{"class":552},[542,4129,999],{"class":552},[542,4131,884],{"class":753},[542,4133,994],{"class":552},[542,4135,573],{"class":552},[542,4137,999],{"class":552},[542,4139,3168],{"class":579},[542,4141,994],{"class":552},[542,4143,665],{"class":552},[542,4145,4146,4148,4150,4152,4154,4156,4158,4160,4162,4164,4166,4168,4170,4172,4174,4176,4178,4180,4182,4184,4186],{"class":544,"line":685},[542,4147,1139],{"class":552},[542,4149,1211],{"class":1142},[542,4151,994],{"class":552},[542,4153,573],{"class":552},[542,4155,597],{"class":552},[542,4157,999],{"class":552},[542,4159,1174],{"class":753},[542,4161,994],{"class":552},[542,4163,573],{"class":552},[542,4165,999],{"class":552},[542,4167,647],{"class":579},[542,4169,994],{"class":552},[542,4171,612],{"class":552},[542,4173,999],{"class":552},[542,4175,884],{"class":753},[542,4177,994],{"class":552},[542,4179,573],{"class":552},[542,4181,999],{"class":552},[542,4183,660],{"class":579},[542,4185,994],{"class":552},[542,4187,665],{"class":552},[542,4189,4190,4192,4194,4196,4198,4200,4203,4205],{"class":544,"line":694},[542,4191,1139],{"class":552},[542,4193,1257],{"class":1142},[542,4195,994],{"class":552},[542,4197,573],{"class":552},[542,4199,999],{"class":552},[542,4201,4202],{"class":579},"failure",[542,4204,994],{"class":552},[542,4206,586],{"class":552},[542,4208,4209,4211,4213,4215,4217,4219,4222,4224],{"class":544,"line":701},[542,4210,1139],{"class":552},[542,4212,1278],{"class":1142},[542,4214,994],{"class":552},[542,4216,573],{"class":552},[542,4218,999],{"class":552},[542,4220,4221],{"class":579},"Stripe error: charge already refunded",[542,4223,994],{"class":552},[542,4225,586],{"class":552},[542,4227,4228,4230,4232,4234,4236,4238],{"class":544,"line":708},[542,4229,1139],{"class":552},[542,4231,1298],{"class":1142},[542,4233,994],{"class":552},[542,4235,573],{"class":552},[542,4237,754],{"class":753},[542,4239,586],{"class":552},[542,4241,4242,4244,4246,4248,4250,4252,4255,4257],{"class":544,"line":1136},[542,4243,1139],{"class":552},[542,4245,1314],{"class":1142},[542,4247,994],{"class":552},[542,4249,573],{"class":552},[542,4251,999],{"class":552},[542,4253,4254],{"class":579},"ak_4c5d6e7f8a9b0c1d",[542,4256,994],{"class":552},[542,4258,586],{"class":552},[542,4260,4261,4263,4265,4267,4269,4271,4273],{"class":544,"line":1158},[542,4262,1139],{"class":552},[542,4264,4021],{"class":1142},[542,4266,994],{"class":552},[542,4268,573],{"class":552},[542,4270,999],{"class":552},[542,4272,4030],{"class":579},[542,4274,1381],{"class":552},[542,4276,4277],{"class":544,"line":1206},[542,4278,2168],{"class":552},[542,4280,4281,4283,4285,4287,4289],{"class":544,"line":1252},[542,4282,987],{"class":552},[542,4284,4065],{"class":990},[542,4286,994],{"class":552},[542,4288,573],{"class":552},[542,4290,837],{"class":552},[542,4292,4293,4295,4298,4300,4302,4304,4307,4309],{"class":544,"line":1273},[542,4294,1139],{"class":552},[542,4296,4297],{"class":1142},"name",[542,4299,994],{"class":552},[542,4301,573],{"class":552},[542,4303,999],{"class":552},[542,4305,4306],{"class":579},"StripeError",[542,4308,994],{"class":552},[542,4310,586],{"class":552},[542,4312,4313,4315,4318,4320,4322,4324,4327,4329],{"class":544,"line":1293},[542,4314,1139],{"class":552},[542,4316,4317],{"class":1142},"message",[542,4319,994],{"class":552},[542,4321,573],{"class":552},[542,4323,999],{"class":552},[542,4325,4326],{"class":579},"charge already refunded",[542,4328,994],{"class":552},[542,4330,586],{"class":552},[542,4332,4333,4335,4338,4340,4342,4344,4347],{"class":544,"line":1309},[542,4334,1139],{"class":552},[542,4336,4337],{"class":1142},"stack",[542,4339,994],{"class":552},[542,4341,573],{"class":552},[542,4343,999],{"class":552},[542,4345,4346],{"class":579},"...",[542,4348,1381],{"class":552},[542,4350,4351],{"class":544,"line":1330},[542,4352,1393],{"class":552},[542,4354,4355],{"class":544,"line":1344},[542,4356,970],{"class":552},[533,4358,4360],{"className":973,"code":4359,"filename":975,"language":976,"meta":538,"style":538},"{\n  \"level\": \"warn\",\n  \"audit\": {\n    \"action\": \"invoice.refund\",\n    \"actor\": { \"type\": \"system\", \"id\": \"anonymous\" },\n    \"target\": { \"type\": \"invoice\", \"id\": \"inv_889\" },\n    \"outcome\": \"denied\",\n    \"reason\": \"Anonymous refund denied\",\n    \"version\": 1,\n    \"idempotencyKey\": \"ak_d12c3a4f5b6e7d8c\",\n    \"correlationId\": \"a566ef91-7765-4f59-b6f0-b9f40ce71599\"\n  }\n}\n",[520,4361,4362,4366,4384,4396,4414,4459,4503,4521,4539,4553,4571,4587,4591],{"__ignoreMap":538},[542,4363,4364],{"class":544,"line":545},[542,4365,563],{"class":552},[542,4367,4368,4370,4372,4374,4376,4378,4380,4382],{"class":544,"line":566},[542,4369,987],{"class":552},[542,4371,991],{"class":990},[542,4373,994],{"class":552},[542,4375,573],{"class":552},[542,4377,999],{"class":552},[542,4379,1002],{"class":579},[542,4381,994],{"class":552},[542,4383,586],{"class":552},[542,4385,4386,4388,4390,4392,4394],{"class":544,"line":589},[542,4387,987],{"class":552},[542,4389,557],{"class":990},[542,4391,994],{"class":552},[542,4393,573],{"class":552},[542,4395,837],{"class":552},[542,4397,4398,4400,4402,4404,4406,4408,4410,4412],{"class":544,"line":631},[542,4399,1139],{"class":552},[542,4401,1143],{"class":1142},[542,4403,994],{"class":552},[542,4405,573],{"class":552},[542,4407,999],{"class":552},[542,4409,580],{"class":579},[542,4411,994],{"class":552},[542,4413,586],{"class":552},[542,4415,4416,4418,4420,4422,4424,4426,4428,4430,4432,4434,4436,4438,4440,4442,4444,4446,4448,4450,4452,4455,4457],{"class":544,"line":668},[542,4417,1139],{"class":552},[542,4419,1163],{"class":1142},[542,4421,994],{"class":552},[542,4423,573],{"class":552},[542,4425,597],{"class":552},[542,4427,999],{"class":552},[542,4429,1174],{"class":753},[542,4431,994],{"class":552},[542,4433,573],{"class":552},[542,4435,999],{"class":552},[542,4437,1484],{"class":579},[542,4439,994],{"class":552},[542,4441,612],{"class":552},[542,4443,999],{"class":552},[542,4445,884],{"class":753},[542,4447,994],{"class":552},[542,4449,573],{"class":552},[542,4451,999],{"class":552},[542,4453,4454],{"class":579},"anonymous",[542,4456,994],{"class":552},[542,4458,665],{"class":552},[542,4460,4461,4463,4465,4467,4469,4471,4473,4475,4477,4479,4481,4483,4485,4487,4489,4491,4493,4495,4497,4499,4501],{"class":544,"line":685},[542,4462,1139],{"class":552},[542,4464,1211],{"class":1142},[542,4466,994],{"class":552},[542,4468,573],{"class":552},[542,4470,597],{"class":552},[542,4472,999],{"class":552},[542,4474,1174],{"class":753},[542,4476,994],{"class":552},[542,4478,573],{"class":552},[542,4480,999],{"class":552},[542,4482,647],{"class":579},[542,4484,994],{"class":552},[542,4486,612],{"class":552},[542,4488,999],{"class":552},[542,4490,884],{"class":753},[542,4492,994],{"class":552},[542,4494,573],{"class":552},[542,4496,999],{"class":552},[542,4498,660],{"class":579},[542,4500,994],{"class":552},[542,4502,665],{"class":552},[542,4504,4505,4507,4509,4511,4513,4515,4517,4519],{"class":544,"line":694},[542,4506,1139],{"class":552},[542,4508,1257],{"class":1142},[542,4510,994],{"class":552},[542,4512,573],{"class":552},[542,4514,999],{"class":552},[542,4516,1266],{"class":579},[542,4518,994],{"class":552},[542,4520,586],{"class":552},[542,4522,4523,4525,4527,4529,4531,4533,4535,4537],{"class":544,"line":701},[542,4524,1139],{"class":552},[542,4526,1278],{"class":1142},[542,4528,994],{"class":552},[542,4530,573],{"class":552},[542,4532,999],{"class":552},[542,4534,3715],{"class":579},[542,4536,994],{"class":552},[542,4538,586],{"class":552},[542,4540,4541,4543,4545,4547,4549,4551],{"class":544,"line":708},[542,4542,1139],{"class":552},[542,4544,1298],{"class":1142},[542,4546,994],{"class":552},[542,4548,573],{"class":552},[542,4550,754],{"class":753},[542,4552,586],{"class":552},[542,4554,4555,4557,4559,4561,4563,4565,4567,4569],{"class":544,"line":1136},[542,4556,1139],{"class":552},[542,4558,1314],{"class":1142},[542,4560,994],{"class":552},[542,4562,573],{"class":552},[542,4564,999],{"class":552},[542,4566,1323],{"class":579},[542,4568,994],{"class":552},[542,4570,586],{"class":552},[542,4572,4573,4575,4577,4579,4581,4583,4585],{"class":544,"line":1158},[542,4574,1139],{"class":552},[542,4576,4021],{"class":1142},[542,4578,994],{"class":552},[542,4580,573],{"class":552},[542,4582,999],{"class":552},[542,4584,4030],{"class":579},[542,4586,1381],{"class":552},[542,4588,4589],{"class":544,"line":1206},[542,4590,1393],{"class":552},[542,4592,4593],{"class":544,"line":1252},[542,4594,970],{"class":552},[512,4596,4597],{},"Outcome resolution:",[2625,4599,4600,4609,4628],{},[2628,4601,4602,4605,4606,553],{},[520,4603,4604],{},"fn"," resolves → ",[520,4607,4608],{},"outcome: 'success'",[2628,4610,4611,4613,4614,4617,4618,4621,4622,4625,4626,553],{},[520,4612,4604],{}," throws an ",[520,4615,4616],{},"AuditDeniedError"," (or any error with ",[520,4619,4620],{},"status === 403",") → ",[520,4623,4624],{},"outcome: 'denied'",", error message becomes ",[520,4627,1278],{},[2628,4629,4630,4631,4634],{},"Other thrown errors → ",[520,4632,4633],{},"outcome: 'failure'",", then re-thrown.",[4636,4637,4638],"style",{},"html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":538,"searchDepth":566,"depth":566,"links":4640},[4641,4642,4643,4645,4646,4651,4652],{"id":518,"depth":566,"text":522},{"id":767,"depth":566,"text":770},{"id":1401,"depth":566,"text":4644},"Standalone audit()",{"id":1800,"depth":566,"text":1803},{"id":1985,"depth":566,"text":1988,"children":4647},[4648,4650],{"id":2613,"depth":589,"text":4649},"defineAuditAction vs defineAuditCatalog — when to choose",{"id":2691,"depth":589,"text":2692},{"id":2797,"depth":566,"text":2800},{"id":3512,"depth":566,"text":4653},"withAudit() — auto-instrumentation","log.audit, log.audit.deny, standalone audit(), withAudit auto-instrumentation, defineAuditAction and defineAuditCatalog registries, and auditDiff change patches.","md",[4657,4660],{"label":367,"icon":370,"to":368,"color":4658,"variant":4659},"neutral","subtle",{"label":4661,"icon":380,"to":378,"color":4658,"variant":4659},"Drains & Integrity",{},{"title":372,"icon":375},{"title":507,"description":4654},"PSZtU2s5zm8923r3ypI-OybWiGUxGIxd2d5epMRl_hk",[4667,4669],{"title":367,"path":368,"stem":369,"description":4668,"icon":370,"children":-1},"The AuditFields type, action naming conventions, actor types, idempotency, and how the schema sits inside a regular wide event.",{"title":377,"path":378,"stem":379,"description":4670,"icon":380,"children":-1},"auditEnricher to auto-fill request context, auditOnly to route audits to a dedicated sink, and signed for tamper-evident HMAC or hash-chain integrity.",1785224898670]