[{"data":1,"prerenderedAt":1935},["ShallowReactive",2],{"navigation_docs":3,"-build-on-top-shared-catalogs-as-packages":547,"-build-on-top-shared-catalogs-as-packages-surround":1930},[4,35,159,201,289,446,531],{"title":5,"path":6,"stem":7,"children":8,"page":34},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-info",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Quick Start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start","i-lucide-zap",{"title":25,"path":26,"stem":27,"icon":28},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F4.agent-skills","i-lucide-sparkles",{"title":30,"path":31,"stem":32,"icon":33},"vs Other Loggers","\u002Fgetting-started\u002Fvs-other-loggers","1.getting-started\u002F5.vs-other-loggers","i-lucide-scale",false,{"title":36,"path":37,"stem":38,"children":39,"page":34},"Logging","\u002Flogging","2.logging",[40,45,50,55,60,65,70,99,127],{"title":41,"path":42,"stem":43,"icon":44},"Overview","\u002Flogging\u002Foverview","2.logging\u002F0.overview","i-lucide-list",{"title":46,"path":47,"stem":48,"icon":49},"Simple Logging","\u002Flogging\u002Fsimple-logging","2.logging\u002F1.simple-logging","i-lucide-terminal",{"title":51,"path":52,"stem":53,"icon":54},"Wide Events","\u002Flogging\u002Fwide-events","2.logging\u002F2.wide-events","i-lucide-layers",{"title":56,"path":57,"stem":58,"icon":59},"Structured Errors","\u002Flogging\u002Fstructured-errors","2.logging\u002F3.structured-errors","i-lucide-shield-alert",{"title":61,"path":62,"stem":63,"icon":64},"Catalogs","\u002Flogging\u002Fcatalogs","2.logging\u002F4.catalogs","i-lucide-book-open",{"title":66,"path":67,"stem":68,"icon":69},"Client Logging","\u002Flogging\u002Fclient-logging","2.logging\u002F5.client-logging","i-lucide-monitor",{"title":71,"icon":72,"path":73,"stem":74,"children":75,"page":34},"AI SDK","i-simple-icons-vercel","\u002Flogging\u002Fai-sdk","2.logging\u002F6.ai-sdk",[76,79,84,89,94],{"title":41,"path":77,"stem":78,"icon":44},"\u002Flogging\u002Fai-sdk\u002Foverview","2.logging\u002F6.ai-sdk\u002F01.overview",{"title":80,"path":81,"stem":82,"icon":83},"Usage","\u002Flogging\u002Fai-sdk\u002Fusage","2.logging\u002F6.ai-sdk\u002F02.usage","i-lucide-code",{"title":85,"path":86,"stem":87,"icon":88},"Options","\u002Flogging\u002Fai-sdk\u002Foptions","2.logging\u002F6.ai-sdk\u002F03.options","i-lucide-sliders",{"title":90,"path":91,"stem":92,"icon":93},"Metadata","\u002Flogging\u002Fai-sdk\u002Fmetadata","2.logging\u002F6.ai-sdk\u002F04.metadata","i-lucide-database",{"title":95,"path":96,"stem":97,"icon":98},"Telemetry","\u002Flogging\u002Fai-sdk\u002Ftelemetry","2.logging\u002F6.ai-sdk\u002F05.telemetry","i-lucide-activity",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":34},"Better Auth","i-simple-icons-betterauth","\u002Flogging\u002Fbetter-auth","2.logging\u002F7.better-auth",[105,108,113,118,122],{"title":41,"path":106,"stem":107,"icon":44},"\u002Flogging\u002Fbetter-auth\u002Foverview","2.logging\u002F7.better-auth\u002F01.overview",{"title":109,"path":110,"stem":111,"icon":112},"Identify User","\u002Flogging\u002Fbetter-auth\u002Fidentify-user","2.logging\u002F7.better-auth\u002F02.identify-user","i-lucide-user-check",{"title":114,"path":115,"stem":116,"icon":117},"Middleware","\u002Flogging\u002Fbetter-auth\u002Fmiddleware","2.logging\u002F7.better-auth\u002F03.middleware","i-lucide-shield",{"title":119,"path":120,"stem":121,"icon":69},"Client Sync","\u002Flogging\u002Fbetter-auth\u002Fclient-sync","2.logging\u002F7.better-auth\u002F04.client-sync",{"title":123,"path":124,"stem":125,"icon":126},"Performance","\u002Flogging\u002Fbetter-auth\u002Fperformance","2.logging\u002F7.better-auth\u002F05.performance","i-lucide-gauge",{"title":128,"icon":129,"path":130,"stem":131,"children":132,"page":34},"Audit Logs","i-lucide-shield-check","\u002Flogging\u002Faudit","2.logging\u002F8.audit",[133,136,141,146,151,155],{"title":41,"path":134,"stem":135,"icon":44},"\u002Flogging\u002Faudit\u002Foverview","2.logging\u002F8.audit\u002F01.overview",{"title":137,"path":138,"stem":139,"icon":140},"Schema","\u002Flogging\u002Faudit\u002Fschema","2.logging\u002F8.audit\u002F02.schema","i-lucide-file-text",{"title":142,"path":143,"stem":144,"icon":145},"Recording","\u002Flogging\u002Faudit\u002Frecording","2.logging\u002F8.audit\u002F03.recording","i-lucide-pen-line",{"title":147,"path":148,"stem":149,"icon":150},"Drains","\u002Flogging\u002Faudit\u002Fpipeline","2.logging\u002F8.audit\u002F04.pipeline","i-lucide-link",{"title":152,"path":153,"stem":154,"icon":129},"Compliance","\u002Flogging\u002Faudit\u002Fcompliance","2.logging\u002F8.audit\u002F05.compliance",{"title":156,"path":157,"stem":158,"icon":64},"Recipes","\u002Flogging\u002Faudit\u002Frecipes","2.logging\u002F8.audit\u002F06.recipes",{"title":160,"path":161,"stem":162,"children":163,"page":34},"Core Concepts","\u002Fcore-concepts","3.core-concepts",[164,169,174,179,184,188,191,196],{"title":165,"path":166,"stem":167,"icon":168},"Lifecycle","\u002Fcore-concepts\u002Flifecycle","3.core-concepts\u002F0.lifecycle","i-lucide-arrow-right-left",{"title":170,"path":171,"stem":172,"icon":173},"Configuration","\u002Fcore-concepts\u002Fconfiguration","3.core-concepts\u002F1.configuration","i-lucide-settings",{"title":175,"path":176,"stem":177,"icon":178},"Sampling","\u002Fcore-concepts\u002Fsampling","3.core-concepts\u002F2.sampling","i-lucide-filter",{"title":180,"path":181,"stem":182,"icon":183},"Typed Fields","\u002Fcore-concepts\u002Ftyped-fields","3.core-concepts\u002F3.typed-fields","i-simple-icons-typescript",{"title":185,"path":186,"stem":187,"icon":129},"Best Practices","\u002Fcore-concepts\u002Fbest-practices","3.core-concepts\u002F4.best-practices",{"title":123,"path":189,"stem":190,"icon":126},"\u002Fcore-concepts\u002Fperformance","3.core-concepts\u002F5.performance",{"title":192,"path":193,"stem":194,"icon":195},"Vite Plugin","\u002Fcore-concepts\u002Fvite-plugin","3.core-concepts\u002F6.vite-plugin","i-custom-vite",{"title":197,"path":198,"stem":199,"icon":200},"Auto-Redaction","\u002Fcore-concepts\u002Fredaction","3.core-concepts\u002F7.redaction","i-lucide-eye-off",{"title":202,"path":203,"stem":204,"children":205,"page":34},"Frameworks","\u002Fframeworks","4.frameworks",[206,210,215,220,225,230,235,240,245,250,255,260,265,270,274,279,284],{"title":41,"path":207,"stem":208,"icon":209},"\u002Fframeworks\u002Foverview","4.frameworks\u002F00.overview","i-lucide-layout-grid",{"title":211,"path":212,"stem":213,"icon":214},"Nuxt","\u002Fframeworks\u002Fnuxt","4.frameworks\u002F01.nuxt","i-simple-icons-nuxtdotjs",{"title":216,"path":217,"stem":218,"icon":219},"Next.js","\u002Fframeworks\u002Fnextjs","4.frameworks\u002F02.nextjs","i-simple-icons-nextdotjs",{"title":221,"path":222,"stem":223,"icon":224},"SvelteKit","\u002Fframeworks\u002Fsveltekit","4.frameworks\u002F03.sveltekit","i-simple-icons-svelte",{"title":226,"path":227,"stem":228,"icon":229},"Nitro","\u002Fframeworks\u002Fnitro","4.frameworks\u002F04.nitro","i-custom-nitro",{"title":231,"path":232,"stem":233,"icon":234},"TanStack Start","\u002Fframeworks\u002Ftanstack-start","4.frameworks\u002F05.tanstack-start","i-custom-tanstack",{"title":236,"path":237,"stem":238,"icon":239},"NestJS","\u002Fframeworks\u002Fnestjs","4.frameworks\u002F06.nestjs","i-simple-icons-nestjs",{"title":241,"path":242,"stem":243,"icon":244},"Express","\u002Fframeworks\u002Fexpress","4.frameworks\u002F07.express","i-simple-icons-express",{"title":246,"path":247,"stem":248,"icon":249},"Hono","\u002Fframeworks\u002Fhono","4.frameworks\u002F08.hono","i-simple-icons-hono",{"title":251,"path":252,"stem":253,"icon":254},"Fastify","\u002Fframeworks\u002Ffastify","4.frameworks\u002F09.fastify","i-simple-icons-fastify",{"title":256,"path":257,"stem":258,"icon":259},"Elysia","\u002Fframeworks\u002Felysia","4.frameworks\u002F10.elysia","i-custom-elysia",{"title":261,"path":262,"stem":263,"icon":264},"React Router","\u002Fframeworks\u002Freact-router","4.frameworks\u002F11.react-router","i-custom-reactrouter",{"title":266,"path":267,"stem":268,"icon":269},"Cloudflare Workers","\u002Fframeworks\u002Fcloudflare-workers","4.frameworks\u002F12.cloudflare-workers","i-simple-icons-cloudflare",{"title":271,"path":272,"stem":273,"icon":183},"Standalone","\u002Fframeworks\u002Fstandalone","4.frameworks\u002F13.standalone",{"title":275,"path":276,"stem":277,"icon":278},"Astro","\u002Fframeworks\u002Fastro","4.frameworks\u002F14.astro","i-simple-icons-astro",{"title":280,"path":281,"stem":282,"icon":283},"AWS Lambda","\u002Fframeworks\u002Faws-lambda","4.frameworks\u002F16.aws-lambda","i-custom-lambda",{"title":285,"path":286,"stem":287,"icon":288},"Custom Integration","\u002Fframeworks\u002Fcustom-integration","4.frameworks\u002F17.custom-integration","i-lucide-puzzle",{"title":290,"path":291,"stem":292,"children":293,"page":34},"Build on top","\u002Fbuild-on-top","5.build-on-top",[294,297,325,346,373,400,428],{"title":41,"path":295,"stem":296,"icon":54},"\u002Fbuild-on-top\u002Foverview","5.build-on-top\u002F0.overview",{"title":298,"path":299,"stem":300,"children":301,"page":34},"Observers","\u002Fbuild-on-top\u002Fobservers","5.build-on-top\u002Fobservers",[302,306,311,316,321],{"title":41,"path":303,"stem":304,"icon":305},"\u002Fbuild-on-top\u002Fobservers\u002Foverview","5.build-on-top\u002Fobservers\u002F1.overview","i-lucide-eye",{"title":307,"path":308,"stem":309,"icon":310},"Stream API","\u002Fbuild-on-top\u002Fobservers\u002Fin-process-stream","5.build-on-top\u002Fobservers\u002F2.in-process-stream","i-lucide-radio-tower",{"title":312,"path":313,"stem":314,"icon":315},"Stream server","\u002Fbuild-on-top\u002Fobservers\u002Fstream-server","5.build-on-top\u002Fobservers\u002F3.stream-server","i-lucide-radio",{"title":317,"path":318,"stem":319,"icon":320},"FS reader","\u002Fbuild-on-top\u002Fobservers\u002Ffs-reader","5.build-on-top\u002Fobservers\u002F4.fs-reader","i-lucide-folder-search",{"title":156,"path":322,"stem":323,"icon":324},"\u002Fbuild-on-top\u002Fobservers\u002Fconsumer-recipes","5.build-on-top\u002Fobservers\u002F5.consumer-recipes","i-lucide-chef-hat",{"title":326,"path":327,"stem":328,"children":329,"page":34},"Pipeline","\u002Fbuild-on-top\u002Fpipeline","5.build-on-top\u002Fpipeline",[330,334,338,342],{"title":41,"path":331,"stem":332,"icon":333},"\u002Fbuild-on-top\u002Fpipeline\u002Foverview","5.build-on-top\u002Fpipeline\u002F1.overview","i-lucide-workflow",{"title":335,"path":336,"stem":337,"icon":288},"Plugins","\u002Fbuild-on-top\u002Fpipeline\u002Fplugins","5.build-on-top\u002Fpipeline\u002F2.plugins",{"title":339,"path":340,"stem":341,"icon":28},"Custom enrichers","\u002Fbuild-on-top\u002Fpipeline\u002Fcustom-enrichers","5.build-on-top\u002Fpipeline\u002F3.custom-enrichers",{"title":343,"path":344,"stem":345,"icon":178},"Tail sampling","\u002Fbuild-on-top\u002Fpipeline\u002Ftail-sampling","5.build-on-top\u002Fpipeline\u002F4.tail-sampling",{"title":347,"path":348,"stem":349,"children":350,"page":34},"Scenarios","\u002Fbuild-on-top\u002Fscenarios","5.build-on-top\u002Fscenarios",[351,355,359,364,368],{"title":41,"path":352,"stem":353,"icon":354},"\u002Fbuild-on-top\u002Fscenarios\u002Foverview","5.build-on-top\u002Fscenarios\u002F0.overview","i-lucide-clipboard-list",{"title":356,"path":357,"stem":358,"icon":49},"Local debugging toolkit","\u002Fbuild-on-top\u002Fscenarios\u002Flocal-debugging-toolkit","5.build-on-top\u002Fscenarios\u002F1.local-debugging-toolkit",{"title":360,"path":361,"stem":362,"icon":363},"Tenant-aware logging","\u002Fbuild-on-top\u002Fscenarios\u002Ftenant-aware-logging","5.build-on-top\u002Fscenarios\u002F2.tenant-aware-logging","i-lucide-users",{"title":365,"path":366,"stem":367,"icon":129},"Compliance audit","\u002Fbuild-on-top\u002Fscenarios\u002Fcompliance-audit","5.build-on-top\u002Fscenarios\u002F3.compliance-audit",{"title":369,"path":370,"stem":371,"icon":372},"Cross-app error vocab","\u002Fbuild-on-top\u002Fscenarios\u002Fcross-app-error-vocab","5.build-on-top\u002Fscenarios\u002F4.cross-app-error-vocab","i-lucide-book",{"title":374,"path":375,"stem":376,"children":377,"page":34},"Shared packages","\u002Fbuild-on-top\u002Fshared","5.build-on-top\u002Fshared",[378,382,386,391,395],{"title":41,"path":379,"stem":380,"icon":381},"\u002Fbuild-on-top\u002Fshared\u002Foverview","5.build-on-top\u002Fshared\u002F1.overview","i-lucide-package",{"title":383,"path":384,"stem":385,"icon":381},"Catalogs as packages","\u002Fbuild-on-top\u002Fshared\u002Fcatalogs-as-packages","5.build-on-top\u002Fshared\u002F2.catalogs-as-packages",{"title":387,"path":388,"stem":389,"icon":390},"Drains as packages","\u002Fbuild-on-top\u002Fshared\u002Fdrains-as-packages","5.build-on-top\u002Fshared\u002F3.drains-as-packages","i-lucide-package-2",{"title":392,"path":393,"stem":394,"icon":28},"Enrichers as packages","\u002Fbuild-on-top\u002Fshared\u002Fenrichers-as-packages","5.build-on-top\u002Fshared\u002F4.enrichers-as-packages",{"title":396,"path":397,"stem":398,"icon":399},"Integration as package","\u002Fbuild-on-top\u002Fshared\u002Fintegration-as-package","5.build-on-top\u002Fshared\u002F5.integration-as-package","i-lucide-package-check",{"title":401,"path":402,"stem":403,"children":404,"page":34},"Sinks","\u002Fbuild-on-top\u002Fsinks","5.build-on-top\u002Fsinks",[405,409,414,418,423],{"title":41,"path":406,"stem":407,"icon":408},"\u002Fbuild-on-top\u002Fsinks\u002Foverview","5.build-on-top\u002Fsinks\u002F1.overview","i-lucide-arrow-up-from-line",{"title":410,"path":411,"stem":412,"icon":413},"Custom drains","\u002Fbuild-on-top\u002Fsinks\u002Fcustom-drains","5.build-on-top\u002Fsinks\u002F2.custom-drains","i-lucide-code-2",{"title":415,"path":416,"stem":417,"icon":333},"Drain pipeline","\u002Fbuild-on-top\u002Fsinks\u002Fdrain-pipeline","5.build-on-top\u002Fsinks\u002F3.drain-pipeline",{"title":419,"path":420,"stem":421,"icon":422},"Identity headers","\u002Fbuild-on-top\u002Fsinks\u002Fidentity-headers","5.build-on-top\u002Fsinks\u002F4.identity-headers","i-lucide-fingerprint",{"title":424,"path":425,"stem":426,"icon":427},"Fanout","\u002Fbuild-on-top\u002Fsinks\u002Ffanout-and-multi-drain","5.build-on-top\u002Fsinks\u002F5.fanout-and-multi-drain","i-lucide-share-2",{"title":429,"path":430,"stem":431,"children":432,"page":34},"Sources","\u002Fbuild-on-top\u002Fsources","5.build-on-top\u002Fsources",[433,437,441],{"title":41,"path":434,"stem":435,"icon":436},"\u002Fbuild-on-top\u002Fsources\u002Foverview","5.build-on-top\u002Fsources\u002F1.overview","i-lucide-arrow-down-to-line",{"title":438,"path":439,"stem":440,"icon":288},"Custom framework","\u002Fbuild-on-top\u002Fsources\u002Fcustom-framework","5.build-on-top\u002Fsources\u002F2.custom-framework",{"title":442,"path":443,"stem":444,"icon":445},"Middleware toolkit","\u002Fbuild-on-top\u002Fsources\u002Fmiddleware-toolkit","5.build-on-top\u002Fsources\u002F3.middleware-toolkit","i-lucide-wrench",{"title":447,"path":448,"stem":449,"children":450,"page":34},"Adapters","\u002Fadapters","6.adapters",[451,454,494,509],{"title":41,"path":452,"stem":453,"icon":44},"\u002Fadapters\u002Foverview","6.adapters\u002F01.overview",{"title":455,"path":456,"stem":457,"children":458,"page":34},"Cloud destinations","\u002Fadapters\u002Fcloud","6.adapters\u002F02.cloud",[459,464,469,474,479,484,489],{"title":460,"path":461,"stem":462,"icon":463},"Axiom","\u002Fadapters\u002Fcloud\u002Faxiom","6.adapters\u002F02.cloud\u002F01.axiom","i-custom-axiom",{"title":465,"path":466,"stem":467,"icon":468},"OTLP","\u002Fadapters\u002Fcloud\u002Fotlp","6.adapters\u002F02.cloud\u002F02.otlp","i-simple-icons-opentelemetry",{"title":470,"path":471,"stem":472,"icon":473},"PostHog","\u002Fadapters\u002Fcloud\u002Fposthog","6.adapters\u002F02.cloud\u002F03.posthog","i-simple-icons-posthog",{"title":475,"path":476,"stem":477,"icon":478},"Sentry","\u002Fadapters\u002Fcloud\u002Fsentry","6.adapters\u002F02.cloud\u002F04.sentry","i-simple-icons-sentry",{"title":480,"path":481,"stem":482,"icon":483},"Better Stack","\u002Fadapters\u002Fcloud\u002Fbetter-stack","6.adapters\u002F02.cloud\u002F05.better-stack","i-simple-icons-betterstack",{"title":485,"path":486,"stem":487,"icon":488},"Datadog","\u002Fadapters\u002Fcloud\u002Fdatadog","6.adapters\u002F02.cloud\u002F06.datadog","i-simple-icons-datadog",{"title":490,"path":491,"stem":492,"icon":493},"HyperDX","\u002Fadapters\u002Fcloud\u002Fhyperdx","6.adapters\u002F02.cloud\u002F07.hyperdx","i-custom-hyperdx",{"title":495,"path":496,"stem":497,"children":498,"page":34},"Self-hosted","\u002Fadapters\u002Fself-hosted","6.adapters\u002F03.self-hosted",[499,504],{"title":500,"path":501,"stem":502,"icon":503},"File System","\u002Fadapters\u002Fself-hosted\u002Ffs","6.adapters\u002F03.self-hosted\u002F01.fs","i-lucide-hard-drive",{"title":505,"path":506,"stem":507,"icon":508},"NuxtHub","\u002Fadapters\u002Fself-hosted\u002Fnuxthub","6.adapters\u002F03.self-hosted\u002F02.nuxthub","i-simple-icons-nuxt",{"title":510,"path":511,"stem":512,"children":513,"page":34},"Building blocks","\u002Fadapters\u002Fbuilding-blocks","6.adapters\u002F04.building-blocks",[514,517,522,526],{"title":326,"path":515,"stem":516,"icon":333},"\u002Fadapters\u002Fbuilding-blocks\u002Fpipeline","6.adapters\u002F04.building-blocks\u002F01.pipeline",{"title":518,"path":519,"stem":520,"icon":521},"HTTP","\u002Fadapters\u002Fbuilding-blocks\u002Fhttp","6.adapters\u002F04.building-blocks\u002F02.http","i-lucide-globe",{"title":523,"path":524,"stem":525,"icon":83},"Custom Adapters","\u002Fadapters\u002Fbuilding-blocks\u002Fcustom","6.adapters\u002F04.building-blocks\u002F03.custom",{"title":527,"path":528,"stem":529,"icon":530},"Toolkit","\u002Fadapters\u002Fbuilding-blocks\u002Ftoolkit","6.adapters\u002F04.building-blocks\u002F04.toolkit","i-lucide-blocks",{"title":532,"path":533,"stem":534,"children":535,"page":34},"Enrichers","\u002Fenrichers","7.enrichers",[536,539,543],{"title":41,"path":537,"stem":538,"icon":28},"\u002Fenrichers\u002Foverview","7.enrichers\u002F1.overview",{"title":540,"path":541,"stem":542,"icon":288},"Built-in","\u002Fenrichers\u002Fbuilt-in","7.enrichers\u002F2.built-in",{"title":544,"path":545,"stem":546,"icon":83},"Custom","\u002Fenrichers\u002Fcustom","7.enrichers\u002F3.custom",{"id":548,"title":383,"body":549,"description":1923,"extension":1924,"links":1925,"meta":1926,"navigation":1927,"path":384,"seo":1928,"stem":385,"__hash__":1929},"docs\u002F5.build-on-top\u002Fshared\u002F2.catalogs-as-packages.md",{"type":550,"value":551,"toc":1916},"minimark",[552,583,596,599,604,607,624,979,990,1000,1004,1011,1331,1337,1354,1478,1482,1485,1503,1572,1579,1595,1825,1829,1832,1868,1874,1878,1909,1912],[553,554,555,556,560,561,564,565,569,570,573,574,577,578,582],"p",{},"evlog catalogs (",[557,558,559],"a",{"href":62},"error catalogs",", ",[557,562,563],{"href":134},"audit catalogs",") are plain TypeScript objects passed to ",[566,567,568],"code",{},"defineErrorCatalog()"," \u002F ",[566,571,572],{},"defineAuditCatalog()",". They're not tied to a project — anything you can ",[566,575,576],{},"import"," works. That makes them perfect to publish as ",[579,580,581],"strong",{},"reusable npm packages",":",[584,585,586,590,593],"ul",{},[587,588,589],"li",{},"An organization-wide error catalog shared by every microservice",[587,591,592],{},"An open-source catalog for a specific domain (Stripe payments, AWS API errors, RFC 7807 problem types)",[587,594,595],{},"A team's audit catalog covering compliance actions across products",[553,597,598],{},"This page shows the minimum scaffolding for a package that exports a catalog and how downstream apps consume it.",[600,601,603],"h2",{"id":602},"what-goes-in-the-package","What goes in the package",[553,605,606],{},"A catalog package exports two things:",[608,609,610,617],"ol",{},[587,611,612,613,616],{},"The defined catalog (an object) — for ",[566,614,615],{},"evlog"," to register",[587,618,619,620,623],{},"A typed ",[566,621,622],{},"module"," augmentation — so consumers get autocomplete on the catalog keys",[625,626,632],"pre",{"className":627,"code":628,"filename":629,"language":630,"meta":631,"style":631},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineErrorCatalog } from 'evlog'\n\nexport const stripeErrors = defineErrorCatalog('stripe', {\n  card_declined: {\n    code: 'STRIPE_CARD_DECLINED',\n    status: 402,\n    message: 'Card was declined.',\n    why: 'The issuing bank rejected the charge.',\n    fix: 'Try a different payment method or contact the bank.',\n  },\n  insufficient_funds: {\n    code: 'STRIPE_INSUFFICIENT_FUNDS',\n    status: 402,\n    message: 'Card has insufficient funds.',\n    why: 'The card balance does not cover this charge.',\n    fix: 'Try a different card or use a smaller amount.',\n  },\n  \u002F\u002F ... more entries ...\n} as const)\n\ndeclare module 'evlog' {\n  interface RegisteredErrorCatalogs {\n    stripe: typeof stripeErrors\n  }\n}\n","src\u002Findex.ts","ts","",[566,633,634,665,672,708,719,737,751,768,785,802,808,818,834,845,861,877,893,898,905,919,924,941,953,967,973],{"__ignoreMap":631},[635,636,639,642,646,650,653,656,659,662],"span",{"class":637,"line":638},"line",1,[635,640,576],{"class":641},"s7zQu",[635,643,645],{"class":644},"sMK4o"," {",[635,647,649],{"class":648},"sTEyZ"," defineErrorCatalog",[635,651,652],{"class":644}," }",[635,654,655],{"class":641}," from",[635,657,658],{"class":644}," '",[635,660,615],{"class":661},"sfazB",[635,663,664],{"class":644},"'\n",[635,666,668],{"class":637,"line":667},2,[635,669,671],{"emptyLinePlaceholder":670},true,"\n",[635,673,675,678,682,685,688,691,694,697,700,702,705],{"class":637,"line":674},3,[635,676,677],{"class":641},"export",[635,679,681],{"class":680},"spNyl"," const",[635,683,684],{"class":648}," stripeErrors ",[635,686,687],{"class":644},"=",[635,689,649],{"class":690},"s2Zo4",[635,692,693],{"class":648},"(",[635,695,696],{"class":644},"'",[635,698,699],{"class":661},"stripe",[635,701,696],{"class":644},[635,703,704],{"class":644},",",[635,706,707],{"class":644}," {\n",[635,709,711,715,717],{"class":637,"line":710},4,[635,712,714],{"class":713},"swJcz","  card_declined",[635,716,582],{"class":644},[635,718,707],{"class":644},[635,720,722,725,727,729,732,734],{"class":637,"line":721},5,[635,723,724],{"class":713},"    code",[635,726,582],{"class":644},[635,728,658],{"class":644},[635,730,731],{"class":661},"STRIPE_CARD_DECLINED",[635,733,696],{"class":644},[635,735,736],{"class":644},",\n",[635,738,740,743,745,749],{"class":637,"line":739},6,[635,741,742],{"class":713},"    status",[635,744,582],{"class":644},[635,746,748],{"class":747},"sbssI"," 402",[635,750,736],{"class":644},[635,752,754,757,759,761,764,766],{"class":637,"line":753},7,[635,755,756],{"class":713},"    message",[635,758,582],{"class":644},[635,760,658],{"class":644},[635,762,763],{"class":661},"Card was declined.",[635,765,696],{"class":644},[635,767,736],{"class":644},[635,769,771,774,776,778,781,783],{"class":637,"line":770},8,[635,772,773],{"class":713},"    why",[635,775,582],{"class":644},[635,777,658],{"class":644},[635,779,780],{"class":661},"The issuing bank rejected the charge.",[635,782,696],{"class":644},[635,784,736],{"class":644},[635,786,788,791,793,795,798,800],{"class":637,"line":787},9,[635,789,790],{"class":713},"    fix",[635,792,582],{"class":644},[635,794,658],{"class":644},[635,796,797],{"class":661},"Try a different payment method or contact the bank.",[635,799,696],{"class":644},[635,801,736],{"class":644},[635,803,805],{"class":637,"line":804},10,[635,806,807],{"class":644},"  },\n",[635,809,811,814,816],{"class":637,"line":810},11,[635,812,813],{"class":713},"  insufficient_funds",[635,815,582],{"class":644},[635,817,707],{"class":644},[635,819,821,823,825,827,830,832],{"class":637,"line":820},12,[635,822,724],{"class":713},[635,824,582],{"class":644},[635,826,658],{"class":644},[635,828,829],{"class":661},"STRIPE_INSUFFICIENT_FUNDS",[635,831,696],{"class":644},[635,833,736],{"class":644},[635,835,837,839,841,843],{"class":637,"line":836},13,[635,838,742],{"class":713},[635,840,582],{"class":644},[635,842,748],{"class":747},[635,844,736],{"class":644},[635,846,848,850,852,854,857,859],{"class":637,"line":847},14,[635,849,756],{"class":713},[635,851,582],{"class":644},[635,853,658],{"class":644},[635,855,856],{"class":661},"Card has insufficient funds.",[635,858,696],{"class":644},[635,860,736],{"class":644},[635,862,864,866,868,870,873,875],{"class":637,"line":863},15,[635,865,773],{"class":713},[635,867,582],{"class":644},[635,869,658],{"class":644},[635,871,872],{"class":661},"The card balance does not cover this charge.",[635,874,696],{"class":644},[635,876,736],{"class":644},[635,878,880,882,884,886,889,891],{"class":637,"line":879},16,[635,881,790],{"class":713},[635,883,582],{"class":644},[635,885,658],{"class":644},[635,887,888],{"class":661},"Try a different card or use a smaller amount.",[635,890,696],{"class":644},[635,892,736],{"class":644},[635,894,896],{"class":637,"line":895},17,[635,897,807],{"class":644},[635,899,901],{"class":637,"line":900},18,[635,902,904],{"class":903},"sHwdD","  \u002F\u002F ... more entries ...\n",[635,906,908,911,914,916],{"class":637,"line":907},19,[635,909,910],{"class":644},"}",[635,912,913],{"class":641}," as",[635,915,681],{"class":680},[635,917,918],{"class":648},")\n",[635,920,922],{"class":637,"line":921},20,[635,923,671],{"emptyLinePlaceholder":670},[635,925,927,930,933,935,937,939],{"class":637,"line":926},21,[635,928,929],{"class":680},"declare",[635,931,932],{"class":680}," module",[635,934,658],{"class":644},[635,936,615],{"class":661},[635,938,696],{"class":644},[635,940,707],{"class":644},[635,942,944,947,951],{"class":637,"line":943},22,[635,945,946],{"class":680},"  interface",[635,948,950],{"class":949},"sBMFI"," RegisteredErrorCatalogs",[635,952,707],{"class":644},[635,954,956,959,961,964],{"class":637,"line":955},23,[635,957,958],{"class":713},"    stripe",[635,960,582],{"class":644},[635,962,963],{"class":644}," typeof",[635,965,966],{"class":648}," stripeErrors\n",[635,968,970],{"class":637,"line":969},24,[635,971,972],{"class":644},"  }\n",[635,974,976],{"class":637,"line":975},25,[635,977,978],{"class":644},"}\n",[553,980,981,982,985,986,989],{},"The ",[566,983,984],{},"as const"," is what makes the catalog keys propagate as a string literal union into ",[566,987,988],{},"createError('stripe.card_declined' | ...)",".",[553,991,981,992,995,996,999],{},[566,993,994],{},"declare module 'evlog'"," block registers the catalog globally — once a consumer imports your package, every call to ",[566,997,998],{},"createError()"," in their codebase autocompletes your catalog's entries.",[600,1001,1003],{"id":1002},"package-layout","Package layout",[553,1005,1006,1007,1010],{},"A minimal ",[566,1008,1009],{},"package.json"," for a catalog package:",[625,1012,1016],{"className":1013,"code":1014,"filename":1009,"language":1015,"meta":631,"style":631},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"name\": \"@my-org\u002Fevlog-stripe-errors\",\n  \"version\": \"0.1.0\",\n  \"type\": \"module\",\n  \"main\": \".\u002Fdist\u002Findex.mjs\",\n  \"types\": \".\u002Fdist\u002Findex.d.mts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \".\u002Fdist\u002Findex.d.mts\",\n      \"import\": \".\u002Fdist\u002Findex.mjs\"\n    }\n  },\n  \"files\": [\"dist\"],\n  \"peerDependencies\": {\n    \"evlog\": \"^2\"\n  },\n  \"devDependencies\": {\n    \"evlog\": \"^2\",\n    \"tsdown\": \"^0.21\",\n    \"typescript\": \"^6\"\n  }\n}\n","json",[566,1017,1018,1023,1046,1066,1085,1105,1125,1138,1151,1170,1187,1192,1196,1220,1233,1250,1254,1267,1285,1305,1323,1327],{"__ignoreMap":631},[635,1019,1020],{"class":637,"line":638},[635,1021,1022],{"class":644},"{\n",[635,1024,1025,1028,1031,1034,1036,1039,1042,1044],{"class":637,"line":667},[635,1026,1027],{"class":644},"  \"",[635,1029,1030],{"class":680},"name",[635,1032,1033],{"class":644},"\"",[635,1035,582],{"class":644},[635,1037,1038],{"class":644}," \"",[635,1040,1041],{"class":661},"@my-org\u002Fevlog-stripe-errors",[635,1043,1033],{"class":644},[635,1045,736],{"class":644},[635,1047,1048,1050,1053,1055,1057,1059,1062,1064],{"class":637,"line":674},[635,1049,1027],{"class":644},[635,1051,1052],{"class":680},"version",[635,1054,1033],{"class":644},[635,1056,582],{"class":644},[635,1058,1038],{"class":644},[635,1060,1061],{"class":661},"0.1.0",[635,1063,1033],{"class":644},[635,1065,736],{"class":644},[635,1067,1068,1070,1073,1075,1077,1079,1081,1083],{"class":637,"line":710},[635,1069,1027],{"class":644},[635,1071,1072],{"class":680},"type",[635,1074,1033],{"class":644},[635,1076,582],{"class":644},[635,1078,1038],{"class":644},[635,1080,622],{"class":661},[635,1082,1033],{"class":644},[635,1084,736],{"class":644},[635,1086,1087,1089,1092,1094,1096,1098,1101,1103],{"class":637,"line":721},[635,1088,1027],{"class":644},[635,1090,1091],{"class":680},"main",[635,1093,1033],{"class":644},[635,1095,582],{"class":644},[635,1097,1038],{"class":644},[635,1099,1100],{"class":661},".\u002Fdist\u002Findex.mjs",[635,1102,1033],{"class":644},[635,1104,736],{"class":644},[635,1106,1107,1109,1112,1114,1116,1118,1121,1123],{"class":637,"line":739},[635,1108,1027],{"class":644},[635,1110,1111],{"class":680},"types",[635,1113,1033],{"class":644},[635,1115,582],{"class":644},[635,1117,1038],{"class":644},[635,1119,1120],{"class":661},".\u002Fdist\u002Findex.d.mts",[635,1122,1033],{"class":644},[635,1124,736],{"class":644},[635,1126,1127,1129,1132,1134,1136],{"class":637,"line":753},[635,1128,1027],{"class":644},[635,1130,1131],{"class":680},"exports",[635,1133,1033],{"class":644},[635,1135,582],{"class":644},[635,1137,707],{"class":644},[635,1139,1140,1143,1145,1147,1149],{"class":637,"line":770},[635,1141,1142],{"class":644},"    \"",[635,1144,989],{"class":949},[635,1146,1033],{"class":644},[635,1148,582],{"class":644},[635,1150,707],{"class":644},[635,1152,1153,1156,1158,1160,1162,1164,1166,1168],{"class":637,"line":787},[635,1154,1155],{"class":644},"      \"",[635,1157,1111],{"class":747},[635,1159,1033],{"class":644},[635,1161,582],{"class":644},[635,1163,1038],{"class":644},[635,1165,1120],{"class":661},[635,1167,1033],{"class":644},[635,1169,736],{"class":644},[635,1171,1172,1174,1176,1178,1180,1182,1184],{"class":637,"line":804},[635,1173,1155],{"class":644},[635,1175,576],{"class":747},[635,1177,1033],{"class":644},[635,1179,582],{"class":644},[635,1181,1038],{"class":644},[635,1183,1100],{"class":661},[635,1185,1186],{"class":644},"\"\n",[635,1188,1189],{"class":637,"line":810},[635,1190,1191],{"class":644},"    }\n",[635,1193,1194],{"class":637,"line":820},[635,1195,807],{"class":644},[635,1197,1198,1200,1203,1205,1207,1210,1212,1215,1217],{"class":637,"line":836},[635,1199,1027],{"class":644},[635,1201,1202],{"class":680},"files",[635,1204,1033],{"class":644},[635,1206,582],{"class":644},[635,1208,1209],{"class":644}," [",[635,1211,1033],{"class":644},[635,1213,1214],{"class":661},"dist",[635,1216,1033],{"class":644},[635,1218,1219],{"class":644},"],\n",[635,1221,1222,1224,1227,1229,1231],{"class":637,"line":847},[635,1223,1027],{"class":644},[635,1225,1226],{"class":680},"peerDependencies",[635,1228,1033],{"class":644},[635,1230,582],{"class":644},[635,1232,707],{"class":644},[635,1234,1235,1237,1239,1241,1243,1245,1248],{"class":637,"line":863},[635,1236,1142],{"class":644},[635,1238,615],{"class":949},[635,1240,1033],{"class":644},[635,1242,582],{"class":644},[635,1244,1038],{"class":644},[635,1246,1247],{"class":661},"^2",[635,1249,1186],{"class":644},[635,1251,1252],{"class":637,"line":879},[635,1253,807],{"class":644},[635,1255,1256,1258,1261,1263,1265],{"class":637,"line":895},[635,1257,1027],{"class":644},[635,1259,1260],{"class":680},"devDependencies",[635,1262,1033],{"class":644},[635,1264,582],{"class":644},[635,1266,707],{"class":644},[635,1268,1269,1271,1273,1275,1277,1279,1281,1283],{"class":637,"line":900},[635,1270,1142],{"class":644},[635,1272,615],{"class":949},[635,1274,1033],{"class":644},[635,1276,582],{"class":644},[635,1278,1038],{"class":644},[635,1280,1247],{"class":661},[635,1282,1033],{"class":644},[635,1284,736],{"class":644},[635,1286,1287,1289,1292,1294,1296,1298,1301,1303],{"class":637,"line":907},[635,1288,1142],{"class":644},[635,1290,1291],{"class":949},"tsdown",[635,1293,1033],{"class":644},[635,1295,582],{"class":644},[635,1297,1038],{"class":644},[635,1299,1300],{"class":661},"^0.21",[635,1302,1033],{"class":644},[635,1304,736],{"class":644},[635,1306,1307,1309,1312,1314,1316,1318,1321],{"class":637,"line":921},[635,1308,1142],{"class":644},[635,1310,1311],{"class":949},"typescript",[635,1313,1033],{"class":644},[635,1315,582],{"class":644},[635,1317,1038],{"class":644},[635,1319,1320],{"class":661},"^6",[635,1322,1186],{"class":644},[635,1324,1325],{"class":637,"line":926},[635,1326,972],{"class":644},[635,1328,1329],{"class":637,"line":943},[635,1330,978],{"class":644},[553,1332,1333,1334,1336],{},"evlog goes in ",[566,1335,1226],{}," — the consumer brings their version, the catalog just imports types from it.",[553,1338,1339,1340,1345,1346,1349,1350,1353],{},"Build with ",[557,1341,1291],{"href":1342,"rel":1343},"https:\u002F\u002Fgithub.com\u002Fsxzz\u002Ftsdown",[1344],"nofollow"," (or any bundler that emits dual ",[566,1347,1348],{},".mjs"," + ",[566,1351,1352],{},".d.mts","):",[625,1355,1358],{"className":627,"code":1356,"filename":1357,"language":630,"meta":631,"style":631},"import { defineConfig } from 'tsdown'\n\nexport default defineConfig({\n  entry: { 'index': 'src\u002Findex.ts' },\n  format: 'esm',\n  dts: true,\n  external: ['evlog'],\n})\n","tsdown.config.ts",[566,1359,1360,1379,1383,1396,1423,1439,1452,1472],{"__ignoreMap":631},[635,1361,1362,1364,1366,1369,1371,1373,1375,1377],{"class":637,"line":638},[635,1363,576],{"class":641},[635,1365,645],{"class":644},[635,1367,1368],{"class":648}," defineConfig",[635,1370,652],{"class":644},[635,1372,655],{"class":641},[635,1374,658],{"class":644},[635,1376,1291],{"class":661},[635,1378,664],{"class":644},[635,1380,1381],{"class":637,"line":667},[635,1382,671],{"emptyLinePlaceholder":670},[635,1384,1385,1387,1390,1392,1394],{"class":637,"line":674},[635,1386,677],{"class":641},[635,1388,1389],{"class":641}," default",[635,1391,1368],{"class":690},[635,1393,693],{"class":648},[635,1395,1022],{"class":644},[635,1397,1398,1401,1403,1405,1407,1410,1412,1414,1416,1418,1420],{"class":637,"line":710},[635,1399,1400],{"class":713},"  entry",[635,1402,582],{"class":644},[635,1404,645],{"class":644},[635,1406,658],{"class":644},[635,1408,1409],{"class":713},"index",[635,1411,696],{"class":644},[635,1413,582],{"class":644},[635,1415,658],{"class":644},[635,1417,629],{"class":661},[635,1419,696],{"class":644},[635,1421,1422],{"class":644}," },\n",[635,1424,1425,1428,1430,1432,1435,1437],{"class":637,"line":721},[635,1426,1427],{"class":713},"  format",[635,1429,582],{"class":644},[635,1431,658],{"class":644},[635,1433,1434],{"class":661},"esm",[635,1436,696],{"class":644},[635,1438,736],{"class":644},[635,1440,1441,1444,1446,1450],{"class":637,"line":739},[635,1442,1443],{"class":713},"  dts",[635,1445,582],{"class":644},[635,1447,1449],{"class":1448},"sfNiH"," true",[635,1451,736],{"class":644},[635,1453,1454,1457,1459,1461,1463,1465,1467,1470],{"class":637,"line":753},[635,1455,1456],{"class":713},"  external",[635,1458,582],{"class":644},[635,1460,1209],{"class":648},[635,1462,696],{"class":644},[635,1464,615],{"class":661},[635,1466,696],{"class":644},[635,1468,1469],{"class":648},"]",[635,1471,736],{"class":644},[635,1473,1474,1476],{"class":637,"line":770},[635,1475,910],{"class":644},[635,1477,918],{"class":648},[600,1479,1481],{"id":1480},"consuming-the-package","Consuming the package",[553,1483,1484],{},"Downstream apps install and import — no extra wiring beyond the existing evlog setup:",[625,1486,1490],{"className":1487,"code":1488,"language":1489,"meta":631,"style":631},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm add @my-org\u002Fevlog-stripe-errors\n","bash",[566,1491,1492],{"__ignoreMap":631},[635,1493,1494,1497,1500],{"class":637,"line":638},[635,1495,1496],{"class":949},"pnpm",[635,1498,1499],{"class":661}," add",[635,1501,1502],{"class":661}," @my-org\u002Fevlog-stripe-errors\n",[625,1504,1506],{"className":627,"code":1505,"language":630,"meta":631,"style":631},"import '@my-org\u002Fevlog-stripe-errors'  \u002F\u002F side-effect: registers the catalog\nimport { createError } from 'evlog'\n\nthrow createError('stripe.card_declined')\n\u002F\u002F                 ^^^^^^^^^^^^^^^^^^^^^^^\n\u002F\u002F autocompletes from the package\n",[566,1507,1508,1521,1540,1544,1562,1567],{"__ignoreMap":631},[635,1509,1510,1512,1514,1516,1518],{"class":637,"line":638},[635,1511,576],{"class":641},[635,1513,658],{"class":644},[635,1515,1041],{"class":661},[635,1517,696],{"class":644},[635,1519,1520],{"class":903},"  \u002F\u002F side-effect: registers the catalog\n",[635,1522,1523,1525,1527,1530,1532,1534,1536,1538],{"class":637,"line":667},[635,1524,576],{"class":641},[635,1526,645],{"class":644},[635,1528,1529],{"class":648}," createError",[635,1531,652],{"class":644},[635,1533,655],{"class":641},[635,1535,658],{"class":644},[635,1537,615],{"class":661},[635,1539,664],{"class":644},[635,1541,1542],{"class":637,"line":674},[635,1543,671],{"emptyLinePlaceholder":670},[635,1545,1546,1549,1551,1553,1555,1558,1560],{"class":637,"line":710},[635,1547,1548],{"class":641},"throw",[635,1550,1529],{"class":690},[635,1552,693],{"class":648},[635,1554,696],{"class":644},[635,1556,1557],{"class":661},"stripe.card_declined",[635,1559,696],{"class":644},[635,1561,918],{"class":648},[635,1563,1564],{"class":637,"line":721},[635,1565,1566],{"class":903},"\u002F\u002F                 ^^^^^^^^^^^^^^^^^^^^^^^\n",[635,1568,1569],{"class":637,"line":739},[635,1570,1571],{"class":903},"\u002F\u002F autocompletes from the package\n",[553,1573,1574,1575,1578],{},"Because the augmentation runs at type-check time, the consumer doesn't even need to call ",[566,1576,1577],{},"defineErrorCatalog"," themselves — the import is the registration.",[553,1580,1581,1582,1584,1585,1588,1589,1584,1592,582],{},"For audit catalogs the pattern is identical — replace ",[566,1583,1577],{}," with ",[566,1586,1587],{},"defineAuditCatalog"," and ",[566,1590,1591],{},"RegisteredErrorCatalogs",[566,1593,1594],{},"RegisteredAuditCatalogs",[625,1596,1598],{"className":627,"code":1597,"language":630,"meta":631,"style":631},"import { defineAuditCatalog } from 'evlog'\n\nexport const awsAudit = defineAuditCatalog('aws', {\n  iam_role_assumed: {\n    actor: 'service',\n    target: 'aws.iam.role',\n    severity: 'info',\n  },\n  s3_bucket_deleted: {\n    actor: 'user',\n    target: 'aws.s3.bucket',\n    severity: 'high',\n  },\n} as const)\n\ndeclare module 'evlog' {\n  interface RegisteredAuditCatalogs {\n    aws: typeof awsAudit\n  }\n}\n",[566,1599,1600,1619,1623,1649,1658,1674,1690,1706,1710,1719,1734,1749,1764,1768,1778,1782,1796,1805,1817,1821],{"__ignoreMap":631},[635,1601,1602,1604,1606,1609,1611,1613,1615,1617],{"class":637,"line":638},[635,1603,576],{"class":641},[635,1605,645],{"class":644},[635,1607,1608],{"class":648}," defineAuditCatalog",[635,1610,652],{"class":644},[635,1612,655],{"class":641},[635,1614,658],{"class":644},[635,1616,615],{"class":661},[635,1618,664],{"class":644},[635,1620,1621],{"class":637,"line":667},[635,1622,671],{"emptyLinePlaceholder":670},[635,1624,1625,1627,1629,1632,1634,1636,1638,1640,1643,1645,1647],{"class":637,"line":674},[635,1626,677],{"class":641},[635,1628,681],{"class":680},[635,1630,1631],{"class":648}," awsAudit ",[635,1633,687],{"class":644},[635,1635,1608],{"class":690},[635,1637,693],{"class":648},[635,1639,696],{"class":644},[635,1641,1642],{"class":661},"aws",[635,1644,696],{"class":644},[635,1646,704],{"class":644},[635,1648,707],{"class":644},[635,1650,1651,1654,1656],{"class":637,"line":710},[635,1652,1653],{"class":713},"  iam_role_assumed",[635,1655,582],{"class":644},[635,1657,707],{"class":644},[635,1659,1660,1663,1665,1667,1670,1672],{"class":637,"line":721},[635,1661,1662],{"class":713},"    actor",[635,1664,582],{"class":644},[635,1666,658],{"class":644},[635,1668,1669],{"class":661},"service",[635,1671,696],{"class":644},[635,1673,736],{"class":644},[635,1675,1676,1679,1681,1683,1686,1688],{"class":637,"line":739},[635,1677,1678],{"class":713},"    target",[635,1680,582],{"class":644},[635,1682,658],{"class":644},[635,1684,1685],{"class":661},"aws.iam.role",[635,1687,696],{"class":644},[635,1689,736],{"class":644},[635,1691,1692,1695,1697,1699,1702,1704],{"class":637,"line":753},[635,1693,1694],{"class":713},"    severity",[635,1696,582],{"class":644},[635,1698,658],{"class":644},[635,1700,1701],{"class":661},"info",[635,1703,696],{"class":644},[635,1705,736],{"class":644},[635,1707,1708],{"class":637,"line":770},[635,1709,807],{"class":644},[635,1711,1712,1715,1717],{"class":637,"line":787},[635,1713,1714],{"class":713},"  s3_bucket_deleted",[635,1716,582],{"class":644},[635,1718,707],{"class":644},[635,1720,1721,1723,1725,1727,1730,1732],{"class":637,"line":804},[635,1722,1662],{"class":713},[635,1724,582],{"class":644},[635,1726,658],{"class":644},[635,1728,1729],{"class":661},"user",[635,1731,696],{"class":644},[635,1733,736],{"class":644},[635,1735,1736,1738,1740,1742,1745,1747],{"class":637,"line":810},[635,1737,1678],{"class":713},[635,1739,582],{"class":644},[635,1741,658],{"class":644},[635,1743,1744],{"class":661},"aws.s3.bucket",[635,1746,696],{"class":644},[635,1748,736],{"class":644},[635,1750,1751,1753,1755,1757,1760,1762],{"class":637,"line":820},[635,1752,1694],{"class":713},[635,1754,582],{"class":644},[635,1756,658],{"class":644},[635,1758,1759],{"class":661},"high",[635,1761,696],{"class":644},[635,1763,736],{"class":644},[635,1765,1766],{"class":637,"line":836},[635,1767,807],{"class":644},[635,1769,1770,1772,1774,1776],{"class":637,"line":847},[635,1771,910],{"class":644},[635,1773,913],{"class":641},[635,1775,681],{"class":680},[635,1777,918],{"class":648},[635,1779,1780],{"class":637,"line":863},[635,1781,671],{"emptyLinePlaceholder":670},[635,1783,1784,1786,1788,1790,1792,1794],{"class":637,"line":879},[635,1785,929],{"class":680},[635,1787,932],{"class":680},[635,1789,658],{"class":644},[635,1791,615],{"class":661},[635,1793,696],{"class":644},[635,1795,707],{"class":644},[635,1797,1798,1800,1803],{"class":637,"line":895},[635,1799,946],{"class":680},[635,1801,1802],{"class":949}," RegisteredAuditCatalogs",[635,1804,707],{"class":644},[635,1806,1807,1810,1812,1814],{"class":637,"line":900},[635,1808,1809],{"class":713},"    aws",[635,1811,582],{"class":644},[635,1813,963],{"class":644},[635,1815,1816],{"class":648}," awsAudit\n",[635,1818,1819],{"class":637,"line":907},[635,1820,972],{"class":644},[635,1822,1823],{"class":637,"line":921},[635,1824,978],{"class":644},[600,1826,1828],{"id":1827},"why-bother","Why bother",[553,1830,1831],{},"A catalog package consolidates three things:",[608,1833,1834,1846,1862],{},[587,1835,1836,1839,1840,569,1842,1845],{},[579,1837,1838],{},"Stable identifiers"," — the same ",[566,1841,566],{},[566,1843,1844],{},"action"," lives in one repo, not duplicated across services",[587,1847,1848,1851,1852,560,1855,560,1858,1861],{},[579,1849,1850],{},"Documented errors \u002F actions"," — ",[566,1853,1854],{},"why",[566,1856,1857],{},"fix",[566,1859,1860],{},"severity"," ride along with the type",[587,1863,1864,1867],{},[579,1865,1866],{},"Type-level discoverability"," — consumers see every supported entry in autocomplete",[553,1869,1870,1871,1873],{},"When the catalog grows or evolves (a new error code is added, a ",[566,1872,1857],{}," text is improved), every consuming app picks it up by bumping the version. No string-based registry to keep in sync.",[600,1875,1877],{"id":1876},"real-examples-to-build","Real examples to build",[584,1879,1880,1886,1891,1897,1903],{},[587,1881,1882,1885],{},[566,1883,1884],{},"@my-org\u002Fevlog-rfc7807"," — error catalog matching RFC 7807 problem types",[587,1887,1888,1890],{},[566,1889,1041],{}," — every code returned by Stripe APIs",[587,1892,1893,1896],{},[566,1894,1895],{},"@my-org\u002Fevlog-aws-audit"," — AWS-style audit actions for compliance",[587,1898,1899,1902],{},[566,1900,1901],{},"@my-org\u002Fevlog-better-auth-audit"," — audit catalog for Better Auth flows",[587,1904,1905,1908],{},[566,1906,1907],{},"@my-org\u002Fevlog-shopify-errors"," — translated Shopify error responses",[553,1910,1911],{},"The pattern is the same — pick a domain, encode its identifiers as a catalog, ship it.",[1913,1914,1915],"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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}",{"title":631,"searchDepth":667,"depth":667,"links":1917},[1918,1919,1920,1921,1922],{"id":602,"depth":667,"text":603},{"id":1002,"depth":667,"text":1003},{"id":1480,"depth":667,"text":1481},{"id":1827,"depth":667,"text":1828},{"id":1876,"depth":667,"text":1877},"Package an error catalog or audit catalog as a reusable npm module — `@my-org\u002Fevlog-stripe-errors`, `@my-org\u002Fevlog-aws-audit`, etc.","md",null,{},{"title":383,"icon":381},{"title":383,"description":1923},"rmF7Qaf1dYIIkYwB2wdKl7xrgcgnDSsWjyymShpms-o",[1931,1933],{"title":41,"path":379,"stem":380,"description":1932,"icon":381,"children":-1},"Package catalogs, drains, enrichers, and framework integrations as reusable npm libraries — same scaffolding pattern for each, type-level discoverability flows transitively to consumers.",{"title":387,"path":388,"stem":389,"description":1934,"icon":390,"children":-1},"Package a custom drain as a reusable npm library — `@my-org\u002Fevlog-internal-loki`, `@my-org\u002Fevlog-pubsub`, etc. Same scaffolding pattern as catalogs.",1778338250641]