@metrone-io/server 1.0.0

package/dist/index.js

@@ -0,0 +1,494 @@
+// src/errors.ts
+var MetroneError = class extends Error {
+  code;
+  status;
+  retryable;
+  constructor(code, message, status, retryable = false) {
+    super(message);
+    this.name = "MetroneError";
+    this.code = code;
+    this.status = status;
+    this.retryable = retryable;
+  }
+};
+var MetroneConfigError = class extends MetroneError {
+  constructor(message) {
+    super("CONFIG_INVALID", message);
+    this.name = "MetroneConfigError";
+  }
+};
+var MetroneAuthError = class extends MetroneError {
+  constructor(message = "Invalid or missing API key") {
+    super("AUTH_FAILED", message, 401, false);
+    this.name = "MetroneAuthError";
+  }
+};
+var MetroneRateLimitError = class extends MetroneError {
+  retryAfterMs;
+  constructor(retryAfterMs) {
+    super("RATE_LIMITED", `Rate limit exceeded. Retry after ${retryAfterMs}ms.`, 429, true);
+    this.name = "MetroneRateLimitError";
+    this.retryAfterMs = retryAfterMs;
+  }
+};
+var MetroneQuotaError = class extends MetroneError {
+  constructor(message = "Monthly event quota exceeded") {
+    super("QUOTA_EXCEEDED", message, 429, false);
+    this.name = "MetroneQuotaError";
+  }
+};
+var MetroneNetworkError = class extends MetroneError {
+  constructor(message = "Network request failed") {
+    super("NETWORK_ERROR", message, void 0, true);
+    this.name = "MetroneNetworkError";
+  }
+};
+var MetroneTimeoutError = class extends MetroneError {
+  constructor(timeoutMs) {
+    super("TIMEOUT", `Request timed out after ${timeoutMs}ms`, void 0, true);
+    this.name = "MetroneTimeoutError";
+  }
+};
+var MetroneValidationError = class extends MetroneError {
+  fields;
+  constructor(fields) {
+    const summary = fields.map((f) => `${f.field}: ${f.message}`).join("; ");
+    super("VALIDATION_FAILED", `Validation failed: ${summary}`, 400, false);
+    this.name = "MetroneValidationError";
+    this.fields = fields;
+  }
+};
+var MetroneServerError = class extends MetroneError {
+  constructor(status, message = "Internal server error") {
+    super("SERVER_ERROR", message, status, true);
+    this.name = "MetroneServerError";
+  }
+};
+
+// src/http.ts
+async function httpPost(config, path, body, headers) {
+  return httpRequest(config, "POST", path, body, headers);
+}
+async function httpGet(config, path, params, headers) {
+  let url = path;
+  if (params) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+      if (v !== void 0) qs.set(k, String(v));
+    }
+    const str = qs.toString();
+    if (str) url += `?${str}`;
+  }
+  return httpRequest(config, "GET", url, void 0, headers);
+}
+async function httpRequest(config, method, path, body, extraHeaders) {
+  const url = `${config.endpoint}${path}`;
+  const fetchFn = config.fetch;
+  const headers = {
+    "X-Api-Key": config.apiKey,
+    "User-Agent": "metrone-server-sdk/1.0.0",
+    ...extraHeaders
+  };
+  if (body !== void 0) {
+    headers["Content-Type"] = "application/json";
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), config.timeoutMs);
+  try {
+    const response = await fetchFn(url, {
+      method,
+      headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0,
+      signal: controller.signal
+    });
+    clearTimeout(timer);
+    let data;
+    const ct = response.headers.get("content-type") ?? "";
+    if (ct.includes("application/json")) {
+      data = await response.json();
+    } else {
+      data = await response.text();
+    }
+    if (response.ok) {
+      return { ok: true, status: response.status, data };
+    }
+    const errBody = data;
+    const errMsg = typeof errBody?.error === "string" ? errBody.error : typeof errBody?.error === "object" && errBody.error !== null ? errBody.error.message ?? response.statusText : response.statusText;
+    if (response.status === 401) throw new MetroneAuthError(errMsg);
+    if (response.status === 429) {
+      const retryMs = typeof errBody?.retry_after_ms === "number" ? errBody.retry_after_ms : 6e4;
+      throw new MetroneRateLimitError(retryMs);
+    }
+    if (response.status >= 500) throw new MetroneServerError(response.status, errMsg);
+    return {
+      ok: false,
+      status: response.status,
+      error: { code: "API_ERROR", message: errMsg, details: errBody }
+    };
+  } catch (err) {
+    clearTimeout(timer);
+    if (err instanceof MetroneAuthError) throw err;
+    if (err instanceof MetroneRateLimitError) throw err;
+    if (err instanceof MetroneServerError) throw err;
+    if (err instanceof DOMException && err.name === "AbortError") {
+      throw new MetroneTimeoutError(config.timeoutMs);
+    }
+    if (err instanceof TypeError) {
+      throw new MetroneNetworkError(err.message);
+    }
+    throw new MetroneNetworkError(
+      err instanceof Error ? err.message : "Unknown network error"
+    );
+  }
+}
+async function withRetry(config, fn) {
+  let lastError;
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      const isRetryable = err instanceof MetroneNetworkError || err instanceof MetroneTimeoutError || err instanceof MetroneServerError || err instanceof MetroneRateLimitError;
+      if (!isRetryable || attempt >= config.maxRetries) throw err;
+      const baseDelay = err instanceof MetroneRateLimitError ? err.retryAfterMs : config.retryBaseMs * Math.pow(2, attempt);
+      const jitter = Math.random() * baseDelay * 0.1;
+      const delay = baseDelay + jitter;
+      if (config.debug) {
+        const errLabel = err instanceof Error ? err.message : String(err);
+        console.error(
+          `[metrone] Retry ${attempt + 1}/${config.maxRetries} after ${Math.round(delay)}ms: ${errLabel}`
+        );
+      }
+      await sleep(delay);
+    }
+  }
+  throw lastError;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/client.ts
+var API_KEY_PATTERN = /^(metrone_(live|test)_|mk_(live|test)_)[a-f0-9]{32}$/;
+var MetroneServer = class {
+  config;
+  queue = [];
+  flushTimer = null;
+  flushing = false;
+  destroyed = false;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new MetroneConfigError("apiKey is required");
+    }
+    if (!API_KEY_PATTERN.test(config.apiKey)) {
+      throw new MetroneConfigError(
+        "Invalid apiKey format. Expected metrone_live_*, metrone_test_*, mk_live_*, or mk_test_* followed by 32 hex chars."
+      );
+    }
+    const endpoint = (config.endpoint ?? "https://api.metrone.io").replace(/\/+$/, "");
+    this.config = {
+      apiKey: config.apiKey,
+      endpoint,
+      batchSize: config.batchSize ?? 10,
+      flushIntervalMs: config.flushIntervalMs ?? 5e3,
+      maxRetries: config.maxRetries ?? 3,
+      retryBaseMs: config.retryBaseMs ?? 1e3,
+      timeoutMs: config.timeoutMs ?? 1e4,
+      maxQueueSize: config.maxQueueSize ?? 1e3,
+      debug: config.debug ?? false,
+      fetch: config.fetch ?? globalThis.fetch.bind(globalThis)
+    };
+    if (this.config.batchSize > 0 && this.config.flushIntervalMs > 0) {
+      this.flushTimer = setInterval(() => {
+        this.flush().catch((err) => {
+          if (this.config.debug) {
+            console.error("[metrone] Auto-flush error:", err);
+          }
+        });
+      }, this.config.flushIntervalMs);
+      if (typeof this.flushTimer === "object" && "unref" in this.flushTimer) {
+        this.flushTimer.unref();
+      }
+    }
+    if (this.config.debug) {
+      console.error(`[metrone] Server SDK initialized (endpoint: ${this.config.endpoint})`);
+    }
+  }
+  // ─── Event Tracking ────────────────────────────────────────────────────────
+  /**
+   * Track a custom event. Queued for batch sending unless batchSize is 0.
+   */
+  track(eventType, data) {
+    this.assertNotDestroyed();
+    if (!eventType) throw new MetroneValidationError([{ field: "event_type", message: "required" }]);
+    const event = {
+      api_key: this.config.apiKey,
+      event_type: eventType,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...data
+    };
+    if (this.config.batchSize <= 0) {
+      withRetry(this.config, () => httpPost(this.config, "/v1/events", event)).catch((err) => {
+        if (this.config.debug) console.error("[metrone] Send error:", err);
+      });
+      return;
+    }
+    this.queue.push(event);
+    if (this.queue.length >= this.config.batchSize) {
+      this.flush().catch((err) => {
+        if (this.config.debug) console.error("[metrone] Flush error:", err);
+      });
+    }
+  }
+  /**
+   * Track a page view.
+   */
+  pageview(url, title, data) {
+    this.track("pageview", {
+      page_url: url,
+      page_title: title,
+      source: "web",
+      ...data
+    });
+  }
+  /**
+   * Track a conversion event.
+   */
+  conversion(data) {
+    this.track("conversion", {
+      source: "web",
+      properties: {
+        conversion_type: data.conversion_type,
+        value: data.value,
+        currency: data.currency,
+        ...data.properties
+      }
+    });
+  }
+  // ─── AI Tracking ───────────────────────────────────────────────────────────
+  /**
+   * Track an AI voice call.
+   */
+  trackAICall(data) {
+    this.track("ai_call", {
+      source: "voice",
+      channel: "phone",
+      ai_provider: data.provider ?? "unknown",
+      ai_call_id: data.call_id,
+      ai_intent: data.intent,
+      ai_duration_sec: data.duration,
+      session_id: data.session_id,
+      properties: {
+        transcript_snippet: data.transcript_snippet,
+        outcome: data.outcome,
+        ...data.properties
+      }
+    });
+  }
+  /**
+   * Track an AI chat interaction.
+   */
+  trackAIChat(data) {
+    this.track("ai_chat", {
+      source: "chat",
+      channel: "website",
+      ai_provider: data.provider ?? "unknown",
+      ai_session_id: data.session_id,
+      ai_intent: data.intent,
+      ai_duration_sec: data.duration,
+      properties: {
+        message_count: data.message_count,
+        resolved: data.resolved,
+        ...data.properties
+      }
+    });
+  }
+  /**
+   * Track an AI intent detection.
+   */
+  trackAIIntent(data) {
+    this.track("ai_intent", {
+      source: data.source ?? "assistant",
+      ai_intent: data.intent,
+      properties: {
+        confidence: data.confidence,
+        ...data.properties
+      }
+    });
+  }
+  /**
+   * Track an AI session lifecycle event (start, end, timeout).
+   */
+  trackAISession(data) {
+    this.track(`ai_session_${data.action}`, {
+      source: "assistant",
+      ai_provider: data.provider ?? "unknown",
+      ai_session_id: data.session_id,
+      ai_duration_sec: data.duration,
+      properties: data.properties
+    });
+  }
+  // ─── Read API ──────────────────────────────────────────────────────────────
+  /**
+   * Get aggregated analytics stats for a time period.
+   */
+  async getStats(params) {
+    this.assertNotDestroyed();
+    const qp = this.buildDateParams(params);
+    const res = await withRetry(
+      this.config,
+      () => httpGet(this.config, "/v1/api/stats", qp)
+    );
+    return res.data;
+  }
+  /**
+   * Get individual analytics events with pagination and filters.
+   */
+  async getEvents(params) {
+    this.assertNotDestroyed();
+    const qp = {
+      ...this.buildDateParams(params),
+      limit: params?.limit,
+      offset: params?.offset,
+      event_type: params?.event_type,
+      source: params?.source
+    };
+    const res = await withRetry(
+      this.config,
+      () => httpGet(this.config, "/v1/api/events", qp)
+    );
+    return res.data;
+  }
+  /**
+   * Get page analytics broken down by path.
+   */
+  async getPages(params) {
+    this.assertNotDestroyed();
+    const qp = {
+      ...this.buildDateParams(params),
+      limit: params?.limit
+    };
+    const res = await withRetry(
+      this.config,
+      () => httpGet(this.config, "/v1/api/pages", qp)
+    );
+    return res.data;
+  }
+  /**
+   * Get traffic source and referrer analytics.
+   */
+  async getSources(params) {
+    this.assertNotDestroyed();
+    const qp = this.buildDateParams(params);
+    const res = await withRetry(
+      this.config,
+      () => httpGet(this.config, "/v1/api/sources", qp)
+    );
+    return res.data;
+  }
+  /**
+   * Get real-time live stats (active visitors, today's totals).
+   */
+  async getLive() {
+    this.assertNotDestroyed();
+    const res = await withRetry(
+      this.config,
+      () => httpGet(this.config, "/v1/api/live")
+    );
+    return res.data;
+  }
+  // ─── Batch & Lifecycle ─────────────────────────────────────────────────────
+  /**
+   * Immediately flush all queued events. Returns the result.
+   * Safe to call multiple times concurrently — only one flush runs at a time.
+   */
+  async flush() {
+    if (this.flushing || this.queue.length === 0) {
+      return { sent: 0, failed: 0, errors: [] };
+    }
+    this.flushing = true;
+    const batch = this.queue.splice(0, 100);
+    try {
+      const res = await withRetry(
+        this.config,
+        () => httpPost(this.config, "/v1/events/batch", batch)
+      );
+      const body = res.data;
+      const accepted = typeof body?.accepted === "number" ? body.accepted : batch.length;
+      if (this.config.debug) {
+        console.error(`[metrone] Flushed ${accepted}/${batch.length} events`);
+      }
+      return { sent: accepted, failed: batch.length - accepted, errors: [] };
+    } catch (err) {
+      this.queue.unshift(...batch);
+      if (this.queue.length > this.config.maxQueueSize) {
+        this.queue.length = this.config.maxQueueSize;
+      }
+      if (this.config.debug) {
+        console.error("[metrone] Flush failed, re-queued:", err);
+      }
+      return {
+        sent: 0,
+        failed: batch.length,
+        errors: [{ index: -1, error: err instanceof Error ? err.message : String(err) }]
+      };
+    } finally {
+      this.flushing = false;
+      if (this.queue.length >= this.config.batchSize && this.config.batchSize > 0) {
+        this.flush().catch(() => {
+        });
+      }
+    }
+  }
+  /**
+   * Flush remaining events, stop the auto-flush timer, and mark the
+   * client as destroyed. Subsequent calls will throw.
+   */
+  async shutdown() {
+    if (this.destroyed) return { sent: 0, failed: 0, errors: [] };
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    const result = await this.flush();
+    this.destroyed = true;
+    if (this.config.debug) {
+      console.error("[metrone] Server SDK shut down");
+    }
+    return result;
+  }
+  /** Number of events currently in the send queue. */
+  get queueSize() {
+    return this.queue.length;
+  }
+  /** Whether shutdown() has been called. */
+  get isDestroyed() {
+    return this.destroyed;
+  }
+  // ─── Internal ──────────────────────────────────────────────────────────────
+  assertNotDestroyed() {
+    if (this.destroyed) {
+      throw new MetroneConfigError("Client has been shut down. Create a new instance.");
+    }
+  }
+  buildDateParams(params) {
+    const result = {};
+    if (params?.days) result.days = params.days;
+    if (params?.from) result.from = params.from instanceof Date ? params.from.toISOString() : params.from;
+    if (params?.to) result.to = params.to instanceof Date ? params.to.toISOString() : params.to;
+    return result;
+  }
+};
+export {
+  MetroneAuthError,
+  MetroneConfigError,
+  MetroneError,
+  MetroneNetworkError,
+  MetroneQuotaError,
+  MetroneRateLimitError,
+  MetroneServer,
+  MetroneServerError,
+  MetroneTimeoutError,
+  MetroneValidationError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/client.ts"],"sourcesContent":["/**\n * Structured error types for the Metrone server SDK.\n *\n * All errors carry a machine-readable `code` that agents can switch on,\n * plus a human-readable `message` for logs.\n */\n\nexport class MetroneError extends Error {\n  public readonly code: string\n  public readonly status?: number\n  public readonly retryable: boolean\n\n  constructor(code: string, message: string, status?: number, retryable = false) {\n    super(message)\n    this.name = 'MetroneError'\n    this.code = code\n    this.status = status\n    this.retryable = retryable\n  }\n}\n\nexport class MetroneConfigError extends MetroneError {\n  constructor(message: string) {\n    super('CONFIG_INVALID', message)\n    this.name = 'MetroneConfigError'\n  }\n}\n\nexport class MetroneAuthError extends MetroneError {\n  constructor(message = 'Invalid or missing API key') {\n    super('AUTH_FAILED', message, 401, false)\n    this.name = 'MetroneAuthError'\n  }\n}\n\nexport class MetroneRateLimitError extends MetroneError {\n  public readonly retryAfterMs: number\n\n  constructor(retryAfterMs: number) {\n    super('RATE_LIMITED', `Rate limit exceeded. Retry after ${retryAfterMs}ms.`, 429, true)\n    this.name = 'MetroneRateLimitError'\n    this.retryAfterMs = retryAfterMs\n  }\n}\n\nexport class MetroneQuotaError extends MetroneError {\n  constructor(message = 'Monthly event quota exceeded') {\n    super('QUOTA_EXCEEDED', message, 429, false)\n    this.name = 'MetroneQuotaError'\n  }\n}\n\nexport class MetroneNetworkError extends MetroneError {\n  constructor(message = 'Network request failed') {\n    super('NETWORK_ERROR', message, undefined, true)\n    this.name = 'MetroneNetworkError'\n  }\n}\n\nexport class MetroneTimeoutError extends MetroneError {\n  constructor(timeoutMs: number) {\n    super('TIMEOUT', `Request timed out after ${timeoutMs}ms`, undefined, true)\n    this.name = 'MetroneTimeoutError'\n  }\n}\n\nexport class MetroneValidationError extends MetroneError {\n  public readonly fields: Array<{ field: string; message: string }>\n\n  constructor(fields: Array<{ field: string; message: string }>) {\n    const summary = fields.map(f => `${f.field}: ${f.message}`).join('; ')\n    super('VALIDATION_FAILED', `Validation failed: ${summary}`, 400, false)\n    this.name = 'MetroneValidationError'\n    this.fields = fields\n  }\n}\n\nexport class MetroneServerError extends MetroneError {\n  constructor(status: number, message = 'Internal server error') {\n    super('SERVER_ERROR', message, status, true)\n    this.name = 'MetroneServerError'\n  }\n}\n","/**\n * Runtime-agnostic HTTP layer.\n *\n * Uses the global fetch() which is available in Node 18+, Deno, Bun,\n * Cloudflare Workers, and all modern edge runtimes. A custom fetch can\n * be injected via config for environments that need it.\n */\n\nimport type { ResolvedConfig, ApiResponse } from './types.js'\nimport {\n  MetroneNetworkError,\n  MetroneTimeoutError,\n  MetroneAuthError,\n  MetroneRateLimitError,\n  MetroneServerError,\n} from './errors.js'\n\nexport async function httpPost(\n  config: ResolvedConfig,\n  path: string,\n  body: unknown,\n  headers?: Record<string, string>,\n): Promise<ApiResponse> {\n  return httpRequest(config, 'POST', path, body, headers)\n}\n\nexport async function httpGet(\n  config: ResolvedConfig,\n  path: string,\n  params?: Record<string, string | number | undefined>,\n  headers?: Record<string, string>,\n): Promise<ApiResponse> {\n  let url = path\n  if (params) {\n    const qs = new URLSearchParams()\n    for (const [k, v] of Object.entries(params)) {\n      if (v !== undefined) qs.set(k, String(v))\n    }\n    const str = qs.toString()\n    if (str) url += `?${str}`\n  }\n  return httpRequest(config, 'GET', url, undefined, headers)\n}\n\nasync function httpRequest(\n  config: ResolvedConfig,\n  method: string,\n  path: string,\n  body?: unknown,\n  extraHeaders?: Record<string, string>,\n): Promise<ApiResponse> {\n  const url = `${config.endpoint}${path}`\n  const fetchFn = config.fetch\n\n  const headers: Record<string, string> = {\n    'X-Api-Key': config.apiKey,\n    'User-Agent': 'metrone-server-sdk/1.0.0',\n    ...extraHeaders,\n  }\n\n  if (body !== undefined) {\n    headers['Content-Type'] = 'application/json'\n  }\n\n  const controller = new AbortController()\n  const timer = setTimeout(() => controller.abort(), config.timeoutMs)\n\n  try {\n    const response = await fetchFn(url, {\n      method,\n      headers,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n      signal: controller.signal,\n    })\n\n    clearTimeout(timer)\n\n    let data: unknown\n    const ct = response.headers.get('content-type') ?? ''\n    if (ct.includes('application/json')) {\n      data = await response.json()\n    } else {\n      data = await response.text()\n    }\n\n    if (response.ok) {\n      return { ok: true, status: response.status, data }\n    }\n\n    const errBody = data as Record<string, unknown> | undefined\n    const errMsg = typeof errBody?.error === 'string'\n      ? errBody.error\n      : typeof errBody?.error === 'object' && errBody.error !== null\n        ? (errBody.error as Record<string, unknown>).message as string ?? response.statusText\n        : response.statusText\n\n    if (response.status === 401) throw new MetroneAuthError(errMsg)\n    if (response.status === 429) {\n      const retryMs = typeof errBody?.retry_after_ms === 'number'\n        ? errBody.retry_after_ms\n        : 60_000\n      throw new MetroneRateLimitError(retryMs)\n    }\n    if (response.status >= 500) throw new MetroneServerError(response.status, errMsg)\n\n    return {\n      ok: false,\n      status: response.status,\n      error: { code: 'API_ERROR', message: errMsg, details: errBody },\n    }\n  } catch (err) {\n    clearTimeout(timer)\n\n    if (err instanceof MetroneAuthError) throw err\n    if (err instanceof MetroneRateLimitError) throw err\n    if (err instanceof MetroneServerError) throw err\n\n    if (err instanceof DOMException && err.name === 'AbortError') {\n      throw new MetroneTimeoutError(config.timeoutMs)\n    }\n    if (err instanceof TypeError) {\n      throw new MetroneNetworkError(err.message)\n    }\n\n    throw new MetroneNetworkError(\n      err instanceof Error ? err.message : 'Unknown network error',\n    )\n  }\n}\n\n/**\n * Retry wrapper with exponential backoff.\n * Retries on MetroneNetworkError, MetroneTimeoutError, MetroneServerError,\n * and MetroneRateLimitError. Stops on auth or validation errors.\n */\nexport async function withRetry<T>(\n  config: ResolvedConfig,\n  fn: () => Promise<T>,\n): Promise<T> {\n  let lastError: Error | undefined\n\n  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {\n    try {\n      return await fn()\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err))\n\n      const isRetryable =\n        err instanceof MetroneNetworkError ||\n        err instanceof MetroneTimeoutError ||\n        err instanceof MetroneServerError ||\n        err instanceof MetroneRateLimitError\n\n      if (!isRetryable || attempt >= config.maxRetries) throw err\n\n      const baseDelay = err instanceof MetroneRateLimitError\n        ? err.retryAfterMs\n        : config.retryBaseMs * Math.pow(2, attempt)\n\n      const jitter = Math.random() * baseDelay * 0.1\n      const delay = baseDelay + jitter\n\n      if (config.debug) {\n        const errLabel = err instanceof Error ? err.message : String(err)\n        console.error(\n          `[metrone] Retry ${attempt + 1}/${config.maxRetries} after ${Math.round(delay)}ms: ${errLabel}`,\n        )\n      }\n\n      await sleep(delay)\n    }\n  }\n\n  throw lastError\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms))\n}\n","/**\n * MetroneServer — the main server-side SDK client.\n *\n * Zero dependencies. Uses global fetch (Node 18+, Deno, Bun, edge runtimes).\n * Runtime-agnostic: no DOM, no window, no navigator, no localStorage.\n *\n * Features:\n *  - Event ingestion (single + batch) with automatic batching\n *  - AI tracking (calls, chats, intents, sessions)\n *  - Read API (stats, events, pages, sources, live)\n *  - Retry with exponential backoff + jitter\n *  - Idempotency key support\n *  - Agent identity tracking\n *  - Graceful shutdown with flush()\n */\n\nimport type {\n  MetroneServerConfig,\n  ResolvedConfig,\n  EventPayload,\n  AICallData,\n  AIChatData,\n  AIIntentData,\n  AISessionData,\n  ConversionData,\n  StatsParams,\n  EventsParams,\n  PagesParams,\n  SourcesParams,\n  FlushResult,\n  StatsResponse,\n  EventsResponse,\n  PagesResponse,\n  SourcesResponse,\n  LiveResponse,\n  ApiResponse,\n} from './types.js'\nimport { MetroneConfigError, MetroneValidationError } from './errors.js'\nimport { httpPost, httpGet, withRetry } from './http.js'\n\nconst API_KEY_PATTERN = /^(metrone_(live|test)_|mk_(live|test)_)[a-f0-9]{32}$/\n\nexport class MetroneServer {\n  private readonly config: ResolvedConfig\n  private queue: Array<EventPayload & { api_key: string }> = []\n  private flushTimer: ReturnType<typeof setInterval> | null = null\n  private flushing = false\n  private destroyed = false\n\n  constructor(config: MetroneServerConfig) {\n    if (!config.apiKey) {\n      throw new MetroneConfigError('apiKey is required')\n    }\n    if (!API_KEY_PATTERN.test(config.apiKey)) {\n      throw new MetroneConfigError(\n        'Invalid apiKey format. Expected metrone_live_*, metrone_test_*, mk_live_*, or mk_test_* followed by 32 hex chars.',\n      )\n    }\n\n    const endpoint = (config.endpoint ?? 'https://api.metrone.io').replace(/\\/+$/, '')\n\n    this.config = {\n      apiKey: config.apiKey,\n      endpoint,\n      batchSize: config.batchSize ?? 10,\n      flushIntervalMs: config.flushIntervalMs ?? 5000,\n      maxRetries: config.maxRetries ?? 3,\n      retryBaseMs: config.retryBaseMs ?? 1000,\n      timeoutMs: config.timeoutMs ?? 10_000,\n      maxQueueSize: config.maxQueueSize ?? 1000,\n      debug: config.debug ?? false,\n      fetch: config.fetch ?? globalThis.fetch.bind(globalThis),\n    }\n\n    if (this.config.batchSize > 0 && this.config.flushIntervalMs > 0) {\n      this.flushTimer = setInterval(() => {\n        this.flush().catch(err => {\n          if (this.config.debug) {\n            console.error('[metrone] Auto-flush error:', err)\n          }\n        })\n      }, this.config.flushIntervalMs)\n\n      if (typeof this.flushTimer === 'object' && 'unref' in this.flushTimer) {\n        (this.flushTimer as NodeJS.Timeout).unref()\n      }\n    }\n\n    if (this.config.debug) {\n      console.error(`[metrone] Server SDK initialized (endpoint: ${this.config.endpoint})`)\n    }\n  }\n\n  // ─── Event Tracking ────────────────────────────────────────────────────────\n\n  /**\n   * Track a custom event. Queued for batch sending unless batchSize is 0.\n   */\n  track(eventType: string, data?: Partial<EventPayload>): void {\n    this.assertNotDestroyed()\n    if (!eventType) throw new MetroneValidationError([{ field: 'event_type', message: 'required' }])\n\n    const event: EventPayload & { api_key: string } = {\n      api_key: this.config.apiKey,\n      event_type: eventType,\n      timestamp: new Date().toISOString(),\n      ...data,\n    }\n\n    if (this.config.batchSize <= 0) {\n      withRetry(this.config, () => httpPost(this.config, '/v1/events', event)).catch(err => {\n        if (this.config.debug) console.error('[metrone] Send error:', err)\n      })\n      return\n    }\n\n    this.queue.push(event)\n    if (this.queue.length >= this.config.batchSize) {\n      this.flush().catch(err => {\n        if (this.config.debug) console.error('[metrone] Flush error:', err)\n      })\n    }\n  }\n\n  /**\n   * Track a page view.\n   */\n  pageview(url: string, title?: string, data?: Partial<EventPayload>): void {\n    this.track('pageview', {\n      page_url: url,\n      page_title: title,\n      source: 'web',\n      ...data,\n    })\n  }\n\n  /**\n   * Track a conversion event.\n   */\n  conversion(data: ConversionData): void {\n    this.track('conversion', {\n      source: 'web',\n      properties: {\n        conversion_type: data.conversion_type,\n        value: data.value,\n        currency: data.currency,\n        ...data.properties,\n      },\n    })\n  }\n\n  // ─── AI Tracking ───────────────────────────────────────────────────────────\n\n  /**\n   * Track an AI voice call.\n   */\n  trackAICall(data: AICallData): void {\n    this.track('ai_call', {\n      source: 'voice',\n      channel: 'phone',\n      ai_provider: data.provider ?? 'unknown',\n      ai_call_id: data.call_id,\n      ai_intent: data.intent,\n      ai_duration_sec: data.duration,\n      session_id: data.session_id,\n      properties: {\n        transcript_snippet: data.transcript_snippet,\n        outcome: data.outcome,\n        ...data.properties,\n      },\n    })\n  }\n\n  /**\n   * Track an AI chat interaction.\n   */\n  trackAIChat(data: AIChatData): void {\n    this.track('ai_chat', {\n      source: 'chat',\n      channel: 'website',\n      ai_provider: data.provider ?? 'unknown',\n      ai_session_id: data.session_id,\n      ai_intent: data.intent,\n      ai_duration_sec: data.duration,\n      properties: {\n        message_count: data.message_count,\n        resolved: data.resolved,\n        ...data.properties,\n      },\n    })\n  }\n\n  /**\n   * Track an AI intent detection.\n   */\n  trackAIIntent(data: AIIntentData): void {\n    this.track('ai_intent', {\n      source: data.source ?? 'assistant',\n      ai_intent: data.intent,\n      properties: {\n        confidence: data.confidence,\n        ...data.properties,\n      },\n    })\n  }\n\n  /**\n   * Track an AI session lifecycle event (start, end, timeout).\n   */\n  trackAISession(data: AISessionData): void {\n    this.track(`ai_session_${data.action}`, {\n      source: 'assistant',\n      ai_provider: data.provider ?? 'unknown',\n      ai_session_id: data.session_id,\n      ai_duration_sec: data.duration,\n      properties: data.properties,\n    })\n  }\n\n  // ─── Read API ──────────────────────────────────────────────────────────────\n\n  /**\n   * Get aggregated analytics stats for a time period.\n   */\n  async getStats(params?: StatsParams): Promise<StatsResponse> {\n    this.assertNotDestroyed()\n    const qp = this.buildDateParams(params)\n    const res = await withRetry(this.config, () =>\n      httpGet(this.config, '/v1/api/stats', qp),\n    )\n    return res.data as StatsResponse\n  }\n\n  /**\n   * Get individual analytics events with pagination and filters.\n   */\n  async getEvents(params?: EventsParams): Promise<EventsResponse> {\n    this.assertNotDestroyed()\n    const qp: Record<string, string | number | undefined> = {\n      ...this.buildDateParams(params),\n      limit: params?.limit,\n      offset: params?.offset,\n      event_type: params?.event_type,\n      source: params?.source,\n    }\n    const res = await withRetry(this.config, () =>\n      httpGet(this.config, '/v1/api/events', qp),\n    )\n    return res.data as EventsResponse\n  }\n\n  /**\n   * Get page analytics broken down by path.\n   */\n  async getPages(params?: PagesParams): Promise<PagesResponse> {\n    this.assertNotDestroyed()\n    const qp: Record<string, string | number | undefined> = {\n      ...this.buildDateParams(params),\n      limit: params?.limit,\n    }\n    const res = await withRetry(this.config, () =>\n      httpGet(this.config, '/v1/api/pages', qp),\n    )\n    return res.data as PagesResponse\n  }\n\n  /**\n   * Get traffic source and referrer analytics.\n   */\n  async getSources(params?: SourcesParams): Promise<SourcesResponse> {\n    this.assertNotDestroyed()\n    const qp = this.buildDateParams(params)\n    const res = await withRetry(this.config, () =>\n      httpGet(this.config, '/v1/api/sources', qp),\n    )\n    return res.data as SourcesResponse\n  }\n\n  /**\n   * Get real-time live stats (active visitors, today's totals).\n   */\n  async getLive(): Promise<LiveResponse> {\n    this.assertNotDestroyed()\n    const res = await withRetry(this.config, () =>\n      httpGet(this.config, '/v1/api/live'),\n    )\n    return res.data as LiveResponse\n  }\n\n  // ─── Batch & Lifecycle ─────────────────────────────────────────────────────\n\n  /**\n   * Immediately flush all queued events. Returns the result.\n   * Safe to call multiple times concurrently — only one flush runs at a time.\n   */\n  async flush(): Promise<FlushResult> {\n    if (this.flushing || this.queue.length === 0) {\n      return { sent: 0, failed: 0, errors: [] }\n    }\n\n    this.flushing = true\n    const batch = this.queue.splice(0, 100)\n\n    try {\n      const res = await withRetry(this.config, () =>\n        httpPost(this.config, '/v1/events/batch', batch),\n      )\n\n      const body = res.data as Record<string, unknown> | undefined\n      const accepted = typeof body?.accepted === 'number' ? body.accepted : batch.length\n\n      if (this.config.debug) {\n        console.error(`[metrone] Flushed ${accepted}/${batch.length} events`)\n      }\n\n      return { sent: accepted, failed: batch.length - accepted, errors: [] }\n    } catch (err) {\n      this.queue.unshift(...batch)\n      if (this.queue.length > this.config.maxQueueSize) {\n        this.queue.length = this.config.maxQueueSize\n      }\n\n      if (this.config.debug) {\n        console.error('[metrone] Flush failed, re-queued:', err)\n      }\n\n      return {\n        sent: 0,\n        failed: batch.length,\n        errors: [{ index: -1, error: err instanceof Error ? err.message : String(err) }],\n      }\n    } finally {\n      this.flushing = false\n\n      if (this.queue.length >= this.config.batchSize && this.config.batchSize > 0) {\n        this.flush().catch(() => {})\n      }\n    }\n  }\n\n  /**\n   * Flush remaining events, stop the auto-flush timer, and mark the\n   * client as destroyed. Subsequent calls will throw.\n   */\n  async shutdown(): Promise<FlushResult> {\n    if (this.destroyed) return { sent: 0, failed: 0, errors: [] }\n\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer)\n      this.flushTimer = null\n    }\n\n    const result = await this.flush()\n    this.destroyed = true\n\n    if (this.config.debug) {\n      console.error('[metrone] Server SDK shut down')\n    }\n\n    return result\n  }\n\n  /** Number of events currently in the send queue. */\n  get queueSize(): number {\n    return this.queue.length\n  }\n\n  /** Whether shutdown() has been called. */\n  get isDestroyed(): boolean {\n    return this.destroyed\n  }\n\n  // ─── Internal ──────────────────────────────────────────────────────────────\n\n  private assertNotDestroyed(): void {\n    if (this.destroyed) {\n      throw new MetroneConfigError('Client has been shut down. Create a new instance.')\n    }\n  }\n\n  private buildDateParams(\n    params?: { days?: number; from?: string | Date; to?: string | Date },\n  ): Record<string, string | number | undefined> {\n    const result: Record<string, string | number | undefined> = {}\n    if (params?.days) result.days = params.days\n    if (params?.from) result.from = params.from instanceof Date ? params.from.toISOString() : params.from\n    if (params?.to) result.to = params.to instanceof Date ? params.to.toISOString() : params.to\n    return result\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@metrone-io/server",
+  "version": "1.0.0",
+  "description": "Metrone server-side SDK for Node.js, Deno, Bun, and edge runtimes",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "metrone",
+    "analytics",
+    "server",
+    "ai-agent",
+    "privacy",
+    "tracking",
+    "node",
+    "deno",
+    "bun",
+    "edge"
+  ],
+  "author": "Metrone",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/metrone/metrone.git",
+    "directory": "packages/server"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.2",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}