[{"data":1,"prerenderedAt":3246},["ShallowReactive",2],{"navigation_docs":3,"-use-cases-telemetry-reference":581,"-use-cases-telemetry-reference-surround":3241},[4,35,85,138,318,458,517,556],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Start","\u002Fstart","1.start",[9,14,19,24,29],{"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",{"title":30,"path":31,"stem":32,"icon":33},"Choose your logger","\u002Fstart\u002Ftypescript-logging-library","1.start\u002F5.typescript-logging-library","i-lucide-file-code",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Learn","\u002Flearn","2.learn",[40,45,50,55,60,65,70,75,80],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flearn\u002Foverview","2.learn\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flearn\u002Fsimple-logging","2.learn\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flearn\u002Fwide-events","2.learn\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flearn\u002Fstructured-errors","2.learn\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Lifecycle","\u002Flearn\u002Flifecycle","2.learn\u002F4.lifecycle","i-lucide-arrow-right-left",{"title":66,"path":67,"stem":68,"icon":69},"Sampling","\u002Flearn\u002Fsampling","2.learn\u002F5.sampling","i-lucide-filter",{"title":71,"path":72,"stem":73,"icon":74},"Auto-Redaction","\u002Flearn\u002Fredaction","2.learn\u002F6.redaction","i-lucide-eye-off",{"title":76,"path":77,"stem":78,"icon":79},"Typed Fields","\u002Flearn\u002Ftyped-fields","2.learn\u002F7.typed-fields","i-simple-icons-typescript",{"title":81,"path":82,"stem":83,"icon":84},"Catalogs","\u002Flearn\u002Fcatalogs","2.learn\u002F8.catalogs","i-lucide-book-open",{"title":86,"path":87,"stem":88,"children":89,"page":34},"CLI","\u002Fcli","3.cli",[90,93,98,103,108,113,118,123,128,133],{"title":41,"path":91,"stem":92,"icon":49},"\u002Fcli\u002Foverview","3.cli\u002F0.overview",{"title":94,"path":95,"stem":96,"icon":97},"init","\u002Fcli\u002Finit","3.cli\u002F1.init","i-lucide-wand-sparkles",{"title":99,"path":100,"stem":101,"icon":102},"map","\u002Fcli\u002Fmap","3.cli\u002F2.map","i-lucide-radar",{"title":104,"path":105,"stem":106,"icon":107},"Rules","\u002Fcli\u002Frules","3.cli\u002F3.rules","i-lucide-list-checks",{"title":109,"path":110,"stem":111,"icon":112},"Scoring","\u002Fcli\u002Fscoring","3.cli\u002F4.scoring","i-lucide-gauge",{"title":114,"path":115,"stem":116,"icon":117},"CI","\u002Fcli\u002Fci","3.cli\u002F5.ci","i-lucide-git-pull-request",{"title":119,"path":120,"stem":121,"icon":122},"doctor","\u002Fcli\u002Fdoctor","3.cli\u002F6.doctor","i-lucide-stethoscope",{"title":124,"path":125,"stem":126,"icon":127},"telemetry","\u002Fcli\u002Ftelemetry","3.cli\u002F7.telemetry","i-lucide-bar-chart-3",{"title":129,"path":130,"stem":131,"icon":132},"agents","\u002Fcli\u002Fagents","3.cli\u002F8.agents","i-lucide-bot",{"title":134,"path":135,"stem":136,"icon":137},"Observability Score","\u002Fcli\u002Fobservability-score","3.cli\u002F9.observability-score","i-lucide-activity",{"title":139,"path":140,"stem":141,"children":142,"page":34},"Integrate","\u002Fintegrate","4.integrate",[143,147,230],{"title":41,"path":144,"stem":145,"icon":146},"\u002Fintegrate\u002Foverview","4.integrate\u002F0.overview","i-lucide-plug",{"title":148,"path":149,"stem":150,"children":151,"page":34},"Adapters","\u002Fintegrate\u002Fadapters","4.integrate\u002Fadapters",[152,155,185,210],{"title":41,"path":153,"stem":154,"icon":44},"\u002Fintegrate\u002Fadapters\u002Foverview","4.integrate\u002Fadapters\u002F01.overview",{"title":156,"path":157,"stem":158,"children":159,"page":34},"Cloud","\u002Fintegrate\u002Fadapters\u002Fcloud","4.integrate\u002Fadapters\u002Fcloud",[160,165,170,175,180],{"title":161,"path":162,"stem":163,"icon":164},"Axiom","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Faxiom","4.integrate\u002Fadapters\u002Fcloud\u002F01.axiom","i-custom-axiom",{"title":166,"path":167,"stem":168,"icon":169},"PostHog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fposthog","4.integrate\u002Fadapters\u002Fcloud\u002F02.posthog","i-simple-icons-posthog",{"title":171,"path":172,"stem":173,"icon":174},"Sentry","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fsentry","4.integrate\u002Fadapters\u002Fcloud\u002F03.sentry","i-simple-icons-sentry",{"title":176,"path":177,"stem":178,"icon":179},"Better Stack","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fbetter-stack","4.integrate\u002Fadapters\u002Fcloud\u002F04.better-stack","i-simple-icons-betterstack",{"title":181,"path":182,"stem":183,"icon":184},"Datadog","\u002Fintegrate\u002Fadapters\u002Fcloud\u002Fdatadog","4.integrate\u002Fadapters\u002Fcloud\u002F05.datadog","i-simple-icons-datadog",{"title":186,"path":187,"stem":188,"children":189,"page":34},"Cloud or Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fhybrid","4.integrate\u002Fadapters\u002Fhybrid",[190,195,200,205],{"title":191,"path":192,"stem":193,"icon":194},"Grafana Loki","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Floki","4.integrate\u002Fadapters\u002Fhybrid\u002F01.loki","i-simple-icons-grafana",{"title":196,"path":197,"stem":198,"icon":199},"ClickHouse","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fclickhouse","4.integrate\u002Fadapters\u002Fhybrid\u002F02.clickhouse","i-simple-icons-clickhouse",{"title":201,"path":202,"stem":203,"icon":204},"OTLP","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fotlp","4.integrate\u002Fadapters\u002Fhybrid\u002F03.otlp","i-simple-icons-opentelemetry",{"title":206,"path":207,"stem":208,"icon":209},"HyperDX","\u002Fintegrate\u002Fadapters\u002Fhybrid\u002Fhyperdx","4.integrate\u002Fadapters\u002Fhybrid\u002F04.hyperdx","i-custom-hyperdx",{"title":211,"path":212,"stem":213,"children":214,"page":34},"Self-Hosted","\u002Fintegrate\u002Fadapters\u002Fself-hosted","4.integrate\u002Fadapters\u002Fself-hosted",[215,220,225],{"title":216,"path":217,"stem":218,"icon":219},"File System","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Ffs","4.integrate\u002Fadapters\u002Fself-hosted\u002F01.fs","i-lucide-hard-drive",{"title":221,"path":222,"stem":223,"icon":224},"NuxtHub","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fnuxthub","4.integrate\u002Fadapters\u002Fself-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":226,"path":227,"stem":228,"icon":229},"Memory","\u002Fintegrate\u002Fadapters\u002Fself-hosted\u002Fmemory","4.integrate\u002Fadapters\u002Fself-hosted\u002F03.memory","i-lucide-cpu",{"title":231,"path":232,"stem":233,"children":234,"page":34},"Frameworks","\u002Fintegrate\u002Fframeworks","4.integrate\u002Fframeworks",[235,239,244,249,254,259,264,269,274,279,284,289,294,299,303,308,313],{"title":41,"path":236,"stem":237,"icon":238},"\u002Fintegrate\u002Fframeworks\u002Foverview","4.integrate\u002Fframeworks\u002F00.overview","i-lucide-layout-grid",{"title":240,"path":241,"stem":242,"icon":243},"Nuxt","\u002Fintegrate\u002Fframeworks\u002Fnuxt","4.integrate\u002Fframeworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":245,"path":246,"stem":247,"icon":248},"Next.js","\u002Fintegrate\u002Fframeworks\u002Fnextjs","4.integrate\u002Fframeworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":250,"path":251,"stem":252,"icon":253},"SvelteKit","\u002Fintegrate\u002Fframeworks\u002Fsveltekit","4.integrate\u002Fframeworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":255,"path":256,"stem":257,"icon":258},"Nitro","\u002Fintegrate\u002Fframeworks\u002Fnitro","4.integrate\u002Fframeworks\u002F04.nitro","i-custom-nitro",{"title":260,"path":261,"stem":262,"icon":263},"TanStack Start","\u002Fintegrate\u002Fframeworks\u002Ftanstack-start","4.integrate\u002Fframeworks\u002F05.tanstack-start","i-custom-tanstack",{"title":265,"path":266,"stem":267,"icon":268},"NestJS","\u002Fintegrate\u002Fframeworks\u002Fnestjs","4.integrate\u002Fframeworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":270,"path":271,"stem":272,"icon":273},"Express","\u002Fintegrate\u002Fframeworks\u002Fexpress","4.integrate\u002Fframeworks\u002F07.express","i-simple-icons-express",{"title":275,"path":276,"stem":277,"icon":278},"Hono","\u002Fintegrate\u002Fframeworks\u002Fhono","4.integrate\u002Fframeworks\u002F08.hono","i-simple-icons-hono",{"title":280,"path":281,"stem":282,"icon":283},"Fastify","\u002Fintegrate\u002Fframeworks\u002Ffastify","4.integrate\u002Fframeworks\u002F09.fastify","i-simple-icons-fastify",{"title":285,"path":286,"stem":287,"icon":288},"Elysia","\u002Fintegrate\u002Fframeworks\u002Felysia","4.integrate\u002Fframeworks\u002F10.elysia","i-custom-elysia",{"title":290,"path":291,"stem":292,"icon":293},"React Router","\u002Fintegrate\u002Fframeworks\u002Freact-router","4.integrate\u002Fframeworks\u002F11.react-router","i-custom-reactrouter",{"title":295,"path":296,"stem":297,"icon":298},"Cloudflare Workers","\u002Fintegrate\u002Fframeworks\u002Fcloudflare-workers","4.integrate\u002Fframeworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":300,"path":301,"stem":302,"icon":79},"Standalone","\u002Fintegrate\u002Fframeworks\u002Fstandalone","4.integrate\u002Fframeworks\u002F13.standalone",{"title":304,"path":305,"stem":306,"icon":307},"Astro","\u002Fintegrate\u002Fframeworks\u002Fastro","4.integrate\u002Fframeworks\u002F14.astro","i-simple-icons-astro",{"title":309,"path":310,"stem":311,"icon":312},"oRPC","\u002Fintegrate\u002Fframeworks\u002Forpc","4.integrate\u002Fframeworks\u002F15.orpc","i-lucide-network",{"title":314,"path":315,"stem":316,"icon":317},"AWS Lambda","\u002Fintegrate\u002Fframeworks\u002Faws-lambda","4.integrate\u002Fframeworks\u002F16.aws-lambda","i-custom-lambda",{"title":319,"path":320,"stem":321,"children":322,"page":34},"Use Cases","\u002Fuse-cases","5.use-cases",[323,326,331,359,386,418,439,444,449,453],{"title":41,"path":324,"stem":325,"icon":107},"\u002Fuse-cases\u002Foverview","5.use-cases\u002F0.overview",{"title":327,"path":328,"stem":329,"icon":330},"Client Logging","\u002Fuse-cases\u002Fclient-logging","5.use-cases\u002F1.client-logging","i-lucide-monitor",{"title":332,"icon":333,"path":334,"stem":335,"children":336,"page":34},"AI SDK","i-simple-icons-vercel","\u002Fuse-cases\u002Fai-sdk","5.use-cases\u002F2.ai-sdk",[337,340,345,350,355],{"title":41,"path":338,"stem":339,"icon":44},"\u002Fuse-cases\u002Fai-sdk\u002Foverview","5.use-cases\u002F2.ai-sdk\u002F01.overview",{"title":341,"path":342,"stem":343,"icon":344},"Usage","\u002Fuse-cases\u002Fai-sdk\u002Fusage","5.use-cases\u002F2.ai-sdk\u002F02.usage","i-lucide-code",{"title":346,"path":347,"stem":348,"icon":349},"Options","\u002Fuse-cases\u002Fai-sdk\u002Foptions","5.use-cases\u002F2.ai-sdk\u002F03.options","i-lucide-sliders",{"title":351,"path":352,"stem":353,"icon":354},"Metadata","\u002Fuse-cases\u002Fai-sdk\u002Fmetadata","5.use-cases\u002F2.ai-sdk\u002F04.metadata","i-lucide-database",{"title":356,"path":357,"stem":358,"icon":137},"Telemetry","\u002Fuse-cases\u002Fai-sdk\u002Ftelemetry","5.use-cases\u002F2.ai-sdk\u002F05.telemetry",{"title":360,"icon":361,"path":362,"stem":363,"children":364,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Fuse-cases\u002Fbetter-auth","5.use-cases\u002F3.better-auth",[365,368,373,378,382],{"title":41,"path":366,"stem":367,"icon":44},"\u002Fuse-cases\u002Fbetter-auth\u002Foverview","5.use-cases\u002F3.better-auth\u002F01.overview",{"title":369,"path":370,"stem":371,"icon":372},"Identify User","\u002Fuse-cases\u002Fbetter-auth\u002Fidentify-user","5.use-cases\u002F3.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":374,"path":375,"stem":376,"icon":377},"Middleware","\u002Fuse-cases\u002Fbetter-auth\u002Fmiddleware","5.use-cases\u002F3.better-auth\u002F03.middleware","i-lucide-shield",{"title":379,"path":380,"stem":381,"icon":330},"Client Sync","\u002Fuse-cases\u002Fbetter-auth\u002Fclient-sync","5.use-cases\u002F3.better-auth\u002F04.client-sync",{"title":383,"path":384,"stem":385,"icon":112},"Performance","\u002Fuse-cases\u002Fbetter-auth\u002Fperformance","5.use-cases\u002F3.better-auth\u002F05.performance",{"title":387,"icon":388,"path":389,"stem":390,"children":391,"page":34},"Audit Logs","i-lucide-shield-check","\u002Fuse-cases\u002Faudit","5.use-cases\u002F4.audit",[392,395,400,405,410,414],{"title":41,"path":393,"stem":394,"icon":44},"\u002Fuse-cases\u002Faudit\u002Foverview","5.use-cases\u002F4.audit\u002F01.overview",{"title":396,"path":397,"stem":398,"icon":399},"Schema","\u002Fuse-cases\u002Faudit\u002Fschema","5.use-cases\u002F4.audit\u002F02.schema","i-lucide-file-text",{"title":401,"path":402,"stem":403,"icon":404},"Recording","\u002Fuse-cases\u002Faudit\u002Frecording","5.use-cases\u002F4.audit\u002F03.recording","i-lucide-pen-line",{"title":406,"path":407,"stem":408,"icon":409},"Drains","\u002Fuse-cases\u002Faudit\u002Fpipeline","5.use-cases\u002F4.audit\u002F04.pipeline","i-lucide-link",{"title":411,"path":412,"stem":413,"icon":388},"Compliance","\u002Fuse-cases\u002Faudit\u002Fcompliance","5.use-cases\u002F4.audit\u002F05.compliance",{"title":415,"path":416,"stem":417,"icon":84},"Recipes","\u002Fuse-cases\u002Faudit\u002Frecipes","5.use-cases\u002F4.audit\u002F06.recipes",{"title":356,"icon":112,"path":419,"stem":420,"children":421,"page":34},"\u002Fuse-cases\u002Ftelemetry","5.use-cases\u002F4.telemetry",[422,425,430,435],{"title":41,"path":423,"stem":424,"icon":44},"\u002Fuse-cases\u002Ftelemetry\u002Foverview","5.use-cases\u002F4.telemetry\u002F01.overview",{"title":426,"path":427,"stem":428,"icon":429},"Setup","\u002Fuse-cases\u002Ftelemetry\u002Fsetup","5.use-cases\u002F4.telemetry\u002F02.setup","i-lucide-wrench",{"title":431,"path":432,"stem":433,"icon":434},"Ingest","\u002Fuse-cases\u002Ftelemetry\u002Fingest","5.use-cases\u002F4.telemetry\u002F03.ingest","i-lucide-server",{"title":436,"path":437,"stem":438,"icon":84},"Reference","\u002Fuse-cases\u002Ftelemetry\u002Freference","5.use-cases\u002F4.telemetry\u002F04.reference",{"title":440,"path":441,"stem":442,"icon":443},"Enrichers","\u002Fuse-cases\u002Fenrichers","5.use-cases\u002F5.enrichers","i-lucide-sparkles",{"title":445,"path":446,"stem":447,"icon":448},"eve","\u002Fuse-cases\u002Feve","5.use-cases\u002F5.eve","i-custom-eve",{"title":450,"path":451,"stem":452,"icon":434},"Node.js request logging","\u002Fuse-cases\u002Fstructured-logging-nodejs","5.use-cases\u002F6.structured-logging-nodejs",{"title":454,"path":455,"stem":456,"icon":457},"Libraries","\u002Fuse-cases\u002Flibraries","5.use-cases\u002F7.libraries","i-lucide-package",{"title":459,"path":460,"stem":461,"children":462,"page":34},"Extend","\u002Fextend","6.extend",[463,467,472,477,481,486,490,494,498,502,507,512],{"title":41,"path":464,"stem":465,"icon":466},"\u002Fextend\u002Foverview","6.extend\u002F0.overview","i-lucide-blocks",{"title":468,"path":469,"stem":470,"icon":471},"Stream","\u002Fextend\u002Fstream","6.extend\u002F1.stream","i-lucide-radio-tower",{"title":473,"path":474,"stem":475,"icon":476},"Custom framework","\u002Fextend\u002Fcustom-framework","6.extend\u002F10.custom-framework","i-lucide-puzzle",{"title":478,"path":479,"stem":480,"icon":471},"Diagnostics channel","\u002Fextend\u002Fdiagnostics-channel","6.extend\u002F11.diagnostics-channel",{"title":482,"path":483,"stem":484,"icon":485},"FS reader","\u002Fextend\u002Ffs-reader","6.extend\u002F2.fs-reader","i-lucide-folder-search",{"title":415,"path":487,"stem":488,"icon":489},"\u002Fextend\u002Fconsumer-recipes","6.extend\u002F3.consumer-recipes","i-lucide-chef-hat",{"title":491,"path":492,"stem":493,"icon":466},"Plugins","\u002Fextend\u002Fplugins","6.extend\u002F4.plugins",{"title":495,"path":496,"stem":497,"icon":443},"Custom enrichers","\u002Fextend\u002Fcustom-enrichers","6.extend\u002F5.custom-enrichers",{"title":499,"path":500,"stem":501,"icon":69},"Tail sampling","\u002Fextend\u002Ftail-sampling","6.extend\u002F6.tail-sampling",{"title":503,"path":504,"stem":505,"icon":506},"Identity headers","\u002Fextend\u002Fidentity-headers","6.extend\u002F7.identity-headers","i-lucide-fingerprint",{"title":508,"path":509,"stem":510,"icon":511},"Custom drains","\u002Fextend\u002Fcustom-drains","6.extend\u002F8.custom-drains","i-lucide-share-2",{"title":513,"path":514,"stem":515,"icon":516},"Drain pipeline","\u002Fextend\u002Fdrain-pipeline","6.extend\u002F9.drain-pipeline","i-lucide-workflow",{"title":436,"path":518,"stem":519,"children":520,"page":34},"\u002Freference","7.reference",[521,525,530,533,538,542,547,551],{"title":41,"path":522,"stem":523,"icon":524},"\u002Freference\u002Foverview","7.reference\u002F0.overview","i-lucide-book-marked",{"title":526,"path":527,"stem":528,"icon":529},"Configuration","\u002Freference\u002Fconfiguration","7.reference\u002F1.configuration","i-lucide-settings",{"title":383,"path":531,"stem":532,"icon":112},"\u002Freference\u002Fperformance","7.reference\u002F2.performance",{"title":534,"path":535,"stem":536,"icon":537},"Vite Plugin","\u002Freference\u002Fvite-plugin","7.reference\u002F3.vite-plugin","i-custom-vite",{"title":539,"path":540,"stem":541,"icon":388},"Best Practices","\u002Freference\u002Fbest-practices","7.reference\u002F4.best-practices",{"title":543,"path":544,"stem":545,"icon":546},"vs Other Loggers","\u002Freference\u002Fvs-other-loggers","7.reference\u002F5.vs-other-loggers","i-lucide-scale",{"title":548,"path":549,"stem":550,"icon":443},"Agent Skills","\u002Freference\u002Fagent-skills","7.reference\u002F6.agent-skills",{"title":552,"path":553,"stem":554,"icon":555},"Cost","\u002Freference\u002Fcost","7.reference\u002F7.cost","i-lucide-receipt",{"title":557,"path":558,"stem":559,"children":560,"page":34},"Compare","\u002Fcompare","8.compare",[561,565,569,573,577],{"title":562,"path":563,"stem":564,"icon":546},"evlog vs Pino","\u002Fcompare\u002Fpino","8.compare\u002F1.pino",{"title":566,"path":567,"stem":568,"icon":204},"evlog vs OpenTelemetry","\u002Fcompare\u002Fopentelemetry","8.compare\u002F2.opentelemetry",{"title":570,"path":571,"stem":572,"icon":546},"evlog vs LogTape","\u002Fcompare\u002Flogtape","8.compare\u002F3.logtape",{"title":574,"path":575,"stem":576,"icon":546},"evlog vs Winston: formats and request events","\u002Fcompare\u002Fwinston","8.compare\u002F4.winston",{"title":578,"path":579,"stem":580,"icon":546},"evlog vs Consola: reporters and request context","\u002Fcompare\u002Fconsola","8.compare\u002F5.consola",{"id":582,"title":583,"body":584,"description":3229,"extension":3230,"links":3231,"meta":3237,"navigation":3238,"path":437,"seo":3239,"stem":438,"__hash__":3240},"docs\u002F5.use-cases\u002F4.telemetry\u002F04.reference.md","Telemetry Reference",{"type":585,"value":586,"toc":3213},"minimark",[587,592,596,971,975,993,996,1053,1056,1089,1094,1105,1408,1411,1568,1577,1597,1601,1604,1874,1882,1886,1893,2178,2187,2193,2202,2281,2291,2295,2301,2439,2443,2538,2553,2557,2560,2569,2741,2750,2763,2769,2773,2784,2823,2916,2922,2965,2979,2990,2994,3006,3144,3154,3158,3177,3187,3196,3209],[588,589,591],"h2",{"id":590},"standard-envelope","Standard envelope",[593,594,595],"p",{},"Every run shares the same shape. You do not declare per-command schemas.",[597,598,603],"pre",{"className":599,"code":600,"language":601,"meta":602,"style":602},"language-jsonc shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"event\": \"run\",\n  \"command\": \"sync\",\n  \"durationMs\": 412,\n  \"outcome\": \"success\",\n  \"flags\": { \"dryRun\": true, \"output\": \"\u003Cset>\" },\n  \"tool\": { \"name\": \"my-tool\", \"version\": \"1.0.0\" },\n  \"env\": {\n    \"node\": \"20.11\",\n    \"ci\": false,\n    \"provider\": null,\n    \"tty\": true,\n    \"agent\": \"cursor\"   \u002F\u002F std-env: cursor, claude, codex, … or null\n  },\n  \"machineId\": \"ab3f…\", \u002F\u002F hashed; omitted in ephemeral CI\n  \"custom\": { \"itemsSynced\": 42 }\n}\n","jsonc","",[604,605,606,615,643,664,682,703,750,801,816,838,853,868,883,906,912,936,965],"code",{"__ignoreMap":602},[607,608,611],"span",{"class":609,"line":610},"line",1,[607,612,614],{"class":613},"sMK4o","{\n",[607,616,618,621,625,628,631,634,638,640],{"class":609,"line":617},2,[607,619,620],{"class":613},"  \"",[607,622,624],{"class":623},"spNyl","event",[607,626,627],{"class":613},"\"",[607,629,630],{"class":613},":",[607,632,633],{"class":613}," \"",[607,635,637],{"class":636},"sfazB","run",[607,639,627],{"class":613},[607,641,642],{"class":613},",\n",[607,644,646,648,651,653,655,657,660,662],{"class":609,"line":645},3,[607,647,620],{"class":613},[607,649,650],{"class":623},"command",[607,652,627],{"class":613},[607,654,630],{"class":613},[607,656,633],{"class":613},[607,658,659],{"class":636},"sync",[607,661,627],{"class":613},[607,663,642],{"class":613},[607,665,667,669,672,674,676,680],{"class":609,"line":666},4,[607,668,620],{"class":613},[607,670,671],{"class":623},"durationMs",[607,673,627],{"class":613},[607,675,630],{"class":613},[607,677,679],{"class":678},"sbssI"," 412",[607,681,642],{"class":613},[607,683,685,687,690,692,694,696,699,701],{"class":609,"line":684},5,[607,686,620],{"class":613},[607,688,689],{"class":623},"outcome",[607,691,627],{"class":613},[607,693,630],{"class":613},[607,695,633],{"class":613},[607,697,698],{"class":636},"success",[607,700,627],{"class":613},[607,702,642],{"class":613},[607,704,706,708,711,713,715,718,720,724,726,728,731,733,736,738,740,742,745,747],{"class":609,"line":705},6,[607,707,620],{"class":613},[607,709,710],{"class":623},"flags",[607,712,627],{"class":613},[607,714,630],{"class":613},[607,716,717],{"class":613}," {",[607,719,633],{"class":613},[607,721,723],{"class":722},"sBMFI","dryRun",[607,725,627],{"class":613},[607,727,630],{"class":613},[607,729,730],{"class":613}," true,",[607,732,633],{"class":613},[607,734,735],{"class":722},"output",[607,737,627],{"class":613},[607,739,630],{"class":613},[607,741,633],{"class":613},[607,743,744],{"class":636},"\u003Cset>",[607,746,627],{"class":613},[607,748,749],{"class":613}," },\n",[607,751,753,755,758,760,762,764,766,769,771,773,775,778,780,783,785,788,790,792,794,797,799],{"class":609,"line":752},7,[607,754,620],{"class":613},[607,756,757],{"class":623},"tool",[607,759,627],{"class":613},[607,761,630],{"class":613},[607,763,717],{"class":613},[607,765,633],{"class":613},[607,767,768],{"class":722},"name",[607,770,627],{"class":613},[607,772,630],{"class":613},[607,774,633],{"class":613},[607,776,777],{"class":636},"my-tool",[607,779,627],{"class":613},[607,781,782],{"class":613},",",[607,784,633],{"class":613},[607,786,787],{"class":722},"version",[607,789,627],{"class":613},[607,791,630],{"class":613},[607,793,633],{"class":613},[607,795,796],{"class":636},"1.0.0",[607,798,627],{"class":613},[607,800,749],{"class":613},[607,802,804,806,809,811,813],{"class":609,"line":803},8,[607,805,620],{"class":613},[607,807,808],{"class":623},"env",[607,810,627],{"class":613},[607,812,630],{"class":613},[607,814,815],{"class":613}," {\n",[607,817,819,822,825,827,829,831,834,836],{"class":609,"line":818},9,[607,820,821],{"class":613},"    \"",[607,823,824],{"class":722},"node",[607,826,627],{"class":613},[607,828,630],{"class":613},[607,830,633],{"class":613},[607,832,833],{"class":636},"20.11",[607,835,627],{"class":613},[607,837,642],{"class":613},[607,839,841,843,846,848,850],{"class":609,"line":840},10,[607,842,821],{"class":613},[607,844,845],{"class":722},"ci",[607,847,627],{"class":613},[607,849,630],{"class":613},[607,851,852],{"class":613}," false,\n",[607,854,856,858,861,863,865],{"class":609,"line":855},11,[607,857,821],{"class":613},[607,859,860],{"class":722},"provider",[607,862,627],{"class":613},[607,864,630],{"class":613},[607,866,867],{"class":613}," null,\n",[607,869,871,873,876,878,880],{"class":609,"line":870},12,[607,872,821],{"class":613},[607,874,875],{"class":722},"tty",[607,877,627],{"class":613},[607,879,630],{"class":613},[607,881,882],{"class":613}," true,\n",[607,884,886,888,891,893,895,897,900,902],{"class":609,"line":885},13,[607,887,821],{"class":613},[607,889,890],{"class":722},"agent",[607,892,627],{"class":613},[607,894,630],{"class":613},[607,896,633],{"class":613},[607,898,899],{"class":636},"cursor",[607,901,627],{"class":613},[607,903,905],{"class":904},"sHwdD","   \u002F\u002F std-env: cursor, claude, codex, … or null\n",[607,907,909],{"class":609,"line":908},14,[607,910,911],{"class":613},"  },\n",[607,913,915,917,920,922,924,926,929,931,933],{"class":609,"line":914},15,[607,916,620],{"class":613},[607,918,919],{"class":623},"machineId",[607,921,627],{"class":613},[607,923,630],{"class":613},[607,925,633],{"class":613},[607,927,928],{"class":636},"ab3f…",[607,930,627],{"class":613},[607,932,782],{"class":613},[607,934,935],{"class":904}," \u002F\u002F hashed; omitted in ephemeral CI\n",[607,937,939,941,944,946,948,950,952,955,957,959,962],{"class":609,"line":938},16,[607,940,620],{"class":613},[607,942,943],{"class":623},"custom",[607,945,627],{"class":613},[607,947,630],{"class":613},[607,949,717],{"class":613},[607,951,633],{"class":613},[607,953,954],{"class":722},"itemsSynced",[607,956,627],{"class":613},[607,958,630],{"class":613},[607,960,961],{"class":678}," 42",[607,963,964],{"class":613}," }\n",[607,966,968],{"class":609,"line":967},17,[607,969,970],{"class":613},"}\n",[588,972,974],{"id":973},"extending-the-schema","Extending the schema",[593,976,977,978,982,983,986,987,989,990,992],{},"The envelope above is ",[979,980,981],"strong",{},"fixed",": every tool sends the same top-level shape so ",[604,984,985],{},"parseIngestBody()"," and disclosure stay predictable. You do not add fields next to ",[604,988,650],{}," or ",[604,991,671],{},".",[593,994,995],{},"Your product schema lives in two extension zones:",[997,998,999,1015],"table",{},[1000,1001,1002],"thead",{},[1003,1004,1005,1009,1012],"tr",{},[1006,1007,1008],"th",{},"Zone",[1006,1010,1011],{},"Who sets it",[1006,1013,1014],{},"What goes there",[1016,1017,1018,1034],"tbody",{},[1003,1019,1020,1025,1031],{},[1021,1022,1023],"td",{},[604,1024,710],{},[1021,1026,1027,1028],{},"citty (auto) + ",[604,1029,1030],{},"collect.flags",[1021,1032,1033],{},"Flags you passed — booleans\u002Fnumbers as values, strings only when allowlisted",[1003,1035,1036,1040,1050],{},[1021,1037,1038],{},[604,1039,943],{},[1021,1041,1042,1043,1046,1047],{},"you via ",[604,1044,1045],{},"telemetry.set()"," + ",[604,1048,1049],{},"collect.fields",[1021,1051,1052],{},"Business counters, categorical dimensions, schema version",[593,1054,1055],{},"Think of it as two contracts:",[1057,1058,1059,1074],"ul",{},[1060,1061,1062,1065,1066,1069,1070,1073],"li",{},[979,1063,1064],{},"Transport contract"," (",[604,1067,1068],{},"RunEvent","): owned by ",[604,1071,1072],{},"@evlog\u002Ftelemetry",", stable across tools",[1060,1075,1076,1065,1079,1081,1082,1084,1085,1088],{},[979,1077,1078],{},"Product contract",[604,1080,943],{}," + declared ",[604,1083,710],{},"): owned by you, declared in ",[604,1086,1087],{},"collect",", mirrored on the server",[1090,1091,1093],"h3",{"id":1092},"declare-your-extensions-once","Declare your extensions once",[593,1095,1096,1097,1100,1101,1104],{},"Everything you collect beyond the standard envelope is declared inline in the same ",[604,1098,1099],{},"withTelemetry()"," \u002F ",[604,1102,1103],{},"createTelemetry()"," call:",[597,1106,1111],{"className":1107,"code":1108,"filename":1109,"language":1110,"meta":602,"style":602},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","withTelemetry(command, {\n  name: 'acme-cli',\n  version: '2.1.0',\n  endpoint: 'https:\u002F\u002Ftelemetry.acme.dev\u002Fapi\u002Fingest',\n  collect: {\n    flags: {\n      format: ['json', 'yaml', 'table'],\n      target: ['staging', 'production'],\n    },\n    fields: {\n      product: ['cli', 'action', 'migrator'],\n      plan: ['free', 'pro', 'enterprise'],\n      framework: ['nuxt', 'next', 'remix'],\n    },\n  },\n})\n","src\u002Findex.ts","ts",[604,1112,1113,1127,1146,1162,1178,1187,1196,1235,1264,1269,1278,1316,1354,1392,1396,1400],{"__ignoreMap":602},[607,1114,1115,1119,1123,1125],{"class":609,"line":610},[607,1116,1118],{"class":1117},"s2Zo4","withTelemetry",[607,1120,1122],{"class":1121},"sTEyZ","(command",[607,1124,782],{"class":613},[607,1126,815],{"class":613},[607,1128,1129,1133,1135,1138,1141,1144],{"class":609,"line":617},[607,1130,1132],{"class":1131},"swJcz","  name",[607,1134,630],{"class":613},[607,1136,1137],{"class":613}," '",[607,1139,1140],{"class":636},"acme-cli",[607,1142,1143],{"class":613},"'",[607,1145,642],{"class":613},[607,1147,1148,1151,1153,1155,1158,1160],{"class":609,"line":645},[607,1149,1150],{"class":1131},"  version",[607,1152,630],{"class":613},[607,1154,1137],{"class":613},[607,1156,1157],{"class":636},"2.1.0",[607,1159,1143],{"class":613},[607,1161,642],{"class":613},[607,1163,1164,1167,1169,1171,1174,1176],{"class":609,"line":666},[607,1165,1166],{"class":1131},"  endpoint",[607,1168,630],{"class":613},[607,1170,1137],{"class":613},[607,1172,1173],{"class":636},"https:\u002F\u002Ftelemetry.acme.dev\u002Fapi\u002Fingest",[607,1175,1143],{"class":613},[607,1177,642],{"class":613},[607,1179,1180,1183,1185],{"class":609,"line":684},[607,1181,1182],{"class":1131},"  collect",[607,1184,630],{"class":613},[607,1186,815],{"class":613},[607,1188,1189,1192,1194],{"class":609,"line":705},[607,1190,1191],{"class":1131},"    flags",[607,1193,630],{"class":613},[607,1195,815],{"class":613},[607,1197,1198,1201,1203,1206,1208,1211,1213,1215,1217,1220,1222,1224,1226,1228,1230,1233],{"class":609,"line":752},[607,1199,1200],{"class":1131},"      format",[607,1202,630],{"class":613},[607,1204,1205],{"class":1121}," [",[607,1207,1143],{"class":613},[607,1209,1210],{"class":636},"json",[607,1212,1143],{"class":613},[607,1214,782],{"class":613},[607,1216,1137],{"class":613},[607,1218,1219],{"class":636},"yaml",[607,1221,1143],{"class":613},[607,1223,782],{"class":613},[607,1225,1137],{"class":613},[607,1227,997],{"class":636},[607,1229,1143],{"class":613},[607,1231,1232],{"class":1121},"]",[607,1234,642],{"class":613},[607,1236,1237,1240,1242,1244,1246,1249,1251,1253,1255,1258,1260,1262],{"class":609,"line":803},[607,1238,1239],{"class":1131},"      target",[607,1241,630],{"class":613},[607,1243,1205],{"class":1121},[607,1245,1143],{"class":613},[607,1247,1248],{"class":636},"staging",[607,1250,1143],{"class":613},[607,1252,782],{"class":613},[607,1254,1137],{"class":613},[607,1256,1257],{"class":636},"production",[607,1259,1143],{"class":613},[607,1261,1232],{"class":1121},[607,1263,642],{"class":613},[607,1265,1266],{"class":609,"line":818},[607,1267,1268],{"class":613},"    },\n",[607,1270,1271,1274,1276],{"class":609,"line":840},[607,1272,1273],{"class":1131},"    fields",[607,1275,630],{"class":613},[607,1277,815],{"class":613},[607,1279,1280,1283,1285,1287,1289,1292,1294,1296,1298,1301,1303,1305,1307,1310,1312,1314],{"class":609,"line":855},[607,1281,1282],{"class":1131},"      product",[607,1284,630],{"class":613},[607,1286,1205],{"class":1121},[607,1288,1143],{"class":613},[607,1290,1291],{"class":636},"cli",[607,1293,1143],{"class":613},[607,1295,782],{"class":613},[607,1297,1137],{"class":613},[607,1299,1300],{"class":636},"action",[607,1302,1143],{"class":613},[607,1304,782],{"class":613},[607,1306,1137],{"class":613},[607,1308,1309],{"class":636},"migrator",[607,1311,1143],{"class":613},[607,1313,1232],{"class":1121},[607,1315,642],{"class":613},[607,1317,1318,1321,1323,1325,1327,1330,1332,1334,1336,1339,1341,1343,1345,1348,1350,1352],{"class":609,"line":870},[607,1319,1320],{"class":1131},"      plan",[607,1322,630],{"class":613},[607,1324,1205],{"class":1121},[607,1326,1143],{"class":613},[607,1328,1329],{"class":636},"free",[607,1331,1143],{"class":613},[607,1333,782],{"class":613},[607,1335,1137],{"class":613},[607,1337,1338],{"class":636},"pro",[607,1340,1143],{"class":613},[607,1342,782],{"class":613},[607,1344,1137],{"class":613},[607,1346,1347],{"class":636},"enterprise",[607,1349,1143],{"class":613},[607,1351,1232],{"class":1121},[607,1353,642],{"class":613},[607,1355,1356,1359,1361,1363,1365,1368,1370,1372,1374,1377,1379,1381,1383,1386,1388,1390],{"class":609,"line":885},[607,1357,1358],{"class":1131},"      framework",[607,1360,630],{"class":613},[607,1362,1205],{"class":1121},[607,1364,1143],{"class":613},[607,1366,1367],{"class":636},"nuxt",[607,1369,1143],{"class":613},[607,1371,782],{"class":613},[607,1373,1137],{"class":613},[607,1375,1376],{"class":636},"next",[607,1378,1143],{"class":613},[607,1380,782],{"class":613},[607,1382,1137],{"class":613},[607,1384,1385],{"class":636},"remix",[607,1387,1143],{"class":613},[607,1389,1232],{"class":1121},[607,1391,642],{"class":613},[607,1393,1394],{"class":609,"line":908},[607,1395,1268],{"class":613},[607,1397,1398],{"class":609,"line":914},[607,1399,911],{"class":613},[607,1401,1402,1405],{"class":609,"line":938},[607,1403,1404],{"class":613},"}",[607,1406,1407],{"class":1121},")\n",[593,1409,1410],{},"Inside handlers, add counters and dimensions:",[597,1412,1415],{"className":1107,"code":1413,"filename":1414,"language":1110,"meta":602,"style":602},"await t.run('deploy', async () => {\n  const result = await deployServices()\n  telemetry.set({\n    servicesDeployed: result.count,   \u002F\u002F number — always allowed\n    rollbackUsed: false,              \u002F\u002F boolean — always allowed\n    framework: 'nuxt',                \u002F\u002F string — allowed (in collect.fields)\n    schemaVersion: 2,                 \u002F\u002F number — version your custom shape\n  })\n})\n","src\u002Fcommands\u002Fdeploy.ts",[604,1416,1417,1453,1473,1487,1506,1522,1540,1555,1562],{"__ignoreMap":602},[607,1418,1419,1423,1426,1428,1430,1433,1435,1438,1440,1442,1445,1448,1451],{"class":609,"line":610},[607,1420,1422],{"class":1421},"s7zQu","await",[607,1424,1425],{"class":1121}," t",[607,1427,992],{"class":613},[607,1429,637],{"class":1117},[607,1431,1432],{"class":1121},"(",[607,1434,1143],{"class":613},[607,1436,1437],{"class":636},"deploy",[607,1439,1143],{"class":613},[607,1441,782],{"class":613},[607,1443,1444],{"class":623}," async",[607,1446,1447],{"class":613}," ()",[607,1449,1450],{"class":623}," =>",[607,1452,815],{"class":613},[607,1454,1455,1458,1461,1464,1467,1470],{"class":609,"line":617},[607,1456,1457],{"class":623},"  const",[607,1459,1460],{"class":1121}," result",[607,1462,1463],{"class":613}," =",[607,1465,1466],{"class":1421}," await",[607,1468,1469],{"class":1117}," deployServices",[607,1471,1472],{"class":1131},"()\n",[607,1474,1475,1478,1480,1483,1485],{"class":609,"line":645},[607,1476,1477],{"class":1121},"  telemetry",[607,1479,992],{"class":613},[607,1481,1482],{"class":1117},"set",[607,1484,1432],{"class":1131},[607,1486,614],{"class":613},[607,1488,1489,1492,1494,1496,1498,1501,1503],{"class":609,"line":666},[607,1490,1491],{"class":1131},"    servicesDeployed",[607,1493,630],{"class":613},[607,1495,1460],{"class":1121},[607,1497,992],{"class":613},[607,1499,1500],{"class":1121},"count",[607,1502,782],{"class":613},[607,1504,1505],{"class":904},"   \u002F\u002F number — always allowed\n",[607,1507,1508,1511,1513,1517,1519],{"class":609,"line":684},[607,1509,1510],{"class":1131},"    rollbackUsed",[607,1512,630],{"class":613},[607,1514,1516],{"class":1515},"sfNiH"," false",[607,1518,782],{"class":613},[607,1520,1521],{"class":904},"              \u002F\u002F boolean — always allowed\n",[607,1523,1524,1527,1529,1531,1533,1535,1537],{"class":609,"line":705},[607,1525,1526],{"class":1131},"    framework",[607,1528,630],{"class":613},[607,1530,1137],{"class":613},[607,1532,1367],{"class":636},[607,1534,1143],{"class":613},[607,1536,782],{"class":613},[607,1538,1539],{"class":904},"                \u002F\u002F string — allowed (in collect.fields)\n",[607,1541,1542,1545,1547,1550,1552],{"class":609,"line":752},[607,1543,1544],{"class":1131},"    schemaVersion",[607,1546,630],{"class":613},[607,1548,1549],{"class":678}," 2",[607,1551,782],{"class":613},[607,1553,1554],{"class":904},"                 \u002F\u002F number — version your custom shape\n",[607,1556,1557,1560],{"class":609,"line":803},[607,1558,1559],{"class":613},"  }",[607,1561,1407],{"class":1131},[607,1563,1564,1566],{"class":609,"line":818},[607,1565,1404],{"class":613},[607,1567,1407],{"class":1121},[593,1569,1570,1571,1574,1575,992],{},"Undeclared strings are ",[979,1572,1573],{},"dropped at runtime",", never thrown. That is the privacy guarantee: no accidental paths, tokens, or free-form PII in ",[604,1576,943],{},[1578,1579,1580,1583,1584,1587,1588,1590,1591,1593,1594,1596],"note",{},[979,1581,1582],{},"Typing:"," ",[604,1585,1586],{},"TelemetryHandle.set()"," autocomplete covers declared ",[604,1589,1049],{}," keys. Use the ambient ",[604,1592,1045],{}," for extra numeric\u002Fboolean counters in the same run, and both merge into ",[604,1595,943],{}," before the event is recorded.",[1090,1598,1600],{"id":1599},"mirror-on-the-server","Mirror on the server",[593,1602,1603],{},"Your ingest handler is the second gate. Pass the same tool name and custom keys you declared on the CLI:",[597,1605,1608],{"className":1107,"code":1606,"filename":1607,"language":1110,"meta":602,"style":602},"import { parseIngestBody } from '@evlog\u002Ftelemetry\u002Fingest'\n\nconst ALLOWED_CUSTOM = [\n  'servicesDeployed', 'rollbackUsed', 'framework',\n  'product', 'plan', 'schemaVersion',\n  'ghaAction', 'ghaEvent',\n] as const\n\nexport async function POST(req: Request) {\n  const raw = await req.text()\n  const events = parseIngestBody(raw, {\n    allowedTools: ['acme-cli'],\n    allowedCustomKeys: { 'acme-cli': ALLOWED_CUSTOM },\n  })\n  \u002F\u002F dedupe on idempotencyKey, then persist\n}\n","app\u002Fapi\u002Ftelemetry\u002Fingest\u002Froute.ts",[604,1609,1610,1634,1640,1654,1684,1713,1733,1744,1748,1777,1798,1818,1837,1859,1865,1870],{"__ignoreMap":602},[607,1611,1612,1615,1617,1620,1623,1626,1628,1631],{"class":609,"line":610},[607,1613,1614],{"class":1421},"import",[607,1616,717],{"class":613},[607,1618,1619],{"class":1121}," parseIngestBody",[607,1621,1622],{"class":613}," }",[607,1624,1625],{"class":1421}," from",[607,1627,1137],{"class":613},[607,1629,1630],{"class":636},"@evlog\u002Ftelemetry\u002Fingest",[607,1632,1633],{"class":613},"'\n",[607,1635,1636],{"class":609,"line":617},[607,1637,1639],{"emptyLinePlaceholder":1638},true,"\n",[607,1641,1642,1645,1648,1651],{"class":609,"line":645},[607,1643,1644],{"class":623},"const",[607,1646,1647],{"class":1121}," ALLOWED_CUSTOM ",[607,1649,1650],{"class":613},"=",[607,1652,1653],{"class":1121}," [\n",[607,1655,1656,1659,1662,1664,1666,1668,1671,1673,1675,1677,1680,1682],{"class":609,"line":666},[607,1657,1658],{"class":613},"  '",[607,1660,1661],{"class":636},"servicesDeployed",[607,1663,1143],{"class":613},[607,1665,782],{"class":613},[607,1667,1137],{"class":613},[607,1669,1670],{"class":636},"rollbackUsed",[607,1672,1143],{"class":613},[607,1674,782],{"class":613},[607,1676,1137],{"class":613},[607,1678,1679],{"class":636},"framework",[607,1681,1143],{"class":613},[607,1683,642],{"class":613},[607,1685,1686,1688,1691,1693,1695,1697,1700,1702,1704,1706,1709,1711],{"class":609,"line":684},[607,1687,1658],{"class":613},[607,1689,1690],{"class":636},"product",[607,1692,1143],{"class":613},[607,1694,782],{"class":613},[607,1696,1137],{"class":613},[607,1698,1699],{"class":636},"plan",[607,1701,1143],{"class":613},[607,1703,782],{"class":613},[607,1705,1137],{"class":613},[607,1707,1708],{"class":636},"schemaVersion",[607,1710,1143],{"class":613},[607,1712,642],{"class":613},[607,1714,1715,1717,1720,1722,1724,1726,1729,1731],{"class":609,"line":705},[607,1716,1658],{"class":613},[607,1718,1719],{"class":636},"ghaAction",[607,1721,1143],{"class":613},[607,1723,782],{"class":613},[607,1725,1137],{"class":613},[607,1727,1728],{"class":636},"ghaEvent",[607,1730,1143],{"class":613},[607,1732,642],{"class":613},[607,1734,1735,1738,1741],{"class":609,"line":752},[607,1736,1737],{"class":1121},"] ",[607,1739,1740],{"class":1421},"as",[607,1742,1743],{"class":623}," const\n",[607,1745,1746],{"class":609,"line":803},[607,1747,1639],{"emptyLinePlaceholder":1638},[607,1749,1750,1753,1755,1758,1761,1763,1767,1769,1772,1775],{"class":609,"line":818},[607,1751,1752],{"class":1421},"export",[607,1754,1444],{"class":623},[607,1756,1757],{"class":623}," function",[607,1759,1760],{"class":1117}," POST",[607,1762,1432],{"class":613},[607,1764,1766],{"class":1765},"sHdIc","req",[607,1768,630],{"class":613},[607,1770,1771],{"class":722}," Request",[607,1773,1774],{"class":613},")",[607,1776,815],{"class":613},[607,1778,1779,1781,1784,1786,1788,1791,1793,1796],{"class":609,"line":840},[607,1780,1457],{"class":623},[607,1782,1783],{"class":1121}," raw",[607,1785,1463],{"class":613},[607,1787,1466],{"class":1421},[607,1789,1790],{"class":1121}," req",[607,1792,992],{"class":613},[607,1794,1795],{"class":1117},"text",[607,1797,1472],{"class":1131},[607,1799,1800,1802,1805,1807,1809,1811,1814,1816],{"class":609,"line":855},[607,1801,1457],{"class":623},[607,1803,1804],{"class":1121}," events",[607,1806,1463],{"class":613},[607,1808,1619],{"class":1117},[607,1810,1432],{"class":1131},[607,1812,1813],{"class":1121},"raw",[607,1815,782],{"class":613},[607,1817,815],{"class":613},[607,1819,1820,1823,1825,1827,1829,1831,1833,1835],{"class":609,"line":870},[607,1821,1822],{"class":1131},"    allowedTools",[607,1824,630],{"class":613},[607,1826,1205],{"class":1131},[607,1828,1143],{"class":613},[607,1830,1140],{"class":636},[607,1832,1143],{"class":613},[607,1834,1232],{"class":1131},[607,1836,642],{"class":613},[607,1838,1839,1842,1844,1846,1848,1850,1852,1854,1857],{"class":609,"line":885},[607,1840,1841],{"class":1131},"    allowedCustomKeys",[607,1843,630],{"class":613},[607,1845,717],{"class":613},[607,1847,1137],{"class":613},[607,1849,1140],{"class":1131},[607,1851,1143],{"class":613},[607,1853,630],{"class":613},[607,1855,1856],{"class":1121}," ALLOWED_CUSTOM",[607,1858,749],{"class":613},[607,1860,1861,1863],{"class":609,"line":908},[607,1862,1559],{"class":613},[607,1864,1407],{"class":1131},[607,1866,1867],{"class":609,"line":914},[607,1868,1869],{"class":904},"  \u002F\u002F dedupe on idempotencyKey, then persist\n",[607,1871,1872],{"class":609,"line":938},[607,1873,970],{"class":613},[593,1875,1876,1878,1879,1881],{},[604,1877,985],{}," strips any ",[604,1880,943],{}," key you did not list, even if a client somehow sent it.",[1090,1883,1885],{"id":1884},"map-to-your-warehouse-schema","Map to your warehouse schema",[593,1887,1888,1889,1892],{},"After validation, shape the event for ",[979,1890,1891],{},"your"," database. The evlog envelope is the wire format; your tables are your choice:",[597,1894,1897],{"className":1107,"code":1895,"filename":1896,"language":1110,"meta":602,"style":602},"function toRow(event: RunEvent) {\n  return {\n    command: event.command,\n    duration_ms: event.durationMs,\n    outcome: event.outcome,\n    tool_version: event.tool.version,\n    format: event.flags.format,\n    target: event.flags.target,\n    services_deployed: event.custom.servicesDeployed,\n    framework: event.custom.framework,\n    plan: event.custom.plan,\n    schema_version: event.custom.schemaVersion ?? 1,\n    is_ci: event.env.ci,\n    node: event.env.node,\n    received_at: new Date(),\n  }\n}\n","lib\u002Ftelemetry-store.ts",[604,1898,1899,1920,1927,1943,1958,1973,1992,2012,2032,2051,2069,2088,2113,2132,2151,2169,2174],{"__ignoreMap":602},[607,1900,1901,1904,1907,1909,1911,1913,1916,1918],{"class":609,"line":610},[607,1902,1903],{"class":623},"function",[607,1905,1906],{"class":1117}," toRow",[607,1908,1432],{"class":613},[607,1910,624],{"class":1765},[607,1912,630],{"class":613},[607,1914,1915],{"class":722}," RunEvent",[607,1917,1774],{"class":613},[607,1919,815],{"class":613},[607,1921,1922,1925],{"class":609,"line":617},[607,1923,1924],{"class":1421},"  return",[607,1926,815],{"class":613},[607,1928,1929,1932,1934,1937,1939,1941],{"class":609,"line":645},[607,1930,1931],{"class":1131},"    command",[607,1933,630],{"class":613},[607,1935,1936],{"class":1121}," event",[607,1938,992],{"class":613},[607,1940,650],{"class":1121},[607,1942,642],{"class":613},[607,1944,1945,1948,1950,1952,1954,1956],{"class":609,"line":666},[607,1946,1947],{"class":1131},"    duration_ms",[607,1949,630],{"class":613},[607,1951,1936],{"class":1121},[607,1953,992],{"class":613},[607,1955,671],{"class":1121},[607,1957,642],{"class":613},[607,1959,1960,1963,1965,1967,1969,1971],{"class":609,"line":684},[607,1961,1962],{"class":1131},"    outcome",[607,1964,630],{"class":613},[607,1966,1936],{"class":1121},[607,1968,992],{"class":613},[607,1970,689],{"class":1121},[607,1972,642],{"class":613},[607,1974,1975,1978,1980,1982,1984,1986,1988,1990],{"class":609,"line":705},[607,1976,1977],{"class":1131},"    tool_version",[607,1979,630],{"class":613},[607,1981,1936],{"class":1121},[607,1983,992],{"class":613},[607,1985,757],{"class":1121},[607,1987,992],{"class":613},[607,1989,787],{"class":1121},[607,1991,642],{"class":613},[607,1993,1994,1997,1999,2001,2003,2005,2007,2010],{"class":609,"line":752},[607,1995,1996],{"class":1131},"    format",[607,1998,630],{"class":613},[607,2000,1936],{"class":1121},[607,2002,992],{"class":613},[607,2004,710],{"class":1121},[607,2006,992],{"class":613},[607,2008,2009],{"class":1121},"format",[607,2011,642],{"class":613},[607,2013,2014,2017,2019,2021,2023,2025,2027,2030],{"class":609,"line":803},[607,2015,2016],{"class":1131},"    target",[607,2018,630],{"class":613},[607,2020,1936],{"class":1121},[607,2022,992],{"class":613},[607,2024,710],{"class":1121},[607,2026,992],{"class":613},[607,2028,2029],{"class":1121},"target",[607,2031,642],{"class":613},[607,2033,2034,2037,2039,2041,2043,2045,2047,2049],{"class":609,"line":818},[607,2035,2036],{"class":1131},"    services_deployed",[607,2038,630],{"class":613},[607,2040,1936],{"class":1121},[607,2042,992],{"class":613},[607,2044,943],{"class":1121},[607,2046,992],{"class":613},[607,2048,1661],{"class":1121},[607,2050,642],{"class":613},[607,2052,2053,2055,2057,2059,2061,2063,2065,2067],{"class":609,"line":840},[607,2054,1526],{"class":1131},[607,2056,630],{"class":613},[607,2058,1936],{"class":1121},[607,2060,992],{"class":613},[607,2062,943],{"class":1121},[607,2064,992],{"class":613},[607,2066,1679],{"class":1121},[607,2068,642],{"class":613},[607,2070,2071,2074,2076,2078,2080,2082,2084,2086],{"class":609,"line":855},[607,2072,2073],{"class":1131},"    plan",[607,2075,630],{"class":613},[607,2077,1936],{"class":1121},[607,2079,992],{"class":613},[607,2081,943],{"class":1121},[607,2083,992],{"class":613},[607,2085,1699],{"class":1121},[607,2087,642],{"class":613},[607,2089,2090,2093,2095,2097,2099,2101,2103,2105,2108,2111],{"class":609,"line":870},[607,2091,2092],{"class":1131},"    schema_version",[607,2094,630],{"class":613},[607,2096,1936],{"class":1121},[607,2098,992],{"class":613},[607,2100,943],{"class":1121},[607,2102,992],{"class":613},[607,2104,1708],{"class":1121},[607,2106,2107],{"class":613}," ??",[607,2109,2110],{"class":678}," 1",[607,2112,642],{"class":613},[607,2114,2115,2118,2120,2122,2124,2126,2128,2130],{"class":609,"line":885},[607,2116,2117],{"class":1131},"    is_ci",[607,2119,630],{"class":613},[607,2121,1936],{"class":1121},[607,2123,992],{"class":613},[607,2125,808],{"class":1121},[607,2127,992],{"class":613},[607,2129,845],{"class":1121},[607,2131,642],{"class":613},[607,2133,2134,2137,2139,2141,2143,2145,2147,2149],{"class":609,"line":908},[607,2135,2136],{"class":1131},"    node",[607,2138,630],{"class":613},[607,2140,1936],{"class":1121},[607,2142,992],{"class":613},[607,2144,808],{"class":1121},[607,2146,992],{"class":613},[607,2148,824],{"class":1121},[607,2150,642],{"class":613},[607,2152,2153,2156,2158,2161,2164,2167],{"class":609,"line":914},[607,2154,2155],{"class":1131},"    received_at",[607,2157,630],{"class":613},[607,2159,2160],{"class":613}," new",[607,2162,2163],{"class":1117}," Date",[607,2165,2166],{"class":1131},"()",[607,2168,642],{"class":613},[607,2170,2171],{"class":609,"line":938},[607,2172,2173],{"class":613},"  }\n",[607,2175,2176],{"class":609,"line":967},[607,2177,970],{"class":613},[593,2179,2180,2181,2183,2184,2186],{},"This is where a company \"modifies the schema\" in practice: not by changing ",[604,2182,1068],{},", but by defining how ",[604,2185,943],{}," maps into internal analytics tables.",[1090,2188,2190,2191],{"id":2189},"version-breaking-changes-in-custom","Version breaking changes in ",[604,2192,943],{},[593,2194,2195,2196,2198,2199,2201],{},"When your product counters evolve, bump a numeric ",[604,2197,1708],{}," in ",[604,2200,943],{}," (no allowlist needed) and branch in the ingest mapper:",[597,2203,2205],{"className":1107,"code":2204,"language":1110,"meta":602,"style":602},"const version = (event.custom.schemaVersion as number | undefined) ?? 1\nif (version === 1) return mapV1(event)\nreturn mapV2(event)\n",[604,2206,2207,2248,2272],{"__ignoreMap":602},[607,2208,2209,2211,2214,2216,2219,2221,2223,2225,2228,2230,2233,2236,2239,2242,2245],{"class":609,"line":610},[607,2210,1644],{"class":623},[607,2212,2213],{"class":1121}," version ",[607,2215,1650],{"class":613},[607,2217,2218],{"class":1121}," (event",[607,2220,992],{"class":613},[607,2222,943],{"class":1121},[607,2224,992],{"class":613},[607,2226,2227],{"class":1121},"schemaVersion ",[607,2229,1740],{"class":1421},[607,2231,2232],{"class":722}," number",[607,2234,2235],{"class":613}," |",[607,2237,2238],{"class":722}," undefined",[607,2240,2241],{"class":1121},") ",[607,2243,2244],{"class":613},"??",[607,2246,2247],{"class":678}," 1\n",[607,2249,2250,2253,2256,2259,2261,2263,2266,2269],{"class":609,"line":617},[607,2251,2252],{"class":1421},"if",[607,2254,2255],{"class":1121}," (version ",[607,2257,2258],{"class":613},"===",[607,2260,2110],{"class":678},[607,2262,2241],{"class":1121},[607,2264,2265],{"class":1421},"return",[607,2267,2268],{"class":1117}," mapV1",[607,2270,2271],{"class":1121},"(event)\n",[607,2273,2274,2276,2279],{"class":609,"line":645},[607,2275,2265],{"class":1421},[607,2277,2278],{"class":1117}," mapV2",[607,2280,2271],{"class":1121},[593,2282,2283,2284,2287,2288,2290],{},"Commit an updated ",[604,2285,2286],{},"TELEMETRY.md"," whenever ",[604,2289,1087],{}," changes so disclosure stays aligned with releases.",[1090,2292,2294],{"id":2293},"multiple-tools-one-endpoint","Multiple tools, one endpoint",[593,2296,2297,2298,630],{},"If several CLIs POST to the same ingest URL, namespace custom keys or rely on ",[604,2299,2300],{},"tool.name",[597,2302,2304],{"className":1107,"code":2303,"language":1110,"meta":602,"style":602},"\u002F\u002F Option A — prefix keys per product line\ntelemetry.set({ acme_product: 'cli', deployCount: 3 })\n\n\u002F\u002F Option B — separate allowedCustomKeys per tool.name in parseIngestBody\nallowedCustomKeys: {\n  'acme-cli': ['deployCount', 'framework'],\n  'acme-action': ['jobDuration', 'ghaAction', 'ghaEvent'],\n}\n",[604,2305,2306,2311,2349,2353,2358,2367,2397,2435],{"__ignoreMap":602},[607,2307,2308],{"class":609,"line":610},[607,2309,2310],{"class":904},"\u002F\u002F Option A — prefix keys per product line\n",[607,2312,2313,2315,2317,2319,2321,2324,2327,2329,2331,2333,2335,2337,2340,2342,2345,2347],{"class":609,"line":617},[607,2314,124],{"class":1121},[607,2316,992],{"class":613},[607,2318,1482],{"class":1117},[607,2320,1432],{"class":1121},[607,2322,2323],{"class":613},"{",[607,2325,2326],{"class":1131}," acme_product",[607,2328,630],{"class":613},[607,2330,1137],{"class":613},[607,2332,1291],{"class":636},[607,2334,1143],{"class":613},[607,2336,782],{"class":613},[607,2338,2339],{"class":1131}," deployCount",[607,2341,630],{"class":613},[607,2343,2344],{"class":678}," 3",[607,2346,1622],{"class":613},[607,2348,1407],{"class":1121},[607,2350,2351],{"class":609,"line":645},[607,2352,1639],{"emptyLinePlaceholder":1638},[607,2354,2355],{"class":609,"line":666},[607,2356,2357],{"class":904},"\u002F\u002F Option B — separate allowedCustomKeys per tool.name in parseIngestBody\n",[607,2359,2360,2363,2365],{"class":609,"line":684},[607,2361,2362],{"class":722},"allowedCustomKeys",[607,2364,630],{"class":613},[607,2366,815],{"class":613},[607,2368,2369,2371,2373,2375,2378,2380,2383,2385,2387,2389,2391,2393,2395],{"class":609,"line":705},[607,2370,1658],{"class":613},[607,2372,1140],{"class":636},[607,2374,1143],{"class":613},[607,2376,2377],{"class":1131},": [",[607,2379,1143],{"class":613},[607,2381,2382],{"class":636},"deployCount",[607,2384,1143],{"class":613},[607,2386,782],{"class":613},[607,2388,1137],{"class":613},[607,2390,1679],{"class":636},[607,2392,1143],{"class":613},[607,2394,1232],{"class":1131},[607,2396,642],{"class":613},[607,2398,2399,2401,2404,2406,2408,2410,2413,2415,2417,2419,2421,2423,2425,2427,2429,2431,2433],{"class":609,"line":752},[607,2400,1658],{"class":613},[607,2402,2403],{"class":636},"acme-action",[607,2405,1143],{"class":613},[607,2407,2377],{"class":1131},[607,2409,1143],{"class":613},[607,2411,2412],{"class":636},"jobDuration",[607,2414,1143],{"class":613},[607,2416,782],{"class":613},[607,2418,1137],{"class":613},[607,2420,1719],{"class":636},[607,2422,1143],{"class":613},[607,2424,782],{"class":613},[607,2426,1137],{"class":613},[607,2428,1728],{"class":636},[607,2430,1143],{"class":613},[607,2432,1232],{"class":1131},[607,2434,642],{"class":613},[607,2436,2437],{"class":609,"line":803},[607,2438,970],{"class":613},[1090,2440,2442],{"id":2441},"what-v1-does-not-support","What v1 does not support",[997,2444,2445,2458],{},[1000,2446,2447],{},[1003,2448,2449,2452,2455],{},[1006,2450,2451],{},"Need",[1006,2453,2454],{},"v1 answer",[1006,2456,2457],{},"Workaround",[1016,2459,2460,2479,2499,2516,2527],{},[1003,2461,2462,2468,2471],{},[1021,2463,2464,2465,1774],{},"New top-level field (",[604,2466,2467],{},"tenantId",[1021,2469,2470],{},"Not on the wire",[1021,2472,2473,2474,2476,2477],{},"Flat key in ",[604,2475,943],{}," + allowlist, or map server-side from ",[604,2478,919],{},[1003,2480,2481,2487,2490],{},[1021,2482,2483,2484,1774],{},"Nested objects (",[604,2485,2486],{},"custom.user.plan",[1021,2488,2489],{},"Flat records only",[1021,2491,2492,2493,2496,2497],{},"Flatten: ",[604,2494,2495],{},"userPlan: 'pro'"," with ",[604,2498,1049],{},[1003,2500,2501,2504,2507],{},[1021,2502,2503],{},"Free-form strings (paths, emails)",[1021,2505,2506],{},"Blocked by design",[1021,2508,2509,2510,2513,2514],{},"Flags record ",[604,2511,2512],{},"\"\u003Cset>\""," instead of the value; hash before ",[604,2515,1045],{},[1003,2517,2518,2521,2524],{},[1021,2519,2520],{},"Different schema per command",[1021,2522,2523],{},"One envelope per run",[1021,2525,2526],{},"Convention: only set relevant keys per command",[1003,2528,2529,2532,2535],{},[1021,2530,2531],{},"Transform before outbox",[1021,2533,2534],{},"No hook yet",[1021,2536,2537],{},"Map on the server (recommended) or see planned v2 below",[2539,2540,2541,2544,2545,2547,2548,1046,2550,2552],"tip",{},[979,2542,2543],{},"Rule of thumb:"," if it is safe to print in ",[604,2546,2286],{}," and fits a closed set or a number, it belongs in ",[604,2549,1087],{},[604,2551,943],{},". Everything else stays server-side.",[1090,2554,2556],{"id":2555},"planned-v2-extensions","Planned v2 extensions",[593,2558,2559],{},"Not shipped yet. These are design targets for when the v1 extension zones are not enough:",[593,2561,2562,2568],{},[979,2563,2564,2567],{},[604,2565,2566],{},"enrich"," hook."," Runs after sanitization, before the outbox append. Lets you inject computed fields without forking the package:",[597,2570,2572],{"className":1107,"code":2571,"language":1110,"meta":602,"style":602},"\u002F\u002F Planned API — not available in v1\ncreateTelemetry({\n  name: 'acme-cli',\n  version: '3.0.0',\n  collect: { fields: { product: ['cli', 'action'] } },\n  enrich(event) {\n    return {\n      ...event,\n      custom: {\n        ...event.custom,\n        schemaVersion: 2,\n      },\n    }\n  },\n})\n",[604,2573,2574,2579,2588,2602,2617,2659,2672,2679,2688,2697,2710,2721,2726,2731,2735],{"__ignoreMap":602},[607,2575,2576],{"class":609,"line":610},[607,2577,2578],{"class":904},"\u002F\u002F Planned API — not available in v1\n",[607,2580,2581,2584,2586],{"class":609,"line":617},[607,2582,2583],{"class":1117},"createTelemetry",[607,2585,1432],{"class":1121},[607,2587,614],{"class":613},[607,2589,2590,2592,2594,2596,2598,2600],{"class":609,"line":645},[607,2591,1132],{"class":1131},[607,2593,630],{"class":613},[607,2595,1137],{"class":613},[607,2597,1140],{"class":636},[607,2599,1143],{"class":613},[607,2601,642],{"class":613},[607,2603,2604,2606,2608,2610,2613,2615],{"class":609,"line":666},[607,2605,1150],{"class":1131},[607,2607,630],{"class":613},[607,2609,1137],{"class":613},[607,2611,2612],{"class":636},"3.0.0",[607,2614,1143],{"class":613},[607,2616,642],{"class":613},[607,2618,2619,2621,2623,2625,2628,2630,2632,2635,2637,2639,2641,2643,2645,2647,2649,2651,2653,2655,2657],{"class":609,"line":684},[607,2620,1182],{"class":1131},[607,2622,630],{"class":613},[607,2624,717],{"class":613},[607,2626,2627],{"class":1131}," fields",[607,2629,630],{"class":613},[607,2631,717],{"class":613},[607,2633,2634],{"class":1131}," product",[607,2636,630],{"class":613},[607,2638,1205],{"class":1121},[607,2640,1143],{"class":613},[607,2642,1291],{"class":636},[607,2644,1143],{"class":613},[607,2646,782],{"class":613},[607,2648,1137],{"class":613},[607,2650,1300],{"class":636},[607,2652,1143],{"class":613},[607,2654,1737],{"class":1121},[607,2656,1404],{"class":613},[607,2658,749],{"class":613},[607,2660,2661,2664,2666,2668,2670],{"class":609,"line":705},[607,2662,2663],{"class":1131},"  enrich",[607,2665,1432],{"class":613},[607,2667,624],{"class":1765},[607,2669,1774],{"class":613},[607,2671,815],{"class":613},[607,2673,2674,2677],{"class":609,"line":752},[607,2675,2676],{"class":1421},"    return",[607,2678,815],{"class":613},[607,2680,2681,2684,2686],{"class":609,"line":803},[607,2682,2683],{"class":613},"      ...",[607,2685,624],{"class":1121},[607,2687,642],{"class":613},[607,2689,2690,2693,2695],{"class":609,"line":818},[607,2691,2692],{"class":1131},"      custom",[607,2694,630],{"class":613},[607,2696,815],{"class":613},[607,2698,2699,2702,2704,2706,2708],{"class":609,"line":840},[607,2700,2701],{"class":613},"        ...",[607,2703,624],{"class":1121},[607,2705,992],{"class":613},[607,2707,943],{"class":1121},[607,2709,642],{"class":613},[607,2711,2712,2715,2717,2719],{"class":609,"line":855},[607,2713,2714],{"class":1131},"        schemaVersion",[607,2716,630],{"class":613},[607,2718,1549],{"class":678},[607,2720,642],{"class":613},[607,2722,2723],{"class":609,"line":870},[607,2724,2725],{"class":613},"      },\n",[607,2727,2728],{"class":609,"line":885},[607,2729,2730],{"class":613},"    }\n",[607,2732,2733],{"class":609,"line":908},[607,2734,911],{"class":613},[607,2736,2737,2739],{"class":609,"line":914},[607,2738,1404],{"class":613},[607,2740,1407],{"class":1121},[593,2742,2743,2744,2746,2747,2749],{},"The hook cannot bypass sanitization rules, and strings still require ",[604,2745,1049],{},". Server-side ",[604,2748,2362],{}," stays the source of truth.",[593,2751,2752,2755,2756,2759,2760,992],{},[979,2753,2754],{},"Namespaced keys."," An optional ",[604,2757,2758],{},"acme.product"," convention for multi-tool endpoints without prefix collisions. Would be documented in disclosure as ",[604,2761,2762],{},"acme.product: cli | action",[593,2764,2765,2766,2768],{},"If you need one of these before v2 lands, open a discussion on the repo. The v1 path (",[604,2767,943],{}," + server mapping) covers most product analytics needs.",[588,2770,2772],{"id":2771},"privacy","Privacy",[593,2774,2775,2776,2779,2780,2783],{},"Raw ",[604,2777,2778],{},"argv"," is never read. Sanitization applies to ",[979,2781,2782],{},"citty-parsed"," flags only:",[1057,2785,2786,2799,2813],{},[1060,2787,2788,2791,2792,2795,2796,1774],{},[979,2789,2790],{},"Booleans \u002F numbers"," → value stored (",[604,2793,2794],{},"json: true",", ",[604,2797,2798],{},"limit: 50",[1060,2800,2801,2804,2805,1065,2807,2810,2811],{},[979,2802,2803],{},"Strings"," → ",[604,2806,2512],{},[604,2808,2809],{},"output: \"\u003Cset>\"",") unless allowlisted in ",[604,2812,1030],{},[1060,2814,2815,2819,2820,2822],{},[979,2816,2817],{},[604,2818,1045],{}," → numbers and booleans always; strings only via ",[604,2821,1049],{}," (undeclared values are dropped at runtime, never thrown)",[597,2824,2826],{"className":1107,"code":2825,"filename":1109,"language":1110,"meta":602,"style":602},"collect: {\n  flags: { format: ['json', 'csv'] },           \u002F\u002F --format json → \"json\"; --format yaml → \"\u003Cset>\"\n  fields: { framework: ['nuxt', 'next'] },      \u002F\u002F telemetry.set({ framework: 'nuxt' }) ok\n}\n",[604,2827,2828,2836,2875,2912],{"__ignoreMap":602},[607,2829,2830,2832,2834],{"class":609,"line":610},[607,2831,1087],{"class":722},[607,2833,630],{"class":613},[607,2835,815],{"class":613},[607,2837,2838,2841,2843,2845,2848,2850,2852,2854,2856,2858,2860,2862,2865,2867,2869,2872],{"class":609,"line":617},[607,2839,2840],{"class":722},"  flags",[607,2842,630],{"class":613},[607,2844,717],{"class":613},[607,2846,2847],{"class":722}," format",[607,2849,630],{"class":613},[607,2851,1205],{"class":1131},[607,2853,1143],{"class":613},[607,2855,1210],{"class":636},[607,2857,1143],{"class":613},[607,2859,782],{"class":613},[607,2861,1137],{"class":613},[607,2863,2864],{"class":636},"csv",[607,2866,1143],{"class":613},[607,2868,1737],{"class":1131},[607,2870,2871],{"class":613},"},",[607,2873,2874],{"class":904},"           \u002F\u002F --format json → \"json\"; --format yaml → \"\u003Cset>\"\n",[607,2876,2877,2880,2882,2884,2887,2889,2891,2893,2895,2897,2899,2901,2903,2905,2907,2909],{"class":609,"line":645},[607,2878,2879],{"class":722},"  fields",[607,2881,630],{"class":613},[607,2883,717],{"class":613},[607,2885,2886],{"class":722}," framework",[607,2888,630],{"class":613},[607,2890,1205],{"class":1131},[607,2892,1143],{"class":613},[607,2894,1367],{"class":636},[607,2896,1143],{"class":613},[607,2898,782],{"class":613},[607,2900,1137],{"class":613},[607,2902,1376],{"class":636},[607,2904,1143],{"class":613},[607,2906,1737],{"class":1131},[607,2908,2871],{"class":613},[607,2910,2911],{"class":904},"      \u002F\u002F telemetry.set({ framework: 'nuxt' }) ok\n",[607,2913,2914],{"class":609,"line":666},[607,2915,970],{"class":613},[593,2917,2918,2919,2921],{},"Three kinds of parser noise are dropped before the event is built, so ",[604,2920,710],{}," reads\nas what the user asked for rather than what the parser filled in:",[1057,2923,2924,2934,2944],{},[1060,2925,2926,2929,2930,2933],{},[979,2927,2928],{},"Positionals",": citty's ",[604,2931,2932],{},"_"," bucket holds argument values, not flag names",[1060,2935,2936,2939,2940,2943],{},[979,2937,2938],{},"Defaults",": a flag still sitting at its declared ",[604,2941,2942],{},"default"," is not a choice anyone made",[1060,2945,2946,2949,2950,2953,2954,2957,2958,2961,2962,2964],{},[979,2947,2948],{},"Kebab-case duplicates",": ",[604,2951,2952],{},"--min-score"," arrives as both ",[604,2955,2956],{},"minScore"," and ",[604,2959,2960],{},"min-score","; only the camelCase name is kept, and that is the name ",[604,2963,1030],{}," allowlists",[593,2966,2967,2968,2971,2972,2975,2976,992],{},"Negation still reports: ",[604,2969,2970],{},"--no-write"," against ",[604,2973,2974],{},"write: { default: true }"," records ",[604,2977,2978],{},"write: false",[593,2980,2981,2982,1100,2984,2986,2987,2989],{},"Declare allowlists in the same ",[604,2983,1099],{},[604,2985,1103],{}," call as ",[604,2988,1087],{},", with no separate config file.",[588,2991,2993],{"id":2992},"disclosure","Disclosure",[593,2995,2996,2999,3000,3002,3003,3005],{},[604,2997,2998],{},"generateDisclosure()"," produces markdown + JSON from the standard envelope plus your ",[604,3001,1087],{}," extensions. Commit the output (e.g. ",[604,3004,2286],{},") so it stays in sync with releases:",[597,3007,3010],{"className":1107,"code":3008,"filename":3009,"language":1110,"meta":602,"style":602},"import { writeFile } from 'node:fs\u002Fpromises'\nimport { generateDisclosure } from '@evlog\u002Ftelemetry'\n\nconst { markdown } = generateDisclosure('my-tool', {\n  flags: { format: ['json', 'csv'] },\n})\n\nawait writeFile('TELEMETRY.md', markdown)\n","scripts\u002Fgenerate-disclosure.ts",[604,3011,3012,3032,3051,3055,3082,3115,3121,3125],{"__ignoreMap":602},[607,3013,3014,3016,3018,3021,3023,3025,3027,3030],{"class":609,"line":610},[607,3015,1614],{"class":1421},[607,3017,717],{"class":613},[607,3019,3020],{"class":1121}," writeFile",[607,3022,1622],{"class":613},[607,3024,1625],{"class":1421},[607,3026,1137],{"class":613},[607,3028,3029],{"class":636},"node:fs\u002Fpromises",[607,3031,1633],{"class":613},[607,3033,3034,3036,3038,3041,3043,3045,3047,3049],{"class":609,"line":617},[607,3035,1614],{"class":1421},[607,3037,717],{"class":613},[607,3039,3040],{"class":1121}," generateDisclosure",[607,3042,1622],{"class":613},[607,3044,1625],{"class":1421},[607,3046,1137],{"class":613},[607,3048,1072],{"class":636},[607,3050,1633],{"class":613},[607,3052,3053],{"class":609,"line":645},[607,3054,1639],{"emptyLinePlaceholder":1638},[607,3056,3057,3059,3061,3064,3066,3068,3070,3072,3074,3076,3078,3080],{"class":609,"line":666},[607,3058,1644],{"class":623},[607,3060,717],{"class":613},[607,3062,3063],{"class":1121}," markdown ",[607,3065,1404],{"class":613},[607,3067,1463],{"class":613},[607,3069,3040],{"class":1117},[607,3071,1432],{"class":1121},[607,3073,1143],{"class":613},[607,3075,777],{"class":636},[607,3077,1143],{"class":613},[607,3079,782],{"class":613},[607,3081,815],{"class":613},[607,3083,3084,3086,3088,3090,3092,3094,3096,3098,3100,3102,3104,3106,3108,3110,3112],{"class":609,"line":684},[607,3085,2840],{"class":1131},[607,3087,630],{"class":613},[607,3089,717],{"class":613},[607,3091,2847],{"class":1131},[607,3093,630],{"class":613},[607,3095,1205],{"class":1121},[607,3097,1143],{"class":613},[607,3099,1210],{"class":636},[607,3101,1143],{"class":613},[607,3103,782],{"class":613},[607,3105,1137],{"class":613},[607,3107,2864],{"class":636},[607,3109,1143],{"class":613},[607,3111,1737],{"class":1121},[607,3113,3114],{"class":613},"},\n",[607,3116,3117,3119],{"class":609,"line":705},[607,3118,1404],{"class":613},[607,3120,1407],{"class":1121},[607,3122,3123],{"class":609,"line":752},[607,3124,1639],{"emptyLinePlaceholder":1638},[607,3126,3127,3129,3131,3133,3135,3137,3139,3141],{"class":609,"line":803},[607,3128,1422],{"class":1421},[607,3130,3020],{"class":1117},[607,3132,1432],{"class":1121},[607,3134,1143],{"class":613},[607,3136,2286],{"class":636},[607,3138,1143],{"class":613},[607,3140,782],{"class":613},[607,3142,3143],{"class":1121}," markdown)\n",[593,3145,3146,3147,3150,3151,992],{},"Users can also read it at runtime via ",[604,3148,3149],{},"my-tool telemetry status"," when you wire ",[604,3152,3153],{},"defineTelemetryCommands()",[588,3155,3157],{"id":3156},"consent-and-reliability","Consent and reliability",[593,3159,3160,1583,3163,2804,3166,3169,3170,1100,3173,3176],{},[979,3161,3162],{},"Opt-out priority:",[604,3164,3165],{},"DO_NOT_TRACK=1",[604,3167,3168],{},"EVLOG_TELEMETRY=0"," → persisted preference (",[604,3171,3172],{},"disableTelemetry()",[604,3174,3175],{},"telemetry disable","). Opt-out purges the undelivered outbox.",[593,3178,3179,3182,3183,3186],{},[979,3180,3181],{},"Never harms the host:"," telemetry never throws, never blocks exit; ",[604,3184,3185],{},"flush()"," has a 500ms hard cap.",[593,3188,3189,3192,3193,992],{},[979,3190,3191],{},"Outbox:"," events append locally before any network attempt. Offline machines and CI matrix jobs drain the backlog on the next invocation once your ingestion endpoint returns ",[604,3194,3195],{},"2xx",[593,3197,3198,1583,3201,3204,3205,3208],{},[979,3199,3200],{},"Endpoint:",[604,3202,3203],{},"EVLOG_TELEMETRY_ENDPOINT"," env → ",[604,3206,3207],{},"endpoint"," option baked into the CLI. Omit both during local development; ship the URL when your ingest handler is live.",[3210,3211,3212],"style",{},"html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}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 .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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 pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":602,"searchDepth":617,"depth":617,"links":3214},[3215,3216,3226,3227,3228],{"id":590,"depth":617,"text":591},{"id":973,"depth":617,"text":974,"children":3217},[3218,3219,3220,3221,3223,3224,3225],{"id":1092,"depth":645,"text":1093},{"id":1599,"depth":645,"text":1600},{"id":1884,"depth":645,"text":1885},{"id":2189,"depth":645,"text":3222},"Version breaking changes in custom",{"id":2293,"depth":645,"text":2294},{"id":2441,"depth":645,"text":2442},{"id":2555,"depth":645,"text":2556},{"id":2771,"depth":617,"text":2772},{"id":2992,"depth":617,"text":2993},{"id":3156,"depth":617,"text":3157},"RunEvent envelope, extending the schema with collect and custom fields, privacy rules, TELEMETRY.md disclosure, and consent \u002F outbox reliability.","md",[3232,3235,3236],{"label":41,"icon":44,"to":423,"color":3233,"variant":3234},"neutral","subtle",{"label":426,"icon":429,"to":427,"color":3233,"variant":3234},{"label":431,"icon":434,"to":432,"color":3233,"variant":3234},{},{"title":436,"icon":84},{"title":583,"description":3229},"9QIMa3arrtXM1ogwvMDBj2bkaTzJC1sft1nHE9vGiwU",[3242,3244],{"title":431,"path":432,"stem":433,"description":3243,"icon":434,"children":-1},"Build the ingestion endpoint for @evlog\u002Ftelemetry: the threat model, parseIngestBody validation, framework routes, storage, and rate limiting.",{"title":440,"path":441,"stem":442,"description":3245,"icon":443,"children":-1},"Add derived context to every wide event, from user agent and geo to your own computed fields.",1789074374243]