[{"data":1,"prerenderedAt":5372},["ShallowReactive",2],{"navigation_docs":3,"-learn-structured-errors":529,"-learn-structured-errors-surround":5367},[4,30,80,128,308,440,499],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118,123],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"icon":127},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":129,"path":130,"stem":131,"children":132,"page":29},"Integrate","\u002Fintegrate","4.integrate",[133,137,220],{"title":36,"path":134,"stem":135,"icon":136},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[142,145,175,200],{"title":36,"path":143,"stem":144,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":146,"path":147,"stem":148,"children":149,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[150,155,160,165,170],{"title":151,"path":152,"stem":153,"icon":154},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"children":179,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[180,185,190,195],{"title":181,"path":182,"stem":183,"icon":184},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":186,"path":187,"stem":188,"icon":189},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":191,"path":192,"stem":193,"icon":194},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":196,"path":197,"stem":198,"icon":199},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[205,210,215],{"title":206,"path":207,"stem":208,"icon":209},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":211,"path":212,"stem":213,"icon":214},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":216,"path":217,"stem":218,"icon":219},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":221,"path":222,"stem":223,"children":224,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[225,229,234,239,244,249,254,259,264,269,274,279,284,289,293,298,303],{"title":36,"path":226,"stem":227,"icon":228},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":230,"path":231,"stem":232,"icon":233},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":235,"path":236,"stem":237,"icon":238},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":240,"path":241,"stem":242,"icon":243},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":245,"path":246,"stem":247,"icon":248},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":250,"path":251,"stem":252,"icon":253},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":255,"path":256,"stem":257,"icon":258},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":260,"path":261,"stem":262,"icon":263},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":270,"path":271,"stem":272,"icon":273},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":275,"path":276,"stem":277,"icon":278},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":280,"path":281,"stem":282,"icon":283},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":285,"path":286,"stem":287,"icon":288},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":290,"path":291,"stem":292,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":294,"path":295,"stem":296,"icon":297},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":299,"path":300,"stem":301,"icon":302},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":304,"path":305,"stem":306,"icon":307},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":309,"path":310,"stem":311,"children":312,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[313,316,321,350,377,409,430,435],{"title":36,"path":314,"stem":315,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":317,"path":318,"stem":319,"icon":320},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":322,"icon":323,"path":324,"stem":325,"children":326,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[327,330,335,340,345],{"title":36,"path":328,"stem":329,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":331,"path":332,"stem":333,"icon":334},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":336,"path":337,"stem":338,"icon":339},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":341,"path":342,"stem":343,"icon":344},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":346,"path":347,"stem":348,"icon":349},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":351,"icon":352,"path":353,"stem":354,"children":355,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[356,359,364,369,373],{"title":36,"path":357,"stem":358,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":360,"path":361,"stem":362,"icon":363},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":365,"path":366,"stem":367,"icon":368},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":370,"path":371,"stem":372,"icon":320},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":374,"path":375,"stem":376,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":378,"icon":379,"path":380,"stem":381,"children":382,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[383,386,391,396,401,405],{"title":36,"path":384,"stem":385,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":390},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":392,"path":393,"stem":394,"icon":395},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":397,"path":398,"stem":399,"icon":400},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":402,"path":403,"stem":404,"icon":379},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":406,"path":407,"stem":408,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":346,"icon":107,"path":410,"stem":411,"children":412,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[413,416,421,426],{"title":36,"path":414,"stem":415,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":417,"path":418,"stem":419,"icon":420},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":422,"path":423,"stem":424,"icon":425},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":427,"path":428,"stem":429,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":431,"path":432,"stem":433,"icon":434},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":436,"path":437,"stem":438,"icon":439},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":441,"path":442,"stem":443,"children":444,"page":29},"Extend","\u002Fextend","6.extend",[445,449,454,459,463,468,472,476,480,484,489,494],{"title":36,"path":446,"stem":447,"icon":448},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":450,"path":451,"stem":452,"icon":453},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":455,"path":456,"stem":457,"icon":458},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":460,"path":461,"stem":462,"icon":453},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":464,"path":465,"stem":466,"icon":467},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":469,"stem":470,"icon":471},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":473,"path":474,"stem":475,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":477,"path":478,"stem":479,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":481,"path":482,"stem":483,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":485,"path":486,"stem":487,"icon":488},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":490,"path":491,"stem":492,"icon":493},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":495,"path":496,"stem":497,"icon":498},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":500,"stem":501,"children":502,"page":29},"\u002Freference","7.reference",[503,508,511,516,520,525],{"title":504,"path":505,"stem":506,"icon":507},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":509,"stem":510,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":512,"path":513,"stem":514,"icon":515},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":517,"path":518,"stem":519,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":521,"path":522,"stem":523,"icon":524},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":526,"path":527,"stem":528,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":530,"title":51,"body":531,"description":5357,"extension":5358,"links":5359,"meta":5363,"navigation":5364,"path":52,"seo":5365,"stem":53,"__hash__":5366},"docs\u002F2.learn\u002F3.structured-errors.md",{"type":532,"value":533,"toc":5326},"minimark",[534,543,636,641,644,647,697,712,715,1022,1026,1144,1150,1164,1307,1354,1361,1365,1370,1485,1489,1747,1751,1754,1907,1911,1939,2247,2250,2254,2320,2345,2351,2359,2362,2606,2629,2638,2642,2647,3141,3145,3148,3468,3471,3475,3752,3756,3912,3916,3941,3946,3957,4583,4597,4668,4672,4682,4819,4840,4846,4852,4985,4989,5006,5249,5252,5277,5289,5296,5300,5322],[535,536,537,538,542],"p",{},"evlog provides a ",[539,540,541],"code",{},"createError()"," function that creates errors with rich, actionable context.",[544,545,548,551,627],"prompt",{":actions":546,"description":547,"icon":54},"[\"copy\",\"cursor\",\"claude\"]","Use structured errors in my app",[535,549,550],{},"Use structured errors with code \u002F why \u002F fix \u002F link fields throughout my app.",[552,553,554,562,576,594,601,608,611,618],"ul",{},[555,556,557,558,561],"li",{},"Replace plain ",[539,559,560],{},"throw new Error(...)"," calls with createError({ code, message, status, why, fix, link })",[555,563,564,565,567,568,571,572,575],{},"Use ",[539,566,539],{}," as a stable, machine-readable identifier (e.g. ",[539,569,570],{},"'PAYMENT_DECLINED'",", ",[539,573,574],{},"'auth\u002Finvalid-token'",") so clients and dashboards can branch on it",[555,577,564,578,581,582,585,586,589,590,593],{},[539,579,580],{},"message"," for what happened, ",[539,583,584],{},"why"," for the technical reason, ",[539,587,588],{},"fix"," for the actionable solution, and ",[539,591,592],{},"link"," for docs",[555,595,596,597,600],{},"Set the appropriate HTTP ",[539,598,599],{},"status"," for API routes (400 \u002F 401 \u002F 402 \u002F 403 \u002F 404 \u002F 422 \u002F 500)",[555,602,603,604,607],{},"For internal-only context, pass ",[539,605,606],{},"internal: { ... }"," (logged but never returned in HTTP responses)",[555,609,610],{},"On the client, use parseError(err) to extract { message, status, code, why, fix, link } from any thrown error",[555,612,613,614,617],{},"Branch on ",[539,615,616],{},"parseError(err).code === 'PAYMENT_DECLINED'"," rather than parsing user-facing messages",[555,619,620,621,623,624,626],{},"Render ",[539,622,584],{}," and ",[539,625,588],{}," in toasts\u002FUI so users get actionable feedback",[535,628,629,630],{},"Docs: ",[631,632,633],"a",{"href":633,"rel":634},"https:\u002F\u002Fwww.evlog.dev\u002Flearn\u002Fstructured-errors",[635],"nofollow",[637,638,640],"h2",{"id":639},"why-structured-errors","Why Structured Errors?",[642,643],"structured-error-context",{},[535,645,646],{},"Traditional errors are often unhelpful:",[648,649,655],"pre",{"className":650,"code":651,"filename":652,"language":653,"meta":654,"style":654},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F Unhelpful error\nthrow new Error('Payment failed')\n","server\u002Fapi\u002Fcheckout.post.ts","typescript","",[539,656,657,666],{"__ignoreMap":654},[658,659,662],"span",{"class":660,"line":661},"line",1,[658,663,665],{"class":664},"sHwdD","\u002F\u002F Unhelpful error\n",[658,667,669,673,677,681,685,688,692,694],{"class":660,"line":668},2,[658,670,672],{"class":671},"s7zQu","throw",[658,674,676],{"class":675},"sMK4o"," new",[658,678,680],{"class":679},"s2Zo4"," Error",[658,682,684],{"class":683},"sTEyZ","(",[658,686,687],{"class":675},"'",[658,689,691],{"class":690},"sfazB","Payment failed",[658,693,687],{"class":675},[658,695,696],{"class":683},")\n",[535,698,699,700,704,705,707,708,711],{},"This tells you ",[701,702,703],"em",{},"what"," happened, but not ",[701,706,584],{}," or ",[701,709,710],{},"how to fix it",".",[535,713,714],{},"Structured errors provide context:",[716,717,718,876],"code-group",{},[648,719,721],{"className":650,"code":720,"filename":652,"language":653,"meta":654,"style":654},"import { createError } from 'evlog'\n\nthrow createError({\n  code: 'PAYMENT_DECLINED',\n  message: 'Payment failed',\n  status: 402,\n  why: 'Card declined by issuer (insufficient funds)',\n  fix: 'Try a different payment method or contact your bank',\n  link: 'https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined',\n})\n",[539,722,723,749,755,767,787,803,817,834,851,868],{"__ignoreMap":654},[658,724,725,728,731,734,737,740,743,746],{"class":660,"line":661},[658,726,727],{"class":671},"import",[658,729,730],{"class":675}," {",[658,732,733],{"class":683}," createError",[658,735,736],{"class":675}," }",[658,738,739],{"class":671}," from",[658,741,742],{"class":675}," '",[658,744,745],{"class":690},"evlog",[658,747,748],{"class":675},"'\n",[658,750,751],{"class":660,"line":668},[658,752,754],{"emptyLinePlaceholder":753},true,"\n",[658,756,758,760,762,764],{"class":660,"line":757},3,[658,759,672],{"class":671},[658,761,733],{"class":679},[658,763,684],{"class":683},[658,765,766],{"class":675},"{\n",[658,768,770,774,777,779,782,784],{"class":660,"line":769},4,[658,771,773],{"class":772},"swJcz","  code",[658,775,776],{"class":675},":",[658,778,742],{"class":675},[658,780,781],{"class":690},"PAYMENT_DECLINED",[658,783,687],{"class":675},[658,785,786],{"class":675},",\n",[658,788,790,793,795,797,799,801],{"class":660,"line":789},5,[658,791,792],{"class":772},"  message",[658,794,776],{"class":675},[658,796,742],{"class":675},[658,798,691],{"class":690},[658,800,687],{"class":675},[658,802,786],{"class":675},[658,804,806,809,811,815],{"class":660,"line":805},6,[658,807,808],{"class":772},"  status",[658,810,776],{"class":675},[658,812,814],{"class":813},"sbssI"," 402",[658,816,786],{"class":675},[658,818,820,823,825,827,830,832],{"class":660,"line":819},7,[658,821,822],{"class":772},"  why",[658,824,776],{"class":675},[658,826,742],{"class":675},[658,828,829],{"class":690},"Card declined by issuer (insufficient funds)",[658,831,687],{"class":675},[658,833,786],{"class":675},[658,835,837,840,842,844,847,849],{"class":660,"line":836},8,[658,838,839],{"class":772},"  fix",[658,841,776],{"class":675},[658,843,742],{"class":675},[658,845,846],{"class":690},"Try a different payment method or contact your bank",[658,848,687],{"class":675},[658,850,786],{"class":675},[658,852,854,857,859,861,864,866],{"class":660,"line":853},9,[658,855,856],{"class":772},"  link",[658,858,776],{"class":675},[658,860,742],{"class":675},[658,862,863],{"class":690},"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined",[658,865,687],{"class":675},[658,867,786],{"class":675},[658,869,871,874],{"class":660,"line":870},10,[658,872,873],{"class":675},"}",[658,875,696],{"class":683},[648,877,882],{"className":878,"code":879,"filename":880,"language":881,"meta":654,"style":654},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"statusCode\": 402,\n  \"message\": \"Payment failed\",\n  \"data\": {\n    \"code\": \"PAYMENT_DECLINED\",\n    \"why\": \"Card declined by issuer (insufficient funds)\",\n    \"fix\": \"Try a different payment method or contact your bank\",\n    \"link\": \"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined\"\n  }\n}\n","Response","json",[539,883,884,888,906,925,939,959,977,995,1012,1017],{"__ignoreMap":654},[658,885,886],{"class":660,"line":661},[658,887,766],{"class":675},[658,889,890,893,897,900,902,904],{"class":660,"line":668},[658,891,892],{"class":675},"  \"",[658,894,896],{"class":895},"spNyl","statusCode",[658,898,899],{"class":675},"\"",[658,901,776],{"class":675},[658,903,814],{"class":813},[658,905,786],{"class":675},[658,907,908,910,912,914,916,919,921,923],{"class":660,"line":757},[658,909,892],{"class":675},[658,911,580],{"class":895},[658,913,899],{"class":675},[658,915,776],{"class":675},[658,917,918],{"class":675}," \"",[658,920,691],{"class":690},[658,922,899],{"class":675},[658,924,786],{"class":675},[658,926,927,929,932,934,936],{"class":660,"line":769},[658,928,892],{"class":675},[658,930,931],{"class":895},"data",[658,933,899],{"class":675},[658,935,776],{"class":675},[658,937,938],{"class":675}," {\n",[658,940,941,944,947,949,951,953,955,957],{"class":660,"line":789},[658,942,943],{"class":675},"    \"",[658,945,539],{"class":946},"sBMFI",[658,948,899],{"class":675},[658,950,776],{"class":675},[658,952,918],{"class":675},[658,954,781],{"class":690},[658,956,899],{"class":675},[658,958,786],{"class":675},[658,960,961,963,965,967,969,971,973,975],{"class":660,"line":805},[658,962,943],{"class":675},[658,964,584],{"class":946},[658,966,899],{"class":675},[658,968,776],{"class":675},[658,970,918],{"class":675},[658,972,829],{"class":690},[658,974,899],{"class":675},[658,976,786],{"class":675},[658,978,979,981,983,985,987,989,991,993],{"class":660,"line":819},[658,980,943],{"class":675},[658,982,588],{"class":946},[658,984,899],{"class":675},[658,986,776],{"class":675},[658,988,918],{"class":675},[658,990,846],{"class":690},[658,992,899],{"class":675},[658,994,786],{"class":675},[658,996,997,999,1001,1003,1005,1007,1009],{"class":660,"line":836},[658,998,943],{"class":675},[658,1000,592],{"class":946},[658,1002,899],{"class":675},[658,1004,776],{"class":675},[658,1006,918],{"class":675},[658,1008,863],{"class":690},[658,1010,1011],{"class":675},"\"\n",[658,1013,1014],{"class":660,"line":853},[658,1015,1016],{"class":675},"  }\n",[658,1018,1019],{"class":660,"line":870},[658,1020,1021],{"class":675},"}\n",[637,1023,1025],{"id":1024},"error-fields","Error Fields",[1027,1028,1029,1045],"table",{},[1030,1031,1032],"thead",{},[1033,1034,1035,1039,1042],"tr",{},[1036,1037,1038],"th",{},"Field",[1036,1040,1041],{},"Required",[1036,1043,1044],{},"Description",[1046,1047,1048,1061,1076,1087,1098,1109,1120,1132],"tbody",{},[1033,1049,1050,1055,1058],{},[1051,1052,1053],"td",{},[539,1054,580],{},[1051,1056,1057],{},"Yes",[1051,1059,1060],{},"What happened (shown to users)",[1033,1062,1063,1067,1070],{},[1051,1064,1065],{},[539,1066,539],{},[1051,1068,1069],{},"No",[1051,1071,1072,1073,1075],{},"Stable machine-readable identifier for client branching (e.g. ",[539,1074,570],{},")",[1033,1077,1078,1082,1084],{},[1051,1079,1080],{},[539,1081,599],{},[1051,1083,1069],{},[1051,1085,1086],{},"HTTP status code (default: 500)",[1033,1088,1089,1093,1095],{},[1051,1090,1091],{},[539,1092,584],{},[1051,1094,1069],{},[1051,1096,1097],{},"Technical reason (for debugging)",[1033,1099,1100,1104,1106],{},[1051,1101,1102],{},[539,1103,588],{},[1051,1105,1069],{},[1051,1107,1108],{},"Actionable solution",[1033,1110,1111,1115,1117],{},[1051,1112,1113],{},[539,1114,592],{},[1051,1116,1069],{},[1051,1118,1119],{},"Documentation URL",[1033,1121,1122,1127,1129],{},[1051,1123,1124],{},[539,1125,1126],{},"cause",[1051,1128,1069],{},[1051,1130,1131],{},"Original error (for error chaining)",[1033,1133,1134,1139,1141],{},[1051,1135,1136],{},[539,1137,1138],{},"internal",[1051,1140,1069],{},[1051,1142,1143],{},"Backend-only context (see below)",[637,1145,1147,1148,1075],{"id":1146},"backend-only-context-internal","Backend-only context (",[539,1149,1138],{},[535,1151,564,1152,1154,1155,1159,1160,1163],{},[539,1153,1138],{}," when you need extra fields for logs, drains, or support tools, but ",[1156,1157,1158],"strong",{},"must not"," expose them in API responses or to ",[539,1161,1162],{},"parseError()"," on the client.",[648,1165,1167],{"className":650,"code":1166,"language":653,"meta":654,"style":654},"throw createError({\n  message: 'Payment could not be completed',\n  status: 402,\n  why: 'Your card was declined',\n  fix: 'Try another payment method',\n  internal: {\n    correlationId: 'pay_8x2k',\n    processorCode: 'insufficient_funds',\n    rawIssuerResponse: '…', \u002F\u002F never sent to the client\n  },\n})\n",[539,1168,1169,1179,1194,1204,1219,1234,1243,1259,1275,1295,1300],{"__ignoreMap":654},[658,1170,1171,1173,1175,1177],{"class":660,"line":661},[658,1172,672],{"class":671},[658,1174,733],{"class":679},[658,1176,684],{"class":683},[658,1178,766],{"class":675},[658,1180,1181,1183,1185,1187,1190,1192],{"class":660,"line":668},[658,1182,792],{"class":772},[658,1184,776],{"class":675},[658,1186,742],{"class":675},[658,1188,1189],{"class":690},"Payment could not be completed",[658,1191,687],{"class":675},[658,1193,786],{"class":675},[658,1195,1196,1198,1200,1202],{"class":660,"line":757},[658,1197,808],{"class":772},[658,1199,776],{"class":675},[658,1201,814],{"class":813},[658,1203,786],{"class":675},[658,1205,1206,1208,1210,1212,1215,1217],{"class":660,"line":769},[658,1207,822],{"class":772},[658,1209,776],{"class":675},[658,1211,742],{"class":675},[658,1213,1214],{"class":690},"Your card was declined",[658,1216,687],{"class":675},[658,1218,786],{"class":675},[658,1220,1221,1223,1225,1227,1230,1232],{"class":660,"line":789},[658,1222,839],{"class":772},[658,1224,776],{"class":675},[658,1226,742],{"class":675},[658,1228,1229],{"class":690},"Try another payment method",[658,1231,687],{"class":675},[658,1233,786],{"class":675},[658,1235,1236,1239,1241],{"class":660,"line":805},[658,1237,1238],{"class":772},"  internal",[658,1240,776],{"class":675},[658,1242,938],{"class":675},[658,1244,1245,1248,1250,1252,1255,1257],{"class":660,"line":819},[658,1246,1247],{"class":772},"    correlationId",[658,1249,776],{"class":675},[658,1251,742],{"class":675},[658,1253,1254],{"class":690},"pay_8x2k",[658,1256,687],{"class":675},[658,1258,786],{"class":675},[658,1260,1261,1264,1266,1268,1271,1273],{"class":660,"line":836},[658,1262,1263],{"class":772},"    processorCode",[658,1265,776],{"class":675},[658,1267,742],{"class":675},[658,1269,1270],{"class":690},"insufficient_funds",[658,1272,687],{"class":675},[658,1274,786],{"class":675},[658,1276,1277,1280,1282,1284,1287,1289,1292],{"class":660,"line":853},[658,1278,1279],{"class":772},"    rawIssuerResponse",[658,1281,776],{"class":675},[658,1283,742],{"class":675},[658,1285,1286],{"class":690},"…",[658,1288,687],{"class":675},[658,1290,1291],{"class":675},",",[658,1293,1294],{"class":664}," \u002F\u002F never sent to the client\n",[658,1296,1297],{"class":660,"line":870},[658,1298,1299],{"class":675},"  },\n",[658,1301,1303,1305],{"class":660,"line":1302},11,[658,1304,873],{"class":675},[658,1306,696],{"class":683},[552,1308,1309,1323,1337],{},[555,1310,1311,1314,1315,1320,1321,711],{},[1156,1312,1313],{},"HTTP responses"," (Nuxt\u002FNitro error handler, Next.js, SvelteKit, etc.) and ",[1156,1316,1317],{},[539,1318,1319],{},"toJSON()"," omit ",[539,1322,1138],{},[555,1324,1325,1329,1330,1332,1333,1336],{},[1156,1326,1327],{},[539,1328,1162],{}," does not surface ",[539,1331,1138],{}," for UI; the thrown error may still carry it server-side on ",[539,1334,1335],{},"raw"," when debugging.",[555,1338,1339,1342,1343,1346,1347,1350,1351,711],{},[1156,1340,1341],{},"Wide events",": when the framework records the error (e.g. ",[539,1344,1345],{},"log.error(err)"," or automatic capture on thrown ",[539,1348,1349],{},"EvlogError","), the emitted payload includes ",[539,1352,1353],{},"error.internal",[535,1355,1356,1357,711],{},"In debuggers, the payload may appear under a symbol key; in code, always use ",[1156,1358,1359],{},[539,1360,1353],{},[637,1362,1364],{"id":1363},"basic-usage","Basic Usage",[1366,1367,1369],"h3",{"id":1368},"simple-error","Simple Error",[716,1371,1372,1442],{},[648,1373,1376],{"className":650,"code":1374,"filename":1375,"language":653,"meta":654,"style":654},"import { createError } from 'evlog'\n\nthrow createError({\n  message: 'User not found',\n  status: 404,\n})\n","server\u002Fapi\u002Fusers\u002F[id].get.ts",[539,1377,1378,1396,1400,1410,1425,1436],{"__ignoreMap":654},[658,1379,1380,1382,1384,1386,1388,1390,1392,1394],{"class":660,"line":661},[658,1381,727],{"class":671},[658,1383,730],{"class":675},[658,1385,733],{"class":683},[658,1387,736],{"class":675},[658,1389,739],{"class":671},[658,1391,742],{"class":675},[658,1393,745],{"class":690},[658,1395,748],{"class":675},[658,1397,1398],{"class":660,"line":668},[658,1399,754],{"emptyLinePlaceholder":753},[658,1401,1402,1404,1406,1408],{"class":660,"line":757},[658,1403,672],{"class":671},[658,1405,733],{"class":679},[658,1407,684],{"class":683},[658,1409,766],{"class":675},[658,1411,1412,1414,1416,1418,1421,1423],{"class":660,"line":769},[658,1413,792],{"class":772},[658,1415,776],{"class":675},[658,1417,742],{"class":675},[658,1419,1420],{"class":690},"User not found",[658,1422,687],{"class":675},[658,1424,786],{"class":675},[658,1426,1427,1429,1431,1434],{"class":660,"line":789},[658,1428,808],{"class":772},[658,1430,776],{"class":675},[658,1432,1433],{"class":813}," 404",[658,1435,786],{"class":675},[658,1437,1438,1440],{"class":660,"line":805},[658,1439,873],{"class":675},[658,1441,696],{"class":683},[648,1443,1445],{"className":878,"code":1444,"filename":880,"language":881,"meta":654,"style":654},"{\n  \"statusCode\": 404,\n  \"message\": \"User not found\"\n}\n",[539,1446,1447,1451,1465,1481],{"__ignoreMap":654},[658,1448,1449],{"class":660,"line":661},[658,1450,766],{"class":675},[658,1452,1453,1455,1457,1459,1461,1463],{"class":660,"line":668},[658,1454,892],{"class":675},[658,1456,896],{"class":895},[658,1458,899],{"class":675},[658,1460,776],{"class":675},[658,1462,1433],{"class":813},[658,1464,786],{"class":675},[658,1466,1467,1469,1471,1473,1475,1477,1479],{"class":660,"line":757},[658,1468,892],{"class":675},[658,1470,580],{"class":895},[658,1472,899],{"class":675},[658,1474,776],{"class":675},[658,1476,918],{"class":675},[658,1478,1420],{"class":690},[658,1480,1011],{"class":675},[658,1482,1483],{"class":660,"line":769},[658,1484,1021],{"class":675},[1366,1486,1488],{"id":1487},"error-with-full-context","Error with Full Context",[716,1490,1491,1616],{},[648,1492,1494],{"className":650,"code":1493,"filename":652,"language":653,"meta":654,"style":654},"import { createError } from 'evlog'\n\nthrow createError({\n  code: 'PAYMENT_DECLINED',\n  message: 'Payment failed',\n  status: 402,\n  why: 'Card declined by issuer',\n  fix: 'Try a different payment method',\n  link: 'https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined',\n})\n",[539,1495,1496,1514,1518,1528,1542,1556,1566,1581,1596,1610],{"__ignoreMap":654},[658,1497,1498,1500,1502,1504,1506,1508,1510,1512],{"class":660,"line":661},[658,1499,727],{"class":671},[658,1501,730],{"class":675},[658,1503,733],{"class":683},[658,1505,736],{"class":675},[658,1507,739],{"class":671},[658,1509,742],{"class":675},[658,1511,745],{"class":690},[658,1513,748],{"class":675},[658,1515,1516],{"class":660,"line":668},[658,1517,754],{"emptyLinePlaceholder":753},[658,1519,1520,1522,1524,1526],{"class":660,"line":757},[658,1521,672],{"class":671},[658,1523,733],{"class":679},[658,1525,684],{"class":683},[658,1527,766],{"class":675},[658,1529,1530,1532,1534,1536,1538,1540],{"class":660,"line":769},[658,1531,773],{"class":772},[658,1533,776],{"class":675},[658,1535,742],{"class":675},[658,1537,781],{"class":690},[658,1539,687],{"class":675},[658,1541,786],{"class":675},[658,1543,1544,1546,1548,1550,1552,1554],{"class":660,"line":789},[658,1545,792],{"class":772},[658,1547,776],{"class":675},[658,1549,742],{"class":675},[658,1551,691],{"class":690},[658,1553,687],{"class":675},[658,1555,786],{"class":675},[658,1557,1558,1560,1562,1564],{"class":660,"line":805},[658,1559,808],{"class":772},[658,1561,776],{"class":675},[658,1563,814],{"class":813},[658,1565,786],{"class":675},[658,1567,1568,1570,1572,1574,1577,1579],{"class":660,"line":819},[658,1569,822],{"class":772},[658,1571,776],{"class":675},[658,1573,742],{"class":675},[658,1575,1576],{"class":690},"Card declined by issuer",[658,1578,687],{"class":675},[658,1580,786],{"class":675},[658,1582,1583,1585,1587,1589,1592,1594],{"class":660,"line":836},[658,1584,839],{"class":772},[658,1586,776],{"class":675},[658,1588,742],{"class":675},[658,1590,1591],{"class":690},"Try a different payment method",[658,1593,687],{"class":675},[658,1595,786],{"class":675},[658,1597,1598,1600,1602,1604,1606,1608],{"class":660,"line":853},[658,1599,856],{"class":772},[658,1601,776],{"class":675},[658,1603,742],{"class":675},[658,1605,863],{"class":690},[658,1607,687],{"class":675},[658,1609,786],{"class":675},[658,1611,1612,1614],{"class":660,"line":870},[658,1613,873],{"class":675},[658,1615,696],{"class":683},[648,1617,1619],{"className":878,"code":1618,"filename":880,"language":881,"meta":654,"style":654},"{\n  \"statusCode\": 402,\n  \"message\": \"Payment failed\",\n  \"data\": {\n    \"code\": \"PAYMENT_DECLINED\",\n    \"why\": \"Card declined by issuer\",\n    \"fix\": \"Try a different payment method\",\n    \"link\": \"https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined\"\n  }\n}\n",[539,1620,1621,1625,1639,1657,1669,1687,1705,1723,1739,1743],{"__ignoreMap":654},[658,1622,1623],{"class":660,"line":661},[658,1624,766],{"class":675},[658,1626,1627,1629,1631,1633,1635,1637],{"class":660,"line":668},[658,1628,892],{"class":675},[658,1630,896],{"class":895},[658,1632,899],{"class":675},[658,1634,776],{"class":675},[658,1636,814],{"class":813},[658,1638,786],{"class":675},[658,1640,1641,1643,1645,1647,1649,1651,1653,1655],{"class":660,"line":757},[658,1642,892],{"class":675},[658,1644,580],{"class":895},[658,1646,899],{"class":675},[658,1648,776],{"class":675},[658,1650,918],{"class":675},[658,1652,691],{"class":690},[658,1654,899],{"class":675},[658,1656,786],{"class":675},[658,1658,1659,1661,1663,1665,1667],{"class":660,"line":769},[658,1660,892],{"class":675},[658,1662,931],{"class":895},[658,1664,899],{"class":675},[658,1666,776],{"class":675},[658,1668,938],{"class":675},[658,1670,1671,1673,1675,1677,1679,1681,1683,1685],{"class":660,"line":789},[658,1672,943],{"class":675},[658,1674,539],{"class":946},[658,1676,899],{"class":675},[658,1678,776],{"class":675},[658,1680,918],{"class":675},[658,1682,781],{"class":690},[658,1684,899],{"class":675},[658,1686,786],{"class":675},[658,1688,1689,1691,1693,1695,1697,1699,1701,1703],{"class":660,"line":805},[658,1690,943],{"class":675},[658,1692,584],{"class":946},[658,1694,899],{"class":675},[658,1696,776],{"class":675},[658,1698,918],{"class":675},[658,1700,1576],{"class":690},[658,1702,899],{"class":675},[658,1704,786],{"class":675},[658,1706,1707,1709,1711,1713,1715,1717,1719,1721],{"class":660,"line":819},[658,1708,943],{"class":675},[658,1710,588],{"class":946},[658,1712,899],{"class":675},[658,1714,776],{"class":675},[658,1716,918],{"class":675},[658,1718,1591],{"class":690},[658,1720,899],{"class":675},[658,1722,786],{"class":675},[658,1724,1725,1727,1729,1731,1733,1735,1737],{"class":660,"line":836},[658,1726,943],{"class":675},[658,1728,592],{"class":946},[658,1730,899],{"class":675},[658,1732,776],{"class":675},[658,1734,918],{"class":675},[658,1736,863],{"class":690},[658,1738,1011],{"class":675},[658,1740,1741],{"class":660,"line":853},[658,1742,1016],{"class":675},[658,1744,1745],{"class":660,"line":870},[658,1746,1021],{"class":675},[1366,1748,1750],{"id":1749},"error-chaining","Error Chaining",[535,1752,1753],{},"Wrap underlying errors while preserving the original:",[648,1755,1757],{"className":650,"code":1756,"filename":652,"language":653,"meta":654,"style":654},"import { createError } from 'evlog'\n\ntry {\n  await stripe.charges.create(charge)\n} catch (err) {\n  throw createError({\n    message: 'Payment processing failed',\n    status: 500,\n    why: 'Stripe API returned an error',\n    cause: err, \u002F\u002F Original error preserved\n  })\n}\n",[539,1758,1759,1777,1781,1788,1813,1825,1836,1852,1864,1880,1895,1902],{"__ignoreMap":654},[658,1760,1761,1763,1765,1767,1769,1771,1773,1775],{"class":660,"line":661},[658,1762,727],{"class":671},[658,1764,730],{"class":675},[658,1766,733],{"class":683},[658,1768,736],{"class":675},[658,1770,739],{"class":671},[658,1772,742],{"class":675},[658,1774,745],{"class":690},[658,1776,748],{"class":675},[658,1778,1779],{"class":660,"line":668},[658,1780,754],{"emptyLinePlaceholder":753},[658,1782,1783,1786],{"class":660,"line":757},[658,1784,1785],{"class":671},"try",[658,1787,938],{"class":675},[658,1789,1790,1793,1796,1798,1801,1803,1806,1808,1811],{"class":660,"line":769},[658,1791,1792],{"class":671},"  await",[658,1794,1795],{"class":683}," stripe",[658,1797,711],{"class":675},[658,1799,1800],{"class":683},"charges",[658,1802,711],{"class":675},[658,1804,1805],{"class":679},"create",[658,1807,684],{"class":772},[658,1809,1810],{"class":683},"charge",[658,1812,696],{"class":772},[658,1814,1815,1817,1820,1823],{"class":660,"line":789},[658,1816,873],{"class":675},[658,1818,1819],{"class":671}," catch",[658,1821,1822],{"class":683}," (err) ",[658,1824,766],{"class":675},[658,1826,1827,1830,1832,1834],{"class":660,"line":805},[658,1828,1829],{"class":671},"  throw",[658,1831,733],{"class":679},[658,1833,684],{"class":772},[658,1835,766],{"class":675},[658,1837,1838,1841,1843,1845,1848,1850],{"class":660,"line":819},[658,1839,1840],{"class":772},"    message",[658,1842,776],{"class":675},[658,1844,742],{"class":675},[658,1846,1847],{"class":690},"Payment processing failed",[658,1849,687],{"class":675},[658,1851,786],{"class":675},[658,1853,1854,1857,1859,1862],{"class":660,"line":836},[658,1855,1856],{"class":772},"    status",[658,1858,776],{"class":675},[658,1860,1861],{"class":813}," 500",[658,1863,786],{"class":675},[658,1865,1866,1869,1871,1873,1876,1878],{"class":660,"line":853},[658,1867,1868],{"class":772},"    why",[658,1870,776],{"class":675},[658,1872,742],{"class":675},[658,1874,1875],{"class":690},"Stripe API returned an error",[658,1877,687],{"class":675},[658,1879,786],{"class":675},[658,1881,1882,1885,1887,1890,1892],{"class":660,"line":870},[658,1883,1884],{"class":772},"    cause",[658,1886,776],{"class":675},[658,1888,1889],{"class":683}," err",[658,1891,1291],{"class":675},[658,1893,1894],{"class":664}," \u002F\u002F Original error preserved\n",[658,1896,1897,1900],{"class":660,"line":1302},[658,1898,1899],{"class":675},"  }",[658,1901,696],{"class":772},[658,1903,1905],{"class":660,"line":1904},12,[658,1906,1021],{"class":675},[637,1908,1910],{"id":1909},"development-terminal-output","Development terminal output",[535,1912,1913,1914,1917,1918,1924,1925,571,1928,1931,1932,571,1934,571,1936,1938],{},"In development with ",[539,1915,1916],{},"pretty: true"," (the default), evlog prints failed requests as a wide event in the terminal. The ",[1156,1919,1920,1923],{},[539,1921,1922],{},"error"," block comes first",", then request context (",[539,1926,1927],{},"user",[539,1929,1930],{},"cart",", …). Structured fields (",[539,1933,584],{},[539,1935,588],{},[539,1937,592],{},") appear under the error message with a source location and optional code snippet.",[716,1940,1941,2067],{},[648,1942,1944],{"className":650,"code":1943,"filename":652,"language":653,"meta":654,"style":654},"import { createError } from 'evlog'\n\nthrow createError({\n  code: 'PAYMENT_DECLINED',\n  message: 'Card declined',\n  status: 402,\n  why: 'Issuer declined the charge',\n  fix: 'Ask the customer to use another card',\n  link: 'https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined',\n})\n",[539,1945,1946,1964,1968,1978,1992,2007,2017,2032,2047,2061],{"__ignoreMap":654},[658,1947,1948,1950,1952,1954,1956,1958,1960,1962],{"class":660,"line":661},[658,1949,727],{"class":671},[658,1951,730],{"class":675},[658,1953,733],{"class":683},[658,1955,736],{"class":675},[658,1957,739],{"class":671},[658,1959,742],{"class":675},[658,1961,745],{"class":690},[658,1963,748],{"class":675},[658,1965,1966],{"class":660,"line":668},[658,1967,754],{"emptyLinePlaceholder":753},[658,1969,1970,1972,1974,1976],{"class":660,"line":757},[658,1971,672],{"class":671},[658,1973,733],{"class":679},[658,1975,684],{"class":683},[658,1977,766],{"class":675},[658,1979,1980,1982,1984,1986,1988,1990],{"class":660,"line":769},[658,1981,773],{"class":772},[658,1983,776],{"class":675},[658,1985,742],{"class":675},[658,1987,781],{"class":690},[658,1989,687],{"class":675},[658,1991,786],{"class":675},[658,1993,1994,1996,1998,2000,2003,2005],{"class":660,"line":789},[658,1995,792],{"class":772},[658,1997,776],{"class":675},[658,1999,742],{"class":675},[658,2001,2002],{"class":690},"Card declined",[658,2004,687],{"class":675},[658,2006,786],{"class":675},[658,2008,2009,2011,2013,2015],{"class":660,"line":805},[658,2010,808],{"class":772},[658,2012,776],{"class":675},[658,2014,814],{"class":813},[658,2016,786],{"class":675},[658,2018,2019,2021,2023,2025,2028,2030],{"class":660,"line":819},[658,2020,822],{"class":772},[658,2022,776],{"class":675},[658,2024,742],{"class":675},[658,2026,2027],{"class":690},"Issuer declined the charge",[658,2029,687],{"class":675},[658,2031,786],{"class":675},[658,2033,2034,2036,2038,2040,2043,2045],{"class":660,"line":836},[658,2035,839],{"class":772},[658,2037,776],{"class":675},[658,2039,742],{"class":675},[658,2041,2042],{"class":690},"Ask the customer to use another card",[658,2044,687],{"class":675},[658,2046,786],{"class":675},[658,2048,2049,2051,2053,2055,2057,2059],{"class":660,"line":853},[658,2050,856],{"class":772},[658,2052,776],{"class":675},[658,2054,742],{"class":675},[658,2056,863],{"class":690},[658,2058,687],{"class":675},[658,2060,786],{"class":675},[658,2062,2063,2065],{"class":660,"line":870},[658,2064,873],{"class":675},[658,2066,696],{"class":683},[648,2068,2073],{"className":2069,"code":2070,"filename":2071,"language":2072,"meta":654,"style":654},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","ERROR [checkout] POST \u002Fapi\u002Fcheckout 402 in 123ms\n  ├─ error: Card declined\n  │     at server\u002Fapi\u002Fcheckout.post.ts:42\n  │   ❯ 42 ┃ throw createError({ code: 'PAYMENT_DECLINED', ... })\n  │     Why: Issuer declined the charge\n  │     Fix: Ask the customer to use another card\n  │     More: https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined\n  │     stack (3 frames hidden in node_modules)\n  ├─ user: id=1 plan=pro\n  └─ cart: items=3 total=9999\n","Terminal (pretty dev)","bash",[539,2074,2075,2083,2097,2108,2131,2150,2177,2187,2211,2227],{"__ignoreMap":654},[658,2076,2077,2080],{"class":660,"line":661},[658,2078,2079],{"class":946},"ERROR",[658,2081,2082],{"class":683}," [checkout] POST \u002Fapi\u002Fcheckout 402 in 123ms\n",[658,2084,2085,2088,2091,2094],{"class":660,"line":668},[658,2086,2087],{"class":946},"  ├─",[658,2089,2090],{"class":690}," error:",[658,2092,2093],{"class":690}," Card",[658,2095,2096],{"class":690}," declined\n",[658,2098,2099,2102,2105],{"class":660,"line":757},[658,2100,2101],{"class":946},"  │",[658,2103,2104],{"class":690},"     at",[658,2106,2107],{"class":690}," server\u002Fapi\u002Fcheckout.post.ts:42\n",[658,2109,2110,2112,2115,2118,2121,2124,2126,2128],{"class":660,"line":769},[658,2111,2101],{"class":946},[658,2113,2114],{"class":690},"   ❯",[658,2116,2117],{"class":813}," 42",[658,2119,2120],{"class":690}," ┃",[658,2122,2123],{"class":690}," throw",[658,2125,733],{"class":690},[658,2127,684],{"class":675},[658,2129,2130],{"class":683},"{ code: 'PAYMENT_DECLINED', ... })\n",[658,2132,2133,2135,2138,2141,2144,2147],{"class":660,"line":789},[658,2134,2101],{"class":946},[658,2136,2137],{"class":690},"     Why:",[658,2139,2140],{"class":690}," Issuer",[658,2142,2143],{"class":690}," declined",[658,2145,2146],{"class":690}," the",[658,2148,2149],{"class":690}," charge\n",[658,2151,2152,2154,2157,2160,2162,2165,2168,2171,2174],{"class":660,"line":805},[658,2153,2101],{"class":946},[658,2155,2156],{"class":690},"     Fix:",[658,2158,2159],{"class":690}," Ask",[658,2161,2146],{"class":690},[658,2163,2164],{"class":690}," customer",[658,2166,2167],{"class":690}," to",[658,2169,2170],{"class":690}," use",[658,2172,2173],{"class":690}," another",[658,2175,2176],{"class":690}," card\n",[658,2178,2179,2181,2184],{"class":660,"line":819},[658,2180,2101],{"class":946},[658,2182,2183],{"class":690},"     More:",[658,2185,2186],{"class":690}," https:\u002F\u002Fdocs.example.com\u002Fpayments\u002Fdeclined\n",[658,2188,2189,2191,2194,2197,2200,2203,2206,2209],{"class":660,"line":836},[658,2190,2101],{"class":946},[658,2192,2193],{"class":690},"     stack",[658,2195,2196],{"class":683}," (3 ",[658,2198,2199],{"class":690},"frames",[658,2201,2202],{"class":690}," hidden",[658,2204,2205],{"class":690}," in",[658,2207,2208],{"class":690}," node_modules",[658,2210,696],{"class":675},[658,2212,2213,2215,2218,2221,2224],{"class":660,"line":853},[658,2214,2087],{"class":946},[658,2216,2217],{"class":690}," user:",[658,2219,2220],{"class":690}," id=",[658,2222,2223],{"class":813},"1",[658,2225,2226],{"class":690}," plan=pro\n",[658,2228,2229,2232,2235,2238,2241,2244],{"class":660,"line":870},[658,2230,2231],{"class":946},"  └─",[658,2233,2234],{"class":690}," cart:",[658,2236,2237],{"class":690}," items=",[658,2239,2240],{"class":813},"3",[658,2242,2243],{"class":690}," total=",[658,2245,2246],{"class":813},"9999\n",[535,2248,2249],{},"Colors and tree connectors render in the terminal; the example above omits ANSI for readability.",[1366,2251,2253],{"id":2252},"choosing-evlog-vs-nitro-console-output","Choosing evlog vs Nitro console output",[1027,2255,2256,2266],{},[1030,2257,2258],{},[1033,2259,2260,2263],{},[1036,2261,2262],{},"Goal",[1036,2264,2265],{},"Config",[1046,2267,2268,2283,2293,2307],{},[1033,2269,2270,2277],{},[1051,2271,2272,2273,2276],{},"One clean signal — wide event only, no Nitro ",[539,2274,2275],{},"[request error]"," overlay",[1051,2278,2279,2282],{},[539,2280,2281],{},"dev: 'evlog'"," (default in pretty dev)",[1033,2284,2285,2288],{},[1051,2286,2287],{},"Wide event context + Nitro's native Youch stack (evlog prints Why\u002FFix only)",[1051,2289,2290],{},[539,2291,2292],{},"dev: 'nitro'",[1033,2294,2295,2302],{},[1051,2296,2297,2298,2301],{},"Full evlog block ",[1156,2299,2300],{},"and"," Nitro overlay (debug)",[1051,2303,2304],{},[539,2305,2306],{},"dev: 'both'",[1033,2308,2309,2312],{},[1051,2310,2311],{},"No pretty tree (JSON logs) but still suppress Nitro overlay",[1051,2313,2314,571,2317],{},[539,2315,2316],{},"pretty: false",[539,2318,2319],{},"dev: { frameworkOverlay: false }",[535,2321,2322,2323,2326,2327,571,2330,571,2333,571,2336,2339,2340,623,2342,711],{},"Fine-grained control lives under ",[539,2324,2325],{},"dev.prettyError"," (",[539,2328,2329],{},"snippet",[539,2331,2332],{},"stackDepth",[539,2334,2335],{},"compact",[539,2337,2338],{},"detail: 'full' | 'guidance'","). See ",[631,2341,504],{"href":505},[631,2343,2344],{"href":231},"Nuxt integration",[637,2346,2348,2349],{"id":2347},"branching-on-code","Branching on ",[539,2350,539],{},[535,2352,2353,2355,2356,2358],{},[539,2354,539],{}," is a stable, machine-readable identifier you control. Pair it with ",[539,2357,1162],{}," so the client can branch on logic without parsing user-facing messages or coupling to HTTP status codes.",[2360,2361],"structured-error-branching",{},[648,2363,2366],{"className":650,"code":2364,"filename":2365,"language":653,"meta":654,"style":654},"import { parseError } from 'evlog'\n\ntry {\n  await $fetch('\u002Fapi\u002Fcheckout', { method: 'POST', body: cart })\n} catch (err) {\n  const error = parseError(err)\n\n  switch (error.code) {\n    case 'PAYMENT_DECLINED':\n      return showRetryWithDifferentCard()\n    case 'CART_EXPIRED':\n      return rebuildCart()\n    default:\n      return toast.add({ title: error.message, color: 'error' })\n  }\n}\n","composables\u002FuseCheckout.ts",[539,2367,2368,2387,2391,2397,2443,2453,2473,2477,2495,2509,2520,2533,2542,2550,2596,2601],{"__ignoreMap":654},[658,2369,2370,2372,2374,2377,2379,2381,2383,2385],{"class":660,"line":661},[658,2371,727],{"class":671},[658,2373,730],{"class":675},[658,2375,2376],{"class":683}," parseError",[658,2378,736],{"class":675},[658,2380,739],{"class":671},[658,2382,742],{"class":675},[658,2384,745],{"class":690},[658,2386,748],{"class":675},[658,2388,2389],{"class":660,"line":668},[658,2390,754],{"emptyLinePlaceholder":753},[658,2392,2393,2395],{"class":660,"line":757},[658,2394,1785],{"class":671},[658,2396,938],{"class":675},[658,2398,2399,2401,2404,2406,2408,2411,2413,2415,2417,2420,2422,2424,2427,2429,2431,2434,2436,2439,2441],{"class":660,"line":769},[658,2400,1792],{"class":671},[658,2402,2403],{"class":679}," $fetch",[658,2405,684],{"class":772},[658,2407,687],{"class":675},[658,2409,2410],{"class":690},"\u002Fapi\u002Fcheckout",[658,2412,687],{"class":675},[658,2414,1291],{"class":675},[658,2416,730],{"class":675},[658,2418,2419],{"class":772}," method",[658,2421,776],{"class":675},[658,2423,742],{"class":675},[658,2425,2426],{"class":690},"POST",[658,2428,687],{"class":675},[658,2430,1291],{"class":675},[658,2432,2433],{"class":772}," body",[658,2435,776],{"class":675},[658,2437,2438],{"class":683}," cart",[658,2440,736],{"class":675},[658,2442,696],{"class":772},[658,2444,2445,2447,2449,2451],{"class":660,"line":789},[658,2446,873],{"class":675},[658,2448,1819],{"class":671},[658,2450,1822],{"class":683},[658,2452,766],{"class":675},[658,2454,2455,2458,2461,2464,2466,2468,2471],{"class":660,"line":805},[658,2456,2457],{"class":895},"  const",[658,2459,2460],{"class":683}," error",[658,2462,2463],{"class":675}," =",[658,2465,2376],{"class":679},[658,2467,684],{"class":772},[658,2469,2470],{"class":683},"err",[658,2472,696],{"class":772},[658,2474,2475],{"class":660,"line":819},[658,2476,754],{"emptyLinePlaceholder":753},[658,2478,2479,2482,2484,2486,2488,2490,2493],{"class":660,"line":836},[658,2480,2481],{"class":671},"  switch",[658,2483,2326],{"class":772},[658,2485,1922],{"class":683},[658,2487,711],{"class":675},[658,2489,539],{"class":683},[658,2491,2492],{"class":772},") ",[658,2494,766],{"class":675},[658,2496,2497,2500,2502,2504,2506],{"class":660,"line":853},[658,2498,2499],{"class":671},"    case",[658,2501,742],{"class":675},[658,2503,781],{"class":690},[658,2505,687],{"class":675},[658,2507,2508],{"class":675},":\n",[658,2510,2511,2514,2517],{"class":660,"line":870},[658,2512,2513],{"class":671},"      return",[658,2515,2516],{"class":679}," showRetryWithDifferentCard",[658,2518,2519],{"class":772},"()\n",[658,2521,2522,2524,2526,2529,2531],{"class":660,"line":1302},[658,2523,2499],{"class":671},[658,2525,742],{"class":675},[658,2527,2528],{"class":690},"CART_EXPIRED",[658,2530,687],{"class":675},[658,2532,2508],{"class":675},[658,2534,2535,2537,2540],{"class":660,"line":1904},[658,2536,2513],{"class":671},[658,2538,2539],{"class":679}," rebuildCart",[658,2541,2519],{"class":772},[658,2543,2545,2548],{"class":660,"line":2544},13,[658,2546,2547],{"class":671},"    default",[658,2549,2508],{"class":675},[658,2551,2553,2555,2558,2560,2563,2565,2568,2571,2573,2575,2577,2579,2581,2584,2586,2588,2590,2592,2594],{"class":660,"line":2552},14,[658,2554,2513],{"class":671},[658,2556,2557],{"class":683}," toast",[658,2559,711],{"class":675},[658,2561,2562],{"class":679},"add",[658,2564,684],{"class":772},[658,2566,2567],{"class":675},"{",[658,2569,2570],{"class":772}," title",[658,2572,776],{"class":675},[658,2574,2460],{"class":683},[658,2576,711],{"class":675},[658,2578,580],{"class":683},[658,2580,1291],{"class":675},[658,2582,2583],{"class":772}," color",[658,2585,776],{"class":675},[658,2587,742],{"class":675},[658,2589,1922],{"class":690},[658,2591,687],{"class":675},[658,2593,736],{"class":675},[658,2595,696],{"class":772},[658,2597,2599],{"class":660,"line":2598},15,[658,2600,1016],{"class":675},[658,2602,2604],{"class":660,"line":2603},16,[658,2605,1021],{"class":675},[535,2607,2608,2610,2611,2613,2614,571,2617,2620,2621,2624,2625,2628],{},[539,2609,1162],{}," also surfaces ",[539,2612,539],{}," from Node-style errors (e.g. ",[539,2615,2616],{},"'ENOENT'",[539,2618,2619],{},"'ECONNRESET'",") and any ",[539,2622,2623],{},"Error"," instance with a string ",[539,2626,2627],{},".code"," property, so existing system errors flow through the same branch.",[535,2630,2631,2633,2634,2637],{},[539,2632,539],{}," is also copied onto wide events under ",[539,2635,2636],{},"error.code",", so dashboards and drains can group, alert, and chart by code without parsing free-text messages.",[637,2639,2641],{"id":2640},"frontend-error-handling","Frontend Error Handling",[535,2643,564,2644,2646],{},[539,2645,1162],{}," to extract all fields from caught errors:",[716,2648,2649,2867],{},[648,2650,2652],{"className":650,"code":2651,"filename":2365,"language":653,"meta":654,"style":654},"import { parseError } from 'evlog'\n\ntry {\n  await $fetch('\u002Fapi\u002Fcheckout', { method: 'POST', body: cart })\n} catch (err) {\n  const error = parseError(err)\n\n  console.log(error.message)  \u002F\u002F \"Payment failed\"\n  console.log(error.status)   \u002F\u002F 402\n  console.log(error.code)     \u002F\u002F \"PAYMENT_DECLINED\"\n  console.log(error.why)      \u002F\u002F \"Card declined\"\n  console.log(error.fix)      \u002F\u002F \"Try another card\"\n}\n",[539,2653,2654,2672,2676,2682,2722,2732,2748,2752,2776,2798,2820,2842,2863],{"__ignoreMap":654},[658,2655,2656,2658,2660,2662,2664,2666,2668,2670],{"class":660,"line":661},[658,2657,727],{"class":671},[658,2659,730],{"class":675},[658,2661,2376],{"class":683},[658,2663,736],{"class":675},[658,2665,739],{"class":671},[658,2667,742],{"class":675},[658,2669,745],{"class":690},[658,2671,748],{"class":675},[658,2673,2674],{"class":660,"line":668},[658,2675,754],{"emptyLinePlaceholder":753},[658,2677,2678,2680],{"class":660,"line":757},[658,2679,1785],{"class":671},[658,2681,938],{"class":675},[658,2683,2684,2686,2688,2690,2692,2694,2696,2698,2700,2702,2704,2706,2708,2710,2712,2714,2716,2718,2720],{"class":660,"line":769},[658,2685,1792],{"class":671},[658,2687,2403],{"class":679},[658,2689,684],{"class":772},[658,2691,687],{"class":675},[658,2693,2410],{"class":690},[658,2695,687],{"class":675},[658,2697,1291],{"class":675},[658,2699,730],{"class":675},[658,2701,2419],{"class":772},[658,2703,776],{"class":675},[658,2705,742],{"class":675},[658,2707,2426],{"class":690},[658,2709,687],{"class":675},[658,2711,1291],{"class":675},[658,2713,2433],{"class":772},[658,2715,776],{"class":675},[658,2717,2438],{"class":683},[658,2719,736],{"class":675},[658,2721,696],{"class":772},[658,2723,2724,2726,2728,2730],{"class":660,"line":789},[658,2725,873],{"class":675},[658,2727,1819],{"class":671},[658,2729,1822],{"class":683},[658,2731,766],{"class":675},[658,2733,2734,2736,2738,2740,2742,2744,2746],{"class":660,"line":805},[658,2735,2457],{"class":895},[658,2737,2460],{"class":683},[658,2739,2463],{"class":675},[658,2741,2376],{"class":679},[658,2743,684],{"class":772},[658,2745,2470],{"class":683},[658,2747,696],{"class":772},[658,2749,2750],{"class":660,"line":819},[658,2751,754],{"emptyLinePlaceholder":753},[658,2753,2754,2757,2759,2762,2764,2766,2768,2770,2773],{"class":660,"line":836},[658,2755,2756],{"class":683},"  console",[658,2758,711],{"class":675},[658,2760,2761],{"class":679},"log",[658,2763,684],{"class":772},[658,2765,1922],{"class":683},[658,2767,711],{"class":675},[658,2769,580],{"class":683},[658,2771,2772],{"class":772},")  ",[658,2774,2775],{"class":664},"\u002F\u002F \"Payment failed\"\n",[658,2777,2778,2780,2782,2784,2786,2788,2790,2792,2795],{"class":660,"line":853},[658,2779,2756],{"class":683},[658,2781,711],{"class":675},[658,2783,2761],{"class":679},[658,2785,684],{"class":772},[658,2787,1922],{"class":683},[658,2789,711],{"class":675},[658,2791,599],{"class":683},[658,2793,2794],{"class":772},")   ",[658,2796,2797],{"class":664},"\u002F\u002F 402\n",[658,2799,2800,2802,2804,2806,2808,2810,2812,2814,2817],{"class":660,"line":870},[658,2801,2756],{"class":683},[658,2803,711],{"class":675},[658,2805,2761],{"class":679},[658,2807,684],{"class":772},[658,2809,1922],{"class":683},[658,2811,711],{"class":675},[658,2813,539],{"class":683},[658,2815,2816],{"class":772},")     ",[658,2818,2819],{"class":664},"\u002F\u002F \"PAYMENT_DECLINED\"\n",[658,2821,2822,2824,2826,2828,2830,2832,2834,2836,2839],{"class":660,"line":1302},[658,2823,2756],{"class":683},[658,2825,711],{"class":675},[658,2827,2761],{"class":679},[658,2829,684],{"class":772},[658,2831,1922],{"class":683},[658,2833,711],{"class":675},[658,2835,584],{"class":683},[658,2837,2838],{"class":772},")      ",[658,2840,2841],{"class":664},"\u002F\u002F \"Card declined\"\n",[658,2843,2844,2846,2848,2850,2852,2854,2856,2858,2860],{"class":660,"line":1904},[658,2845,2756],{"class":683},[658,2847,711],{"class":675},[658,2849,2761],{"class":679},[658,2851,684],{"class":772},[658,2853,1922],{"class":683},[658,2855,711],{"class":675},[658,2857,588],{"class":683},[658,2859,2838],{"class":772},[658,2861,2862],{"class":664},"\u002F\u002F \"Try another card\"\n",[658,2864,2865],{"class":660,"line":2544},[658,2866,1021],{"class":675},[648,2868,2871],{"className":650,"code":2869,"filename":2870,"language":653,"meta":654,"style":654},"import { parseError } from 'evlog'\n\nconst toast = useToast()\n\ntry {\n  await $fetch('\u002Fapi\u002Fcheckout', { method: 'POST', body: cart })\n} catch (err) {\n  const error = parseError(err)\n\n  toast.add({\n    title: error.message,\n    description: error.why,\n    color: 'error',\n    actions: error.link\n      ? [{ label: 'Learn more', onClick: () => window.open(error.link) }]\n      : undefined,\n  })\n}\n","composables\u002FuseCheckout.ts (Nuxt UI)",[539,2872,2873,2891,2895,2911,2915,2921,2961,2971,2987,2991,3004,3019,3034,3049,3063,3121,3129,3136],{"__ignoreMap":654},[658,2874,2875,2877,2879,2881,2883,2885,2887,2889],{"class":660,"line":661},[658,2876,727],{"class":671},[658,2878,730],{"class":675},[658,2880,2376],{"class":683},[658,2882,736],{"class":675},[658,2884,739],{"class":671},[658,2886,742],{"class":675},[658,2888,745],{"class":690},[658,2890,748],{"class":675},[658,2892,2893],{"class":660,"line":668},[658,2894,754],{"emptyLinePlaceholder":753},[658,2896,2897,2900,2903,2906,2909],{"class":660,"line":757},[658,2898,2899],{"class":895},"const",[658,2901,2902],{"class":683}," toast ",[658,2904,2905],{"class":675},"=",[658,2907,2908],{"class":679}," useToast",[658,2910,2519],{"class":683},[658,2912,2913],{"class":660,"line":769},[658,2914,754],{"emptyLinePlaceholder":753},[658,2916,2917,2919],{"class":660,"line":789},[658,2918,1785],{"class":671},[658,2920,938],{"class":675},[658,2922,2923,2925,2927,2929,2931,2933,2935,2937,2939,2941,2943,2945,2947,2949,2951,2953,2955,2957,2959],{"class":660,"line":805},[658,2924,1792],{"class":671},[658,2926,2403],{"class":679},[658,2928,684],{"class":772},[658,2930,687],{"class":675},[658,2932,2410],{"class":690},[658,2934,687],{"class":675},[658,2936,1291],{"class":675},[658,2938,730],{"class":675},[658,2940,2419],{"class":772},[658,2942,776],{"class":675},[658,2944,742],{"class":675},[658,2946,2426],{"class":690},[658,2948,687],{"class":675},[658,2950,1291],{"class":675},[658,2952,2433],{"class":772},[658,2954,776],{"class":675},[658,2956,2438],{"class":683},[658,2958,736],{"class":675},[658,2960,696],{"class":772},[658,2962,2963,2965,2967,2969],{"class":660,"line":819},[658,2964,873],{"class":675},[658,2966,1819],{"class":671},[658,2968,1822],{"class":683},[658,2970,766],{"class":675},[658,2972,2973,2975,2977,2979,2981,2983,2985],{"class":660,"line":836},[658,2974,2457],{"class":895},[658,2976,2460],{"class":683},[658,2978,2463],{"class":675},[658,2980,2376],{"class":679},[658,2982,684],{"class":772},[658,2984,2470],{"class":683},[658,2986,696],{"class":772},[658,2988,2989],{"class":660,"line":853},[658,2990,754],{"emptyLinePlaceholder":753},[658,2992,2993,2996,2998,3000,3002],{"class":660,"line":870},[658,2994,2995],{"class":683},"  toast",[658,2997,711],{"class":675},[658,2999,2562],{"class":679},[658,3001,684],{"class":772},[658,3003,766],{"class":675},[658,3005,3006,3009,3011,3013,3015,3017],{"class":660,"line":1302},[658,3007,3008],{"class":772},"    title",[658,3010,776],{"class":675},[658,3012,2460],{"class":683},[658,3014,711],{"class":675},[658,3016,580],{"class":683},[658,3018,786],{"class":675},[658,3020,3021,3024,3026,3028,3030,3032],{"class":660,"line":1904},[658,3022,3023],{"class":772},"    description",[658,3025,776],{"class":675},[658,3027,2460],{"class":683},[658,3029,711],{"class":675},[658,3031,584],{"class":683},[658,3033,786],{"class":675},[658,3035,3036,3039,3041,3043,3045,3047],{"class":660,"line":2544},[658,3037,3038],{"class":772},"    color",[658,3040,776],{"class":675},[658,3042,742],{"class":675},[658,3044,1922],{"class":690},[658,3046,687],{"class":675},[658,3048,786],{"class":675},[658,3050,3051,3054,3056,3058,3060],{"class":660,"line":2552},[658,3052,3053],{"class":772},"    actions",[658,3055,776],{"class":675},[658,3057,2460],{"class":683},[658,3059,711],{"class":675},[658,3061,3062],{"class":683},"link\n",[658,3064,3065,3068,3071,3073,3076,3078,3080,3083,3085,3087,3090,3092,3095,3098,3101,3103,3106,3108,3110,3112,3114,3116,3118],{"class":660,"line":2598},[658,3066,3067],{"class":675},"      ?",[658,3069,3070],{"class":772}," [",[658,3072,2567],{"class":675},[658,3074,3075],{"class":772}," label",[658,3077,776],{"class":675},[658,3079,742],{"class":675},[658,3081,3082],{"class":690},"Learn more",[658,3084,687],{"class":675},[658,3086,1291],{"class":675},[658,3088,3089],{"class":679}," onClick",[658,3091,776],{"class":675},[658,3093,3094],{"class":675}," ()",[658,3096,3097],{"class":895}," =>",[658,3099,3100],{"class":683}," window",[658,3102,711],{"class":675},[658,3104,3105],{"class":679},"open",[658,3107,684],{"class":772},[658,3109,1922],{"class":683},[658,3111,711],{"class":675},[658,3113,592],{"class":683},[658,3115,2492],{"class":772},[658,3117,873],{"class":675},[658,3119,3120],{"class":772},"]\n",[658,3122,3123,3126],{"class":660,"line":2603},[658,3124,3125],{"class":675},"      :",[658,3127,3128],{"class":675}," undefined,\n",[658,3130,3132,3134],{"class":660,"line":3131},17,[658,3133,1899],{"class":675},[658,3135,696],{"class":772},[658,3137,3139],{"class":660,"line":3138},18,[658,3140,1021],{"class":675},[1366,3142,3144],{"id":3143},"error-display-component","Error Display Component",[535,3146,3147],{},"Create a reusable error display:",[648,3149,3154],{"className":3150,"code":3151,"filename":3152,"language":3153,"meta":654,"style":654},"language-vue shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cscript setup lang=\"ts\">\nimport { parseError } from 'evlog'\n\nconst { error } = defineProps\u003C{\n  error: unknown\n}>()\n\nconst parsed = computed(() => parseError(error))\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CUAlert\n    :title=\"parsed.message\"\n    :description=\"parsed.why\"\n    color=\"error\"\n    icon=\"i-lucide-alert-circle\"\n  >\n    \u003Ctemplate v-if=\"parsed.fix\" #description>\n      \u003Cp>{{ parsed.why }}\u003C\u002Fp>\n      \u003Cp class=\"mt-2 font-medium\">{{ parsed.fix }}\u003C\u002Fp>\n    \u003C\u002Ftemplate>\n  \u003C\u002FUAlert>\n\u003C\u002Ftemplate>\n","components\u002FErrorAlert.vue","vue",[539,3155,3156,3182,3200,3204,3223,3233,3240,3244,3268,3277,3281,3290,3298,3312,3326,3338,3352,3357,3388,3408,3438,3448,3459],{"__ignoreMap":654},[658,3157,3158,3161,3164,3167,3170,3172,3174,3177,3179],{"class":660,"line":661},[658,3159,3160],{"class":675},"\u003C",[658,3162,3163],{"class":772},"script",[658,3165,3166],{"class":895}," setup",[658,3168,3169],{"class":895}," lang",[658,3171,2905],{"class":675},[658,3173,899],{"class":675},[658,3175,3176],{"class":690},"ts",[658,3178,899],{"class":675},[658,3180,3181],{"class":675},">\n",[658,3183,3184,3186,3188,3190,3192,3194,3196,3198],{"class":660,"line":668},[658,3185,727],{"class":671},[658,3187,730],{"class":675},[658,3189,2376],{"class":683},[658,3191,736],{"class":675},[658,3193,739],{"class":671},[658,3195,742],{"class":675},[658,3197,745],{"class":690},[658,3199,748],{"class":675},[658,3201,3202],{"class":660,"line":757},[658,3203,754],{"emptyLinePlaceholder":753},[658,3205,3206,3208,3210,3213,3215,3217,3220],{"class":660,"line":769},[658,3207,2899],{"class":895},[658,3209,730],{"class":675},[658,3211,3212],{"class":683}," error ",[658,3214,873],{"class":675},[658,3216,2463],{"class":675},[658,3218,3219],{"class":679}," defineProps",[658,3221,3222],{"class":675},"\u003C{\n",[658,3224,3225,3228,3230],{"class":660,"line":789},[658,3226,3227],{"class":772},"  error",[658,3229,776],{"class":675},[658,3231,3232],{"class":946}," unknown\n",[658,3234,3235,3238],{"class":660,"line":805},[658,3236,3237],{"class":675},"}>",[658,3239,2519],{"class":683},[658,3241,3242],{"class":660,"line":819},[658,3243,754],{"emptyLinePlaceholder":753},[658,3245,3246,3248,3251,3253,3256,3258,3261,3263,3265],{"class":660,"line":836},[658,3247,2899],{"class":895},[658,3249,3250],{"class":683}," parsed ",[658,3252,2905],{"class":675},[658,3254,3255],{"class":679}," computed",[658,3257,684],{"class":683},[658,3259,3260],{"class":675},"()",[658,3262,3097],{"class":895},[658,3264,2376],{"class":679},[658,3266,3267],{"class":683},"(error))\n",[658,3269,3270,3273,3275],{"class":660,"line":853},[658,3271,3272],{"class":675},"\u003C\u002F",[658,3274,3163],{"class":772},[658,3276,3181],{"class":675},[658,3278,3279],{"class":660,"line":870},[658,3280,754],{"emptyLinePlaceholder":753},[658,3282,3283,3285,3288],{"class":660,"line":1302},[658,3284,3160],{"class":675},[658,3286,3287],{"class":772},"template",[658,3289,3181],{"class":675},[658,3291,3292,3295],{"class":660,"line":1904},[658,3293,3294],{"class":675},"  \u003C",[658,3296,3297],{"class":772},"UAlert\n",[658,3299,3300,3303,3305,3307,3310],{"class":660,"line":2544},[658,3301,3302],{"class":895},"    :title",[658,3304,2905],{"class":675},[658,3306,899],{"class":675},[658,3308,3309],{"class":690},"parsed.message",[658,3311,1011],{"class":675},[658,3313,3314,3317,3319,3321,3324],{"class":660,"line":2552},[658,3315,3316],{"class":895},"    :description",[658,3318,2905],{"class":675},[658,3320,899],{"class":675},[658,3322,3323],{"class":690},"parsed.why",[658,3325,1011],{"class":675},[658,3327,3328,3330,3332,3334,3336],{"class":660,"line":2598},[658,3329,3038],{"class":895},[658,3331,2905],{"class":675},[658,3333,899],{"class":675},[658,3335,1922],{"class":690},[658,3337,1011],{"class":675},[658,3339,3340,3343,3345,3347,3350],{"class":660,"line":2603},[658,3341,3342],{"class":895},"    icon",[658,3344,2905],{"class":675},[658,3346,899],{"class":675},[658,3348,3349],{"class":690},"i-lucide-alert-circle",[658,3351,1011],{"class":675},[658,3353,3354],{"class":660,"line":3131},[658,3355,3356],{"class":675},"  >\n",[658,3358,3359,3362,3364,3367,3369,3371,3374,3376,3378,3380,3383,3386],{"class":660,"line":3138},[658,3360,3361],{"class":675},"    \u003C",[658,3363,3287],{"class":772},[658,3365,3366],{"class":671}," v-if",[658,3368,2905],{"class":675},[658,3370,899],{"class":675},[658,3372,3373],{"class":683},"parsed",[658,3375,711],{"class":675},[658,3377,588],{"class":683},[658,3379,899],{"class":675},[658,3381,3382],{"class":675}," #",[658,3384,3385],{"class":895},"description",[658,3387,3181],{"class":675},[658,3389,3391,3394,3396,3399,3402,3404,3406],{"class":660,"line":3390},19,[658,3392,3393],{"class":675},"      \u003C",[658,3395,535],{"class":772},[658,3397,3398],{"class":675},">",[658,3400,3401],{"class":683},"{{ parsed.why }}",[658,3403,3272],{"class":675},[658,3405,535],{"class":772},[658,3407,3181],{"class":675},[658,3409,3411,3413,3415,3418,3420,3422,3425,3427,3429,3432,3434,3436],{"class":660,"line":3410},20,[658,3412,3393],{"class":675},[658,3414,535],{"class":772},[658,3416,3417],{"class":895}," class",[658,3419,2905],{"class":675},[658,3421,899],{"class":675},[658,3423,3424],{"class":690},"mt-2 font-medium",[658,3426,899],{"class":675},[658,3428,3398],{"class":675},[658,3430,3431],{"class":683},"{{ parsed.fix }}",[658,3433,3272],{"class":675},[658,3435,535],{"class":772},[658,3437,3181],{"class":675},[658,3439,3441,3444,3446],{"class":660,"line":3440},21,[658,3442,3443],{"class":675},"    \u003C\u002F",[658,3445,3287],{"class":772},[658,3447,3181],{"class":675},[658,3449,3451,3454,3457],{"class":660,"line":3450},22,[658,3452,3453],{"class":675},"  \u003C\u002F",[658,3455,3456],{"class":772},"UAlert",[658,3458,3181],{"class":675},[658,3460,3462,3464,3466],{"class":660,"line":3461},23,[658,3463,3272],{"class":675},[658,3465,3287],{"class":772},[658,3467,3181],{"class":675},[637,3469,517],{"id":3470},"best-practices",[1366,3472,3474],{"id":3473},"use-appropriate-status-codes","Use Appropriate Status Codes",[716,3476,3477,3545,3628,3680],{},[648,3478,3481],{"className":650,"code":3479,"filename":3480,"language":653,"meta":654,"style":654},"\u002F\u002F Client error - user can fix\nthrow createError({\n  message: 'Invalid email format',\n  status: 400,\n  fix: 'Please enter a valid email address',\n})\n","400 - Bad Request",[539,3482,3483,3488,3498,3513,3524,3539],{"__ignoreMap":654},[658,3484,3485],{"class":660,"line":661},[658,3486,3487],{"class":664},"\u002F\u002F Client error - user can fix\n",[658,3489,3490,3492,3494,3496],{"class":660,"line":668},[658,3491,672],{"class":671},[658,3493,733],{"class":679},[658,3495,684],{"class":683},[658,3497,766],{"class":675},[658,3499,3500,3502,3504,3506,3509,3511],{"class":660,"line":757},[658,3501,792],{"class":772},[658,3503,776],{"class":675},[658,3505,742],{"class":675},[658,3507,3508],{"class":690},"Invalid email format",[658,3510,687],{"class":675},[658,3512,786],{"class":675},[658,3514,3515,3517,3519,3522],{"class":660,"line":769},[658,3516,808],{"class":772},[658,3518,776],{"class":675},[658,3520,3521],{"class":813}," 400",[658,3523,786],{"class":675},[658,3525,3526,3528,3530,3532,3535,3537],{"class":660,"line":789},[658,3527,839],{"class":772},[658,3529,776],{"class":675},[658,3531,742],{"class":675},[658,3533,3534],{"class":690},"Please enter a valid email address",[658,3536,687],{"class":675},[658,3538,786],{"class":675},[658,3540,3541,3543],{"class":660,"line":805},[658,3542,873],{"class":675},[658,3544,696],{"class":683},[648,3546,3549],{"className":650,"code":3547,"filename":3548,"language":653,"meta":654,"style":654},"\u002F\u002F Authentication required\nthrow createError({\n  message: 'Please log in to continue',\n  status: 401,\n  fix: 'Sign in to your account',\n  link: '\u002Flogin',\n})\n","401 - Unauthorized",[539,3550,3551,3556,3566,3581,3592,3607,3622],{"__ignoreMap":654},[658,3552,3553],{"class":660,"line":661},[658,3554,3555],{"class":664},"\u002F\u002F Authentication required\n",[658,3557,3558,3560,3562,3564],{"class":660,"line":668},[658,3559,672],{"class":671},[658,3561,733],{"class":679},[658,3563,684],{"class":683},[658,3565,766],{"class":675},[658,3567,3568,3570,3572,3574,3577,3579],{"class":660,"line":757},[658,3569,792],{"class":772},[658,3571,776],{"class":675},[658,3573,742],{"class":675},[658,3575,3576],{"class":690},"Please log in to continue",[658,3578,687],{"class":675},[658,3580,786],{"class":675},[658,3582,3583,3585,3587,3590],{"class":660,"line":769},[658,3584,808],{"class":772},[658,3586,776],{"class":675},[658,3588,3589],{"class":813}," 401",[658,3591,786],{"class":675},[658,3593,3594,3596,3598,3600,3603,3605],{"class":660,"line":789},[658,3595,839],{"class":772},[658,3597,776],{"class":675},[658,3599,742],{"class":675},[658,3601,3602],{"class":690},"Sign in to your account",[658,3604,687],{"class":675},[658,3606,786],{"class":675},[658,3608,3609,3611,3613,3615,3618,3620],{"class":660,"line":805},[658,3610,856],{"class":772},[658,3612,776],{"class":675},[658,3614,742],{"class":675},[658,3616,3617],{"class":690},"\u002Flogin",[658,3619,687],{"class":675},[658,3621,786],{"class":675},[658,3623,3624,3626],{"class":660,"line":819},[658,3625,873],{"class":675},[658,3627,696],{"class":683},[648,3629,3632],{"className":650,"code":3630,"filename":3631,"language":653,"meta":654,"style":654},"\u002F\u002F Resource not found\nthrow createError({\n  message: 'Order not found',\n  status: 404,\n})\n","404 - Not Found",[539,3633,3634,3639,3649,3664,3674],{"__ignoreMap":654},[658,3635,3636],{"class":660,"line":661},[658,3637,3638],{"class":664},"\u002F\u002F Resource not found\n",[658,3640,3641,3643,3645,3647],{"class":660,"line":668},[658,3642,672],{"class":671},[658,3644,733],{"class":679},[658,3646,684],{"class":683},[658,3648,766],{"class":675},[658,3650,3651,3653,3655,3657,3660,3662],{"class":660,"line":757},[658,3652,792],{"class":772},[658,3654,776],{"class":675},[658,3656,742],{"class":675},[658,3658,3659],{"class":690},"Order not found",[658,3661,687],{"class":675},[658,3663,786],{"class":675},[658,3665,3666,3668,3670,3672],{"class":660,"line":769},[658,3667,808],{"class":772},[658,3669,776],{"class":675},[658,3671,1433],{"class":813},[658,3673,786],{"class":675},[658,3675,3676,3678],{"class":660,"line":789},[658,3677,873],{"class":675},[658,3679,696],{"class":683},[648,3681,3684],{"className":650,"code":3682,"filename":3683,"language":653,"meta":654,"style":654},"\u002F\u002F Server error - not user's fault\nthrow createError({\n  message: 'Something went wrong',\n  status: 500,\n  why: 'Database connection timeout',\n  \u002F\u002F No 'fix' - user can't fix server errors\n})\n","500 - Server Error",[539,3685,3686,3691,3701,3716,3726,3741,3746],{"__ignoreMap":654},[658,3687,3688],{"class":660,"line":661},[658,3689,3690],{"class":664},"\u002F\u002F Server error - not user's fault\n",[658,3692,3693,3695,3697,3699],{"class":660,"line":668},[658,3694,672],{"class":671},[658,3696,733],{"class":679},[658,3698,684],{"class":683},[658,3700,766],{"class":675},[658,3702,3703,3705,3707,3709,3712,3714],{"class":660,"line":757},[658,3704,792],{"class":772},[658,3706,776],{"class":675},[658,3708,742],{"class":675},[658,3710,3711],{"class":690},"Something went wrong",[658,3713,687],{"class":675},[658,3715,786],{"class":675},[658,3717,3718,3720,3722,3724],{"class":660,"line":769},[658,3719,808],{"class":772},[658,3721,776],{"class":675},[658,3723,1861],{"class":813},[658,3725,786],{"class":675},[658,3727,3728,3730,3732,3734,3737,3739],{"class":660,"line":789},[658,3729,822],{"class":772},[658,3731,776],{"class":675},[658,3733,742],{"class":675},[658,3735,3736],{"class":690},"Database connection timeout",[658,3738,687],{"class":675},[658,3740,786],{"class":675},[658,3742,3743],{"class":660,"line":805},[658,3744,3745],{"class":664},"  \u002F\u002F No 'fix' - user can't fix server errors\n",[658,3747,3748,3750],{"class":660,"line":819},[658,3749,873],{"class":675},[658,3751,696],{"class":683},[1366,3753,3755],{"id":3754},"provide-actionable-fixes","Provide Actionable Fixes",[716,3757,3758,3815],{},[648,3759,3762],{"className":650,"code":3760,"filename":3761,"language":653,"meta":654,"style":654},"\u002F\u002F Unhelpful fix\nthrow createError({\n  message: 'Upload failed',\n  fix: 'Try again',\n})\n","Bad",[539,3763,3764,3769,3779,3794,3809],{"__ignoreMap":654},[658,3765,3766],{"class":660,"line":661},[658,3767,3768],{"class":664},"\u002F\u002F Unhelpful fix\n",[658,3770,3771,3773,3775,3777],{"class":660,"line":668},[658,3772,672],{"class":671},[658,3774,733],{"class":679},[658,3776,684],{"class":683},[658,3778,766],{"class":675},[658,3780,3781,3783,3785,3787,3790,3792],{"class":660,"line":757},[658,3782,792],{"class":772},[658,3784,776],{"class":675},[658,3786,742],{"class":675},[658,3788,3789],{"class":690},"Upload failed",[658,3791,687],{"class":675},[658,3793,786],{"class":675},[658,3795,3796,3798,3800,3802,3805,3807],{"class":660,"line":769},[658,3797,839],{"class":772},[658,3799,776],{"class":675},[658,3801,742],{"class":675},[658,3803,3804],{"class":690},"Try again",[658,3806,687],{"class":675},[658,3808,786],{"class":675},[658,3810,3811,3813],{"class":660,"line":789},[658,3812,873],{"class":675},[658,3814,696],{"class":683},[648,3816,3819],{"className":650,"code":3817,"filename":3818,"language":653,"meta":654,"style":654},"\u002F\u002F Actionable fix\nthrow createError({\n  message: 'Upload failed',\n  status: 413,\n  why: 'File exceeds maximum size (10MB)',\n  fix: 'Reduce the file size or compress the image before uploading',\n  link: '\u002Fdocs\u002Fupload-limits',\n})\n","Good",[539,3820,3821,3826,3836,3850,3861,3876,3891,3906],{"__ignoreMap":654},[658,3822,3823],{"class":660,"line":661},[658,3824,3825],{"class":664},"\u002F\u002F Actionable fix\n",[658,3827,3828,3830,3832,3834],{"class":660,"line":668},[658,3829,672],{"class":671},[658,3831,733],{"class":679},[658,3833,684],{"class":683},[658,3835,766],{"class":675},[658,3837,3838,3840,3842,3844,3846,3848],{"class":660,"line":757},[658,3839,792],{"class":772},[658,3841,776],{"class":675},[658,3843,742],{"class":675},[658,3845,3789],{"class":690},[658,3847,687],{"class":675},[658,3849,786],{"class":675},[658,3851,3852,3854,3856,3859],{"class":660,"line":769},[658,3853,808],{"class":772},[658,3855,776],{"class":675},[658,3857,3858],{"class":813}," 413",[658,3860,786],{"class":675},[658,3862,3863,3865,3867,3869,3872,3874],{"class":660,"line":789},[658,3864,822],{"class":772},[658,3866,776],{"class":675},[658,3868,742],{"class":675},[658,3870,3871],{"class":690},"File exceeds maximum size (10MB)",[658,3873,687],{"class":675},[658,3875,786],{"class":675},[658,3877,3878,3880,3882,3884,3887,3889],{"class":660,"line":805},[658,3879,839],{"class":772},[658,3881,776],{"class":675},[658,3883,742],{"class":675},[658,3885,3886],{"class":690},"Reduce the file size or compress the image before uploading",[658,3888,687],{"class":675},[658,3890,786],{"class":675},[658,3892,3893,3895,3897,3899,3902,3904],{"class":660,"line":819},[658,3894,856],{"class":772},[658,3896,776],{"class":675},[658,3898,742],{"class":675},[658,3900,3901],{"class":690},"\u002Fdocs\u002Fupload-limits",[658,3903,687],{"class":675},[658,3905,786],{"class":675},[658,3907,3908,3910],{"class":660,"line":836},[658,3909,873],{"class":675},[658,3911,696],{"class":683},[637,3913,3915],{"id":3914},"error-catalogs","Error Catalogs",[535,3917,3918,3919,3922,3923,3926,3927,3930,3931,3933,3934,3937,3938,3940],{},"For anything beyond a handful of one-off errors, group them in a typed ",[1156,3920,3921],{},"catalog",". evlog ships two primitives for this — ",[539,3924,3925],{},"defineError"," (single factory) and ",[539,3928,3929],{},"defineErrorCatalog"," (bundle prefixed). The wire ",[539,3932,539],{}," is auto-derived as ",[539,3935,3936],{},"${prefix}.${KEY}"," and the ",[539,3939,1349],{}," instance is built with all defaults applied.",[1366,3942,3944],{"id":3943},"defineerrorcatalog",[539,3945,3929],{},[535,3947,3948,3949,3952,3953,3956],{},"Define a bundle of errors that share a prefix. Convention: ",[539,3950,3951],{},"UPPER_SNAKE_CASE"," keys, ",[539,3954,3955],{},"lower.dot.case"," prefix.",[716,3958,3959,4257],{},[648,3960,3963],{"className":650,"code":3961,"filename":3962,"language":653,"meta":654,"style":654},"import { defineErrorCatalog } from 'evlog'\n\nexport const billingErrors = defineErrorCatalog('billing', {\n  CART_EMPTY: {\n    status: 400,\n    message: 'Cart is empty',\n  },\n  PAYMENT_DECLINED: {\n    status: 402,\n    message: 'Card declined',\n    why: 'Issuer declined the charge',\n    fix: 'Try a different payment method',\n    link: 'https:\u002F\u002Fdocs.example.com\u002Ferrors\u002Fbilling.payment_declined',\n  },\n  INSUFFICIENT_FUNDS: {\n    status: 402,\n    message: ({ available, required }: { available: number, required: number }) =>\n      `Insufficient funds: $${available} available, $${required} required`,\n    fix: 'Add funds and retry',\n  },\n})\n","errors\u002Fbilling.ts",[539,3964,3965,3984,3988,4016,4025,4035,4050,4054,4063,4073,4087,4101,4116,4132,4136,4145,4155,4199,4232,4247,4251],{"__ignoreMap":654},[658,3966,3967,3969,3971,3974,3976,3978,3980,3982],{"class":660,"line":661},[658,3968,727],{"class":671},[658,3970,730],{"class":675},[658,3972,3973],{"class":683}," defineErrorCatalog",[658,3975,736],{"class":675},[658,3977,739],{"class":671},[658,3979,742],{"class":675},[658,3981,745],{"class":690},[658,3983,748],{"class":675},[658,3985,3986],{"class":660,"line":668},[658,3987,754],{"emptyLinePlaceholder":753},[658,3989,3990,3993,3996,3999,4001,4003,4005,4007,4010,4012,4014],{"class":660,"line":757},[658,3991,3992],{"class":671},"export",[658,3994,3995],{"class":895}," const",[658,3997,3998],{"class":683}," billingErrors ",[658,4000,2905],{"class":675},[658,4002,3973],{"class":679},[658,4004,684],{"class":683},[658,4006,687],{"class":675},[658,4008,4009],{"class":690},"billing",[658,4011,687],{"class":675},[658,4013,1291],{"class":675},[658,4015,938],{"class":675},[658,4017,4018,4021,4023],{"class":660,"line":769},[658,4019,4020],{"class":772},"  CART_EMPTY",[658,4022,776],{"class":675},[658,4024,938],{"class":675},[658,4026,4027,4029,4031,4033],{"class":660,"line":789},[658,4028,1856],{"class":772},[658,4030,776],{"class":675},[658,4032,3521],{"class":813},[658,4034,786],{"class":675},[658,4036,4037,4039,4041,4043,4046,4048],{"class":660,"line":805},[658,4038,1840],{"class":772},[658,4040,776],{"class":675},[658,4042,742],{"class":675},[658,4044,4045],{"class":690},"Cart is empty",[658,4047,687],{"class":675},[658,4049,786],{"class":675},[658,4051,4052],{"class":660,"line":819},[658,4053,1299],{"class":675},[658,4055,4056,4059,4061],{"class":660,"line":836},[658,4057,4058],{"class":772},"  PAYMENT_DECLINED",[658,4060,776],{"class":675},[658,4062,938],{"class":675},[658,4064,4065,4067,4069,4071],{"class":660,"line":853},[658,4066,1856],{"class":772},[658,4068,776],{"class":675},[658,4070,814],{"class":813},[658,4072,786],{"class":675},[658,4074,4075,4077,4079,4081,4083,4085],{"class":660,"line":870},[658,4076,1840],{"class":772},[658,4078,776],{"class":675},[658,4080,742],{"class":675},[658,4082,2002],{"class":690},[658,4084,687],{"class":675},[658,4086,786],{"class":675},[658,4088,4089,4091,4093,4095,4097,4099],{"class":660,"line":1302},[658,4090,1868],{"class":772},[658,4092,776],{"class":675},[658,4094,742],{"class":675},[658,4096,2027],{"class":690},[658,4098,687],{"class":675},[658,4100,786],{"class":675},[658,4102,4103,4106,4108,4110,4112,4114],{"class":660,"line":1904},[658,4104,4105],{"class":772},"    fix",[658,4107,776],{"class":675},[658,4109,742],{"class":675},[658,4111,1591],{"class":690},[658,4113,687],{"class":675},[658,4115,786],{"class":675},[658,4117,4118,4121,4123,4125,4128,4130],{"class":660,"line":2544},[658,4119,4120],{"class":772},"    link",[658,4122,776],{"class":675},[658,4124,742],{"class":675},[658,4126,4127],{"class":690},"https:\u002F\u002Fdocs.example.com\u002Ferrors\u002Fbilling.payment_declined",[658,4129,687],{"class":675},[658,4131,786],{"class":675},[658,4133,4134],{"class":660,"line":2552},[658,4135,1299],{"class":675},[658,4137,4138,4141,4143],{"class":660,"line":2598},[658,4139,4140],{"class":772},"  INSUFFICIENT_FUNDS",[658,4142,776],{"class":675},[658,4144,938],{"class":675},[658,4146,4147,4149,4151,4153],{"class":660,"line":2603},[658,4148,1856],{"class":772},[658,4150,776],{"class":675},[658,4152,814],{"class":813},[658,4154,786],{"class":675},[658,4156,4157,4159,4161,4164,4168,4170,4173,4176,4178,4180,4182,4185,4187,4189,4191,4193,4196],{"class":660,"line":3131},[658,4158,1840],{"class":679},[658,4160,776],{"class":675},[658,4162,4163],{"class":675}," ({",[658,4165,4167],{"class":4166},"sHdIc"," available",[658,4169,1291],{"class":675},[658,4171,4172],{"class":4166}," required",[658,4174,4175],{"class":675}," }:",[658,4177,730],{"class":675},[658,4179,4167],{"class":772},[658,4181,776],{"class":675},[658,4183,4184],{"class":946}," number",[658,4186,1291],{"class":675},[658,4188,4172],{"class":772},[658,4190,776],{"class":675},[658,4192,4184],{"class":946},[658,4194,4195],{"class":675}," })",[658,4197,4198],{"class":895}," =>\n",[658,4200,4201,4204,4207,4210,4213,4215,4218,4220,4223,4225,4227,4230],{"class":660,"line":3138},[658,4202,4203],{"class":675},"      `",[658,4205,4206],{"class":690},"Insufficient funds: $",[658,4208,4209],{"class":675},"${",[658,4211,4212],{"class":683},"available",[658,4214,873],{"class":675},[658,4216,4217],{"class":690}," available, $",[658,4219,4209],{"class":675},[658,4221,4222],{"class":683},"required",[658,4224,873],{"class":675},[658,4226,4172],{"class":690},[658,4228,4229],{"class":675},"`",[658,4231,786],{"class":675},[658,4233,4234,4236,4238,4240,4243,4245],{"class":660,"line":3390},[658,4235,4105],{"class":772},[658,4237,776],{"class":675},[658,4239,742],{"class":675},[658,4241,4242],{"class":690},"Add funds and retry",[658,4244,687],{"class":675},[658,4246,786],{"class":675},[658,4248,4249],{"class":660,"line":3410},[658,4250,1299],{"class":675},[658,4252,4253,4255],{"class":660,"line":3440},[658,4254,873],{"class":675},[658,4256,696],{"class":683},[648,4258,4260],{"className":650,"code":4259,"filename":652,"language":653,"meta":654,"style":654},"import { billingErrors } from '~\u002Ferrors\u002Fbilling'\n\nexport default defineEventHandler(async (event) => {\n  const cart = await getCart(event)\n\n  if (!cart.items.length) throw billingErrors.CART_EMPTY()\n\n  try {\n    await stripe.charge(cart.total)\n  }\n  catch (e) {\n    if (e.code === 'card_declined') throw billingErrors.PAYMENT_DECLINED({ cause: e })\n    if (e.code === 'insufficient_funds') {\n      throw billingErrors.INSUFFICIENT_FUNDS({\n        available: e.balance,\n        required: cart.total,\n        cause: e,\n      })\n    }\n    throw e\n  }\n})\n",[539,4261,4262,4282,4286,4312,4332,4336,4371,4375,4382,4404,4408,4422,4471,4495,4511,4527,4542,4553,4560,4565,4573,4577],{"__ignoreMap":654},[658,4263,4264,4266,4268,4271,4273,4275,4277,4280],{"class":660,"line":661},[658,4265,727],{"class":671},[658,4267,730],{"class":675},[658,4269,4270],{"class":683}," billingErrors",[658,4272,736],{"class":675},[658,4274,739],{"class":671},[658,4276,742],{"class":675},[658,4278,4279],{"class":690},"~\u002Ferrors\u002Fbilling",[658,4281,748],{"class":675},[658,4283,4284],{"class":660,"line":668},[658,4285,754],{"emptyLinePlaceholder":753},[658,4287,4288,4290,4293,4296,4298,4301,4303,4306,4308,4310],{"class":660,"line":757},[658,4289,3992],{"class":671},[658,4291,4292],{"class":671}," default",[658,4294,4295],{"class":679}," defineEventHandler",[658,4297,684],{"class":683},[658,4299,4300],{"class":895},"async",[658,4302,2326],{"class":675},[658,4304,4305],{"class":4166},"event",[658,4307,1075],{"class":675},[658,4309,3097],{"class":895},[658,4311,938],{"class":675},[658,4313,4314,4316,4318,4320,4323,4326,4328,4330],{"class":660,"line":769},[658,4315,2457],{"class":895},[658,4317,2438],{"class":683},[658,4319,2463],{"class":675},[658,4321,4322],{"class":671}," await",[658,4324,4325],{"class":679}," getCart",[658,4327,684],{"class":772},[658,4329,4305],{"class":683},[658,4331,696],{"class":772},[658,4333,4334],{"class":660,"line":789},[658,4335,754],{"emptyLinePlaceholder":753},[658,4337,4338,4341,4343,4346,4348,4350,4353,4355,4358,4360,4362,4364,4366,4369],{"class":660,"line":805},[658,4339,4340],{"class":671},"  if",[658,4342,2326],{"class":772},[658,4344,4345],{"class":675},"!",[658,4347,1930],{"class":683},[658,4349,711],{"class":675},[658,4351,4352],{"class":683},"items",[658,4354,711],{"class":675},[658,4356,4357],{"class":683},"length",[658,4359,2492],{"class":772},[658,4361,672],{"class":671},[658,4363,4270],{"class":683},[658,4365,711],{"class":675},[658,4367,4368],{"class":679},"CART_EMPTY",[658,4370,2519],{"class":772},[658,4372,4373],{"class":660,"line":819},[658,4374,754],{"emptyLinePlaceholder":753},[658,4376,4377,4380],{"class":660,"line":836},[658,4378,4379],{"class":671},"  try",[658,4381,938],{"class":675},[658,4383,4384,4387,4389,4391,4393,4395,4397,4399,4402],{"class":660,"line":853},[658,4385,4386],{"class":671},"    await",[658,4388,1795],{"class":683},[658,4390,711],{"class":675},[658,4392,1810],{"class":679},[658,4394,684],{"class":772},[658,4396,1930],{"class":683},[658,4398,711],{"class":675},[658,4400,4401],{"class":683},"total",[658,4403,696],{"class":772},[658,4405,4406],{"class":660,"line":870},[658,4407,1016],{"class":675},[658,4409,4410,4413,4415,4418,4420],{"class":660,"line":1302},[658,4411,4412],{"class":671},"  catch",[658,4414,2326],{"class":772},[658,4416,4417],{"class":683},"e",[658,4419,2492],{"class":772},[658,4421,766],{"class":675},[658,4423,4424,4427,4429,4431,4433,4435,4438,4440,4443,4445,4447,4449,4451,4453,4455,4457,4459,4462,4464,4467,4469],{"class":660,"line":1904},[658,4425,4426],{"class":671},"    if",[658,4428,2326],{"class":772},[658,4430,4417],{"class":683},[658,4432,711],{"class":675},[658,4434,539],{"class":683},[658,4436,4437],{"class":675}," ===",[658,4439,742],{"class":675},[658,4441,4442],{"class":690},"card_declined",[658,4444,687],{"class":675},[658,4446,2492],{"class":772},[658,4448,672],{"class":671},[658,4450,4270],{"class":683},[658,4452,711],{"class":675},[658,4454,781],{"class":679},[658,4456,684],{"class":772},[658,4458,2567],{"class":675},[658,4460,4461],{"class":772}," cause",[658,4463,776],{"class":675},[658,4465,4466],{"class":683}," e",[658,4468,736],{"class":675},[658,4470,696],{"class":772},[658,4472,4473,4475,4477,4479,4481,4483,4485,4487,4489,4491,4493],{"class":660,"line":2544},[658,4474,4426],{"class":671},[658,4476,2326],{"class":772},[658,4478,4417],{"class":683},[658,4480,711],{"class":675},[658,4482,539],{"class":683},[658,4484,4437],{"class":675},[658,4486,742],{"class":675},[658,4488,1270],{"class":690},[658,4490,687],{"class":675},[658,4492,2492],{"class":772},[658,4494,766],{"class":675},[658,4496,4497,4500,4502,4504,4507,4509],{"class":660,"line":2552},[658,4498,4499],{"class":671},"      throw",[658,4501,4270],{"class":683},[658,4503,711],{"class":675},[658,4505,4506],{"class":679},"INSUFFICIENT_FUNDS",[658,4508,684],{"class":772},[658,4510,766],{"class":675},[658,4512,4513,4516,4518,4520,4522,4525],{"class":660,"line":2598},[658,4514,4515],{"class":772},"        available",[658,4517,776],{"class":675},[658,4519,4466],{"class":683},[658,4521,711],{"class":675},[658,4523,4524],{"class":683},"balance",[658,4526,786],{"class":675},[658,4528,4529,4532,4534,4536,4538,4540],{"class":660,"line":2603},[658,4530,4531],{"class":772},"        required",[658,4533,776],{"class":675},[658,4535,2438],{"class":683},[658,4537,711],{"class":675},[658,4539,4401],{"class":683},[658,4541,786],{"class":675},[658,4543,4544,4547,4549,4551],{"class":660,"line":3131},[658,4545,4546],{"class":772},"        cause",[658,4548,776],{"class":675},[658,4550,4466],{"class":683},[658,4552,786],{"class":675},[658,4554,4555,4558],{"class":660,"line":3138},[658,4556,4557],{"class":675},"      }",[658,4559,696],{"class":772},[658,4561,4562],{"class":660,"line":3390},[658,4563,4564],{"class":675},"    }\n",[658,4566,4567,4570],{"class":660,"line":3410},[658,4568,4569],{"class":671},"    throw",[658,4571,4572],{"class":683}," e\n",[658,4574,4575],{"class":660,"line":3440},[658,4576,1016],{"class":675},[658,4578,4579,4581],{"class":660,"line":3450},[658,4580,873],{"class":675},[658,4582,696],{"class":683},[535,4584,4585,4586,623,4589,4592,4593,4596],{},"Each entry becomes a typed factory. Catalog metadata is exposed on ",[539,4587,4588],{},"_codes",[539,4590,4591],{},"_prefix"," for introspection (non-enumerable so ",[539,4594,4595],{},"Object.keys(billingErrors)"," still returns just the entry names).",[648,4598,4600],{"className":650,"code":4599,"language":653,"meta":654,"style":654},"billingErrors.PAYMENT_DECLINED.code   \u002F\u002F 'billing.PAYMENT_DECLINED'\nbillingErrors.PAYMENT_DECLINED.status \u002F\u002F 402\nbillingErrors._codes\n\u002F\u002F readonly [\n\u002F\u002F   'billing.CART_EMPTY',\n\u002F\u002F   'billing.PAYMENT_DECLINED',\n\u002F\u002F   'billing.INSUFFICIENT_FUNDS',\n\u002F\u002F ]\n",[539,4601,4602,4619,4634,4643,4648,4653,4658,4663],{"__ignoreMap":654},[658,4603,4604,4607,4609,4611,4613,4616],{"class":660,"line":661},[658,4605,4606],{"class":683},"billingErrors",[658,4608,711],{"class":675},[658,4610,781],{"class":683},[658,4612,711],{"class":675},[658,4614,4615],{"class":683},"code   ",[658,4617,4618],{"class":664},"\u002F\u002F 'billing.PAYMENT_DECLINED'\n",[658,4620,4621,4623,4625,4627,4629,4632],{"class":660,"line":668},[658,4622,4606],{"class":683},[658,4624,711],{"class":675},[658,4626,781],{"class":683},[658,4628,711],{"class":675},[658,4630,4631],{"class":683},"status ",[658,4633,2797],{"class":664},[658,4635,4636,4638,4640],{"class":660,"line":757},[658,4637,4606],{"class":683},[658,4639,711],{"class":675},[658,4641,4642],{"class":683},"_codes\n",[658,4644,4645],{"class":660,"line":769},[658,4646,4647],{"class":664},"\u002F\u002F readonly [\n",[658,4649,4650],{"class":660,"line":789},[658,4651,4652],{"class":664},"\u002F\u002F   'billing.CART_EMPTY',\n",[658,4654,4655],{"class":660,"line":805},[658,4656,4657],{"class":664},"\u002F\u002F   'billing.PAYMENT_DECLINED',\n",[658,4659,4660],{"class":660,"line":819},[658,4661,4662],{"class":664},"\u002F\u002F   'billing.INSUFFICIENT_FUNDS',\n",[658,4664,4665],{"class":660,"line":836},[658,4666,4667],{"class":664},"\u002F\u002F ]\n",[1366,4669,4671],{"id":4670},"templated-messages-with-typed-params","Templated messages with typed params",[535,4673,4674,4675,4677,4678,4681],{},"Set ",[539,4676,580],{}," to a function and the params become ",[1156,4679,4680],{},"required and typed"," at the call site.",[648,4683,4685],{"className":650,"code":4684,"language":653,"meta":654,"style":654},"const InvoiceOverdue = defineError('billing.INVOICE_OVERDUE', {\n  status: 402,\n  message: ({ daysOverdue }: { daysOverdue: number }) =>\n    `Invoice overdue by ${daysOverdue} day(s)`,\n  fix: 'Pay outstanding invoice to resume service',\n})\n\nthrow InvoiceOverdue({ daysOverdue: 7 }) \u002F\u002F params required and type-checked\n",[539,4686,4687,4712,4722,4747,4769,4784,4790,4794],{"__ignoreMap":654},[658,4688,4689,4691,4694,4696,4699,4701,4703,4706,4708,4710],{"class":660,"line":661},[658,4690,2899],{"class":895},[658,4692,4693],{"class":683}," InvoiceOverdue ",[658,4695,2905],{"class":675},[658,4697,4698],{"class":679}," defineError",[658,4700,684],{"class":683},[658,4702,687],{"class":675},[658,4704,4705],{"class":690},"billing.INVOICE_OVERDUE",[658,4707,687],{"class":675},[658,4709,1291],{"class":675},[658,4711,938],{"class":675},[658,4713,4714,4716,4718,4720],{"class":660,"line":668},[658,4715,808],{"class":772},[658,4717,776],{"class":675},[658,4719,814],{"class":813},[658,4721,786],{"class":675},[658,4723,4724,4726,4728,4730,4733,4735,4737,4739,4741,4743,4745],{"class":660,"line":757},[658,4725,792],{"class":679},[658,4727,776],{"class":675},[658,4729,4163],{"class":675},[658,4731,4732],{"class":4166}," daysOverdue",[658,4734,4175],{"class":675},[658,4736,730],{"class":675},[658,4738,4732],{"class":772},[658,4740,776],{"class":675},[658,4742,4184],{"class":946},[658,4744,4195],{"class":675},[658,4746,4198],{"class":895},[658,4748,4749,4752,4755,4757,4760,4762,4765,4767],{"class":660,"line":769},[658,4750,4751],{"class":675},"    `",[658,4753,4754],{"class":690},"Invoice overdue by ",[658,4756,4209],{"class":675},[658,4758,4759],{"class":683},"daysOverdue",[658,4761,873],{"class":675},[658,4763,4764],{"class":690}," day(s)",[658,4766,4229],{"class":675},[658,4768,786],{"class":675},[658,4770,4771,4773,4775,4777,4780,4782],{"class":660,"line":789},[658,4772,839],{"class":772},[658,4774,776],{"class":675},[658,4776,742],{"class":675},[658,4778,4779],{"class":690},"Pay outstanding invoice to resume service",[658,4781,687],{"class":675},[658,4783,786],{"class":675},[658,4785,4786,4788],{"class":660,"line":805},[658,4787,873],{"class":675},[658,4789,696],{"class":683},[658,4791,4792],{"class":660,"line":819},[658,4793,754],{"emptyLinePlaceholder":753},[658,4795,4796,4798,4801,4803,4805,4807,4809,4812,4814,4816],{"class":660,"line":836},[658,4797,672],{"class":671},[658,4799,4800],{"class":679}," InvoiceOverdue",[658,4802,684],{"class":683},[658,4804,2567],{"class":675},[658,4806,4732],{"class":772},[658,4808,776],{"class":675},[658,4810,4811],{"class":813}," 7",[658,4813,736],{"class":675},[658,4815,2492],{"class":683},[658,4817,4818],{"class":664},"\u002F\u002F params required and type-checked\n",[535,4820,4821,4822,571,4824,571,4826,571,4828,571,4830,571,4832,571,4834,4836,4837,4839],{},"You can still override any field at the call site (",[539,4823,580],{},[539,4825,599],{},[539,4827,584],{},[539,4829,588],{},[539,4831,592],{},[539,4833,1138],{},[539,4835,1126],{},"). Catalog defaults for ",[539,4838,1138],{}," are shallow-merged with call-site values (call-site wins on conflict).",[1366,4841,4843,4845],{"id":4842},"defineerror-standalone-factories",[539,4844,3925],{}," — standalone factories",[535,4847,4848,4849,4851],{},"For one-off errors that don't fit a catalog (or for very large repos that prefer one file per error), use ",[539,4850,3925],{}," directly. Same factory shape as a catalog entry, no prefix derivation.",[648,4853,4855],{"className":650,"code":4854,"language":653,"meta":654,"style":654},"\u002F\u002F errors\u002FFraudDetected.ts\nimport { defineError } from 'evlog'\n\nexport const FraudDetected = defineError('billing.FRAUD_DETECTED', {\n  status: 403,\n  message: 'Transaction flagged for review',\n  why: 'ML fraud-score above threshold',\n  fix: 'Contact support to verify your identity',\n})\n\nthrow FraudDetected()\n",[539,4856,4857,4862,4880,4884,4910,4921,4936,4951,4966,4972,4976],{"__ignoreMap":654},[658,4858,4859],{"class":660,"line":661},[658,4860,4861],{"class":664},"\u002F\u002F errors\u002FFraudDetected.ts\n",[658,4863,4864,4866,4868,4870,4872,4874,4876,4878],{"class":660,"line":668},[658,4865,727],{"class":671},[658,4867,730],{"class":675},[658,4869,4698],{"class":683},[658,4871,736],{"class":675},[658,4873,739],{"class":671},[658,4875,742],{"class":675},[658,4877,745],{"class":690},[658,4879,748],{"class":675},[658,4881,4882],{"class":660,"line":757},[658,4883,754],{"emptyLinePlaceholder":753},[658,4885,4886,4888,4890,4893,4895,4897,4899,4901,4904,4906,4908],{"class":660,"line":769},[658,4887,3992],{"class":671},[658,4889,3995],{"class":895},[658,4891,4892],{"class":683}," FraudDetected ",[658,4894,2905],{"class":675},[658,4896,4698],{"class":679},[658,4898,684],{"class":683},[658,4900,687],{"class":675},[658,4902,4903],{"class":690},"billing.FRAUD_DETECTED",[658,4905,687],{"class":675},[658,4907,1291],{"class":675},[658,4909,938],{"class":675},[658,4911,4912,4914,4916,4919],{"class":660,"line":789},[658,4913,808],{"class":772},[658,4915,776],{"class":675},[658,4917,4918],{"class":813}," 403",[658,4920,786],{"class":675},[658,4922,4923,4925,4927,4929,4932,4934],{"class":660,"line":805},[658,4924,792],{"class":772},[658,4926,776],{"class":675},[658,4928,742],{"class":675},[658,4930,4931],{"class":690},"Transaction flagged for review",[658,4933,687],{"class":675},[658,4935,786],{"class":675},[658,4937,4938,4940,4942,4944,4947,4949],{"class":660,"line":819},[658,4939,822],{"class":772},[658,4941,776],{"class":675},[658,4943,742],{"class":675},[658,4945,4946],{"class":690},"ML fraud-score above threshold",[658,4948,687],{"class":675},[658,4950,786],{"class":675},[658,4952,4953,4955,4957,4959,4962,4964],{"class":660,"line":836},[658,4954,839],{"class":772},[658,4956,776],{"class":675},[658,4958,742],{"class":675},[658,4960,4961],{"class":690},"Contact support to verify your identity",[658,4963,687],{"class":675},[658,4965,786],{"class":675},[658,4967,4968,4970],{"class":660,"line":853},[658,4969,873],{"class":675},[658,4971,696],{"class":683},[658,4973,4974],{"class":660,"line":870},[658,4975,754],{"emptyLinePlaceholder":753},[658,4977,4978,4980,4983],{"class":660,"line":1302},[658,4979,672],{"class":671},[658,4981,4982],{"class":679}," FraudDetected",[658,4984,2519],{"class":683},[1366,4986,4988],{"id":4987},"type-safe-codes-everywhere-opt-in","Type-safe codes everywhere (opt-in)",[535,4990,4991,4992,4995,4996,571,4999,5002,5003,5005],{},"Augment the ",[539,4993,4994],{},"RegisteredErrorCatalogs"," interface to make every registered code surface as autocomplete on ",[539,4997,4998],{},"createError({ code })",[539,5000,5001],{},"parseError(err).code",", and any other typed ",[539,5004,539],{}," field across the codebase.",[716,5007,5008,5123],{},[648,5009,5012],{"className":650,"code":5010,"filename":5011,"language":653,"meta":654,"style":654},"import type { billingErrors } from '.\u002Fbilling'\nimport type { authErrors }    from '.\u002Fauth'\n\ndeclare module 'evlog' {\n  interface RegisteredErrorCatalogs {\n    billing: typeof billingErrors\n    auth:    typeof authErrors\n  }\n}\n","errors\u002Ftypes.ts",[539,5013,5014,5036,5059,5063,5079,5089,5102,5115,5119],{"__ignoreMap":654},[658,5015,5016,5018,5021,5023,5025,5027,5029,5031,5034],{"class":660,"line":661},[658,5017,727],{"class":671},[658,5019,5020],{"class":671}," type",[658,5022,730],{"class":675},[658,5024,4270],{"class":683},[658,5026,736],{"class":675},[658,5028,739],{"class":671},[658,5030,742],{"class":675},[658,5032,5033],{"class":690},".\u002Fbilling",[658,5035,748],{"class":675},[658,5037,5038,5040,5042,5044,5047,5049,5052,5054,5057],{"class":660,"line":668},[658,5039,727],{"class":671},[658,5041,5020],{"class":671},[658,5043,730],{"class":675},[658,5045,5046],{"class":683}," authErrors",[658,5048,736],{"class":675},[658,5050,5051],{"class":671},"    from",[658,5053,742],{"class":675},[658,5055,5056],{"class":690},".\u002Fauth",[658,5058,748],{"class":675},[658,5060,5061],{"class":660,"line":757},[658,5062,754],{"emptyLinePlaceholder":753},[658,5064,5065,5068,5071,5073,5075,5077],{"class":660,"line":769},[658,5066,5067],{"class":895},"declare",[658,5069,5070],{"class":895}," module",[658,5072,742],{"class":675},[658,5074,745],{"class":690},[658,5076,687],{"class":675},[658,5078,938],{"class":675},[658,5080,5081,5084,5087],{"class":660,"line":789},[658,5082,5083],{"class":895},"  interface",[658,5085,5086],{"class":946}," RegisteredErrorCatalogs",[658,5088,938],{"class":675},[658,5090,5091,5094,5096,5099],{"class":660,"line":805},[658,5092,5093],{"class":772},"    billing",[658,5095,776],{"class":675},[658,5097,5098],{"class":675}," typeof",[658,5100,5101],{"class":683}," billingErrors\n",[658,5103,5104,5107,5109,5112],{"class":660,"line":819},[658,5105,5106],{"class":772},"    auth",[658,5108,776],{"class":675},[658,5110,5111],{"class":675},"    typeof",[658,5113,5114],{"class":683}," authErrors\n",[658,5116,5117],{"class":660,"line":836},[658,5118,1016],{"class":675},[658,5120,5121],{"class":660,"line":853},[658,5122,1021],{"class":675},[648,5124,5127],{"className":650,"code":5125,"filename":5126,"language":653,"meta":654,"style":654},"\u002F\u002F createError autocompletes registered codes (and still accepts ad-hoc strings)\nthrow createError({\n  code: 'billing.PAYMENT_DECLINED', \u002F\u002F ← autocomplete, TS error if typo\n  message: 'Card declined',\n  status: 402,\n})\n\n\u002F\u002F parseError().code is typed as the union of all registered codes\nconst err = parseError(caught)\nif (err.code === 'billing.PAYMENT_DECLINED') retry()\n\u002F\u002F                ↑ autocomplete, refactor-safe\n","Anywhere in your codebase",[539,5128,5129,5134,5144,5162,5176,5186,5192,5196,5201,5215,5244],{"__ignoreMap":654},[658,5130,5131],{"class":660,"line":661},[658,5132,5133],{"class":664},"\u002F\u002F createError autocompletes registered codes (and still accepts ad-hoc strings)\n",[658,5135,5136,5138,5140,5142],{"class":660,"line":668},[658,5137,672],{"class":671},[658,5139,733],{"class":679},[658,5141,684],{"class":683},[658,5143,766],{"class":675},[658,5145,5146,5148,5150,5152,5155,5157,5159],{"class":660,"line":757},[658,5147,773],{"class":772},[658,5149,776],{"class":675},[658,5151,742],{"class":675},[658,5153,5154],{"class":690},"billing.PAYMENT_DECLINED",[658,5156,687],{"class":675},[658,5158,1291],{"class":675},[658,5160,5161],{"class":664}," \u002F\u002F ← autocomplete, TS error if typo\n",[658,5163,5164,5166,5168,5170,5172,5174],{"class":660,"line":769},[658,5165,792],{"class":772},[658,5167,776],{"class":675},[658,5169,742],{"class":675},[658,5171,2002],{"class":690},[658,5173,687],{"class":675},[658,5175,786],{"class":675},[658,5177,5178,5180,5182,5184],{"class":660,"line":789},[658,5179,808],{"class":772},[658,5181,776],{"class":675},[658,5183,814],{"class":813},[658,5185,786],{"class":675},[658,5187,5188,5190],{"class":660,"line":805},[658,5189,873],{"class":675},[658,5191,696],{"class":683},[658,5193,5194],{"class":660,"line":819},[658,5195,754],{"emptyLinePlaceholder":753},[658,5197,5198],{"class":660,"line":836},[658,5199,5200],{"class":664},"\u002F\u002F parseError().code is typed as the union of all registered codes\n",[658,5202,5203,5205,5208,5210,5212],{"class":660,"line":853},[658,5204,2899],{"class":895},[658,5206,5207],{"class":683}," err ",[658,5209,2905],{"class":675},[658,5211,2376],{"class":679},[658,5213,5214],{"class":683},"(caught)\n",[658,5216,5217,5220,5223,5225,5228,5231,5233,5235,5237,5239,5242],{"class":660,"line":870},[658,5218,5219],{"class":671},"if",[658,5221,5222],{"class":683}," (err",[658,5224,711],{"class":675},[658,5226,5227],{"class":683},"code ",[658,5229,5230],{"class":675},"===",[658,5232,742],{"class":675},[658,5234,5154],{"class":690},[658,5236,687],{"class":675},[658,5238,2492],{"class":683},[658,5240,5241],{"class":679},"retry",[658,5243,2519],{"class":683},[658,5245,5246],{"class":660,"line":1302},[658,5247,5248],{"class":664},"\u002F\u002F                ↑ autocomplete, refactor-safe\n",[535,5250,5251],{},"This is purely type-level — no runtime registration, no init step. Skip it entirely if you don't need it; the runtime API is identical either way.",[5253,5254,5257,5260,5261,5264,5265,5268,5269,5272,5273,5276],"callout",{"color":5255,"icon":5256},"neutral","i-lucide-package",[1156,5258,5259],{},"Packaging tip."," A catalog is regular TypeScript. Publish ",[539,5262,5263],{},"@acme\u002Ferrors-billing"," exporting your ",[539,5266,5267],{},"defineErrorCatalog(...)"," plus the ",[539,5270,5271],{},"declare module 'evlog'"," augmentation in its ",[539,5274,5275],{},"index.d.ts",", and the typing flows transitively to every consumer that depends on it. Each shared package owns its prefix, no conflicts possible.",[5253,5278,5281,5284,5285,5288],{"color":5279,"icon":5280,"to":77},"primary","i-lucide-arrow-right",[1156,5282,5283],{},"Going further."," The dedicated ",[631,5286,5287],{"href":77},"Catalogs page"," covers the scaling story (single file → folder → feature → npm package), the full npm packaging recipe, composition patterns, the type-augmentation deep dive, and common pitfalls.",[5253,5290,5291,5292,5295],{"color":5255,"icon":334},"See the ",[631,5293,5294],{"href":236},"Next.js guide"," for a working implementation.",[637,5297,5299],{"id":5298},"next-steps","Next Steps",[552,5301,5302,5307,5312,5317],{},[555,5303,5304,5306],{},[631,5305,46],{"href":47},": Accumulate context and emit comprehensive events",[555,5308,5309,5311],{},[631,5310,138],{"href":143},": Send errors and events to Axiom, Sentry, PostHog, and more",[555,5313,5314,5316],{},[631,5315,221],{"href":226},": Auto-managed request logging per framework",[555,5318,5319,5321],{},[631,5320,25],{"href":26},": See all evlog APIs in action",[5323,5324,5325],"style",{},"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 .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 .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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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 .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":654,"searchDepth":668,"depth":668,"links":5327},[5328,5329,5330,5332,5337,5340,5342,5345,5349,5356],{"id":639,"depth":668,"text":640},{"id":1024,"depth":668,"text":1025},{"id":1146,"depth":668,"text":5331},"Backend-only context (internal)",{"id":1363,"depth":668,"text":1364,"children":5333},[5334,5335,5336],{"id":1368,"depth":757,"text":1369},{"id":1487,"depth":757,"text":1488},{"id":1749,"depth":757,"text":1750},{"id":1909,"depth":668,"text":1910,"children":5338},[5339],{"id":2252,"depth":757,"text":2253},{"id":2347,"depth":668,"text":5341},"Branching on code",{"id":2640,"depth":668,"text":2641,"children":5343},[5344],{"id":3143,"depth":757,"text":3144},{"id":3470,"depth":668,"text":517,"children":5346},[5347,5348],{"id":3473,"depth":757,"text":3474},{"id":3754,"depth":757,"text":3755},{"id":3914,"depth":668,"text":3915,"children":5350},[5351,5352,5353,5355],{"id":3943,"depth":757,"text":3929},{"id":4670,"depth":757,"text":4671},{"id":4842,"depth":757,"text":5354},"defineError — standalone factories",{"id":4987,"depth":757,"text":4988},{"id":5298,"depth":668,"text":5299},"Create errors that explain why they occurred and how to fix them. Add actionable context with why, fix, and link fields for humans and AI agents.","md",[5360,5362],{"label":46,"icon":49,"to":47,"color":5255,"variant":5361},"subtle",{"label":517,"icon":379,"to":518,"color":5255,"variant":5361},{},{"icon":54},{"title":51,"description":5357},"wFZNj2GdxUvM_gQcxp08awMfeYR1my6V6yMvK90afe4",[5368,5370],{"title":46,"path":47,"stem":48,"description":5369,"icon":49,"children":-1},"Accumulate context over any unit of work and emit a single comprehensive event. Works for HTTP requests, scripts, background jobs, queue workers, and workflows.",{"title":56,"path":57,"stem":58,"description":5371,"icon":59,"children":-1},"Understand the full lifecycle of an evlog event, from creation to drain. Covers all three modes (simple logging, wide events, request logging), sampling, enrichment, and delivery.",1786047075438]