[{"data":1,"prerenderedAt":1265},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-better-auth-middleware":528,"-use-cases-better-auth-middleware-surround":1260},[4,29,76,122,304,435,496],{"title":5,"path":6,"stem":7,"children":8,"page":28},"Start","\u002Fstart","1.start",[9,13,18,23],{"title":10,"path":11,"stem":12},"Introduction","\u002Fstart\u002Fintroduction","1.start\u002F1.introduction",{"title":14,"path":15,"stem":16,"icon":17},"Why start with evlog","\u002Fstart\u002Fwhy-evlog","1.start\u002F2.why-evlog","i-lucide-rocket",{"title":19,"path":20,"stem":21,"icon":22},"Installation","\u002Fstart\u002Finstallation","1.start\u002F3.installation","i-lucide-download",{"title":24,"path":25,"stem":26,"icon":27},"Quick Start","\u002Fstart\u002Fquick-start","1.start\u002F4.quick-start","i-lucide-zap",false,{"title":30,"path":31,"stem":32,"children":33,"page":28},"Learn","\u002Flearn","2.learn",[34,38,43,48,53,58,62,67,72],{"title":35,"path":36,"stem":37},"Learn evlog","\u002Flearn\u002Foverview","2.learn\u002F0.overview",{"title":39,"path":40,"stem":41,"icon":42},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":44,"path":45,"stem":46,"icon":47},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":49,"path":50,"stem":51,"icon":52},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":54,"path":55,"stem":56,"icon":57},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":59,"path":60,"stem":61},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling",{"title":63,"path":64,"stem":65,"icon":66},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":68,"path":69,"stem":70,"icon":71},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":73,"path":74,"stem":75},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs",{"title":77,"path":78,"stem":79,"children":80,"page":28},"CLI","\u002Fcli","3.cli",[81,85,90,95,99,103,108,113,118],{"title":82,"path":83,"stem":84},"evlog CLI","\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":86,"path":87,"stem":88,"icon":89},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":91,"path":92,"stem":93,"icon":94},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":96,"path":97,"stem":98},"Map rules","\u002Fcli\u002Frules","3.cli\u002F3.rules",{"title":100,"path":101,"stem":102},"Map scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring",{"title":104,"path":105,"stem":106,"icon":107},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":109,"path":110,"stem":111,"icon":112},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":114,"path":115,"stem":116,"icon":117},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":119,"path":120,"stem":121},"evlog agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents",{"title":123,"path":124,"stem":125,"children":126,"page":28},"Integrate","\u002Fintegrate","4.integrate",[127,132,216],{"title":128,"path":129,"stem":130,"icon":131},"Overview","\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":133,"path":134,"stem":135,"children":136,"page":28},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[137,141,171,196],{"title":128,"path":138,"stem":139,"icon":140},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview","i-lucide-list",{"title":142,"path":143,"stem":144,"children":145,"page":28},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[146,151,156,161,166],{"title":147,"path":148,"stem":149,"icon":150},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":152,"path":153,"stem":154,"icon":155},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":157,"path":158,"stem":159,"icon":160},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":162,"path":163,"stem":164,"icon":165},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":167,"path":168,"stem":169,"icon":170},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":172,"path":173,"stem":174,"children":175,"page":28},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[176,181,186,191],{"title":177,"path":178,"stem":179,"icon":180},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":182,"path":183,"stem":184,"icon":185},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":187,"path":188,"stem":189,"icon":190},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":192,"path":193,"stem":194,"icon":195},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":197,"path":198,"stem":199,"children":200,"page":28},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[201,206,211],{"title":202,"path":203,"stem":204,"icon":205},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":207,"path":208,"stem":209,"icon":210},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":212,"path":213,"stem":214,"icon":215},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":217,"path":218,"stem":219,"children":220,"page":28},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[221,225,230,235,240,245,250,255,260,265,270,275,280,285,289,294,299],{"title":128,"path":222,"stem":223,"icon":224},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":226,"path":227,"stem":228,"icon":229},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":231,"path":232,"stem":233,"icon":234},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":236,"path":237,"stem":238,"icon":239},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":241,"path":242,"stem":243,"icon":244},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":246,"path":247,"stem":248,"icon":249},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":251,"path":252,"stem":253,"icon":254},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":256,"path":257,"stem":258,"icon":259},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":261,"path":262,"stem":263,"icon":264},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":266,"path":267,"stem":268,"icon":269},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":271,"path":272,"stem":273,"icon":274},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":276,"path":277,"stem":278,"icon":279},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":281,"path":282,"stem":283,"icon":284},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":286,"path":287,"stem":288,"icon":71},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":290,"path":291,"stem":292,"icon":293},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":295,"path":296,"stem":297,"icon":298},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":300,"path":301,"stem":302,"icon":303},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":305,"path":306,"stem":307,"children":308,"page":28},"Use Cases","\u002Fuse-cases","5.use-cases",[309,312,317,346,374,407,427,431],{"title":305,"path":310,"stem":311},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":313,"path":314,"stem":315,"icon":316},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":318,"icon":319,"path":320,"stem":321,"children":322,"page":28},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[323,326,331,336,341],{"title":128,"path":324,"stem":325,"icon":140},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":327,"path":328,"stem":329,"icon":330},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":332,"path":333,"stem":334,"icon":335},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":337,"path":338,"stem":339,"icon":340},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":342,"path":343,"stem":344,"icon":345},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":347,"icon":348,"path":349,"stem":350,"children":351,"page":28},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[352,355,360,365,369],{"title":128,"path":353,"stem":354,"icon":140},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":356,"path":357,"stem":358,"icon":359},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":361,"path":362,"stem":363,"icon":364},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":366,"path":367,"stem":368,"icon":316},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":370,"path":371,"stem":372,"icon":373},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance","i-lucide-gauge",{"title":375,"icon":376,"path":377,"stem":378,"children":379,"page":28},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[380,383,388,393,398,402],{"title":128,"path":381,"stem":382,"icon":140},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":384,"path":385,"stem":386,"icon":387},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":389,"path":390,"stem":391,"icon":392},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":394,"path":395,"stem":396,"icon":397},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":399,"path":400,"stem":401,"icon":376},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":403,"path":404,"stem":405,"icon":406},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes","i-lucide-book-open",{"title":342,"icon":373,"path":408,"stem":409,"children":410,"page":28},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[411,414,419,423],{"title":128,"path":412,"stem":413,"icon":140},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":415,"path":416,"stem":417,"icon":418},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":420,"path":421,"stem":422},"Telemetry Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest",{"title":424,"path":425,"stem":426,"icon":406},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":428,"path":429,"stem":430},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers",{"title":432,"path":433,"stem":434},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve",{"title":436,"path":437,"stem":438,"children":439,"page":28},"Extend","\u002Fextend","6.extend",[440,444,449,454,458,463,467,471,476,481,486,491],{"title":128,"path":441,"stem":442,"icon":443},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":445,"path":446,"stem":447,"icon":448},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":450,"path":451,"stem":452,"icon":453},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":455,"path":456,"stem":457,"icon":448},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":459,"path":460,"stem":461,"icon":462},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":403,"path":464,"stem":465,"icon":466},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":468,"path":469,"stem":470},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":472,"path":473,"stem":474,"icon":475},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers","i-lucide-sparkles",{"title":477,"path":478,"stem":479,"icon":480},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling","i-lucide-filter",{"title":482,"path":483,"stem":484,"icon":485},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":487,"path":488,"stem":489,"icon":490},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":492,"path":493,"stem":494,"icon":495},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":424,"path":497,"stem":498,"children":499,"page":28},"\u002Freference","7.reference",[500,504,507,512,516,520,524],{"title":501,"path":502,"stem":503},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration",{"title":370,"path":505,"stem":506,"icon":373},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":508,"path":509,"stem":510,"icon":511},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":513,"path":514,"stem":515,"icon":376},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":517,"path":518,"stem":519},"evlog vs pino, winston, consola","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers",{"title":521,"path":522,"stem":523,"icon":475},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"title":525,"path":526,"stem":527},"Log cost","\u002Freference\u002Fcost","7.reference\u002F7.cost",{"id":529,"title":530,"body":531,"description":1249,"extension":1250,"links":1251,"meta":1256,"navigation":1257,"path":362,"seo":1258,"stem":363,"__hash__":1259},"docs\u002F5.use-cases\u002F3.better-auth\u002F03.middleware.md","createAuthMiddleware",{"type":532,"value":533,"toc":1243},"minimark",[534,545,700,714,718,729,832,836,839,924,927,982,1004,1008,1014,1189,1201,1222,1226,1239],[535,536,537,540,541,544],"p",{},[538,539,530],"code",{}," wraps ",[538,542,543],{},"identifyUser"," with the things you need on every request: route filtering, session resolution timing, lifecycle hooks, and silent error handling. Call it once at startup, then use the returned function in your framework's middleware\u002Fhook system.",[546,547,553],"pre",{"className":548,"code":549,"filename":550,"language":551,"meta":552,"style":552},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { createAuthMiddleware } from 'evlog\u002Fbetter-auth'\n\nconst identify = createAuthMiddleware(auth, {\n  exclude: ['\u002Fapi\u002Fauth\u002F**', '\u002Fapi\u002Fpublic\u002F**'],\n  include: ['\u002Fapi\u002F**'],\n  maskEmail: true,\n})\n","server\u002Fmiddleware\u002Fauth-identify.ts","typescript","",[538,554,555,588,595,620,656,677,691],{"__ignoreMap":552},[556,557,560,564,568,572,575,578,581,585],"span",{"class":558,"line":559},"line",1,[556,561,563],{"class":562},"s7zQu","import",[556,565,567],{"class":566},"sMK4o"," {",[556,569,571],{"class":570},"sTEyZ"," createAuthMiddleware",[556,573,574],{"class":566}," }",[556,576,577],{"class":562}," from",[556,579,580],{"class":566}," '",[556,582,584],{"class":583},"sfazB","evlog\u002Fbetter-auth",[556,586,587],{"class":566},"'\n",[556,589,591],{"class":558,"line":590},2,[556,592,594],{"emptyLinePlaceholder":593},true,"\n",[556,596,598,602,605,608,611,614,617],{"class":558,"line":597},3,[556,599,601],{"class":600},"spNyl","const",[556,603,604],{"class":570}," identify ",[556,606,607],{"class":566},"=",[556,609,571],{"class":610},"s2Zo4",[556,612,613],{"class":570},"(auth",[556,615,616],{"class":566},",",[556,618,619],{"class":566}," {\n",[556,621,623,627,630,633,636,639,641,643,645,648,650,653],{"class":558,"line":622},4,[556,624,626],{"class":625},"swJcz","  exclude",[556,628,629],{"class":566},":",[556,631,632],{"class":570}," [",[556,634,635],{"class":566},"'",[556,637,638],{"class":583},"\u002Fapi\u002Fauth\u002F**",[556,640,635],{"class":566},[556,642,616],{"class":566},[556,644,580],{"class":566},[556,646,647],{"class":583},"\u002Fapi\u002Fpublic\u002F**",[556,649,635],{"class":566},[556,651,652],{"class":570},"]",[556,654,655],{"class":566},",\n",[556,657,659,662,664,666,668,671,673,675],{"class":558,"line":658},5,[556,660,661],{"class":625},"  include",[556,663,629],{"class":566},[556,665,632],{"class":570},[556,667,635],{"class":566},[556,669,670],{"class":583},"\u002Fapi\u002F**",[556,672,635],{"class":566},[556,674,652],{"class":570},[556,676,655],{"class":566},[556,678,680,683,685,689],{"class":558,"line":679},6,[556,681,682],{"class":625},"  maskEmail",[556,684,629],{"class":566},[556,686,688],{"class":687},"sfNiH"," true",[556,690,655],{"class":566},[556,692,694,697],{"class":558,"line":693},7,[556,695,696],{"class":566},"}",[556,698,699],{"class":570},")\n",[535,701,702,703,706,707,709,710,713],{},"The function signature is ",[538,704,705],{},"(log, headers, path?) => Promise\u003Cboolean>",". It resolves the session, calls ",[538,708,543],{},", captures timing into ",[538,711,712],{},"auth.resolvedIn",", fires lifecycle hooks, and silently catches errors so session resolution never breaks a request.",[715,716,332],"h2",{"id":717},"options",[535,719,720,721,728],{},"Inherits all ",[722,723,725,727],"a",{"href":724},"\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user#options",[538,726,543],{}," options",", plus:",[730,731,732,751],"table",{},[733,734,735],"thead",{},[736,737,738,742,745,748],"tr",{},[739,740,741],"th",{},"Option",[739,743,744],{},"Type",[739,746,747],{},"Default",[739,749,750],{},"Description",[752,753,754,775,794,813],"tbody",{},[736,755,756,762,767,772],{},[757,758,759],"td",{},[538,760,761],{},"exclude",[757,763,764],{},[538,765,766],{},"string[]",[757,768,769],{},[538,770,771],{},"['\u002Fapi\u002Fauth\u002F**']",[757,773,774],{},"Route patterns to skip (glob).",[736,776,777,782,786,791],{},[757,778,779],{},[538,780,781],{},"include",[757,783,784],{},[538,785,766],{},[757,787,788],{},[538,789,790],{},"undefined",[757,792,793],{},"If set, only matching routes are resolved.",[736,795,796,801,806,810],{},[757,797,798],{},[538,799,800],{},"onIdentify",[757,802,803],{},[538,804,805],{},"(log, session) => void",[757,807,808],{},[538,809,790],{},[757,811,812],{},"Called after successful identification.",[736,814,815,820,825,829],{},[757,816,817],{},[538,818,819],{},"onAnonymous",[757,821,822],{},[538,823,824],{},"(log) => void",[757,826,827],{},[538,828,790],{},[757,830,831],{},"Called when no session is found.",[715,833,835],{"id":834},"route-filtering","Route Filtering",[535,837,838],{},"Skip Better Auth's own routes and any public endpoints to avoid wasted database queries:",[546,840,842],{"className":548,"code":841,"language":551,"meta":552,"style":552},"const identify = createAuthMiddleware(auth, {\n  exclude: [\n    '\u002Fapi\u002Fauth\u002F**',     \u002F\u002F Better Auth itself\n    '\u002Fapi\u002Fpublic\u002F**',   \u002F\u002F Public endpoints\n    '\u002Fapi\u002Fhealth',      \u002F\u002F Health checks\n  ],\n})\n",[538,843,844,860,869,884,897,911,918],{"__ignoreMap":552},[556,845,846,848,850,852,854,856,858],{"class":558,"line":559},[556,847,601],{"class":600},[556,849,604],{"class":570},[556,851,607],{"class":566},[556,853,571],{"class":610},[556,855,613],{"class":570},[556,857,616],{"class":566},[556,859,619],{"class":566},[556,861,862,864,866],{"class":558,"line":590},[556,863,626],{"class":625},[556,865,629],{"class":566},[556,867,868],{"class":570}," [\n",[556,870,871,874,876,878,880],{"class":558,"line":597},[556,872,873],{"class":566},"    '",[556,875,638],{"class":583},[556,877,635],{"class":566},[556,879,616],{"class":566},[556,881,883],{"class":882},"sHwdD","     \u002F\u002F Better Auth itself\n",[556,885,886,888,890,892,894],{"class":558,"line":622},[556,887,873],{"class":566},[556,889,647],{"class":583},[556,891,635],{"class":566},[556,893,616],{"class":566},[556,895,896],{"class":882},"   \u002F\u002F Public endpoints\n",[556,898,899,901,904,906,908],{"class":558,"line":658},[556,900,873],{"class":566},[556,902,903],{"class":583},"\u002Fapi\u002Fhealth",[556,905,635],{"class":566},[556,907,616],{"class":566},[556,909,910],{"class":882},"      \u002F\u002F Health checks\n",[556,912,913,916],{"class":558,"line":679},[556,914,915],{"class":570},"  ]",[556,917,655],{"class":566},[556,919,920,922],{"class":558,"line":693},[556,921,696],{"class":566},[556,923,699],{"class":570},[535,925,926],{},"For high-traffic apps, flip the model and only resolve sessions on routes that need them:",[546,928,930],{"className":548,"code":929,"language":551,"meta":552,"style":552},"const identify = createAuthMiddleware(auth, {\n  include: ['\u002Fapi\u002Fdashboard\u002F**', '\u002Fapi\u002Faccount\u002F**'],\n})\n",[538,931,932,948,976],{"__ignoreMap":552},[556,933,934,936,938,940,942,944,946],{"class":558,"line":559},[556,935,601],{"class":600},[556,937,604],{"class":570},[556,939,607],{"class":566},[556,941,571],{"class":610},[556,943,613],{"class":570},[556,945,616],{"class":566},[556,947,619],{"class":566},[556,949,950,952,954,956,958,961,963,965,967,970,972,974],{"class":558,"line":590},[556,951,661],{"class":625},[556,953,629],{"class":566},[556,955,632],{"class":570},[556,957,635],{"class":566},[556,959,960],{"class":583},"\u002Fapi\u002Fdashboard\u002F**",[556,962,635],{"class":566},[556,964,616],{"class":566},[556,966,580],{"class":566},[556,968,969],{"class":583},"\u002Fapi\u002Faccount\u002F**",[556,971,635],{"class":566},[556,973,652],{"class":570},[556,975,655],{"class":566},[556,977,978,980],{"class":558,"line":597},[556,979,696],{"class":566},[556,981,699],{"class":570},[535,983,984,986,987,989,990,993,994,997,998,1000,1001,1003],{},[538,985,781],{}," and ",[538,988,761],{}," use glob patterns (",[538,991,992],{},"*",", ",[538,995,996],{},"**","). Provide both if you need granular control, and ",[538,999,761],{}," wins over ",[538,1002,781],{},".",[715,1005,1007],{"id":1006},"lifecycle-hooks","Lifecycle Hooks",[535,1009,1010,1011,1013],{},"Use ",[538,1012,800],{}," to react to user identification, for example to force-keep logs for premium users via tail sampling:",[546,1015,1017],{"className":548,"code":1016,"filename":550,"language":551,"meta":552,"style":552},"const identify = createAuthMiddleware(auth, {\n  onIdentify: (log, session) => {\n    if (session.user.plan === 'enterprise') {\n      log.set({ _forceKeep: true })\n    }\n  },\n  onAnonymous: (log) => {\n    log.set({ anonymous: true })\n  },\n})\n",[538,1018,1019,1035,1062,1098,1125,1130,1135,1152,1177,1182],{"__ignoreMap":552},[556,1020,1021,1023,1025,1027,1029,1031,1033],{"class":558,"line":559},[556,1022,601],{"class":600},[556,1024,604],{"class":570},[556,1026,607],{"class":566},[556,1028,571],{"class":610},[556,1030,613],{"class":570},[556,1032,616],{"class":566},[556,1034,619],{"class":566},[556,1036,1037,1040,1042,1045,1049,1051,1054,1057,1060],{"class":558,"line":590},[556,1038,1039],{"class":610},"  onIdentify",[556,1041,629],{"class":566},[556,1043,1044],{"class":566}," (",[556,1046,1048],{"class":1047},"sHdIc","log",[556,1050,616],{"class":566},[556,1052,1053],{"class":1047}," session",[556,1055,1056],{"class":566},")",[556,1058,1059],{"class":600}," =>",[556,1061,619],{"class":566},[556,1063,1064,1067,1069,1072,1074,1077,1079,1082,1085,1087,1090,1092,1095],{"class":558,"line":597},[556,1065,1066],{"class":562},"    if",[556,1068,1044],{"class":625},[556,1070,1071],{"class":570},"session",[556,1073,1003],{"class":566},[556,1075,1076],{"class":570},"user",[556,1078,1003],{"class":566},[556,1080,1081],{"class":570},"plan",[556,1083,1084],{"class":566}," ===",[556,1086,580],{"class":566},[556,1088,1089],{"class":583},"enterprise",[556,1091,635],{"class":566},[556,1093,1094],{"class":625},") ",[556,1096,1097],{"class":566},"{\n",[556,1099,1100,1103,1105,1108,1111,1114,1117,1119,1121,1123],{"class":558,"line":622},[556,1101,1102],{"class":570},"      log",[556,1104,1003],{"class":566},[556,1106,1107],{"class":610},"set",[556,1109,1110],{"class":625},"(",[556,1112,1113],{"class":566},"{",[556,1115,1116],{"class":625}," _forceKeep",[556,1118,629],{"class":566},[556,1120,688],{"class":687},[556,1122,574],{"class":566},[556,1124,699],{"class":625},[556,1126,1127],{"class":558,"line":658},[556,1128,1129],{"class":566},"    }\n",[556,1131,1132],{"class":558,"line":679},[556,1133,1134],{"class":566},"  },\n",[556,1136,1137,1140,1142,1144,1146,1148,1150],{"class":558,"line":693},[556,1138,1139],{"class":610},"  onAnonymous",[556,1141,629],{"class":566},[556,1143,1044],{"class":566},[556,1145,1048],{"class":1047},[556,1147,1056],{"class":566},[556,1149,1059],{"class":600},[556,1151,619],{"class":566},[556,1153,1155,1158,1160,1162,1164,1166,1169,1171,1173,1175],{"class":558,"line":1154},8,[556,1156,1157],{"class":570},"    log",[556,1159,1003],{"class":566},[556,1161,1107],{"class":610},[556,1163,1110],{"class":625},[556,1165,1113],{"class":566},[556,1167,1168],{"class":625}," anonymous",[556,1170,629],{"class":566},[556,1172,688],{"class":687},[556,1174,574],{"class":566},[556,1176,699],{"class":625},[556,1178,1180],{"class":558,"line":1179},9,[556,1181,1134],{"class":566},[556,1183,1185,1187],{"class":558,"line":1184},10,[556,1186,696],{"class":566},[556,1188,699],{"class":570},[535,1190,1191,1192,1194,1195,1197,1198,1200],{},"Hooks fire after the session is resolved and ",[538,1193,543],{}," has set its fields. They run on every request that passes the ",[538,1196,781],{},"\u002F",[538,1199,761],{}," filter, so keep them fast and side-effect-free.",[1202,1203,1204,1209],"tip",{},[535,1205,1206,1207,629],{},"Common patterns for ",[538,1208,800],{},[1210,1211,1212,1216,1219],"ul",{},[1213,1214,1215],"li",{},"Force-keep audit logs for admins or high-value plans.",[1213,1217,1218],{},"Tag the request with feature flags or tenant info loaded from the session.",[1213,1220,1221],{},"Increment a per-user counter for billing.",[715,1223,1225],{"id":1224},"error-handling","Error Handling",[535,1227,1228,1229,1232,1233,986,1235,1238],{},"The middleware catches every error from ",[538,1230,1231],{},"getSession"," and logs nothing, so your request keeps flowing whether the auth backend is up or down. The wide event still includes ",[538,1234,712],{},[538,1236,1237],{},"auth.identified: false"," so you can alert on session resolution health from your dashboards.",[1240,1241,1242],"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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .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}",{"title":552,"searchDepth":590,"depth":590,"links":1244},[1245,1246,1247,1248],{"id":717,"depth":590,"text":332},{"id":834,"depth":590,"text":835},{"id":1006,"depth":590,"text":1007},{"id":1224,"depth":590,"text":1225},"Framework-agnostic factory with route filtering, session timing, and lifecycle hooks. Call it once at startup and reuse across requests.","md",[1252,1255],{"label":356,"icon":359,"to":357,"color":1253,"variant":1254},"neutral","subtle",{"label":370,"icon":373,"to":371,"color":1253,"variant":1254},{},{"title":361,"icon":364},{"title":530,"description":1249},"sYkQx2CC4zmij510bSV3vHnK3AKwmpWUadsXw-oF7yI",[1261,1263],{"title":356,"path":357,"stem":358,"description":1262,"icon":359,"children":-1},"The core building block — extract safe user fields, mask emails, and capture plugin data (organizations, roles, 2FA) from a Better Auth session.",{"title":366,"path":367,"stem":368,"description":1264,"icon":316,"children":-1},"Mirror the server-side user identity into client-side logs by watching the Better Auth session and calling setIdentity.",1786793478265]