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