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