[{"data":1,"prerenderedAt":2967},["ShallowReactive",2],{"navigation_docs":3,"-adapters-building-blocks-custom":547,"-adapters-building-blocks-custom-surround":2962},[4,35,159,201,289,446,531],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Quick Start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F4.agent-skills","i-lucide-sparkles",{"title":30,"path":31,"stem":32,"icon":33},"vs Other Loggers","\u002Fgetting-started\u002Fvs-other-loggers","1.getting-started\u002F5.vs-other-loggers","i-lucide-scale",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Logging","\u002Flogging","2.logging",[40,45,50,55,60,65,70,99,127],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flogging\u002Foverview","2.logging\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flogging\u002Fsimple-logging","2.logging\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flogging\u002Fwide-events","2.logging\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flogging\u002Fstructured-errors","2.logging\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Catalogs","\u002Flogging\u002Fcatalogs","2.logging\u002F4.catalogs","i-lucide-book-open",{"title":66,"path":67,"stem":68,"icon":69},"Client Logging","\u002Flogging\u002Fclient-logging","2.logging\u002F5.client-logging","i-lucide-monitor",{"title":71,"icon":72,"path":73,"stem":74,"children":75,"page":34},"AI SDK","i-simple-icons-vercel","\u002Flogging\u002Fai-sdk","2.logging\u002F6.ai-sdk",[76,79,84,89,94],{"title":41,"path":77,"stem":78,"icon":44},"\u002Flogging\u002Fai-sdk\u002Foverview","2.logging\u002F6.ai-sdk\u002F01.overview",{"title":80,"path":81,"stem":82,"icon":83},"Usage","\u002Flogging\u002Fai-sdk\u002Fusage","2.logging\u002F6.ai-sdk\u002F02.usage","i-lucide-code",{"title":85,"path":86,"stem":87,"icon":88},"Options","\u002Flogging\u002Fai-sdk\u002Foptions","2.logging\u002F6.ai-sdk\u002F03.options","i-lucide-sliders",{"title":90,"path":91,"stem":92,"icon":93},"Metadata","\u002Flogging\u002Fai-sdk\u002Fmetadata","2.logging\u002F6.ai-sdk\u002F04.metadata","i-lucide-database",{"title":95,"path":96,"stem":97,"icon":98},"Telemetry","\u002Flogging\u002Fai-sdk\u002Ftelemetry","2.logging\u002F6.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Flogging\u002Fbetter-auth","2.logging\u002F7.better-auth",[105,108,113,118,122],{"title":41,"path":106,"stem":107,"icon":44},"\u002Flogging\u002Fbetter-auth\u002Foverview","2.logging\u002F7.better-auth\u002F01.overview",{"title":109,"path":110,"stem":111,"icon":112},"Identify User","\u002Flogging\u002Fbetter-auth\u002Fidentify-user","2.logging\u002F7.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":114,"path":115,"stem":116,"icon":117},"Middleware","\u002Flogging\u002Fbetter-auth\u002Fmiddleware","2.logging\u002F7.better-auth\u002F03.middleware","i-lucide-shield",{"title":119,"path":120,"stem":121,"icon":69},"Client Sync","\u002Flogging\u002Fbetter-auth\u002Fclient-sync","2.logging\u002F7.better-auth\u002F04.client-sync",{"title":123,"path":124,"stem":125,"icon":126},"Performance","\u002Flogging\u002Fbetter-auth\u002Fperformance","2.logging\u002F7.better-auth\u002F05.performance","i-lucide-gauge",{"title":128,"icon":129,"path":130,"stem":131,"children":132,"page":34},"Audit Logs","i-lucide-shield-check","\u002Flogging\u002Faudit","2.logging\u002F8.audit",[133,136,141,146,151,155],{"title":41,"path":134,"stem":135,"icon":44},"\u002Flogging\u002Faudit\u002Foverview","2.logging\u002F8.audit\u002F01.overview",{"title":137,"path":138,"stem":139,"icon":140},"Schema","\u002Flogging\u002Faudit\u002Fschema","2.logging\u002F8.audit\u002F02.schema","i-lucide-file-text",{"title":142,"path":143,"stem":144,"icon":145},"Recording","\u002Flogging\u002Faudit\u002Frecording","2.logging\u002F8.audit\u002F03.recording","i-lucide-pen-line",{"title":147,"path":148,"stem":149,"icon":150},"Drains","\u002Flogging\u002Faudit\u002Fpipeline","2.logging\u002F8.audit\u002F04.pipeline","i-lucide-link",{"title":152,"path":153,"stem":154,"icon":129},"Compliance","\u002Flogging\u002Faudit\u002Fcompliance","2.logging\u002F8.audit\u002F05.compliance",{"title":156,"path":157,"stem":158,"icon":64},"Recipes","\u002Flogging\u002Faudit\u002Frecipes","2.logging\u002F8.audit\u002F06.recipes",{"title":160,"path":161,"stem":162,"children":163,"page":34},"Core Concepts","\u002Fcore-concepts","3.core-concepts",[164,169,174,179,184,188,191,196],{"title":165,"path":166,"stem":167,"icon":168},"Lifecycle","\u002Fcore-concepts\u002Flifecycle","3.core-concepts\u002F0.lifecycle","i-lucide-arrow-right-left",{"title":170,"path":171,"stem":172,"icon":173},"Configuration","\u002Fcore-concepts\u002Fconfiguration","3.core-concepts\u002F1.configuration","i-lucide-settings",{"title":175,"path":176,"stem":177,"icon":178},"Sampling","\u002Fcore-concepts\u002Fsampling","3.core-concepts\u002F2.sampling","i-lucide-filter",{"title":180,"path":181,"stem":182,"icon":183},"Typed Fields","\u002Fcore-concepts\u002Ftyped-fields","3.core-concepts\u002F3.typed-fields","i-simple-icons-typescript",{"title":185,"path":186,"stem":187,"icon":129},"Best Practices","\u002Fcore-concepts\u002Fbest-practices","3.core-concepts\u002F4.best-practices",{"title":123,"path":189,"stem":190,"icon":126},"\u002Fcore-concepts\u002Fperformance","3.core-concepts\u002F5.performance",{"title":192,"path":193,"stem":194,"icon":195},"Vite Plugin","\u002Fcore-concepts\u002Fvite-plugin","3.core-concepts\u002F6.vite-plugin","i-custom-vite",{"title":197,"path":198,"stem":199,"icon":200},"Auto-Redaction","\u002Fcore-concepts\u002Fredaction","3.core-concepts\u002F7.redaction","i-lucide-eye-off",{"title":202,"path":203,"stem":204,"children":205,"page":34},"Frameworks","\u002Fframeworks","4.frameworks",[206,210,215,220,225,230,235,240,245,250,255,260,265,270,274,279,284],{"title":41,"path":207,"stem":208,"icon":209},"\u002Fframeworks\u002Foverview","4.frameworks\u002F00.overview","i-lucide-layout-grid",{"title":211,"path":212,"stem":213,"icon":214},"Nuxt","\u002Fframeworks\u002Fnuxt","4.frameworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":216,"path":217,"stem":218,"icon":219},"Next.js","\u002Fframeworks\u002Fnextjs","4.frameworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":221,"path":222,"stem":223,"icon":224},"SvelteKit","\u002Fframeworks\u002Fsveltekit","4.frameworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":226,"path":227,"stem":228,"icon":229},"Nitro","\u002Fframeworks\u002Fnitro","4.frameworks\u002F04.nitro","i-custom-nitro",{"title":231,"path":232,"stem":233,"icon":234},"TanStack Start","\u002Fframeworks\u002Ftanstack-start","4.frameworks\u002F05.tanstack-start","i-custom-tanstack",{"title":236,"path":237,"stem":238,"icon":239},"NestJS","\u002Fframeworks\u002Fnestjs","4.frameworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":241,"path":242,"stem":243,"icon":244},"Express","\u002Fframeworks\u002Fexpress","4.frameworks\u002F07.express","i-simple-icons-express",{"title":246,"path":247,"stem":248,"icon":249},"Hono","\u002Fframeworks\u002Fhono","4.frameworks\u002F08.hono","i-simple-icons-hono",{"title":251,"path":252,"stem":253,"icon":254},"Fastify","\u002Fframeworks\u002Ffastify","4.frameworks\u002F09.fastify","i-simple-icons-fastify",{"title":256,"path":257,"stem":258,"icon":259},"Elysia","\u002Fframeworks\u002Felysia","4.frameworks\u002F10.elysia","i-custom-elysia",{"title":261,"path":262,"stem":263,"icon":264},"React Router","\u002Fframeworks\u002Freact-router","4.frameworks\u002F11.react-router","i-custom-reactrouter",{"title":266,"path":267,"stem":268,"icon":269},"Cloudflare Workers","\u002Fframeworks\u002Fcloudflare-workers","4.frameworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":271,"path":272,"stem":273,"icon":183},"Standalone","\u002Fframeworks\u002Fstandalone","4.frameworks\u002F13.standalone",{"title":275,"path":276,"stem":277,"icon":278},"Astro","\u002Fframeworks\u002Fastro","4.frameworks\u002F14.astro","i-simple-icons-astro",{"title":280,"path":281,"stem":282,"icon":283},"AWS Lambda","\u002Fframeworks\u002Faws-lambda","4.frameworks\u002F16.aws-lambda","i-custom-lambda",{"title":285,"path":286,"stem":287,"icon":288},"Custom Integration","\u002Fframeworks\u002Fcustom-integration","4.frameworks\u002F17.custom-integration","i-lucide-puzzle",{"title":290,"path":291,"stem":292,"children":293,"page":34},"Build on top","\u002Fbuild-on-top","5.build-on-top",[294,297,325,346,373,400,428],{"title":41,"path":295,"stem":296,"icon":54},"\u002Fbuild-on-top\u002Foverview","5.build-on-top\u002F0.overview",{"title":298,"path":299,"stem":300,"children":301,"page":34},"Observers","\u002Fbuild-on-top\u002Fobservers","5.build-on-top\u002Fobservers",[302,306,311,316,321],{"title":41,"path":303,"stem":304,"icon":305},"\u002Fbuild-on-top\u002Fobservers\u002Foverview","5.build-on-top\u002Fobservers\u002F1.overview","i-lucide-eye",{"title":307,"path":308,"stem":309,"icon":310},"Stream API","\u002Fbuild-on-top\u002Fobservers\u002Fin-process-stream","5.build-on-top\u002Fobservers\u002F2.in-process-stream","i-lucide-radio-tower",{"title":312,"path":313,"stem":314,"icon":315},"Stream server","\u002Fbuild-on-top\u002Fobservers\u002Fstream-server","5.build-on-top\u002Fobservers\u002F3.stream-server","i-lucide-radio",{"title":317,"path":318,"stem":319,"icon":320},"FS reader","\u002Fbuild-on-top\u002Fobservers\u002Ffs-reader","5.build-on-top\u002Fobservers\u002F4.fs-reader","i-lucide-folder-search",{"title":156,"path":322,"stem":323,"icon":324},"\u002Fbuild-on-top\u002Fobservers\u002Fconsumer-recipes","5.build-on-top\u002Fobservers\u002F5.consumer-recipes","i-lucide-chef-hat",{"title":326,"path":327,"stem":328,"children":329,"page":34},"Pipeline","\u002Fbuild-on-top\u002Fpipeline","5.build-on-top\u002Fpipeline",[330,334,338,342],{"title":41,"path":331,"stem":332,"icon":333},"\u002Fbuild-on-top\u002Fpipeline\u002Foverview","5.build-on-top\u002Fpipeline\u002F1.overview","i-lucide-workflow",{"title":335,"path":336,"stem":337,"icon":288},"Plugins","\u002Fbuild-on-top\u002Fpipeline\u002Fplugins","5.build-on-top\u002Fpipeline\u002F2.plugins",{"title":339,"path":340,"stem":341,"icon":28},"Custom enrichers","\u002Fbuild-on-top\u002Fpipeline\u002Fcustom-enrichers","5.build-on-top\u002Fpipeline\u002F3.custom-enrichers",{"title":343,"path":344,"stem":345,"icon":178},"Tail sampling","\u002Fbuild-on-top\u002Fpipeline\u002Ftail-sampling","5.build-on-top\u002Fpipeline\u002F4.tail-sampling",{"title":347,"path":348,"stem":349,"children":350,"page":34},"Scenarios","\u002Fbuild-on-top\u002Fscenarios","5.build-on-top\u002Fscenarios",[351,355,359,364,368],{"title":41,"path":352,"stem":353,"icon":354},"\u002Fbuild-on-top\u002Fscenarios\u002Foverview","5.build-on-top\u002Fscenarios\u002F0.overview","i-lucide-clipboard-list",{"title":356,"path":357,"stem":358,"icon":49},"Local debugging toolkit","\u002Fbuild-on-top\u002Fscenarios\u002Flocal-debugging-toolkit","5.build-on-top\u002Fscenarios\u002F1.local-debugging-toolkit",{"title":360,"path":361,"stem":362,"icon":363},"Tenant-aware logging","\u002Fbuild-on-top\u002Fscenarios\u002Ftenant-aware-logging","5.build-on-top\u002Fscenarios\u002F2.tenant-aware-logging","i-lucide-users",{"title":365,"path":366,"stem":367,"icon":129},"Compliance audit","\u002Fbuild-on-top\u002Fscenarios\u002Fcompliance-audit","5.build-on-top\u002Fscenarios\u002F3.compliance-audit",{"title":369,"path":370,"stem":371,"icon":372},"Cross-app error vocab","\u002Fbuild-on-top\u002Fscenarios\u002Fcross-app-error-vocab","5.build-on-top\u002Fscenarios\u002F4.cross-app-error-vocab","i-lucide-book",{"title":374,"path":375,"stem":376,"children":377,"page":34},"Shared packages","\u002Fbuild-on-top\u002Fshared","5.build-on-top\u002Fshared",[378,382,386,391,395],{"title":41,"path":379,"stem":380,"icon":381},"\u002Fbuild-on-top\u002Fshared\u002Foverview","5.build-on-top\u002Fshared\u002F1.overview","i-lucide-package",{"title":383,"path":384,"stem":385,"icon":381},"Catalogs as packages","\u002Fbuild-on-top\u002Fshared\u002Fcatalogs-as-packages","5.build-on-top\u002Fshared\u002F2.catalogs-as-packages",{"title":387,"path":388,"stem":389,"icon":390},"Drains as packages","\u002Fbuild-on-top\u002Fshared\u002Fdrains-as-packages","5.build-on-top\u002Fshared\u002F3.drains-as-packages","i-lucide-package-2",{"title":392,"path":393,"stem":394,"icon":28},"Enrichers as packages","\u002Fbuild-on-top\u002Fshared\u002Fenrichers-as-packages","5.build-on-top\u002Fshared\u002F4.enrichers-as-packages",{"title":396,"path":397,"stem":398,"icon":399},"Integration as package","\u002Fbuild-on-top\u002Fshared\u002Fintegration-as-package","5.build-on-top\u002Fshared\u002F5.integration-as-package","i-lucide-package-check",{"title":401,"path":402,"stem":403,"children":404,"page":34},"Sinks","\u002Fbuild-on-top\u002Fsinks","5.build-on-top\u002Fsinks",[405,409,414,418,423],{"title":41,"path":406,"stem":407,"icon":408},"\u002Fbuild-on-top\u002Fsinks\u002Foverview","5.build-on-top\u002Fsinks\u002F1.overview","i-lucide-arrow-up-from-line",{"title":410,"path":411,"stem":412,"icon":413},"Custom drains","\u002Fbuild-on-top\u002Fsinks\u002Fcustom-drains","5.build-on-top\u002Fsinks\u002F2.custom-drains","i-lucide-code-2",{"title":415,"path":416,"stem":417,"icon":333},"Drain pipeline","\u002Fbuild-on-top\u002Fsinks\u002Fdrain-pipeline","5.build-on-top\u002Fsinks\u002F3.drain-pipeline",{"title":419,"path":420,"stem":421,"icon":422},"Identity headers","\u002Fbuild-on-top\u002Fsinks\u002Fidentity-headers","5.build-on-top\u002Fsinks\u002F4.identity-headers","i-lucide-fingerprint",{"title":424,"path":425,"stem":426,"icon":427},"Fanout","\u002Fbuild-on-top\u002Fsinks\u002Ffanout-and-multi-drain","5.build-on-top\u002Fsinks\u002F5.fanout-and-multi-drain","i-lucide-share-2",{"title":429,"path":430,"stem":431,"children":432,"page":34},"Sources","\u002Fbuild-on-top\u002Fsources","5.build-on-top\u002Fsources",[433,437,441],{"title":41,"path":434,"stem":435,"icon":436},"\u002Fbuild-on-top\u002Fsources\u002Foverview","5.build-on-top\u002Fsources\u002F1.overview","i-lucide-arrow-down-to-line",{"title":438,"path":439,"stem":440,"icon":288},"Custom framework","\u002Fbuild-on-top\u002Fsources\u002Fcustom-framework","5.build-on-top\u002Fsources\u002F2.custom-framework",{"title":442,"path":443,"stem":444,"icon":445},"Middleware toolkit","\u002Fbuild-on-top\u002Fsources\u002Fmiddleware-toolkit","5.build-on-top\u002Fsources\u002F3.middleware-toolkit","i-lucide-wrench",{"title":447,"path":448,"stem":449,"children":450,"page":34},"Adapters","\u002Fadapters","6.adapters",[451,454,494,509],{"title":41,"path":452,"stem":453,"icon":44},"\u002Fadapters\u002Foverview","6.adapters\u002F01.overview",{"title":455,"path":456,"stem":457,"children":458,"page":34},"Cloud destinations","\u002Fadapters\u002Fcloud","6.adapters\u002F02.cloud",[459,464,469,474,479,484,489],{"title":460,"path":461,"stem":462,"icon":463},"Axiom","\u002Fadapters\u002Fcloud\u002Faxiom","6.adapters\u002F02.cloud\u002F01.axiom","i-custom-axiom",{"title":465,"path":466,"stem":467,"icon":468},"OTLP","\u002Fadapters\u002Fcloud\u002Fotlp","6.adapters\u002F02.cloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":470,"path":471,"stem":472,"icon":473},"PostHog","\u002Fadapters\u002Fcloud\u002Fposthog","6.adapters\u002F02.cloud\u002F03.posthog","i-simple-icons-posthog",{"title":475,"path":476,"stem":477,"icon":478},"Sentry","\u002Fadapters\u002Fcloud\u002Fsentry","6.adapters\u002F02.cloud\u002F04.sentry","i-simple-icons-sentry",{"title":480,"path":481,"stem":482,"icon":483},"Better Stack","\u002Fadapters\u002Fcloud\u002Fbetter-stack","6.adapters\u002F02.cloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":485,"path":486,"stem":487,"icon":488},"Datadog","\u002Fadapters\u002Fcloud\u002Fdatadog","6.adapters\u002F02.cloud\u002F06.datadog","i-simple-icons-datadog",{"title":490,"path":491,"stem":492,"icon":493},"HyperDX","\u002Fadapters\u002Fcloud\u002Fhyperdx","6.adapters\u002F02.cloud\u002F07.hyperdx","i-custom-hyperdx",{"title":495,"path":496,"stem":497,"children":498,"page":34},"Self-hosted","\u002Fadapters\u002Fself-hosted","6.adapters\u002F03.self-hosted",[499,504],{"title":500,"path":501,"stem":502,"icon":503},"File System","\u002Fadapters\u002Fself-hosted\u002Ffs","6.adapters\u002F03.self-hosted\u002F01.fs","i-lucide-hard-drive",{"title":505,"path":506,"stem":507,"icon":508},"NuxtHub","\u002Fadapters\u002Fself-hosted\u002Fnuxthub","6.adapters\u002F03.self-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":510,"path":511,"stem":512,"children":513,"page":34},"Building blocks","\u002Fadapters\u002Fbuilding-blocks","6.adapters\u002F04.building-blocks",[514,517,522,526],{"title":326,"path":515,"stem":516,"icon":333},"\u002Fadapters\u002Fbuilding-blocks\u002Fpipeline","6.adapters\u002F04.building-blocks\u002F01.pipeline",{"title":518,"path":519,"stem":520,"icon":521},"HTTP","\u002Fadapters\u002Fbuilding-blocks\u002Fhttp","6.adapters\u002F04.building-blocks\u002F02.http","i-lucide-globe",{"title":523,"path":524,"stem":525,"icon":83},"Custom Adapters","\u002Fadapters\u002Fbuilding-blocks\u002Fcustom","6.adapters\u002F04.building-blocks\u002F03.custom",{"title":527,"path":528,"stem":529,"icon":530},"Toolkit","\u002Fadapters\u002Fbuilding-blocks\u002Ftoolkit","6.adapters\u002F04.building-blocks\u002F04.toolkit","i-lucide-blocks",{"title":532,"path":533,"stem":534,"children":535,"page":34},"Enrichers","\u002Fenrichers","7.enrichers",[536,539,543],{"title":41,"path":537,"stem":538,"icon":28},"\u002Fenrichers\u002Foverview","7.enrichers\u002F1.overview",{"title":540,"path":541,"stem":542,"icon":288},"Built-in","\u002Fenrichers\u002Fbuilt-in","7.enrichers\u002F2.built-in",{"title":544,"path":545,"stem":546,"icon":83},"Custom","\u002Fenrichers\u002Fcustom","7.enrichers\u002F3.custom",{"id":548,"title":523,"body":549,"description":2951,"extension":2952,"links":2953,"meta":2958,"navigation":2959,"path":524,"seo":2960,"stem":525,"__hash__":2961},"docs\u002F6.adapters\u002F04.building-blocks\u002F03.custom.md",{"type":550,"value":551,"toc":2939},"minimark",[552,572,582,629,637,644,1310,1316,1319,1657,1661,1922,1926,1932,1964,1997,2001,2010,2373,2383,2389,2395,2593,2596,2600,2607,2831,2840,2844,2849,2892,2906,2910,2935],[553,554,555,559,560,563,564,567,568,571],"p",{},[556,557,558],"code",{},"evlog\u002Ftoolkit"," ships ",[556,561,562],{},"defineHttpDrain"," — the same factory every built-in adapter uses. You provide two pure functions (",[556,565,566],{},"resolve()"," for config, ",[556,569,570],{},"encode()"," for the payload) and the toolkit handles batching, retries, timeouts, and error isolation.",[553,573,574,575,578,579,581],{},"A drain at its lowest level is still just a function that receives a ",[556,576,577],{},"DrainContext"," and sends data somewhere — but in practice, you should reach for ",[556,580,562],{}," first.",[583,584,587,590,615],"prompt",{":actions":585,"description":586,"icon":83},"[\"copy\",\"cursor\",\"windsurf\"]","Build a custom drain adapter",[553,588,589],{},"Build a custom evlog drain adapter that sends wide events to my destination.",[591,592,593,597,600,603,606,609,612],"ul",{},[594,595,596],"li",{},"Use defineHttpDrain from evlog\u002Ftoolkit — never call fetch directly",[594,598,599],{},"Provide a resolve() function returning the config (or null to skip)",[594,601,602],{},"Provide an encode(events, config) function returning { url, headers, body } (or null to skip)",[594,604,605],{},"For config use resolveAdapterConfig from evlog\u002Ftoolkit so users get the standard precedence (overrides → runtimeConfig → env)",[594,607,608],{},"Use the standardized field names: apiKey for bearer secrets, endpoint for the base URL, serviceName, timeout",[594,610,611],{},"defineHttpDrain handles retries, timeouts, error isolation, and batching — don't reimplement them",[594,613,614],{},"Wire the drain via defineEvlog({ drain: createMyDrain() }) or your framework's middleware drain option",[553,616,617,618,624,625],{},"Docs: ",[619,620,621],"a",{"href":621,"rel":622},"https:\u002F\u002Fwww.evlog.dev\u002Fadapters\u002Fbuilding-blocks\u002Fcustom",[623],"nofollow","\nPipeline: ",[619,626,627],{"href":627,"rel":628},"https:\u002F\u002Fwww.evlog.dev\u002Fadapters\u002Fbuilding-blocks\u002Fpipeline",[623],[630,631,633,634,636],"h2",{"id":632},"recipe-definehttpdrain-in-15-lines","Recipe — ",[556,635,562],{}," in 15 lines",[553,638,639,640,643],{},"The recipe every built-in adapter follows. Replace ",[556,641,642],{},"myservice"," with your service name.",[645,646,652],"pre",{"className":647,"code":648,"filename":649,"language":650,"meta":651,"style":651},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import {\n  defineHttpDrain,\n  resolveAdapterConfig,\n  type ConfigField,\n} from 'evlog\u002Ftoolkit'\n\ninterface MyServiceConfig {\n  apiKey: string\n  endpoint?: string\n  timeout?: number\n}\n\nconst FIELDS: ConfigField\u003CMyServiceConfig>[] = [\n  { key: 'apiKey', env: ['MYSERVICE_API_KEY'] },\n  { key: 'endpoint', env: ['MYSERVICE_ENDPOINT'] },\n  { key: 'timeout' },\n]\n\nexport function createMyServiceDrain(overrides?: Partial\u003CMyServiceConfig>) {\n  return defineHttpDrain\u003CMyServiceConfig>({\n    name: 'myservice',\n    resolve: async () => {\n      const cfg = await resolveAdapterConfig\u003CMyServiceConfig>('myservice', FIELDS, overrides)\n      if (!cfg.apiKey) {\n        console.error('[evlog\u002Fmyservice] Missing apiKey')\n        return null\n      }\n      return cfg as MyServiceConfig\n    },\n    encode: (events, cfg) => ({\n      url: `${cfg.endpoint ?? 'https:\u002F\u002Fapi.myservice.com'}\u002Fv1\u002Fingest`,\n      headers: {\n        'Content-Type': 'application\u002Fjson',\n        Authorization: `Bearer ${cfg.apiKey}`,\n      },\n      body: JSON.stringify(events),\n    }),\n  })\n}\n","lib\u002Fmy-drain.ts","typescript","",[556,653,654,667,677,685,696,714,721,734,747,758,769,775,780,811,854,889,908,914,919,953,973,989,1008,1052,1077,1099,1108,1114,1128,1134,1160,1197,1207,1229,1257,1263,1287,1297,1305],{"__ignoreMap":651},[655,656,659,663],"span",{"class":657,"line":658},"line",1,[655,660,662],{"class":661},"s7zQu","import",[655,664,666],{"class":665},"sMK4o"," {\n",[655,668,670,674],{"class":657,"line":669},2,[655,671,673],{"class":672},"sTEyZ","  defineHttpDrain",[655,675,676],{"class":665},",\n",[655,678,680,683],{"class":657,"line":679},3,[655,681,682],{"class":672},"  resolveAdapterConfig",[655,684,676],{"class":665},[655,686,688,691,694],{"class":657,"line":687},4,[655,689,690],{"class":661},"  type",[655,692,693],{"class":672}," ConfigField",[655,695,676],{"class":665},[655,697,699,702,705,708,711],{"class":657,"line":698},5,[655,700,701],{"class":665},"}",[655,703,704],{"class":661}," from",[655,706,707],{"class":665}," '",[655,709,558],{"class":710},"sfazB",[655,712,713],{"class":665},"'\n",[655,715,717],{"class":657,"line":716},6,[655,718,720],{"emptyLinePlaceholder":719},true,"\n",[655,722,724,728,732],{"class":657,"line":723},7,[655,725,727],{"class":726},"spNyl","interface",[655,729,731],{"class":730},"sBMFI"," MyServiceConfig",[655,733,666],{"class":665},[655,735,737,741,744],{"class":657,"line":736},8,[655,738,740],{"class":739},"swJcz","  apiKey",[655,742,743],{"class":665},":",[655,745,746],{"class":730}," string\n",[655,748,750,753,756],{"class":657,"line":749},9,[655,751,752],{"class":739},"  endpoint",[655,754,755],{"class":665},"?:",[655,757,746],{"class":730},[655,759,761,764,766],{"class":657,"line":760},10,[655,762,763],{"class":739},"  timeout",[655,765,755],{"class":665},[655,767,768],{"class":730}," number\n",[655,770,772],{"class":657,"line":771},11,[655,773,774],{"class":665},"}\n",[655,776,778],{"class":657,"line":777},12,[655,779,720],{"emptyLinePlaceholder":719},[655,781,783,786,789,791,793,796,799,802,805,808],{"class":657,"line":782},13,[655,784,785],{"class":726},"const",[655,787,788],{"class":672}," FIELDS",[655,790,743],{"class":665},[655,792,693],{"class":730},[655,794,795],{"class":665},"\u003C",[655,797,798],{"class":730},"MyServiceConfig",[655,800,801],{"class":665},">",[655,803,804],{"class":672},"[] ",[655,806,807],{"class":665},"=",[655,809,810],{"class":672}," [\n",[655,812,814,817,820,822,824,827,830,833,836,838,841,843,846,848,851],{"class":657,"line":813},14,[655,815,816],{"class":665},"  {",[655,818,819],{"class":739}," key",[655,821,743],{"class":665},[655,823,707],{"class":665},[655,825,826],{"class":710},"apiKey",[655,828,829],{"class":665},"'",[655,831,832],{"class":665},",",[655,834,835],{"class":739}," env",[655,837,743],{"class":665},[655,839,840],{"class":672}," [",[655,842,829],{"class":665},[655,844,845],{"class":710},"MYSERVICE_API_KEY",[655,847,829],{"class":665},[655,849,850],{"class":672},"] ",[655,852,853],{"class":665},"},\n",[655,855,857,859,861,863,865,868,870,872,874,876,878,880,883,885,887],{"class":657,"line":856},15,[655,858,816],{"class":665},[655,860,819],{"class":739},[655,862,743],{"class":665},[655,864,707],{"class":665},[655,866,867],{"class":710},"endpoint",[655,869,829],{"class":665},[655,871,832],{"class":665},[655,873,835],{"class":739},[655,875,743],{"class":665},[655,877,840],{"class":672},[655,879,829],{"class":665},[655,881,882],{"class":710},"MYSERVICE_ENDPOINT",[655,884,829],{"class":665},[655,886,850],{"class":672},[655,888,853],{"class":665},[655,890,892,894,896,898,900,903,905],{"class":657,"line":891},16,[655,893,816],{"class":665},[655,895,819],{"class":739},[655,897,743],{"class":665},[655,899,707],{"class":665},[655,901,902],{"class":710},"timeout",[655,904,829],{"class":665},[655,906,907],{"class":665}," },\n",[655,909,911],{"class":657,"line":910},17,[655,912,913],{"class":672},"]\n",[655,915,917],{"class":657,"line":916},18,[655,918,720],{"emptyLinePlaceholder":719},[655,920,922,925,928,932,935,939,941,944,946,948,951],{"class":657,"line":921},19,[655,923,924],{"class":661},"export",[655,926,927],{"class":726}," function",[655,929,931],{"class":930},"s2Zo4"," createMyServiceDrain",[655,933,934],{"class":665},"(",[655,936,938],{"class":937},"sHdIc","overrides",[655,940,755],{"class":665},[655,942,943],{"class":730}," Partial",[655,945,795],{"class":665},[655,947,798],{"class":730},[655,949,950],{"class":665},">)",[655,952,666],{"class":665},[655,954,956,959,962,964,966,968,970],{"class":657,"line":955},20,[655,957,958],{"class":661},"  return",[655,960,961],{"class":930}," defineHttpDrain",[655,963,795],{"class":665},[655,965,798],{"class":730},[655,967,801],{"class":665},[655,969,934],{"class":739},[655,971,972],{"class":665},"{\n",[655,974,976,979,981,983,985,987],{"class":657,"line":975},21,[655,977,978],{"class":739},"    name",[655,980,743],{"class":665},[655,982,707],{"class":665},[655,984,642],{"class":710},[655,986,829],{"class":665},[655,988,676],{"class":665},[655,990,992,995,997,1000,1003,1006],{"class":657,"line":991},22,[655,993,994],{"class":930},"    resolve",[655,996,743],{"class":665},[655,998,999],{"class":726}," async",[655,1001,1002],{"class":665}," ()",[655,1004,1005],{"class":726}," =>",[655,1007,666],{"class":665},[655,1009,1011,1014,1017,1020,1023,1026,1028,1030,1032,1034,1036,1038,1040,1042,1044,1046,1049],{"class":657,"line":1010},23,[655,1012,1013],{"class":726},"      const",[655,1015,1016],{"class":672}," cfg",[655,1018,1019],{"class":665}," =",[655,1021,1022],{"class":661}," await",[655,1024,1025],{"class":930}," resolveAdapterConfig",[655,1027,795],{"class":665},[655,1029,798],{"class":730},[655,1031,801],{"class":665},[655,1033,934],{"class":739},[655,1035,829],{"class":665},[655,1037,642],{"class":710},[655,1039,829],{"class":665},[655,1041,832],{"class":665},[655,1043,788],{"class":672},[655,1045,832],{"class":665},[655,1047,1048],{"class":672}," overrides",[655,1050,1051],{"class":739},")\n",[655,1053,1055,1058,1061,1064,1067,1070,1072,1075],{"class":657,"line":1054},24,[655,1056,1057],{"class":661},"      if",[655,1059,1060],{"class":739}," (",[655,1062,1063],{"class":665},"!",[655,1065,1066],{"class":672},"cfg",[655,1068,1069],{"class":665},".",[655,1071,826],{"class":672},[655,1073,1074],{"class":739},") ",[655,1076,972],{"class":665},[655,1078,1080,1083,1085,1088,1090,1092,1095,1097],{"class":657,"line":1079},25,[655,1081,1082],{"class":672},"        console",[655,1084,1069],{"class":665},[655,1086,1087],{"class":930},"error",[655,1089,934],{"class":739},[655,1091,829],{"class":665},[655,1093,1094],{"class":710},"[evlog\u002Fmyservice] Missing apiKey",[655,1096,829],{"class":665},[655,1098,1051],{"class":739},[655,1100,1102,1105],{"class":657,"line":1101},26,[655,1103,1104],{"class":661},"        return",[655,1106,1107],{"class":665}," null\n",[655,1109,1111],{"class":657,"line":1110},27,[655,1112,1113],{"class":665},"      }\n",[655,1115,1117,1120,1122,1125],{"class":657,"line":1116},28,[655,1118,1119],{"class":661},"      return",[655,1121,1016],{"class":672},[655,1123,1124],{"class":661}," as",[655,1126,1127],{"class":730}," MyServiceConfig\n",[655,1129,1131],{"class":657,"line":1130},29,[655,1132,1133],{"class":665},"    },\n",[655,1135,1137,1140,1142,1144,1147,1149,1151,1154,1156,1158],{"class":657,"line":1136},30,[655,1138,1139],{"class":930},"    encode",[655,1141,743],{"class":665},[655,1143,1060],{"class":665},[655,1145,1146],{"class":937},"events",[655,1148,832],{"class":665},[655,1150,1016],{"class":937},[655,1152,1153],{"class":665},")",[655,1155,1005],{"class":726},[655,1157,1060],{"class":739},[655,1159,972],{"class":665},[655,1161,1163,1166,1168,1171,1173,1175,1178,1181,1183,1186,1189,1192,1195],{"class":657,"line":1162},31,[655,1164,1165],{"class":739},"      url",[655,1167,743],{"class":665},[655,1169,1170],{"class":665}," `${",[655,1172,1066],{"class":672},[655,1174,1069],{"class":665},[655,1176,1177],{"class":672},"endpoint ",[655,1179,1180],{"class":665},"??",[655,1182,707],{"class":665},[655,1184,1185],{"class":710},"https:\u002F\u002Fapi.myservice.com",[655,1187,1188],{"class":665},"'}",[655,1190,1191],{"class":710},"\u002Fv1\u002Fingest",[655,1193,1194],{"class":665},"`",[655,1196,676],{"class":665},[655,1198,1200,1203,1205],{"class":657,"line":1199},32,[655,1201,1202],{"class":739},"      headers",[655,1204,743],{"class":665},[655,1206,666],{"class":665},[655,1208,1210,1213,1216,1218,1220,1222,1225,1227],{"class":657,"line":1209},33,[655,1211,1212],{"class":665},"        '",[655,1214,1215],{"class":739},"Content-Type",[655,1217,829],{"class":665},[655,1219,743],{"class":665},[655,1221,707],{"class":665},[655,1223,1224],{"class":710},"application\u002Fjson",[655,1226,829],{"class":665},[655,1228,676],{"class":665},[655,1230,1232,1235,1237,1240,1243,1246,1248,1250,1252,1255],{"class":657,"line":1231},34,[655,1233,1234],{"class":739},"        Authorization",[655,1236,743],{"class":665},[655,1238,1239],{"class":665}," `",[655,1241,1242],{"class":710},"Bearer ",[655,1244,1245],{"class":665},"${",[655,1247,1066],{"class":672},[655,1249,1069],{"class":665},[655,1251,826],{"class":672},[655,1253,1254],{"class":665},"}`",[655,1256,676],{"class":665},[655,1258,1260],{"class":657,"line":1259},35,[655,1261,1262],{"class":665},"      },\n",[655,1264,1266,1269,1271,1274,1276,1279,1281,1283,1285],{"class":657,"line":1265},36,[655,1267,1268],{"class":739},"      body",[655,1270,743],{"class":665},[655,1272,1273],{"class":672}," JSON",[655,1275,1069],{"class":665},[655,1277,1278],{"class":930},"stringify",[655,1280,934],{"class":739},[655,1282,1146],{"class":672},[655,1284,1153],{"class":739},[655,1286,676],{"class":665},[655,1288,1290,1293,1295],{"class":657,"line":1289},37,[655,1291,1292],{"class":665},"    }",[655,1294,1153],{"class":739},[655,1296,676],{"class":665},[655,1298,1300,1303],{"class":657,"line":1299},38,[655,1301,1302],{"class":665},"  }",[655,1304,1051],{"class":739},[655,1306,1308],{"class":657,"line":1307},39,[655,1309,774],{"class":665},[553,1311,1312,1313,1315],{},"That's it. ",[556,1314,562],{}," handles retries (default 2), timeouts (default 5000ms), and error isolation — your app pipeline keeps running even if your destination is down.",[553,1317,1318],{},"Then wire it to your framework:",[1320,1321,1322,1394,1496,1529,1555,1586,1612,1637],"code-group",{},[645,1323,1326],{"className":647,"code":1324,"filename":1325,"language":650,"meta":651,"style":651},"\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\nexport default defineNitroPlugin((nitroApp) => {\n  nitroApp.hooks.hook('evlog:drain', drain)\n})\n","Nuxt \u002F Nitro",[556,1327,1328,1334,1357,1388],{"__ignoreMap":651},[655,1329,1330],{"class":657,"line":658},[655,1331,1333],{"class":1332},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\n",[655,1335,1336,1338,1341,1344,1346,1348,1351,1353,1355],{"class":657,"line":669},[655,1337,924],{"class":661},[655,1339,1340],{"class":661}," default",[655,1342,1343],{"class":930}," defineNitroPlugin",[655,1345,934],{"class":672},[655,1347,934],{"class":665},[655,1349,1350],{"class":937},"nitroApp",[655,1352,1153],{"class":665},[655,1354,1005],{"class":726},[655,1356,666],{"class":665},[655,1358,1359,1362,1364,1367,1369,1372,1374,1376,1379,1381,1383,1386],{"class":657,"line":679},[655,1360,1361],{"class":672},"  nitroApp",[655,1363,1069],{"class":665},[655,1365,1366],{"class":672},"hooks",[655,1368,1069],{"class":665},[655,1370,1371],{"class":930},"hook",[655,1373,934],{"class":739},[655,1375,829],{"class":665},[655,1377,1378],{"class":710},"evlog:drain",[655,1380,829],{"class":665},[655,1382,832],{"class":665},[655,1384,1385],{"class":672}," drain",[655,1387,1051],{"class":739},[655,1389,1390,1392],{"class":657,"line":687},[655,1391,701],{"class":665},[655,1393,1051],{"class":672},[645,1395,1397],{"className":647,"code":1396,"filename":216,"language":650,"meta":651,"style":651},"\u002F\u002F lib\u002Fevlog.ts\nimport { createEvlog } from 'evlog\u002Fnext'\n\nexport const { withEvlog, useLogger, log, createError } = createEvlog({\n  service: 'my-app',\n  drain,\n})\n",[556,1398,1399,1404,1426,1430,1467,1483,1490],{"__ignoreMap":651},[655,1400,1401],{"class":657,"line":658},[655,1402,1403],{"class":1332},"\u002F\u002F lib\u002Fevlog.ts\n",[655,1405,1406,1408,1411,1414,1417,1419,1421,1424],{"class":657,"line":669},[655,1407,662],{"class":661},[655,1409,1410],{"class":665}," {",[655,1412,1413],{"class":672}," createEvlog",[655,1415,1416],{"class":665}," }",[655,1418,704],{"class":661},[655,1420,707],{"class":665},[655,1422,1423],{"class":710},"evlog\u002Fnext",[655,1425,713],{"class":665},[655,1427,1428],{"class":657,"line":679},[655,1429,720],{"emptyLinePlaceholder":719},[655,1431,1432,1434,1437,1439,1442,1444,1447,1449,1452,1454,1457,1459,1461,1463,1465],{"class":657,"line":687},[655,1433,924],{"class":661},[655,1435,1436],{"class":726}," const",[655,1438,1410],{"class":665},[655,1440,1441],{"class":672}," withEvlog",[655,1443,832],{"class":665},[655,1445,1446],{"class":672}," useLogger",[655,1448,832],{"class":665},[655,1450,1451],{"class":672}," log",[655,1453,832],{"class":665},[655,1455,1456],{"class":672}," createError ",[655,1458,701],{"class":665},[655,1460,1019],{"class":665},[655,1462,1413],{"class":930},[655,1464,934],{"class":672},[655,1466,972],{"class":665},[655,1468,1469,1472,1474,1476,1479,1481],{"class":657,"line":698},[655,1470,1471],{"class":739},"  service",[655,1473,743],{"class":665},[655,1475,707],{"class":665},[655,1477,1478],{"class":710},"my-app",[655,1480,829],{"class":665},[655,1482,676],{"class":665},[655,1484,1485,1488],{"class":657,"line":716},[655,1486,1487],{"class":672},"  drain",[655,1489,676],{"class":665},[655,1491,1492,1494],{"class":657,"line":723},[655,1493,701],{"class":665},[655,1495,1051],{"class":672},[645,1497,1499],{"className":647,"code":1498,"filename":246,"language":650,"meta":651,"style":651},"app.use(evlog({ drain }))\n",[556,1500,1501],{"__ignoreMap":651},[655,1502,1503,1506,1508,1511,1513,1516,1518,1521,1524,1526],{"class":657,"line":658},[655,1504,1505],{"class":672},"app",[655,1507,1069],{"class":665},[655,1509,1510],{"class":930},"use",[655,1512,934],{"class":672},[655,1514,1515],{"class":930},"evlog",[655,1517,934],{"class":672},[655,1519,1520],{"class":665},"{",[655,1522,1523],{"class":672}," drain ",[655,1525,701],{"class":665},[655,1527,1528],{"class":672},"))\n",[645,1530,1531],{"className":647,"code":1498,"filename":241,"language":650,"meta":651,"style":651},[556,1532,1533],{"__ignoreMap":651},[655,1534,1535,1537,1539,1541,1543,1545,1547,1549,1551,1553],{"class":657,"line":658},[655,1536,1505],{"class":672},[655,1538,1069],{"class":665},[655,1540,1510],{"class":930},[655,1542,934],{"class":672},[655,1544,1515],{"class":930},[655,1546,934],{"class":672},[655,1548,1520],{"class":665},[655,1550,1523],{"class":672},[655,1552,701],{"class":665},[655,1554,1528],{"class":672},[645,1556,1558],{"className":647,"code":1557,"filename":251,"language":650,"meta":651,"style":651},"await app.register(evlog, { drain })\n",[556,1559,1560],{"__ignoreMap":651},[655,1561,1562,1565,1568,1570,1573,1576,1578,1580,1582,1584],{"class":657,"line":658},[655,1563,1564],{"class":661},"await",[655,1566,1567],{"class":672}," app",[655,1569,1069],{"class":665},[655,1571,1572],{"class":930},"register",[655,1574,1575],{"class":672},"(evlog",[655,1577,832],{"class":665},[655,1579,1410],{"class":665},[655,1581,1523],{"class":672},[655,1583,701],{"class":665},[655,1585,1051],{"class":672},[645,1587,1588],{"className":647,"code":1498,"filename":256,"language":650,"meta":651,"style":651},[556,1589,1590],{"__ignoreMap":651},[655,1591,1592,1594,1596,1598,1600,1602,1604,1606,1608,1610],{"class":657,"line":658},[655,1593,1505],{"class":672},[655,1595,1069],{"class":665},[655,1597,1510],{"class":930},[655,1599,934],{"class":672},[655,1601,1515],{"class":930},[655,1603,934],{"class":672},[655,1605,1520],{"class":665},[655,1607,1523],{"class":672},[655,1609,701],{"class":665},[655,1611,1528],{"class":672},[645,1613,1615],{"className":647,"code":1614,"filename":236,"language":650,"meta":651,"style":651},"EvlogModule.forRoot({ drain })\n",[556,1616,1617],{"__ignoreMap":651},[655,1618,1619,1622,1624,1627,1629,1631,1633,1635],{"class":657,"line":658},[655,1620,1621],{"class":672},"EvlogModule",[655,1623,1069],{"class":665},[655,1625,1626],{"class":930},"forRoot",[655,1628,934],{"class":672},[655,1630,1520],{"class":665},[655,1632,1523],{"class":672},[655,1634,701],{"class":665},[655,1636,1051],{"class":672},[645,1638,1640],{"className":647,"code":1639,"filename":271,"language":650,"meta":651,"style":651},"initLogger({ drain })\n",[556,1641,1642],{"__ignoreMap":651},[655,1643,1644,1647,1649,1651,1653,1655],{"class":657,"line":658},[655,1645,1646],{"class":930},"initLogger",[655,1648,934],{"class":672},[655,1650,1520],{"class":665},[655,1652,1523],{"class":672},[655,1654,701],{"class":665},[655,1656,1051],{"class":672},[630,1658,1660],{"id":1659},"draincontext-reference","DrainContext Reference",[645,1662,1665],{"className":647,"code":1663,"filename":1664,"language":650,"meta":651,"style":651},"interface DrainContext {\n  \u002F** The complete wide event with all accumulated context *\u002F\n  event: WideEvent\n\n  \u002F** Request metadata *\u002F\n  request?: {\n    method: string\n    path: string\n    requestId: string\n  }\n\n  \u002F** Safe HTTP headers (sensitive headers filtered) *\u002F\n  headers?: Record\u003Cstring, string>\n}\n\ninterface WideEvent {\n  timestamp: string\n  level: 'debug' | 'info' | 'warn' | 'error'\n  service: string\n  environment?: string\n  version?: string\n  region?: string\n  commitHash?: string\n  requestId?: string\n  \u002F\u002F ... plus all fields added via log.set()\n  [key: string]: unknown\n}\n","types.ts",[556,1666,1667,1676,1681,1691,1695,1700,1709,1718,1727,1736,1741,1745,1750,1773,1777,1781,1790,1799,1840,1848,1857,1866,1875,1884,1893,1898,1918],{"__ignoreMap":651},[655,1668,1669,1671,1674],{"class":657,"line":658},[655,1670,727],{"class":726},[655,1672,1673],{"class":730}," DrainContext",[655,1675,666],{"class":665},[655,1677,1678],{"class":657,"line":669},[655,1679,1680],{"class":1332},"  \u002F** The complete wide event with all accumulated context *\u002F\n",[655,1682,1683,1686,1688],{"class":657,"line":679},[655,1684,1685],{"class":739},"  event",[655,1687,743],{"class":665},[655,1689,1690],{"class":730}," WideEvent\n",[655,1692,1693],{"class":657,"line":687},[655,1694,720],{"emptyLinePlaceholder":719},[655,1696,1697],{"class":657,"line":698},[655,1698,1699],{"class":1332},"  \u002F** Request metadata *\u002F\n",[655,1701,1702,1705,1707],{"class":657,"line":716},[655,1703,1704],{"class":739},"  request",[655,1706,755],{"class":665},[655,1708,666],{"class":665},[655,1710,1711,1714,1716],{"class":657,"line":723},[655,1712,1713],{"class":739},"    method",[655,1715,743],{"class":665},[655,1717,746],{"class":730},[655,1719,1720,1723,1725],{"class":657,"line":736},[655,1721,1722],{"class":739},"    path",[655,1724,743],{"class":665},[655,1726,746],{"class":730},[655,1728,1729,1732,1734],{"class":657,"line":749},[655,1730,1731],{"class":739},"    requestId",[655,1733,743],{"class":665},[655,1735,746],{"class":730},[655,1737,1738],{"class":657,"line":760},[655,1739,1740],{"class":665},"  }\n",[655,1742,1743],{"class":657,"line":771},[655,1744,720],{"emptyLinePlaceholder":719},[655,1746,1747],{"class":657,"line":777},[655,1748,1749],{"class":1332},"  \u002F** Safe HTTP headers (sensitive headers filtered) *\u002F\n",[655,1751,1752,1755,1757,1760,1762,1765,1767,1770],{"class":657,"line":782},[655,1753,1754],{"class":739},"  headers",[655,1756,755],{"class":665},[655,1758,1759],{"class":730}," Record",[655,1761,795],{"class":665},[655,1763,1764],{"class":730},"string",[655,1766,832],{"class":665},[655,1768,1769],{"class":730}," string",[655,1771,1772],{"class":665},">\n",[655,1774,1775],{"class":657,"line":813},[655,1776,774],{"class":665},[655,1778,1779],{"class":657,"line":856},[655,1780,720],{"emptyLinePlaceholder":719},[655,1782,1783,1785,1788],{"class":657,"line":891},[655,1784,727],{"class":726},[655,1786,1787],{"class":730}," WideEvent",[655,1789,666],{"class":665},[655,1791,1792,1795,1797],{"class":657,"line":910},[655,1793,1794],{"class":739},"  timestamp",[655,1796,743],{"class":665},[655,1798,746],{"class":730},[655,1800,1801,1804,1806,1808,1811,1813,1816,1818,1821,1823,1825,1827,1830,1832,1834,1836,1838],{"class":657,"line":916},[655,1802,1803],{"class":739},"  level",[655,1805,743],{"class":665},[655,1807,707],{"class":665},[655,1809,1810],{"class":710},"debug",[655,1812,829],{"class":665},[655,1814,1815],{"class":665}," |",[655,1817,707],{"class":665},[655,1819,1820],{"class":710},"info",[655,1822,829],{"class":665},[655,1824,1815],{"class":665},[655,1826,707],{"class":665},[655,1828,1829],{"class":710},"warn",[655,1831,829],{"class":665},[655,1833,1815],{"class":665},[655,1835,707],{"class":665},[655,1837,1087],{"class":710},[655,1839,713],{"class":665},[655,1841,1842,1844,1846],{"class":657,"line":921},[655,1843,1471],{"class":739},[655,1845,743],{"class":665},[655,1847,746],{"class":730},[655,1849,1850,1853,1855],{"class":657,"line":955},[655,1851,1852],{"class":739},"  environment",[655,1854,755],{"class":665},[655,1856,746],{"class":730},[655,1858,1859,1862,1864],{"class":657,"line":975},[655,1860,1861],{"class":739},"  version",[655,1863,755],{"class":665},[655,1865,746],{"class":730},[655,1867,1868,1871,1873],{"class":657,"line":991},[655,1869,1870],{"class":739},"  region",[655,1872,755],{"class":665},[655,1874,746],{"class":730},[655,1876,1877,1880,1882],{"class":657,"line":1010},[655,1878,1879],{"class":739},"  commitHash",[655,1881,755],{"class":665},[655,1883,746],{"class":730},[655,1885,1886,1889,1891],{"class":657,"line":1054},[655,1887,1888],{"class":739},"  requestId",[655,1890,755],{"class":665},[655,1892,746],{"class":730},[655,1894,1895],{"class":657,"line":1079},[655,1896,1897],{"class":1332},"  \u002F\u002F ... plus all fields added via log.set()\n",[655,1899,1900,1903,1906,1908,1910,1913,1915],{"class":657,"line":1101},[655,1901,1902],{"class":672},"  [",[655,1904,1905],{"class":937},"key",[655,1907,743],{"class":665},[655,1909,1769],{"class":730},[655,1911,1912],{"class":672},"]",[655,1914,743],{"class":665},[655,1916,1917],{"class":730}," unknown\n",[655,1919,1920],{"class":657,"line":1110},[655,1921,774],{"class":665},[630,1923,1925],{"id":1924},"standardized-config-priority","Standardized config priority",[553,1927,1928,1931],{},[556,1929,1930],{},"resolveAdapterConfig(namespace, fields, overrides)"," walks the standard chain so users get the same configuration UX as built-in adapters:",[1933,1934,1935,1941,1947,1953,1959],"ol",{},[594,1936,1937,1938,1940],{},"Explicit ",[556,1939,938],{}," passed to your factory",[594,1942,1943,1946],{},[556,1944,1945],{},"runtimeConfig.evlog.\u003Cnamespace>"," (Nuxt\u002FNitro)",[594,1948,1949,1952],{},[556,1950,1951],{},"runtimeConfig.\u003Cnamespace>"," (legacy Nuxt\u002FNitro)",[594,1954,1955,1958],{},[556,1956,1957],{},"NUXT_\u003CNS>_\u003CFIELD>"," env vars",[594,1960,1961,1958],{},[556,1962,1963],{},"\u003CNS>_\u003CFIELD>",[553,1965,1966,1967,1969,1970,1969,1972,1969,1975,1977,1978,1981,1982,1984,1985,1988,1989,1992,1993,1996],{},"Field names should follow the project conventions: ",[556,1968,826],{},", ",[556,1971,867],{},[556,1973,1974],{},"serviceName",[556,1976,902],{},". If you're renaming an existing field (e.g. ",[556,1979,1980],{},"token"," → ",[556,1983,826],{},"), keep both as ",[556,1986,1987],{},"ConfigField"," entries for one major version — see ",[556,1990,1991],{},"axiom.ts"," and ",[556,1994,1995],{},"better-stack.ts"," for the deprecation pattern.",[630,1998,2000],{"id":1999},"filtering-and-transforming-events","Filtering and transforming events",[553,2002,2003,2005,2006,2009],{},[556,2004,570],{}," receives the full batch of ",[556,2007,2008],{},"WideEvent[]"," plus the resolved config. Filter or transform inline:",[645,2011,2013],{"className":647,"code":2012,"language":650,"meta":651,"style":651},"encode: (events, cfg) => {\n  const filtered = events.filter(e => e.level === 'error' && e.path !== '\u002Fhealth')\n  if (filtered.length === 0) return null\n\n  const payload = filtered.map(e => ({\n    ts: new Date(e.timestamp).getTime(),\n    severity: e.level.toUpperCase(),\n    attributes: { method: e.method, path: e.path, status: e.status, duration: e.duration },\n  }))\n\n  return {\n    url: `${cfg.endpoint}\u002Fv1\u002Fpush`,\n    headers: { 'Content-Type': 'application\u002Fjson' },\n    body: JSON.stringify(payload),\n  }\n}\n",[556,2014,2015,2036,2100,2128,2132,2158,2192,2214,2278,2284,2288,2294,2318,2343,2365,2369],{"__ignoreMap":651},[655,2016,2017,2020,2022,2024,2026,2028,2030,2032,2034],{"class":657,"line":658},[655,2018,2019],{"class":730},"encode",[655,2021,743],{"class":665},[655,2023,1060],{"class":665},[655,2025,1146],{"class":937},[655,2027,832],{"class":665},[655,2029,1016],{"class":937},[655,2031,1153],{"class":665},[655,2033,1005],{"class":726},[655,2035,666],{"class":665},[655,2037,2038,2041,2044,2046,2049,2051,2054,2056,2059,2061,2064,2066,2069,2072,2074,2076,2078,2081,2083,2085,2088,2091,2093,2096,2098],{"class":657,"line":669},[655,2039,2040],{"class":726},"  const",[655,2042,2043],{"class":672}," filtered",[655,2045,1019],{"class":665},[655,2047,2048],{"class":672}," events",[655,2050,1069],{"class":665},[655,2052,2053],{"class":930},"filter",[655,2055,934],{"class":739},[655,2057,2058],{"class":937},"e",[655,2060,1005],{"class":726},[655,2062,2063],{"class":672}," e",[655,2065,1069],{"class":665},[655,2067,2068],{"class":672},"level",[655,2070,2071],{"class":665}," ===",[655,2073,707],{"class":665},[655,2075,1087],{"class":710},[655,2077,829],{"class":665},[655,2079,2080],{"class":665}," &&",[655,2082,2063],{"class":672},[655,2084,1069],{"class":665},[655,2086,2087],{"class":672},"path",[655,2089,2090],{"class":665}," !==",[655,2092,707],{"class":665},[655,2094,2095],{"class":710},"\u002Fhealth",[655,2097,829],{"class":665},[655,2099,1051],{"class":739},[655,2101,2102,2105,2107,2110,2112,2115,2117,2121,2123,2126],{"class":657,"line":679},[655,2103,2104],{"class":661},"  if",[655,2106,1060],{"class":739},[655,2108,2109],{"class":672},"filtered",[655,2111,1069],{"class":665},[655,2113,2114],{"class":672},"length",[655,2116,2071],{"class":665},[655,2118,2120],{"class":2119},"sbssI"," 0",[655,2122,1074],{"class":739},[655,2124,2125],{"class":661},"return",[655,2127,1107],{"class":665},[655,2129,2130],{"class":657,"line":687},[655,2131,720],{"emptyLinePlaceholder":719},[655,2133,2134,2136,2139,2141,2143,2145,2148,2150,2152,2154,2156],{"class":657,"line":698},[655,2135,2040],{"class":726},[655,2137,2138],{"class":672}," payload",[655,2140,1019],{"class":665},[655,2142,2043],{"class":672},[655,2144,1069],{"class":665},[655,2146,2147],{"class":930},"map",[655,2149,934],{"class":739},[655,2151,2058],{"class":937},[655,2153,1005],{"class":726},[655,2155,1060],{"class":739},[655,2157,972],{"class":665},[655,2159,2160,2163,2165,2168,2171,2173,2175,2177,2180,2182,2184,2187,2190],{"class":657,"line":716},[655,2161,2162],{"class":739},"    ts",[655,2164,743],{"class":665},[655,2166,2167],{"class":665}," new",[655,2169,2170],{"class":930}," Date",[655,2172,934],{"class":739},[655,2174,2058],{"class":672},[655,2176,1069],{"class":665},[655,2178,2179],{"class":672},"timestamp",[655,2181,1153],{"class":739},[655,2183,1069],{"class":665},[655,2185,2186],{"class":930},"getTime",[655,2188,2189],{"class":739},"()",[655,2191,676],{"class":665},[655,2193,2194,2197,2199,2201,2203,2205,2207,2210,2212],{"class":657,"line":723},[655,2195,2196],{"class":739},"    severity",[655,2198,743],{"class":665},[655,2200,2063],{"class":672},[655,2202,1069],{"class":665},[655,2204,2068],{"class":672},[655,2206,1069],{"class":665},[655,2208,2209],{"class":930},"toUpperCase",[655,2211,2189],{"class":739},[655,2213,676],{"class":665},[655,2215,2216,2219,2221,2223,2226,2228,2230,2232,2235,2237,2240,2242,2244,2246,2248,2250,2253,2255,2257,2259,2262,2264,2267,2269,2271,2273,2276],{"class":657,"line":736},[655,2217,2218],{"class":739},"    attributes",[655,2220,743],{"class":665},[655,2222,1410],{"class":665},[655,2224,2225],{"class":739}," method",[655,2227,743],{"class":665},[655,2229,2063],{"class":672},[655,2231,1069],{"class":665},[655,2233,2234],{"class":672},"method",[655,2236,832],{"class":665},[655,2238,2239],{"class":739}," path",[655,2241,743],{"class":665},[655,2243,2063],{"class":672},[655,2245,1069],{"class":665},[655,2247,2087],{"class":672},[655,2249,832],{"class":665},[655,2251,2252],{"class":739}," status",[655,2254,743],{"class":665},[655,2256,2063],{"class":672},[655,2258,1069],{"class":665},[655,2260,2261],{"class":672},"status",[655,2263,832],{"class":665},[655,2265,2266],{"class":739}," duration",[655,2268,743],{"class":665},[655,2270,2063],{"class":672},[655,2272,1069],{"class":665},[655,2274,2275],{"class":672},"duration",[655,2277,907],{"class":665},[655,2279,2280,2282],{"class":657,"line":749},[655,2281,1302],{"class":665},[655,2283,1528],{"class":739},[655,2285,2286],{"class":657,"line":760},[655,2287,720],{"emptyLinePlaceholder":719},[655,2289,2290,2292],{"class":657,"line":771},[655,2291,958],{"class":661},[655,2293,666],{"class":665},[655,2295,2296,2299,2301,2303,2305,2307,2309,2311,2314,2316],{"class":657,"line":777},[655,2297,2298],{"class":739},"    url",[655,2300,743],{"class":665},[655,2302,1170],{"class":665},[655,2304,1066],{"class":672},[655,2306,1069],{"class":665},[655,2308,867],{"class":672},[655,2310,701],{"class":665},[655,2312,2313],{"class":710},"\u002Fv1\u002Fpush",[655,2315,1194],{"class":665},[655,2317,676],{"class":665},[655,2319,2320,2323,2325,2327,2329,2331,2333,2335,2337,2339,2341],{"class":657,"line":782},[655,2321,2322],{"class":739},"    headers",[655,2324,743],{"class":665},[655,2326,1410],{"class":665},[655,2328,707],{"class":665},[655,2330,1215],{"class":739},[655,2332,829],{"class":665},[655,2334,743],{"class":665},[655,2336,707],{"class":665},[655,2338,1224],{"class":710},[655,2340,829],{"class":665},[655,2342,907],{"class":665},[655,2344,2345,2348,2350,2352,2354,2356,2358,2361,2363],{"class":657,"line":813},[655,2346,2347],{"class":739},"    body",[655,2349,743],{"class":665},[655,2351,1273],{"class":672},[655,2353,1069],{"class":665},[655,2355,1278],{"class":930},[655,2357,934],{"class":739},[655,2359,2360],{"class":672},"payload",[655,2362,1153],{"class":739},[655,2364,676],{"class":665},[655,2366,2367],{"class":657,"line":856},[655,2368,1740],{"class":665},[655,2370,2371],{"class":657,"line":891},[655,2372,774],{"class":665},[553,2374,2375,2376,2379,2380,2382],{},"Returning ",[556,2377,2378],{},"null"," from ",[556,2381,570],{}," is a clean opt-out — the drain stays a no-op for that batch.",[630,2384,2386,2387],{"id":2385},"when-you-cant-use-definehttpdrain","When you can't use ",[556,2388,562],{},[553,2390,2391,2392,743],{},"If your destination requires a non-HTTP transport (gRPC, websocket, vendor SDK), drop one level lower with ",[556,2393,2394],{},"defineDrain",[645,2396,2398],{"className":647,"code":2397,"language":650,"meta":651,"style":651},"import { defineDrain, type DrainContext } from 'evlog\u002Ftoolkit'\n\nexport const createCustomTransportDrain = () =>\n  defineDrain\u003C{ apiKey: string }>({\n    name: 'custom',\n    resolve: async () => ({ apiKey: process.env.MY_KEY! }),\n    send: async (events, cfg) => {\n      await myVendorSdk.publish(events, { token: cfg.apiKey })\n    },\n  })\n",[556,2399,2400,2426,2430,2446,2468,2483,2524,2547,2583,2587],{"__ignoreMap":651},[655,2401,2402,2404,2406,2409,2411,2414,2416,2418,2420,2422,2424],{"class":657,"line":658},[655,2403,662],{"class":661},[655,2405,1410],{"class":665},[655,2407,2408],{"class":672}," defineDrain",[655,2410,832],{"class":665},[655,2412,2413],{"class":661}," type",[655,2415,1673],{"class":672},[655,2417,1416],{"class":665},[655,2419,704],{"class":661},[655,2421,707],{"class":665},[655,2423,558],{"class":710},[655,2425,713],{"class":665},[655,2427,2428],{"class":657,"line":669},[655,2429,720],{"emptyLinePlaceholder":719},[655,2431,2432,2434,2436,2439,2441,2443],{"class":657,"line":679},[655,2433,924],{"class":661},[655,2435,1436],{"class":726},[655,2437,2438],{"class":672}," createCustomTransportDrain ",[655,2440,807],{"class":665},[655,2442,1002],{"class":665},[655,2444,2445],{"class":726}," =>\n",[655,2447,2448,2451,2454,2457,2459,2461,2464,2466],{"class":657,"line":687},[655,2449,2450],{"class":930},"  defineDrain",[655,2452,2453],{"class":665},"\u003C{",[655,2455,2456],{"class":739}," apiKey",[655,2458,743],{"class":665},[655,2460,1769],{"class":730},[655,2462,2463],{"class":665}," }>",[655,2465,934],{"class":672},[655,2467,972],{"class":665},[655,2469,2470,2472,2474,2476,2479,2481],{"class":657,"line":698},[655,2471,978],{"class":739},[655,2473,743],{"class":665},[655,2475,707],{"class":665},[655,2477,2478],{"class":710},"custom",[655,2480,829],{"class":665},[655,2482,676],{"class":665},[655,2484,2485,2487,2489,2491,2493,2495,2497,2499,2501,2503,2506,2508,2511,2513,2516,2518,2520,2522],{"class":657,"line":716},[655,2486,994],{"class":930},[655,2488,743],{"class":665},[655,2490,999],{"class":726},[655,2492,1002],{"class":665},[655,2494,1005],{"class":726},[655,2496,1060],{"class":672},[655,2498,1520],{"class":665},[655,2500,2456],{"class":739},[655,2502,743],{"class":665},[655,2504,2505],{"class":672}," process",[655,2507,1069],{"class":665},[655,2509,2510],{"class":672},"env",[655,2512,1069],{"class":665},[655,2514,2515],{"class":672},"MY_KEY",[655,2517,1063],{"class":665},[655,2519,1416],{"class":665},[655,2521,1153],{"class":672},[655,2523,676],{"class":665},[655,2525,2526,2529,2531,2533,2535,2537,2539,2541,2543,2545],{"class":657,"line":723},[655,2527,2528],{"class":930},"    send",[655,2530,743],{"class":665},[655,2532,999],{"class":726},[655,2534,1060],{"class":665},[655,2536,1146],{"class":937},[655,2538,832],{"class":665},[655,2540,1016],{"class":937},[655,2542,1153],{"class":665},[655,2544,1005],{"class":726},[655,2546,666],{"class":665},[655,2548,2549,2552,2555,2557,2560,2562,2564,2566,2568,2571,2573,2575,2577,2579,2581],{"class":657,"line":736},[655,2550,2551],{"class":661},"      await",[655,2553,2554],{"class":672}," myVendorSdk",[655,2556,1069],{"class":665},[655,2558,2559],{"class":930},"publish",[655,2561,934],{"class":739},[655,2563,1146],{"class":672},[655,2565,832],{"class":665},[655,2567,1410],{"class":665},[655,2569,2570],{"class":739}," token",[655,2572,743],{"class":665},[655,2574,1016],{"class":672},[655,2576,1069],{"class":665},[655,2578,826],{"class":672},[655,2580,1416],{"class":665},[655,2582,1051],{"class":739},[655,2584,2585],{"class":657,"line":749},[655,2586,1133],{"class":665},[655,2588,2589,2591],{"class":657,"line":760},[655,2590,1302],{"class":665},[655,2592,1051],{"class":672},[553,2594,2595],{},"You still get config resolution, error isolation, and a consistent shape — you just own the wire transport.",[630,2597,2599],{"id":2598},"batching","Batching",[553,2601,2602,2603,2606],{},"For high-throughput scenarios, use the ",[619,2604,2605],{"href":515},"Drain Pipeline"," to batch events, retry on failure, and handle buffer overflow automatically:",[645,2608,2610],{"className":647,"code":2609,"filename":649,"language":650,"meta":651,"style":651},"import type { DrainContext } from 'evlog'\nimport { createDrainPipeline } from 'evlog\u002Fpipeline'\n\nconst pipeline = createDrainPipeline\u003CDrainContext>({\n  batch: { size: 100, intervalMs: 5000 },\n})\n\nconst drain = pipeline(async (batch) => {\n  await fetch('https:\u002F\u002Fapi.example.com\u002Flogs\u002Fbatch', {\n    method: 'POST',\n    body: JSON.stringify(batch.map(ctx => ctx.event)),\n  })\n})\n",[556,2611,2612,2632,2652,2656,2677,2706,2712,2716,2743,2764,2779,2819,2825],{"__ignoreMap":651},[655,2613,2614,2616,2618,2620,2622,2624,2626,2628,2630],{"class":657,"line":658},[655,2615,662],{"class":661},[655,2617,2413],{"class":661},[655,2619,1410],{"class":665},[655,2621,1673],{"class":672},[655,2623,1416],{"class":665},[655,2625,704],{"class":661},[655,2627,707],{"class":665},[655,2629,1515],{"class":710},[655,2631,713],{"class":665},[655,2633,2634,2636,2638,2641,2643,2645,2647,2650],{"class":657,"line":669},[655,2635,662],{"class":661},[655,2637,1410],{"class":665},[655,2639,2640],{"class":672}," createDrainPipeline",[655,2642,1416],{"class":665},[655,2644,704],{"class":661},[655,2646,707],{"class":665},[655,2648,2649],{"class":710},"evlog\u002Fpipeline",[655,2651,713],{"class":665},[655,2653,2654],{"class":657,"line":679},[655,2655,720],{"emptyLinePlaceholder":719},[655,2657,2658,2660,2663,2665,2667,2669,2671,2673,2675],{"class":657,"line":687},[655,2659,785],{"class":726},[655,2661,2662],{"class":672}," pipeline ",[655,2664,807],{"class":665},[655,2666,2640],{"class":930},[655,2668,795],{"class":665},[655,2670,577],{"class":730},[655,2672,801],{"class":665},[655,2674,934],{"class":672},[655,2676,972],{"class":665},[655,2678,2679,2682,2684,2686,2689,2691,2694,2696,2699,2701,2704],{"class":657,"line":698},[655,2680,2681],{"class":739},"  batch",[655,2683,743],{"class":665},[655,2685,1410],{"class":665},[655,2687,2688],{"class":739}," size",[655,2690,743],{"class":665},[655,2692,2693],{"class":2119}," 100",[655,2695,832],{"class":665},[655,2697,2698],{"class":739}," intervalMs",[655,2700,743],{"class":665},[655,2702,2703],{"class":2119}," 5000",[655,2705,907],{"class":665},[655,2707,2708,2710],{"class":657,"line":716},[655,2709,701],{"class":665},[655,2711,1051],{"class":672},[655,2713,2714],{"class":657,"line":723},[655,2715,720],{"emptyLinePlaceholder":719},[655,2717,2718,2720,2722,2724,2727,2729,2732,2734,2737,2739,2741],{"class":657,"line":736},[655,2719,785],{"class":726},[655,2721,1523],{"class":672},[655,2723,807],{"class":665},[655,2725,2726],{"class":930}," pipeline",[655,2728,934],{"class":672},[655,2730,2731],{"class":726},"async",[655,2733,1060],{"class":665},[655,2735,2736],{"class":937},"batch",[655,2738,1153],{"class":665},[655,2740,1005],{"class":726},[655,2742,666],{"class":665},[655,2744,2745,2748,2751,2753,2755,2758,2760,2762],{"class":657,"line":749},[655,2746,2747],{"class":661},"  await",[655,2749,2750],{"class":930}," fetch",[655,2752,934],{"class":739},[655,2754,829],{"class":665},[655,2756,2757],{"class":710},"https:\u002F\u002Fapi.example.com\u002Flogs\u002Fbatch",[655,2759,829],{"class":665},[655,2761,832],{"class":665},[655,2763,666],{"class":665},[655,2765,2766,2768,2770,2772,2775,2777],{"class":657,"line":760},[655,2767,1713],{"class":739},[655,2769,743],{"class":665},[655,2771,707],{"class":665},[655,2773,2774],{"class":710},"POST",[655,2776,829],{"class":665},[655,2778,676],{"class":665},[655,2780,2781,2783,2785,2787,2789,2791,2793,2795,2797,2799,2801,2804,2806,2809,2811,2814,2817],{"class":657,"line":771},[655,2782,2347],{"class":739},[655,2784,743],{"class":665},[655,2786,1273],{"class":672},[655,2788,1069],{"class":665},[655,2790,1278],{"class":930},[655,2792,934],{"class":739},[655,2794,2736],{"class":672},[655,2796,1069],{"class":665},[655,2798,2147],{"class":930},[655,2800,934],{"class":739},[655,2802,2803],{"class":937},"ctx",[655,2805,1005],{"class":726},[655,2807,2808],{"class":672}," ctx",[655,2810,1069],{"class":665},[655,2812,2813],{"class":672},"event",[655,2815,2816],{"class":739},"))",[655,2818,676],{"class":665},[655,2820,2821,2823],{"class":657,"line":777},[655,2822,1302],{"class":665},[655,2824,1051],{"class":739},[655,2826,2827,2829],{"class":657,"line":782},[655,2828,701],{"class":665},[655,2830,1051],{"class":672},[2832,2833,2835,2836,2839],"callout",{"color":1820,"icon":2834},"i-lucide-arrow-right","See the ",[619,2837,2838],{"href":515},"Pipeline documentation"," for the full options reference, retry strategies, and buffer overflow handling.",[630,2841,2843],{"id":2842},"error-handling-already-done-for-you","Error Handling — already done for you",[553,2845,2846,2848],{},[556,2847,562],{}," enforces every best practice automatically:",[1933,2850,2851,2862,2872,2880],{},[594,2852,2853,2857,2858,2861],{},[2854,2855,2856],"strong",{},"Never throws"," — failures are caught and logged with the ",[556,2859,2860],{},"[evlog\u002F\u003Cname>]"," prefix.",[594,2863,2864,2867,2868,2871],{},[2854,2865,2866],{},"Retries"," — defaults to 2 attempts on transient errors (configurable via ",[556,2869,2870],{},"retries",").",[594,2873,2874,2877,2878,2871],{},[2854,2875,2876],{},"Timeouts"," — defaults to 5000ms (configurable via ",[556,2879,902],{},[594,2881,2882,2885,2886,2888,2889,2891],{},[2854,2883,2884],{},"Graceful degradation"," — ",[556,2887,566],{}," returning ",[556,2890,2378],{}," makes the drain a no-op.",[553,2893,2894,2895,2897,2898,2901,2902,2905],{},"If you fall back to ",[556,2896,2394],{}," for non-HTTP transports, follow the same rules manually — wrap the transport in ",[556,2899,2900],{},"try\u002Fcatch",", log with ",[556,2903,2904],{},"console.error('[evlog\u002F\u003Cname>] …')",", and never re-throw.",[630,2907,2909],{"id":2908},"next-steps","Next Steps",[591,2911,2912,2918,2924,2930],{},[594,2913,2914,2917],{},[619,2915,2916],{"href":461},"Axiom Adapter"," - See a production-ready adapter implementation",[594,2919,2920,2923],{},[619,2921,2922],{"href":466},"OTLP Adapter"," - OpenTelemetry Protocol adapter",[594,2925,2926,2929],{},[619,2927,2928],{"href":471},"PostHog Adapter"," - PostHog product analytics adapter",[594,2931,2932,2934],{},[619,2933,185],{"href":186}," - Security and production tips",[2936,2937,2938],"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 .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 .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}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 .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 .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":651,"searchDepth":669,"depth":669,"links":2940},[2941,2943,2944,2945,2946,2948,2949,2950],{"id":632,"depth":669,"text":2942},"Recipe — defineHttpDrain in 15 lines",{"id":1659,"depth":669,"text":1660},{"id":1924,"depth":669,"text":1925},{"id":1999,"depth":669,"text":2000},{"id":2385,"depth":669,"text":2947},"When you can't use defineHttpDrain",{"id":2598,"depth":669,"text":2599},{"id":2842,"depth":669,"text":2843},{"id":2908,"depth":669,"text":2909},"Build your own adapter to send logs to any destination using defineHttpDrain — config resolution, retries, timeouts, and error handling are handled for you.","md",[2954,2957],{"label":2916,"icon":463,"to":461,"color":2955,"variant":2956},"neutral","subtle",{"label":185,"icon":129,"to":186,"color":2955,"variant":2956},{},{"icon":83},{"title":523,"description":2951},"y3SEJzJOQWr98KRcRYbmwenqorLQM3z7gyQP-04pMtM",[2963,2965],{"title":518,"path":519,"stem":520,"description":2964,"icon":521,"children":-1},"Framework-agnostic HTTP log transport for sending client-side logs to your server via fetch or sendBeacon. Works in the browser or any environment with fetch. Use the `evlog\u002Fhttp` entry point.",{"title":527,"path":528,"stem":529,"description":2966,"icon":530,"children":-1},"The evlog\u002Ftoolkit public API — every primitive used to build adapters, enrichers, plugins, and framework integrations.",1778338245145]