@listo-ai/mcp-observability 0.2.0 → 0.3.1

package/README.md

@@ -4,13 +4,14 @@ Lightweight telemetry SDK for MCP servers and web applications. Captures HTTP re
 
 ## Overview
 
-This SDK provides comprehensive observability for [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers and Express.js applications. It integrates with Listo Insights for centralized analytics, and includes a local development dashboard for real-time metrics.
+This SDK provides comprehensive observability for [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers and Express.js applications. It supports centralized analytics via a remote sink, and includes a local development dashboard for real-time metrics.
 
 **Key features:**
 
 - **Easy setup** -- Get started in 4 lines of code with `createMcpObservabilityEasy()`
 - **Local dashboard** -- Real-time metrics dashboard during development at `/telemetry/dashboard`
-- **Centralized analytics** -- Send telemetry data to Listo Insights in production
+- **Browser client** -- Reusable `TelemetryClient` for browser apps with batching and `sendBeacon` fallback
+- **Centralized analytics** -- Send telemetry data to a remote endpoint in production
 - **Automatic tracking** -- HTTP requests via Express middleware, MCP tool invocations via handler wrapper
 - **Payload sanitization** -- Built-in redaction of sensitive keys (`password`, `token`, `apiKey`, `secret`, `authorization`)
 - **Sampling** -- Configurable sampling rates with guaranteed capture of errors and session events
@@ -20,6 +21,7 @@ This SDK provides comprehensive observability for [Model Context Protocol (MCP)]
 
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Browser Client](#browser-client)
 - [How It Works](#how-it-works)
 - [API Reference](#api-reference)
 - [Integration Guide](#integration-guide)
@@ -56,14 +58,14 @@ const observability = createMcpObservabilityEasy({
 ```typescript
 import { createTelemetryRouter } from '@listo-ai/mcp-observability';
 
-app.use('/telemetry', createTelemetryRouter());
+app.use('/telemetry', createTelemetryRouter(express));
 ```
 
-### 3. Set environment variables
+### 3. Set environment variables (optional, for remote telemetry)
 
 ```bash
-INSIGHTS_API_URL=https://api.listoai.co
-INSIGHTS_API_KEY=fuse_xxxxxxxxxxxxx
+LISTO_API_URL=https://your-api.example.com
+LISTO_API_KEY=your_api_key
 ```
 
 ### 4. Access the local dashboard
@@ -72,6 +74,23 @@ INSIGHTS_API_KEY=fuse_xxxxxxxxxxxxx
 http://localhost:3000/telemetry/dashboard
 ```
 
+## Browser Client
+
+For browser applications, use the lightweight client module with automatic batching and session management:
+
+```typescript
+import { createTelemetryClient } from '@listo-ai/mcp-observability/client';
+
+const client = createTelemetryClient({
+  endpoint: 'https://myapp.com/telemetry',
+});
+
+client.track('page_view', { path: '/home' });
+client.trackUi('button_click', { action: 'click', widgetId: 'cta-1' });
+```
+
+The client has no Node.js dependencies — it uses `fetch()`, `crypto.randomUUID()`, and `navigator.sendBeacon()`. See [Browser Client docs](./docs/client.md) for full API reference.
+
 ## How It Works
 
 ### Environment-Based Auto-Configuration
@@ -97,7 +116,7 @@ Observability SDK (captures events)
     |
     +---> Console Sink (dev only, errors)
     +---> InMemory Sink (local dashboard)
-    +---> Remote Sink (Listo Insights, batched)
+    +---> Remote Sink (remote endpoint, batched)
 ```
 
 ### Sink Architecture
@@ -105,7 +124,7 @@ Observability SDK (captures events)
 Events flow through configurable **sinks** -- decoupled consumers that process telemetry data:
 
 - **`InMemorySink`** -- Circular buffer (default 2000 events) powering the local dashboard
-- **`RemoteSink`** -- Batches events and sends them to Listo Insights with exponential backoff retries
+- **`RemoteSink`** -- Batches events and sends them to a remote endpoint with exponential backoff retries
 - **`ConsoleSink`** -- Logs errors to stdout
 - **`combineSinks()`** -- Routes events to multiple sinks simultaneously
 
@@ -120,8 +139,8 @@ interface EasySetupConfig {
   serviceName: string;
   serviceVersion?: string;           // default: "1.0.0"
   environment?: "dev" | "staging" | "production";
-  insightsApiUrl?: string;           // default: process.env.INSIGHTS_API_URL
-  insightsApiKey?: string;           // default: process.env.INSIGHTS_API_KEY
+  listoApiUrl?: string;              // default: process.env.LISTO_API_URL
+  listoApiKey?: string;              // default: process.env.LISTO_API_KEY
   enableLocalDashboard?: boolean;    // default: true in dev, false in prod
   sampleRate?: number;               // default: 1 in dev, 0.1 in prod
 }
@@ -129,7 +148,7 @@ interface EasySetupConfig {
 
 ```typescript
 const observability = createMcpObservabilityEasy({
-  serviceName: 'hotel-search-mcp',
+  serviceName: 'my-mcp-server',
   serviceVersion: '0.1.0',
   enableLocalDashboard: true,
 });
@@ -152,7 +171,7 @@ interface ObservabilityOptions {
 }
 ```
 
-### `createTelemetryRouter()`
+### `createTelemetryRouter(express)`
 
 Express router providing telemetry endpoints:
 
@@ -160,12 +179,13 @@ Express router providing telemetry endpoints:
 | --- | --- | --- |
 | `/` | GET | JSON metrics data |
 | `/dashboard` | GET | HTML dashboard with auto-refresh |
-| `/event` | POST | UI event ingestion |
+| `/event` | POST | Single UI event ingestion |
+| `/events` | POST | Batch UI event ingestion (max 100) |
 
 ```typescript
 import { createTelemetryRouter } from '@listo-ai/mcp-observability';
 
-app.use('/telemetry', createTelemetryRouter());
+app.use('/telemetry', createTelemetryRouter(express));
 // Dashboard: http://localhost:3000/telemetry/dashboard
 ```
 
@@ -204,10 +224,10 @@ server.setRequestHandler(
 Record custom business events for domain-specific analytics.
 
 ```typescript
-observability.recordBusinessEvent('hotel_search', {
-  q: 'paris hotels',
-  minRating: 4.5,
-  total: 42,
+observability.recordBusinessEvent('product_search', {
+  q: 'premium items',
+  category: 'electronics',
+  results: 42,
 }, 'ok');
 ```
 
@@ -217,8 +237,10 @@ Record UI interaction events from the browser.
 
 ```typescript
 observability.recordUiEvent({
-  name: 'booking_clicked',
-  properties: { hotelId: 'h123', hotelName: 'Hotel Paris' },
+  name: 'cta_click',
+  action: 'click',
+  widgetId: 'signup-btn',
+  properties: { itemId: 'i-123' },
   sessionId: 'session-456',
   tenantId: 'tenant-789',
 });
@@ -244,8 +266,8 @@ Standalone remote sink for custom configurations.
 import { RemoteSink } from '@listo-ai/mcp-observability';
 
 const sink = new RemoteSink({
-  endpoint: 'https://api.listoai.co/v1/events/batch',
-  apiKey: 'fuse_xxxxxxxxxxxxx',
+  endpoint: 'https://your-api.example.com/v1/events/batch',
+  apiKey: 'your_api_key',
   batchSize: 50,           // events per batch
   flushIntervalMs: 5000,   // flush every 5s
   maxRetries: 3,           // retry with exponential backoff
@@ -275,11 +297,11 @@ const observability = createMcpObservabilityEasy({
 app.use(expressTelemetry(observability));
 
 // Telemetry endpoints
-app.use('/telemetry', createTelemetryRouter());
+app.use('/telemetry', createTelemetryRouter(express));
 
-app.get('/hotels', (req, res) => {
+app.get('/products', (req, res) => {
   // Automatically tracked
-  res.json({ hotels: [] });
+  res.json({ products: [] });
 });
 
 app.listen(3000);
@@ -297,14 +319,14 @@ import express from 'express';
 
 const app = express();
 const observability = createMcpObservabilityEasy({
-  serviceName: 'hotel-search-mcp',
+  serviceName: 'my-mcp-server',
   serviceVersion: '0.1.0',
 });
 
-app.use('/telemetry', createTelemetryRouter());
+app.use('/telemetry', createTelemetryRouter(express));
 
 const server = new Server({
-  name: 'hotel-search',
+  name: 'my-mcp-server',
   version: '0.1.0',
 });
 
@@ -332,8 +354,8 @@ Automatically captured via `expressTelemetry()` middleware.
 {
   type: 'http_request',
   method: 'GET',
-  path: '/hotels',
-  route: '/hotels/:city',
+  path: '/products',
+  route: '/products/:id',
   statusCode: 200,
   status: 'ok',
   latencyMs: 45.2,
@@ -349,7 +371,7 @@ Captured via `wrapMcpHandler()`.
 {
   type: 'mcp_request',
   requestKind: 'CallTool',
-  toolName: 'search_hotels',
+  toolName: 'search_products',
   status: 'ok',
   latencyMs: 234.5,
   inputBytes: 156,
@@ -376,9 +398,9 @@ Custom domain events via `recordBusinessEvent()`.
 ```typescript
 {
   type: 'business_event',
-  name: 'hotel_search',
+  name: 'product_search',
   status: 'ok',
-  properties: { q: 'paris', results: 42 },
+  properties: { q: 'premium', results: 42 },
 }
 ```
 
@@ -389,9 +411,10 @@ Browser interaction events via `recordUiEvent()` or the `POST /telemetry/event`
 ```typescript
 {
   type: 'ui_event',
-  name: 'booking_clicked',
+  name: 'cta_click',
+  action: 'click',
   sessionId: 'session-123',
-  properties: { hotelId: 'h456' },
+  properties: { itemId: 'i-456' },
 }
 ```
 
@@ -399,8 +422,8 @@ Browser interaction events via `recordUiEvent()` or the `POST /telemetry/event`
 
 | Variable | Required | Description |
 | --- | --- | --- |
-| `INSIGHTS_API_URL` | For remote | Listo Insights API endpoint (default: `https://api.listoai.co`) |
-| `INSIGHTS_API_KEY` | For remote | API key for authentication (format: `fuse_xxxxxxxxxxxxx`) |
+| `LISTO_API_URL` | For remote | Listo API endpoint |
+| `LISTO_API_KEY` | For remote | API key for authentication |
 | `NODE_ENV` | No | `development` / `staging` / `production` -- controls defaults |
 | `TELEMETRY_SAMPLE_RATE` | No | Override sampling percentage (0.0 - 1.0) |
 | `TELEMETRY_CAPTURE_PAYLOADS` | No | Enable/disable payload capture |
@@ -411,7 +434,7 @@ Browser interaction events via `recordUiEvent()` or the `POST /telemetry/event`
 
 The SDK automatically redacts sensitive keys from all captured payloads. Redaction is applied recursively up to 6 levels deep.
 
-**Default redacted keys:** `password`, `token`, `apiKey`, `secret`, `authorization`
+**Default redacted keys:** `password`, `token`, `apiKey`, `secret`, `authorization`, `userId`, `userLocation`, `email`, `userEmail`, `phone`, `phoneNumber`
 
 **Custom redaction:**
 
@@ -457,6 +480,7 @@ Full Amplitude-style documentation is available in the [`docs/`](./docs/) direct
 | [Sessions](./docs/sessions.md) | `recordSession()`, always-capture behavior |
 | [Business Events](./docs/business-events.md) | `recordBusinessEvent()` |
 | [UI Events](./docs/ui-events.md) | `recordUiEvent()` + POST endpoint |
+| [Browser Client](./docs/client.md) | `TelemetryClient` for browser apps |
 | [Sinks](./docs/sinks.md) | InMemorySink, RemoteSink, ConsoleSink, combineSinks |
 | [Endpoints](./docs/endpoints.md) | Dashboard, JSON API, event ingestion |
 | [Easy Setup](./docs/easy-setup.md) | `createMcpObservabilityEasy()` deep-dive |
@@ -522,7 +546,8 @@ mcp-observability/
 │       └── publish.yml     # Publish to npm on release
 ├── docs/                  # Comprehensive SDK documentation
 ├── src/
-│   ├── index.ts            # Core SDK: types, classes, analytics
+│   ├── index.ts            # Core SDK: types, classes, metrics
+│   ├── client.ts           # Browser telemetry client
 │   ├── endpoints.ts        # Express router and middleware
 │   ├── easy-setup.ts       # Simplified configuration factory
 │   └── remote-sink.ts      # Remote event batching and transmission
@@ -539,10 +564,11 @@ mcp-observability/
 
 | File | Description |
 | --- | --- |
-| `src/index.ts` | Core SDK -- event types, `McpObservability` class, `InMemorySink`, sampling, sanitization, analytics aggregation |
-| `src/endpoints.ts` | `expressTelemetry()` middleware and `createTelemetryRouter()` for JSON metrics, HTML dashboard, and event ingestion |
+| `src/index.ts` | Core SDK -- event types, `McpObservability` class, `InMemorySink`, sampling, sanitization |
+| `src/client.ts` | Browser telemetry client -- `TelemetryClient` class with batching, session management, `sendBeacon` fallback |
+| `src/endpoints.ts` | `expressTelemetry()` middleware and `createTelemetryRouter(express)` for JSON metrics, HTML dashboard, and event ingestion |
 | `src/easy-setup.ts` | `createMcpObservabilityEasy()` -- auto-configures sinks and sampling based on environment |
-| `src/remote-sink.ts` | `RemoteSink` class -- batches events and sends to Listo Insights API with retry logic |
+| `src/remote-sink.ts` | `RemoteSink` class -- batches events and sends to remote API with retry logic |
 
 ## CI/CD and Publishing
 
@@ -583,14 +609,13 @@ The tag, npm publish, and GitHub Release are all handled automatically by CI.
 
 - Ensure `enableLocalDashboard: true` is set (default in dev)
 - Visit `http://localhost:PORT/telemetry/dashboard`
-- Confirm `createTelemetryRouter()` is mounted: `app.use('/telemetry', createTelemetryRouter())`
+- Confirm `createTelemetryRouter(express)` is mounted: `app.use('/telemetry', createTelemetryRouter(express))`
 
-### Data not reaching Listo Insights
+### Data not reaching remote endpoint
 
-- Verify `INSIGHTS_API_KEY` is set and valid (starts with `fuse_`)
-- Check `INSIGHTS_API_URL` is correct
-- Look for `[Listo Insights]` warnings in server logs
-- Generate a new API key at https://app.listoai.co/settings
+- Verify `LISTO_API_KEY` is set and valid
+- Check `LISTO_API_URL` is correct
+- Look for warnings in server logs
 
 ### Performance overhead
 

package/dist/client.d.ts

@@ -0,0 +1,41 @@
+export interface TelemetryClientOptions {
+    endpoint: string;
+    sessionId?: string;
+    tenantId?: string;
+    locale?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    onError?: (error: unknown) => void;
+    debug?: boolean;
+}
+export declare class TelemetryClient {
+    private readonly endpoint;
+    private readonly sessionId;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly onError;
+    private readonly debug;
+    private queue;
+    private timer;
+    private context;
+    private destroyed;
+    constructor(options: TelemetryClientOptions);
+    track(name: string, properties?: Record<string, unknown>): void;
+    trackUi(name: string, options: {
+        action?: string;
+        widgetId?: string;
+        toolName?: string;
+        properties?: Record<string, unknown>;
+    }): void;
+    setContext(ctx: {
+        tenantId?: string;
+        locale?: string;
+    }): void;
+    flush(): void;
+    destroy(): void;
+    private enqueue;
+    private send;
+    private handleVisibilityChange;
+}
+export declare function createTelemetryClient(options: TelemetryClientOptions): TelemetryClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,sBAAsB;IAsB3C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAY/D,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,GACA,IAAI;IAeP,UAAU,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAK7D,KAAK,IAAI,IAAI;IAMb,OAAO,IAAI,IAAI;IAef,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,IAAI;IA8BZ,OAAO,CAAC,sBAAsB,CAI5B;CACH;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAEjB"}

package/dist/client.js

@@ -0,0 +1,123 @@
+export class TelemetryClient {
+    endpoint;
+    sessionId;
+    batchSize;
+    flushIntervalMs;
+    onError;
+    debug;
+    queue = [];
+    timer = null;
+    context;
+    destroyed = false;
+    constructor(options) {
+        this.endpoint = options.endpoint.replace(/\/+$/, '');
+        this.sessionId = options.sessionId ?? globalThis.crypto.randomUUID();
+        this.batchSize = options.batchSize ?? 20;
+        this.flushIntervalMs = options.flushIntervalMs ?? 5000;
+        this.onError = options.onError ?? (() => { });
+        this.debug = options.debug ?? false;
+        this.context = {
+            tenantId: options.tenantId,
+            locale: options.locale,
+        };
+        this.timer = setInterval(() => this.flush(), this.flushIntervalMs);
+        if (typeof globalThis.document !== 'undefined') {
+            globalThis.document.addEventListener('visibilitychange', this.handleVisibilityChange);
+        }
+    }
+    track(name, properties) {
+        if (this.destroyed)
+            return;
+        this.enqueue({
+            name,
+            timestamp: Date.now(),
+            sessionId: this.sessionId,
+            tenantId: this.context.tenantId,
+            locale: this.context.locale,
+            properties,
+        });
+    }
+    trackUi(name, options) {
+        if (this.destroyed)
+            return;
+        this.enqueue({
+            name,
+            timestamp: Date.now(),
+            sessionId: this.sessionId,
+            tenantId: this.context.tenantId,
+            locale: this.context.locale,
+            action: options.action,
+            widgetId: options.widgetId,
+            toolName: options.toolName,
+            properties: options.properties,
+        });
+    }
+    setContext(ctx) {
+        if (ctx.tenantId !== undefined)
+            this.context.tenantId = ctx.tenantId;
+        if (ctx.locale !== undefined)
+            this.context.locale = ctx.locale;
+    }
+    flush() {
+        if (this.queue.length === 0)
+            return;
+        const events = this.queue.splice(0);
+        this.send(events);
+    }
+    destroy() {
+        this.destroyed = true;
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (typeof globalThis.document !== 'undefined') {
+            globalThis.document.removeEventListener('visibilitychange', this.handleVisibilityChange);
+        }
+        this.flush();
+    }
+    enqueue(event) {
+        this.queue.push(event);
+        if (this.queue.length >= this.batchSize) {
+            this.flush();
+        }
+    }
+    send(events) {
+        const url = `${this.endpoint}/events`;
+        const body = JSON.stringify({ events });
+        if (this.debug) {
+            console.debug('[telemetry-client] sending', events.length, 'events');
+        }
+        try {
+            fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+                keepalive: true,
+            }).catch((error) => {
+                try {
+                    this.onError(error);
+                }
+                catch {
+                    // never throw from onError
+                }
+            });
+        }
+        catch (error) {
+            try {
+                this.onError(error);
+            }
+            catch {
+                // never throw from onError
+            }
+        }
+    }
+    handleVisibilityChange = () => {
+        if (globalThis.document?.visibilityState === 'hidden') {
+            this.flush();
+        }
+    };
+}
+export function createTelemetryClient(options) {
+    return new TelemetryClient(options);
+}
+//# sourceMappingURL=client.js.map

package/dist/easy-setup.d.ts

@@ -2,17 +2,21 @@ export interface EasySetupConfig {
     serviceName: string;
     serviceVersion?: string;
     environment?: 'dev' | 'staging' | 'production';
+    /** @deprecated Use `listoApiUrl` instead. */
     insightsApiUrl?: string;
+    /** @deprecated Use `listoApiKey` instead. */
     insightsApiKey?: string;
+    listoApiUrl?: string;
+    listoApiKey?: string;
     enableLocalDashboard?: boolean;
     sampleRate?: number;
 }
 /**
  * Create an observability instance with environment-based defaults.
  *
- * This is the easiest way to get started with Listo Insights.
+ * This is the easiest way to get started.
  * It automatically:
- * - Configures RemoteSink if INSIGHTS_API_KEY is provided
+ * - Configures RemoteSink if LISTO_API_KEY is provided
  * - Configures InMemorySink + local dashboard in development
  * - Applies sensible defaults (sampling, redaction, etc.)
  * - Auto-detects tenant/user from common headers
@@ -26,8 +30,8 @@ export interface EasySetupConfig {
  * ```
  *
  * Environment variables used:
- * - INSIGHTS_API_URL: Insights API endpoint (default: https://api.listoai.co)
- * - INSIGHTS_API_KEY: API key for authentication (generated in dashboard)
+ * - LISTO_API_URL: Remote telemetry API endpoint
+ * - LISTO_API_KEY: API key for authentication
  * - NODE_ENV: Determines if dev/production mode
  */
 export declare function createMcpObservabilityEasy(config: EasySetupConfig): import("./index.js").McpObservability;

package/dist/easy-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"easy-setup.d.ts","sourceRoot":"","sources":["../src/easy-setup.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,yCAsEjE"}
+{"version":3,"file":"easy-setup.d.ts","sourceRoot":"","sources":["../src/easy-setup.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;IAC/C,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,yCAyEjE"}

package/dist/easy-setup.js

@@ -4,9 +4,9 @@ import { TELEMETRY_SINK_KEY, OBSERVABILITY_KEY, setGlobal, } from './endpoints.j
 /**
  * Create an observability instance with environment-based defaults.
  *
- * This is the easiest way to get started with Listo Insights.
+ * This is the easiest way to get started.
  * It automatically:
- * - Configures RemoteSink if INSIGHTS_API_KEY is provided
+ * - Configures RemoteSink if LISTO_API_KEY is provided
  * - Configures InMemorySink + local dashboard in development
  * - Applies sensible defaults (sampling, redaction, etc.)
  * - Auto-detects tenant/user from common headers
@@ -20,12 +20,16 @@ import { TELEMETRY_SINK_KEY, OBSERVABILITY_KEY, setGlobal, } from './endpoints.j
  * ```
  *
  * Environment variables used:
- * - INSIGHTS_API_URL: Insights API endpoint (default: https://api.listoai.co)
- * - INSIGHTS_API_KEY: API key for authentication (generated in dashboard)
+ * - LISTO_API_URL: Remote telemetry API endpoint
+ * - LISTO_API_KEY: API key for authentication
  * - NODE_ENV: Determines if dev/production mode
  */
 export function createMcpObservabilityEasy(config) {
-    const { serviceName, serviceVersion = '1.0.0', environment = process.env.NODE_ENV === 'production' ? 'production' : 'dev', insightsApiUrl = process.env.INSIGHTS_API_URL, insightsApiKey = process.env.INSIGHTS_API_KEY, enableLocalDashboard = environment === 'dev', sampleRate = environment === 'production' ? 0.1 : 1.0, } = config;
+    const { serviceName, serviceVersion = '1.0.0', environment = process.env.NODE_ENV === 'production' ? 'production' : 'dev', listoApiUrl = config.insightsApiUrl ??
+        process.env.LISTO_API_URL ??
+        process.env.INSIGHTS_API_URL, listoApiKey = config.insightsApiKey ??
+        process.env.LISTO_API_KEY ??
+        process.env.INSIGHTS_API_KEY, enableLocalDashboard = environment === 'dev', sampleRate = environment === 'production' ? 0.1 : 1.0, } = config;
     const sinks = [];
     // Console logging in dev only
     if (environment === 'dev') {
@@ -38,20 +42,19 @@ export function createMcpObservabilityEasy(config) {
         // Export globally for telemetry endpoints to access
         setGlobal(TELEMETRY_SINK_KEY, telemetrySink);
     }
-    // Remote Listo Insights sink
-    if (insightsApiUrl && insightsApiKey) {
+    // Remote telemetry sink
+    if (listoApiUrl && listoApiKey) {
         sinks.push(createRemoteSink({
-            endpoint: `${insightsApiUrl}/v1/events/batch`,
-            apiKey: insightsApiKey,
+            endpoint: `${listoApiUrl}/v1/events/batch`,
+            apiKey: listoApiKey,
             batchSize: 50,
             flushIntervalMs: 5000,
             maxRetries: 3,
         }));
     }
     else if (environment !== 'dev') {
-        console.warn('[Listo Insights] No API key configured. ' +
-            'Set INSIGHTS_API_KEY environment variable to enable remote telemetry. ' +
-            'Generate a key at: https://app.listoai.co/settings');
+        console.warn('[telemetry] No API key configured. ' +
+            'Set LISTO_API_KEY environment variable to enable remote telemetry.');
     }
     // Create the observability instance
     const options = {
@@ -60,7 +63,7 @@ export function createMcpObservabilityEasy(config) {
         environment,
         sampleRate,
         capturePayloads: true,
-        redactKeys: ['password', 'token', 'apiKey', 'secret', 'authorization'],
+        // Omit redactKeys to use the SDK defaults (includes PII keys)
         sinks: sinks.length > 0 ? sinks : [createConsoleSink({ logSuccess: false })],
         // Auto-detect tenant from common headers
         tenantResolver: (req) => req.headers['x-tenant-id'] ||

package/dist/endpoints.d.ts

@@ -22,13 +22,17 @@ export declare function expressTelemetry(observability: McpObservability): (req:
  * - GET /telemetry/dashboard - HTML dashboard
  * - POST /telemetry/event - UI event ingestion
  *
+ * @param expressModule - The express module instance. Required because the SDK
+ *   cannot resolve express from the consumer's node_modules automatically.
+ *
  * @example
  * ```typescript
+ * import express from 'express';
  * import { createTelemetryRouter } from '@listo-ai/mcp-observability';
  *
- * app.use('/telemetry', createTelemetryRouter());
+ * app.use('/telemetry', createTelemetryRouter(express));
  * ```
  */
-export declare function createTelemetryRouter(): any;
+export declare function createTelemetryRouter(expressModule: any): any;
 export { TELEMETRY_SINK_KEY, OBSERVABILITY_KEY, setGlobal };
 //# sourceMappingURL=endpoints.d.ts.map

package/dist/endpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,YAAY,CAAC;AAEjE,QAAA,MAAM,kBAAkB,eAAoC,CAAC;AAC7D,QAAA,MAAM,iBAAiB,eAAoC,CAAC;AAe5D,iBAAS,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAEjD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,IAChD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAW9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,QAqQpC;AAED,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,YAAY,CAAC;AAEjE,QAAA,MAAM,kBAAkB,eAAsC,CAAC;AAC/D,QAAA,MAAM,iBAAiB,eAAsC,CAAC;AAe9D,iBAAS,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAEjD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,IAChD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAW9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,OAySvD;AAED,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC"}

package/dist/endpoints.js

@@ -1,5 +1,5 @@
-const TELEMETRY_SINK_KEY = Symbol.for('listo.telemetrySink');
-const OBSERVABILITY_KEY = Symbol.for('listo.observability');
+const TELEMETRY_SINK_KEY = Symbol.for('mcp-obs.telemetrySink');
+const OBSERVABILITY_KEY = Symbol.for('mcp-obs.observability');
 function escapeHtml(str) {
     return str
         .replace(/&/g, '&')
@@ -71,17 +71,20 @@ export function expressTelemetry(observability) {
  * - GET /telemetry/dashboard - HTML dashboard
  * - POST /telemetry/event - UI event ingestion
  *
+ * @param expressModule - The express module instance. Required because the SDK
+ *   cannot resolve express from the consumer's node_modules automatically.
+ *
  * @example
  * ```typescript
+ * import express from 'express';
  * import { createTelemetryRouter } from '@listo-ai/mcp-observability';
  *
- * app.use('/telemetry', createTelemetryRouter());
+ * app.use('/telemetry', createTelemetryRouter(express));
  * ```
  */
-export function createTelemetryRouter() {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const express = require('express');
-    const router = express.Router();
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function createTelemetryRouter(expressModule) {
+    const router = expressModule.Router();
     const getTelemetrySink = () => {
         return getGlobal(TELEMETRY_SINK_KEY);
     };
@@ -110,14 +113,14 @@ export function createTelemetryRouter() {
         <!DOCTYPE html>
         <html>
           <head>
-            <title>Listo Telemetry</title>
+            <title>Telemetry Dashboard</title>
             <style>
               body { font-family: system-ui, sans-serif; padding: 20px; }
               .error { color: #d32f2f; }
             </style>
           </head>
           <body>
-            <h1>Listo Telemetry Dashboard</h1>
+            <h1>Telemetry Dashboard</h1>
             <p class="error">Local telemetry is not enabled.</p>
             <p>To enable, set enableLocalDashboard: true in createMcpObservabilityEasy config.</p>
           </body>
@@ -131,7 +134,7 @@ export function createTelemetryRouter() {
         <head>
           <meta charset="UTF-8">
           <meta name="viewport" content="width=device-width, initial-scale=1.0">
-          <title>Listo Telemetry Dashboard</title>
+          <title>Telemetry Dashboard</title>
           <style>
             * { margin: 0; padding: 0; box-sizing: border-box; }
             body {
@@ -186,7 +189,7 @@ export function createTelemetryRouter() {
               <small style="margin-left: 10px; color: #666;">Auto-refreshes every 5 seconds</small>
             </div>
 
-            <h1>📊 Listo Telemetry Dashboard</h1>
+            <h1>Telemetry Dashboard</h1>
 
             <div class="grid">
               <div class="card">
@@ -270,8 +273,7 @@ export function createTelemetryRouter() {
             : ''}
 
             <p style="margin-top: 40px; color: #999; font-size: 12px;">
-              Last updated: ${new Date().toLocaleTimeString()} |
-              View in <a href="https://app.listoai.co" target="_blank" style="color: #1976d2;">Listo</a>
+              Last updated: ${new Date().toLocaleTimeString()}
             </p>
           </div>
 
@@ -287,7 +289,7 @@ export function createTelemetryRouter() {
             .send(html);
     });
     // UI event ingestion endpoint
-    router.post('/event', express.json({ limit: MAX_EVENT_BODY_SIZE }), (req, res) => {
+    router.post('/event', expressModule.json({ limit: MAX_EVENT_BODY_SIZE }), (req, res) => {
         const validated = validateUiEventBody(req.body);
         if (!validated) {
             res
@@ -301,6 +303,35 @@ export function createTelemetryRouter() {
         }
         res.status(201).json({ ok: true });
     });
+    // Batch UI event ingestion endpoint
+    router.post('/events', expressModule.json({ limit: MAX_EVENT_BODY_SIZE * 100 }), (req, res) => {
+        const body = req.body;
+        if (!body || !Array.isArray(body.events)) {
+            res.status(400).json({ error: 'Expected { events: [...] } array' });
+            return;
+        }
+        const events = body.events;
+        if (events.length > 100) {
+            res.status(400).json({ error: 'Maximum 100 events per batch' });
+            return;
+        }
+        const observability = getGlobal(OBSERVABILITY_KEY);
+        let accepted = 0;
+        let rejected = 0;
+        for (const raw of events) {
+            const validated = validateUiEventBody(raw);
+            if (validated) {
+                if (observability) {
+                    observability.recordUiEvent(validated);
+                }
+                accepted++;
+            }
+            else {
+                rejected++;
+            }
+        }
+        res.status(201).json({ ok: true, accepted, rejected });
+    });
     return router;
 }
 export { TELEMETRY_SINK_KEY, OBSERVABILITY_KEY, setGlobal };

package/dist/index.d.ts

@@ -209,66 +209,6 @@ export declare class InMemorySink implements EventSink {
                 error: number;
             }>;
         };
-        analytics: {
-            search: {
-                topQueries: CountEntry[];
-                topKeywords: CountEntry[];
-                minRatings: CountEntry[];
-                priceLevels: CountEntry[];
-                neighborhoods: CountEntry[];
-                styles: CountEntry[];
-                limits: CountEntry[];
-            };
-            geo: {
-                topCities: CountEntry[];
-                topCountries: CountEntry[];
-            };
-            hotels: {
-                topViewed: {
-                    id: string;
-                    name?: string;
-                    count: number;
-                }[];
-                topBookingClicks: {
-                    id: string;
-                    name?: string;
-                    count: number;
-                }[];
-                topBookingCtr: {
-                    id: string;
-                    name: string | undefined;
-                    clicks: number;
-                    views: number;
-                    ctr: number | null;
-                }[];
-                topWebsiteClicks: {
-                    id: string;
-                    name?: string;
-                    count: number;
-                }[];
-                viewedPriceLevels: CountEntry[];
-                viewedStyles: CountEntry[];
-                viewedCategories: CountEntry[];
-                viewedNeighborhoods: CountEntry[];
-            };
-            ctr: {
-                impressions: number;
-                clicks: number;
-                detailViews: number;
-                bookingClicks: number;
-                websiteClicks: number;
-                bookingPerImpression: number | null;
-                bookingPerDetailView: number | null;
-            };
-            sessions: {
-                total: number;
-                converted: number;
-                booking: number;
-                website: number;
-                conversionRate: number | null;
-                unknownSessionUiEvents: number;
-            };
-        };
     };
 }
 export declare function createConsoleSink(options?: {
@@ -295,10 +235,6 @@ export declare class McpObservability {
     private safeEmit;
 }
 export declare function createMcpObservability(options: ObservabilityOptions): McpObservability;
-type CountEntry = {
-    value: string;
-    count: number;
-};
 export { RemoteSink, createRemoteSink, type RemoteSinkOptions, } from './remote-sink.js';
 export { createMcpObservabilityEasy, type EasySetupConfig, } from './easy-setup.js';
 export { createTelemetryRouter, expressTelemetry } from './endpoints.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -40,7 +40,6 @@ export class InMemorySink {
             sessions: summarizeSessionEvents(sessionEvents),
             ui: summarizeUiEvents(uiEvents),
             business: summarizeBusinessEvents(businessEvents),
-            analytics: computeAnalytics({ uiEvents, businessEvents }),
         };
     }
 }
@@ -112,6 +111,12 @@ export class McpObservability {
             'password',
             'token',
             'secret',
+            'userid',
+            'userlocation',
+            'email',
+            'useremail',
+            'phone',
+            'phonenumber',
         ]).map((key) => key.toLowerCase()));
         this.capturePayloads = options.capturePayloads ?? false;
         this.tenantResolver = options.tenantResolver;
@@ -124,6 +129,9 @@ export class McpObservability {
             service: this.serviceName,
             serviceVersion: this.serviceVersion,
             environment: this.environment,
+            properties: event.properties
+                ? this.sanitizePayload(event.properties)
+                : undefined,
         };
         this.safeEmit(enriched);
     }
@@ -273,7 +281,9 @@ export class McpObservability {
             serviceVersion: this.serviceVersion,
             environment: this.environment,
             name,
-            properties,
+            properties: properties
+                ? this.sanitizePayload(properties)
+                : undefined,
             status,
         };
         this.safeEmit(event);
@@ -469,321 +479,6 @@ function truncatePreview(value) {
         return truncateString(value);
     return value;
 }
-function incMap(map, rawKey, delta = 1) {
-    const key = rawKey.trim();
-    if (!key)
-        return;
-    map.set(key, (map.get(key) ?? 0) + delta);
-}
-function asString(value) {
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number' || typeof value === 'boolean')
-        return String(value);
-    return undefined;
-}
-function asObject(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return undefined;
-    return value;
-}
-function asStringArray(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value
-        .map((v) => asString(v))
-        .filter((v) => typeof v === 'string' && v.trim().length > 0);
-}
-function tokenize(input, stopWords) {
-    const sanitized = input
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, ' ')
-        .trim();
-    if (!sanitized)
-        return [];
-    return sanitized
-        .split(/\s+/)
-        .map((token) => token.trim())
-        .filter((token) => token.length >= 3)
-        .filter((token) => !stopWords.has(token));
-}
-function topEntries(map, limit = 10) {
-    return Array.from(map.entries())
-        .sort((a, b) => b[1] - a[1])
-        .slice(0, limit)
-        .map(([value, count]) => ({ value, count }));
-}
-function topHotelEntries(map, limit = 10) {
-    return Array.from(map.entries())
-        .sort((a, b) => b[1].count - a[1].count)
-        .slice(0, limit)
-        .map(([id, meta]) => ({ id, name: meta.name, count: meta.count }));
-}
-function computeAnalytics(options) {
-    const queryCounts = new Map();
-    const keywordCounts = new Map();
-    const minRatingCounts = new Map();
-    const cityCounts = new Map();
-    const countryCounts = new Map();
-    const hotelViewCounts = new Map();
-    const bookingClickCounts = new Map();
-    const websiteClickCounts = new Map();
-    const searchPriceCounts = new Map();
-    const searchStyleCounts = new Map();
-    const searchNeighborhoodCounts = new Map();
-    const searchLimitCounts = new Map();
-    const viewedPriceCounts = new Map();
-    const viewedStyleCounts = new Map();
-    const viewedCategoryCounts = new Map();
-    const viewedNeighborhoodCounts = new Map();
-    const stopWords = new Set([
-        'a',
-        'an',
-        'and',
-        'are',
-        'as',
-        'at',
-        'be',
-        'but',
-        'by',
-        'for',
-        'from',
-        'has',
-        'have',
-        'hotel',
-        'hotels',
-        'i',
-        'in',
-        'is',
-        'it',
-        'of',
-        'on',
-        'or',
-        'the',
-        'to',
-        'with',
-    ]);
-    const recordQuery = (query) => {
-        const normalized = query.trim();
-        if (!normalized)
-            return;
-        incMap(queryCounts, normalized);
-        tokenize(normalized, stopWords).forEach((token) => incMap(keywordCounts, token));
-    };
-    const recordMinRating = (value) => {
-        const str = asString(value);
-        if (!str)
-            return;
-        incMap(minRatingCounts, str);
-    };
-    const recordCityCountry = (city, country) => {
-        if (city)
-            incMap(cityCounts, city);
-        if (country)
-            incMap(countryCounts, country);
-    };
-    const recordHotelView = (hotelId, name) => {
-        if (!hotelId)
-            return;
-        const existing = hotelViewCounts.get(hotelId) ?? {
-            count: 0,
-            name: undefined,
-        };
-        hotelViewCounts.set(hotelId, {
-            count: existing.count + 1,
-            name: existing.name ?? (name || undefined),
-        });
-    };
-    const recordHotelClick = (map, hotelId, name) => {
-        if (!hotelId)
-            return;
-        const existing = map.get(hotelId) ?? { count: 0, name: undefined };
-        map.set(hotelId, {
-            count: existing.count + 1,
-            name: existing.name ?? (name || undefined),
-        });
-    };
-    const recordList = (map, values) => {
-        const list = asStringArray(values);
-        list.forEach((value) => incMap(map, value));
-    };
-    // Business events (tool-level signals)
-    for (const event of options.businessEvents) {
-        if (event.name === 'hotel_search') {
-            const q = asString(event.properties?.q);
-            if (q)
-                recordQuery(q);
-            recordMinRating(event.properties?.minRating ?? event.properties?.min_rating);
-            recordCityCountry(asString(event.properties?.city), asString(event.properties?.country));
-            recordList(searchPriceCounts, event.properties?.priceLevels);
-            recordList(searchStyleCounts, event.properties?.styles);
-            recordList(searchNeighborhoodCounts, event.properties?.neighborhoods);
-            const limit = asString(event.properties?.limit);
-            if (limit)
-                incMap(searchLimitCounts, limit);
-        }
-        if (event.name === 'hotel_details') {
-            const hotelId = asString(event.properties?.id);
-            const name = asString(event.properties?.name);
-            recordHotelView(hotelId, name);
-            recordCityCountry(asString(event.properties?.city), asString(event.properties?.country));
-            const priceLevel = asString(event.properties?.priceLevel);
-            if (priceLevel)
-                incMap(viewedPriceCounts, priceLevel);
-            recordList(viewedStyleCounts, event.properties?.styles);
-            recordList(viewedCategoryCounts, event.properties?.categories);
-            recordList(viewedNeighborhoodCounts, event.properties?.neighborhoods);
-        }
-    }
-    // UI events (engagement/CTR)
-    for (const event of options.uiEvents) {
-        if (event.name === 'search_results_rendered') {
-            const filters = asObject(event.properties?.rawFilters) ??
-                asObject(event.properties?.filters);
-            const q = asString(filters?.q ?? filters?.query);
-            if (q)
-                recordQuery(q);
-            recordMinRating(filters?.minRating ?? filters?.min_rating);
-            recordList(searchPriceCounts, filters?.priceLevels ?? filters?.price_levels);
-            recordList(searchStyleCounts, filters?.styles);
-            recordList(searchNeighborhoodCounts, filters?.neighborhoods);
-            const limit = asString(filters?.limit);
-            if (limit)
-                incMap(searchLimitCounts, limit);
-        }
-        if (event.name === 'hotel_detail_viewed') {
-            const props = asObject(event.properties);
-            recordHotelView(asString(props?.hotelId), asString(props?.hotelName));
-            recordCityCountry(asString(props?.city), asString(props?.country));
-            const priceLevel = asString(props?.priceLevel);
-            if (priceLevel)
-                incMap(viewedPriceCounts, priceLevel);
-            recordList(viewedStyleCounts, props?.styles);
-            recordList(viewedCategoryCounts, props?.categories);
-            recordList(viewedNeighborhoodCounts, props?.neighborhoods);
-        }
-        if (event.name === 'hotel_selected') {
-            const props = asObject(event.properties);
-            recordHotelView(asString(props?.hotelId), asString(props?.hotelName));
-        }
-        if (event.name === 'booking_cta_click') {
-            const props = asObject(event.properties);
-            const hotelId = asString(props?.hotelId);
-            recordHotelClick(bookingClickCounts, hotelId, asString(props?.hotelName));
-        }
-        if (event.name === 'website_click') {
-            const props = asObject(event.properties);
-            const hotelId = asString(props?.hotelId);
-            recordHotelClick(websiteClickCounts, hotelId, asString(props?.hotelName));
-        }
-    }
-    const impressions = options.uiEvents.filter((e) => e.name === 'widget_impression').length;
-    const clicks = options.uiEvents.filter((e) => e.name === 'widget_click').length;
-    const detailViews = options.uiEvents.filter((e) => e.name === 'hotel_detail_viewed').length;
-    const bookingClicks = Array.from(bookingClickCounts.values()).reduce((acc, entry) => acc + (entry.count || 0), 0);
-    const websiteClicks = Array.from(websiteClickCounts.values()).reduce((acc, entry) => acc + (entry.count || 0), 0);
-    // Backfill missing names from any known hotel views (older clients may omit hotelName).
-    for (const [hotelId, meta] of bookingClickCounts.entries()) {
-        if (!meta.name) {
-            const known = hotelViewCounts.get(hotelId)?.name;
-            if (known)
-                bookingClickCounts.set(hotelId, { ...meta, name: known });
-        }
-    }
-    for (const [hotelId, meta] of websiteClickCounts.entries()) {
-        if (!meta.name) {
-            const known = hotelViewCounts.get(hotelId)?.name;
-            if (known)
-                websiteClickCounts.set(hotelId, { ...meta, name: known });
-        }
-    }
-    const ctrFromImpressions = impressions ? bookingClicks / impressions : null;
-    const ctrFromDetails = detailViews ? bookingClicks / detailViews : null;
-    const topBookingCtr = Array.from(bookingClickCounts.entries())
-        .map(([hotelId, meta]) => {
-        const clicks = meta.count || 0;
-        const views = hotelViewCounts.get(hotelId)?.count ?? 0;
-        const name = meta.name ?? hotelViewCounts.get(hotelId)?.name;
-        return {
-            id: hotelId,
-            name,
-            clicks,
-            views,
-            ctr: views ? clicks / views : null,
-        };
-    })
-        .filter((row) => row.ctr !== null && row.views >= 2)
-        .sort((a, b) => (b.ctr ?? 0) - (a.ctr ?? 0))
-        .slice(0, 8);
-    const sessionsAll = new Set();
-    const sessionsFromImpressions = new Set();
-    const sessionsBooking = new Set();
-    const sessionsWebsite = new Set();
-    let unknownSessionUiEvents = 0;
-    for (const event of options.uiEvents) {
-        const sid = event.sessionId;
-        if (!sid) {
-            unknownSessionUiEvents += 1;
-            continue;
-        }
-        sessionsAll.add(sid);
-        if (event.name === 'widget_impression')
-            sessionsFromImpressions.add(sid);
-        if (event.name === 'booking_cta_click')
-            sessionsBooking.add(sid);
-        if (event.name === 'website_click')
-            sessionsWebsite.add(sid);
-    }
-    const totalSessions = sessionsFromImpressions.size > 0
-        ? sessionsFromImpressions.size
-        : sessionsAll.size;
-    const convertedSessions = new Set([
-        ...Array.from(sessionsBooking),
-        ...Array.from(sessionsWebsite),
-    ]).size;
-    return {
-        search: {
-            topQueries: topEntries(queryCounts, 12),
-            topKeywords: topEntries(keywordCounts, 18),
-            minRatings: topEntries(minRatingCounts, 8),
-            priceLevels: topEntries(searchPriceCounts, 10),
-            neighborhoods: topEntries(searchNeighborhoodCounts, 10),
-            styles: topEntries(searchStyleCounts, 10),
-            limits: topEntries(searchLimitCounts, 8),
-        },
-        geo: {
-            topCities: topEntries(cityCounts, 12),
-            topCountries: topEntries(countryCounts, 12),
-        },
-        hotels: {
-            topViewed: topHotelEntries(hotelViewCounts, 12),
-            topBookingClicks: topHotelEntries(bookingClickCounts, 12),
-            topBookingCtr,
-            topWebsiteClicks: topHotelEntries(websiteClickCounts, 12),
-            viewedPriceLevels: topEntries(viewedPriceCounts, 10),
-            viewedStyles: topEntries(viewedStyleCounts, 10),
-            viewedCategories: topEntries(viewedCategoryCounts, 10),
-            viewedNeighborhoods: topEntries(viewedNeighborhoodCounts, 10),
-        },
-        ctr: {
-            impressions,
-            clicks,
-            detailViews,
-            bookingClicks,
-            websiteClicks,
-            bookingPerImpression: ctrFromImpressions,
-            bookingPerDetailView: ctrFromDetails,
-        },
-        sessions: {
-            total: totalSessions,
-            converted: convertedSessions,
-            booking: sessionsBooking.size,
-            website: sessionsWebsite.size,
-            conversionRate: totalSessions ? convertedSessions / totalSessions : null,
-            unknownSessionUiEvents,
-        },
-    };
-}
 export { RemoteSink, createRemoteSink, } from './remote-sink.js';
 export { createMcpObservabilityEasy, } from './easy-setup.js';
 export { createTelemetryRouter, expressTelemetry } from './endpoints.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@listo-ai/mcp-observability",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Lightweight telemetry SDK for MCP servers and web applications. Captures HTTP requests, MCP tool invocations, business events, and UI interactions with built-in payload sanitization.",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
     }
   },
   "files": [