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