evlog 2.17.0 → 2.19.0

package/README.md

@@ -528,6 +528,38 @@ log.set({ users: { count: 42 } })
 
 See the full [nestjs example](https://github.com/HugoRCD/evlog/tree/main/examples/nestjs) for a complete working project.
 
+## oRPC
+
+```typescript
+// server/orpc.ts
+import { os } from '@orpc/server'
+import { RPCHandler } from '@orpc/server/fetch'
+import { initLogger } from 'evlog'
+import { evlog, withEvlog, type EvlogOrpcContext } from 'evlog/orpc'
+
+initLogger({ env: { service: 'orpc-api' } })
+
+const base = os.$context<EvlogOrpcContext>().use(evlog())
+
+const router = {
+  ping: base.handler(({ context }) => {
+    context.log.set({ pinged: true })
+    return { ok: true }
+  }),
+}
+
+const handler = withEvlog(new RPCHandler(router))
+
+export default async function fetch(request: Request) {
+  const { matched, response } = await handler.handle(request, { prefix: '/rpc' })
+  return matched ? response : new Response('Not Found', { status: 404 })
+}
+```
+
+`withEvlog()` wraps the handler and emits one wide event per request; `os.use(evlog())` exposes `context.log` to procedures and tags each event with the procedure path as `operation`. Use `useLogger()` from `evlog/orpc` to access the logger off-context.
+
+See the full [orpc example](https://github.com/HugoRCD/evlog/tree/main/examples/orpc) for a complete working project.
+
 ## Browser
 
 Use the `log` API on the client side for structured browser logging:
@@ -821,7 +853,7 @@ export default defineNitroPlugin((nitroApp) => {
 Set environment variables:
 
 ```bash
-NUXT_AXIOM_TOKEN=xaat-your-token
+NUXT_AXIOM_API_KEY=xaat-your-token
 NUXT_AXIOM_DATASET=your-dataset
 ```
 
@@ -916,9 +948,69 @@ export default defineNitroPlugin((nitroApp) => {
 Set environment variables:
 
 ```bash
-NUXT_BETTER_STACK_SOURCE_TOKEN=your-source-token
+NUXT_BETTER_STACK_API_KEY=your-source-token
+```
+
+### HyperDX
+
+```typescript
+// server/plugins/evlog-drain.ts
+import { createHyperDXDrain } from 'evlog/hyperdx'
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:drain', createHyperDXDrain())
+})
+```
+
+Set environment variables:
+
+```bash
+NUXT_HYPERDX_API_KEY=your-api-key
+# Optional — defaults to https://in-otel.hyperdx.io
+NUXT_HYPERDX_ENDPOINT=https://in-otel.hyperdx.io
+```
+
+### File System
+
+Write wide events to local NDJSON files (`.evlog/logs/` by default):
+
+```typescript
+// server/plugins/evlog-drain.ts
+import { createFsDrain } from 'evlog/fs'
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:drain', createFsDrain())
+})
+```
+
+Set environment variables:
+
+```bash
+NUXT_EVLOG_FS_DIR=.evlog/logs
 ```
 
+### Memory
+
+In-memory ring buffer — works in any runtime, including Cloudflare Workers:
+
+```typescript
+// server/plugins/evlog-drain.ts
+import { createMemoryDrain } from 'evlog/memory'
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('evlog:drain', createMemoryDrain())
+})
+```
+
+Optional environment variables:
+
+```bash
+NUXT_EVLOG_MEMORY_STORE=default
+NUXT_EVLOG_MEMORY_MAX_EVENTS=1000
+```
+
+Pair with `readMemoryLogs()` for dev-only agent access over HTTP. See the [Memory adapter docs](https://www.evlog.dev/integrate/adapters/self-hosted/memory).
+
 ### Multiple Destinations
 
 Send logs to multiple services:
@@ -1297,6 +1389,7 @@ try {
 | **Hono** | `app.use(evlog())` with `import { evlog } from 'evlog/hono'` ([example](./examples/hono)) |
 | **Fastify** | `app.register(evlog)` with `import { evlog } from 'evlog/fastify'` ([example](./examples/fastify)) |
 | **Elysia** | `.use(evlog())` with `import { evlog } from 'evlog/elysia'` ([example](./examples/elysia)) |
+| **oRPC** | `withEvlog(handler)` + `os.use(evlog())` with `import { evlog, withEvlog } from 'evlog/orpc'` ([example](./examples/orpc)) |
 | **Cloudflare Workers** | Manual setup with `import { initWorkersLogger, createWorkersLogger } from 'evlog/workers'` ([example](./examples/workers)) |
 | **Custom** | Build your own with `import { createMiddlewareLogger } from 'evlog/toolkit'` ([guide](https://evlog.dev/extend/custom-framework)) |
 | **Analog** | Nitro v2 module setup |

package/dist/adapters/axiom.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/axiom.d.ts
 interface BaseAxiomConfig {
   /** Axiom dataset name. */

package/dist/adapters/axiom.mjs

@@ -1,5 +1,5 @@
-import { r as httpPost } from "../http-6umVAKDW.mjs";
-import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-X7_5szSI.mjs";
+import { r as httpPost } from "../http-Bept5EIC.mjs";
+import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-D_fy7m0n.mjs";
 //#region src/adapters/axiom.ts
 const AXIOM_FIELDS = [
 	{

package/dist/adapters/axiom.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"axiom.mjs","names":[],"sources":["../../src/adapters/axiom.ts"],"sourcesContent":["import type { WideEvent } from '../types'\nimport type { ConfigField } from '../shared/config'\nimport { resolveAdapterConfig } from '../shared/config'\nimport { defineHttpDrain } from '../shared/drain'\nimport { httpPost } from '../shared/http'\n\ninterface BaseAxiomConfig {\n  /** Axiom dataset name. */\n  dataset: string\n  /**\n   * Axiom API key.\n   *\n   * @example `xaat-...`\n   */\n  apiKey: string\n  /**\n   * @deprecated Renamed to {@link BaseAxiomConfig.apiKey}. Will be removed in\n   * the next major version. Pass `apiKey` instead.\n   */\n  token?: string\n  /** Organization ID (required for Personal Access Tokens). */\n  orgId?: string\n  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n  /** Number of retry attempts on transient failures. Default: 2 */\n  retries?: number\n}\n\ninterface EdgeAxiomConfig {\n  /**\n   * Edge URL for Axiom ingest/query endpoints.\n   * If no path is provided, uses /v1/ingest/{dataset}.\n   * If a custom path is provided, it is used as-is (trailing slash trimmed).\n   */\n  edgeUrl: string\n  /** Mutually exclusive with edgeUrl. */\n  baseUrl?: never\n}\n\ninterface EndpointAxiomConfig {\n  /** Base URL for Axiom API. Uses /v1/datasets/{dataset}/ingest. */\n  baseUrl?: string\n  /** Mutually exclusive with baseUrl. */\n  edgeUrl?: never\n}\n\nexport type AxiomConfig = BaseAxiomConfig & (EdgeAxiomConfig | EndpointAxiomConfig)\n\ntype ResolvedAxiomConfig = BaseAxiomConfig & {\n  edgeUrl?: string\n  baseUrl?: string\n}\n\nconst AXIOM_FIELDS: ConfigField<ResolvedAxiomConfig>[] = [\n  { key: 'dataset', env: ['NUXT_AXIOM_DATASET', 'AXIOM_DATASET'] },\n  { key: 'apiKey', env: ['NUXT_AXIOM_API_KEY', 'AXIOM_API_KEY'] },\n  // Deprecated env var names — resolved as a fallback for `apiKey` below.\n  { key: 'token', env: ['NUXT_AXIOM_TOKEN', 'AXIOM_TOKEN'] },\n  { key: 'orgId', env: ['NUXT_AXIOM_ORG_ID', 'AXIOM_ORG_ID'] },\n  { key: 'edgeUrl', env: ['NUXT_AXIOM_EDGE_URL', 'AXIOM_EDGE_URL'] },\n  { key: 'baseUrl', env: ['NUXT_AXIOM_URL', 'AXIOM_URL'] },\n  { key: 'timeout' },\n  { key: 'retries' },\n]\n\nlet warnedAboutToken = false\n\nfunction applyApiKeyAlias(config: ResolvedAxiomConfig): ResolvedAxiomConfig {\n  if (!config.apiKey && config.token) {\n    if (!warnedAboutToken) {\n      warnedAboutToken = true\n      console.warn('[evlog/axiom] `token` is deprecated, use `apiKey` instead. (Env: NUXT_AXIOM_TOKEN/AXIOM_TOKEN → NUXT_AXIOM_API_KEY/AXIOM_API_KEY.)')\n    }\n    config.apiKey = config.token\n  }\n  return config\n}\n\n/**\n * Create a drain function for sending logs to Axiom.\n *\n * Configuration priority (highest to lowest):\n * 1. Overrides passed to createAxiomDrain()\n * 2. runtimeConfig.evlog.axiom\n * 3. runtimeConfig.axiom\n * 4. Environment variables: NUXT_AXIOM_API_KEY, AXIOM_API_KEY (or legacy `*_TOKEN`)\n *\n * @example\n * ```ts\n * // Zero config — set NUXT_AXIOM_API_KEY and NUXT_AXIOM_DATASET\n * initLogger({ drain: createAxiomDrain() })\n *\n * // With overrides\n * initLogger({ drain: createAxiomDrain({ dataset: 'my-dataset' }) })\n * ```\n */\nexport function createAxiomDrain(overrides?: Partial<AxiomConfig>) {\n  return defineHttpDrain<AxiomConfig>({\n    name: 'axiom',\n    resolve: async () => {\n      const resolved = await resolveAdapterConfig<ResolvedAxiomConfig>(\n        'axiom',\n        AXIOM_FIELDS,\n        overrides as Partial<ResolvedAxiomConfig>,\n      )\n      const config = applyApiKeyAlias(resolved)\n      if (!config.dataset || !config.apiKey) {\n        console.error('[evlog/axiom] Missing dataset or apiKey. Set NUXT_AXIOM_API_KEY/NUXT_AXIOM_DATASET env vars or pass to createAxiomDrain()')\n        return null\n      }\n      if (config.edgeUrl && config.baseUrl) {\n        console.warn('[evlog/axiom] Both edgeUrl and baseUrl are set. edgeUrl takes precedence for ingest.')\n        delete config.baseUrl\n      }\n      return config as AxiomConfig\n    },\n    encode: (events, config) => {\n      const url = resolveIngestUrl(config)\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.apiKey}`,\n      }\n      if (config.orgId) headers['X-Axiom-Org-Id'] = config.orgId\n      return { url, headers, body: JSON.stringify(events) }\n    },\n  })\n}\n\n/**\n * Send a single event to Axiom.\n */\nexport async function sendToAxiom(event: WideEvent, config: AxiomConfig): Promise<void> {\n  await sendBatchToAxiom([event], config)\n}\n\n/**\n * Send a batch of events to Axiom.\n */\nexport async function sendBatchToAxiom(events: WideEvent[], config: AxiomConfig): Promise<void> {\n  const apiKey = config.apiKey ?? config.token\n  if (!apiKey) {\n    throw new Error('[evlog/axiom] Missing apiKey')\n  }\n  const url = resolveIngestUrl(config)\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'Authorization': `Bearer ${apiKey}`,\n  }\n  if (config.orgId) headers['X-Axiom-Org-Id'] = config.orgId\n  await httpPost({\n    url,\n    headers,\n    body: JSON.stringify(events),\n    timeout: config.timeout ?? 5000,\n    retries: config.retries,\n    label: 'Axiom',\n    source: 'axiom',\n  })\n}\n\nfunction resolveIngestUrl(config: AxiomConfig): string {\n  const encodedDataset = encodeURIComponent(config.dataset)\n\n  if (!config.edgeUrl) {\n    const baseUrl = config.baseUrl ?? 'https://api.axiom.co'\n    return `${baseUrl}/v1/datasets/${encodedDataset}/ingest`\n  }\n\n  try {\n    const parsed = new URL(config.edgeUrl)\n    if (parsed.pathname === '' || parsed.pathname === '/') {\n      parsed.pathname = `/v1/ingest/${encodedDataset}`\n      return parsed.toString()\n    }\n    parsed.pathname = parsed.pathname.replace(/\\/+$/, '')\n    return parsed.toString()\n  } catch {\n    console.warn(`[evlog/axiom] edgeUrl \"${config.edgeUrl}\" is not a valid URL, falling back to string concatenation.`)\n    const trimmed = config.edgeUrl.replace(/\\/+$/, '')\n    return `${trimmed}/v1/ingest/${encodedDataset}`\n  }\n}\n"],"mappings":";;;AAqDA,MAAM,eAAmD;CACvD;EAAE,KAAK;EAAW,KAAK,CAAC,sBAAsB,gBAAgB;EAAE;CAChE;EAAE,KAAK;EAAU,KAAK,CAAC,sBAAsB,gBAAgB;EAAE;CAE/D;EAAE,KAAK;EAAS,KAAK,CAAC,oBAAoB,cAAc;EAAE;CAC1D;EAAE,KAAK;EAAS,KAAK,CAAC,qBAAqB,eAAe;EAAE;CAC5D;EAAE,KAAK;EAAW,KAAK,CAAC,uBAAuB,iBAAiB;EAAE;CAClE;EAAE,KAAK;EAAW,KAAK,CAAC,kBAAkB,YAAY;EAAE;CACxD,EAAE,KAAK,WAAW;CAClB,EAAE,KAAK,WAAW;CACnB;AAED,IAAI,mBAAmB;AAEvB,SAAS,iBAAiB,QAAkD;AAC1E,KAAI,CAAC,OAAO,UAAU,OAAO,OAAO;AAClC,MAAI,CAAC,kBAAkB;AACrB,sBAAmB;AACnB,WAAQ,KAAK,qIAAqI;;AAEpJ,SAAO,SAAS,OAAO;;AAEzB,QAAO;;;;;;;;;;;;;;;;;;;;AAqBT,SAAgB,iBAAiB,WAAkC;AACjE,QAAO,gBAA6B;EAClC,MAAM;EACN,SAAS,YAAY;GAMnB,MAAM,SAAS,iBAAiB,MALT,qBACrB,SACA,cACA,UACD,CACwC;AACzC,OAAI,CAAC,OAAO,WAAW,CAAC,OAAO,QAAQ;AACrC,YAAQ,MAAM,4HAA4H;AAC1I,WAAO;;AAET,OAAI,OAAO,WAAW,OAAO,SAAS;AACpC,YAAQ,KAAK,uFAAuF;AACpG,WAAO,OAAO;;AAEhB,UAAO;;EAET,SAAS,QAAQ,WAAW;GAC1B,MAAM,MAAM,iBAAiB,OAAO;GACpC,MAAM,UAAkC;IACtC,gBAAgB;IAChB,iBAAiB,UAAU,OAAO;IACnC;AACD,OAAI,OAAO,MAAO,SAAQ,oBAAoB,OAAO;AACrD,UAAO;IAAE;IAAK;IAAS,MAAM,KAAK,UAAU,OAAO;IAAE;;EAExD,CAAC;;;;;AAMJ,eAAsB,YAAY,OAAkB,QAAoC;AACtF,OAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO;;;;;AAMzC,eAAsB,iBAAiB,QAAqB,QAAoC;CAC9F,MAAM,SAAS,OAAO,UAAU,OAAO;AACvC,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,+BAA+B;CAEjD,MAAM,MAAM,iBAAiB,OAAO;CACpC,MAAM,UAAkC;EACtC,gBAAgB;EAChB,iBAAiB,UAAU;EAC5B;AACD,KAAI,OAAO,MAAO,SAAQ,oBAAoB,OAAO;AACrD,OAAM,SAAS;EACb;EACA;EACA,MAAM,KAAK,UAAU,OAAO;EAC5B,SAAS,OAAO,WAAW;EAC3B,SAAS,OAAO;EAChB,OAAO;EACP,QAAQ;EACT,CAAC;;AAGJ,SAAS,iBAAiB,QAA6B;CACrD,MAAM,iBAAiB,mBAAmB,OAAO,QAAQ;AAEzD,KAAI,CAAC,OAAO,QAEV,QAAO,GADS,OAAO,WAAW,uBAChB,eAAe,eAAe;AAGlD,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,OAAO,QAAQ;AACtC,MAAI,OAAO,aAAa,MAAM,OAAO,aAAa,KAAK;AACrD,UAAO,WAAW,cAAc;AAChC,UAAO,OAAO,UAAU;;AAE1B,SAAO,WAAW,OAAO,SAAS,QAAQ,QAAQ,GAAG;AACrD,SAAO,OAAO,UAAU;SAClB;AACN,UAAQ,KAAK,0BAA0B,OAAO,QAAQ,6DAA6D;AAEnH,SAAO,GADS,OAAO,QAAQ,QAAQ,QAAQ,GAC9B,CAAC,aAAa"}
+{"version":3,"file":"axiom.mjs","names":[],"sources":["../../src/adapters/axiom.ts"],"sourcesContent":["import type { WideEvent } from '../types'\nimport type { ConfigField } from '../shared/config'\nimport { resolveAdapterConfig } from '../shared/config'\nimport { defineHttpDrain } from '../shared/drain'\nimport { httpPost } from '../shared/http'\n\ninterface BaseAxiomConfig {\n  /** Axiom dataset name. */\n  dataset: string\n  /**\n   * Axiom API key.\n   *\n   * @example `xaat-...`\n   */\n  apiKey: string\n  /**\n   * @deprecated Renamed to {@link BaseAxiomConfig.apiKey}. Will be removed in\n   * the next major version. Pass `apiKey` instead.\n   */\n  token?: string\n  /** Organization ID (required for Personal Access Tokens). */\n  orgId?: string\n  /** Request timeout in milliseconds. Default: 5000 */\n  timeout?: number\n  /** Number of retry attempts on transient failures. Default: 2 */\n  retries?: number\n}\n\ninterface EdgeAxiomConfig {\n  /**\n   * Edge URL for Axiom ingest/query endpoints.\n   * If no path is provided, uses /v1/ingest/{dataset}.\n   * If a custom path is provided, it is used as-is (trailing slash trimmed).\n   */\n  edgeUrl: string\n  /** Mutually exclusive with edgeUrl. */\n  baseUrl?: never\n}\n\ninterface EndpointAxiomConfig {\n  /** Base URL for Axiom API. Uses /v1/datasets/{dataset}/ingest. */\n  baseUrl?: string\n  /** Mutually exclusive with baseUrl. */\n  edgeUrl?: never\n}\n\nexport type AxiomConfig = BaseAxiomConfig & (EdgeAxiomConfig | EndpointAxiomConfig)\n\ntype ResolvedAxiomConfig = BaseAxiomConfig & {\n  edgeUrl?: string\n  baseUrl?: string\n}\n\nconst AXIOM_FIELDS: ConfigField<ResolvedAxiomConfig>[] = [\n  { key: 'dataset', env: ['NUXT_AXIOM_DATASET', 'AXIOM_DATASET'] },\n  { key: 'apiKey', env: ['NUXT_AXIOM_API_KEY', 'AXIOM_API_KEY'] },\n  // Deprecated env var names — resolved as a fallback for `apiKey` below.\n  { key: 'token', env: ['NUXT_AXIOM_TOKEN', 'AXIOM_TOKEN'] },\n  { key: 'orgId', env: ['NUXT_AXIOM_ORG_ID', 'AXIOM_ORG_ID'] },\n  { key: 'edgeUrl', env: ['NUXT_AXIOM_EDGE_URL', 'AXIOM_EDGE_URL'] },\n  { key: 'baseUrl', env: ['NUXT_AXIOM_URL', 'AXIOM_URL'] },\n  { key: 'timeout' },\n  { key: 'retries' },\n]\n\nlet warnedAboutToken = false\n\nfunction applyApiKeyAlias(config: Partial<ResolvedAxiomConfig>): Partial<ResolvedAxiomConfig> {\n  if (!config.apiKey && config.token) {\n    if (!warnedAboutToken) {\n      warnedAboutToken = true\n      console.warn('[evlog/axiom] `token` is deprecated, use `apiKey` instead. (Env: NUXT_AXIOM_TOKEN/AXIOM_TOKEN → NUXT_AXIOM_API_KEY/AXIOM_API_KEY.)')\n    }\n    config.apiKey = config.token\n  }\n  return config\n}\n\n/**\n * Create a drain function for sending logs to Axiom.\n *\n * Configuration priority (highest to lowest):\n * 1. Overrides passed to createAxiomDrain()\n * 2. runtimeConfig.evlog.axiom\n * 3. runtimeConfig.axiom\n * 4. Environment variables: NUXT_AXIOM_API_KEY, AXIOM_API_KEY (or legacy `*_TOKEN`)\n *\n * @example\n * ```ts\n * // Zero config — set NUXT_AXIOM_API_KEY and NUXT_AXIOM_DATASET\n * initLogger({ drain: createAxiomDrain() })\n *\n * // With overrides\n * initLogger({ drain: createAxiomDrain({ dataset: 'my-dataset' }) })\n * ```\n */\nexport function createAxiomDrain(overrides?: Partial<AxiomConfig>) {\n  return defineHttpDrain<AxiomConfig>({\n    name: 'axiom',\n    resolve: async () => {\n      const resolved = await resolveAdapterConfig<ResolvedAxiomConfig>(\n        'axiom',\n        AXIOM_FIELDS,\n        overrides as Partial<ResolvedAxiomConfig>,\n      )\n      const config = applyApiKeyAlias(resolved)\n      if (!config.dataset || !config.apiKey) {\n        console.error('[evlog/axiom] Missing dataset or apiKey. Set NUXT_AXIOM_API_KEY/NUXT_AXIOM_DATASET env vars or pass to createAxiomDrain()')\n        return null\n      }\n      if (config.edgeUrl && config.baseUrl) {\n        console.warn('[evlog/axiom] Both edgeUrl and baseUrl are set. edgeUrl takes precedence for ingest.')\n        delete config.baseUrl\n      }\n      return config as AxiomConfig\n    },\n    encode: (events, config) => {\n      const url = resolveIngestUrl(config)\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.apiKey}`,\n      }\n      if (config.orgId) headers['X-Axiom-Org-Id'] = config.orgId\n      return { url, headers, body: JSON.stringify(events) }\n    },\n  })\n}\n\n/**\n * Send a single event to Axiom.\n */\nexport async function sendToAxiom(event: WideEvent, config: AxiomConfig): Promise<void> {\n  await sendBatchToAxiom([event], config)\n}\n\n/**\n * Send a batch of events to Axiom.\n */\nexport async function sendBatchToAxiom(events: WideEvent[], config: AxiomConfig): Promise<void> {\n  const apiKey = config.apiKey ?? config.token\n  if (!apiKey) {\n    throw new Error('[evlog/axiom] Missing apiKey')\n  }\n  const url = resolveIngestUrl(config)\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'Authorization': `Bearer ${apiKey}`,\n  }\n  if (config.orgId) headers['X-Axiom-Org-Id'] = config.orgId\n  await httpPost({\n    url,\n    headers,\n    body: JSON.stringify(events),\n    timeout: config.timeout ?? 5000,\n    retries: config.retries,\n    label: 'Axiom',\n    source: 'axiom',\n  })\n}\n\nfunction resolveIngestUrl(config: AxiomConfig): string {\n  const encodedDataset = encodeURIComponent(config.dataset)\n\n  if (!config.edgeUrl) {\n    const baseUrl = config.baseUrl ?? 'https://api.axiom.co'\n    return `${baseUrl}/v1/datasets/${encodedDataset}/ingest`\n  }\n\n  try {\n    const parsed = new URL(config.edgeUrl)\n    if (parsed.pathname === '' || parsed.pathname === '/') {\n      parsed.pathname = `/v1/ingest/${encodedDataset}`\n      return parsed.toString()\n    }\n    parsed.pathname = parsed.pathname.replace(/\\/+$/, '')\n    return parsed.toString()\n  } catch {\n    console.warn(`[evlog/axiom] edgeUrl \"${config.edgeUrl}\" is not a valid URL, falling back to string concatenation.`)\n    const trimmed = config.edgeUrl.replace(/\\/+$/, '')\n    return `${trimmed}/v1/ingest/${encodedDataset}`\n  }\n}\n"],"mappings":";;;AAqDA,MAAM,eAAmD;CACvD;EAAE,KAAK;EAAW,KAAK,CAAC,sBAAsB,gBAAgB;EAAE;CAChE;EAAE,KAAK;EAAU,KAAK,CAAC,sBAAsB,gBAAgB;EAAE;CAE/D;EAAE,KAAK;EAAS,KAAK,CAAC,oBAAoB,cAAc;EAAE;CAC1D;EAAE,KAAK;EAAS,KAAK,CAAC,qBAAqB,eAAe;EAAE;CAC5D;EAAE,KAAK;EAAW,KAAK,CAAC,uBAAuB,iBAAiB;EAAE;CAClE;EAAE,KAAK;EAAW,KAAK,CAAC,kBAAkB,YAAY;EAAE;CACxD,EAAE,KAAK,WAAW;CAClB,EAAE,KAAK,WAAW;CACnB;AAED,IAAI,mBAAmB;AAEvB,SAAS,iBAAiB,QAAoE;AAC5F,KAAI,CAAC,OAAO,UAAU,OAAO,OAAO;AAClC,MAAI,CAAC,kBAAkB;AACrB,sBAAmB;AACnB,WAAQ,KAAK,qIAAqI;;AAEpJ,SAAO,SAAS,OAAO;;AAEzB,QAAO;;;;;;;;;;;;;;;;;;;;AAqBT,SAAgB,iBAAiB,WAAkC;AACjE,QAAO,gBAA6B;EAClC,MAAM;EACN,SAAS,YAAY;GAMnB,MAAM,SAAS,iBAAiB,MALT,qBACrB,SACA,cACA,UACD,CACwC;AACzC,OAAI,CAAC,OAAO,WAAW,CAAC,OAAO,QAAQ;AACrC,YAAQ,MAAM,4HAA4H;AAC1I,WAAO;;AAET,OAAI,OAAO,WAAW,OAAO,SAAS;AACpC,YAAQ,KAAK,uFAAuF;AACpG,WAAO,OAAO;;AAEhB,UAAO;;EAET,SAAS,QAAQ,WAAW;GAC1B,MAAM,MAAM,iBAAiB,OAAO;GACpC,MAAM,UAAkC;IACtC,gBAAgB;IAChB,iBAAiB,UAAU,OAAO;IACnC;AACD,OAAI,OAAO,MAAO,SAAQ,oBAAoB,OAAO;AACrD,UAAO;IAAE;IAAK;IAAS,MAAM,KAAK,UAAU,OAAO;IAAE;;EAExD,CAAC;;;;;AAMJ,eAAsB,YAAY,OAAkB,QAAoC;AACtF,OAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO;;;;;AAMzC,eAAsB,iBAAiB,QAAqB,QAAoC;CAC9F,MAAM,SAAS,OAAO,UAAU,OAAO;AACvC,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,+BAA+B;CAEjD,MAAM,MAAM,iBAAiB,OAAO;CACpC,MAAM,UAAkC;EACtC,gBAAgB;EAChB,iBAAiB,UAAU;EAC5B;AACD,KAAI,OAAO,MAAO,SAAQ,oBAAoB,OAAO;AACrD,OAAM,SAAS;EACb;EACA;EACA,MAAM,KAAK,UAAU,OAAO;EAC5B,SAAS,OAAO,WAAW;EAC3B,SAAS,OAAO;EAChB,OAAO;EACP,QAAQ;EACT,CAAC;;AAGJ,SAAS,iBAAiB,QAA6B;CACrD,MAAM,iBAAiB,mBAAmB,OAAO,QAAQ;AAEzD,KAAI,CAAC,OAAO,QAEV,QAAO,GADS,OAAO,WAAW,uBAChB,eAAe,eAAe;AAGlD,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,OAAO,QAAQ;AACtC,MAAI,OAAO,aAAa,MAAM,OAAO,aAAa,KAAK;AACrD,UAAO,WAAW,cAAc;AAChC,UAAO,OAAO,UAAU;;AAE1B,SAAO,WAAW,OAAO,SAAS,QAAQ,QAAQ,GAAG;AACrD,SAAO,OAAO,UAAU;SAClB;AACN,UAAQ,KAAK,0BAA0B,OAAO,QAAQ,6DAA6D;AAEnH,SAAO,GADS,OAAO,QAAQ,QAAQ,QAAQ,GAC9B,CAAC,aAAa"}

package/dist/adapters/better-stack.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/better-stack.d.ts
 interface BetterStackConfig {
   /** Better Stack API key (replaces deprecated `sourceToken`). */

package/dist/adapters/better-stack.mjs

@@ -1,5 +1,5 @@
-import { r as httpPost } from "../http-6umVAKDW.mjs";
-import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-X7_5szSI.mjs";
+import { r as httpPost } from "../http-Bept5EIC.mjs";
+import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-D_fy7m0n.mjs";
 //#region src/adapters/better-stack.ts
 const BETTER_STACK_FIELDS = [
 	{

package/dist/adapters/datadog.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/datadog.d.ts
 interface DatadogConfig {
   /** Datadog API key with Logs intake permission */

package/dist/adapters/datadog.mjs

@@ -1,5 +1,5 @@
-import { r as httpPost } from "../http-6umVAKDW.mjs";
-import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-X7_5szSI.mjs";
+import { r as httpPost } from "../http-Bept5EIC.mjs";
+import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-D_fy7m0n.mjs";
 //#region src/adapters/datadog.ts
 const DATADOG_FIELDS = [
 	{

package/dist/adapters/fs.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, K as LogLevel, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, X as LogLevel, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/fs.d.ts
 interface FsConfig {
   /** Directory for log files. Default: `.evlog/logs` */

package/dist/adapters/fs.mjs

@@ -1,7 +1,7 @@
-import { i as resolveAdapterConfig, t as defineDrain } from "../drain-X7_5szSI.mjs";
+import { i as resolveAdapterConfig, t as defineDrain } from "../drain-D_fy7m0n.mjs";
 import { join, sep } from "node:path";
-import { appendFile, mkdir, open, readdir, stat, unlink, writeFile } from "node:fs/promises";
 import { createReadStream } from "node:fs";
+import { appendFile, mkdir, open, readdir, stat, unlink, writeFile } from "node:fs/promises";
 import { createInterface } from "node:readline";
 //#region src/adapters/fs.ts
 const FS_FIELDS = [

package/dist/adapters/hyperdx.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 import { OTLPConfig } from "./otlp.mjs";
 
 //#region src/adapters/hyperdx.d.ts

package/dist/adapters/hyperdx.mjs

@@ -1,4 +1,4 @@
-import { i as resolveAdapterConfig, t as defineDrain } from "../drain-X7_5szSI.mjs";
+import { i as resolveAdapterConfig, t as defineDrain } from "../drain-D_fy7m0n.mjs";
 import { sendBatchToOTLP } from "./otlp.mjs";
 //#region src/adapters/hyperdx.ts
 /**

package/dist/adapters/memory.d.mts

@@ -0,0 +1,116 @@
+import { B as DrainContext, X as LogLevel, ft as WideEvent } from "../audit-BUAajsPU.mjs";
+//#region src/adapters/memory.d.ts
+/**
+ * Configuration for the in-memory drain.
+ */
+interface MemoryConfig {
+  /** Named store key. Multiple drains sharing the same key share the same buffer. Default: `'default'` */
+  store: string;
+  /** Maximum number of events to keep in the ring buffer. Oldest events are discarded when the limit is exceeded. Default: `1000` */
+  maxEvents: number;
+}
+/**
+ * Write events directly into the named store. Exported for direct use and
+ * easier testing without going through the drain pipeline.
+ */
+declare function writeToMemory(events: WideEvent[], config: MemoryConfig): void;
+/**
+ * Create a drain that stores wide events in an in-memory ring buffer.
+ *
+ * Works in **any** runtime — including Cloudflare Workers (workerd) — where
+ * the filesystem (`evlog/fs`) is not available. Pair it with a dev-only HTTP
+ * endpoint to let agents retrieve the buffer over HTTP.
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Overrides passed to `createMemoryDrain()`
+ * 2. `runtimeConfig.evlog.memory` / `runtimeConfig.memory` (Nitro)
+ * 3. Environment variables: `NUXT_EVLOG_MEMORY_STORE`, `EVLOG_MEMORY_STORE`,
+ *    `NUXT_EVLOG_MEMORY_MAX_EVENTS`, `EVLOG_MEMORY_MAX_EVENTS`
+ *
+ * @example
+ * ```ts
+ * // Hono + Cloudflare Workers
+ * import { createMemoryDrain, readMemoryLogs } from 'evlog/memory'
+ *
+ * app.use(evlog({ drain: createMemoryDrain() }))
+ *
+ * // Dev-only endpoint for agent retrieval
+ * if (env.NODE_ENV === 'development') {
+ *   app.get('/_evlog/logs', (c) => c.json(readMemoryLogs()))
+ * }
+ * ```
+ */
+declare function createMemoryDrain(overrides?: Partial<MemoryConfig>): (ctx: DrainContext | DrainContext[]) => Promise<void>;
+/** Options accepted by {@link readMemoryLogs}. */
+interface ReadMemoryLogsOptions {
+  /** Named store to read from. Default: `'default'` */
+  store?: string;
+  /** Only include events with `timestamp >= since`. */
+  since?: Date | string;
+  /** Only include events with `timestamp <= until`. */
+  until?: Date | string;
+  /** Filter by log level. */
+  level?: LogLevel | LogLevel[];
+  /** Custom predicate — return `false` to skip the event. */
+  filter?: (event: WideEvent) => boolean;
+  /** Return at most this many of the most-recent matching events. */
+  limit?: number;
+}
+/**
+ * Read events from the named in-memory store. Returns a snapshot of the
+ * buffer with optional filtering, ordered oldest-first.
+ *
+ * @example
+ * ```ts
+ * import { readMemoryLogs } from 'evlog/memory'
+ *
+ * // All events
+ * const events = readMemoryLogs()
+ *
+ * // Errors in the last hour
+ * const errors = readMemoryLogs({
+ *   level: 'error',
+ *   since: new Date(Date.now() - 60 * 60 * 1000),
+ * })
+ *
+ * // Expose as a JSON endpoint
+ * app.get('/_evlog/logs', (c) => c.json(readMemoryLogs({ limit: 200 })))
+ * ```
+ */
+declare function readMemoryLogs(options?: ReadMemoryLogsOptions): WideEvent[];
+/**
+ * Clear all events from a named store (or `'default'`).
+ *
+ * @example
+ * ```ts
+ * clearMemoryLogs()           // clears the default store
+ * clearMemoryLogs('my-store') // clears a named store
+ * ```
+ */
+declare function clearMemoryLogs(store?: string): void;
+/**
+ * Parse a flat query-string object (e.g. from `c.req.query()` in Hono, or
+ * `req.query` in Express) into {@link ReadMemoryLogsOptions} with proper type
+ * coercion.
+ *
+ * This lets agents discover and pass filter parameters through HTTP query
+ * strings directly:
+ *
+ * @example
+ * ```ts
+ * // Hono — zero glue
+ * app.get('/_evlog/logs', (c) =>
+ *   c.json(readMemoryLogs(parseReadMemoryLogsQuery(c.req.query()))))
+ *
+ * // Express
+ * app.get('/_evlog/logs', (req, res) =>
+ *   res.json(readMemoryLogs(parseReadMemoryLogsQuery(req.query as Record<string, string>))))
+ * ```
+ *
+ * Supported query params: `store`, `since`, `until`, `level` (comma-separated),
+ * `limit`. The `filter` predicate cannot be expressed as a query param.
+ */
+declare function parseReadMemoryLogsQuery(query: Record<string, string | string[] | undefined>): ReadMemoryLogsOptions;
+//#endregion
+export { MemoryConfig, ReadMemoryLogsOptions, clearMemoryLogs, createMemoryDrain, parseReadMemoryLogsQuery, readMemoryLogs, writeToMemory };
+//# sourceMappingURL=memory.d.mts.map

package/dist/adapters/memory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.mts","names":[],"sources":["../../src/adapters/memory.ts"],"mappings":";;;;;UAQiB,YAAA;EAAY;EAE3B,KAAA;EAAA;EAEA,SAAA;AAAA;;;;;iBA2Cc,aAAA,CAAc,MAAA,EAAQ,SAAA,IAAa,MAAA,EAAQ,YAAA;;;;;AAmC3D;;;;;;;;;;;;;;;;;;;AAYA;;;iBAZgB,iBAAA,CAAkB,SAAA,GAAY,OAAA,CAAQ,YAAA,KAAa,GAAA,EAAd,YAAA,GAAc,YAAA,OAAA,OAAA;;UAYlD,qBAAA;EAQI;EANnB,KAAA;EAQ0B;EAN1B,KAAA,GAAQ,IAAA;EAFR;EAIA,KAAA,GAAQ,IAAA;EAFA;EAIR,KAAA,GAAQ,QAAA,GAAW,QAAA;EAFX;EAIR,MAAA,IAAU,KAAA,EAAO,SAAA;EAFT;EAIR,KAAA;AAAA;;;;;;AA+BF;;;;;;;;;AAuCA;;;;;AA6BA;;iBApEgB,cAAA,CAAe,OAAA,GAAS,qBAAA,GAA6B,SAAA;;;;;;;;;;iBAuCrD,eAAA,CAAgB,KAAA;;;;;;;;;;;;;;;;;;;;;;;iBA6BhB,wBAAA,CACd,KAAA,EAAO,MAAA,0CACN,qBAAA"}

package/dist/adapters/memory.mjs

@@ -0,0 +1,191 @@
+import { i as resolveAdapterConfig, t as defineDrain } from "../drain-D_fy7m0n.mjs";
+//#region src/adapters/memory.ts
+const DEFAULT_STORE = "default";
+const DEFAULT_MAX_EVENTS = 1e3;
+const MEMORY_FIELDS = [{
+	key: "store",
+	env: ["NUXT_EVLOG_MEMORY_STORE", "EVLOG_MEMORY_STORE"]
+}, {
+	key: "maxEvents",
+	env: ["NUXT_EVLOG_MEMORY_MAX_EVENTS", "EVLOG_MEMORY_MAX_EVENTS"]
+}];
+const stores = /* @__PURE__ */ new Map();
+function getOrCreateStore(name) {
+	if (!stores.has(name)) stores.set(name, []);
+	return stores.get(name);
+}
+function parseMaxEvents(value) {
+	if (typeof value === "number" && Number.isFinite(value)) {
+		const n = Math.floor(value);
+		return n > 0 ? n : void 0;
+	}
+	if (typeof value === "string" && value) {
+		const parsed = Number.parseFloat(value);
+		if (!Number.isFinite(parsed)) return void 0;
+		const n = Math.floor(parsed);
+		return n > 0 ? n : void 0;
+	}
+}
+function resolveMemoryConfig(overrides) {
+	return {
+		store: overrides?.store ?? DEFAULT_STORE,
+		maxEvents: parseMaxEvents(overrides?.maxEvents) ?? DEFAULT_MAX_EVENTS
+	};
+}
+/**
+* Write events directly into the named store. Exported for direct use and
+* easier testing without going through the drain pipeline.
+*/
+function writeToMemory(events, config) {
+	if (events.length === 0) return;
+	const store = getOrCreateStore(config.store);
+	store.push(...events);
+	if (store.length > config.maxEvents) store.splice(0, store.length - config.maxEvents);
+}
+/**
+* Create a drain that stores wide events in an in-memory ring buffer.
+*
+* Works in **any** runtime — including Cloudflare Workers (workerd) — where
+* the filesystem (`evlog/fs`) is not available. Pair it with a dev-only HTTP
+* endpoint to let agents retrieve the buffer over HTTP.
+*
+* Configuration priority (highest to lowest):
+* 1. Overrides passed to `createMemoryDrain()`
+* 2. `runtimeConfig.evlog.memory` / `runtimeConfig.memory` (Nitro)
+* 3. Environment variables: `NUXT_EVLOG_MEMORY_STORE`, `EVLOG_MEMORY_STORE`,
+*    `NUXT_EVLOG_MEMORY_MAX_EVENTS`, `EVLOG_MEMORY_MAX_EVENTS`
+*
+* @example
+* ```ts
+* // Hono + Cloudflare Workers
+* import { createMemoryDrain, readMemoryLogs } from 'evlog/memory'
+*
+* app.use(evlog({ drain: createMemoryDrain() }))
+*
+* // Dev-only endpoint for agent retrieval
+* if (env.NODE_ENV === 'development') {
+*   app.get('/_evlog/logs', (c) => c.json(readMemoryLogs()))
+* }
+* ```
+*/
+function createMemoryDrain(overrides) {
+	return defineDrain({
+		name: "memory",
+		resolve: async () => {
+			return resolveMemoryConfig(await resolveAdapterConfig("memory", MEMORY_FIELDS, overrides));
+		},
+		send: (events, cfg) => Promise.resolve(writeToMemory(events, cfg))
+	});
+}
+function normalizeTimestamp(value) {
+	if (!value) return void 0;
+	const ts = (value instanceof Date ? value : new Date(value)).getTime();
+	return Number.isNaN(ts) ? void 0 : ts;
+}
+/**
+* Read events from the named in-memory store. Returns a snapshot of the
+* buffer with optional filtering, ordered oldest-first.
+*
+* @example
+* ```ts
+* import { readMemoryLogs } from 'evlog/memory'
+*
+* // All events
+* const events = readMemoryLogs()
+*
+* // Errors in the last hour
+* const errors = readMemoryLogs({
+*   level: 'error',
+*   since: new Date(Date.now() - 60 * 60 * 1000),
+* })
+*
+* // Expose as a JSON endpoint
+* app.get('/_evlog/logs', (c) => c.json(readMemoryLogs({ limit: 200 })))
+* ```
+*/
+function readMemoryLogs(options = {}) {
+	const storeName = options.store ?? DEFAULT_STORE;
+	const events = [...stores.get(storeName) ?? []];
+	const sinceMs = normalizeTimestamp(options.since);
+	const untilMs = normalizeTimestamp(options.until);
+	const levels = options.level ? new Set(Array.isArray(options.level) ? options.level : [options.level]) : void 0;
+	const custom = options.filter;
+	const filtered = events.filter((event) => {
+		if (levels && !levels.has(event.level)) return false;
+		if (sinceMs !== void 0 || untilMs !== void 0) {
+			const ts = typeof event.timestamp === "string" ? Date.parse(event.timestamp) : NaN;
+			if (Number.isNaN(ts)) return false;
+			if (sinceMs !== void 0 && ts < sinceMs) return false;
+			if (untilMs !== void 0 && ts > untilMs) return false;
+		}
+		if (custom && !custom(event)) return false;
+		return true;
+	});
+	if (options.limit !== void 0) {
+		if (options.limit <= 0) return [];
+		if (filtered.length > options.limit) return filtered.slice(-options.limit);
+	}
+	return filtered;
+}
+/**
+* Clear all events from a named store (or `'default'`).
+*
+* @example
+* ```ts
+* clearMemoryLogs()           // clears the default store
+* clearMemoryLogs('my-store') // clears a named store
+* ```
+*/
+function clearMemoryLogs(store = DEFAULT_STORE) {
+	const s = stores.get(store);
+	if (s) s.length = 0;
+}
+const VALID_LEVELS = new Set([
+	"info",
+	"error",
+	"warn",
+	"debug"
+]);
+/**
+* Parse a flat query-string object (e.g. from `c.req.query()` in Hono, or
+* `req.query` in Express) into {@link ReadMemoryLogsOptions} with proper type
+* coercion.
+*
+* This lets agents discover and pass filter parameters through HTTP query
+* strings directly:
+*
+* @example
+* ```ts
+* // Hono — zero glue
+* app.get('/_evlog/logs', (c) =>
+*   c.json(readMemoryLogs(parseReadMemoryLogsQuery(c.req.query()))))
+*
+* // Express
+* app.get('/_evlog/logs', (req, res) =>
+*   res.json(readMemoryLogs(parseReadMemoryLogsQuery(req.query as Record<string, string>))))
+* ```
+*
+* Supported query params: `store`, `since`, `until`, `level` (comma-separated),
+* `limit`. The `filter` predicate cannot be expressed as a query param.
+*/
+function parseReadMemoryLogsQuery(query) {
+	const opts = {};
+	const { store, since, until, level, limit } = query;
+	if (typeof store === "string" && store) opts.store = store;
+	if (typeof since === "string" && since) opts.since = since;
+	if (typeof until === "string" && until) opts.until = until;
+	if (level !== void 0) {
+		const levels = (Array.isArray(level) ? level : level.split(",")).map((l) => l.trim()).filter((l) => VALID_LEVELS.has(l));
+		if (levels.length === 1) [opts.level] = levels;
+		else if (levels.length > 1) opts.level = levels;
+	}
+	if (typeof limit === "string") {
+		const n = Number.parseInt(limit, 10);
+		if (!Number.isNaN(n)) opts.limit = n;
+	}
+	return opts;
+}
+//#endregion
+export { clearMemoryLogs, createMemoryDrain, parseReadMemoryLogsQuery, readMemoryLogs, writeToMemory };
+
+//# sourceMappingURL=memory.mjs.map

package/dist/adapters/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","names":[],"sources":["../../src/adapters/memory.ts"],"sourcesContent":["import type { LogLevel, WideEvent } from '../types'\nimport type { ConfigField } from '../shared/config'\nimport { resolveAdapterConfig } from '../shared/config'\nimport { defineDrain } from '../shared/drain'\n\n/**\n * Configuration for the in-memory drain.\n */\nexport interface MemoryConfig {\n  /** Named store key. Multiple drains sharing the same key share the same buffer. Default: `'default'` */\n  store: string\n  /** Maximum number of events to keep in the ring buffer. Oldest events are discarded when the limit is exceeded. Default: `1000` */\n  maxEvents: number\n}\n\nconst DEFAULT_STORE = 'default'\nconst DEFAULT_MAX_EVENTS = 1000\n\nconst MEMORY_FIELDS: ConfigField<Partial<MemoryConfig>>[] = [\n  { key: 'store', env: ['NUXT_EVLOG_MEMORY_STORE', 'EVLOG_MEMORY_STORE'] },\n  { key: 'maxEvents', env: ['NUXT_EVLOG_MEMORY_MAX_EVENTS', 'EVLOG_MEMORY_MAX_EVENTS'] },\n]\n\nconst stores = new Map<string, WideEvent[]>()\n\nfunction getOrCreateStore(name: string): WideEvent[] {\n  if (!stores.has(name)) stores.set(name, [])\n  return stores.get(name)!\n}\n\nfunction parseMaxEvents(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    const n = Math.floor(value)\n    return n > 0 ? n : undefined\n  }\n  if (typeof value === 'string' && value) {\n    const parsed = Number.parseFloat(value)\n    if (!Number.isFinite(parsed)) return undefined\n    const n = Math.floor(parsed)\n    return n > 0 ? n : undefined\n  }\n  return undefined\n}\n\nfunction resolveMemoryConfig(overrides?: Partial<MemoryConfig>): MemoryConfig {\n  return {\n    store: overrides?.store ?? DEFAULT_STORE,\n    maxEvents: parseMaxEvents(overrides?.maxEvents) ?? DEFAULT_MAX_EVENTS,\n  }\n}\n\n/**\n * Write events directly into the named store. Exported for direct use and\n * easier testing without going through the drain pipeline.\n */\nexport function writeToMemory(events: WideEvent[], config: MemoryConfig): void {\n  if (events.length === 0) return\n  const store = getOrCreateStore(config.store)\n  store.push(...events)\n  if (store.length > config.maxEvents) {\n    store.splice(0, store.length - config.maxEvents)\n  }\n}\n\n/**\n * Create a drain that stores wide events in an in-memory ring buffer.\n *\n * Works in **any** runtime — including Cloudflare Workers (workerd) — where\n * the filesystem (`evlog/fs`) is not available. Pair it with a dev-only HTTP\n * endpoint to let agents retrieve the buffer over HTTP.\n *\n * Configuration priority (highest to lowest):\n * 1. Overrides passed to `createMemoryDrain()`\n * 2. `runtimeConfig.evlog.memory` / `runtimeConfig.memory` (Nitro)\n * 3. Environment variables: `NUXT_EVLOG_MEMORY_STORE`, `EVLOG_MEMORY_STORE`,\n *    `NUXT_EVLOG_MEMORY_MAX_EVENTS`, `EVLOG_MEMORY_MAX_EVENTS`\n *\n * @example\n * ```ts\n * // Hono + Cloudflare Workers\n * import { createMemoryDrain, readMemoryLogs } from 'evlog/memory'\n *\n * app.use(evlog({ drain: createMemoryDrain() }))\n *\n * // Dev-only endpoint for agent retrieval\n * if (env.NODE_ENV === 'development') {\n *   app.get('/_evlog/logs', (c) => c.json(readMemoryLogs()))\n * }\n * ```\n */\nexport function createMemoryDrain(overrides?: Partial<MemoryConfig>) {\n  return defineDrain<MemoryConfig>({\n    name: 'memory',\n    resolve: async () => {\n      const resolved = await resolveAdapterConfig<Partial<MemoryConfig>>('memory', MEMORY_FIELDS, overrides)\n      return resolveMemoryConfig(resolved)\n    },\n    send: (events, cfg) => Promise.resolve(writeToMemory(events, cfg)),\n  })\n}\n\n/** Options accepted by {@link readMemoryLogs}. */\nexport interface ReadMemoryLogsOptions {\n  /** Named store to read from. Default: `'default'` */\n  store?: string\n  /** Only include events with `timestamp >= since`. */\n  since?: Date | string\n  /** Only include events with `timestamp <= until`. */\n  until?: Date | string\n  /** Filter by log level. */\n  level?: LogLevel | LogLevel[]\n  /** Custom predicate — return `false` to skip the event. */\n  filter?: (event: WideEvent) => boolean\n  /** Return at most this many of the most-recent matching events. */\n  limit?: number\n}\n\nfunction normalizeTimestamp(value: Date | string | undefined): number | undefined {\n  if (!value) return undefined\n  const date = value instanceof Date ? value : new Date(value)\n  const ts = date.getTime()\n  return Number.isNaN(ts) ? undefined : ts\n}\n\n/**\n * Read events from the named in-memory store. Returns a snapshot of the\n * buffer with optional filtering, ordered oldest-first.\n *\n * @example\n * ```ts\n * import { readMemoryLogs } from 'evlog/memory'\n *\n * // All events\n * const events = readMemoryLogs()\n *\n * // Errors in the last hour\n * const errors = readMemoryLogs({\n *   level: 'error',\n *   since: new Date(Date.now() - 60 * 60 * 1000),\n * })\n *\n * // Expose as a JSON endpoint\n * app.get('/_evlog/logs', (c) => c.json(readMemoryLogs({ limit: 200 })))\n * ```\n */\nexport function readMemoryLogs(options: ReadMemoryLogsOptions = {}): WideEvent[] {\n  const storeName = options.store ?? DEFAULT_STORE\n  const events = [...(stores.get(storeName) ?? [])]\n\n  const sinceMs = normalizeTimestamp(options.since)\n  const untilMs = normalizeTimestamp(options.until)\n  const levels = options.level\n    ? new Set<LogLevel>(Array.isArray(options.level) ? options.level : [options.level])\n    : undefined\n  const custom = options.filter\n\n  const filtered = events.filter((event) => {\n    if (levels && !levels.has(event.level)) return false\n    if (sinceMs !== undefined || untilMs !== undefined) {\n      const ts = typeof event.timestamp === 'string' ? Date.parse(event.timestamp) : Number.NaN\n      if (Number.isNaN(ts)) return false\n      if (sinceMs !== undefined && ts < sinceMs) return false\n      if (untilMs !== undefined && ts > untilMs) return false\n    }\n    if (custom && !custom(event)) return false\n    return true\n  })\n\n  if (options.limit !== undefined) {\n    if (options.limit <= 0) return []\n    if (filtered.length > options.limit) return filtered.slice(-options.limit)\n  }\n  return filtered\n}\n\n/**\n * Clear all events from a named store (or `'default'`).\n *\n * @example\n * ```ts\n * clearMemoryLogs()           // clears the default store\n * clearMemoryLogs('my-store') // clears a named store\n * ```\n */\nexport function clearMemoryLogs(store = DEFAULT_STORE): void {\n  const s = stores.get(store)\n  if (s) s.length = 0\n}\n\nconst VALID_LEVELS = new Set<LogLevel>(['info', 'error', 'warn', 'debug'])\n\n/**\n * Parse a flat query-string object (e.g. from `c.req.query()` in Hono, or\n * `req.query` in Express) into {@link ReadMemoryLogsOptions} with proper type\n * coercion.\n *\n * This lets agents discover and pass filter parameters through HTTP query\n * strings directly:\n *\n * @example\n * ```ts\n * // Hono — zero glue\n * app.get('/_evlog/logs', (c) =>\n *   c.json(readMemoryLogs(parseReadMemoryLogsQuery(c.req.query()))))\n *\n * // Express\n * app.get('/_evlog/logs', (req, res) =>\n *   res.json(readMemoryLogs(parseReadMemoryLogsQuery(req.query as Record<string, string>))))\n * ```\n *\n * Supported query params: `store`, `since`, `until`, `level` (comma-separated),\n * `limit`. The `filter` predicate cannot be expressed as a query param.\n */\nexport function parseReadMemoryLogsQuery(\n  query: Record<string, string | string[] | undefined>,\n): ReadMemoryLogsOptions {\n  const opts: ReadMemoryLogsOptions = {}\n  const { store, since, until, level, limit } = query\n\n  if (typeof store === 'string' && store) opts.store = store\n  if (typeof since === 'string' && since) opts.since = since\n  if (typeof until === 'string' && until) opts.until = until\n\n  if (level !== undefined) {\n    const raw = Array.isArray(level) ? level : level.split(',')\n    const levels = raw.map((l) => l.trim()).filter((l): l is LogLevel => VALID_LEVELS.has(l as LogLevel))\n    if (levels.length === 1) [opts.level] = levels\n    else if (levels.length > 1) opts.level = levels\n  }\n\n  if (typeof limit === 'string') {\n    const n = Number.parseInt(limit, 10)\n    if (!Number.isNaN(n)) opts.limit = n\n  }\n\n  return opts\n}\n"],"mappings":"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"}

package/dist/adapters/otlp.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/otlp.d.ts
 interface OTLPConfig {
   /** OTLP HTTP endpoint (e.g., http://localhost:4318) */

package/dist/adapters/otlp.mjs

@@ -1,7 +1,7 @@
-import { r as httpPost } from "../http-6umVAKDW.mjs";
-import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-X7_5szSI.mjs";
-import { n as toOtlpAttributeValue } from "../event-1BMl7o0k.mjs";
-import { n as OTEL_SEVERITY_TEXT, t as OTEL_SEVERITY_NUMBER } from "../severity-R5Egq3qz.mjs";
+import { r as httpPost } from "../http-Bept5EIC.mjs";
+import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-D_fy7m0n.mjs";
+import { n as toOtlpAttributeValue } from "../event-qwAv-7AZ.mjs";
+import { n as OTEL_SEVERITY_TEXT, t as OTEL_SEVERITY_NUMBER } from "../severity-CwXUSHt3.mjs";
 //#region src/adapters/otlp.ts
 const OTLP_FIELDS = [
 	{

package/dist/adapters/posthog.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/posthog.d.ts
 /**
  * Mode for {@link createPostHogDrain}.

package/dist/adapters/posthog.mjs

@@ -1,5 +1,5 @@
-import { r as httpPost } from "../http-6umVAKDW.mjs";
-import { i as resolveAdapterConfig, n as defineHttpDrain, t as defineDrain } from "../drain-X7_5szSI.mjs";
+import { r as httpPost } from "../http-Bept5EIC.mjs";
+import { i as resolveAdapterConfig, n as defineHttpDrain, t as defineDrain } from "../drain-D_fy7m0n.mjs";
 import { sendBatchToOTLP } from "./otlp.mjs";
 //#region src/adapters/posthog.ts
 const POSTHOG_FIELDS = [

package/dist/adapters/sentry.d.mts

@@ -1,4 +1,4 @@
-import { I as DrainContext, ct as WideEvent } from "../audit-CC8nfazi.mjs";
+import { B as DrainContext, ft as WideEvent } from "../audit-BUAajsPU.mjs";
 //#region src/adapters/sentry.d.ts
 interface SentryConfig {
   /** Sentry DSN */

package/dist/adapters/sentry.mjs

@@ -1,6 +1,6 @@
-import { r as httpPost } from "../http-6umVAKDW.mjs";
-import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-X7_5szSI.mjs";
-import { t as OTEL_SEVERITY_NUMBER } from "../severity-R5Egq3qz.mjs";
+import { r as httpPost } from "../http-Bept5EIC.mjs";
+import { i as resolveAdapterConfig, n as defineHttpDrain } from "../drain-D_fy7m0n.mjs";
+import { t as OTEL_SEVERITY_NUMBER } from "../severity-CwXUSHt3.mjs";
 //#region src/adapters/sentry.ts
 const SENTRY_FIELDS = [
 	{

package/dist/ai/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as RequestLogger } from "../audit-CC8nfazi.mjs";
+import { rt as RequestLogger } from "../audit-BUAajsPU.mjs";
 import { GatewayModelId, TelemetryIntegration } from "ai";
 import { LanguageModelV3, LanguageModelV3Middleware } from "@ai-sdk/provider";