[{"data":1,"prerenderedAt":3742},["ShallowReactive",2],{"navigation_docs":3,"-examples-nextjs":171,"-examples-nextjs-surround":3737},[4,30,55,105,122,136],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","/getting-started","1.getting-started",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","/getting-started/introduction","1.getting-started/1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Installation","/getting-started/installation","1.getting-started/2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Quick Start","/getting-started/quick-start","1.getting-started/3.quick-start","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Agent Skills","/getting-started/agent-skills","1.getting-started/4.agent-skills","i-lucide-sparkles",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Core Concepts","/core-concepts","2.core-concepts",[35,40,45,50],{"title":36,"path":37,"stem":38,"icon":39},"Wide Events","/core-concepts/wide-events","2.core-concepts/1.wide-events","i-lucide-layers",{"title":41,"path":42,"stem":43,"icon":44},"Structured Errors","/core-concepts/structured-errors","2.core-concepts/2.structured-errors","i-lucide-shield-alert",{"title":46,"path":47,"stem":48,"icon":49},"Best Practices","/core-concepts/best-practices","2.core-concepts/3.best-practices","i-lucide-shield-check",{"title":51,"path":52,"stem":53,"icon":54},"Typed Fields","/core-concepts/typed-fields","2.core-concepts/4.typed-fields","i-simple-icons-typescript",{"title":56,"path":57,"stem":58,"children":59,"page":29},"Adapters","/adapters","3.adapters",[60,65,70,75,80,85,90,95,100],{"title":61,"path":62,"stem":63,"icon":64},"Overview","/adapters/overview","3.adapters/1.overview","i-custom-plug",{"title":66,"path":67,"stem":68,"icon":69},"Axiom","/adapters/axiom","3.adapters/2.axiom","i-custom-axiom",{"title":71,"path":72,"stem":73,"icon":74},"OTLP","/adapters/otlp","3.adapters/3.otlp","i-simple-icons-opentelemetry",{"title":76,"path":77,"stem":78,"icon":79},"PostHog","/adapters/posthog","3.adapters/4.posthog","i-simple-icons-posthog",{"title":81,"path":82,"stem":83,"icon":84},"Sentry","/adapters/sentry","3.adapters/5.sentry","i-simple-icons-sentry",{"title":86,"path":87,"stem":88,"icon":89},"Better Stack","/adapters/better-stack","3.adapters/6.better-stack","i-simple-icons-betterstack",{"title":91,"path":92,"stem":93,"icon":94},"Custom Adapters","/adapters/custom","3.adapters/7.custom","i-lucide-code",{"title":96,"path":97,"stem":98,"icon":99},"Pipeline","/adapters/pipeline","3.adapters/8.pipeline","i-lucide-workflow",{"title":101,"path":102,"stem":103,"icon":104},"Browser","/adapters/browser","3.adapters/9.browser","i-lucide-globe",{"title":106,"path":107,"stem":108,"children":109,"page":29},"Enrichers","/enrichers","4.enrichers",[110,113,118],{"title":61,"path":111,"stem":112,"icon":28},"/enrichers/overview","4.enrichers/1.overview",{"title":114,"path":115,"stem":116,"icon":117},"Built-in","/enrichers/built-in","4.enrichers/2.built-in","i-lucide-puzzle",{"title":119,"path":120,"stem":121,"icon":94},"Custom","/enrichers/custom","4.enrichers/3.custom",{"title":123,"path":124,"stem":125,"children":126,"page":29},"NuxtHub","/nuxthub","5.nuxthub",[127,131],{"title":61,"path":128,"stem":129,"icon":130},"/nuxthub/overview","5.nuxthub/1.overview","i-lucide-database",{"title":132,"path":133,"stem":134,"icon":135},"Retention","/nuxthub/retention","5.nuxthub/2.retention","i-lucide-clock",{"title":137,"path":138,"stem":139,"children":140,"page":29},"Examples","/examples","6.examples",[141,146,151,156,161,166],{"title":142,"path":143,"stem":144,"icon":145},"Next.js","/examples/nextjs","6.examples/1.nextjs","i-simple-icons-nextdotjs",{"title":147,"path":148,"stem":149,"icon":150},"TanStack Start","/examples/tanstack-start","6.examples/2.tanstack-start","i-custom-tanstack",{"title":152,"path":153,"stem":154,"icon":155},"Hono","/examples/hono","6.examples/3.hono","i-simple-icons-hono",{"title":157,"path":158,"stem":159,"icon":160},"Express","/examples/express","6.examples/4.express","i-simple-icons-express",{"title":162,"path":163,"stem":164,"icon":165},"Elysia","/examples/elysia","6.examples/5.elysia","i-custom-elysia",{"title":167,"path":168,"stem":169,"icon":170},"Fastify","/examples/fastify","6.examples/6.fastify","i-simple-icons-fastify",{"id":172,"title":142,"body":173,"description":3727,"extension":3728,"links":3729,"meta":3733,"navigation":3734,"path":143,"seo":3735,"stem":144,"__hash__":3736},"docs/6.examples/1.nextjs.md",{"type":174,"value":175,"toc":3714},"minimark",[176,180,185,193,1089,1092,1095,1485,1488,1570,1574,1593,2064,2074,2200,2203,2270,2275,2288,2591,2604,2608,2611,2836,2843,2847,2861,2947,2962,2966,2973,3161,3165,3171,3415,3419,3425,3556,3559,3644,3648,3690,3700,3710],[177,178,179],"p",{},"Practical patterns for using evlog with Next.js (App Router). Each section shows how to activate a feature and the recommended way to use it.",[181,182,184],"h2",{"id":183},"production-configuration","Production Configuration",[177,186,187,188,192],{},"A real-world ",[189,190,191],"code",{},"lib/evlog.ts"," with enrichers, batched drain, tail sampling, and route-based service names:",[194,195,200],"pre",{"className":196,"code":197,"filename":191,"language":198,"meta":199,"style":199},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import type { DrainContext } from 'evlog'\nimport { createEvlog } from 'evlog/next'\nimport { createUserAgentEnricher, createRequestSizeEnricher } from 'evlog/enrichers'\nimport { createAxiomDrain } from 'evlog/axiom'\nimport { createDrainPipeline } from 'evlog/pipeline'\n\n// 1. Enrichers — add derived context to every event\nconst enrichers = [createUserAgentEnricher(), createRequestSizeEnricher()]\n\n// 2. Pipeline — batch events before sending\nconst pipeline = createDrainPipeline\u003CDrainContext>({ batch: { size: 50, intervalMs: 5000 } })\n\n// 3. Drain — send batched events to Axiom\nconst drain = pipeline(createAxiomDrain({\n  dataset: 'logs',\n  token: process.env.AXIOM_TOKEN!,\n}))\n\nexport const { withEvlog, useLogger, log, createError } = createEvlog({\n  service: 'my-app',\n\n  // 4. Head sampling — keep 10% of info logs\n  sampling: {\n    rates: { info: 10 },\n    keep: [\n      { status: 400 },              // Always keep errors\n      { duration: 1000 },           // Always keep slow requests\n      { path: '/api/critical/**' }, // Always keep critical paths\n    ],\n  },\n\n  // 5. Route-based service names\n  routes: {\n    '/api/auth/**': { service: 'auth-service' },\n    '/api/payment/**': { service: 'payment-service' },\n    '/api/booking/**': { service: 'booking-service' },\n  },\n\n  // 6. Custom tail sampling — business logic\n  keep: (ctx) => {\n    const user = ctx.context.user as { premium?: boolean } | undefined\n    if (user?.premium) ctx.shouldKeep = true\n  },\n\n  // 7. Enrich every event with user agent, request size, and deployment info\n  enrich: (ctx) => {\n    for (const enricher of enrichers) enricher(ctx)\n    ctx.event.deploymentId = process.env.VERCEL_DEPLOYMENT_ID\n    ctx.event.region = process.env.VERCEL_REGION\n  },\n\n  drain,\n})\n","typescript","",[189,201,202,238,259,286,307,328,335,342,372,377,383,446,451,457,480,499,524,533,538,578,595,600,606,617,638,649,669,687,709,717,723,728,734,744,773,800,827,832,837,843,866,912,944,949,954,960,978,1008,1037,1064,1069,1074,1082],{"__ignoreMap":199},[203,204,207,211,214,218,222,225,228,231,235],"span",{"class":205,"line":206},"line",1,[203,208,210],{"class":209},"s7zQu","import",[203,212,213],{"class":209}," type",[203,215,217],{"class":216},"sMK4o"," {",[203,219,221],{"class":220},"sTEyZ"," DrainContext",[203,223,224],{"class":216}," }",[203,226,227],{"class":209}," from",[203,229,230],{"class":216}," '",[203,232,234],{"class":233},"sfazB","evlog",[203,236,237],{"class":216},"'\n",[203,239,241,243,245,248,250,252,254,257],{"class":205,"line":240},2,[203,242,210],{"class":209},[203,244,217],{"class":216},[203,246,247],{"class":220}," createEvlog",[203,249,224],{"class":216},[203,251,227],{"class":209},[203,253,230],{"class":216},[203,255,256],{"class":233},"evlog/next",[203,258,237],{"class":216},[203,260,262,264,266,269,272,275,277,279,281,284],{"class":205,"line":261},3,[203,263,210],{"class":209},[203,265,217],{"class":216},[203,267,268],{"class":220}," createUserAgentEnricher",[203,270,271],{"class":216},",",[203,273,274],{"class":220}," createRequestSizeEnricher",[203,276,224],{"class":216},[203,278,227],{"class":209},[203,280,230],{"class":216},[203,282,283],{"class":233},"evlog/enrichers",[203,285,237],{"class":216},[203,287,289,291,293,296,298,300,302,305],{"class":205,"line":288},4,[203,290,210],{"class":209},[203,292,217],{"class":216},[203,294,295],{"class":220}," createAxiomDrain",[203,297,224],{"class":216},[203,299,227],{"class":209},[203,301,230],{"class":216},[203,303,304],{"class":233},"evlog/axiom",[203,306,237],{"class":216},[203,308,310,312,314,317,319,321,323,326],{"class":205,"line":309},5,[203,311,210],{"class":209},[203,313,217],{"class":216},[203,315,316],{"class":220}," createDrainPipeline",[203,318,224],{"class":216},[203,320,227],{"class":209},[203,322,230],{"class":216},[203,324,325],{"class":233},"evlog/pipeline",[203,327,237],{"class":216},[203,329,331],{"class":205,"line":330},6,[203,332,334],{"emptyLinePlaceholder":333},true,"\n",[203,336,338],{"class":205,"line":337},7,[203,339,341],{"class":340},"sHwdD","// 1. Enrichers — add derived context to every event\n",[203,343,345,349,352,355,358,362,365,367,369],{"class":205,"line":344},8,[203,346,348],{"class":347},"spNyl","const",[203,350,351],{"class":220}," enrichers ",[203,353,354],{"class":216},"=",[203,356,357],{"class":220}," [",[203,359,361],{"class":360},"s2Zo4","createUserAgentEnricher",[203,363,364],{"class":220},"()",[203,366,271],{"class":216},[203,368,274],{"class":360},[203,370,371],{"class":220},"()]\n",[203,373,375],{"class":205,"line":374},9,[203,376,334],{"emptyLinePlaceholder":333},[203,378,380],{"class":205,"line":379},10,[203,381,382],{"class":340},"// 2. Pipeline — batch events before sending\n",[203,384,386,388,391,393,395,398,402,405,408,411,415,418,420,423,425,429,431,434,436,439,441,443],{"class":205,"line":385},11,[203,387,348],{"class":347},[203,389,390],{"class":220}," pipeline ",[203,392,354],{"class":216},[203,394,316],{"class":360},[203,396,397],{"class":216},"\u003C",[203,399,401],{"class":400},"sBMFI","DrainContext",[203,403,404],{"class":216},">",[203,406,407],{"class":220},"(",[203,409,410],{"class":216},"{",[203,412,414],{"class":413},"swJcz"," batch",[203,416,417],{"class":216},":",[203,419,217],{"class":216},[203,421,422],{"class":413}," size",[203,424,417],{"class":216},[203,426,428],{"class":427},"sbssI"," 50",[203,430,271],{"class":216},[203,432,433],{"class":413}," intervalMs",[203,435,417],{"class":216},[203,437,438],{"class":427}," 5000",[203,440,224],{"class":216},[203,442,224],{"class":216},[203,444,445],{"class":220},")\n",[203,447,449],{"class":205,"line":448},12,[203,450,334],{"emptyLinePlaceholder":333},[203,452,454],{"class":205,"line":453},13,[203,455,456],{"class":340},"// 3. Drain — send batched events to Axiom\n",[203,458,460,462,465,467,470,472,475,477],{"class":205,"line":459},14,[203,461,348],{"class":347},[203,463,464],{"class":220}," drain ",[203,466,354],{"class":216},[203,468,469],{"class":360}," pipeline",[203,471,407],{"class":220},[203,473,474],{"class":360},"createAxiomDrain",[203,476,407],{"class":220},[203,478,479],{"class":216},"{\n",[203,481,483,486,488,490,493,496],{"class":205,"line":482},15,[203,484,485],{"class":413},"  dataset",[203,487,417],{"class":216},[203,489,230],{"class":216},[203,491,492],{"class":233},"logs",[203,494,495],{"class":216},"'",[203,497,498],{"class":216},",\n",[203,500,502,505,507,510,513,516,518,521],{"class":205,"line":501},16,[203,503,504],{"class":413},"  token",[203,506,417],{"class":216},[203,508,509],{"class":220}," process",[203,511,512],{"class":216},".",[203,514,515],{"class":220},"env",[203,517,512],{"class":216},[203,519,520],{"class":220},"AXIOM_TOKEN",[203,522,523],{"class":216},"!,\n",[203,525,527,530],{"class":205,"line":526},17,[203,528,529],{"class":216},"}",[203,531,532],{"class":220},"))\n",[203,534,536],{"class":205,"line":535},18,[203,537,334],{"emptyLinePlaceholder":333},[203,539,541,544,547,549,552,554,557,559,562,564,567,569,572,574,576],{"class":205,"line":540},19,[203,542,543],{"class":209},"export",[203,545,546],{"class":347}," const",[203,548,217],{"class":216},[203,550,551],{"class":220}," withEvlog",[203,553,271],{"class":216},[203,555,556],{"class":220}," useLogger",[203,558,271],{"class":216},[203,560,561],{"class":220}," log",[203,563,271],{"class":216},[203,565,566],{"class":220}," createError ",[203,568,529],{"class":216},[203,570,571],{"class":216}," =",[203,573,247],{"class":360},[203,575,407],{"class":220},[203,577,479],{"class":216},[203,579,581,584,586,588,591,593],{"class":205,"line":580},20,[203,582,583],{"class":413},"  service",[203,585,417],{"class":216},[203,587,230],{"class":216},[203,589,590],{"class":233},"my-app",[203,592,495],{"class":216},[203,594,498],{"class":216},[203,596,598],{"class":205,"line":597},21,[203,599,334],{"emptyLinePlaceholder":333},[203,601,603],{"class":205,"line":602},22,[203,604,605],{"class":340},"  // 4. Head sampling — keep 10% of info logs\n",[203,607,609,612,614],{"class":205,"line":608},23,[203,610,611],{"class":413},"  sampling",[203,613,417],{"class":216},[203,615,616],{"class":216}," {\n",[203,618,620,623,625,627,630,632,635],{"class":205,"line":619},24,[203,621,622],{"class":413},"    rates",[203,624,417],{"class":216},[203,626,217],{"class":216},[203,628,629],{"class":413}," info",[203,631,417],{"class":216},[203,633,634],{"class":427}," 10",[203,636,637],{"class":216}," },\n",[203,639,641,644,646],{"class":205,"line":640},25,[203,642,643],{"class":413},"    keep",[203,645,417],{"class":216},[203,647,648],{"class":220}," [\n",[203,650,652,655,658,660,663,666],{"class":205,"line":651},26,[203,653,654],{"class":216},"      {",[203,656,657],{"class":413}," status",[203,659,417],{"class":216},[203,661,662],{"class":427}," 400",[203,664,665],{"class":216}," },",[203,667,668],{"class":340},"              // Always keep errors\n",[203,670,672,674,677,679,682,684],{"class":205,"line":671},27,[203,673,654],{"class":216},[203,675,676],{"class":413}," duration",[203,678,417],{"class":216},[203,680,681],{"class":427}," 1000",[203,683,665],{"class":216},[203,685,686],{"class":340},"           // Always keep slow requests\n",[203,688,690,692,695,697,699,702,704,706],{"class":205,"line":689},28,[203,691,654],{"class":216},[203,693,694],{"class":413}," path",[203,696,417],{"class":216},[203,698,230],{"class":216},[203,700,701],{"class":233},"/api/critical/**",[203,703,495],{"class":216},[203,705,665],{"class":216},[203,707,708],{"class":340}," // Always keep critical paths\n",[203,710,712,715],{"class":205,"line":711},29,[203,713,714],{"class":220},"    ]",[203,716,498],{"class":216},[203,718,720],{"class":205,"line":719},30,[203,721,722],{"class":216},"  },\n",[203,724,726],{"class":205,"line":725},31,[203,727,334],{"emptyLinePlaceholder":333},[203,729,731],{"class":205,"line":730},32,[203,732,733],{"class":340},"  // 5. Route-based service names\n",[203,735,737,740,742],{"class":205,"line":736},33,[203,738,739],{"class":413},"  routes",[203,741,417],{"class":216},[203,743,616],{"class":216},[203,745,747,750,753,755,757,759,762,764,766,769,771],{"class":205,"line":746},34,[203,748,749],{"class":216},"    '",[203,751,752],{"class":413},"/api/auth/**",[203,754,495],{"class":216},[203,756,417],{"class":216},[203,758,217],{"class":216},[203,760,761],{"class":413}," service",[203,763,417],{"class":216},[203,765,230],{"class":216},[203,767,768],{"class":233},"auth-service",[203,770,495],{"class":216},[203,772,637],{"class":216},[203,774,776,778,781,783,785,787,789,791,793,796,798],{"class":205,"line":775},35,[203,777,749],{"class":216},[203,779,780],{"class":413},"/api/payment/**",[203,782,495],{"class":216},[203,784,417],{"class":216},[203,786,217],{"class":216},[203,788,761],{"class":413},[203,790,417],{"class":216},[203,792,230],{"class":216},[203,794,795],{"class":233},"payment-service",[203,797,495],{"class":216},[203,799,637],{"class":216},[203,801,803,805,808,810,812,814,816,818,820,823,825],{"class":205,"line":802},36,[203,804,749],{"class":216},[203,806,807],{"class":413},"/api/booking/**",[203,809,495],{"class":216},[203,811,417],{"class":216},[203,813,217],{"class":216},[203,815,761],{"class":413},[203,817,417],{"class":216},[203,819,230],{"class":216},[203,821,822],{"class":233},"booking-service",[203,824,495],{"class":216},[203,826,637],{"class":216},[203,828,830],{"class":205,"line":829},37,[203,831,722],{"class":216},[203,833,835],{"class":205,"line":834},38,[203,836,334],{"emptyLinePlaceholder":333},[203,838,840],{"class":205,"line":839},39,[203,841,842],{"class":340},"  // 6. Custom tail sampling — business logic\n",[203,844,846,849,851,854,858,861,864],{"class":205,"line":845},40,[203,847,848],{"class":360},"  keep",[203,850,417],{"class":216},[203,852,853],{"class":216}," (",[203,855,857],{"class":856},"sHdIc","ctx",[203,859,860],{"class":216},")",[203,862,863],{"class":347}," =>",[203,865,616],{"class":216},[203,867,869,872,875,877,880,882,885,887,890,893,895,898,901,904,906,909],{"class":205,"line":868},41,[203,870,871],{"class":347},"    const",[203,873,874],{"class":220}," user",[203,876,571],{"class":216},[203,878,879],{"class":220}," ctx",[203,881,512],{"class":216},[203,883,884],{"class":220},"context",[203,886,512],{"class":216},[203,888,889],{"class":220},"user",[203,891,892],{"class":209}," as",[203,894,217],{"class":216},[203,896,897],{"class":413}," premium",[203,899,900],{"class":216},"?:",[203,902,903],{"class":400}," boolean",[203,905,224],{"class":216},[203,907,908],{"class":216}," |",[203,910,911],{"class":400}," undefined\n",[203,913,915,918,920,922,925,928,931,933,935,938,940],{"class":205,"line":914},42,[203,916,917],{"class":209},"    if",[203,919,853],{"class":413},[203,921,889],{"class":220},[203,923,924],{"class":216},"?.",[203,926,927],{"class":220},"premium",[203,929,930],{"class":413},") ",[203,932,857],{"class":220},[203,934,512],{"class":216},[203,936,937],{"class":220},"shouldKeep",[203,939,571],{"class":216},[203,941,943],{"class":942},"sfNiH"," true\n",[203,945,947],{"class":205,"line":946},43,[203,948,722],{"class":216},[203,950,952],{"class":205,"line":951},44,[203,953,334],{"emptyLinePlaceholder":333},[203,955,957],{"class":205,"line":956},45,[203,958,959],{"class":340},"  // 7. Enrich every event with user agent, request size, and deployment info\n",[203,961,963,966,968,970,972,974,976],{"class":205,"line":962},46,[203,964,965],{"class":360},"  enrich",[203,967,417],{"class":216},[203,969,853],{"class":216},[203,971,857],{"class":856},[203,973,860],{"class":216},[203,975,863],{"class":347},[203,977,616],{"class":216},[203,979,981,984,986,988,991,994,997,999,1002,1004,1006],{"class":205,"line":980},47,[203,982,983],{"class":209},"    for",[203,985,853],{"class":413},[203,987,348],{"class":347},[203,989,990],{"class":220}," enricher",[203,992,993],{"class":216}," of",[203,995,996],{"class":220}," enrichers",[203,998,930],{"class":413},[203,1000,1001],{"class":360},"enricher",[203,1003,407],{"class":413},[203,1005,857],{"class":220},[203,1007,445],{"class":413},[203,1009,1011,1014,1016,1019,1021,1024,1026,1028,1030,1032,1034],{"class":205,"line":1010},48,[203,1012,1013],{"class":220},"    ctx",[203,1015,512],{"class":216},[203,1017,1018],{"class":220},"event",[203,1020,512],{"class":216},[203,1022,1023],{"class":220},"deploymentId",[203,1025,571],{"class":216},[203,1027,509],{"class":220},[203,1029,512],{"class":216},[203,1031,515],{"class":220},[203,1033,512],{"class":216},[203,1035,1036],{"class":220},"VERCEL_DEPLOYMENT_ID\n",[203,1038,1040,1042,1044,1046,1048,1051,1053,1055,1057,1059,1061],{"class":205,"line":1039},49,[203,1041,1013],{"class":220},[203,1043,512],{"class":216},[203,1045,1018],{"class":220},[203,1047,512],{"class":216},[203,1049,1050],{"class":220},"region",[203,1052,571],{"class":216},[203,1054,509],{"class":220},[203,1056,512],{"class":216},[203,1058,515],{"class":220},[203,1060,512],{"class":216},[203,1062,1063],{"class":220},"VERCEL_REGION\n",[203,1065,1067],{"class":205,"line":1066},50,[203,1068,722],{"class":216},[203,1070,1072],{"class":205,"line":1071},51,[203,1073,334],{"emptyLinePlaceholder":333},[203,1075,1077,1080],{"class":205,"line":1076},52,[203,1078,1079],{"class":220},"  drain",[203,1081,498],{"class":216},[203,1083,1085,1087],{"class":205,"line":1084},53,[203,1086,529],{"class":216},[203,1088,445],{"class":220},[181,1090,36],{"id":1091},"wide-events",[177,1093,1094],{},"Build up context progressively through your handler. One request = one wide event:",[194,1096,1099],{"className":196,"code":1097,"filename":1098,"language":198,"meta":199,"style":199},"import { withEvlog, useLogger } from '@/lib/evlog'\n\nexport const POST = withEvlog(async (request: Request) => {\n  const log = useLogger()\n  const body = await request.json()\n\n  // Stage 1: User context\n  log.set({\n    user: { id: body.userId, plan: 'enterprise' },\n  })\n\n  // Stage 2: Cart context\n  log.set({\n    cart: { items: body.items.length, total: body.total, currency: 'USD' },\n  })\n\n  // Stage 3: Payment context\n  const payment = await processPayment(body)\n  log.set({\n    payment: { method: payment.method, cardLast4: payment.last4 },\n  })\n\n  return Response.json({ success: true, orderId: payment.orderId })\n})\n","app/api/checkout/route.ts",[189,1100,1101,1124,1128,1162,1176,1198,1202,1207,1221,1258,1265,1269,1274,1286,1342,1348,1352,1357,1378,1390,1427,1433,1437,1479],{"__ignoreMap":199},[203,1102,1103,1105,1107,1109,1111,1113,1115,1117,1119,1122],{"class":205,"line":206},[203,1104,210],{"class":209},[203,1106,217],{"class":216},[203,1108,551],{"class":220},[203,1110,271],{"class":216},[203,1112,556],{"class":220},[203,1114,224],{"class":216},[203,1116,227],{"class":209},[203,1118,230],{"class":216},[203,1120,1121],{"class":233},"@/lib/evlog",[203,1123,237],{"class":216},[203,1125,1126],{"class":205,"line":240},[203,1127,334],{"emptyLinePlaceholder":333},[203,1129,1130,1132,1134,1137,1139,1141,1143,1146,1148,1151,1153,1156,1158,1160],{"class":205,"line":261},[203,1131,543],{"class":209},[203,1133,546],{"class":347},[203,1135,1136],{"class":220}," POST ",[203,1138,354],{"class":216},[203,1140,551],{"class":360},[203,1142,407],{"class":220},[203,1144,1145],{"class":347},"async",[203,1147,853],{"class":216},[203,1149,1150],{"class":856},"request",[203,1152,417],{"class":216},[203,1154,1155],{"class":400}," Request",[203,1157,860],{"class":216},[203,1159,863],{"class":347},[203,1161,616],{"class":216},[203,1163,1164,1167,1169,1171,1173],{"class":205,"line":288},[203,1165,1166],{"class":347},"  const",[203,1168,561],{"class":220},[203,1170,571],{"class":216},[203,1172,556],{"class":360},[203,1174,1175],{"class":413},"()\n",[203,1177,1178,1180,1183,1185,1188,1191,1193,1196],{"class":205,"line":309},[203,1179,1166],{"class":347},[203,1181,1182],{"class":220}," body",[203,1184,571],{"class":216},[203,1186,1187],{"class":209}," await",[203,1189,1190],{"class":220}," request",[203,1192,512],{"class":216},[203,1194,1195],{"class":360},"json",[203,1197,1175],{"class":413},[203,1199,1200],{"class":205,"line":330},[203,1201,334],{"emptyLinePlaceholder":333},[203,1203,1204],{"class":205,"line":337},[203,1205,1206],{"class":340},"  // Stage 1: User context\n",[203,1208,1209,1212,1214,1217,1219],{"class":205,"line":344},[203,1210,1211],{"class":220},"  log",[203,1213,512],{"class":216},[203,1215,1216],{"class":360},"set",[203,1218,407],{"class":413},[203,1220,479],{"class":216},[203,1222,1223,1226,1228,1230,1233,1235,1237,1239,1242,1244,1247,1249,1251,1254,1256],{"class":205,"line":374},[203,1224,1225],{"class":413},"    user",[203,1227,417],{"class":216},[203,1229,217],{"class":216},[203,1231,1232],{"class":413}," id",[203,1234,417],{"class":216},[203,1236,1182],{"class":220},[203,1238,512],{"class":216},[203,1240,1241],{"class":220},"userId",[203,1243,271],{"class":216},[203,1245,1246],{"class":413}," plan",[203,1248,417],{"class":216},[203,1250,230],{"class":216},[203,1252,1253],{"class":233},"enterprise",[203,1255,495],{"class":216},[203,1257,637],{"class":216},[203,1259,1260,1263],{"class":205,"line":379},[203,1261,1262],{"class":216},"  }",[203,1264,445],{"class":413},[203,1266,1267],{"class":205,"line":385},[203,1268,334],{"emptyLinePlaceholder":333},[203,1270,1271],{"class":205,"line":448},[203,1272,1273],{"class":340},"  // Stage 2: Cart context\n",[203,1275,1276,1278,1280,1282,1284],{"class":205,"line":453},[203,1277,1211],{"class":220},[203,1279,512],{"class":216},[203,1281,1216],{"class":360},[203,1283,407],{"class":413},[203,1285,479],{"class":216},[203,1287,1288,1291,1293,1295,1298,1300,1302,1304,1307,1309,1312,1314,1317,1319,1321,1323,1326,1328,1331,1333,1335,1338,1340],{"class":205,"line":459},[203,1289,1290],{"class":413},"    cart",[203,1292,417],{"class":216},[203,1294,217],{"class":216},[203,1296,1297],{"class":413}," items",[203,1299,417],{"class":216},[203,1301,1182],{"class":220},[203,1303,512],{"class":216},[203,1305,1306],{"class":220},"items",[203,1308,512],{"class":216},[203,1310,1311],{"class":220},"length",[203,1313,271],{"class":216},[203,1315,1316],{"class":413}," total",[203,1318,417],{"class":216},[203,1320,1182],{"class":220},[203,1322,512],{"class":216},[203,1324,1325],{"class":220},"total",[203,1327,271],{"class":216},[203,1329,1330],{"class":413}," currency",[203,1332,417],{"class":216},[203,1334,230],{"class":216},[203,1336,1337],{"class":233},"USD",[203,1339,495],{"class":216},[203,1341,637],{"class":216},[203,1343,1344,1346],{"class":205,"line":482},[203,1345,1262],{"class":216},[203,1347,445],{"class":413},[203,1349,1350],{"class":205,"line":501},[203,1351,334],{"emptyLinePlaceholder":333},[203,1353,1354],{"class":205,"line":526},[203,1355,1356],{"class":340},"  // Stage 3: Payment context\n",[203,1358,1359,1361,1364,1366,1368,1371,1373,1376],{"class":205,"line":535},[203,1360,1166],{"class":347},[203,1362,1363],{"class":220}," payment",[203,1365,571],{"class":216},[203,1367,1187],{"class":209},[203,1369,1370],{"class":360}," processPayment",[203,1372,407],{"class":413},[203,1374,1375],{"class":220},"body",[203,1377,445],{"class":413},[203,1379,1380,1382,1384,1386,1388],{"class":205,"line":540},[203,1381,1211],{"class":220},[203,1383,512],{"class":216},[203,1385,1216],{"class":360},[203,1387,407],{"class":413},[203,1389,479],{"class":216},[203,1391,1392,1395,1397,1399,1402,1404,1406,1408,1411,1413,1416,1418,1420,1422,1425],{"class":205,"line":580},[203,1393,1394],{"class":413},"    payment",[203,1396,417],{"class":216},[203,1398,217],{"class":216},[203,1400,1401],{"class":413}," method",[203,1403,417],{"class":216},[203,1405,1363],{"class":220},[203,1407,512],{"class":216},[203,1409,1410],{"class":220},"method",[203,1412,271],{"class":216},[203,1414,1415],{"class":413}," cardLast4",[203,1417,417],{"class":216},[203,1419,1363],{"class":220},[203,1421,512],{"class":216},[203,1423,1424],{"class":220},"last4",[203,1426,637],{"class":216},[203,1428,1429,1431],{"class":205,"line":597},[203,1430,1262],{"class":216},[203,1432,445],{"class":413},[203,1434,1435],{"class":205,"line":602},[203,1436,334],{"emptyLinePlaceholder":333},[203,1438,1439,1442,1445,1447,1449,1451,1453,1456,1458,1461,1463,1466,1468,1470,1472,1475,1477],{"class":205,"line":608},[203,1440,1441],{"class":209},"  return",[203,1443,1444],{"class":220}," Response",[203,1446,512],{"class":216},[203,1448,1195],{"class":360},[203,1450,407],{"class":413},[203,1452,410],{"class":216},[203,1454,1455],{"class":413}," success",[203,1457,417],{"class":216},[203,1459,1460],{"class":942}," true",[203,1462,271],{"class":216},[203,1464,1465],{"class":413}," orderId",[203,1467,417],{"class":216},[203,1469,1363],{"class":220},[203,1471,512],{"class":216},[203,1473,1474],{"class":220},"orderId",[203,1476,224],{"class":216},[203,1478,445],{"class":413},[203,1480,1481,1483],{"class":205,"line":619},[203,1482,529],{"class":216},[203,1484,445],{"class":220},[177,1486,1487],{},"All fields are merged into a single wide event emitted when the handler completes:",[194,1489,1494],{"className":1490,"code":1491,"filename":1492,"language":1493,"meta":199,"style":199},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","10:23:45.612 INFO [my-app] POST /api/checkout 200 in 145ms\n  ├─ user: id=usr_123 plan=enterprise\n  ├─ cart: items=3 total=14999 currency=USD\n  ├─ payment: method=card cardLast4=4242\n  └─ requestId: a1b2c3d4-...\n","Output (Pretty)","bash",[189,1495,1496,1507,1521,1543,1559],{"__ignoreMap":199},[203,1497,1498,1501,1504],{"class":205,"line":206},[203,1499,1500],{"class":400},"10:23:45.612",[203,1502,1503],{"class":233}," INFO",[203,1505,1506],{"class":220}," [my-app] POST /api/checkout 200 in 145ms\n",[203,1508,1509,1512,1515,1518],{"class":205,"line":240},[203,1510,1511],{"class":400},"  ├─",[203,1513,1514],{"class":233}," user:",[203,1516,1517],{"class":233}," id=usr_123",[203,1519,1520],{"class":233}," plan=enterprise\n",[203,1522,1523,1525,1528,1531,1534,1537,1540],{"class":205,"line":261},[203,1524,1511],{"class":400},[203,1526,1527],{"class":233}," cart:",[203,1529,1530],{"class":233}," items=",[203,1532,1533],{"class":427},"3",[203,1535,1536],{"class":233}," total=",[203,1538,1539],{"class":427},"14999",[203,1541,1542],{"class":233}," currency=USD\n",[203,1544,1545,1547,1550,1553,1556],{"class":205,"line":288},[203,1546,1511],{"class":400},[203,1548,1549],{"class":233}," payment:",[203,1551,1552],{"class":233}," method=card",[203,1554,1555],{"class":233}," cardLast4=",[203,1557,1558],{"class":427},"4242\n",[203,1560,1561,1564,1567],{"class":205,"line":309},[203,1562,1563],{"class":400},"  └─",[203,1565,1566],{"class":233}," requestId:",[203,1568,1569],{"class":233}," a1b2c3d4-...\n",[181,1571,1573],{"id":1572},"error-handling","Error Handling",[177,1575,1576,1577,1580,1581,1584,1585,1588,1589,1592],{},"Use ",[189,1578,1579],{},"createError"," for structured errors with ",[189,1582,1583],{},"why",", ",[189,1586,1587],{},"fix",", and ",[189,1590,1591],{},"link"," fields that help developers debug in both logs and API responses:",[194,1594,1597],{"className":196,"code":1595,"filename":1596,"language":198,"meta":199,"style":199},"import { withEvlog, useLogger, createError } from '@/lib/evlog'\n\nexport const POST = withEvlog(async (request: Request) => {\n  const log = useLogger()\n  const body = await request.json()\n\n  log.set({ payment: { amount: body.amount } })\n\n  if (body.amount \u003C= 0) {\n    throw createError({\n      status: 400,\n      message: 'Invalid payment amount',\n      why: 'The amount must be a positive number',\n      fix: 'Pass a positive integer in cents (e.g. 4999 for $49.99)',\n      link: 'https://docs.example.com/api/payments#amount',\n    })\n  }\n\n  const result = await chargeCard(body)\n\n  if (!result.success) {\n    log.error(new Error(`Payment declined: ${result.reason}`))\n    throw createError({\n      status: 402,\n      message: 'Payment declined',\n      why: `Card declined by issuer: ${result.reason}`,\n      fix: 'Try a different payment method or contact your bank',\n    })\n  }\n\n  return Response.json({ success: true })\n})\n","app/api/payment/process/route.ts",[189,1598,1599,1626,1630,1660,1672,1690,1694,1730,1734,1757,1768,1779,1795,1811,1827,1843,1850,1855,1859,1879,1883,1904,1945,1955,1966,1981,2005,2020,2026,2030,2034,2058],{"__ignoreMap":199},[203,1600,1601,1603,1605,1607,1609,1611,1613,1616,1618,1620,1622,1624],{"class":205,"line":206},[203,1602,210],{"class":209},[203,1604,217],{"class":216},[203,1606,551],{"class":220},[203,1608,271],{"class":216},[203,1610,556],{"class":220},[203,1612,271],{"class":216},[203,1614,1615],{"class":220}," createError",[203,1617,224],{"class":216},[203,1619,227],{"class":209},[203,1621,230],{"class":216},[203,1623,1121],{"class":233},[203,1625,237],{"class":216},[203,1627,1628],{"class":205,"line":240},[203,1629,334],{"emptyLinePlaceholder":333},[203,1631,1632,1634,1636,1638,1640,1642,1644,1646,1648,1650,1652,1654,1656,1658],{"class":205,"line":261},[203,1633,543],{"class":209},[203,1635,546],{"class":347},[203,1637,1136],{"class":220},[203,1639,354],{"class":216},[203,1641,551],{"class":360},[203,1643,407],{"class":220},[203,1645,1145],{"class":347},[203,1647,853],{"class":216},[203,1649,1150],{"class":856},[203,1651,417],{"class":216},[203,1653,1155],{"class":400},[203,1655,860],{"class":216},[203,1657,863],{"class":347},[203,1659,616],{"class":216},[203,1661,1662,1664,1666,1668,1670],{"class":205,"line":288},[203,1663,1166],{"class":347},[203,1665,561],{"class":220},[203,1667,571],{"class":216},[203,1669,556],{"class":360},[203,1671,1175],{"class":413},[203,1673,1674,1676,1678,1680,1682,1684,1686,1688],{"class":205,"line":309},[203,1675,1166],{"class":347},[203,1677,1182],{"class":220},[203,1679,571],{"class":216},[203,1681,1187],{"class":209},[203,1683,1190],{"class":220},[203,1685,512],{"class":216},[203,1687,1195],{"class":360},[203,1689,1175],{"class":413},[203,1691,1692],{"class":205,"line":330},[203,1693,334],{"emptyLinePlaceholder":333},[203,1695,1696,1698,1700,1702,1704,1706,1708,1710,1712,1715,1717,1719,1721,1724,1726,1728],{"class":205,"line":337},[203,1697,1211],{"class":220},[203,1699,512],{"class":216},[203,1701,1216],{"class":360},[203,1703,407],{"class":413},[203,1705,410],{"class":216},[203,1707,1363],{"class":413},[203,1709,417],{"class":216},[203,1711,217],{"class":216},[203,1713,1714],{"class":413}," amount",[203,1716,417],{"class":216},[203,1718,1182],{"class":220},[203,1720,512],{"class":216},[203,1722,1723],{"class":220},"amount",[203,1725,224],{"class":216},[203,1727,224],{"class":216},[203,1729,445],{"class":413},[203,1731,1732],{"class":205,"line":344},[203,1733,334],{"emptyLinePlaceholder":333},[203,1735,1736,1739,1741,1743,1745,1747,1750,1753,1755],{"class":205,"line":374},[203,1737,1738],{"class":209},"  if",[203,1740,853],{"class":413},[203,1742,1375],{"class":220},[203,1744,512],{"class":216},[203,1746,1723],{"class":220},[203,1748,1749],{"class":216}," \u003C=",[203,1751,1752],{"class":427}," 0",[203,1754,930],{"class":413},[203,1756,479],{"class":216},[203,1758,1759,1762,1764,1766],{"class":205,"line":379},[203,1760,1761],{"class":209},"    throw",[203,1763,1615],{"class":360},[203,1765,407],{"class":413},[203,1767,479],{"class":216},[203,1769,1770,1773,1775,1777],{"class":205,"line":385},[203,1771,1772],{"class":413},"      status",[203,1774,417],{"class":216},[203,1776,662],{"class":427},[203,1778,498],{"class":216},[203,1780,1781,1784,1786,1788,1791,1793],{"class":205,"line":448},[203,1782,1783],{"class":413},"      message",[203,1785,417],{"class":216},[203,1787,230],{"class":216},[203,1789,1790],{"class":233},"Invalid payment amount",[203,1792,495],{"class":216},[203,1794,498],{"class":216},[203,1796,1797,1800,1802,1804,1807,1809],{"class":205,"line":453},[203,1798,1799],{"class":413},"      why",[203,1801,417],{"class":216},[203,1803,230],{"class":216},[203,1805,1806],{"class":233},"The amount must be a positive number",[203,1808,495],{"class":216},[203,1810,498],{"class":216},[203,1812,1813,1816,1818,1820,1823,1825],{"class":205,"line":459},[203,1814,1815],{"class":413},"      fix",[203,1817,417],{"class":216},[203,1819,230],{"class":216},[203,1821,1822],{"class":233},"Pass a positive integer in cents (e.g. 4999 for $49.99)",[203,1824,495],{"class":216},[203,1826,498],{"class":216},[203,1828,1829,1832,1834,1836,1839,1841],{"class":205,"line":482},[203,1830,1831],{"class":413},"      link",[203,1833,417],{"class":216},[203,1835,230],{"class":216},[203,1837,1838],{"class":233},"https://docs.example.com/api/payments#amount",[203,1840,495],{"class":216},[203,1842,498],{"class":216},[203,1844,1845,1848],{"class":205,"line":501},[203,1846,1847],{"class":216},"    }",[203,1849,445],{"class":413},[203,1851,1852],{"class":205,"line":526},[203,1853,1854],{"class":216},"  }\n",[203,1856,1857],{"class":205,"line":535},[203,1858,334],{"emptyLinePlaceholder":333},[203,1860,1861,1863,1866,1868,1870,1873,1875,1877],{"class":205,"line":540},[203,1862,1166],{"class":347},[203,1864,1865],{"class":220}," result",[203,1867,571],{"class":216},[203,1869,1187],{"class":209},[203,1871,1872],{"class":360}," chargeCard",[203,1874,407],{"class":413},[203,1876,1375],{"class":220},[203,1878,445],{"class":413},[203,1880,1881],{"class":205,"line":580},[203,1882,334],{"emptyLinePlaceholder":333},[203,1884,1885,1887,1889,1892,1895,1897,1900,1902],{"class":205,"line":597},[203,1886,1738],{"class":209},[203,1888,853],{"class":413},[203,1890,1891],{"class":216},"!",[203,1893,1894],{"class":220},"result",[203,1896,512],{"class":216},[203,1898,1899],{"class":220},"success",[203,1901,930],{"class":413},[203,1903,479],{"class":216},[203,1905,1906,1909,1911,1914,1916,1919,1922,1924,1927,1930,1933,1935,1937,1940,1943],{"class":205,"line":602},[203,1907,1908],{"class":220},"    log",[203,1910,512],{"class":216},[203,1912,1913],{"class":360},"error",[203,1915,407],{"class":413},[203,1917,1918],{"class":216},"new",[203,1920,1921],{"class":360}," Error",[203,1923,407],{"class":413},[203,1925,1926],{"class":216},"`",[203,1928,1929],{"class":233},"Payment declined: ",[203,1931,1932],{"class":216},"${",[203,1934,1894],{"class":220},[203,1936,512],{"class":216},[203,1938,1939],{"class":220},"reason",[203,1941,1942],{"class":216},"}`",[203,1944,532],{"class":413},[203,1946,1947,1949,1951,1953],{"class":205,"line":608},[203,1948,1761],{"class":209},[203,1950,1615],{"class":360},[203,1952,407],{"class":413},[203,1954,479],{"class":216},[203,1956,1957,1959,1961,1964],{"class":205,"line":619},[203,1958,1772],{"class":413},[203,1960,417],{"class":216},[203,1962,1963],{"class":427}," 402",[203,1965,498],{"class":216},[203,1967,1968,1970,1972,1974,1977,1979],{"class":205,"line":640},[203,1969,1783],{"class":413},[203,1971,417],{"class":216},[203,1973,230],{"class":216},[203,1975,1976],{"class":233},"Payment declined",[203,1978,495],{"class":216},[203,1980,498],{"class":216},[203,1982,1983,1985,1987,1990,1993,1995,1997,1999,2001,2003],{"class":205,"line":651},[203,1984,1799],{"class":413},[203,1986,417],{"class":216},[203,1988,1989],{"class":216}," `",[203,1991,1992],{"class":233},"Card declined by issuer: ",[203,1994,1932],{"class":216},[203,1996,1894],{"class":220},[203,1998,512],{"class":216},[203,2000,1939],{"class":220},[203,2002,1942],{"class":216},[203,2004,498],{"class":216},[203,2006,2007,2009,2011,2013,2016,2018],{"class":205,"line":671},[203,2008,1815],{"class":413},[203,2010,417],{"class":216},[203,2012,230],{"class":216},[203,2014,2015],{"class":233},"Try a different payment method or contact your bank",[203,2017,495],{"class":216},[203,2019,498],{"class":216},[203,2021,2022,2024],{"class":205,"line":689},[203,2023,1847],{"class":216},[203,2025,445],{"class":413},[203,2027,2028],{"class":205,"line":711},[203,2029,1854],{"class":216},[203,2031,2032],{"class":205,"line":719},[203,2033,334],{"emptyLinePlaceholder":333},[203,2035,2036,2038,2040,2042,2044,2046,2048,2050,2052,2054,2056],{"class":205,"line":725},[203,2037,1441],{"class":209},[203,2039,1444],{"class":220},[203,2041,512],{"class":216},[203,2043,1195],{"class":360},[203,2045,407],{"class":413},[203,2047,410],{"class":216},[203,2049,1455],{"class":413},[203,2051,417],{"class":216},[203,2053,1460],{"class":942},[203,2055,224],{"class":216},[203,2057,445],{"class":413},[203,2059,2060,2062],{"class":205,"line":730},[203,2061,529],{"class":216},[203,2063,445],{"class":220},[177,2065,2066,2069,2070,2073],{},[189,2067,2068],{},"withEvlog()"," catches ",[189,2071,2072],{},"EvlogError"," and returns a structured JSON response (like Nitro does for Nuxt):",[194,2075,2079],{"className":2076,"code":2077,"filename":2078,"language":1195,"meta":199,"style":199},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"name\": \"EvlogError\",\n  \"message\": \"Payment declined\",\n  \"status\": 402,\n  \"data\": {\n    \"why\": \"Card declined by issuer: insufficient_funds\",\n    \"fix\": \"Try a different payment method or contact your bank\"\n  }\n}\n","Response (402)",[189,2080,2081,2085,2107,2126,2141,2154,2174,2191,2195],{"__ignoreMap":199},[203,2082,2083],{"class":205,"line":206},[203,2084,479],{"class":216},[203,2086,2087,2090,2093,2096,2098,2101,2103,2105],{"class":205,"line":240},[203,2088,2089],{"class":216},"  \"",[203,2091,2092],{"class":347},"name",[203,2094,2095],{"class":216},"\"",[203,2097,417],{"class":216},[203,2099,2100],{"class":216}," \"",[203,2102,2072],{"class":233},[203,2104,2095],{"class":216},[203,2106,498],{"class":216},[203,2108,2109,2111,2114,2116,2118,2120,2122,2124],{"class":205,"line":261},[203,2110,2089],{"class":216},[203,2112,2113],{"class":347},"message",[203,2115,2095],{"class":216},[203,2117,417],{"class":216},[203,2119,2100],{"class":216},[203,2121,1976],{"class":233},[203,2123,2095],{"class":216},[203,2125,498],{"class":216},[203,2127,2128,2130,2133,2135,2137,2139],{"class":205,"line":288},[203,2129,2089],{"class":216},[203,2131,2132],{"class":347},"status",[203,2134,2095],{"class":216},[203,2136,417],{"class":216},[203,2138,1963],{"class":427},[203,2140,498],{"class":216},[203,2142,2143,2145,2148,2150,2152],{"class":205,"line":309},[203,2144,2089],{"class":216},[203,2146,2147],{"class":347},"data",[203,2149,2095],{"class":216},[203,2151,417],{"class":216},[203,2153,616],{"class":216},[203,2155,2156,2159,2161,2163,2165,2167,2170,2172],{"class":205,"line":330},[203,2157,2158],{"class":216},"    \"",[203,2160,1583],{"class":400},[203,2162,2095],{"class":216},[203,2164,417],{"class":216},[203,2166,2100],{"class":216},[203,2168,2169],{"class":233},"Card declined by issuer: insufficient_funds",[203,2171,2095],{"class":216},[203,2173,498],{"class":216},[203,2175,2176,2178,2180,2182,2184,2186,2188],{"class":205,"line":337},[203,2177,2158],{"class":216},[203,2179,1587],{"class":400},[203,2181,2095],{"class":216},[203,2183,417],{"class":216},[203,2185,2100],{"class":216},[203,2187,2015],{"class":233},[203,2189,2190],{"class":216},"\"\n",[203,2192,2193],{"class":205,"line":344},[203,2194,1854],{"class":216},[203,2196,2197],{"class":205,"line":374},[203,2198,2199],{"class":216},"}\n",[177,2201,2202],{},"In the terminal, the error renders with colored output:",[194,2204,2207],{"className":1490,"code":2205,"filename":2206,"language":1493,"meta":199,"style":199},"Error: Payment declined\nWhy: Card declined by issuer: insufficient_funds\nFix: Try a different payment method or contact your bank\n","Terminal output",[189,2208,2209,2220,2240],{"__ignoreMap":199},[203,2210,2211,2214,2217],{"class":205,"line":206},[203,2212,2213],{"class":400},"Error:",[203,2215,2216],{"class":233}," Payment",[203,2218,2219],{"class":233}," declined\n",[203,2221,2222,2225,2228,2231,2234,2237],{"class":205,"line":240},[203,2223,2224],{"class":400},"Why:",[203,2226,2227],{"class":233}," Card",[203,2229,2230],{"class":233}," declined",[203,2232,2233],{"class":233}," by",[203,2235,2236],{"class":233}," issuer:",[203,2238,2239],{"class":233}," insufficient_funds\n",[203,2241,2242,2245,2248,2251,2254,2256,2258,2261,2264,2267],{"class":205,"line":261},[203,2243,2244],{"class":400},"Fix:",[203,2246,2247],{"class":233}," Try",[203,2249,2250],{"class":233}," a",[203,2252,2253],{"class":233}," different",[203,2255,1363],{"class":233},[203,2257,1401],{"class":233},[203,2259,2260],{"class":233}," or",[203,2262,2263],{"class":233}," contact",[203,2265,2266],{"class":233}," your",[203,2268,2269],{"class":233}," bank\n",[2271,2272,2274],"h3",{"id":2273},"parsing-errors-on-the-client","Parsing Errors on the Client",[177,2276,1576,2277,2280,2281,2283,2284,2287],{},[189,2278,2279],{},"parseError"," to extract the structured fields from any error — fetch responses, ",[189,2282,2072],{},", or plain ",[189,2285,2286],{},"Error"," objects:",[194,2289,2294],{"className":2290,"code":2291,"filename":2292,"language":2293,"meta":199,"style":199},"language-tsx shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","'use client'\nimport { parseError } from 'evlog'\n\nasync function handleSubmit(formData: FormData) {\n  try {\n    const res = await fetch('/api/payment/process', {\n      method: 'POST',\n      body: JSON.stringify({ amount: Number(formData.get('amount')) }),\n    })\n    if (!res.ok) throw { data: await res.json(), status: res.status }\n  } catch (error) {\n    const { message, status, why, fix, link } = parseError(error)\n    // message: \"Payment declined\"\n    // why: \"Card declined by issuer: insufficient_funds\"\n    // fix: \"Try a different payment method or contact your bank\"\n  }\n}\n","app/components/PaymentForm.tsx","tsx",[189,2295,2296,2305,2324,2328,2352,2359,2386,2402,2454,2460,2513,2528,2568,2573,2578,2583,2587],{"__ignoreMap":199},[203,2297,2298,2300,2303],{"class":205,"line":206},[203,2299,495],{"class":216},[203,2301,2302],{"class":233},"use client",[203,2304,237],{"class":216},[203,2306,2307,2309,2311,2314,2316,2318,2320,2322],{"class":205,"line":240},[203,2308,210],{"class":209},[203,2310,217],{"class":216},[203,2312,2313],{"class":220}," parseError",[203,2315,224],{"class":216},[203,2317,227],{"class":209},[203,2319,230],{"class":216},[203,2321,234],{"class":233},[203,2323,237],{"class":216},[203,2325,2326],{"class":205,"line":261},[203,2327,334],{"emptyLinePlaceholder":333},[203,2329,2330,2332,2335,2338,2340,2343,2345,2348,2350],{"class":205,"line":288},[203,2331,1145],{"class":347},[203,2333,2334],{"class":347}," function",[203,2336,2337],{"class":360}," handleSubmit",[203,2339,407],{"class":216},[203,2341,2342],{"class":856},"formData",[203,2344,417],{"class":216},[203,2346,2347],{"class":400}," FormData",[203,2349,860],{"class":216},[203,2351,616],{"class":216},[203,2353,2354,2357],{"class":205,"line":309},[203,2355,2356],{"class":209},"  try",[203,2358,616],{"class":216},[203,2360,2361,2363,2366,2368,2370,2373,2375,2377,2380,2382,2384],{"class":205,"line":330},[203,2362,871],{"class":347},[203,2364,2365],{"class":220}," res",[203,2367,571],{"class":216},[203,2369,1187],{"class":209},[203,2371,2372],{"class":360}," fetch",[203,2374,407],{"class":413},[203,2376,495],{"class":216},[203,2378,2379],{"class":233},"/api/payment/process",[203,2381,495],{"class":216},[203,2383,271],{"class":216},[203,2385,616],{"class":216},[203,2387,2388,2391,2393,2395,2398,2400],{"class":205,"line":337},[203,2389,2390],{"class":413},"      method",[203,2392,417],{"class":216},[203,2394,230],{"class":216},[203,2396,2397],{"class":233},"POST",[203,2399,495],{"class":216},[203,2401,498],{"class":216},[203,2403,2404,2407,2409,2412,2414,2417,2419,2421,2423,2425,2428,2430,2432,2434,2437,2439,2441,2443,2445,2448,2450,2452],{"class":205,"line":344},[203,2405,2406],{"class":413},"      body",[203,2408,417],{"class":216},[203,2410,2411],{"class":220}," JSON",[203,2413,512],{"class":216},[203,2415,2416],{"class":360},"stringify",[203,2418,407],{"class":413},[203,2420,410],{"class":216},[203,2422,1714],{"class":413},[203,2424,417],{"class":216},[203,2426,2427],{"class":360}," Number",[203,2429,407],{"class":413},[203,2431,2342],{"class":220},[203,2433,512],{"class":216},[203,2435,2436],{"class":360},"get",[203,2438,407],{"class":413},[203,2440,495],{"class":216},[203,2442,1723],{"class":233},[203,2444,495],{"class":216},[203,2446,2447],{"class":413},")) ",[203,2449,529],{"class":216},[203,2451,860],{"class":413},[203,2453,498],{"class":216},[203,2455,2456,2458],{"class":205,"line":374},[203,2457,1847],{"class":216},[203,2459,445],{"class":413},[203,2461,2462,2464,2466,2468,2471,2473,2476,2478,2481,2483,2486,2488,2490,2492,2494,2496,2498,2500,2502,2504,2506,2508,2510],{"class":205,"line":379},[203,2463,917],{"class":209},[203,2465,853],{"class":413},[203,2467,1891],{"class":216},[203,2469,2470],{"class":220},"res",[203,2472,512],{"class":216},[203,2474,2475],{"class":220},"ok",[203,2477,930],{"class":413},[203,2479,2480],{"class":209},"throw",[203,2482,217],{"class":216},[203,2484,2485],{"class":413}," data",[203,2487,417],{"class":216},[203,2489,1187],{"class":209},[203,2491,2365],{"class":220},[203,2493,512],{"class":216},[203,2495,1195],{"class":360},[203,2497,364],{"class":413},[203,2499,271],{"class":216},[203,2501,657],{"class":413},[203,2503,417],{"class":216},[203,2505,2365],{"class":220},[203,2507,512],{"class":216},[203,2509,2132],{"class":220},[203,2511,2512],{"class":216}," }\n",[203,2514,2515,2517,2520,2522,2524,2526],{"class":205,"line":385},[203,2516,1262],{"class":216},[203,2518,2519],{"class":209}," catch",[203,2521,853],{"class":413},[203,2523,1913],{"class":220},[203,2525,930],{"class":413},[203,2527,479],{"class":216},[203,2529,2530,2532,2534,2537,2539,2541,2543,2546,2548,2551,2553,2556,2558,2560,2562,2564,2566],{"class":205,"line":448},[203,2531,871],{"class":347},[203,2533,217],{"class":216},[203,2535,2536],{"class":220}," message",[203,2538,271],{"class":216},[203,2540,657],{"class":220},[203,2542,271],{"class":216},[203,2544,2545],{"class":220}," why",[203,2547,271],{"class":216},[203,2549,2550],{"class":220}," fix",[203,2552,271],{"class":216},[203,2554,2555],{"class":220}," link",[203,2557,224],{"class":216},[203,2559,571],{"class":216},[203,2561,2313],{"class":360},[203,2563,407],{"class":413},[203,2565,1913],{"class":220},[203,2567,445],{"class":413},[203,2569,2570],{"class":205,"line":453},[203,2571,2572],{"class":340},"    // message: \"Payment declined\"\n",[203,2574,2575],{"class":205,"line":459},[203,2576,2577],{"class":340},"    // why: \"Card declined by issuer: insufficient_funds\"\n",[203,2579,2580],{"class":205,"line":482},[203,2581,2582],{"class":340},"    // fix: \"Try a different payment method or contact your bank\"\n",[203,2584,2585],{"class":205,"line":501},[203,2586,1854],{"class":216},[203,2588,2589],{"class":205,"line":526},[203,2590,2199],{"class":216},[177,2592,2593,2595,2596,2599,2600,2603],{},[189,2594,2279],{}," normalizes any error shape into a flat ",[189,2597,2598],{},"{ message, status, why?, fix?, link? }"," object, so your UI code never has to dig through nested ",[189,2601,2602],{},"data.data"," or check for different error formats.",[181,2605,2607],{"id":2606},"tail-sampling","Tail Sampling",[177,2609,2610],{},"Combine rule-based and custom tail sampling to always capture what matters, even when head sampling drops most logs:",[194,2612,2614],{"className":196,"code":2613,"filename":191,"language":198,"meta":199,"style":199},"export const { withEvlog, useLogger } = createEvlog({\n  service: 'my-app',\n  sampling: {\n    rates: { info: 10 }, // Only keep 10% of info logs\n    keep: [\n      { status: 400 },              // Always keep 4xx/5xx\n      { duration: 1000 },           // Always keep slow requests\n      { path: '/api/critical/**' }, // Always keep critical paths\n    ],\n  },\n  // Custom: always keep premium user requests\n  keep: (ctx) => {\n    const user = ctx.context.user as { premium?: boolean } | undefined\n    if (user?.premium) ctx.shouldKeep = true\n  },\n})\n",[189,2615,2616,2641,2655,2663,2682,2690,2705,2719,2737,2743,2747,2752,2768,2802,2826,2830],{"__ignoreMap":199},[203,2617,2618,2620,2622,2624,2626,2628,2631,2633,2635,2637,2639],{"class":205,"line":206},[203,2619,543],{"class":209},[203,2621,546],{"class":347},[203,2623,217],{"class":216},[203,2625,551],{"class":220},[203,2627,271],{"class":216},[203,2629,2630],{"class":220}," useLogger ",[203,2632,529],{"class":216},[203,2634,571],{"class":216},[203,2636,247],{"class":360},[203,2638,407],{"class":220},[203,2640,479],{"class":216},[203,2642,2643,2645,2647,2649,2651,2653],{"class":205,"line":240},[203,2644,583],{"class":413},[203,2646,417],{"class":216},[203,2648,230],{"class":216},[203,2650,590],{"class":233},[203,2652,495],{"class":216},[203,2654,498],{"class":216},[203,2656,2657,2659,2661],{"class":205,"line":261},[203,2658,611],{"class":413},[203,2660,417],{"class":216},[203,2662,616],{"class":216},[203,2664,2665,2667,2669,2671,2673,2675,2677,2679],{"class":205,"line":288},[203,2666,622],{"class":413},[203,2668,417],{"class":216},[203,2670,217],{"class":216},[203,2672,629],{"class":413},[203,2674,417],{"class":216},[203,2676,634],{"class":427},[203,2678,665],{"class":216},[203,2680,2681],{"class":340}," // Only keep 10% of info logs\n",[203,2683,2684,2686,2688],{"class":205,"line":309},[203,2685,643],{"class":413},[203,2687,417],{"class":216},[203,2689,648],{"class":220},[203,2691,2692,2694,2696,2698,2700,2702],{"class":205,"line":330},[203,2693,654],{"class":216},[203,2695,657],{"class":413},[203,2697,417],{"class":216},[203,2699,662],{"class":427},[203,2701,665],{"class":216},[203,2703,2704],{"class":340},"              // Always keep 4xx/5xx\n",[203,2706,2707,2709,2711,2713,2715,2717],{"class":205,"line":337},[203,2708,654],{"class":216},[203,2710,676],{"class":413},[203,2712,417],{"class":216},[203,2714,681],{"class":427},[203,2716,665],{"class":216},[203,2718,686],{"class":340},[203,2720,2721,2723,2725,2727,2729,2731,2733,2735],{"class":205,"line":344},[203,2722,654],{"class":216},[203,2724,694],{"class":413},[203,2726,417],{"class":216},[203,2728,230],{"class":216},[203,2730,701],{"class":233},[203,2732,495],{"class":216},[203,2734,665],{"class":216},[203,2736,708],{"class":340},[203,2738,2739,2741],{"class":205,"line":374},[203,2740,714],{"class":220},[203,2742,498],{"class":216},[203,2744,2745],{"class":205,"line":379},[203,2746,722],{"class":216},[203,2748,2749],{"class":205,"line":385},[203,2750,2751],{"class":340},"  // Custom: always keep premium user requests\n",[203,2753,2754,2756,2758,2760,2762,2764,2766],{"class":205,"line":448},[203,2755,848],{"class":360},[203,2757,417],{"class":216},[203,2759,853],{"class":216},[203,2761,857],{"class":856},[203,2763,860],{"class":216},[203,2765,863],{"class":347},[203,2767,616],{"class":216},[203,2769,2770,2772,2774,2776,2778,2780,2782,2784,2786,2788,2790,2792,2794,2796,2798,2800],{"class":205,"line":453},[203,2771,871],{"class":347},[203,2773,874],{"class":220},[203,2775,571],{"class":216},[203,2777,879],{"class":220},[203,2779,512],{"class":216},[203,2781,884],{"class":220},[203,2783,512],{"class":216},[203,2785,889],{"class":220},[203,2787,892],{"class":209},[203,2789,217],{"class":216},[203,2791,897],{"class":413},[203,2793,900],{"class":216},[203,2795,903],{"class":400},[203,2797,224],{"class":216},[203,2799,908],{"class":216},[203,2801,911],{"class":400},[203,2803,2804,2806,2808,2810,2812,2814,2816,2818,2820,2822,2824],{"class":205,"line":459},[203,2805,917],{"class":209},[203,2807,853],{"class":413},[203,2809,889],{"class":220},[203,2811,924],{"class":216},[203,2813,927],{"class":220},[203,2815,930],{"class":413},[203,2817,857],{"class":220},[203,2819,512],{"class":216},[203,2821,937],{"class":220},[203,2823,571],{"class":216},[203,2825,943],{"class":942},[203,2827,2828],{"class":205,"line":482},[203,2829,722],{"class":216},[203,2831,2832,2834],{"class":205,"line":501},[203,2833,529],{"class":216},[203,2835,445],{"class":220},[177,2837,2838,2839,2842],{},"The ",[189,2840,2841],{},"keep"," rules use OR logic — any match forces the event through regardless of head sampling.",[181,2844,2846],{"id":2845},"middleware","Middleware",[177,2848,2849,2850,2853,2854,2857,2858,2860],{},"Set ",[189,2851,2852],{},"x-request-id"," and ",[189,2855,2856],{},"x-evlog-start"," headers so ",[189,2859,2068],{}," can correlate timing across the middleware → handler chain:",[194,2862,2865],{"className":196,"code":2863,"filename":2864,"language":198,"meta":199,"style":199},"import { evlogMiddleware } from 'evlog/next'\n\nexport const proxy = evlogMiddleware()\n\nexport const config = {\n  matcher: ['/api/:path*'],\n}\n","proxy.ts",[189,2866,2867,2886,2890,2905,2909,2922,2943],{"__ignoreMap":199},[203,2868,2869,2871,2873,2876,2878,2880,2882,2884],{"class":205,"line":206},[203,2870,210],{"class":209},[203,2872,217],{"class":216},[203,2874,2875],{"class":220}," evlogMiddleware",[203,2877,224],{"class":216},[203,2879,227],{"class":209},[203,2881,230],{"class":216},[203,2883,256],{"class":233},[203,2885,237],{"class":216},[203,2887,2888],{"class":205,"line":240},[203,2889,334],{"emptyLinePlaceholder":333},[203,2891,2892,2894,2896,2899,2901,2903],{"class":205,"line":261},[203,2893,543],{"class":209},[203,2895,546],{"class":347},[203,2897,2898],{"class":220}," proxy ",[203,2900,354],{"class":216},[203,2902,2875],{"class":360},[203,2904,1175],{"class":220},[203,2906,2907],{"class":205,"line":288},[203,2908,334],{"emptyLinePlaceholder":333},[203,2910,2911,2913,2915,2918,2920],{"class":205,"line":309},[203,2912,543],{"class":209},[203,2914,546],{"class":347},[203,2916,2917],{"class":220}," config ",[203,2919,354],{"class":216},[203,2921,616],{"class":216},[203,2923,2924,2927,2929,2931,2933,2936,2938,2941],{"class":205,"line":330},[203,2925,2926],{"class":413},"  matcher",[203,2928,417],{"class":216},[203,2930,357],{"class":220},[203,2932,495],{"class":216},[203,2934,2935],{"class":233},"/api/:path*",[203,2937,495],{"class":216},[203,2939,2940],{"class":220},"]",[203,2942,498],{"class":216},[203,2944,2945],{"class":205,"line":337},[203,2946,2199],{"class":216},[2948,2949,2951,2952,2955,2956,2958,2959,2961],"callout",{"color":2950,"icon":13},"info","Older versions of Next.js use ",[189,2953,2954],{},"middleware.ts"," instead of ",[189,2957,2864],{},". The evlog middleware works with both — import from ",[189,2960,256],{}," regardless.",[181,2963,2965],{"id":2964},"client-provider","Client Provider",[177,2967,2968,2969,2972],{},"Wrap your root layout with ",[189,2970,2971],{},"EvlogProvider"," to enable client-side logging and transport:",[194,2974,2977],{"className":2290,"code":2975,"filename":2976,"language":2293,"meta":199,"style":199},"import { EvlogProvider } from 'evlog/next/client'\n\nexport default function Layout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml lang=\"en\">\n      \u003Cbody>\n        \u003CEvlogProvider service=\"my-app\" transport={{ enabled: true }}>\n          {children}\n        \u003C/EvlogProvider>\n      \u003C/body>\n    \u003C/html>\n  )\n}\n","app/layout.tsx",[189,2978,2979,2999,3003,3043,3050,3073,3082,3115,3125,3134,3143,3152,3157],{"__ignoreMap":199},[203,2980,2981,2983,2985,2988,2990,2992,2994,2997],{"class":205,"line":206},[203,2982,210],{"class":209},[203,2984,217],{"class":216},[203,2986,2987],{"class":220}," EvlogProvider",[203,2989,224],{"class":216},[203,2991,227],{"class":209},[203,2993,230],{"class":216},[203,2995,2996],{"class":233},"evlog/next/client",[203,2998,237],{"class":216},[203,3000,3001],{"class":205,"line":240},[203,3002,334],{"emptyLinePlaceholder":333},[203,3004,3005,3007,3010,3012,3015,3018,3021,3024,3026,3028,3030,3033,3035,3038,3041],{"class":205,"line":261},[203,3006,543],{"class":209},[203,3008,3009],{"class":209}," default",[203,3011,2334],{"class":347},[203,3013,3014],{"class":360}," Layout",[203,3016,3017],{"class":216},"({",[203,3019,3020],{"class":856}," children",[203,3022,3023],{"class":216}," }:",[203,3025,217],{"class":216},[203,3027,3020],{"class":413},[203,3029,417],{"class":216},[203,3031,3032],{"class":400}," React",[203,3034,512],{"class":216},[203,3036,3037],{"class":400},"ReactNode",[203,3039,3040],{"class":216}," })",[203,3042,616],{"class":216},[203,3044,3045,3047],{"class":205,"line":288},[203,3046,1441],{"class":209},[203,3048,3049],{"class":413}," (\n",[203,3051,3052,3055,3058,3061,3063,3065,3068,3070],{"class":205,"line":309},[203,3053,3054],{"class":216},"    \u003C",[203,3056,3057],{"class":413},"html",[203,3059,3060],{"class":347}," lang",[203,3062,354],{"class":216},[203,3064,2095],{"class":216},[203,3066,3067],{"class":233},"en",[203,3069,2095],{"class":216},[203,3071,3072],{"class":216},">\n",[203,3074,3075,3078,3080],{"class":205,"line":330},[203,3076,3077],{"class":216},"      \u003C",[203,3079,1375],{"class":413},[203,3081,3072],{"class":216},[203,3083,3084,3087,3089,3091,3093,3095,3097,3099,3102,3105,3108,3110,3112],{"class":205,"line":337},[203,3085,3086],{"class":216},"        \u003C",[203,3088,2971],{"class":400},[203,3090,761],{"class":347},[203,3092,354],{"class":216},[203,3094,2095],{"class":216},[203,3096,590],{"class":233},[203,3098,2095],{"class":216},[203,3100,3101],{"class":347}," transport",[203,3103,3104],{"class":216},"={{",[203,3106,3107],{"class":413}," enabled",[203,3109,417],{"class":216},[203,3111,1460],{"class":942},[203,3113,3114],{"class":216}," }}>\n",[203,3116,3117,3120,3123],{"class":205,"line":344},[203,3118,3119],{"class":216},"          {",[203,3121,3122],{"class":220},"children",[203,3124,2199],{"class":216},[203,3126,3127,3130,3132],{"class":205,"line":374},[203,3128,3129],{"class":216},"        \u003C/",[203,3131,2971],{"class":400},[203,3133,3072],{"class":216},[203,3135,3136,3139,3141],{"class":205,"line":379},[203,3137,3138],{"class":216},"      \u003C/",[203,3140,1375],{"class":413},[203,3142,3072],{"class":216},[203,3144,3145,3148,3150],{"class":205,"line":385},[203,3146,3147],{"class":216},"    \u003C/",[203,3149,3057],{"class":413},[203,3151,3072],{"class":216},[203,3153,3154],{"class":205,"line":448},[203,3155,3156],{"class":413},"  )\n",[203,3158,3159],{"class":205,"line":453},[203,3160,2199],{"class":216},[181,3162,3164],{"id":3163},"client-logging","Client Logging",[177,3166,1576,3167,3170],{},[189,3168,3169],{},"log"," in any client component. Identity is preserved across all logs and transported to the server:",[194,3172,3175],{"className":2290,"code":3173,"filename":3174,"language":2293,"meta":199,"style":199},"'use client'\nimport { log, setIdentity, clearIdentity } from 'evlog/next/client'\n\nexport function Dashboard({ user }: { user: { id: string } }) {\n  // Set identity once — all subsequent logs include it\n  useEffect(() => {\n    setIdentity({ userId: user.id })\n    return () => clearIdentity()\n  }, [user.id])\n\n  return (\n    \u003Cbutton onClick={() => log.info({ action: 'export_clicked', format: 'csv' })}>\n      Export\n    \u003C/button>\n  )\n}\n","app/components/Dashboard.tsx",[189,3176,3177,3185,3213,3217,3253,3258,3271,3296,3310,3326,3330,3336,3394,3399,3407,3411],{"__ignoreMap":199},[203,3178,3179,3181,3183],{"class":205,"line":206},[203,3180,495],{"class":216},[203,3182,2302],{"class":233},[203,3184,237],{"class":216},[203,3186,3187,3189,3191,3193,3195,3198,3200,3203,3205,3207,3209,3211],{"class":205,"line":240},[203,3188,210],{"class":209},[203,3190,217],{"class":216},[203,3192,561],{"class":220},[203,3194,271],{"class":216},[203,3196,3197],{"class":220}," setIdentity",[203,3199,271],{"class":216},[203,3201,3202],{"class":220}," clearIdentity",[203,3204,224],{"class":216},[203,3206,227],{"class":209},[203,3208,230],{"class":216},[203,3210,2996],{"class":233},[203,3212,237],{"class":216},[203,3214,3215],{"class":205,"line":261},[203,3216,334],{"emptyLinePlaceholder":333},[203,3218,3219,3221,3223,3226,3228,3230,3232,3234,3236,3238,3240,3242,3244,3247,3249,3251],{"class":205,"line":288},[203,3220,543],{"class":209},[203,3222,2334],{"class":347},[203,3224,3225],{"class":360}," Dashboard",[203,3227,3017],{"class":216},[203,3229,874],{"class":856},[203,3231,3023],{"class":216},[203,3233,217],{"class":216},[203,3235,874],{"class":413},[203,3237,417],{"class":216},[203,3239,217],{"class":216},[203,3241,1232],{"class":413},[203,3243,417],{"class":216},[203,3245,3246],{"class":400}," string",[203,3248,224],{"class":216},[203,3250,3040],{"class":216},[203,3252,616],{"class":216},[203,3254,3255],{"class":205,"line":309},[203,3256,3257],{"class":340},"  // Set identity once — all subsequent logs include it\n",[203,3259,3260,3263,3265,3267,3269],{"class":205,"line":330},[203,3261,3262],{"class":360},"  useEffect",[203,3264,407],{"class":413},[203,3266,364],{"class":216},[203,3268,863],{"class":347},[203,3270,616],{"class":216},[203,3272,3273,3276,3278,3280,3283,3285,3287,3289,3292,3294],{"class":205,"line":337},[203,3274,3275],{"class":360},"    setIdentity",[203,3277,407],{"class":413},[203,3279,410],{"class":216},[203,3281,3282],{"class":413}," userId",[203,3284,417],{"class":216},[203,3286,874],{"class":220},[203,3288,512],{"class":216},[203,3290,3291],{"class":220},"id",[203,3293,224],{"class":216},[203,3295,445],{"class":413},[203,3297,3298,3301,3304,3306,3308],{"class":205,"line":344},[203,3299,3300],{"class":209},"    return",[203,3302,3303],{"class":216}," ()",[203,3305,863],{"class":347},[203,3307,3202],{"class":360},[203,3309,1175],{"class":413},[203,3311,3312,3315,3317,3319,3321,3323],{"class":205,"line":374},[203,3313,3314],{"class":216},"  },",[203,3316,357],{"class":413},[203,3318,889],{"class":220},[203,3320,512],{"class":216},[203,3322,3291],{"class":220},[203,3324,3325],{"class":413},"])\n",[203,3327,3328],{"class":205,"line":379},[203,3329,334],{"emptyLinePlaceholder":333},[203,3331,3332,3334],{"class":205,"line":385},[203,3333,1441],{"class":209},[203,3335,3049],{"class":413},[203,3337,3338,3340,3343,3346,3349,3351,3353,3355,3357,3359,3361,3364,3366,3368,3371,3373,3375,3378,3380,3382,3385,3387,3389,3391],{"class":205,"line":448},[203,3339,3054],{"class":216},[203,3341,3342],{"class":413},"button",[203,3344,3345],{"class":347}," onClick",[203,3347,3348],{"class":216},"={()",[203,3350,863],{"class":347},[203,3352,561],{"class":220},[203,3354,512],{"class":216},[203,3356,2950],{"class":360},[203,3358,407],{"class":220},[203,3360,410],{"class":216},[203,3362,3363],{"class":413}," action",[203,3365,417],{"class":216},[203,3367,230],{"class":216},[203,3369,3370],{"class":233},"export_clicked",[203,3372,495],{"class":216},[203,3374,271],{"class":216},[203,3376,3377],{"class":413}," format",[203,3379,417],{"class":216},[203,3381,230],{"class":216},[203,3383,3384],{"class":233},"csv",[203,3386,495],{"class":216},[203,3388,224],{"class":216},[203,3390,860],{"class":220},[203,3392,3393],{"class":216},"}>\n",[203,3395,3396],{"class":205,"line":453},[203,3397,3398],{"class":220},"      Export\n",[203,3400,3401,3403,3405],{"class":205,"line":459},[203,3402,3147],{"class":216},[203,3404,3342],{"class":413},[203,3406,3072],{"class":216},[203,3408,3409],{"class":205,"line":482},[203,3410,3156],{"class":413},[203,3412,3413],{"class":205,"line":501},[203,3414,2199],{"class":216},[181,3416,3418],{"id":3417},"browser-drain","Browser Drain",[177,3420,3421,3422,3424],{},"For advanced use cases, send structured ",[189,3423,401],{}," events directly from the browser to a custom endpoint:",[194,3426,3428],{"className":196,"code":3427,"language":198,"meta":199,"style":199},"import { createBrowserLogDrain } from 'evlog/browser'\n\nconst drain = createBrowserLogDrain({\n  drain: { endpoint: '/api/evlog/browser-ingest' },\n  pipeline: { batch: { size: 10, intervalMs: 5000 } },\n})\n\ndrain(drainEvent)\nawait drain.flush()\n",[189,3429,3430,3450,3454,3468,3490,3523,3529,3533,3541],{"__ignoreMap":199},[203,3431,3432,3434,3436,3439,3441,3443,3445,3448],{"class":205,"line":206},[203,3433,210],{"class":209},[203,3435,217],{"class":216},[203,3437,3438],{"class":220}," createBrowserLogDrain",[203,3440,224],{"class":216},[203,3442,227],{"class":209},[203,3444,230],{"class":216},[203,3446,3447],{"class":233},"evlog/browser",[203,3449,237],{"class":216},[203,3451,3452],{"class":205,"line":240},[203,3453,334],{"emptyLinePlaceholder":333},[203,3455,3456,3458,3460,3462,3464,3466],{"class":205,"line":261},[203,3457,348],{"class":347},[203,3459,464],{"class":220},[203,3461,354],{"class":216},[203,3463,3438],{"class":360},[203,3465,407],{"class":220},[203,3467,479],{"class":216},[203,3469,3470,3472,3474,3476,3479,3481,3483,3486,3488],{"class":205,"line":288},[203,3471,1079],{"class":413},[203,3473,417],{"class":216},[203,3475,217],{"class":216},[203,3477,3478],{"class":413}," endpoint",[203,3480,417],{"class":216},[203,3482,230],{"class":216},[203,3484,3485],{"class":233},"/api/evlog/browser-ingest",[203,3487,495],{"class":216},[203,3489,637],{"class":216},[203,3491,3492,3495,3497,3499,3501,3503,3505,3507,3509,3511,3513,3515,3517,3519,3521],{"class":205,"line":309},[203,3493,3494],{"class":413},"  pipeline",[203,3496,417],{"class":216},[203,3498,217],{"class":216},[203,3500,414],{"class":413},[203,3502,417],{"class":216},[203,3504,217],{"class":216},[203,3506,422],{"class":413},[203,3508,417],{"class":216},[203,3510,634],{"class":427},[203,3512,271],{"class":216},[203,3514,433],{"class":413},[203,3516,417],{"class":216},[203,3518,438],{"class":427},[203,3520,224],{"class":216},[203,3522,637],{"class":216},[203,3524,3525,3527],{"class":205,"line":330},[203,3526,529],{"class":216},[203,3528,445],{"class":220},[203,3530,3531],{"class":205,"line":337},[203,3532,334],{"emptyLinePlaceholder":333},[203,3534,3535,3538],{"class":205,"line":344},[203,3536,3537],{"class":360},"drain",[203,3539,3540],{"class":220},"(drainEvent)\n",[203,3542,3543,3546,3549,3551,3554],{"class":205,"line":374},[203,3544,3545],{"class":209},"await",[203,3547,3548],{"class":220}," drain",[203,3550,512],{"class":216},[203,3552,3553],{"class":360},"flush",[203,3555,1175],{"class":220},[177,3557,3558],{},"The server endpoint receives batched events:",[194,3560,3563],{"className":196,"code":3561,"filename":3562,"language":198,"meta":199,"style":199},"export async function POST(request: Request) {\n  const events = await request.json()\n  // Forward to your drain pipeline, Axiom, etc.\n  return new Response(null, { status: 204 })\n}\n","app/api/evlog/browser-ingest/route.ts",[189,3564,3565,3589,3608,3613,3640],{"__ignoreMap":199},[203,3566,3567,3569,3572,3574,3577,3579,3581,3583,3585,3587],{"class":205,"line":206},[203,3568,543],{"class":209},[203,3570,3571],{"class":347}," async",[203,3573,2334],{"class":347},[203,3575,3576],{"class":360}," POST",[203,3578,407],{"class":216},[203,3580,1150],{"class":856},[203,3582,417],{"class":216},[203,3584,1155],{"class":400},[203,3586,860],{"class":216},[203,3588,616],{"class":216},[203,3590,3591,3593,3596,3598,3600,3602,3604,3606],{"class":205,"line":240},[203,3592,1166],{"class":347},[203,3594,3595],{"class":220}," events",[203,3597,571],{"class":216},[203,3599,1187],{"class":209},[203,3601,1190],{"class":220},[203,3603,512],{"class":216},[203,3605,1195],{"class":360},[203,3607,1175],{"class":413},[203,3609,3610],{"class":205,"line":261},[203,3611,3612],{"class":340},"  // Forward to your drain pipeline, Axiom, etc.\n",[203,3614,3615,3617,3620,3622,3624,3627,3629,3631,3633,3636,3638],{"class":205,"line":288},[203,3616,1441],{"class":209},[203,3618,3619],{"class":216}," new",[203,3621,1444],{"class":360},[203,3623,407],{"class":413},[203,3625,3626],{"class":216},"null,",[203,3628,217],{"class":216},[203,3630,657],{"class":413},[203,3632,417],{"class":216},[203,3634,3635],{"class":427}," 204",[203,3637,224],{"class":216},[203,3639,445],{"class":413},[203,3641,3642],{"class":205,"line":309},[203,3643,2199],{"class":216},[181,3645,3647],{"id":3646},"run-locally","Run Locally",[194,3649,3651],{"className":1490,"code":3650,"language":1493,"meta":199,"style":199},"git clone https://github.com/HugoRCD/evlog.git\ncd evlog/examples/nextjs\nbun install\nbun run dev\n",[189,3652,3653,3664,3672,3680],{"__ignoreMap":199},[203,3654,3655,3658,3661],{"class":205,"line":206},[203,3656,3657],{"class":400},"git",[203,3659,3660],{"class":233}," clone",[203,3662,3663],{"class":233}," https://github.com/HugoRCD/evlog.git\n",[203,3665,3666,3669],{"class":205,"line":240},[203,3667,3668],{"class":360},"cd",[203,3670,3671],{"class":233}," evlog/examples/nextjs\n",[203,3673,3674,3677],{"class":205,"line":261},[203,3675,3676],{"class":400},"bun",[203,3678,3679],{"class":233}," install\n",[203,3681,3682,3684,3687],{"class":205,"line":288},[203,3683,3676],{"class":400},[203,3685,3686],{"class":233}," run",[203,3688,3689],{"class":233}," dev\n",[177,3691,3692,3693,3699],{},"Open ",[3694,3695,3696],"a",{"href":3696,"rel":3697},"http://localhost:3000",[3698],"nofollow"," to explore the example.",[3701,3702,3703],"card-group",{},[3704,3705,3709],"card",{"icon":3706,"title":3707,"to":3708},"i-simple-icons-github","Source Code","https://github.com/HugoRCD/evlog/tree/main/examples/nextjs","Browse the complete Next.js example source on GitHub.",[3711,3712,3713],"style",{},"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 .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 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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .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}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}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);}",{"title":199,"searchDepth":240,"depth":240,"links":3715},[3716,3717,3718,3721,3722,3723,3724,3725,3726],{"id":183,"depth":240,"text":184},{"id":1091,"depth":240,"text":36},{"id":1572,"depth":240,"text":1573,"children":3719},[3720],{"id":2273,"depth":261,"text":2274},{"id":2606,"depth":240,"text":2607},{"id":2845,"depth":240,"text":2846},{"id":2964,"depth":240,"text":2965},{"id":3163,"depth":240,"text":3164},{"id":3417,"depth":240,"text":3418},{"id":3646,"depth":240,"text":3647},"Practical patterns for evlog with Next.js — enrichers, drain pipeline, tail sampling, route-based services, error handling, and client-side logging.","md",[3730],{"label":3707,"icon":3706,"to":3708,"color":3731,"variant":3732},"neutral","subtle",{},{"title":142,"icon":145},{"title":142,"description":3727},"HMDtbVZ5zMPMIJENY5PgBdlbKJuxFKEJKEafia4bzgk",[3738,3740],{"title":132,"path":133,"stem":134,"description":3739,"icon":135,"children":-1},"Configure how long logs are kept in NuxtHub and how they are automatically cleaned up with scheduled tasks, cron jobs, and retention policies.",{"title":147,"path":148,"stem":149,"description":3741,"icon":150,"children":-1},"Using evlog with TanStack Start — automatic wide events, structured errors, and logging in API routes and server functions.",1772880296686]