[{"data":1,"prerenderedAt":3672},["ShallowReactive",2],{"navigation_docs":3,"-extend-custom-drains":529,"-extend-custom-drains-surround":3667},[4,30,80,128,308,440,499],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Start","\u002Fstart","1.start",[9,14,19,24],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":20,"path":21,"stem":22,"icon":23},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":25,"path":26,"stem":27,"icon":28},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Learn","\u002Flearn","2.learn",[35,40,45,50,55,60,65,70,75],{"title":36,"path":37,"stem":38,"icon":39},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":41,"path":42,"stem":43,"icon":44},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":46,"path":47,"stem":48,"icon":49},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":51,"path":52,"stem":53,"icon":54},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":56,"path":57,"stem":58,"icon":59},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":61,"path":62,"stem":63,"icon":64},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":66,"path":67,"stem":68,"icon":69},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":71,"path":72,"stem":73,"icon":74},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":76,"path":77,"stem":78,"icon":79},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":81,"path":82,"stem":83,"children":84,"page":29},"CLI","\u002Fcli","3.cli",[85,88,93,98,103,108,113,118,123],{"title":36,"path":86,"stem":87,"icon":44},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":89,"path":90,"stem":91,"icon":92},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":94,"path":95,"stem":96,"icon":97},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":99,"path":100,"stem":101,"icon":102},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":104,"path":105,"stem":106,"icon":107},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":109,"path":110,"stem":111,"icon":112},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":114,"path":115,"stem":116,"icon":117},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":119,"path":120,"stem":121,"icon":122},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":124,"path":125,"stem":126,"icon":127},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":129,"path":130,"stem":131,"children":132,"page":29},"Integrate","\u002Fintegrate","4.integrate",[133,137,220],{"title":36,"path":134,"stem":135,"icon":136},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"page":29},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[142,145,175,200],{"title":36,"path":143,"stem":144,"icon":39},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":146,"path":147,"stem":148,"children":149,"page":29},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[150,155,160,165,170],{"title":151,"path":152,"stem":153,"icon":154},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":156,"path":157,"stem":158,"icon":159},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":161,"path":162,"stem":163,"icon":164},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":166,"path":167,"stem":168,"icon":169},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":171,"path":172,"stem":173,"icon":174},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":176,"path":177,"stem":178,"children":179,"page":29},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[180,185,190,195],{"title":181,"path":182,"stem":183,"icon":184},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":186,"path":187,"stem":188,"icon":189},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":191,"path":192,"stem":193,"icon":194},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":196,"path":197,"stem":198,"icon":199},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":201,"path":202,"stem":203,"children":204,"page":29},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[205,210,215],{"title":206,"path":207,"stem":208,"icon":209},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":211,"path":212,"stem":213,"icon":214},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":216,"path":217,"stem":218,"icon":219},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":221,"path":222,"stem":223,"children":224,"page":29},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[225,229,234,239,244,249,254,259,264,269,274,279,284,289,293,298,303],{"title":36,"path":226,"stem":227,"icon":228},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":230,"path":231,"stem":232,"icon":233},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":235,"path":236,"stem":237,"icon":238},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":240,"path":241,"stem":242,"icon":243},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":245,"path":246,"stem":247,"icon":248},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":250,"path":251,"stem":252,"icon":253},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":255,"path":256,"stem":257,"icon":258},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":260,"path":261,"stem":262,"icon":263},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":265,"path":266,"stem":267,"icon":268},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":270,"path":271,"stem":272,"icon":273},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":275,"path":276,"stem":277,"icon":278},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":280,"path":281,"stem":282,"icon":283},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":285,"path":286,"stem":287,"icon":288},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":290,"path":291,"stem":292,"icon":74},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":294,"path":295,"stem":296,"icon":297},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":299,"path":300,"stem":301,"icon":302},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":304,"path":305,"stem":306,"icon":307},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":309,"path":310,"stem":311,"children":312,"page":29},"Use Cases","\u002Fuse-cases","5.use-cases",[313,316,321,350,377,409,430,435],{"title":36,"path":314,"stem":315,"icon":102},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":317,"path":318,"stem":319,"icon":320},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":322,"icon":323,"path":324,"stem":325,"children":326,"page":29},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[327,330,335,340,345],{"title":36,"path":328,"stem":329,"icon":39},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":331,"path":332,"stem":333,"icon":334},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":336,"path":337,"stem":338,"icon":339},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":341,"path":342,"stem":343,"icon":344},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":346,"path":347,"stem":348,"icon":349},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":351,"icon":352,"path":353,"stem":354,"children":355,"page":29},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[356,359,364,369,373],{"title":36,"path":357,"stem":358,"icon":39},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":360,"path":361,"stem":362,"icon":363},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":365,"path":366,"stem":367,"icon":368},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":370,"path":371,"stem":372,"icon":320},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":374,"path":375,"stem":376,"icon":107},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":378,"icon":379,"path":380,"stem":381,"children":382,"page":29},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[383,386,391,396,401,405],{"title":36,"path":384,"stem":385,"icon":39},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":387,"path":388,"stem":389,"icon":390},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":392,"path":393,"stem":394,"icon":395},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":397,"path":398,"stem":399,"icon":400},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":402,"path":403,"stem":404,"icon":379},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":406,"path":407,"stem":408,"icon":79},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":346,"icon":107,"path":410,"stem":411,"children":412,"page":29},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[413,416,421,426],{"title":36,"path":414,"stem":415,"icon":39},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":417,"path":418,"stem":419,"icon":420},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":422,"path":423,"stem":424,"icon":425},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":427,"path":428,"stem":429,"icon":79},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":431,"path":432,"stem":433,"icon":434},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":436,"path":437,"stem":438,"icon":439},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":441,"path":442,"stem":443,"children":444,"page":29},"Extend","\u002Fextend","6.extend",[445,449,454,459,463,468,472,476,480,484,489,494],{"title":36,"path":446,"stem":447,"icon":448},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":450,"path":451,"stem":452,"icon":453},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":455,"path":456,"stem":457,"icon":458},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":460,"path":461,"stem":462,"icon":453},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":464,"path":465,"stem":466,"icon":467},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":406,"path":469,"stem":470,"icon":471},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":473,"path":474,"stem":475,"icon":448},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":477,"path":478,"stem":479,"icon":434},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":481,"path":482,"stem":483,"icon":64},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":485,"path":486,"stem":487,"icon":488},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":490,"path":491,"stem":492,"icon":493},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":495,"path":496,"stem":497,"icon":498},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":427,"path":500,"stem":501,"children":502,"page":29},"\u002Freference","7.reference",[503,508,511,516,520,525],{"title":504,"path":505,"stem":506,"icon":507},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":374,"path":509,"stem":510,"icon":107},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":512,"path":513,"stem":514,"icon":515},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":517,"path":518,"stem":519,"icon":379},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":521,"path":522,"stem":523,"icon":524},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":526,"path":527,"stem":528,"icon":434},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"id":530,"title":531,"body":532,"description":3655,"extension":3656,"links":3657,"meta":3663,"navigation":3664,"path":491,"seo":3665,"stem":492,"__hash__":3666},"docs\u002F6.extend\u002F8.custom-drains.md","Custom Drains",{"type":533,"value":534,"toc":3638},"minimark",[535,549,552,603,610,731,738,751,1418,1432,1437,1440,1915,1919,1924,1965,1995,1999,2006,2441,2449,2453,2465,2821,2827,2833,3019,3036,3040,3050,3309,3326,3330,3335,3441,3444,3449,3490,3499,3503,3508,3550,3556,3560,3563,3571,3585,3597,3601,3634],[536,537,538,539,543,544,548],"p",{},"A ",[540,541,542],"strong",{},"drain"," is the terminal step of evlog's pipeline: a function that receives wide events and ships them somewhere — an HTTP API, a message queue, a database, a webhook, a local file. evlog ships built-in drains for popular providers (",[545,546,547],"a",{"href":143},"Adapters overview","). When you need a destination that isn't covered, you write your own.",[536,550,551],{},"Two factories cover every case:",[553,554,555,568],"table",{},[556,557,558],"thead",{},[559,560,561,565],"tr",{},[562,563,564],"th",{},"You have…",[562,566,567],{},"Use",[569,570,571,590],"tbody",{},[559,572,573,582],{},[574,575,576,577,581],"td",{},"An HTTP backend (REST, JSON ingest, vendor ",[578,579,580],"code",{},"\u002Fv1\u002Flogs"," endpoint)",[574,583,584],{},[545,585,587],{"href":586},"#definehttpdrain-the-http-recipe",[578,588,589],{},"defineHttpDrain",[559,591,592,595],{},[574,593,594],{},"A non-HTTP transport (gRPC, WebSocket, vendor SDK, queue, raw socket)",[574,596,597],{},[545,598,600],{"href":599},"#definedrain-non-http-transports",[578,601,602],{},"defineDrain",[536,604,605,606,609],{},"Both come from ",[578,607,608],{},"evlog\u002Ftoolkit"," and are the exact factories every built-in adapter uses.",[611,612,616,619,718],"prompt",{":actions":613,"description":614,"icon":615},"[\"copy\",\"cursor\",\"claude\"]","Build a custom evlog drain","i-lucide-code-2",[536,617,618],{},"Build a custom evlog drain that ships wide events to a backend without a built-in adapter.",[620,621,622,637,648,663,681,696,701,711],"ul",{},[623,624,625,626,629,630,632,633,636],"li",{},"For HTTP backends, use ",[578,627,628],{},"defineHttpDrain({ name, resolve, encode })"," from ",[578,631,608],{}," — never call ",[578,634,635],{},"fetch"," directly",[623,638,639,640,643,644,647],{},"For non-HTTP transports (queue, DB, native SDK, raw socket), use ",[578,641,642],{},"defineDrain({ name, send })"," and implement ",[578,645,646],{},"send(events)"," myself",[623,649,650,651,654,655,658,659,662],{},"Resolve config lazily inside ",[578,652,653],{},"resolve()"," via ",[578,656,657],{},"resolveAdapterConfig(namespace, fields, overrides)"," so users get the standard precedence (overrides → ",[578,660,661],{},"runtimeConfig.evlog.\u003Cns>"," → env)",[623,664,665,666,669,670,673,674,677,678],{},"Use the standardized field names: ",[578,667,668],{},"apiKey"," for bearer secrets, ",[578,671,672],{},"endpoint"," for the base URL, ",[578,675,676],{},"serviceName",", ",[578,679,680],{},"timeout",[623,682,683,684,687,688,691,692,695],{},"Encode batched events into the destination's wire format inside ",[578,685,686],{},"encode(events, config)"," — return ",[578,689,690],{},"{ url, headers, body }"," (or ",[578,693,694],{},"null"," to opt out of the batch)",[623,697,698,700],{},[578,699,589],{}," handles retries, timeouts, error isolation, batching, and identity headers — don't reimplement them",[623,702,703,704,707,708,710],{},"Wire the drain via ",[578,705,706],{},"defineEvlog({ drain: createMyDrain() })"," or my framework's middleware ",[578,709,542],{}," option",[623,712,713,714,717],{},"For production, wrap the result in ",[578,715,716],{},"createDrainPipeline"," for batching + retries",[536,719,720,721,726,727],{},"Docs: ",[545,722,723],{"href":723,"rel":724},"https:\u002F\u002Fwww.evlog.dev\u002Fextend\u002Fcustom-drains",[725],"nofollow","\nPipeline: ",[545,728,729],{"href":729,"rel":730},"https:\u002F\u002Fwww.evlog.dev\u002Fextend\u002Fdrain-pipeline",[725],[732,733,735,737],"h2",{"id":734},"definehttpdrain-the-http-recipe",[578,736,589],{}," (the HTTP recipe)",[536,739,740,741,743,744,746,747,750],{},"The recipe every built-in adapter follows. Two pure functions: ",[578,742,653],{}," returns the config (or ",[578,745,694],{}," to skip), ",[578,748,749],{},"encode()"," returns the HTTP request payload.",[752,753,754],"code-collapse",{},[755,756,762],"pre",{"className":757,"code":758,"filename":759,"language":760,"meta":761,"style":761},"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","",[578,763,764,777,787,795,806,824,831,844,857,868,879,885,890,921,963,997,1015,1021,1026,1060,1080,1097,1116,1160,1185,1207,1216,1222,1236,1242,1268,1305,1315,1337,1365,1371,1395,1405,1413],{"__ignoreMap":761},[765,766,769,773],"span",{"class":767,"line":768},"line",1,[765,770,772],{"class":771},"s7zQu","import",[765,774,776],{"class":775},"sMK4o"," {\n",[765,778,780,784],{"class":767,"line":779},2,[765,781,783],{"class":782},"sTEyZ","  defineHttpDrain",[765,785,786],{"class":775},",\n",[765,788,790,793],{"class":767,"line":789},3,[765,791,792],{"class":782},"  resolveAdapterConfig",[765,794,786],{"class":775},[765,796,798,801,804],{"class":767,"line":797},4,[765,799,800],{"class":771},"  type",[765,802,803],{"class":782}," ConfigField",[765,805,786],{"class":775},[765,807,809,812,815,818,821],{"class":767,"line":808},5,[765,810,811],{"class":775},"}",[765,813,814],{"class":771}," from",[765,816,817],{"class":775}," '",[765,819,608],{"class":820},"sfazB",[765,822,823],{"class":775},"'\n",[765,825,827],{"class":767,"line":826},6,[765,828,830],{"emptyLinePlaceholder":829},true,"\n",[765,832,834,838,842],{"class":767,"line":833},7,[765,835,837],{"class":836},"spNyl","interface",[765,839,841],{"class":840},"sBMFI"," MyServiceConfig",[765,843,776],{"class":775},[765,845,847,851,854],{"class":767,"line":846},8,[765,848,850],{"class":849},"swJcz","  apiKey",[765,852,853],{"class":775},":",[765,855,856],{"class":840}," string\n",[765,858,860,863,866],{"class":767,"line":859},9,[765,861,862],{"class":849},"  endpoint",[765,864,865],{"class":775},"?:",[765,867,856],{"class":840},[765,869,871,874,876],{"class":767,"line":870},10,[765,872,873],{"class":849},"  timeout",[765,875,865],{"class":775},[765,877,878],{"class":840}," number\n",[765,880,882],{"class":767,"line":881},11,[765,883,884],{"class":775},"}\n",[765,886,888],{"class":767,"line":887},12,[765,889,830],{"emptyLinePlaceholder":829},[765,891,893,896,899,901,903,906,909,912,915,918],{"class":767,"line":892},13,[765,894,895],{"class":836},"const",[765,897,898],{"class":782}," FIELDS",[765,900,853],{"class":775},[765,902,803],{"class":840},[765,904,905],{"class":775},"\u003C",[765,907,908],{"class":840},"MyServiceConfig",[765,910,911],{"class":775},">",[765,913,914],{"class":782},"[] ",[765,916,917],{"class":775},"=",[765,919,920],{"class":782}," [\n",[765,922,924,927,930,932,934,936,939,942,945,947,950,952,955,957,960],{"class":767,"line":923},14,[765,925,926],{"class":775},"  {",[765,928,929],{"class":849}," key",[765,931,853],{"class":775},[765,933,817],{"class":775},[765,935,668],{"class":820},[765,937,938],{"class":775},"'",[765,940,941],{"class":775},",",[765,943,944],{"class":849}," env",[765,946,853],{"class":775},[765,948,949],{"class":782}," [",[765,951,938],{"class":775},[765,953,954],{"class":820},"MYSERVICE_API_KEY",[765,956,938],{"class":775},[765,958,959],{"class":782},"] ",[765,961,962],{"class":775},"},\n",[765,964,966,968,970,972,974,976,978,980,982,984,986,988,991,993,995],{"class":767,"line":965},15,[765,967,926],{"class":775},[765,969,929],{"class":849},[765,971,853],{"class":775},[765,973,817],{"class":775},[765,975,672],{"class":820},[765,977,938],{"class":775},[765,979,941],{"class":775},[765,981,944],{"class":849},[765,983,853],{"class":775},[765,985,949],{"class":782},[765,987,938],{"class":775},[765,989,990],{"class":820},"MYSERVICE_ENDPOINT",[765,992,938],{"class":775},[765,994,959],{"class":782},[765,996,962],{"class":775},[765,998,1000,1002,1004,1006,1008,1010,1012],{"class":767,"line":999},16,[765,1001,926],{"class":775},[765,1003,929],{"class":849},[765,1005,853],{"class":775},[765,1007,817],{"class":775},[765,1009,680],{"class":820},[765,1011,938],{"class":775},[765,1013,1014],{"class":775}," },\n",[765,1016,1018],{"class":767,"line":1017},17,[765,1019,1020],{"class":782},"]\n",[765,1022,1024],{"class":767,"line":1023},18,[765,1025,830],{"emptyLinePlaceholder":829},[765,1027,1029,1032,1035,1039,1042,1046,1048,1051,1053,1055,1058],{"class":767,"line":1028},19,[765,1030,1031],{"class":771},"export",[765,1033,1034],{"class":836}," function",[765,1036,1038],{"class":1037},"s2Zo4"," createMyServiceDrain",[765,1040,1041],{"class":775},"(",[765,1043,1045],{"class":1044},"sHdIc","overrides",[765,1047,865],{"class":775},[765,1049,1050],{"class":840}," Partial",[765,1052,905],{"class":775},[765,1054,908],{"class":840},[765,1056,1057],{"class":775},">)",[765,1059,776],{"class":775},[765,1061,1063,1066,1069,1071,1073,1075,1077],{"class":767,"line":1062},20,[765,1064,1065],{"class":771},"  return",[765,1067,1068],{"class":1037}," defineHttpDrain",[765,1070,905],{"class":775},[765,1072,908],{"class":840},[765,1074,911],{"class":775},[765,1076,1041],{"class":849},[765,1078,1079],{"class":775},"{\n",[765,1081,1083,1086,1088,1090,1093,1095],{"class":767,"line":1082},21,[765,1084,1085],{"class":849},"    name",[765,1087,853],{"class":775},[765,1089,817],{"class":775},[765,1091,1092],{"class":820},"myservice",[765,1094,938],{"class":775},[765,1096,786],{"class":775},[765,1098,1100,1103,1105,1108,1111,1114],{"class":767,"line":1099},22,[765,1101,1102],{"class":1037},"    resolve",[765,1104,853],{"class":775},[765,1106,1107],{"class":836}," async",[765,1109,1110],{"class":775}," ()",[765,1112,1113],{"class":836}," =>",[765,1115,776],{"class":775},[765,1117,1119,1122,1125,1128,1131,1134,1136,1138,1140,1142,1144,1146,1148,1150,1152,1154,1157],{"class":767,"line":1118},23,[765,1120,1121],{"class":836},"      const",[765,1123,1124],{"class":782}," cfg",[765,1126,1127],{"class":775}," =",[765,1129,1130],{"class":771}," await",[765,1132,1133],{"class":1037}," resolveAdapterConfig",[765,1135,905],{"class":775},[765,1137,908],{"class":840},[765,1139,911],{"class":775},[765,1141,1041],{"class":849},[765,1143,938],{"class":775},[765,1145,1092],{"class":820},[765,1147,938],{"class":775},[765,1149,941],{"class":775},[765,1151,898],{"class":782},[765,1153,941],{"class":775},[765,1155,1156],{"class":782}," overrides",[765,1158,1159],{"class":849},")\n",[765,1161,1163,1166,1169,1172,1175,1178,1180,1183],{"class":767,"line":1162},24,[765,1164,1165],{"class":771},"      if",[765,1167,1168],{"class":849}," (",[765,1170,1171],{"class":775},"!",[765,1173,1174],{"class":782},"cfg",[765,1176,1177],{"class":775},".",[765,1179,668],{"class":782},[765,1181,1182],{"class":849},") ",[765,1184,1079],{"class":775},[765,1186,1188,1191,1193,1196,1198,1200,1203,1205],{"class":767,"line":1187},25,[765,1189,1190],{"class":782},"        console",[765,1192,1177],{"class":775},[765,1194,1195],{"class":1037},"error",[765,1197,1041],{"class":849},[765,1199,938],{"class":775},[765,1201,1202],{"class":820},"[evlog\u002Fmyservice] Missing apiKey",[765,1204,938],{"class":775},[765,1206,1159],{"class":849},[765,1208,1210,1213],{"class":767,"line":1209},26,[765,1211,1212],{"class":771},"        return",[765,1214,1215],{"class":775}," null\n",[765,1217,1219],{"class":767,"line":1218},27,[765,1220,1221],{"class":775},"      }\n",[765,1223,1225,1228,1230,1233],{"class":767,"line":1224},28,[765,1226,1227],{"class":771},"      return",[765,1229,1124],{"class":782},[765,1231,1232],{"class":771}," as",[765,1234,1235],{"class":840}," MyServiceConfig\n",[765,1237,1239],{"class":767,"line":1238},29,[765,1240,1241],{"class":775},"    },\n",[765,1243,1245,1248,1250,1252,1255,1257,1259,1262,1264,1266],{"class":767,"line":1244},30,[765,1246,1247],{"class":1037},"    encode",[765,1249,853],{"class":775},[765,1251,1168],{"class":775},[765,1253,1254],{"class":1044},"events",[765,1256,941],{"class":775},[765,1258,1124],{"class":1044},[765,1260,1261],{"class":775},")",[765,1263,1113],{"class":836},[765,1265,1168],{"class":849},[765,1267,1079],{"class":775},[765,1269,1271,1274,1276,1279,1281,1283,1286,1289,1291,1294,1297,1300,1303],{"class":767,"line":1270},31,[765,1272,1273],{"class":849},"      url",[765,1275,853],{"class":775},[765,1277,1278],{"class":775}," `${",[765,1280,1174],{"class":782},[765,1282,1177],{"class":775},[765,1284,1285],{"class":782},"endpoint ",[765,1287,1288],{"class":775},"??",[765,1290,817],{"class":775},[765,1292,1293],{"class":820},"https:\u002F\u002Fapi.myservice.com",[765,1295,1296],{"class":775},"'}",[765,1298,1299],{"class":820},"\u002Fv1\u002Fingest",[765,1301,1302],{"class":775},"`",[765,1304,786],{"class":775},[765,1306,1308,1311,1313],{"class":767,"line":1307},32,[765,1309,1310],{"class":849},"      headers",[765,1312,853],{"class":775},[765,1314,776],{"class":775},[765,1316,1318,1321,1324,1326,1328,1330,1333,1335],{"class":767,"line":1317},33,[765,1319,1320],{"class":775},"        '",[765,1322,1323],{"class":849},"Content-Type",[765,1325,938],{"class":775},[765,1327,853],{"class":775},[765,1329,817],{"class":775},[765,1331,1332],{"class":820},"application\u002Fjson",[765,1334,938],{"class":775},[765,1336,786],{"class":775},[765,1338,1340,1343,1345,1348,1351,1354,1356,1358,1360,1363],{"class":767,"line":1339},34,[765,1341,1342],{"class":849},"        Authorization",[765,1344,853],{"class":775},[765,1346,1347],{"class":775}," `",[765,1349,1350],{"class":820},"Bearer ",[765,1352,1353],{"class":775},"${",[765,1355,1174],{"class":782},[765,1357,1177],{"class":775},[765,1359,668],{"class":782},[765,1361,1362],{"class":775},"}`",[765,1364,786],{"class":775},[765,1366,1368],{"class":767,"line":1367},35,[765,1369,1370],{"class":775},"      },\n",[765,1372,1374,1377,1379,1382,1384,1387,1389,1391,1393],{"class":767,"line":1373},36,[765,1375,1376],{"class":849},"      body",[765,1378,853],{"class":775},[765,1380,1381],{"class":782}," JSON",[765,1383,1177],{"class":775},[765,1385,1386],{"class":1037},"stringify",[765,1388,1041],{"class":849},[765,1390,1254],{"class":782},[765,1392,1261],{"class":849},[765,1394,786],{"class":775},[765,1396,1398,1401,1403],{"class":767,"line":1397},37,[765,1399,1400],{"class":775},"    }",[765,1402,1261],{"class":849},[765,1404,786],{"class":775},[765,1406,1408,1411],{"class":767,"line":1407},38,[765,1409,1410],{"class":775},"  }",[765,1412,1159],{"class":849},[765,1414,1416],{"class":767,"line":1415},39,[765,1417,884],{"class":775},[536,1419,1420,1421,1423,1424,1427,1428,1431],{},"That's it. ",[578,1422,589],{}," handles batching, retries (default 2), timeouts (default 5000ms), error isolation, and the identity headers (",[578,1425,1426],{},"User-Agent: evlog\u002F\u003Cversion>"," + ",[578,1429,1430],{},"X-Evlog-Source: \u003Cname>","). Your app pipeline keeps running even if your destination is down.",[1433,1434,1436],"h3",{"id":1435},"a-5-minute-example-internal-loki-drain","A 5-minute example — internal Loki drain",[536,1438,1439],{},"A complete working drain in 25 lines, with no external config helper:",[755,1441,1446],{"className":1442,"code":1443,"filename":1444,"language":1445,"meta":761,"style":761},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineHttpDrain } from 'evlog\u002Ftoolkit'\n\nexport function createLokiDrain(overrides?: { url?: string, token?: string }) {\n  return defineHttpDrain\u003C{ url: string, token: string }>({\n    name: 'loki',\n    resolve: () => ({\n      url: overrides?.url ?? process.env.LOKI_URL!,\n      token: overrides?.token ?? process.env.LOKI_TOKEN!,\n    }),\n    encode: (events, config) => ({\n      url: `${config.url}\u002Floki\u002Fapi\u002Fv1\u002Fpush`,\n      headers: {\n        'Content-Type': 'application\u002Fjson',\n        Authorization: `Bearer ${config.token}`,\n      },\n      body: JSON.stringify({\n        streams: events.map(e => ({\n          stream: { service: e.service, level: e.level },\n          values: [[String(Date.parse(e.timestamp) * 1e6), JSON.stringify(e)]],\n        })),\n      }),\n    }),\n  })\n}\n","lib\u002Floki-drain.ts","ts",[578,1447,1448,1468,1472,1511,1541,1556,1570,1603,1632,1640,1663,1687,1695,1713,1735,1739,1755,1780,1818,1878,1888,1897,1905,1911],{"__ignoreMap":761},[765,1449,1450,1452,1455,1457,1460,1462,1464,1466],{"class":767,"line":768},[765,1451,772],{"class":771},[765,1453,1454],{"class":775}," {",[765,1456,1068],{"class":782},[765,1458,1459],{"class":775}," }",[765,1461,814],{"class":771},[765,1463,817],{"class":775},[765,1465,608],{"class":820},[765,1467,823],{"class":775},[765,1469,1470],{"class":767,"line":779},[765,1471,830],{"emptyLinePlaceholder":829},[765,1473,1474,1476,1478,1481,1483,1485,1487,1489,1492,1494,1497,1499,1502,1504,1506,1509],{"class":767,"line":789},[765,1475,1031],{"class":771},[765,1477,1034],{"class":836},[765,1479,1480],{"class":1037}," createLokiDrain",[765,1482,1041],{"class":775},[765,1484,1045],{"class":1044},[765,1486,865],{"class":775},[765,1488,1454],{"class":775},[765,1490,1491],{"class":849}," url",[765,1493,865],{"class":775},[765,1495,1496],{"class":840}," string",[765,1498,941],{"class":775},[765,1500,1501],{"class":849}," token",[765,1503,865],{"class":775},[765,1505,1496],{"class":840},[765,1507,1508],{"class":775}," })",[765,1510,776],{"class":775},[765,1512,1513,1515,1517,1520,1522,1524,1526,1528,1530,1532,1534,1537,1539],{"class":767,"line":797},[765,1514,1065],{"class":771},[765,1516,1068],{"class":1037},[765,1518,1519],{"class":775},"\u003C{",[765,1521,1491],{"class":849},[765,1523,853],{"class":775},[765,1525,1496],{"class":840},[765,1527,941],{"class":775},[765,1529,1501],{"class":849},[765,1531,853],{"class":775},[765,1533,1496],{"class":840},[765,1535,1536],{"class":775}," }>",[765,1538,1041],{"class":849},[765,1540,1079],{"class":775},[765,1542,1543,1545,1547,1549,1552,1554],{"class":767,"line":808},[765,1544,1085],{"class":849},[765,1546,853],{"class":775},[765,1548,817],{"class":775},[765,1550,1551],{"class":820},"loki",[765,1553,938],{"class":775},[765,1555,786],{"class":775},[765,1557,1558,1560,1562,1564,1566,1568],{"class":767,"line":826},[765,1559,1102],{"class":1037},[765,1561,853],{"class":775},[765,1563,1110],{"class":775},[765,1565,1113],{"class":836},[765,1567,1168],{"class":849},[765,1569,1079],{"class":775},[765,1571,1572,1574,1576,1578,1581,1584,1587,1590,1592,1595,1597,1600],{"class":767,"line":833},[765,1573,1273],{"class":849},[765,1575,853],{"class":775},[765,1577,1156],{"class":782},[765,1579,1580],{"class":775},"?.",[765,1582,1583],{"class":782},"url",[765,1585,1586],{"class":775}," ??",[765,1588,1589],{"class":782}," process",[765,1591,1177],{"class":775},[765,1593,1594],{"class":782},"env",[765,1596,1177],{"class":775},[765,1598,1599],{"class":782},"LOKI_URL",[765,1601,1602],{"class":775},"!,\n",[765,1604,1605,1608,1610,1612,1614,1617,1619,1621,1623,1625,1627,1630],{"class":767,"line":846},[765,1606,1607],{"class":849},"      token",[765,1609,853],{"class":775},[765,1611,1156],{"class":782},[765,1613,1580],{"class":775},[765,1615,1616],{"class":782},"token",[765,1618,1586],{"class":775},[765,1620,1589],{"class":782},[765,1622,1177],{"class":775},[765,1624,1594],{"class":782},[765,1626,1177],{"class":775},[765,1628,1629],{"class":782},"LOKI_TOKEN",[765,1631,1602],{"class":775},[765,1633,1634,1636,1638],{"class":767,"line":859},[765,1635,1400],{"class":775},[765,1637,1261],{"class":849},[765,1639,786],{"class":775},[765,1641,1642,1644,1646,1648,1650,1652,1655,1657,1659,1661],{"class":767,"line":870},[765,1643,1247],{"class":1037},[765,1645,853],{"class":775},[765,1647,1168],{"class":775},[765,1649,1254],{"class":1044},[765,1651,941],{"class":775},[765,1653,1654],{"class":1044}," config",[765,1656,1261],{"class":775},[765,1658,1113],{"class":836},[765,1660,1168],{"class":849},[765,1662,1079],{"class":775},[765,1664,1665,1667,1669,1671,1674,1676,1678,1680,1683,1685],{"class":767,"line":881},[765,1666,1273],{"class":849},[765,1668,853],{"class":775},[765,1670,1278],{"class":775},[765,1672,1673],{"class":782},"config",[765,1675,1177],{"class":775},[765,1677,1583],{"class":782},[765,1679,811],{"class":775},[765,1681,1682],{"class":820},"\u002Floki\u002Fapi\u002Fv1\u002Fpush",[765,1684,1302],{"class":775},[765,1686,786],{"class":775},[765,1688,1689,1691,1693],{"class":767,"line":887},[765,1690,1310],{"class":849},[765,1692,853],{"class":775},[765,1694,776],{"class":775},[765,1696,1697,1699,1701,1703,1705,1707,1709,1711],{"class":767,"line":892},[765,1698,1320],{"class":775},[765,1700,1323],{"class":849},[765,1702,938],{"class":775},[765,1704,853],{"class":775},[765,1706,817],{"class":775},[765,1708,1332],{"class":820},[765,1710,938],{"class":775},[765,1712,786],{"class":775},[765,1714,1715,1717,1719,1721,1723,1725,1727,1729,1731,1733],{"class":767,"line":923},[765,1716,1342],{"class":849},[765,1718,853],{"class":775},[765,1720,1347],{"class":775},[765,1722,1350],{"class":820},[765,1724,1353],{"class":775},[765,1726,1673],{"class":782},[765,1728,1177],{"class":775},[765,1730,1616],{"class":782},[765,1732,1362],{"class":775},[765,1734,786],{"class":775},[765,1736,1737],{"class":767,"line":965},[765,1738,1370],{"class":775},[765,1740,1741,1743,1745,1747,1749,1751,1753],{"class":767,"line":999},[765,1742,1376],{"class":849},[765,1744,853],{"class":775},[765,1746,1381],{"class":782},[765,1748,1177],{"class":775},[765,1750,1386],{"class":1037},[765,1752,1041],{"class":849},[765,1754,1079],{"class":775},[765,1756,1757,1760,1762,1765,1767,1769,1771,1774,1776,1778],{"class":767,"line":1017},[765,1758,1759],{"class":849},"        streams",[765,1761,853],{"class":775},[765,1763,1764],{"class":782}," events",[765,1766,1177],{"class":775},[765,1768,94],{"class":1037},[765,1770,1041],{"class":849},[765,1772,1773],{"class":1044},"e",[765,1775,1113],{"class":836},[765,1777,1168],{"class":849},[765,1779,1079],{"class":775},[765,1781,1782,1785,1787,1789,1792,1794,1797,1799,1802,1804,1807,1809,1811,1813,1816],{"class":767,"line":1023},[765,1783,1784],{"class":849},"          stream",[765,1786,853],{"class":775},[765,1788,1454],{"class":775},[765,1790,1791],{"class":849}," service",[765,1793,853],{"class":775},[765,1795,1796],{"class":782}," e",[765,1798,1177],{"class":775},[765,1800,1801],{"class":782},"service",[765,1803,941],{"class":775},[765,1805,1806],{"class":849}," level",[765,1808,853],{"class":775},[765,1810,1796],{"class":782},[765,1812,1177],{"class":775},[765,1814,1815],{"class":782},"level",[765,1817,1014],{"class":775},[765,1819,1820,1823,1825,1828,1831,1833,1836,1838,1841,1843,1845,1847,1850,1852,1855,1859,1861,1863,1865,1867,1869,1871,1873,1876],{"class":767,"line":1028},[765,1821,1822],{"class":849},"          values",[765,1824,853],{"class":775},[765,1826,1827],{"class":849}," [[",[765,1829,1830],{"class":1037},"String",[765,1832,1041],{"class":849},[765,1834,1835],{"class":782},"Date",[765,1837,1177],{"class":775},[765,1839,1840],{"class":1037},"parse",[765,1842,1041],{"class":849},[765,1844,1773],{"class":782},[765,1846,1177],{"class":775},[765,1848,1849],{"class":782},"timestamp",[765,1851,1182],{"class":849},[765,1853,1854],{"class":775},"*",[765,1856,1858],{"class":1857},"sbssI"," 1e6",[765,1860,1261],{"class":849},[765,1862,941],{"class":775},[765,1864,1381],{"class":782},[765,1866,1177],{"class":775},[765,1868,1386],{"class":1037},[765,1870,1041],{"class":849},[765,1872,1773],{"class":782},[765,1874,1875],{"class":849},")]]",[765,1877,786],{"class":775},[765,1879,1880,1883,1886],{"class":767,"line":1062},[765,1881,1882],{"class":775},"        }",[765,1884,1885],{"class":849},"))",[765,1887,786],{"class":775},[765,1889,1890,1893,1895],{"class":767,"line":1082},[765,1891,1892],{"class":775},"      }",[765,1894,1261],{"class":849},[765,1896,786],{"class":775},[765,1898,1899,1901,1903],{"class":767,"line":1099},[765,1900,1400],{"class":775},[765,1902,1261],{"class":849},[765,1904,786],{"class":775},[765,1906,1907,1909],{"class":767,"line":1118},[765,1908,1410],{"class":775},[765,1910,1159],{"class":849},[765,1912,1913],{"class":767,"line":1162},[765,1914,884],{"class":775},[732,1916,1918],{"id":1917},"standardized-config-priority","Standardized config priority",[536,1920,1921,1923],{},[578,1922,657],{}," walks the standard chain so users get the same configuration UX as built-in adapters:",[1925,1926,1927,1933,1939,1945],"ol",{},[623,1928,1929,1930,1932],{},"Explicit ",[578,1931,1045],{}," passed to your factory",[623,1934,1935,1938],{},[578,1936,1937],{},"runtimeConfig.evlog.\u003Cnamespace>"," (Nuxt\u002FNitro)",[623,1940,1941,1944],{},[578,1942,1943],{},"runtimeConfig.\u003Cnamespace>"," (legacy Nuxt\u002FNitro)",[623,1946,1947,1950,1951,1954,1955,1958,1959,1961,1962,1261],{},[578,1948,1949],{},"\u003CNS>_\u003CFIELD>"," env vars (list ",[578,1952,1953],{},"NUXT_\u003CNS>_\u003CFIELD>"," in ",[578,1956,1957],{},"ConfigField.env"," for silent Nuxt compat; show only ",[578,1960,1949],{}," in error messages via ",[578,1963,1964],{},"formatPublicEnvKeys",[536,1966,1967,1968,677,1970,677,1972,677,1974,1976,1977,1979,1980,1982,1983,1986,1987,1990,1991,1994],{},"Field names should follow the project conventions: ",[578,1969,668],{},[578,1971,672],{},[578,1973,676],{},[578,1975,680],{},". If you're renaming an existing field (e.g. ",[578,1978,1616],{}," → ",[578,1981,668],{},"), keep both as ",[578,1984,1985],{},"ConfigField"," entries for one major version — see ",[578,1988,1989],{},"axiom.ts"," and ",[578,1992,1993],{},"better-stack.ts"," for the deprecation pattern.",[732,1996,1998],{"id":1997},"wiring-the-drain-into-your-framework","Wiring the drain into your framework",[536,2000,2001,2002,2005],{},"Once ",[578,2003,2004],{},"createMyServiceDrain()"," returns the drain, wire it like any other:",[2007,2008,2009,2122,2248,2306,2343,2374],"code-group",{},[755,2010,2013],{"className":757,"code":2011,"filename":2012,"language":760,"meta":761,"style":761},"\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\nimport { createMyServiceDrain } from '~\u002Fserver\u002Futils\u002Fmy-drain'\n\nconst drain = createMyServiceDrain()\n\nexport default defineNitroPlugin((nitroApp) => {\n  nitroApp.hooks.hook('evlog:drain', drain)\n})\n","Nuxt \u002F Nitro",[578,2014,2015,2021,2040,2044,2058,2062,2085,2116],{"__ignoreMap":761},[765,2016,2017],{"class":767,"line":768},[765,2018,2020],{"class":2019},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\n",[765,2022,2023,2025,2027,2029,2031,2033,2035,2038],{"class":767,"line":779},[765,2024,772],{"class":771},[765,2026,1454],{"class":775},[765,2028,1038],{"class":782},[765,2030,1459],{"class":775},[765,2032,814],{"class":771},[765,2034,817],{"class":775},[765,2036,2037],{"class":820},"~\u002Fserver\u002Futils\u002Fmy-drain",[765,2039,823],{"class":775},[765,2041,2042],{"class":767,"line":789},[765,2043,830],{"emptyLinePlaceholder":829},[765,2045,2046,2048,2051,2053,2055],{"class":767,"line":797},[765,2047,895],{"class":836},[765,2049,2050],{"class":782}," drain ",[765,2052,917],{"class":775},[765,2054,1038],{"class":1037},[765,2056,2057],{"class":782},"()\n",[765,2059,2060],{"class":767,"line":808},[765,2061,830],{"emptyLinePlaceholder":829},[765,2063,2064,2066,2069,2072,2074,2076,2079,2081,2083],{"class":767,"line":826},[765,2065,1031],{"class":771},[765,2067,2068],{"class":771}," default",[765,2070,2071],{"class":1037}," defineNitroPlugin",[765,2073,1041],{"class":782},[765,2075,1041],{"class":775},[765,2077,2078],{"class":1044},"nitroApp",[765,2080,1261],{"class":775},[765,2082,1113],{"class":836},[765,2084,776],{"class":775},[765,2086,2087,2090,2092,2095,2097,2100,2102,2104,2107,2109,2111,2114],{"class":767,"line":833},[765,2088,2089],{"class":782},"  nitroApp",[765,2091,1177],{"class":775},[765,2093,2094],{"class":782},"hooks",[765,2096,1177],{"class":775},[765,2098,2099],{"class":1037},"hook",[765,2101,1041],{"class":849},[765,2103,938],{"class":775},[765,2105,2106],{"class":820},"evlog:drain",[765,2108,938],{"class":775},[765,2110,941],{"class":775},[765,2112,2113],{"class":782}," drain",[765,2115,1159],{"class":849},[765,2117,2118,2120],{"class":767,"line":846},[765,2119,811],{"class":775},[765,2121,1159],{"class":782},[755,2123,2125],{"className":757,"code":2124,"filename":235,"language":760,"meta":761,"style":761},"\u002F\u002F lib\u002Fevlog.ts\nimport { createEvlog } from 'evlog\u002Fnext'\nimport { createMyServiceDrain } from '.\u002Fmy-drain'\n\nexport const { withEvlog, useLogger, log, createError } = createEvlog({\n  service: 'my-app',\n  drain: createMyServiceDrain(),\n})\n",[578,2126,2127,2132,2152,2171,2175,2212,2228,2242],{"__ignoreMap":761},[765,2128,2129],{"class":767,"line":768},[765,2130,2131],{"class":2019},"\u002F\u002F lib\u002Fevlog.ts\n",[765,2133,2134,2136,2138,2141,2143,2145,2147,2150],{"class":767,"line":779},[765,2135,772],{"class":771},[765,2137,1454],{"class":775},[765,2139,2140],{"class":782}," createEvlog",[765,2142,1459],{"class":775},[765,2144,814],{"class":771},[765,2146,817],{"class":775},[765,2148,2149],{"class":820},"evlog\u002Fnext",[765,2151,823],{"class":775},[765,2153,2154,2156,2158,2160,2162,2164,2166,2169],{"class":767,"line":789},[765,2155,772],{"class":771},[765,2157,1454],{"class":775},[765,2159,1038],{"class":782},[765,2161,1459],{"class":775},[765,2163,814],{"class":771},[765,2165,817],{"class":775},[765,2167,2168],{"class":820},".\u002Fmy-drain",[765,2170,823],{"class":775},[765,2172,2173],{"class":767,"line":797},[765,2174,830],{"emptyLinePlaceholder":829},[765,2176,2177,2179,2182,2184,2187,2189,2192,2194,2197,2199,2202,2204,2206,2208,2210],{"class":767,"line":808},[765,2178,1031],{"class":771},[765,2180,2181],{"class":836}," const",[765,2183,1454],{"class":775},[765,2185,2186],{"class":782}," withEvlog",[765,2188,941],{"class":775},[765,2190,2191],{"class":782}," useLogger",[765,2193,941],{"class":775},[765,2195,2196],{"class":782}," log",[765,2198,941],{"class":775},[765,2200,2201],{"class":782}," createError ",[765,2203,811],{"class":775},[765,2205,1127],{"class":775},[765,2207,2140],{"class":1037},[765,2209,1041],{"class":782},[765,2211,1079],{"class":775},[765,2213,2214,2217,2219,2221,2224,2226],{"class":767,"line":826},[765,2215,2216],{"class":849},"  service",[765,2218,853],{"class":775},[765,2220,817],{"class":775},[765,2222,2223],{"class":820},"my-app",[765,2225,938],{"class":775},[765,2227,786],{"class":775},[765,2229,2230,2233,2235,2237,2240],{"class":767,"line":833},[765,2231,2232],{"class":849},"  drain",[765,2234,853],{"class":775},[765,2236,1038],{"class":1037},[765,2238,2239],{"class":782},"()",[765,2241,786],{"class":775},[765,2243,2244,2246],{"class":767,"line":846},[765,2245,811],{"class":775},[765,2247,1159],{"class":782},[755,2249,2252],{"className":757,"code":2250,"filename":2251,"language":760,"meta":761,"style":761},"import { createMyServiceDrain } from '.\u002Fmy-drain'\napp.use(evlog({ drain: createMyServiceDrain() }))\n","Hono \u002F Express \u002F Elysia",[578,2253,2254,2272],{"__ignoreMap":761},[765,2255,2256,2258,2260,2262,2264,2266,2268,2270],{"class":767,"line":768},[765,2257,772],{"class":771},[765,2259,1454],{"class":775},[765,2261,1038],{"class":782},[765,2263,1459],{"class":775},[765,2265,814],{"class":771},[765,2267,817],{"class":775},[765,2269,2168],{"class":820},[765,2271,823],{"class":775},[765,2273,2274,2277,2279,2282,2284,2287,2289,2292,2294,2296,2298,2301,2303],{"class":767,"line":779},[765,2275,2276],{"class":782},"app",[765,2278,1177],{"class":775},[765,2280,2281],{"class":1037},"use",[765,2283,1041],{"class":782},[765,2285,2286],{"class":1037},"evlog",[765,2288,1041],{"class":782},[765,2290,2291],{"class":775},"{",[765,2293,2113],{"class":849},[765,2295,853],{"class":775},[765,2297,1038],{"class":1037},[765,2299,2300],{"class":782},"() ",[765,2302,811],{"class":775},[765,2304,2305],{"class":782},"))\n",[755,2307,2309],{"className":757,"code":2308,"filename":270,"language":760,"meta":761,"style":761},"await app.register(evlog, { drain: createMyServiceDrain() })\n",[578,2310,2311],{"__ignoreMap":761},[765,2312,2313,2316,2319,2321,2324,2327,2329,2331,2333,2335,2337,2339,2341],{"class":767,"line":768},[765,2314,2315],{"class":771},"await",[765,2317,2318],{"class":782}," app",[765,2320,1177],{"class":775},[765,2322,2323],{"class":1037},"register",[765,2325,2326],{"class":782},"(evlog",[765,2328,941],{"class":775},[765,2330,1454],{"class":775},[765,2332,2113],{"class":849},[765,2334,853],{"class":775},[765,2336,1038],{"class":1037},[765,2338,2300],{"class":782},[765,2340,811],{"class":775},[765,2342,1159],{"class":782},[755,2344,2346],{"className":757,"code":2345,"filename":255,"language":760,"meta":761,"style":761},"EvlogModule.forRoot({ drain: createMyServiceDrain() })\n",[578,2347,2348],{"__ignoreMap":761},[765,2349,2350,2353,2355,2358,2360,2362,2364,2366,2368,2370,2372],{"class":767,"line":768},[765,2351,2352],{"class":782},"EvlogModule",[765,2354,1177],{"class":775},[765,2356,2357],{"class":1037},"forRoot",[765,2359,1041],{"class":782},[765,2361,2291],{"class":775},[765,2363,2113],{"class":849},[765,2365,853],{"class":775},[765,2367,1038],{"class":1037},[765,2369,2300],{"class":782},[765,2371,811],{"class":775},[765,2373,1159],{"class":782},[755,2375,2377],{"className":757,"code":2376,"filename":290,"language":760,"meta":761,"style":761},"import { initLogger } from 'evlog'\nimport { createMyServiceDrain } from '.\u002Fmy-drain'\n\ninitLogger({ drain: createMyServiceDrain() })\n",[578,2378,2379,2398,2416,2420],{"__ignoreMap":761},[765,2380,2381,2383,2385,2388,2390,2392,2394,2396],{"class":767,"line":768},[765,2382,772],{"class":771},[765,2384,1454],{"class":775},[765,2386,2387],{"class":782}," initLogger",[765,2389,1459],{"class":775},[765,2391,814],{"class":771},[765,2393,817],{"class":775},[765,2395,2286],{"class":820},[765,2397,823],{"class":775},[765,2399,2400,2402,2404,2406,2408,2410,2412,2414],{"class":767,"line":779},[765,2401,772],{"class":771},[765,2403,1454],{"class":775},[765,2405,1038],{"class":782},[765,2407,1459],{"class":775},[765,2409,814],{"class":771},[765,2411,817],{"class":775},[765,2413,2168],{"class":820},[765,2415,823],{"class":775},[765,2417,2418],{"class":767,"line":789},[765,2419,830],{"emptyLinePlaceholder":829},[765,2421,2422,2425,2427,2429,2431,2433,2435,2437,2439],{"class":767,"line":797},[765,2423,2424],{"class":1037},"initLogger",[765,2426,1041],{"class":782},[765,2428,2291],{"class":775},[765,2430,2113],{"class":849},[765,2432,853],{"class":775},[765,2434,1038],{"class":1037},[765,2436,2300],{"class":782},[765,2438,811],{"class":775},[765,2440,1159],{"class":782},[536,2442,2443,2444,2448],{},"For production, wrap it once in ",[545,2445,2446],{"href":496},[578,2447,716],{}," so events are batched and retried.",[732,2450,2452],{"id":2451},"filtering-and-transforming-events","Filtering and transforming events",[536,2454,2455,2457,2458,2461,2462,2464],{},[578,2456,749],{}," receives the full batch of ",[578,2459,2460],{},"WideEvent[]"," plus the resolved config. Filter or transform inline — returning ",[578,2463,694],{}," is a clean opt-out for that batch:",[755,2466,2468],{"className":757,"code":2467,"language":760,"meta":761,"style":761},"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, durationMs: e.durationMs },\n  }))\n\n  return {\n    url: `${cfg.endpoint}\u002Fv1\u002Fpush`,\n    headers: { 'Content-Type': 'application\u002Fjson' },\n    body: JSON.stringify(payload),\n  }\n}\n",[578,2469,2470,2491,2551,2578,2582,2607,2639,2661,2725,2731,2735,2741,2765,2790,2812,2817],{"__ignoreMap":761},[765,2471,2472,2475,2477,2479,2481,2483,2485,2487,2489],{"class":767,"line":768},[765,2473,2474],{"class":840},"encode",[765,2476,853],{"class":775},[765,2478,1168],{"class":775},[765,2480,1254],{"class":1044},[765,2482,941],{"class":775},[765,2484,1124],{"class":1044},[765,2486,1261],{"class":775},[765,2488,1113],{"class":836},[765,2490,776],{"class":775},[765,2492,2493,2496,2499,2501,2503,2505,2508,2510,2512,2514,2516,2518,2520,2523,2525,2527,2529,2532,2534,2536,2539,2542,2544,2547,2549],{"class":767,"line":779},[765,2494,2495],{"class":836},"  const",[765,2497,2498],{"class":782}," filtered",[765,2500,1127],{"class":775},[765,2502,1764],{"class":782},[765,2504,1177],{"class":775},[765,2506,2507],{"class":1037},"filter",[765,2509,1041],{"class":849},[765,2511,1773],{"class":1044},[765,2513,1113],{"class":836},[765,2515,1796],{"class":782},[765,2517,1177],{"class":775},[765,2519,1815],{"class":782},[765,2521,2522],{"class":775}," ===",[765,2524,817],{"class":775},[765,2526,1195],{"class":820},[765,2528,938],{"class":775},[765,2530,2531],{"class":775}," &&",[765,2533,1796],{"class":782},[765,2535,1177],{"class":775},[765,2537,2538],{"class":782},"path",[765,2540,2541],{"class":775}," !==",[765,2543,817],{"class":775},[765,2545,2546],{"class":820},"\u002Fhealth",[765,2548,938],{"class":775},[765,2550,1159],{"class":849},[765,2552,2553,2556,2558,2561,2563,2566,2568,2571,2573,2576],{"class":767,"line":789},[765,2554,2555],{"class":771},"  if",[765,2557,1168],{"class":849},[765,2559,2560],{"class":782},"filtered",[765,2562,1177],{"class":775},[765,2564,2565],{"class":782},"length",[765,2567,2522],{"class":775},[765,2569,2570],{"class":1857}," 0",[765,2572,1182],{"class":849},[765,2574,2575],{"class":771},"return",[765,2577,1215],{"class":775},[765,2579,2580],{"class":767,"line":797},[765,2581,830],{"emptyLinePlaceholder":829},[765,2583,2584,2586,2589,2591,2593,2595,2597,2599,2601,2603,2605],{"class":767,"line":808},[765,2585,2495],{"class":836},[765,2587,2588],{"class":782}," payload",[765,2590,1127],{"class":775},[765,2592,2498],{"class":782},[765,2594,1177],{"class":775},[765,2596,94],{"class":1037},[765,2598,1041],{"class":849},[765,2600,1773],{"class":1044},[765,2602,1113],{"class":836},[765,2604,1168],{"class":849},[765,2606,1079],{"class":775},[765,2608,2609,2612,2614,2617,2620,2622,2624,2626,2628,2630,2632,2635,2637],{"class":767,"line":826},[765,2610,2611],{"class":849},"    ts",[765,2613,853],{"class":775},[765,2615,2616],{"class":775}," new",[765,2618,2619],{"class":1037}," Date",[765,2621,1041],{"class":849},[765,2623,1773],{"class":782},[765,2625,1177],{"class":775},[765,2627,1849],{"class":782},[765,2629,1261],{"class":849},[765,2631,1177],{"class":775},[765,2633,2634],{"class":1037},"getTime",[765,2636,2239],{"class":849},[765,2638,786],{"class":775},[765,2640,2641,2644,2646,2648,2650,2652,2654,2657,2659],{"class":767,"line":833},[765,2642,2643],{"class":849},"    severity",[765,2645,853],{"class":775},[765,2647,1796],{"class":782},[765,2649,1177],{"class":775},[765,2651,1815],{"class":782},[765,2653,1177],{"class":775},[765,2655,2656],{"class":1037},"toUpperCase",[765,2658,2239],{"class":849},[765,2660,786],{"class":775},[765,2662,2663,2666,2668,2670,2673,2675,2677,2679,2682,2684,2687,2689,2691,2693,2695,2697,2700,2702,2704,2706,2709,2711,2714,2716,2718,2720,2723],{"class":767,"line":846},[765,2664,2665],{"class":849},"    attributes",[765,2667,853],{"class":775},[765,2669,1454],{"class":775},[765,2671,2672],{"class":849}," method",[765,2674,853],{"class":775},[765,2676,1796],{"class":782},[765,2678,1177],{"class":775},[765,2680,2681],{"class":782},"method",[765,2683,941],{"class":775},[765,2685,2686],{"class":849}," path",[765,2688,853],{"class":775},[765,2690,1796],{"class":782},[765,2692,1177],{"class":775},[765,2694,2538],{"class":782},[765,2696,941],{"class":775},[765,2698,2699],{"class":849}," status",[765,2701,853],{"class":775},[765,2703,1796],{"class":782},[765,2705,1177],{"class":775},[765,2707,2708],{"class":782},"status",[765,2710,941],{"class":775},[765,2712,2713],{"class":849}," durationMs",[765,2715,853],{"class":775},[765,2717,1796],{"class":782},[765,2719,1177],{"class":775},[765,2721,2722],{"class":782},"durationMs",[765,2724,1014],{"class":775},[765,2726,2727,2729],{"class":767,"line":859},[765,2728,1410],{"class":775},[765,2730,2305],{"class":849},[765,2732,2733],{"class":767,"line":870},[765,2734,830],{"emptyLinePlaceholder":829},[765,2736,2737,2739],{"class":767,"line":881},[765,2738,1065],{"class":771},[765,2740,776],{"class":775},[765,2742,2743,2746,2748,2750,2752,2754,2756,2758,2761,2763],{"class":767,"line":887},[765,2744,2745],{"class":849},"    url",[765,2747,853],{"class":775},[765,2749,1278],{"class":775},[765,2751,1174],{"class":782},[765,2753,1177],{"class":775},[765,2755,672],{"class":782},[765,2757,811],{"class":775},[765,2759,2760],{"class":820},"\u002Fv1\u002Fpush",[765,2762,1302],{"class":775},[765,2764,786],{"class":775},[765,2766,2767,2770,2772,2774,2776,2778,2780,2782,2784,2786,2788],{"class":767,"line":892},[765,2768,2769],{"class":849},"    headers",[765,2771,853],{"class":775},[765,2773,1454],{"class":775},[765,2775,817],{"class":775},[765,2777,1323],{"class":849},[765,2779,938],{"class":775},[765,2781,853],{"class":775},[765,2783,817],{"class":775},[765,2785,1332],{"class":820},[765,2787,938],{"class":775},[765,2789,1014],{"class":775},[765,2791,2792,2795,2797,2799,2801,2803,2805,2808,2810],{"class":767,"line":923},[765,2793,2794],{"class":849},"    body",[765,2796,853],{"class":775},[765,2798,1381],{"class":782},[765,2800,1177],{"class":775},[765,2802,1386],{"class":1037},[765,2804,1041],{"class":849},[765,2806,2807],{"class":782},"payload",[765,2809,1261],{"class":849},[765,2811,786],{"class":775},[765,2813,2814],{"class":767,"line":965},[765,2815,2816],{"class":775},"  }\n",[765,2818,2819],{"class":767,"line":999},[765,2820,884],{"class":775},[732,2822,2824,2826],{"id":2823},"definedrain-non-http-transports",[578,2825,602],{}," (non-HTTP transports)",[536,2828,2829,2830,2832],{},"If your destination requires gRPC, a vendor SDK, a queue client, a WebSocket, or a raw socket, drop one level lower with ",[578,2831,602],{},". You own the transport; the toolkit still gives you config resolution, error isolation, and a consistent shape.",[755,2834,2836],{"className":757,"code":2835,"language":760,"meta":761,"style":761},"import { defineDrain } 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",[578,2837,2838,2857,2861,2877,2897,2912,2951,2974,3009,3013],{"__ignoreMap":761},[765,2839,2840,2842,2844,2847,2849,2851,2853,2855],{"class":767,"line":768},[765,2841,772],{"class":771},[765,2843,1454],{"class":775},[765,2845,2846],{"class":782}," defineDrain",[765,2848,1459],{"class":775},[765,2850,814],{"class":771},[765,2852,817],{"class":775},[765,2854,608],{"class":820},[765,2856,823],{"class":775},[765,2858,2859],{"class":767,"line":779},[765,2860,830],{"emptyLinePlaceholder":829},[765,2862,2863,2865,2867,2870,2872,2874],{"class":767,"line":789},[765,2864,1031],{"class":771},[765,2866,2181],{"class":836},[765,2868,2869],{"class":782}," createCustomTransportDrain ",[765,2871,917],{"class":775},[765,2873,1110],{"class":775},[765,2875,2876],{"class":836}," =>\n",[765,2878,2879,2882,2884,2887,2889,2891,2893,2895],{"class":767,"line":797},[765,2880,2881],{"class":1037},"  defineDrain",[765,2883,1519],{"class":775},[765,2885,2886],{"class":849}," apiKey",[765,2888,853],{"class":775},[765,2890,1496],{"class":840},[765,2892,1536],{"class":775},[765,2894,1041],{"class":782},[765,2896,1079],{"class":775},[765,2898,2899,2901,2903,2905,2908,2910],{"class":767,"line":808},[765,2900,1085],{"class":849},[765,2902,853],{"class":775},[765,2904,817],{"class":775},[765,2906,2907],{"class":820},"custom",[765,2909,938],{"class":775},[765,2911,786],{"class":775},[765,2913,2914,2916,2918,2920,2922,2924,2926,2928,2930,2932,2934,2936,2938,2940,2943,2945,2947,2949],{"class":767,"line":826},[765,2915,1102],{"class":1037},[765,2917,853],{"class":775},[765,2919,1107],{"class":836},[765,2921,1110],{"class":775},[765,2923,1113],{"class":836},[765,2925,1168],{"class":782},[765,2927,2291],{"class":775},[765,2929,2886],{"class":849},[765,2931,853],{"class":775},[765,2933,1589],{"class":782},[765,2935,1177],{"class":775},[765,2937,1594],{"class":782},[765,2939,1177],{"class":775},[765,2941,2942],{"class":782},"MY_KEY",[765,2944,1171],{"class":775},[765,2946,1459],{"class":775},[765,2948,1261],{"class":782},[765,2950,786],{"class":775},[765,2952,2953,2956,2958,2960,2962,2964,2966,2968,2970,2972],{"class":767,"line":833},[765,2954,2955],{"class":1037},"    send",[765,2957,853],{"class":775},[765,2959,1107],{"class":836},[765,2961,1168],{"class":775},[765,2963,1254],{"class":1044},[765,2965,941],{"class":775},[765,2967,1124],{"class":1044},[765,2969,1261],{"class":775},[765,2971,1113],{"class":836},[765,2973,776],{"class":775},[765,2975,2976,2979,2982,2984,2987,2989,2991,2993,2995,2997,2999,3001,3003,3005,3007],{"class":767,"line":846},[765,2977,2978],{"class":771},"      await",[765,2980,2981],{"class":782}," myVendorSdk",[765,2983,1177],{"class":775},[765,2985,2986],{"class":1037},"publish",[765,2988,1041],{"class":849},[765,2990,1254],{"class":782},[765,2992,941],{"class":775},[765,2994,1454],{"class":775},[765,2996,1501],{"class":849},[765,2998,853],{"class":775},[765,3000,1124],{"class":782},[765,3002,1177],{"class":775},[765,3004,668],{"class":782},[765,3006,1459],{"class":775},[765,3008,1159],{"class":849},[765,3010,3011],{"class":767,"line":859},[765,3012,1241],{"class":775},[765,3014,3015,3017],{"class":767,"line":870},[765,3016,1410],{"class":775},[765,3018,1159],{"class":782},[536,3020,3021,3022,3024,3025,3027,3028,3031,3032,3035],{},"When you fall back to ",[578,3023,602],{},", follow the same rules manually that ",[578,3026,589],{}," enforces: wrap the transport in ",[578,3029,3030],{},"try\u002Fcatch",", log with ",[578,3033,3034],{},"console.error('[evlog\u002F\u003Cname>] …')",", and never re-throw.",[732,3037,3039],{"id":3038},"draincontext-reference","DrainContext reference",[536,3041,3042,3043,3045,3046,3049],{},"When evlog calls your drain through ",[578,3044,2106],{},", it passes a ",[578,3047,3048],{},"DrainContext"," per event:",[755,3051,3054],{"className":757,"code":3052,"filename":3053,"language":760,"meta":761,"style":761},"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",[578,3055,3056,3065,3070,3080,3084,3089,3098,3107,3116,3125,3129,3133,3138,3160,3164,3168,3177,3186,3227,3235,3244,3253,3262,3271,3280,3285,3305],{"__ignoreMap":761},[765,3057,3058,3060,3063],{"class":767,"line":768},[765,3059,837],{"class":836},[765,3061,3062],{"class":840}," DrainContext",[765,3064,776],{"class":775},[765,3066,3067],{"class":767,"line":779},[765,3068,3069],{"class":2019},"  \u002F** The complete wide event with all accumulated context *\u002F\n",[765,3071,3072,3075,3077],{"class":767,"line":789},[765,3073,3074],{"class":849},"  event",[765,3076,853],{"class":775},[765,3078,3079],{"class":840}," WideEvent\n",[765,3081,3082],{"class":767,"line":797},[765,3083,830],{"emptyLinePlaceholder":829},[765,3085,3086],{"class":767,"line":808},[765,3087,3088],{"class":2019},"  \u002F** Request metadata *\u002F\n",[765,3090,3091,3094,3096],{"class":767,"line":826},[765,3092,3093],{"class":849},"  request",[765,3095,865],{"class":775},[765,3097,776],{"class":775},[765,3099,3100,3103,3105],{"class":767,"line":833},[765,3101,3102],{"class":849},"    method",[765,3104,853],{"class":775},[765,3106,856],{"class":840},[765,3108,3109,3112,3114],{"class":767,"line":846},[765,3110,3111],{"class":849},"    path",[765,3113,853],{"class":775},[765,3115,856],{"class":840},[765,3117,3118,3121,3123],{"class":767,"line":859},[765,3119,3120],{"class":849},"    requestId",[765,3122,853],{"class":775},[765,3124,856],{"class":840},[765,3126,3127],{"class":767,"line":870},[765,3128,2816],{"class":775},[765,3130,3131],{"class":767,"line":881},[765,3132,830],{"emptyLinePlaceholder":829},[765,3134,3135],{"class":767,"line":887},[765,3136,3137],{"class":2019},"  \u002F** Safe HTTP headers (sensitive headers filtered) *\u002F\n",[765,3139,3140,3143,3145,3148,3150,3153,3155,3157],{"class":767,"line":892},[765,3141,3142],{"class":849},"  headers",[765,3144,865],{"class":775},[765,3146,3147],{"class":840}," Record",[765,3149,905],{"class":775},[765,3151,3152],{"class":840},"string",[765,3154,941],{"class":775},[765,3156,1496],{"class":840},[765,3158,3159],{"class":775},">\n",[765,3161,3162],{"class":767,"line":923},[765,3163,884],{"class":775},[765,3165,3166],{"class":767,"line":965},[765,3167,830],{"emptyLinePlaceholder":829},[765,3169,3170,3172,3175],{"class":767,"line":999},[765,3171,837],{"class":836},[765,3173,3174],{"class":840}," WideEvent",[765,3176,776],{"class":775},[765,3178,3179,3182,3184],{"class":767,"line":1017},[765,3180,3181],{"class":849},"  timestamp",[765,3183,853],{"class":775},[765,3185,856],{"class":840},[765,3187,3188,3191,3193,3195,3198,3200,3203,3205,3208,3210,3212,3214,3217,3219,3221,3223,3225],{"class":767,"line":1023},[765,3189,3190],{"class":849},"  level",[765,3192,853],{"class":775},[765,3194,817],{"class":775},[765,3196,3197],{"class":820},"debug",[765,3199,938],{"class":775},[765,3201,3202],{"class":775}," |",[765,3204,817],{"class":775},[765,3206,3207],{"class":820},"info",[765,3209,938],{"class":775},[765,3211,3202],{"class":775},[765,3213,817],{"class":775},[765,3215,3216],{"class":820},"warn",[765,3218,938],{"class":775},[765,3220,3202],{"class":775},[765,3222,817],{"class":775},[765,3224,1195],{"class":820},[765,3226,823],{"class":775},[765,3228,3229,3231,3233],{"class":767,"line":1028},[765,3230,2216],{"class":849},[765,3232,853],{"class":775},[765,3234,856],{"class":840},[765,3236,3237,3240,3242],{"class":767,"line":1062},[765,3238,3239],{"class":849},"  environment",[765,3241,865],{"class":775},[765,3243,856],{"class":840},[765,3245,3246,3249,3251],{"class":767,"line":1082},[765,3247,3248],{"class":849},"  version",[765,3250,865],{"class":775},[765,3252,856],{"class":840},[765,3254,3255,3258,3260],{"class":767,"line":1099},[765,3256,3257],{"class":849},"  region",[765,3259,865],{"class":775},[765,3261,856],{"class":840},[765,3263,3264,3267,3269],{"class":767,"line":1118},[765,3265,3266],{"class":849},"  commitHash",[765,3268,865],{"class":775},[765,3270,856],{"class":840},[765,3272,3273,3276,3278],{"class":767,"line":1162},[765,3274,3275],{"class":849},"  requestId",[765,3277,865],{"class":775},[765,3279,856],{"class":840},[765,3281,3282],{"class":767,"line":1187},[765,3283,3284],{"class":2019},"  \u002F\u002F ... plus all fields added via log.set()\n",[765,3286,3287,3290,3293,3295,3297,3300,3302],{"class":767,"line":1209},[765,3288,3289],{"class":782},"  [",[765,3291,3292],{"class":1044},"key",[765,3294,853],{"class":775},[765,3296,1496],{"class":840},[765,3298,3299],{"class":782},"]",[765,3301,853],{"class":775},[765,3303,3304],{"class":840}," unknown\n",[765,3306,3307],{"class":767,"line":1218},[765,3308,884],{"class":775},[536,3310,3311,3312,3314,3315,3318,3319,3321,3322,3325],{},"In the batched form your ",[578,3313,749],{}," \u002F ",[578,3316,3317],{},"send()"," receives, you get ",[578,3320,2460],{}," directly (the toolkit unwraps ",[578,3323,3324],{},"event"," from each context).",[732,3327,3329],{"id":3328},"toolkit-helpers","Toolkit helpers",[536,3331,3332,3334],{},[578,3333,608],{}," exposes the same helpers every built-in adapter uses. The ones relevant to drains:",[553,3336,3337,3347],{},[556,3338,3339],{},[559,3340,3341,3344],{},[562,3342,3343],{},"Export",[562,3345,3346],{},"Purpose",[569,3348,3349,3359,3369,3381,3391,3404,3414,3428],{},[559,3350,3351,3356],{},[574,3352,3353],{},[578,3354,3355],{},"defineHttpDrain(spec)",[574,3357,3358],{},"The HTTP recipe — auto retries, timeouts, identity headers, error isolation",[559,3360,3361,3366],{},[574,3362,3363],{},[578,3364,3365],{},"defineDrain(spec)",[574,3367,3368],{},"Same contract for non-HTTP transports",[559,3370,3371,3376],{},[574,3372,3373],{},[578,3374,3375],{},"resolveAdapterConfig(ns, fields, overrides)",[574,3377,3378,3379,662],{},"Standard config priority chain (overrides → ",[578,3380,661],{},[559,3382,3383,3388],{},[574,3384,3385],{},[578,3386,3387],{},"httpPost(opts)",[574,3389,3390],{},"The retried POST helper used by every built-in HTTP adapter — handles timeout, retries, redacted error messages",[559,3392,3393,3398],{},[574,3394,3395],{},[578,3396,3397],{},"composeDrains(drains)",[574,3399,3400,3401,1261],{},"Combine multiple drains into one (errors isolated, runs concurrently with ",[578,3402,3403],{},"Promise.allSettled",[559,3405,3406,3411],{},[574,3407,3408],{},[578,3409,3410],{},"toTypedAttributeValue(value)",[574,3412,3413],{},"Convert any value to the typed attribute shape used by Axiom \u002F Sentry",[559,3415,3416,3421],{},[574,3417,3418],{},[578,3419,3420],{},"toOtlpAttributeValue(value)",[574,3422,3423,3424,3427],{},"Convert any value to the OTLP ",[578,3425,3426],{},"AnyValue"," shape (used by OTLP \u002F HyperDX \u002F PostHog logs)",[559,3429,3430,3438],{},[574,3431,3432,677,3435],{},[578,3433,3434],{},"OTEL_SEVERITY_NUMBER",[578,3436,3437],{},"OTEL_SEVERITY_TEXT",[574,3439,3440],{},"OTEL log severity tables",[732,3442,485],{"id":3443},"identity-headers",[536,3445,3446,3448],{},[578,3447,589],{}," automatically tags every request with two headers so receivers can identify the traffic:",[553,3450,3451,3461],{},[556,3452,3453],{},[559,3454,3455,3458],{},[562,3456,3457],{},"Header",[562,3459,3460],{},"Value",[569,3462,3463,3476],{},[559,3464,3465,3470],{},[574,3466,3467],{},[578,3468,3469],{},"User-Agent",[574,3471,3472,3475],{},[578,3473,3474],{},"evlog\u002F\u003Cversion>"," (Node \u002F server runtimes only — browsers strip this header)",[559,3477,3478,3483],{},[574,3479,3480],{},[578,3481,3482],{},"X-Evlog-Source",[574,3484,3485,3486,3489],{},"The drain ",[578,3487,3488],{},"name"," you provided",[536,3491,3492,3493,3496,3497,1177],{},"If you build a drain on top of ",[578,3494,3495],{},"httpPost"," directly, you can override or suppress them — see ",[545,3498,485],{"href":486},[732,3500,3502],{"id":3501},"error-handling-already-done-for-you","Error handling — already done for you",[536,3504,3505,3507],{},[578,3506,589],{}," enforces every best practice automatically:",[1925,3509,3510,3520,3530,3538],{},[623,3511,3512,3515,3516,3519],{},[540,3513,3514],{},"Never throws"," — failures are caught and logged with the ",[578,3517,3518],{},"[evlog\u002F\u003Cname>]"," prefix.",[623,3521,3522,3525,3526,3529],{},[540,3523,3524],{},"Retries"," — defaults to 2 attempts on transient errors (configurable via ",[578,3527,3528],{},"retries",").",[623,3531,3532,3535,3536,3529],{},[540,3533,3534],{},"Timeouts"," — defaults to 5000ms (configurable via ",[578,3537,680],{},[623,3539,3540,3543,3544,3546,3547,3549],{},[540,3541,3542],{},"Graceful degradation"," — ",[578,3545,653],{}," returning ",[578,3548,694],{}," makes the drain a no-op.",[536,3551,3552,3553,3555],{},"If you fall back to ",[578,3554,602],{},", follow the same rules manually.",[732,3557,3559],{"id":3558},"publishing-as-a-community-package","Publishing as a community package",[536,3561,3562],{},"Recommended structure for a community drain:",[755,3564,3569],{"className":3565,"code":3567,"language":3568,"meta":761},[3566],"language-text","my-evlog-drain\u002F\n├─ src\u002F\n│  ├─ drain.ts        # createMyDrain via defineHttpDrain\n│  └─ index.ts        # re-exports\n├─ test\u002F              # vitest, mock fetch\n├─ package.json       # peerDependency: \"evlog\"\n└─ README.md\n","text",[578,3570,3567],{"__ignoreMap":761},[536,3572,3573,3574,3576,3577,3580,3581,3584],{},"Add ",[578,3575,2286],{}," as a ",[578,3578,3579],{},"peerDependency"," (not a ",[578,3582,3583],{},"dependency",") — your package shouldn't pull in a copy of evlog at install time.",[3586,3587,3590,3591,3596],"callout",{"color":3588,"icon":3589},"neutral","i-lucide-heart","Built something great? ",[545,3592,3595],{"href":3593,"rel":3594},"https:\u002F\u002Fgithub.com\u002Fhugorcd\u002Fevlog\u002Fpulls",[725],"Open a PR"," to add a row to the Adapters table — the community will thank you.",[732,3598,3600],{"id":3599},"next-steps","Next steps",[620,3602,3603,3609,3617,3623,3629],{},[623,3604,3605,3608],{},[545,3606,3607],{"href":496},"Drain Pipeline"," — wrap your drain in batch + retry + fanout for production",[623,3610,3611,3614,3615],{},[545,3612,3613],{"href":143},"Adapters Overview"," — see how the built-in adapters use ",[578,3616,589],{},[623,3618,3619,3622],{},[545,3620,3621],{"href":478},"Custom Enrichers"," — same toolkit shape for derived event fields",[623,3624,3625,3628],{},[545,3626,3627],{"href":456},"Custom Framework Integration"," — same toolkit shape for HTTP frameworks",[623,3630,3631,3633],{},[545,3632,517],{"href":518}," — security and production tips",[3635,3636,3637],"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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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}",{"title":761,"searchDepth":779,"depth":779,"links":3639},[3640,3644,3645,3646,3647,3649,3650,3651,3652,3653,3654],{"id":734,"depth":779,"text":3641,"children":3642},"defineHttpDrain (the HTTP recipe)",[3643],{"id":1435,"depth":789,"text":1436},{"id":1917,"depth":779,"text":1918},{"id":1997,"depth":779,"text":1998},{"id":2451,"depth":779,"text":2452},{"id":2823,"depth":779,"text":3648},"defineDrain (non-HTTP transports)",{"id":3038,"depth":779,"text":3039},{"id":3328,"depth":779,"text":3329},{"id":3443,"depth":779,"text":485},{"id":3501,"depth":779,"text":3502},{"id":3558,"depth":779,"text":3559},{"id":3599,"depth":779,"text":3600},"Build a drain for any backend without a built-in adapter — defineHttpDrain for HTTP destinations, defineDrain for any other transport. Standardized config resolution, retries, timeouts, and identity headers handled for you.","md",[3658,3660,3662],{"label":3607,"icon":498,"to":496,"color":3588,"variant":3659},"subtle",{"label":3613,"icon":3661,"to":143,"color":3588,"variant":3659},"i-custom-plug",{"label":517,"icon":379,"to":518,"color":3588,"variant":3659},{},{"title":490,"icon":493},{"title":531,"description":3655},"CmlLpH94lyME32t8at6pNQyhFCYNjhfal9aVs_NHU6E",[3668,3670],{"title":485,"path":486,"stem":487,"description":3669,"icon":488,"children":-1},"Every drain request sent by evlog is tagged with User-Agent and X-Evlog-Source headers so receivers can identify and triage the traffic. Override or suppress them when your custom drain needs different identity.",{"title":495,"path":496,"stem":497,"description":3671,"icon":498,"children":-1},"Batch events, retry on failure, fan out to multiple destinations, and ship browser logs to your server. The shared pipeline that wraps every drain in production.",1786001797086]