[{"data":1,"prerenderedAt":5382},["ShallowReactive",2],{"navigation_docs":3,"-learn-structured-errors":529,"-learn-structured-errors-surround":5377},[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":5367,"extension":5368,"links":5369,"meta":5373,"navigation":5374,"path":52,"seo":5375,"stem":53,"__hash__":5376},"docs\u002F2.learn\u002F3.structured-errors.md",{"type":532,"value":533,"toc":5336},"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,3478,3481,3485,3762,3766,3922,3926,3951,3956,3967,4593,4607,4678,4682,4692,4829,4850,4856,4862,4995,4999,5016,5259,5262,5287,5299,5306,5310,5332],[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,3319,3338,3350,3364,3369,3398,3418,3448,3458,3469],{"__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,3306,3308,3310,3313,3315,3317],{"class":660,"line":2544},[658,3301,3302],{"class":675},"    :",[658,3304,3305],{"class":895},"title",[658,3307,2905],{"class":675},[658,3309,899],{"class":675},[658,3311,3312],{"class":683},"parsed",[658,3314,711],{"class":675},[658,3316,580],{"class":683},[658,3318,1011],{"class":675},[658,3320,3321,3323,3326,3328,3330,3332,3334,3336],{"class":660,"line":2552},[658,3322,3302],{"class":675},[658,3324,3325],{"class":895},"description",[658,3327,2905],{"class":675},[658,3329,899],{"class":675},[658,3331,3312],{"class":683},[658,3333,711],{"class":675},[658,3335,584],{"class":683},[658,3337,1011],{"class":675},[658,3339,3340,3342,3344,3346,3348],{"class":660,"line":2598},[658,3341,3038],{"class":895},[658,3343,2905],{"class":675},[658,3345,899],{"class":675},[658,3347,1922],{"class":690},[658,3349,1011],{"class":675},[658,3351,3352,3355,3357,3359,3362],{"class":660,"line":2603},[658,3353,3354],{"class":895},"    icon",[658,3356,2905],{"class":675},[658,3358,899],{"class":675},[658,3360,3361],{"class":690},"i-lucide-alert-circle",[658,3363,1011],{"class":675},[658,3365,3366],{"class":660,"line":3131},[658,3367,3368],{"class":675},"  >\n",[658,3370,3371,3374,3376,3379,3381,3383,3385,3387,3389,3391,3394,3396],{"class":660,"line":3138},[658,3372,3373],{"class":675},"    \u003C",[658,3375,3287],{"class":772},[658,3377,3378],{"class":671}," v-if",[658,3380,2905],{"class":675},[658,3382,899],{"class":675},[658,3384,3312],{"class":683},[658,3386,711],{"class":675},[658,3388,588],{"class":683},[658,3390,899],{"class":675},[658,3392,3393],{"class":675}," #",[658,3395,3325],{"class":895},[658,3397,3181],{"class":675},[658,3399,3401,3404,3406,3409,3412,3414,3416],{"class":660,"line":3400},19,[658,3402,3403],{"class":675},"      \u003C",[658,3405,535],{"class":772},[658,3407,3408],{"class":675},">",[658,3410,3411],{"class":683},"{{ parsed.why }}",[658,3413,3272],{"class":675},[658,3415,535],{"class":772},[658,3417,3181],{"class":675},[658,3419,3421,3423,3425,3428,3430,3432,3435,3437,3439,3442,3444,3446],{"class":660,"line":3420},20,[658,3422,3403],{"class":675},[658,3424,535],{"class":772},[658,3426,3427],{"class":895}," class",[658,3429,2905],{"class":675},[658,3431,899],{"class":675},[658,3433,3434],{"class":690},"mt-2 font-medium",[658,3436,899],{"class":675},[658,3438,3408],{"class":675},[658,3440,3441],{"class":683},"{{ parsed.fix }}",[658,3443,3272],{"class":675},[658,3445,535],{"class":772},[658,3447,3181],{"class":675},[658,3449,3451,3454,3456],{"class":660,"line":3450},21,[658,3452,3453],{"class":675},"    \u003C\u002F",[658,3455,3287],{"class":772},[658,3457,3181],{"class":675},[658,3459,3461,3464,3467],{"class":660,"line":3460},22,[658,3462,3463],{"class":675},"  \u003C\u002F",[658,3465,3466],{"class":772},"UAlert",[658,3468,3181],{"class":675},[658,3470,3472,3474,3476],{"class":660,"line":3471},23,[658,3473,3272],{"class":675},[658,3475,3287],{"class":772},[658,3477,3181],{"class":675},[637,3479,517],{"id":3480},"best-practices",[1366,3482,3484],{"id":3483},"use-appropriate-status-codes","Use Appropriate Status Codes",[716,3486,3487,3555,3638,3690],{},[648,3488,3491],{"className":650,"code":3489,"filename":3490,"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,3492,3493,3498,3508,3523,3534,3549],{"__ignoreMap":654},[658,3494,3495],{"class":660,"line":661},[658,3496,3497],{"class":664},"\u002F\u002F Client error - user can fix\n",[658,3499,3500,3502,3504,3506],{"class":660,"line":668},[658,3501,672],{"class":671},[658,3503,733],{"class":679},[658,3505,684],{"class":683},[658,3507,766],{"class":675},[658,3509,3510,3512,3514,3516,3519,3521],{"class":660,"line":757},[658,3511,792],{"class":772},[658,3513,776],{"class":675},[658,3515,742],{"class":675},[658,3517,3518],{"class":690},"Invalid email format",[658,3520,687],{"class":675},[658,3522,786],{"class":675},[658,3524,3525,3527,3529,3532],{"class":660,"line":769},[658,3526,808],{"class":772},[658,3528,776],{"class":675},[658,3530,3531],{"class":813}," 400",[658,3533,786],{"class":675},[658,3535,3536,3538,3540,3542,3545,3547],{"class":660,"line":789},[658,3537,839],{"class":772},[658,3539,776],{"class":675},[658,3541,742],{"class":675},[658,3543,3544],{"class":690},"Please enter a valid email address",[658,3546,687],{"class":675},[658,3548,786],{"class":675},[658,3550,3551,3553],{"class":660,"line":805},[658,3552,873],{"class":675},[658,3554,696],{"class":683},[648,3556,3559],{"className":650,"code":3557,"filename":3558,"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,3560,3561,3566,3576,3591,3602,3617,3632],{"__ignoreMap":654},[658,3562,3563],{"class":660,"line":661},[658,3564,3565],{"class":664},"\u002F\u002F Authentication required\n",[658,3567,3568,3570,3572,3574],{"class":660,"line":668},[658,3569,672],{"class":671},[658,3571,733],{"class":679},[658,3573,684],{"class":683},[658,3575,766],{"class":675},[658,3577,3578,3580,3582,3584,3587,3589],{"class":660,"line":757},[658,3579,792],{"class":772},[658,3581,776],{"class":675},[658,3583,742],{"class":675},[658,3585,3586],{"class":690},"Please log in to continue",[658,3588,687],{"class":675},[658,3590,786],{"class":675},[658,3592,3593,3595,3597,3600],{"class":660,"line":769},[658,3594,808],{"class":772},[658,3596,776],{"class":675},[658,3598,3599],{"class":813}," 401",[658,3601,786],{"class":675},[658,3603,3604,3606,3608,3610,3613,3615],{"class":660,"line":789},[658,3605,839],{"class":772},[658,3607,776],{"class":675},[658,3609,742],{"class":675},[658,3611,3612],{"class":690},"Sign in to your account",[658,3614,687],{"class":675},[658,3616,786],{"class":675},[658,3618,3619,3621,3623,3625,3628,3630],{"class":660,"line":805},[658,3620,856],{"class":772},[658,3622,776],{"class":675},[658,3624,742],{"class":675},[658,3626,3627],{"class":690},"\u002Flogin",[658,3629,687],{"class":675},[658,3631,786],{"class":675},[658,3633,3634,3636],{"class":660,"line":819},[658,3635,873],{"class":675},[658,3637,696],{"class":683},[648,3639,3642],{"className":650,"code":3640,"filename":3641,"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,3643,3644,3649,3659,3674,3684],{"__ignoreMap":654},[658,3645,3646],{"class":660,"line":661},[658,3647,3648],{"class":664},"\u002F\u002F Resource not found\n",[658,3650,3651,3653,3655,3657],{"class":660,"line":668},[658,3652,672],{"class":671},[658,3654,733],{"class":679},[658,3656,684],{"class":683},[658,3658,766],{"class":675},[658,3660,3661,3663,3665,3667,3670,3672],{"class":660,"line":757},[658,3662,792],{"class":772},[658,3664,776],{"class":675},[658,3666,742],{"class":675},[658,3668,3669],{"class":690},"Order not found",[658,3671,687],{"class":675},[658,3673,786],{"class":675},[658,3675,3676,3678,3680,3682],{"class":660,"line":769},[658,3677,808],{"class":772},[658,3679,776],{"class":675},[658,3681,1433],{"class":813},[658,3683,786],{"class":675},[658,3685,3686,3688],{"class":660,"line":789},[658,3687,873],{"class":675},[658,3689,696],{"class":683},[648,3691,3694],{"className":650,"code":3692,"filename":3693,"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,3695,3696,3701,3711,3726,3736,3751,3756],{"__ignoreMap":654},[658,3697,3698],{"class":660,"line":661},[658,3699,3700],{"class":664},"\u002F\u002F Server error - not user's fault\n",[658,3702,3703,3705,3707,3709],{"class":660,"line":668},[658,3704,672],{"class":671},[658,3706,733],{"class":679},[658,3708,684],{"class":683},[658,3710,766],{"class":675},[658,3712,3713,3715,3717,3719,3722,3724],{"class":660,"line":757},[658,3714,792],{"class":772},[658,3716,776],{"class":675},[658,3718,742],{"class":675},[658,3720,3721],{"class":690},"Something went wrong",[658,3723,687],{"class":675},[658,3725,786],{"class":675},[658,3727,3728,3730,3732,3734],{"class":660,"line":769},[658,3729,808],{"class":772},[658,3731,776],{"class":675},[658,3733,1861],{"class":813},[658,3735,786],{"class":675},[658,3737,3738,3740,3742,3744,3747,3749],{"class":660,"line":789},[658,3739,822],{"class":772},[658,3741,776],{"class":675},[658,3743,742],{"class":675},[658,3745,3746],{"class":690},"Database connection timeout",[658,3748,687],{"class":675},[658,3750,786],{"class":675},[658,3752,3753],{"class":660,"line":805},[658,3754,3755],{"class":664},"  \u002F\u002F No 'fix' - user can't fix server errors\n",[658,3757,3758,3760],{"class":660,"line":819},[658,3759,873],{"class":675},[658,3761,696],{"class":683},[1366,3763,3765],{"id":3764},"provide-actionable-fixes","Provide Actionable Fixes",[716,3767,3768,3825],{},[648,3769,3772],{"className":650,"code":3770,"filename":3771,"language":653,"meta":654,"style":654},"\u002F\u002F Unhelpful fix\nthrow createError({\n  message: 'Upload failed',\n  fix: 'Try again',\n})\n","Bad",[539,3773,3774,3779,3789,3804,3819],{"__ignoreMap":654},[658,3775,3776],{"class":660,"line":661},[658,3777,3778],{"class":664},"\u002F\u002F Unhelpful fix\n",[658,3780,3781,3783,3785,3787],{"class":660,"line":668},[658,3782,672],{"class":671},[658,3784,733],{"class":679},[658,3786,684],{"class":683},[658,3788,766],{"class":675},[658,3790,3791,3793,3795,3797,3800,3802],{"class":660,"line":757},[658,3792,792],{"class":772},[658,3794,776],{"class":675},[658,3796,742],{"class":675},[658,3798,3799],{"class":690},"Upload failed",[658,3801,687],{"class":675},[658,3803,786],{"class":675},[658,3805,3806,3808,3810,3812,3815,3817],{"class":660,"line":769},[658,3807,839],{"class":772},[658,3809,776],{"class":675},[658,3811,742],{"class":675},[658,3813,3814],{"class":690},"Try again",[658,3816,687],{"class":675},[658,3818,786],{"class":675},[658,3820,3821,3823],{"class":660,"line":789},[658,3822,873],{"class":675},[658,3824,696],{"class":683},[648,3826,3829],{"className":650,"code":3827,"filename":3828,"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,3830,3831,3836,3846,3860,3871,3886,3901,3916],{"__ignoreMap":654},[658,3832,3833],{"class":660,"line":661},[658,3834,3835],{"class":664},"\u002F\u002F Actionable fix\n",[658,3837,3838,3840,3842,3844],{"class":660,"line":668},[658,3839,672],{"class":671},[658,3841,733],{"class":679},[658,3843,684],{"class":683},[658,3845,766],{"class":675},[658,3847,3848,3850,3852,3854,3856,3858],{"class":660,"line":757},[658,3849,792],{"class":772},[658,3851,776],{"class":675},[658,3853,742],{"class":675},[658,3855,3799],{"class":690},[658,3857,687],{"class":675},[658,3859,786],{"class":675},[658,3861,3862,3864,3866,3869],{"class":660,"line":769},[658,3863,808],{"class":772},[658,3865,776],{"class":675},[658,3867,3868],{"class":813}," 413",[658,3870,786],{"class":675},[658,3872,3873,3875,3877,3879,3882,3884],{"class":660,"line":789},[658,3874,822],{"class":772},[658,3876,776],{"class":675},[658,3878,742],{"class":675},[658,3880,3881],{"class":690},"File exceeds maximum size (10MB)",[658,3883,687],{"class":675},[658,3885,786],{"class":675},[658,3887,3888,3890,3892,3894,3897,3899],{"class":660,"line":805},[658,3889,839],{"class":772},[658,3891,776],{"class":675},[658,3893,742],{"class":675},[658,3895,3896],{"class":690},"Reduce the file size or compress the image before uploading",[658,3898,687],{"class":675},[658,3900,786],{"class":675},[658,3902,3903,3905,3907,3909,3912,3914],{"class":660,"line":819},[658,3904,856],{"class":772},[658,3906,776],{"class":675},[658,3908,742],{"class":675},[658,3910,3911],{"class":690},"\u002Fdocs\u002Fupload-limits",[658,3913,687],{"class":675},[658,3915,786],{"class":675},[658,3917,3918,3920],{"class":660,"line":836},[658,3919,873],{"class":675},[658,3921,696],{"class":683},[637,3923,3925],{"id":3924},"error-catalogs","Error Catalogs",[535,3927,3928,3929,3932,3933,3936,3937,3940,3941,3943,3944,3947,3948,3950],{},"For anything beyond a handful of one-off errors, group them in a typed ",[1156,3930,3931],{},"catalog",". evlog ships two primitives for this — ",[539,3934,3935],{},"defineError"," (single factory) and ",[539,3938,3939],{},"defineErrorCatalog"," (bundle prefixed). The wire ",[539,3942,539],{}," is auto-derived as ",[539,3945,3946],{},"${prefix}.${KEY}"," and the ",[539,3949,1349],{}," instance is built with all defaults applied.",[1366,3952,3954],{"id":3953},"defineerrorcatalog",[539,3955,3939],{},[535,3957,3958,3959,3962,3963,3966],{},"Define a bundle of errors that share a prefix. Convention: ",[539,3960,3961],{},"UPPER_SNAKE_CASE"," keys, ",[539,3964,3965],{},"lower.dot.case"," prefix.",[716,3968,3969,4267],{},[648,3970,3973],{"className":650,"code":3971,"filename":3972,"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,3974,3975,3994,3998,4026,4035,4045,4060,4064,4073,4083,4097,4111,4126,4142,4146,4155,4165,4209,4242,4257,4261],{"__ignoreMap":654},[658,3976,3977,3979,3981,3984,3986,3988,3990,3992],{"class":660,"line":661},[658,3978,727],{"class":671},[658,3980,730],{"class":675},[658,3982,3983],{"class":683}," defineErrorCatalog",[658,3985,736],{"class":675},[658,3987,739],{"class":671},[658,3989,742],{"class":675},[658,3991,745],{"class":690},[658,3993,748],{"class":675},[658,3995,3996],{"class":660,"line":668},[658,3997,754],{"emptyLinePlaceholder":753},[658,3999,4000,4003,4006,4009,4011,4013,4015,4017,4020,4022,4024],{"class":660,"line":757},[658,4001,4002],{"class":671},"export",[658,4004,4005],{"class":895}," const",[658,4007,4008],{"class":683}," billingErrors ",[658,4010,2905],{"class":675},[658,4012,3983],{"class":679},[658,4014,684],{"class":683},[658,4016,687],{"class":675},[658,4018,4019],{"class":690},"billing",[658,4021,687],{"class":675},[658,4023,1291],{"class":675},[658,4025,938],{"class":675},[658,4027,4028,4031,4033],{"class":660,"line":769},[658,4029,4030],{"class":772},"  CART_EMPTY",[658,4032,776],{"class":675},[658,4034,938],{"class":675},[658,4036,4037,4039,4041,4043],{"class":660,"line":789},[658,4038,1856],{"class":772},[658,4040,776],{"class":675},[658,4042,3531],{"class":813},[658,4044,786],{"class":675},[658,4046,4047,4049,4051,4053,4056,4058],{"class":660,"line":805},[658,4048,1840],{"class":772},[658,4050,776],{"class":675},[658,4052,742],{"class":675},[658,4054,4055],{"class":690},"Cart is empty",[658,4057,687],{"class":675},[658,4059,786],{"class":675},[658,4061,4062],{"class":660,"line":819},[658,4063,1299],{"class":675},[658,4065,4066,4069,4071],{"class":660,"line":836},[658,4067,4068],{"class":772},"  PAYMENT_DECLINED",[658,4070,776],{"class":675},[658,4072,938],{"class":675},[658,4074,4075,4077,4079,4081],{"class":660,"line":853},[658,4076,1856],{"class":772},[658,4078,776],{"class":675},[658,4080,814],{"class":813},[658,4082,786],{"class":675},[658,4084,4085,4087,4089,4091,4093,4095],{"class":660,"line":870},[658,4086,1840],{"class":772},[658,4088,776],{"class":675},[658,4090,742],{"class":675},[658,4092,2002],{"class":690},[658,4094,687],{"class":675},[658,4096,786],{"class":675},[658,4098,4099,4101,4103,4105,4107,4109],{"class":660,"line":1302},[658,4100,1868],{"class":772},[658,4102,776],{"class":675},[658,4104,742],{"class":675},[658,4106,2027],{"class":690},[658,4108,687],{"class":675},[658,4110,786],{"class":675},[658,4112,4113,4116,4118,4120,4122,4124],{"class":660,"line":1904},[658,4114,4115],{"class":772},"    fix",[658,4117,776],{"class":675},[658,4119,742],{"class":675},[658,4121,1591],{"class":690},[658,4123,687],{"class":675},[658,4125,786],{"class":675},[658,4127,4128,4131,4133,4135,4138,4140],{"class":660,"line":2544},[658,4129,4130],{"class":772},"    link",[658,4132,776],{"class":675},[658,4134,742],{"class":675},[658,4136,4137],{"class":690},"https:\u002F\u002Fdocs.example.com\u002Ferrors\u002Fbilling.payment_declined",[658,4139,687],{"class":675},[658,4141,786],{"class":675},[658,4143,4144],{"class":660,"line":2552},[658,4145,1299],{"class":675},[658,4147,4148,4151,4153],{"class":660,"line":2598},[658,4149,4150],{"class":772},"  INSUFFICIENT_FUNDS",[658,4152,776],{"class":675},[658,4154,938],{"class":675},[658,4156,4157,4159,4161,4163],{"class":660,"line":2603},[658,4158,1856],{"class":772},[658,4160,776],{"class":675},[658,4162,814],{"class":813},[658,4164,786],{"class":675},[658,4166,4167,4169,4171,4174,4178,4180,4183,4186,4188,4190,4192,4195,4197,4199,4201,4203,4206],{"class":660,"line":3131},[658,4168,1840],{"class":679},[658,4170,776],{"class":675},[658,4172,4173],{"class":675}," ({",[658,4175,4177],{"class":4176},"sHdIc"," available",[658,4179,1291],{"class":675},[658,4181,4182],{"class":4176}," required",[658,4184,4185],{"class":675}," }:",[658,4187,730],{"class":675},[658,4189,4177],{"class":772},[658,4191,776],{"class":675},[658,4193,4194],{"class":946}," number",[658,4196,1291],{"class":675},[658,4198,4182],{"class":772},[658,4200,776],{"class":675},[658,4202,4194],{"class":946},[658,4204,4205],{"class":675}," })",[658,4207,4208],{"class":895}," =>\n",[658,4210,4211,4214,4217,4220,4223,4225,4228,4230,4233,4235,4237,4240],{"class":660,"line":3138},[658,4212,4213],{"class":675},"      `",[658,4215,4216],{"class":690},"Insufficient funds: $",[658,4218,4219],{"class":675},"${",[658,4221,4222],{"class":683},"available",[658,4224,873],{"class":675},[658,4226,4227],{"class":690}," available, $",[658,4229,4219],{"class":675},[658,4231,4232],{"class":683},"required",[658,4234,873],{"class":675},[658,4236,4182],{"class":690},[658,4238,4239],{"class":675},"`",[658,4241,786],{"class":675},[658,4243,4244,4246,4248,4250,4253,4255],{"class":660,"line":3400},[658,4245,4115],{"class":772},[658,4247,776],{"class":675},[658,4249,742],{"class":675},[658,4251,4252],{"class":690},"Add funds and retry",[658,4254,687],{"class":675},[658,4256,786],{"class":675},[658,4258,4259],{"class":660,"line":3420},[658,4260,1299],{"class":675},[658,4262,4263,4265],{"class":660,"line":3450},[658,4264,873],{"class":675},[658,4266,696],{"class":683},[648,4268,4270],{"className":650,"code":4269,"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,4271,4272,4292,4296,4322,4342,4346,4381,4385,4392,4414,4418,4432,4481,4505,4521,4537,4552,4563,4570,4575,4583,4587],{"__ignoreMap":654},[658,4273,4274,4276,4278,4281,4283,4285,4287,4290],{"class":660,"line":661},[658,4275,727],{"class":671},[658,4277,730],{"class":675},[658,4279,4280],{"class":683}," billingErrors",[658,4282,736],{"class":675},[658,4284,739],{"class":671},[658,4286,742],{"class":675},[658,4288,4289],{"class":690},"~\u002Ferrors\u002Fbilling",[658,4291,748],{"class":675},[658,4293,4294],{"class":660,"line":668},[658,4295,754],{"emptyLinePlaceholder":753},[658,4297,4298,4300,4303,4306,4308,4311,4313,4316,4318,4320],{"class":660,"line":757},[658,4299,4002],{"class":671},[658,4301,4302],{"class":671}," default",[658,4304,4305],{"class":679}," defineEventHandler",[658,4307,684],{"class":683},[658,4309,4310],{"class":895},"async",[658,4312,2326],{"class":675},[658,4314,4315],{"class":4176},"event",[658,4317,1075],{"class":675},[658,4319,3097],{"class":895},[658,4321,938],{"class":675},[658,4323,4324,4326,4328,4330,4333,4336,4338,4340],{"class":660,"line":769},[658,4325,2457],{"class":895},[658,4327,2438],{"class":683},[658,4329,2463],{"class":675},[658,4331,4332],{"class":671}," await",[658,4334,4335],{"class":679}," getCart",[658,4337,684],{"class":772},[658,4339,4315],{"class":683},[658,4341,696],{"class":772},[658,4343,4344],{"class":660,"line":789},[658,4345,754],{"emptyLinePlaceholder":753},[658,4347,4348,4351,4353,4356,4358,4360,4363,4365,4368,4370,4372,4374,4376,4379],{"class":660,"line":805},[658,4349,4350],{"class":671},"  if",[658,4352,2326],{"class":772},[658,4354,4355],{"class":675},"!",[658,4357,1930],{"class":683},[658,4359,711],{"class":675},[658,4361,4362],{"class":683},"items",[658,4364,711],{"class":675},[658,4366,4367],{"class":683},"length",[658,4369,2492],{"class":772},[658,4371,672],{"class":671},[658,4373,4280],{"class":683},[658,4375,711],{"class":675},[658,4377,4378],{"class":679},"CART_EMPTY",[658,4380,2519],{"class":772},[658,4382,4383],{"class":660,"line":819},[658,4384,754],{"emptyLinePlaceholder":753},[658,4386,4387,4390],{"class":660,"line":836},[658,4388,4389],{"class":671},"  try",[658,4391,938],{"class":675},[658,4393,4394,4397,4399,4401,4403,4405,4407,4409,4412],{"class":660,"line":853},[658,4395,4396],{"class":671},"    await",[658,4398,1795],{"class":683},[658,4400,711],{"class":675},[658,4402,1810],{"class":679},[658,4404,684],{"class":772},[658,4406,1930],{"class":683},[658,4408,711],{"class":675},[658,4410,4411],{"class":683},"total",[658,4413,696],{"class":772},[658,4415,4416],{"class":660,"line":870},[658,4417,1016],{"class":675},[658,4419,4420,4423,4425,4428,4430],{"class":660,"line":1302},[658,4421,4422],{"class":671},"  catch",[658,4424,2326],{"class":772},[658,4426,4427],{"class":683},"e",[658,4429,2492],{"class":772},[658,4431,766],{"class":675},[658,4433,4434,4437,4439,4441,4443,4445,4448,4450,4453,4455,4457,4459,4461,4463,4465,4467,4469,4472,4474,4477,4479],{"class":660,"line":1904},[658,4435,4436],{"class":671},"    if",[658,4438,2326],{"class":772},[658,4440,4427],{"class":683},[658,4442,711],{"class":675},[658,4444,539],{"class":683},[658,4446,4447],{"class":675}," ===",[658,4449,742],{"class":675},[658,4451,4452],{"class":690},"card_declined",[658,4454,687],{"class":675},[658,4456,2492],{"class":772},[658,4458,672],{"class":671},[658,4460,4280],{"class":683},[658,4462,711],{"class":675},[658,4464,781],{"class":679},[658,4466,684],{"class":772},[658,4468,2567],{"class":675},[658,4470,4471],{"class":772}," cause",[658,4473,776],{"class":675},[658,4475,4476],{"class":683}," e",[658,4478,736],{"class":675},[658,4480,696],{"class":772},[658,4482,4483,4485,4487,4489,4491,4493,4495,4497,4499,4501,4503],{"class":660,"line":2544},[658,4484,4436],{"class":671},[658,4486,2326],{"class":772},[658,4488,4427],{"class":683},[658,4490,711],{"class":675},[658,4492,539],{"class":683},[658,4494,4447],{"class":675},[658,4496,742],{"class":675},[658,4498,1270],{"class":690},[658,4500,687],{"class":675},[658,4502,2492],{"class":772},[658,4504,766],{"class":675},[658,4506,4507,4510,4512,4514,4517,4519],{"class":660,"line":2552},[658,4508,4509],{"class":671},"      throw",[658,4511,4280],{"class":683},[658,4513,711],{"class":675},[658,4515,4516],{"class":679},"INSUFFICIENT_FUNDS",[658,4518,684],{"class":772},[658,4520,766],{"class":675},[658,4522,4523,4526,4528,4530,4532,4535],{"class":660,"line":2598},[658,4524,4525],{"class":772},"        available",[658,4527,776],{"class":675},[658,4529,4476],{"class":683},[658,4531,711],{"class":675},[658,4533,4534],{"class":683},"balance",[658,4536,786],{"class":675},[658,4538,4539,4542,4544,4546,4548,4550],{"class":660,"line":2603},[658,4540,4541],{"class":772},"        required",[658,4543,776],{"class":675},[658,4545,2438],{"class":683},[658,4547,711],{"class":675},[658,4549,4411],{"class":683},[658,4551,786],{"class":675},[658,4553,4554,4557,4559,4561],{"class":660,"line":3131},[658,4555,4556],{"class":772},"        cause",[658,4558,776],{"class":675},[658,4560,4476],{"class":683},[658,4562,786],{"class":675},[658,4564,4565,4568],{"class":660,"line":3138},[658,4566,4567],{"class":675},"      }",[658,4569,696],{"class":772},[658,4571,4572],{"class":660,"line":3400},[658,4573,4574],{"class":675},"    }\n",[658,4576,4577,4580],{"class":660,"line":3420},[658,4578,4579],{"class":671},"    throw",[658,4581,4582],{"class":683}," e\n",[658,4584,4585],{"class":660,"line":3450},[658,4586,1016],{"class":675},[658,4588,4589,4591],{"class":660,"line":3460},[658,4590,873],{"class":675},[658,4592,696],{"class":683},[535,4594,4595,4596,623,4599,4602,4603,4606],{},"Each entry becomes a typed factory. Catalog metadata is exposed on ",[539,4597,4598],{},"_codes",[539,4600,4601],{},"_prefix"," for introspection (non-enumerable so ",[539,4604,4605],{},"Object.keys(billingErrors)"," still returns just the entry names).",[648,4608,4610],{"className":650,"code":4609,"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,4611,4612,4629,4644,4653,4658,4663,4668,4673],{"__ignoreMap":654},[658,4613,4614,4617,4619,4621,4623,4626],{"class":660,"line":661},[658,4615,4616],{"class":683},"billingErrors",[658,4618,711],{"class":675},[658,4620,781],{"class":683},[658,4622,711],{"class":675},[658,4624,4625],{"class":683},"code   ",[658,4627,4628],{"class":664},"\u002F\u002F 'billing.PAYMENT_DECLINED'\n",[658,4630,4631,4633,4635,4637,4639,4642],{"class":660,"line":668},[658,4632,4616],{"class":683},[658,4634,711],{"class":675},[658,4636,781],{"class":683},[658,4638,711],{"class":675},[658,4640,4641],{"class":683},"status ",[658,4643,2797],{"class":664},[658,4645,4646,4648,4650],{"class":660,"line":757},[658,4647,4616],{"class":683},[658,4649,711],{"class":675},[658,4651,4652],{"class":683},"_codes\n",[658,4654,4655],{"class":660,"line":769},[658,4656,4657],{"class":664},"\u002F\u002F readonly [\n",[658,4659,4660],{"class":660,"line":789},[658,4661,4662],{"class":664},"\u002F\u002F   'billing.CART_EMPTY',\n",[658,4664,4665],{"class":660,"line":805},[658,4666,4667],{"class":664},"\u002F\u002F   'billing.PAYMENT_DECLINED',\n",[658,4669,4670],{"class":660,"line":819},[658,4671,4672],{"class":664},"\u002F\u002F   'billing.INSUFFICIENT_FUNDS',\n",[658,4674,4675],{"class":660,"line":836},[658,4676,4677],{"class":664},"\u002F\u002F ]\n",[1366,4679,4681],{"id":4680},"templated-messages-with-typed-params","Templated messages with typed params",[535,4683,4684,4685,4687,4688,4691],{},"Set ",[539,4686,580],{}," to a function and the params become ",[1156,4689,4690],{},"required and typed"," at the call site.",[648,4693,4695],{"className":650,"code":4694,"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,4696,4697,4722,4732,4757,4779,4794,4800,4804],{"__ignoreMap":654},[658,4698,4699,4701,4704,4706,4709,4711,4713,4716,4718,4720],{"class":660,"line":661},[658,4700,2899],{"class":895},[658,4702,4703],{"class":683}," InvoiceOverdue ",[658,4705,2905],{"class":675},[658,4707,4708],{"class":679}," defineError",[658,4710,684],{"class":683},[658,4712,687],{"class":675},[658,4714,4715],{"class":690},"billing.INVOICE_OVERDUE",[658,4717,687],{"class":675},[658,4719,1291],{"class":675},[658,4721,938],{"class":675},[658,4723,4724,4726,4728,4730],{"class":660,"line":668},[658,4725,808],{"class":772},[658,4727,776],{"class":675},[658,4729,814],{"class":813},[658,4731,786],{"class":675},[658,4733,4734,4736,4738,4740,4743,4745,4747,4749,4751,4753,4755],{"class":660,"line":757},[658,4735,792],{"class":679},[658,4737,776],{"class":675},[658,4739,4173],{"class":675},[658,4741,4742],{"class":4176}," daysOverdue",[658,4744,4185],{"class":675},[658,4746,730],{"class":675},[658,4748,4742],{"class":772},[658,4750,776],{"class":675},[658,4752,4194],{"class":946},[658,4754,4205],{"class":675},[658,4756,4208],{"class":895},[658,4758,4759,4762,4765,4767,4770,4772,4775,4777],{"class":660,"line":769},[658,4760,4761],{"class":675},"    `",[658,4763,4764],{"class":690},"Invoice overdue by ",[658,4766,4219],{"class":675},[658,4768,4769],{"class":683},"daysOverdue",[658,4771,873],{"class":675},[658,4773,4774],{"class":690}," day(s)",[658,4776,4239],{"class":675},[658,4778,786],{"class":675},[658,4780,4781,4783,4785,4787,4790,4792],{"class":660,"line":789},[658,4782,839],{"class":772},[658,4784,776],{"class":675},[658,4786,742],{"class":675},[658,4788,4789],{"class":690},"Pay outstanding invoice to resume service",[658,4791,687],{"class":675},[658,4793,786],{"class":675},[658,4795,4796,4798],{"class":660,"line":805},[658,4797,873],{"class":675},[658,4799,696],{"class":683},[658,4801,4802],{"class":660,"line":819},[658,4803,754],{"emptyLinePlaceholder":753},[658,4805,4806,4808,4811,4813,4815,4817,4819,4822,4824,4826],{"class":660,"line":836},[658,4807,672],{"class":671},[658,4809,4810],{"class":679}," InvoiceOverdue",[658,4812,684],{"class":683},[658,4814,2567],{"class":675},[658,4816,4742],{"class":772},[658,4818,776],{"class":675},[658,4820,4821],{"class":813}," 7",[658,4823,736],{"class":675},[658,4825,2492],{"class":683},[658,4827,4828],{"class":664},"\u002F\u002F params required and type-checked\n",[535,4830,4831,4832,571,4834,571,4836,571,4838,571,4840,571,4842,571,4844,4846,4847,4849],{},"You can still override any field at the call site (",[539,4833,580],{},[539,4835,599],{},[539,4837,584],{},[539,4839,588],{},[539,4841,592],{},[539,4843,1138],{},[539,4845,1126],{},"). Catalog defaults for ",[539,4848,1138],{}," are shallow-merged with call-site values (call-site wins on conflict).",[1366,4851,4853,4855],{"id":4852},"defineerror-standalone-factories",[539,4854,3935],{}," — standalone factories",[535,4857,4858,4859,4861],{},"For one-off errors that don't fit a catalog (or for very large repos that prefer one file per error), use ",[539,4860,3935],{}," directly. Same factory shape as a catalog entry, no prefix derivation.",[648,4863,4865],{"className":650,"code":4864,"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,4866,4867,4872,4890,4894,4920,4931,4946,4961,4976,4982,4986],{"__ignoreMap":654},[658,4868,4869],{"class":660,"line":661},[658,4870,4871],{"class":664},"\u002F\u002F errors\u002FFraudDetected.ts\n",[658,4873,4874,4876,4878,4880,4882,4884,4886,4888],{"class":660,"line":668},[658,4875,727],{"class":671},[658,4877,730],{"class":675},[658,4879,4708],{"class":683},[658,4881,736],{"class":675},[658,4883,739],{"class":671},[658,4885,742],{"class":675},[658,4887,745],{"class":690},[658,4889,748],{"class":675},[658,4891,4892],{"class":660,"line":757},[658,4893,754],{"emptyLinePlaceholder":753},[658,4895,4896,4898,4900,4903,4905,4907,4909,4911,4914,4916,4918],{"class":660,"line":769},[658,4897,4002],{"class":671},[658,4899,4005],{"class":895},[658,4901,4902],{"class":683}," FraudDetected ",[658,4904,2905],{"class":675},[658,4906,4708],{"class":679},[658,4908,684],{"class":683},[658,4910,687],{"class":675},[658,4912,4913],{"class":690},"billing.FRAUD_DETECTED",[658,4915,687],{"class":675},[658,4917,1291],{"class":675},[658,4919,938],{"class":675},[658,4921,4922,4924,4926,4929],{"class":660,"line":789},[658,4923,808],{"class":772},[658,4925,776],{"class":675},[658,4927,4928],{"class":813}," 403",[658,4930,786],{"class":675},[658,4932,4933,4935,4937,4939,4942,4944],{"class":660,"line":805},[658,4934,792],{"class":772},[658,4936,776],{"class":675},[658,4938,742],{"class":675},[658,4940,4941],{"class":690},"Transaction flagged for review",[658,4943,687],{"class":675},[658,4945,786],{"class":675},[658,4947,4948,4950,4952,4954,4957,4959],{"class":660,"line":819},[658,4949,822],{"class":772},[658,4951,776],{"class":675},[658,4953,742],{"class":675},[658,4955,4956],{"class":690},"ML fraud-score above threshold",[658,4958,687],{"class":675},[658,4960,786],{"class":675},[658,4962,4963,4965,4967,4969,4972,4974],{"class":660,"line":836},[658,4964,839],{"class":772},[658,4966,776],{"class":675},[658,4968,742],{"class":675},[658,4970,4971],{"class":690},"Contact support to verify your identity",[658,4973,687],{"class":675},[658,4975,786],{"class":675},[658,4977,4978,4980],{"class":660,"line":853},[658,4979,873],{"class":675},[658,4981,696],{"class":683},[658,4983,4984],{"class":660,"line":870},[658,4985,754],{"emptyLinePlaceholder":753},[658,4987,4988,4990,4993],{"class":660,"line":1302},[658,4989,672],{"class":671},[658,4991,4992],{"class":679}," FraudDetected",[658,4994,2519],{"class":683},[1366,4996,4998],{"id":4997},"type-safe-codes-everywhere-opt-in","Type-safe codes everywhere (opt-in)",[535,5000,5001,5002,5005,5006,571,5009,5012,5013,5015],{},"Augment the ",[539,5003,5004],{},"RegisteredErrorCatalogs"," interface to make every registered code surface as autocomplete on ",[539,5007,5008],{},"createError({ code })",[539,5010,5011],{},"parseError(err).code",", and any other typed ",[539,5014,539],{}," field across the codebase.",[716,5017,5018,5133],{},[648,5019,5022],{"className":650,"code":5020,"filename":5021,"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,5023,5024,5046,5069,5073,5089,5099,5112,5125,5129],{"__ignoreMap":654},[658,5025,5026,5028,5031,5033,5035,5037,5039,5041,5044],{"class":660,"line":661},[658,5027,727],{"class":671},[658,5029,5030],{"class":671}," type",[658,5032,730],{"class":675},[658,5034,4280],{"class":683},[658,5036,736],{"class":675},[658,5038,739],{"class":671},[658,5040,742],{"class":675},[658,5042,5043],{"class":690},".\u002Fbilling",[658,5045,748],{"class":675},[658,5047,5048,5050,5052,5054,5057,5059,5062,5064,5067],{"class":660,"line":668},[658,5049,727],{"class":671},[658,5051,5030],{"class":671},[658,5053,730],{"class":675},[658,5055,5056],{"class":683}," authErrors",[658,5058,736],{"class":675},[658,5060,5061],{"class":671},"    from",[658,5063,742],{"class":675},[658,5065,5066],{"class":690},".\u002Fauth",[658,5068,748],{"class":675},[658,5070,5071],{"class":660,"line":757},[658,5072,754],{"emptyLinePlaceholder":753},[658,5074,5075,5078,5081,5083,5085,5087],{"class":660,"line":769},[658,5076,5077],{"class":895},"declare",[658,5079,5080],{"class":895}," module",[658,5082,742],{"class":675},[658,5084,745],{"class":690},[658,5086,687],{"class":675},[658,5088,938],{"class":675},[658,5090,5091,5094,5097],{"class":660,"line":789},[658,5092,5093],{"class":895},"  interface",[658,5095,5096],{"class":946}," RegisteredErrorCatalogs",[658,5098,938],{"class":675},[658,5100,5101,5104,5106,5109],{"class":660,"line":805},[658,5102,5103],{"class":772},"    billing",[658,5105,776],{"class":675},[658,5107,5108],{"class":675}," typeof",[658,5110,5111],{"class":683}," billingErrors\n",[658,5113,5114,5117,5119,5122],{"class":660,"line":819},[658,5115,5116],{"class":772},"    auth",[658,5118,776],{"class":675},[658,5120,5121],{"class":675},"    typeof",[658,5123,5124],{"class":683}," authErrors\n",[658,5126,5127],{"class":660,"line":836},[658,5128,1016],{"class":675},[658,5130,5131],{"class":660,"line":853},[658,5132,1021],{"class":675},[648,5134,5137],{"className":650,"code":5135,"filename":5136,"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,5138,5139,5144,5154,5172,5186,5196,5202,5206,5211,5225,5254],{"__ignoreMap":654},[658,5140,5141],{"class":660,"line":661},[658,5142,5143],{"class":664},"\u002F\u002F createError autocompletes registered codes (and still accepts ad-hoc strings)\n",[658,5145,5146,5148,5150,5152],{"class":660,"line":668},[658,5147,672],{"class":671},[658,5149,733],{"class":679},[658,5151,684],{"class":683},[658,5153,766],{"class":675},[658,5155,5156,5158,5160,5162,5165,5167,5169],{"class":660,"line":757},[658,5157,773],{"class":772},[658,5159,776],{"class":675},[658,5161,742],{"class":675},[658,5163,5164],{"class":690},"billing.PAYMENT_DECLINED",[658,5166,687],{"class":675},[658,5168,1291],{"class":675},[658,5170,5171],{"class":664}," \u002F\u002F ← autocomplete, TS error if typo\n",[658,5173,5174,5176,5178,5180,5182,5184],{"class":660,"line":769},[658,5175,792],{"class":772},[658,5177,776],{"class":675},[658,5179,742],{"class":675},[658,5181,2002],{"class":690},[658,5183,687],{"class":675},[658,5185,786],{"class":675},[658,5187,5188,5190,5192,5194],{"class":660,"line":789},[658,5189,808],{"class":772},[658,5191,776],{"class":675},[658,5193,814],{"class":813},[658,5195,786],{"class":675},[658,5197,5198,5200],{"class":660,"line":805},[658,5199,873],{"class":675},[658,5201,696],{"class":683},[658,5203,5204],{"class":660,"line":819},[658,5205,754],{"emptyLinePlaceholder":753},[658,5207,5208],{"class":660,"line":836},[658,5209,5210],{"class":664},"\u002F\u002F parseError().code is typed as the union of all registered codes\n",[658,5212,5213,5215,5218,5220,5222],{"class":660,"line":853},[658,5214,2899],{"class":895},[658,5216,5217],{"class":683}," err ",[658,5219,2905],{"class":675},[658,5221,2376],{"class":679},[658,5223,5224],{"class":683},"(caught)\n",[658,5226,5227,5230,5233,5235,5238,5241,5243,5245,5247,5249,5252],{"class":660,"line":870},[658,5228,5229],{"class":671},"if",[658,5231,5232],{"class":683}," (err",[658,5234,711],{"class":675},[658,5236,5237],{"class":683},"code ",[658,5239,5240],{"class":675},"===",[658,5242,742],{"class":675},[658,5244,5164],{"class":690},[658,5246,687],{"class":675},[658,5248,2492],{"class":683},[658,5250,5251],{"class":679},"retry",[658,5253,2519],{"class":683},[658,5255,5256],{"class":660,"line":1302},[658,5257,5258],{"class":664},"\u002F\u002F                ↑ autocomplete, refactor-safe\n",[535,5260,5261],{},"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.",[5263,5264,5267,5270,5271,5274,5275,5278,5279,5282,5283,5286],"callout",{"color":5265,"icon":5266},"neutral","i-lucide-package",[1156,5268,5269],{},"Packaging tip."," A catalog is regular TypeScript. Publish ",[539,5272,5273],{},"@acme\u002Ferrors-billing"," exporting your ",[539,5276,5277],{},"defineErrorCatalog(...)"," plus the ",[539,5280,5281],{},"declare module 'evlog'"," augmentation in its ",[539,5284,5285],{},"index.d.ts",", and the typing flows transitively to every consumer that depends on it. Each shared package owns its prefix, no conflicts possible.",[5263,5288,5291,5294,5295,5298],{"color":5289,"icon":5290,"to":77},"primary","i-lucide-arrow-right",[1156,5292,5293],{},"Going further."," The dedicated ",[631,5296,5297],{"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.",[5263,5300,5301,5302,5305],{"color":5265,"icon":334},"See the ",[631,5303,5304],{"href":236},"Next.js guide"," for a working implementation.",[637,5307,5309],{"id":5308},"next-steps","Next Steps",[552,5311,5312,5317,5322,5327],{},[555,5313,5314,5316],{},[631,5315,46],{"href":47},": Accumulate context and emit comprehensive events",[555,5318,5319,5321],{},[631,5320,138],{"href":143},": Send errors and events to Axiom, Sentry, PostHog, and more",[555,5323,5324,5326],{},[631,5325,221],{"href":226},": Auto-managed request logging per framework",[555,5328,5329,5331],{},[631,5330,25],{"href":26},": See all evlog APIs in action",[5333,5334,5335],"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":5337},[5338,5339,5340,5342,5347,5350,5352,5355,5359,5366],{"id":639,"depth":668,"text":640},{"id":1024,"depth":668,"text":1025},{"id":1146,"depth":668,"text":5341},"Backend-only context (internal)",{"id":1363,"depth":668,"text":1364,"children":5343},[5344,5345,5346],{"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":5348},[5349],{"id":2252,"depth":757,"text":2253},{"id":2347,"depth":668,"text":5351},"Branching on code",{"id":2640,"depth":668,"text":2641,"children":5353},[5354],{"id":3143,"depth":757,"text":3144},{"id":3480,"depth":668,"text":517,"children":5356},[5357,5358],{"id":3483,"depth":757,"text":3484},{"id":3764,"depth":757,"text":3765},{"id":3924,"depth":668,"text":3925,"children":5360},[5361,5362,5363,5365],{"id":3953,"depth":757,"text":3939},{"id":4680,"depth":757,"text":4681},{"id":4852,"depth":757,"text":5364},"defineError — standalone factories",{"id":4997,"depth":757,"text":4998},{"id":5308,"depth":668,"text":5309},"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",[5370,5372],{"label":46,"icon":49,"to":47,"color":5265,"variant":5371},"subtle",{"label":517,"icon":379,"to":518,"color":5265,"variant":5371},{},{"icon":54},{"title":51,"description":5367},"PNTJ0TZbufUexeqSBn1pMGbBvbklhkS2RJ8T6CZr60I",[5378,5380],{"title":46,"path":47,"stem":48,"description":5379,"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":5381,"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.",1786286572484]