[{"data":1,"prerenderedAt":3580},["ShallowReactive",2],{"navigation_docs":3,"-extend-custom-drains":439,"-extend-custom-drains-surround":3575},[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":3563,"extension":3564,"links":3565,"meta":3571,"navigation":3572,"path":400,"seo":3573,"stem":401,"__hash__":3574},"docs\u002F5.extend\u002F8.custom-drains.md","Custom Drains",{"type":443,"value":444,"toc":3546},"minimark",[445,459,462,513,520,641,648,661,1325,1339,1344,1347,1823,1827,1832,1873,1903,1907,1914,2349,2357,2361,2373,2729,2735,2741,2927,2944,2948,2958,3217,3234,3238,3243,3349,3352,3357,3398,3407,3411,3416,3458,3464,3468,3471,3479,3493,3505,3509,3542],[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],"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,1859,1862,1863,1866,1867,1869,1870,1168],{},[488,1856,1857],{},"\u003CNS>_\u003CFIELD>"," env vars (list ",[488,1860,1861],{},"NUXT_\u003CNS>_\u003CFIELD>"," in ",[488,1864,1865],{},"ConfigField.env"," for silent Nuxt compat; show only ",[488,1868,1857],{}," in error messages via ",[488,1871,1872],{},"formatPublicEnvKeys",[446,1874,1875,1876,587,1878,587,1880,587,1882,1884,1885,1887,1888,1890,1891,1894,1895,1898,1899,1902],{},"Field names should follow the project conventions: ",[488,1877,578],{},[488,1879,582],{},[488,1881,586],{},[488,1883,590],{},". If you're renaming an existing field (e.g. ",[488,1886,1523],{}," → ",[488,1889,578],{},"), keep both as ",[488,1892,1893],{},"ConfigField"," entries for one major version — see ",[488,1896,1897],{},"axiom.ts"," and ",[488,1900,1901],{},"better-stack.ts"," for the deprecation pattern.",[642,1904,1906],{"id":1905},"wiring-the-drain-into-your-framework","Wiring the drain into your framework",[446,1908,1909,1910,1913],{},"Once ",[488,1911,1912],{},"createMyServiceDrain()"," returns the drain, wire it like any other:",[1915,1916,1917,2030,2156,2214,2251,2282],"code-group",{},[662,1918,1921],{"className":664,"code":1919,"filename":1920,"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,1922,1923,1929,1948,1952,1966,1970,1993,2024],{"__ignoreMap":668},[672,1924,1925],{"class":674,"line":675},[672,1926,1928],{"class":1927},"sHwdD","\u002F\u002F server\u002Fplugins\u002Fevlog-drain.ts\n",[672,1930,1931,1933,1935,1937,1939,1941,1943,1946],{"class":674,"line":686},[672,1932,679],{"class":678},[672,1934,1361],{"class":682},[672,1936,945],{"class":689},[672,1938,1366],{"class":682},[672,1940,721],{"class":678},[672,1942,724],{"class":682},[672,1944,1945],{"class":727},"~\u002Fserver\u002Futils\u002Fmy-drain",[672,1947,730],{"class":682},[672,1949,1950],{"class":674,"line":696},[672,1951,737],{"emptyLinePlaceholder":736},[672,1953,1954,1956,1959,1961,1963],{"class":674,"line":704},[672,1955,802],{"class":743},[672,1957,1958],{"class":689}," drain ",[672,1960,824],{"class":682},[672,1962,945],{"class":944},[672,1964,1965],{"class":689},"()\n",[672,1967,1968],{"class":674,"line":715},[672,1969,737],{"emptyLinePlaceholder":736},[672,1971,1972,1974,1977,1980,1982,1984,1987,1989,1991],{"class":674,"line":733},[672,1973,938],{"class":678},[672,1975,1976],{"class":678}," default",[672,1978,1979],{"class":944}," defineNitroPlugin",[672,1981,948],{"class":689},[672,1983,948],{"class":682},[672,1985,1986],{"class":951},"nitroApp",[672,1988,1168],{"class":682},[672,1990,1020],{"class":743},[672,1992,683],{"class":682},[672,1994,1995,1998,2000,2003,2005,2008,2010,2012,2015,2017,2019,2022],{"class":674,"line":740},[672,1996,1997],{"class":689},"  nitroApp",[672,1999,1084],{"class":682},[672,2001,2002],{"class":689},"hooks",[672,2004,1084],{"class":682},[672,2006,2007],{"class":944},"hook",[672,2009,948],{"class":756},[672,2011,845],{"class":682},[672,2013,2014],{"class":727},"evlog:drain",[672,2016,845],{"class":682},[672,2018,848],{"class":682},[672,2020,2021],{"class":689}," drain",[672,2023,1066],{"class":756},[672,2025,2026,2028],{"class":674,"line":753},[672,2027,718],{"class":682},[672,2029,1066],{"class":689},[662,2031,2033],{"className":664,"code":2032,"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,2034,2035,2040,2060,2079,2083,2120,2136,2150],{"__ignoreMap":668},[672,2036,2037],{"class":674,"line":675},[672,2038,2039],{"class":1927},"\u002F\u002F lib\u002Fevlog.ts\n",[672,2041,2042,2044,2046,2049,2051,2053,2055,2058],{"class":674,"line":686},[672,2043,679],{"class":678},[672,2045,1361],{"class":682},[672,2047,2048],{"class":689}," createEvlog",[672,2050,1366],{"class":682},[672,2052,721],{"class":678},[672,2054,724],{"class":682},[672,2056,2057],{"class":727},"evlog\u002Fnext",[672,2059,730],{"class":682},[672,2061,2062,2064,2066,2068,2070,2072,2074,2077],{"class":674,"line":696},[672,2063,679],{"class":678},[672,2065,1361],{"class":682},[672,2067,945],{"class":689},[672,2069,1366],{"class":682},[672,2071,721],{"class":678},[672,2073,724],{"class":682},[672,2075,2076],{"class":727},".\u002Fmy-drain",[672,2078,730],{"class":682},[672,2080,2081],{"class":674,"line":704},[672,2082,737],{"emptyLinePlaceholder":736},[672,2084,2085,2087,2090,2092,2095,2097,2100,2102,2105,2107,2110,2112,2114,2116,2118],{"class":674,"line":715},[672,2086,938],{"class":678},[672,2088,2089],{"class":743}," const",[672,2091,1361],{"class":682},[672,2093,2094],{"class":689}," withEvlog",[672,2096,848],{"class":682},[672,2098,2099],{"class":689}," useLogger",[672,2101,848],{"class":682},[672,2103,2104],{"class":689}," log",[672,2106,848],{"class":682},[672,2108,2109],{"class":689}," createError ",[672,2111,718],{"class":682},[672,2113,1034],{"class":682},[672,2115,2048],{"class":944},[672,2117,948],{"class":689},[672,2119,986],{"class":682},[672,2121,2122,2125,2127,2129,2132,2134],{"class":674,"line":733},[672,2123,2124],{"class":756},"  service",[672,2126,760],{"class":682},[672,2128,724],{"class":682},[672,2130,2131],{"class":727},"my-app",[672,2133,845],{"class":682},[672,2135,693],{"class":682},[672,2137,2138,2141,2143,2145,2148],{"class":674,"line":740},[672,2139,2140],{"class":756},"  drain",[672,2142,760],{"class":682},[672,2144,945],{"class":944},[672,2146,2147],{"class":689},"()",[672,2149,693],{"class":682},[672,2151,2152,2154],{"class":674,"line":753},[672,2153,718],{"class":682},[672,2155,1066],{"class":689},[662,2157,2160],{"className":664,"code":2158,"filename":2159,"language":667,"meta":668,"style":668},"import { createMyServiceDrain } from '.\u002Fmy-drain'\napp.use(evlog({ drain: createMyServiceDrain() }))\n","Hono \u002F Express \u002F Elysia",[488,2161,2162,2180],{"__ignoreMap":668},[672,2163,2164,2166,2168,2170,2172,2174,2176,2178],{"class":674,"line":675},[672,2165,679],{"class":678},[672,2167,1361],{"class":682},[672,2169,945],{"class":689},[672,2171,1366],{"class":682},[672,2173,721],{"class":678},[672,2175,724],{"class":682},[672,2177,2076],{"class":727},[672,2179,730],{"class":682},[672,2181,2182,2185,2187,2190,2192,2195,2197,2200,2202,2204,2206,2209,2211],{"class":674,"line":686},[672,2183,2184],{"class":689},"app",[672,2186,1084],{"class":682},[672,2188,2189],{"class":944},"use",[672,2191,948],{"class":689},[672,2193,2194],{"class":944},"evlog",[672,2196,948],{"class":689},[672,2198,2199],{"class":682},"{",[672,2201,2021],{"class":756},[672,2203,760],{"class":682},[672,2205,945],{"class":944},[672,2207,2208],{"class":689},"() ",[672,2210,718],{"class":682},[672,2212,2213],{"class":689},"))\n",[662,2215,2217],{"className":664,"code":2216,"filename":207,"language":667,"meta":668,"style":668},"await app.register(evlog, { drain: createMyServiceDrain() })\n",[488,2218,2219],{"__ignoreMap":668},[672,2220,2221,2224,2227,2229,2232,2235,2237,2239,2241,2243,2245,2247,2249],{"class":674,"line":675},[672,2222,2223],{"class":678},"await",[672,2225,2226],{"class":689}," app",[672,2228,1084],{"class":682},[672,2230,2231],{"class":944},"register",[672,2233,2234],{"class":689},"(evlog",[672,2236,848],{"class":682},[672,2238,1361],{"class":682},[672,2240,2021],{"class":756},[672,2242,760],{"class":682},[672,2244,945],{"class":944},[672,2246,2208],{"class":689},[672,2248,718],{"class":682},[672,2250,1066],{"class":689},[662,2252,2254],{"className":664,"code":2253,"filename":192,"language":667,"meta":668,"style":668},"EvlogModule.forRoot({ drain: createMyServiceDrain() })\n",[488,2255,2256],{"__ignoreMap":668},[672,2257,2258,2261,2263,2266,2268,2270,2272,2274,2276,2278,2280],{"class":674,"line":675},[672,2259,2260],{"class":689},"EvlogModule",[672,2262,1084],{"class":682},[672,2264,2265],{"class":944},"forRoot",[672,2267,948],{"class":689},[672,2269,2199],{"class":682},[672,2271,2021],{"class":756},[672,2273,760],{"class":682},[672,2275,945],{"class":944},[672,2277,2208],{"class":689},[672,2279,718],{"class":682},[672,2281,1066],{"class":689},[662,2283,2285],{"className":664,"code":2284,"filename":227,"language":667,"meta":668,"style":668},"import { initLogger } from 'evlog'\nimport { createMyServiceDrain } from '.\u002Fmy-drain'\n\ninitLogger({ drain: createMyServiceDrain() })\n",[488,2286,2287,2306,2324,2328],{"__ignoreMap":668},[672,2288,2289,2291,2293,2296,2298,2300,2302,2304],{"class":674,"line":675},[672,2290,679],{"class":678},[672,2292,1361],{"class":682},[672,2294,2295],{"class":689}," initLogger",[672,2297,1366],{"class":682},[672,2299,721],{"class":678},[672,2301,724],{"class":682},[672,2303,2194],{"class":727},[672,2305,730],{"class":682},[672,2307,2308,2310,2312,2314,2316,2318,2320,2322],{"class":674,"line":686},[672,2309,679],{"class":678},[672,2311,1361],{"class":682},[672,2313,945],{"class":689},[672,2315,1366],{"class":682},[672,2317,721],{"class":678},[672,2319,724],{"class":682},[672,2321,2076],{"class":727},[672,2323,730],{"class":682},[672,2325,2326],{"class":674,"line":696},[672,2327,737],{"emptyLinePlaceholder":736},[672,2329,2330,2333,2335,2337,2339,2341,2343,2345,2347],{"class":674,"line":704},[672,2331,2332],{"class":944},"initLogger",[672,2334,948],{"class":689},[672,2336,2199],{"class":682},[672,2338,2021],{"class":756},[672,2340,760],{"class":682},[672,2342,945],{"class":944},[672,2344,2208],{"class":689},[672,2346,718],{"class":682},[672,2348,1066],{"class":689},[446,2350,2351,2352,2356],{},"For production, wrap it once in ",[455,2353,2354],{"href":405},[488,2355,626],{}," so events are batched and retried.",[642,2358,2360],{"id":2359},"filtering-and-transforming-events","Filtering and transforming events",[446,2362,2363,2365,2366,2369,2370,2372],{},[488,2364,659],{}," receives the full batch of ",[488,2367,2368],{},"WideEvent[]"," plus the resolved config. Filter or transform inline — returning ",[488,2371,604],{}," is a clean opt-out for that batch:",[662,2374,2376],{"className":664,"code":2375,"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,2377,2378,2399,2459,2486,2490,2515,2547,2569,2633,2639,2643,2649,2673,2698,2720,2725],{"__ignoreMap":668},[672,2379,2380,2383,2385,2387,2389,2391,2393,2395,2397],{"class":674,"line":675},[672,2381,2382],{"class":747},"encode",[672,2384,760],{"class":682},[672,2386,1075],{"class":682},[672,2388,1161],{"class":951},[672,2390,848],{"class":682},[672,2392,1031],{"class":951},[672,2394,1168],{"class":682},[672,2396,1020],{"class":743},[672,2398,683],{"class":682},[672,2400,2401,2404,2407,2409,2411,2413,2416,2418,2420,2422,2424,2426,2428,2431,2433,2435,2437,2440,2442,2444,2447,2450,2452,2455,2457],{"class":674,"line":686},[672,2402,2403],{"class":743},"  const",[672,2405,2406],{"class":689}," filtered",[672,2408,1034],{"class":682},[672,2410,1671],{"class":689},[672,2412,1084],{"class":682},[672,2414,2415],{"class":944},"filter",[672,2417,948],{"class":756},[672,2419,1681],{"class":951},[672,2421,1020],{"class":743},[672,2423,1704],{"class":689},[672,2425,1084],{"class":682},[672,2427,1723],{"class":689},[672,2429,2430],{"class":682}," ===",[672,2432,724],{"class":682},[672,2434,1102],{"class":727},[672,2436,845],{"class":682},[672,2438,2439],{"class":682}," &&",[672,2441,1704],{"class":689},[672,2443,1084],{"class":682},[672,2445,2446],{"class":689},"path",[672,2448,2449],{"class":682}," !==",[672,2451,724],{"class":682},[672,2453,2454],{"class":727},"\u002Fhealth",[672,2456,845],{"class":682},[672,2458,1066],{"class":756},[672,2460,2461,2464,2466,2469,2471,2474,2476,2479,2481,2484],{"class":674,"line":696},[672,2462,2463],{"class":678},"  if",[672,2465,1075],{"class":756},[672,2467,2468],{"class":689},"filtered",[672,2470,1084],{"class":682},[672,2472,2473],{"class":689},"length",[672,2475,2430],{"class":682},[672,2477,2478],{"class":1765}," 0",[672,2480,1089],{"class":756},[672,2482,2483],{"class":678},"return",[672,2485,1122],{"class":682},[672,2487,2488],{"class":674,"line":704},[672,2489,737],{"emptyLinePlaceholder":736},[672,2491,2492,2494,2497,2499,2501,2503,2505,2507,2509,2511,2513],{"class":674,"line":715},[672,2493,2403],{"class":743},[672,2495,2496],{"class":689}," payload",[672,2498,1034],{"class":682},[672,2500,2406],{"class":689},[672,2502,1084],{"class":682},[672,2504,1676],{"class":944},[672,2506,948],{"class":756},[672,2508,1681],{"class":951},[672,2510,1020],{"class":743},[672,2512,1075],{"class":756},[672,2514,986],{"class":682},[672,2516,2517,2520,2522,2525,2528,2530,2532,2534,2536,2538,2540,2543,2545],{"class":674,"line":733},[672,2518,2519],{"class":756},"    ts",[672,2521,760],{"class":682},[672,2523,2524],{"class":682}," new",[672,2526,2527],{"class":944}," Date",[672,2529,948],{"class":756},[672,2531,1681],{"class":689},[672,2533,1084],{"class":682},[672,2535,1757],{"class":689},[672,2537,1168],{"class":756},[672,2539,1084],{"class":682},[672,2541,2542],{"class":944},"getTime",[672,2544,2147],{"class":756},[672,2546,693],{"class":682},[672,2548,2549,2552,2554,2556,2558,2560,2562,2565,2567],{"class":674,"line":740},[672,2550,2551],{"class":756},"    severity",[672,2553,760],{"class":682},[672,2555,1704],{"class":689},[672,2557,1084],{"class":682},[672,2559,1723],{"class":689},[672,2561,1084],{"class":682},[672,2563,2564],{"class":944},"toUpperCase",[672,2566,2147],{"class":756},[672,2568,693],{"class":682},[672,2570,2571,2574,2576,2578,2581,2583,2585,2587,2590,2592,2595,2597,2599,2601,2603,2605,2608,2610,2612,2614,2617,2619,2622,2624,2626,2628,2631],{"class":674,"line":753},[672,2572,2573],{"class":756},"    attributes",[672,2575,760],{"class":682},[672,2577,1361],{"class":682},[672,2579,2580],{"class":756}," method",[672,2582,760],{"class":682},[672,2584,1704],{"class":689},[672,2586,1084],{"class":682},[672,2588,2589],{"class":689},"method",[672,2591,848],{"class":682},[672,2593,2594],{"class":756}," path",[672,2596,760],{"class":682},[672,2598,1704],{"class":689},[672,2600,1084],{"class":682},[672,2602,2446],{"class":689},[672,2604,848],{"class":682},[672,2606,2607],{"class":756}," status",[672,2609,760],{"class":682},[672,2611,1704],{"class":689},[672,2613,1084],{"class":682},[672,2615,2616],{"class":689},"status",[672,2618,848],{"class":682},[672,2620,2621],{"class":756}," duration",[672,2623,760],{"class":682},[672,2625,1704],{"class":689},[672,2627,1084],{"class":682},[672,2629,2630],{"class":689},"duration",[672,2632,921],{"class":682},[672,2634,2635,2637],{"class":674,"line":766},[672,2636,1317],{"class":682},[672,2638,2213],{"class":756},[672,2640,2641],{"class":674,"line":777},[672,2642,737],{"emptyLinePlaceholder":736},[672,2644,2645,2647],{"class":674,"line":788},[672,2646,972],{"class":678},[672,2648,683],{"class":682},[672,2650,2651,2654,2656,2658,2660,2662,2664,2666,2669,2671],{"class":674,"line":794},[672,2652,2653],{"class":756},"    url",[672,2655,760],{"class":682},[672,2657,1185],{"class":682},[672,2659,1081],{"class":689},[672,2661,1084],{"class":682},[672,2663,582],{"class":689},[672,2665,718],{"class":682},[672,2667,2668],{"class":727},"\u002Fv1\u002Fpush",[672,2670,1209],{"class":682},[672,2672,693],{"class":682},[672,2674,2675,2678,2680,2682,2684,2686,2688,2690,2692,2694,2696],{"class":674,"line":799},[672,2676,2677],{"class":756},"    headers",[672,2679,760],{"class":682},[672,2681,1361],{"class":682},[672,2683,724],{"class":682},[672,2685,1230],{"class":756},[672,2687,845],{"class":682},[672,2689,760],{"class":682},[672,2691,724],{"class":682},[672,2693,1239],{"class":727},[672,2695,845],{"class":682},[672,2697,921],{"class":682},[672,2699,2700,2703,2705,2707,2709,2711,2713,2716,2718],{"class":674,"line":830},[672,2701,2702],{"class":756},"    body",[672,2704,760],{"class":682},[672,2706,1288],{"class":689},[672,2708,1084],{"class":682},[672,2710,1293],{"class":944},[672,2712,948],{"class":756},[672,2714,2715],{"class":689},"payload",[672,2717,1168],{"class":756},[672,2719,693],{"class":682},[672,2721,2722],{"class":674,"line":872},[672,2723,2724],{"class":682},"  }\n",[672,2726,2727],{"class":674,"line":906},[672,2728,791],{"class":682},[642,2730,2732,2734],{"id":2731},"definedrain-non-http-transports",[488,2733,512],{}," (non-HTTP transports)",[446,2736,2737,2738,2740],{},"If your destination requires gRPC, a vendor SDK, a queue client, a WebSocket, or a raw socket, drop one level lower with ",[488,2739,512],{},". You own the transport; the toolkit still gives you config resolution, error isolation, and a consistent shape.",[662,2742,2744],{"className":664,"code":2743,"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,2745,2746,2765,2769,2785,2805,2820,2859,2882,2917,2921],{"__ignoreMap":668},[672,2747,2748,2750,2752,2755,2757,2759,2761,2763],{"class":674,"line":675},[672,2749,679],{"class":678},[672,2751,1361],{"class":682},[672,2753,2754],{"class":689}," defineDrain",[672,2756,1366],{"class":682},[672,2758,721],{"class":678},[672,2760,724],{"class":682},[672,2762,518],{"class":727},[672,2764,730],{"class":682},[672,2766,2767],{"class":674,"line":686},[672,2768,737],{"emptyLinePlaceholder":736},[672,2770,2771,2773,2775,2778,2780,2782],{"class":674,"line":696},[672,2772,938],{"class":678},[672,2774,2089],{"class":743},[672,2776,2777],{"class":689}," createCustomTransportDrain ",[672,2779,824],{"class":682},[672,2781,1017],{"class":682},[672,2783,2784],{"class":743}," =>\n",[672,2786,2787,2790,2792,2795,2797,2799,2801,2803],{"class":674,"line":704},[672,2788,2789],{"class":944},"  defineDrain",[672,2791,1426],{"class":682},[672,2793,2794],{"class":756}," apiKey",[672,2796,760],{"class":682},[672,2798,1403],{"class":747},[672,2800,1443],{"class":682},[672,2802,948],{"class":689},[672,2804,986],{"class":682},[672,2806,2807,2809,2811,2813,2816,2818],{"class":674,"line":715},[672,2808,992],{"class":756},[672,2810,760],{"class":682},[672,2812,724],{"class":682},[672,2814,2815],{"class":727},"custom",[672,2817,845],{"class":682},[672,2819,693],{"class":682},[672,2821,2822,2824,2826,2828,2830,2832,2834,2836,2838,2840,2842,2844,2846,2848,2851,2853,2855,2857],{"class":674,"line":733},[672,2823,1009],{"class":944},[672,2825,760],{"class":682},[672,2827,1014],{"class":743},[672,2829,1017],{"class":682},[672,2831,1020],{"class":743},[672,2833,1075],{"class":689},[672,2835,2199],{"class":682},[672,2837,2794],{"class":756},[672,2839,760],{"class":682},[672,2841,1496],{"class":689},[672,2843,1084],{"class":682},[672,2845,1501],{"class":689},[672,2847,1084],{"class":682},[672,2849,2850],{"class":689},"MY_KEY",[672,2852,1078],{"class":682},[672,2854,1366],{"class":682},[672,2856,1168],{"class":689},[672,2858,693],{"class":682},[672,2860,2861,2864,2866,2868,2870,2872,2874,2876,2878,2880],{"class":674,"line":740},[672,2862,2863],{"class":944},"    send",[672,2865,760],{"class":682},[672,2867,1014],{"class":743},[672,2869,1075],{"class":682},[672,2871,1161],{"class":951},[672,2873,848],{"class":682},[672,2875,1031],{"class":951},[672,2877,1168],{"class":682},[672,2879,1020],{"class":743},[672,2881,683],{"class":682},[672,2883,2884,2887,2890,2892,2895,2897,2899,2901,2903,2905,2907,2909,2911,2913,2915],{"class":674,"line":753},[672,2885,2886],{"class":678},"      await",[672,2888,2889],{"class":689}," myVendorSdk",[672,2891,1084],{"class":682},[672,2893,2894],{"class":944},"publish",[672,2896,948],{"class":756},[672,2898,1161],{"class":689},[672,2900,848],{"class":682},[672,2902,1361],{"class":682},[672,2904,1408],{"class":756},[672,2906,760],{"class":682},[672,2908,1031],{"class":689},[672,2910,1084],{"class":682},[672,2912,578],{"class":689},[672,2914,1366],{"class":682},[672,2916,1066],{"class":756},[672,2918,2919],{"class":674,"line":766},[672,2920,1148],{"class":682},[672,2922,2923,2925],{"class":674,"line":777},[672,2924,1317],{"class":682},[672,2926,1066],{"class":689},[446,2928,2929,2930,2932,2933,2935,2936,2939,2940,2943],{},"When you fall back to ",[488,2931,512],{},", follow the same rules manually that ",[488,2934,499],{}," enforces: wrap the transport in ",[488,2937,2938],{},"try\u002Fcatch",", log with ",[488,2941,2942],{},"console.error('[evlog\u002F\u003Cname>] …')",", and never re-throw.",[642,2945,2947],{"id":2946},"draincontext-reference","DrainContext reference",[446,2949,2950,2951,2953,2954,2957],{},"When evlog calls your drain through ",[488,2952,2014],{},", it passes a ",[488,2955,2956],{},"DrainContext"," per event:",[662,2959,2962],{"className":664,"code":2960,"filename":2961,"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,2963,2964,2973,2978,2988,2992,2997,3006,3015,3024,3033,3037,3041,3046,3068,3072,3076,3085,3094,3135,3143,3152,3161,3170,3179,3188,3193,3213],{"__ignoreMap":668},[672,2965,2966,2968,2971],{"class":674,"line":675},[672,2967,744],{"class":743},[672,2969,2970],{"class":747}," DrainContext",[672,2972,683],{"class":682},[672,2974,2975],{"class":674,"line":686},[672,2976,2977],{"class":1927},"  \u002F** The complete wide event with all accumulated context *\u002F\n",[672,2979,2980,2983,2985],{"class":674,"line":696},[672,2981,2982],{"class":756},"  event",[672,2984,760],{"class":682},[672,2986,2987],{"class":747}," WideEvent\n",[672,2989,2990],{"class":674,"line":704},[672,2991,737],{"emptyLinePlaceholder":736},[672,2993,2994],{"class":674,"line":715},[672,2995,2996],{"class":1927},"  \u002F** Request metadata *\u002F\n",[672,2998,2999,3002,3004],{"class":674,"line":733},[672,3000,3001],{"class":756},"  request",[672,3003,772],{"class":682},[672,3005,683],{"class":682},[672,3007,3008,3011,3013],{"class":674,"line":740},[672,3009,3010],{"class":756},"    method",[672,3012,760],{"class":682},[672,3014,763],{"class":747},[672,3016,3017,3020,3022],{"class":674,"line":753},[672,3018,3019],{"class":756},"    path",[672,3021,760],{"class":682},[672,3023,763],{"class":747},[672,3025,3026,3029,3031],{"class":674,"line":766},[672,3027,3028],{"class":756},"    requestId",[672,3030,760],{"class":682},[672,3032,763],{"class":747},[672,3034,3035],{"class":674,"line":777},[672,3036,2724],{"class":682},[672,3038,3039],{"class":674,"line":788},[672,3040,737],{"emptyLinePlaceholder":736},[672,3042,3043],{"class":674,"line":794},[672,3044,3045],{"class":1927},"  \u002F** Safe HTTP headers (sensitive headers filtered) *\u002F\n",[672,3047,3048,3051,3053,3056,3058,3061,3063,3065],{"class":674,"line":799},[672,3049,3050],{"class":756},"  headers",[672,3052,772],{"class":682},[672,3054,3055],{"class":747}," Record",[672,3057,812],{"class":682},[672,3059,3060],{"class":747},"string",[672,3062,848],{"class":682},[672,3064,1403],{"class":747},[672,3066,3067],{"class":682},">\n",[672,3069,3070],{"class":674,"line":830},[672,3071,791],{"class":682},[672,3073,3074],{"class":674,"line":872},[672,3075,737],{"emptyLinePlaceholder":736},[672,3077,3078,3080,3083],{"class":674,"line":906},[672,3079,744],{"class":743},[672,3081,3082],{"class":747}," WideEvent",[672,3084,683],{"class":682},[672,3086,3087,3090,3092],{"class":674,"line":924},[672,3088,3089],{"class":756},"  timestamp",[672,3091,760],{"class":682},[672,3093,763],{"class":747},[672,3095,3096,3099,3101,3103,3106,3108,3111,3113,3116,3118,3120,3122,3125,3127,3129,3131,3133],{"class":674,"line":930},[672,3097,3098],{"class":756},"  level",[672,3100,760],{"class":682},[672,3102,724],{"class":682},[672,3104,3105],{"class":727},"debug",[672,3107,845],{"class":682},[672,3109,3110],{"class":682}," |",[672,3112,724],{"class":682},[672,3114,3115],{"class":727},"info",[672,3117,845],{"class":682},[672,3119,3110],{"class":682},[672,3121,724],{"class":682},[672,3123,3124],{"class":727},"warn",[672,3126,845],{"class":682},[672,3128,3110],{"class":682},[672,3130,724],{"class":682},[672,3132,1102],{"class":727},[672,3134,730],{"class":682},[672,3136,3137,3139,3141],{"class":674,"line":935},[672,3138,2124],{"class":756},[672,3140,760],{"class":682},[672,3142,763],{"class":747},[672,3144,3145,3148,3150],{"class":674,"line":969},[672,3146,3147],{"class":756},"  environment",[672,3149,772],{"class":682},[672,3151,763],{"class":747},[672,3153,3154,3157,3159],{"class":674,"line":989},[672,3155,3156],{"class":756},"  version",[672,3158,772],{"class":682},[672,3160,763],{"class":747},[672,3162,3163,3166,3168],{"class":674,"line":1006},[672,3164,3165],{"class":756},"  region",[672,3167,772],{"class":682},[672,3169,763],{"class":747},[672,3171,3172,3175,3177],{"class":674,"line":1025},[672,3173,3174],{"class":756},"  commitHash",[672,3176,772],{"class":682},[672,3178,763],{"class":747},[672,3180,3181,3184,3186],{"class":674,"line":1069},[672,3182,3183],{"class":756},"  requestId",[672,3185,772],{"class":682},[672,3187,763],{"class":747},[672,3189,3190],{"class":674,"line":1094},[672,3191,3192],{"class":1927},"  \u002F\u002F ... plus all fields added via log.set()\n",[672,3194,3195,3198,3201,3203,3205,3208,3210],{"class":674,"line":1116},[672,3196,3197],{"class":689},"  [",[672,3199,3200],{"class":951},"key",[672,3202,760],{"class":682},[672,3204,1403],{"class":747},[672,3206,3207],{"class":689},"]",[672,3209,760],{"class":682},[672,3211,3212],{"class":747}," unknown\n",[672,3214,3215],{"class":674,"line":1125},[672,3216,791],{"class":682},[446,3218,3219,3220,3222,3223,3226,3227,3229,3230,3233],{},"In the batched form your ",[488,3221,659],{}," \u002F ",[488,3224,3225],{},"send()"," receives, you get ",[488,3228,2368],{}," directly (the toolkit unwraps ",[488,3231,3232],{},"event"," from each context).",[642,3235,3237],{"id":3236},"toolkit-helpers","Toolkit helpers",[446,3239,3240,3242],{},[488,3241,518],{}," exposes the same helpers every built-in adapter uses. The ones relevant to drains:",[463,3244,3245,3255],{},[466,3246,3247],{},[469,3248,3249,3252],{},[472,3250,3251],{},"Export",[472,3253,3254],{},"Purpose",[479,3256,3257,3267,3277,3289,3299,3312,3322,3336],{},[469,3258,3259,3264],{},[484,3260,3261],{},[488,3262,3263],{},"defineHttpDrain(spec)",[484,3265,3266],{},"The HTTP recipe — auto retries, timeouts, identity headers, error isolation",[469,3268,3269,3274],{},[484,3270,3271],{},[488,3272,3273],{},"defineDrain(spec)",[484,3275,3276],{},"Same contract for non-HTTP transports",[469,3278,3279,3284],{},[484,3280,3281],{},[488,3282,3283],{},"resolveAdapterConfig(ns, fields, overrides)",[484,3285,3286,3287,572],{},"Standard config priority chain (overrides → ",[488,3288,571],{},[469,3290,3291,3296],{},[484,3292,3293],{},[488,3294,3295],{},"httpPost(opts)",[484,3297,3298],{},"The retried POST helper used by every built-in HTTP adapter — handles timeout, retries, redacted error messages",[469,3300,3301,3306],{},[484,3302,3303],{},[488,3304,3305],{},"composeDrains(drains)",[484,3307,3308,3309,1168],{},"Combine multiple drains into one (errors isolated, runs concurrently with ",[488,3310,3311],{},"Promise.allSettled",[469,3313,3314,3319],{},[484,3315,3316],{},[488,3317,3318],{},"toTypedAttributeValue(value)",[484,3320,3321],{},"Convert any value to the typed attribute shape used by Axiom \u002F Sentry",[469,3323,3324,3329],{},[484,3325,3326],{},[488,3327,3328],{},"toOtlpAttributeValue(value)",[484,3330,3331,3332,3335],{},"Convert any value to the OTLP ",[488,3333,3334],{},"AnyValue"," shape (used by OTLP \u002F HyperDX \u002F PostHog logs)",[469,3337,3338,3346],{},[484,3339,3340,587,3343],{},[488,3341,3342],{},"OTEL_SEVERITY_NUMBER",[488,3344,3345],{},"OTEL_SEVERITY_TEXT",[484,3347,3348],{},"OTEL log severity tables",[642,3350,394],{"id":3351},"identity-headers",[446,3353,3354,3356],{},[488,3355,499],{}," automatically tags every request with two headers so receivers can identify the traffic:",[463,3358,3359,3369],{},[466,3360,3361],{},[469,3362,3363,3366],{},[472,3364,3365],{},"Header",[472,3367,3368],{},"Value",[479,3370,3371,3384],{},[469,3372,3373,3378],{},[484,3374,3375],{},[488,3376,3377],{},"User-Agent",[484,3379,3380,3383],{},[488,3381,3382],{},"evlog\u002F\u003Cversion>"," (Node \u002F server runtimes only — browsers strip this header)",[469,3385,3386,3391],{},[484,3387,3388],{},[488,3389,3390],{},"X-Evlog-Source",[484,3392,3393,3394,3397],{},"The drain ",[488,3395,3396],{},"name"," you provided",[446,3399,3400,3401,3404,3405,1084],{},"If you build a drain on top of ",[488,3402,3403],{},"httpPost"," directly, you can override or suppress them — see ",[455,3406,394],{"href":395},[642,3408,3410],{"id":3409},"error-handling-already-done-for-you","Error handling — already done for you",[446,3412,3413,3415],{},[488,3414,499],{}," enforces every best practice automatically:",[1833,3417,3418,3428,3438,3446],{},[533,3419,3420,3423,3424,3427],{},[450,3421,3422],{},"Never throws"," — failures are caught and logged with the ",[488,3425,3426],{},"[evlog\u002F\u003Cname>]"," prefix.",[533,3429,3430,3433,3434,3437],{},[450,3431,3432],{},"Retries"," — defaults to 2 attempts on transient errors (configurable via ",[488,3435,3436],{},"retries",").",[533,3439,3440,3443,3444,3437],{},[450,3441,3442],{},"Timeouts"," — defaults to 5000ms (configurable via ",[488,3445,590],{},[533,3447,3448,3451,3452,3454,3455,3457],{},[450,3449,3450],{},"Graceful degradation"," — ",[488,3453,563],{}," returning ",[488,3456,604],{}," makes the drain a no-op.",[446,3459,3460,3461,3463],{},"If you fall back to ",[488,3462,512],{},", follow the same rules manually.",[642,3465,3467],{"id":3466},"publishing-as-a-community-package","Publishing as a community package",[446,3469,3470],{},"Recommended structure for a community drain:",[662,3472,3477],{"className":3473,"code":3475,"language":3476,"meta":668},[3474],"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,3478,3475],{"__ignoreMap":668},[446,3480,3481,3482,3484,3485,3488,3489,3492],{},"Add ",[488,3483,2194],{}," as a ",[488,3486,3487],{},"peerDependency"," (not a ",[488,3490,3491],{},"dependency",") — your package shouldn't pull in a copy of evlog at install time.",[3494,3495,3498,3499,3504],"callout",{"color":3496,"icon":3497},"neutral","i-lucide-heart","Built something great? ",[455,3500,3503],{"href":3501,"rel":3502},"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,3506,3508],{"id":3507},"next-steps","Next steps",[530,3510,3511,3517,3525,3531,3537],{},[533,3512,3513,3516],{},[455,3514,3515],{"href":405},"Drain Pipeline"," — wrap your drain in batch + retry + fanout for production",[533,3518,3519,3522,3523],{},[455,3520,3521],{"href":95},"Adapters Overview"," — see how the built-in adapters use ",[488,3524,499],{},[533,3526,3527,3530],{},[455,3528,3529],{"href":387},"Custom Enrichers"," — same toolkit shape for derived event fields",[533,3532,3533,3536],{},[455,3534,3535],{"href":369},"Custom Framework Integration"," — same toolkit shape for HTTP frameworks",[533,3538,3539,3541],{},[455,3540,427],{"href":428}," — security and production tips",[3543,3544,3545],"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":3547},[3548,3552,3553,3554,3555,3557,3558,3559,3560,3561,3562],{"id":644,"depth":686,"text":3549,"children":3550},"defineHttpDrain (the HTTP recipe)",[3551],{"id":1342,"depth":696,"text":1343},{"id":1825,"depth":686,"text":1826},{"id":1905,"depth":686,"text":1906},{"id":2359,"depth":686,"text":2360},{"id":2731,"depth":686,"text":3556},"defineDrain (non-HTTP transports)",{"id":2946,"depth":686,"text":2947},{"id":3236,"depth":686,"text":3237},{"id":3351,"depth":686,"text":394},{"id":3409,"depth":686,"text":3410},{"id":3466,"depth":686,"text":3467},{"id":3507,"depth":686,"text":3508},"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",[3566,3568,3570],{"label":3515,"icon":407,"to":405,"color":3496,"variant":3567},"subtle",{"label":3521,"icon":3569,"to":95,"color":3496,"variant":3567},"i-custom-plug",{"label":427,"icon":318,"to":428,"color":3496,"variant":3567},{},{"title":399,"icon":402},{"title":441,"description":3563},"3keCTtrYI4m0InxzFzdh__CUaCVnTsL4WT_07rNF9mY",[3576,3578],{"title":394,"path":395,"stem":396,"description":3577,"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":3579,"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.",1781250181889]