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