@validors/sdk 0.1.5

package/README.md

@@ -0,0 +1,189 @@
+# @validors/sdk
+
+Official Node.js SDK for [Validors](https://validors.com) — backend API monitoring and analytics.
+
+Drop in one line of middleware and instantly get:
+- Request volume & error rates per route
+- P50 / P95 / P99 latency percentiles
+- Time-series charts in the Validors dashboard
+
+---
+
+## Prerequisites
+
+1. Create a free account at [validors.com](https://validors.com)
+2. Create a project in the dashboard
+3. Copy your project's API key
+
+---
+
+## Installation
+
+```bash
+npm install @validors/sdk
+# or
+yarn add @validors/sdk
+# or
+pnpm add @validors/sdk
+```
+
+Node.js 18+ is required (uses native `fetch`).
+
+---
+
+## Quick Start
+
+### Express
+
+```ts
+import express from 'express';
+import * as validors from '@validors/sdk';
+
+const app = express();
+
+// Add the middleware as early as possible
+app.use(validors.express({
+  apiKey: process.env.VALIDORS_API_KEY!,
+}));
+
+app.get('/users', (req, res) => {
+  res.json({ users: [] });
+});
+
+app.listen(3000);
+```
+
+### Fastify
+
+```ts
+import Fastify from 'fastify';
+import * as validors from '@validors/sdk';
+
+const fastify = Fastify({ logger: true });
+
+await fastify.register(validors.fastify({ apiKey: process.env.VALIDORS_API_KEY! }));
+
+fastify.get('/users', async () => {
+  return { users: [] };
+});
+
+await fastify.listen({ port: 3000 });
+```
+
+### Hono
+
+```ts
+import { Hono } from 'hono';
+import { createMiddleware } from '@validors/sdk';
+
+const app = new Hono();
+
+app.use('*', createMiddleware({ apiKey: process.env.VALIDORS_API_KEY! }));
+
+app.get('/users', (c) => c.json({ users: [] }));
+
+export default app;
+```
+
+### Cloudflare Workers
+
+```ts
+import { wrapFetch } from '@validors/sdk';
+
+export default {
+  fetch: wrapFetch(
+    { apiKey: process.env.VALIDORS_API_KEY! },
+    async (request) => {
+      return new Response('Hello from the edge!');
+    }
+  ),
+};
+```
+
+---
+
+## Configuration
+
+All options are passed as a `ValidorsOptions` object to any of the middleware factories.
+
+| Option          | Type       | Default                           | Description                                                                   |
+|-----------------|------------|-----------------------------------|-------------------------------------------------------------------------------|
+| `apiKey`        | `string`   | **required**                      | Your project API key from the Validors dashboard.                             |
+| `ingestUrl`     | `string`   | `https://validors.app/api/ingest` | Override the ingest endpoint (useful for self-hosting or local development).  |
+| `flushInterval` | `number`   | `5000`                            | Milliseconds between automatic queue flushes.                                 |
+| `batchSize`     | `number`   | `50`                              | Number of queued events that triggers an immediate flush.                     |
+| `debug`         | `boolean`  | `false`                           | Log debug output to `console` — useful during integration.                   |
+| `ignoreRoutes`  | `string[]` | `[]`                              | Routes to exclude from tracking (exact match or prefix). E.g. `['/health']`. |
+| `environment`   | `string`   | `process.env.NODE_ENV`            | Tag events with an environment label (`production`, `staging`, etc.).         |
+
+---
+
+## Verifying your integration
+
+Enable `debug: true` when first setting up to confirm events are being sent:
+
+```ts
+app.use(validors.express({
+  apiKey: process.env.VALIDORS_API_KEY!,
+  debug: true, // remove once confirmed working
+}));
+```
+
+You'll see logs like:
+
+```
+[validors] queued event: GET /users 200 12ms (queue=1)
+[validors] flushed successfully: received=1
+```
+
+Then open your [Validors dashboard](https://validors.com) — data should appear within seconds.
+
+---
+
+## Graceful Shutdown
+
+The SDK registers `beforeExit` and `SIGTERM` handlers automatically to flush pending events before the process exits. If you manage your own shutdown lifecycle, call `shutdown()` explicitly:
+
+```ts
+import { shutdown } from '@validors/sdk';
+
+process.on('SIGTERM', async () => {
+  await shutdown();
+  process.exit(0);
+});
+```
+
+---
+
+## Troubleshooting
+
+The SDK always logs warnings to `console.warn` if something goes wrong during a flush — even with `debug: false`.
+
+| Message | Cause | Fix |
+|---|---|---|
+| `Invalid or missing API key` | Wrong or missing `apiKey` | Check your key in the [dashboard](https://validors.com) |
+| `Rate limit exceeded` | Too many flushes per minute | Increase `flushInterval` or reduce `batchSize` |
+| `Payload too large` | Batch is over 512 KB | Reduce `batchSize` (default 50 is safe) |
+| `Access denied` | Plan limit reached | [Upgrade your plan](https://validors.com) |
+| `Server error (HTTP 5xx)` | Validors is down | Check [validors.com](https://validors.com) for status |
+
+If you're stuck, visit [validors.com](https://validors.com) for documentation and support.
+
+---
+
+## How it works
+
+Events are collected in an in-memory queue and flushed to the Validors ingest API in batches. This keeps overhead minimal — a single `Date.now()` call per request plus a periodic background HTTP request.
+
+- Network errors during flush are silently swallowed — your app is never impacted.
+- The flush timer uses `timer.unref()` so it never prevents the Node process from exiting.
+
+---
+
+## License
+
+MIT
+
+---
+
+Built with care by the Validors team. Visit [validors.com](https://validors.com) to get started.

package/dist/index.d.mts

@@ -0,0 +1,126 @@
+interface ValidorsOptions {
+    /** Your project API key from the Validors dashboard */
+    apiKey: string;
+    /** Ingest endpoint URL. Defaults to https://validors.app/api/ingest */
+    ingestUrl?: string;
+    /** How often to flush the event queue, in ms. Default: 5000 */
+    flushInterval?: number;
+    /** Max number of events before an automatic flush is triggered. Default: 50 */
+    batchSize?: number;
+    /** Log debug info to console. Default: false */
+    debug?: boolean;
+    /** Route paths to skip (exact match or prefix). E.g. ['/health', '/metrics'] */
+    ignoreRoutes?: string[];
+    /** Environment tag attached to events. Default: process.env.NODE_ENV */
+    environment?: string;
+}
+interface SdkEvent {
+    route: string;
+    method: string;
+    status_code: number;
+    duration_ms: number;
+    error?: string;
+    timestamp: string;
+}
+interface IngestPayload {
+    events: SdkEvent[];
+}
+
+declare class BatchQueue {
+    private queue;
+    private timer;
+    private options;
+    constructor(options: ValidorsOptions);
+    push(event: SdkEvent): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
+/** Flush all pending events immediately. Call before process exit if needed. */
+declare function shutdown(): Promise<void>;
+type ExpressRequest = {
+    method: string;
+    path: string;
+    route?: {
+        path?: string;
+    };
+};
+type ExpressResponse = {
+    statusCode: number;
+    locals: Record<string, unknown>;
+    on(event: string, listener: () => void): void;
+};
+type NextFunction = () => void;
+type ExpressRequestHandler = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void;
+/**
+ * Express middleware that tracks request latency and status codes.
+ *
+ * @example
+ * import * as validors from '@validors/sdk';
+ * app.use(validors.express({ apiKey: 'vl_...' }));
+ */
+declare function express(options: ValidorsOptions): ExpressRequestHandler;
+type FastifyInstance = {
+    addHook(name: "onResponse", fn: (request: FastifyRequest, reply: FastifyReply) => Promise<void>): void;
+};
+type FastifyRequest = {
+    method: string;
+    routerPath?: string;
+    routeOptions?: {
+        url?: string;
+    };
+};
+type FastifyReply = {
+    statusCode: number;
+    elapsedTime?: number;
+};
+type FastifyPlugin = (fastify: FastifyInstance, _opts: Record<string, unknown>, done: () => void) => void;
+/**
+ * Fastify plugin that tracks request latency and status codes.
+ *
+ * @example
+ * import * as validors from '@validors/sdk';
+ * await fastify.register(validors.fastify, { apiKey: 'vl_...' });
+ */
+declare function fastify(options: ValidorsOptions): FastifyPlugin;
+type GenericHandler = (request: Request, env?: unknown) => Promise<Response>;
+/**
+ * Generic fetch-based middleware wrapper for Hono, Cloudflare Workers,
+ * and other edge runtimes.
+ *
+ * Returns a handler that you can use as a Hono middleware or wrap your
+ * existing fetch handler with.
+ *
+ * @example
+ * // Hono
+ * import { Hono } from 'hono';
+ * import { createMiddleware } from '@validors/sdk';
+ *
+ * const app = new Hono();
+ * app.use('*', createMiddleware({ apiKey: 'vl_...' }));
+ */
+declare function createMiddleware(options: ValidorsOptions): (c: {
+    req: {
+        method: string;
+        url: string;
+        routePath?: string;
+    };
+    res?: {
+        status?: number;
+    };
+}, next: () => Promise<void>) => Promise<void>;
+/**
+ * Wrap a generic fetch handler (for edge runtimes like Cloudflare Workers).
+ *
+ * @example
+ * import { wrapFetch } from '@validors/sdk';
+ *
+ * export default {
+ *   fetch: wrapFetch({ apiKey: 'vl_...' }, async (request, env) => {
+ *     return new Response('Hello!');
+ *   })
+ * };
+ */
+declare function wrapFetch(options: ValidorsOptions, handler: GenericHandler): GenericHandler;
+
+export { BatchQueue, type ExpressRequestHandler, type IngestPayload, type SdkEvent, type ValidorsOptions, createMiddleware, BatchQueue as default, express, fastify, shutdown, wrapFetch };

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+interface ValidorsOptions {
+    /** Your project API key from the Validors dashboard */
+    apiKey: string;
+    /** Ingest endpoint URL. Defaults to https://validors.app/api/ingest */
+    ingestUrl?: string;
+    /** How often to flush the event queue, in ms. Default: 5000 */
+    flushInterval?: number;
+    /** Max number of events before an automatic flush is triggered. Default: 50 */
+    batchSize?: number;
+    /** Log debug info to console. Default: false */
+    debug?: boolean;
+    /** Route paths to skip (exact match or prefix). E.g. ['/health', '/metrics'] */
+    ignoreRoutes?: string[];
+    /** Environment tag attached to events. Default: process.env.NODE_ENV */
+    environment?: string;
+}
+interface SdkEvent {
+    route: string;
+    method: string;
+    status_code: number;
+    duration_ms: number;
+    error?: string;
+    timestamp: string;
+}
+interface IngestPayload {
+    events: SdkEvent[];
+}
+
+declare class BatchQueue {
+    private queue;
+    private timer;
+    private options;
+    constructor(options: ValidorsOptions);
+    push(event: SdkEvent): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
+/** Flush all pending events immediately. Call before process exit if needed. */
+declare function shutdown(): Promise<void>;
+type ExpressRequest = {
+    method: string;
+    path: string;
+    route?: {
+        path?: string;
+    };
+};
+type ExpressResponse = {
+    statusCode: number;
+    locals: Record<string, unknown>;
+    on(event: string, listener: () => void): void;
+};
+type NextFunction = () => void;
+type ExpressRequestHandler = (req: ExpressRequest, res: ExpressResponse, next: NextFunction) => void;
+/**
+ * Express middleware that tracks request latency and status codes.
+ *
+ * @example
+ * import * as validors from '@validors/sdk';
+ * app.use(validors.express({ apiKey: 'vl_...' }));
+ */
+declare function express(options: ValidorsOptions): ExpressRequestHandler;
+type FastifyInstance = {
+    addHook(name: "onResponse", fn: (request: FastifyRequest, reply: FastifyReply) => Promise<void>): void;
+};
+type FastifyRequest = {
+    method: string;
+    routerPath?: string;
+    routeOptions?: {
+        url?: string;
+    };
+};
+type FastifyReply = {
+    statusCode: number;
+    elapsedTime?: number;
+};
+type FastifyPlugin = (fastify: FastifyInstance, _opts: Record<string, unknown>, done: () => void) => void;
+/**
+ * Fastify plugin that tracks request latency and status codes.
+ *
+ * @example
+ * import * as validors from '@validors/sdk';
+ * await fastify.register(validors.fastify, { apiKey: 'vl_...' });
+ */
+declare function fastify(options: ValidorsOptions): FastifyPlugin;
+type GenericHandler = (request: Request, env?: unknown) => Promise<Response>;
+/**
+ * Generic fetch-based middleware wrapper for Hono, Cloudflare Workers,
+ * and other edge runtimes.
+ *
+ * Returns a handler that you can use as a Hono middleware or wrap your
+ * existing fetch handler with.
+ *
+ * @example
+ * // Hono
+ * import { Hono } from 'hono';
+ * import { createMiddleware } from '@validors/sdk';
+ *
+ * const app = new Hono();
+ * app.use('*', createMiddleware({ apiKey: 'vl_...' }));
+ */
+declare function createMiddleware(options: ValidorsOptions): (c: {
+    req: {
+        method: string;
+        url: string;
+        routePath?: string;
+    };
+    res?: {
+        status?: number;
+    };
+}, next: () => Promise<void>) => Promise<void>;
+/**
+ * Wrap a generic fetch handler (for edge runtimes like Cloudflare Workers).
+ *
+ * @example
+ * import { wrapFetch } from '@validors/sdk';
+ *
+ * export default {
+ *   fetch: wrapFetch({ apiKey: 'vl_...' }, async (request, env) => {
+ *     return new Response('Hello!');
+ *   })
+ * };
+ */
+declare function wrapFetch(options: ValidorsOptions, handler: GenericHandler): GenericHandler;
+
+export { BatchQueue, type ExpressRequestHandler, type IngestPayload, type SdkEvent, type ValidorsOptions, createMiddleware, BatchQueue as default, express, fastify, shutdown, wrapFetch };

package/dist/index.js

@@ -0,0 +1,263 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BatchQueue: () => BatchQueue,
+  createMiddleware: () => createMiddleware,
+  default: () => index_default,
+  express: () => express,
+  fastify: () => fastify,
+  shutdown: () => shutdown,
+  wrapFetch: () => wrapFetch
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core.ts
+var DEFAULT_INGEST_URL = "https://validors.app/api/ingest";
+var DOCS_URL = "https://validors.com";
+function getErrorMessage(status, apiKey) {
+  const keyHint = `(key: ${apiKey.slice(0, 8)}...)`;
+  switch (status) {
+    case 401:
+      return `[validors] Invalid or missing API key ${keyHint}. Check your key in the dashboard \u2192 ${DOCS_URL}`;
+    case 403:
+      return `[validors] Access denied ${keyHint}. Your plan may not support this. Upgrade at ${DOCS_URL}`;
+    case 400:
+      return `[validors] Bad request \u2014 the event payload was rejected. This is likely a bug. Please report it at ${DOCS_URL}`;
+    case 413:
+      return `[validors] Payload too large. Reduce your batch size or flush more frequently. See ${DOCS_URL}`;
+    case 429:
+      return `[validors] Rate limit exceeded ${keyHint}. Events are being dropped. Reduce flush frequency or upgrade at ${DOCS_URL}`;
+    case 500:
+    case 502:
+    case 503:
+    case 504:
+      return `[validors] Server error (HTTP ${status}). Events may have been lost. Check status at ${DOCS_URL}`;
+    default:
+      return `[validors] Unexpected response (HTTP ${status}). See ${DOCS_URL} for help.`;
+  }
+}
+var DEFAULT_FLUSH_INTERVAL = 5e3;
+var DEFAULT_BATCH_SIZE = 50;
+var BatchQueue = class {
+  constructor(options) {
+    this.queue = [];
+    this.timer = null;
+    this.options = {
+      apiKey: options.apiKey,
+      ingestUrl: options.ingestUrl ?? DEFAULT_INGEST_URL,
+      flushInterval: options.flushInterval ?? DEFAULT_FLUSH_INTERVAL,
+      batchSize: options.batchSize ?? DEFAULT_BATCH_SIZE,
+      debug: options.debug ?? false,
+      ignoreRoutes: options.ignoreRoutes ?? [],
+      environment: options.environment ?? process.env.NODE_ENV ?? "production"
+    };
+    this.timer = setInterval(() => {
+      this.flush().catch(() => void 0);
+    }, this.options.flushInterval);
+    if (this.timer.unref) {
+      this.timer.unref();
+    }
+  }
+  push(event) {
+    for (const ignored of this.options.ignoreRoutes) {
+      if (event.route === ignored || event.route.startsWith(ignored)) return;
+    }
+    this.queue.push(event);
+    if (this.options.debug) {
+      console.log(
+        `[validors] queued event: ${event.method} ${event.route} ${event.status_code} ${event.duration_ms}ms (queue=${this.queue.length})`
+      );
+    }
+    if (this.queue.length >= this.options.batchSize) {
+      this.flush().catch(() => void 0);
+    }
+  }
+  async flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0, this.queue.length);
+    if (this.options.debug) {
+      console.log(`[validors] flushing ${batch.length} events to ${this.options.ingestUrl}`);
+    }
+    const payload = { events: batch };
+    try {
+      const response = await fetch(this.options.ingestUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.options.apiKey
+        },
+        body: JSON.stringify(payload)
+      });
+      if (response.ok) {
+        if (this.options.debug) {
+          const data = await response.json();
+          console.log(`[validors] flushed successfully: received=${data.received}`);
+        }
+      } else {
+        const message = getErrorMessage(response.status, this.options.apiKey);
+        console.warn(message);
+      }
+    } catch (err) {
+      if (this.options.debug) {
+        console.error("[validors] network error during flush:", err);
+      }
+    }
+  }
+  async shutdown() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    await this.flush();
+  }
+};
+
+// src/index.ts
+var _defaultQueue = null;
+function getOrCreateQueue(options) {
+  if (!_defaultQueue) {
+    _defaultQueue = new BatchQueue(options);
+    process.on("beforeExit", () => {
+      _defaultQueue?.flush().catch(() => void 0);
+    });
+    process.on("SIGTERM", () => {
+      _defaultQueue?.shutdown().catch(() => void 0);
+    });
+  }
+  return _defaultQueue;
+}
+async function shutdown() {
+  if (_defaultQueue) {
+    await _defaultQueue.shutdown();
+    _defaultQueue = null;
+  }
+}
+function express(options) {
+  const queue = getOrCreateQueue(options);
+  return function validorsMiddleware(req, res, next) {
+    const startTime = Date.now();
+    res.on("finish", () => {
+      const durationMs = Date.now() - startTime;
+      const route = req.route?.path ?? req.path ?? "unknown";
+      const error = typeof res.locals.error === "string" ? res.locals.error : void 0;
+      const event = {
+        route,
+        method: req.method,
+        status_code: res.statusCode,
+        duration_ms: durationMs,
+        ...error ? { error } : {},
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      queue.push(event);
+    });
+    next();
+  };
+}
+function fastify(options) {
+  const queue = getOrCreateQueue(options);
+  return function validorsFastifyPlugin(fastifyInstance, _opts, done) {
+    fastifyInstance.addHook(
+      "onResponse",
+      async (request, reply) => {
+        const route = request.routerPath ?? request.routeOptions?.url ?? "unknown";
+        const durationMs = typeof reply.elapsedTime === "number" ? Math.round(reply.elapsedTime) : 0;
+        const event = {
+          route,
+          method: request.method,
+          status_code: reply.statusCode,
+          duration_ms: durationMs,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        queue.push(event);
+      }
+    );
+    done();
+  };
+}
+function createMiddleware(options) {
+  const queue = new BatchQueue(options);
+  return async function validorsHonoMiddleware(c, next) {
+    const startTime = Date.now();
+    try {
+      await next();
+    } finally {
+      const durationMs = Date.now() - startTime;
+      let route;
+      try {
+        route = c.req.routePath ?? new URL(c.req.url).pathname ?? "unknown";
+      } catch {
+        route = "unknown";
+      }
+      const statusCode = c.res?.status ?? 200;
+      const event = {
+        route,
+        method: c.req.method,
+        status_code: statusCode,
+        duration_ms: durationMs,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      queue.push(event);
+    }
+  };
+}
+function wrapFetch(options, handler) {
+  const queue = new BatchQueue(options);
+  return async function wrappedFetch(request, env) {
+    const startTime = Date.now();
+    let statusCode = 200;
+    try {
+      const response = await handler(request, env);
+      statusCode = response.status;
+      return response;
+    } catch (err) {
+      statusCode = 500;
+      throw err;
+    } finally {
+      const durationMs = Date.now() - startTime;
+      let route;
+      try {
+        route = new URL(request.url).pathname ?? "unknown";
+      } catch {
+        route = "unknown";
+      }
+      const event = {
+        route,
+        method: request.method,
+        status_code: statusCode,
+        duration_ms: durationMs,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      queue.push(event);
+    }
+  };
+}
+var index_default = BatchQueue;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BatchQueue,
+  createMiddleware,
+  express,
+  fastify,
+  shutdown,
+  wrapFetch
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core.ts"],"sourcesContent":["import { BatchQueue } from \"./core\";\nimport type { ValidorsOptions, SdkEvent } from \"./types\";\n\nexport type { ValidorsOptions, SdkEvent, IngestPayload } from \"./types\";\nexport { BatchQueue } from \"./core\";\n\n// ---------------------------------------------------------------------------\n// Module-level default queue instance (created lazily)\n// ---------------------------------------------------------------------------\n\nlet _defaultQueue: BatchQueue | null = null;\n\nfunction getOrCreateQueue(options: ValidorsOptions): BatchQueue {\n  if (!_defaultQueue) {\n    _defaultQueue = new BatchQueue(options);\n\n    process.on(\"beforeExit\", () => {\n      _defaultQueue?.flush().catch(() => undefined);\n    });\n\n    process.on(\"SIGTERM\", () => {\n      _defaultQueue?.shutdown().catch(() => undefined);\n    });\n  }\n  return _defaultQueue;\n}\n\n/** Flush all pending events immediately. Call before process exit if needed. */\nexport async function shutdown(): Promise<void> {\n  if (_defaultQueue) {\n    await _defaultQueue.shutdown();\n    _defaultQueue = null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Express middleware\n// ---------------------------------------------------------------------------\n\ntype ExpressRequest = {\n  method: string;\n  path: string;\n  route?: { path?: string };\n};\n\ntype ExpressResponse = {\n  statusCode: number;\n  locals: Record<string, unknown>;\n  on(event: string, listener: () => void): void;\n};\n\ntype NextFunction = () => void;\n\nexport type ExpressRequestHandler = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: NextFunction\n) => void;\n\n/**\n * Express middleware that tracks request latency and status codes.\n *\n * @example\n * import * as validors from '@validors/sdk';\n * app.use(validors.express({ apiKey: 'vl_...' }));\n */\nexport function express(options: ValidorsOptions): ExpressRequestHandler {\n  const queue = getOrCreateQueue(options);\n\n  return function validorsMiddleware(\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction\n  ) {\n    const startTime = Date.now();\n\n    res.on(\"finish\", () => {\n      const durationMs = Date.now() - startTime;\n      const route = req.route?.path ?? req.path ?? \"unknown\";\n      const error =\n        typeof res.locals.error === \"string\" ? res.locals.error : undefined;\n\n      const event: SdkEvent = {\n        route,\n        method: req.method,\n        status_code: res.statusCode,\n        duration_ms: durationMs,\n        ...(error ? { error } : {}),\n        timestamp: new Date().toISOString(),\n      };\n\n      queue.push(event);\n    });\n\n    next();\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Fastify plugin\n// ---------------------------------------------------------------------------\n\ntype FastifyInstance = {\n  addHook(\n    name: \"onResponse\",\n    fn: (request: FastifyRequest, reply: FastifyReply) => Promise<void>\n  ): void;\n};\n\ntype FastifyRequest = {\n  method: string;\n  routerPath?: string;\n  routeOptions?: { url?: string };\n};\n\ntype FastifyReply = {\n  statusCode: number;\n  elapsedTime?: number;\n};\n\ntype FastifyPlugin = (\n  fastify: FastifyInstance,\n  _opts: Record<string, unknown>,\n  done: () => void\n) => void;\n\n/**\n * Fastify plugin that tracks request latency and status codes.\n *\n * @example\n * import * as validors from '@validors/sdk';\n * await fastify.register(validors.fastify, { apiKey: 'vl_...' });\n */\nexport function fastify(options: ValidorsOptions): FastifyPlugin {\n  const queue = getOrCreateQueue(options);\n\n  return function validorsFastifyPlugin(\n    fastifyInstance: FastifyInstance,\n    _opts: Record<string, unknown>,\n    done: () => void\n  ) {\n    fastifyInstance.addHook(\n      \"onResponse\",\n      async (request: FastifyRequest, reply: FastifyReply) => {\n        const route =\n          request.routerPath ??\n          request.routeOptions?.url ??\n          \"unknown\";\n\n        const durationMs =\n          typeof reply.elapsedTime === \"number\"\n            ? Math.round(reply.elapsedTime)\n            : 0;\n\n        const event: SdkEvent = {\n          route,\n          method: request.method,\n          status_code: reply.statusCode,\n          duration_ms: durationMs,\n          timestamp: new Date().toISOString(),\n        };\n\n        queue.push(event);\n      }\n    );\n\n    done();\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Generic / Hono / Edge middleware\n// ---------------------------------------------------------------------------\n\ntype GenericHandler = (\n  request: Request,\n  env?: unknown\n) => Promise<Response>;\n\n/**\n * Generic fetch-based middleware wrapper for Hono, Cloudflare Workers,\n * and other edge runtimes.\n *\n * Returns a handler that you can use as a Hono middleware or wrap your\n * existing fetch handler with.\n *\n * @example\n * // Hono\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@validors/sdk';\n *\n * const app = new Hono();\n * app.use('*', createMiddleware({ apiKey: 'vl_...' }));\n */\nexport function createMiddleware(options: ValidorsOptions) {\n  const queue = new BatchQueue(options);\n\n  return async function validorsHonoMiddleware(\n    c: {\n      req: { method: string; url: string; routePath?: string };\n      res?: { status?: number };\n    },\n    next: () => Promise<void>\n  ) {\n    const startTime = Date.now();\n\n    try {\n      await next();\n    } finally {\n      const durationMs = Date.now() - startTime;\n\n      let route: string;\n      try {\n        route = c.req.routePath ?? new URL(c.req.url).pathname ?? \"unknown\";\n      } catch {\n        route = \"unknown\";\n      }\n\n      const statusCode = c.res?.status ?? 200;\n\n      const event: SdkEvent = {\n        route,\n        method: c.req.method,\n        status_code: statusCode,\n        duration_ms: durationMs,\n        timestamp: new Date().toISOString(),\n      };\n\n      queue.push(event);\n    }\n  };\n}\n\n/**\n * Wrap a generic fetch handler (for edge runtimes like Cloudflare Workers).\n *\n * @example\n * import { wrapFetch } from '@validors/sdk';\n *\n * export default {\n *   fetch: wrapFetch({ apiKey: 'vl_...' }, async (request, env) => {\n *     return new Response('Hello!');\n *   })\n * };\n */\nexport function wrapFetch(\n  options: ValidorsOptions,\n  handler: GenericHandler\n): GenericHandler {\n  const queue = new BatchQueue(options);\n\n  return async function wrappedFetch(request: Request, env?: unknown) {\n    const startTime = Date.now();\n    let statusCode = 200;\n\n    try {\n      const response = await handler(request, env);\n      statusCode = response.status;\n      return response;\n    } catch (err) {\n      statusCode = 500;\n      throw err;\n    } finally {\n      const durationMs = Date.now() - startTime;\n\n      let route: string;\n      try {\n        route = new URL(request.url).pathname ?? \"unknown\";\n      } catch {\n        route = \"unknown\";\n      }\n\n      const event: SdkEvent = {\n        route,\n        method: request.method,\n        status_code: statusCode,\n        duration_ms: durationMs,\n        timestamp: new Date().toISOString(),\n      };\n\n      queue.push(event);\n    }\n  };\n}\n\nexport default BatchQueue;\n","import type { ValidorsOptions, SdkEvent, IngestPayload } from \"./types\";\n\nconst DEFAULT_INGEST_URL = \"https://validors.app/api/ingest\";\nconst DOCS_URL = \"https://validors.com\";\n\nfunction getErrorMessage(status: number, apiKey: string): string {\n  const keyHint = `(key: ${apiKey.slice(0, 8)}...)`;\n\n  switch (status) {\n    case 401:\n      return (\n        `[validors] Invalid or missing API key ${keyHint}. ` +\n        `Check your key in the dashboard → ${DOCS_URL}`\n      );\n    case 403:\n      return (\n        `[validors] Access denied ${keyHint}. Your plan may not support this. ` +\n        `Upgrade at ${DOCS_URL}`\n      );\n    case 400:\n      return (\n        `[validors] Bad request — the event payload was rejected. ` +\n        `This is likely a bug. Please report it at ${DOCS_URL}`\n      );\n    case 413:\n      return (\n        `[validors] Payload too large. ` +\n        `Reduce your batch size or flush more frequently. See ${DOCS_URL}`\n      );\n    case 429:\n      return (\n        `[validors] Rate limit exceeded ${keyHint}. ` +\n        `Events are being dropped. Reduce flush frequency or upgrade at ${DOCS_URL}`\n      );\n    case 500:\n    case 502:\n    case 503:\n    case 504:\n      return (\n        `[validors] Server error (HTTP ${status}). ` +\n        `Events may have been lost. Check status at ${DOCS_URL}`\n      );\n    default:\n      return (\n        `[validors] Unexpected response (HTTP ${status}). ` +\n        `See ${DOCS_URL} for help.`\n      );\n  }\n}\nconst DEFAULT_FLUSH_INTERVAL = 5000;\nconst DEFAULT_BATCH_SIZE = 50;\n\nexport class BatchQueue {\n  private queue: SdkEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private options: Required<ValidorsOptions>;\n\n  constructor(options: ValidorsOptions) {\n    this.options = {\n      apiKey: options.apiKey,\n      ingestUrl: options.ingestUrl ?? DEFAULT_INGEST_URL,\n      flushInterval: options.flushInterval ?? DEFAULT_FLUSH_INTERVAL,\n      batchSize: options.batchSize ?? DEFAULT_BATCH_SIZE,\n      debug: options.debug ?? false,\n      ignoreRoutes: options.ignoreRoutes ?? [],\n      environment: options.environment ?? process.env.NODE_ENV ?? \"production\",\n    };\n\n    this.timer = setInterval(() => {\n      this.flush().catch(() => undefined);\n    }, this.options.flushInterval);\n\n    // Allow process to exit even if timer is active\n    if (this.timer.unref) {\n      this.timer.unref();\n    }\n  }\n\n  push(event: SdkEvent): void {\n    // Check ignored routes\n    for (const ignored of this.options.ignoreRoutes) {\n      if (event.route === ignored || event.route.startsWith(ignored)) return;\n    }\n\n    this.queue.push(event);\n\n    if (this.options.debug) {\n      console.log(\n        `[validors] queued event: ${event.method} ${event.route} ${event.status_code} ${event.duration_ms}ms (queue=${this.queue.length})`\n      );\n    }\n\n    if (this.queue.length >= this.options.batchSize) {\n      this.flush().catch(() => undefined);\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const batch = this.queue.splice(0, this.queue.length);\n\n    if (this.options.debug) {\n      console.log(`[validors] flushing ${batch.length} events to ${this.options.ingestUrl}`);\n    }\n\n    const payload: IngestPayload = { events: batch };\n\n    try {\n      const response = await fetch(this.options.ingestUrl, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.options.apiKey,\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (response.ok) {\n        if (this.options.debug) {\n          const data = await response.json() as { received?: number };\n          console.log(`[validors] flushed successfully: received=${data.received}`);\n        }\n      } else {\n        const message = getErrorMessage(response.status, this.options.apiKey);\n        console.warn(message);\n      }\n    } catch (err) {\n      // Never throw — silently swallow network errors\n      if (this.options.debug) {\n        console.error(\"[validors] network error during flush:\", err);\n      }\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n    await this.flush();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,231 @@
+// src/core.ts
+var DEFAULT_INGEST_URL = "https://validors.app/api/ingest";
+var DOCS_URL = "https://validors.com";
+function getErrorMessage(status, apiKey) {
+  const keyHint = `(key: ${apiKey.slice(0, 8)}...)`;
+  switch (status) {
+    case 401:
+      return `[validors] Invalid or missing API key ${keyHint}. Check your key in the dashboard \u2192 ${DOCS_URL}`;
+    case 403:
+      return `[validors] Access denied ${keyHint}. Your plan may not support this. Upgrade at ${DOCS_URL}`;
+    case 400:
+      return `[validors] Bad request \u2014 the event payload was rejected. This is likely a bug. Please report it at ${DOCS_URL}`;
+    case 413:
+      return `[validors] Payload too large. Reduce your batch size or flush more frequently. See ${DOCS_URL}`;
+    case 429:
+      return `[validors] Rate limit exceeded ${keyHint}. Events are being dropped. Reduce flush frequency or upgrade at ${DOCS_URL}`;
+    case 500:
+    case 502:
+    case 503:
+    case 504:
+      return `[validors] Server error (HTTP ${status}). Events may have been lost. Check status at ${DOCS_URL}`;
+    default:
+      return `[validors] Unexpected response (HTTP ${status}). See ${DOCS_URL} for help.`;
+  }
+}
+var DEFAULT_FLUSH_INTERVAL = 5e3;
+var DEFAULT_BATCH_SIZE = 50;
+var BatchQueue = class {
+  constructor(options) {
+    this.queue = [];
+    this.timer = null;
+    this.options = {
+      apiKey: options.apiKey,
+      ingestUrl: options.ingestUrl ?? DEFAULT_INGEST_URL,
+      flushInterval: options.flushInterval ?? DEFAULT_FLUSH_INTERVAL,
+      batchSize: options.batchSize ?? DEFAULT_BATCH_SIZE,
+      debug: options.debug ?? false,
+      ignoreRoutes: options.ignoreRoutes ?? [],
+      environment: options.environment ?? process.env.NODE_ENV ?? "production"
+    };
+    this.timer = setInterval(() => {
+      this.flush().catch(() => void 0);
+    }, this.options.flushInterval);
+    if (this.timer.unref) {
+      this.timer.unref();
+    }
+  }
+  push(event) {
+    for (const ignored of this.options.ignoreRoutes) {
+      if (event.route === ignored || event.route.startsWith(ignored)) return;
+    }
+    this.queue.push(event);
+    if (this.options.debug) {
+      console.log(
+        `[validors] queued event: ${event.method} ${event.route} ${event.status_code} ${event.duration_ms}ms (queue=${this.queue.length})`
+      );
+    }
+    if (this.queue.length >= this.options.batchSize) {
+      this.flush().catch(() => void 0);
+    }
+  }
+  async flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0, this.queue.length);
+    if (this.options.debug) {
+      console.log(`[validors] flushing ${batch.length} events to ${this.options.ingestUrl}`);
+    }
+    const payload = { events: batch };
+    try {
+      const response = await fetch(this.options.ingestUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.options.apiKey
+        },
+        body: JSON.stringify(payload)
+      });
+      if (response.ok) {
+        if (this.options.debug) {
+          const data = await response.json();
+          console.log(`[validors] flushed successfully: received=${data.received}`);
+        }
+      } else {
+        const message = getErrorMessage(response.status, this.options.apiKey);
+        console.warn(message);
+      }
+    } catch (err) {
+      if (this.options.debug) {
+        console.error("[validors] network error during flush:", err);
+      }
+    }
+  }
+  async shutdown() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    await this.flush();
+  }
+};
+
+// src/index.ts
+var _defaultQueue = null;
+function getOrCreateQueue(options) {
+  if (!_defaultQueue) {
+    _defaultQueue = new BatchQueue(options);
+    process.on("beforeExit", () => {
+      _defaultQueue?.flush().catch(() => void 0);
+    });
+    process.on("SIGTERM", () => {
+      _defaultQueue?.shutdown().catch(() => void 0);
+    });
+  }
+  return _defaultQueue;
+}
+async function shutdown() {
+  if (_defaultQueue) {
+    await _defaultQueue.shutdown();
+    _defaultQueue = null;
+  }
+}
+function express(options) {
+  const queue = getOrCreateQueue(options);
+  return function validorsMiddleware(req, res, next) {
+    const startTime = Date.now();
+    res.on("finish", () => {
+      const durationMs = Date.now() - startTime;
+      const route = req.route?.path ?? req.path ?? "unknown";
+      const error = typeof res.locals.error === "string" ? res.locals.error : void 0;
+      const event = {
+        route,
+        method: req.method,
+        status_code: res.statusCode,
+        duration_ms: durationMs,
+        ...error ? { error } : {},
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      queue.push(event);
+    });
+    next();
+  };
+}
+function fastify(options) {
+  const queue = getOrCreateQueue(options);
+  return function validorsFastifyPlugin(fastifyInstance, _opts, done) {
+    fastifyInstance.addHook(
+      "onResponse",
+      async (request, reply) => {
+        const route = request.routerPath ?? request.routeOptions?.url ?? "unknown";
+        const durationMs = typeof reply.elapsedTime === "number" ? Math.round(reply.elapsedTime) : 0;
+        const event = {
+          route,
+          method: request.method,
+          status_code: reply.statusCode,
+          duration_ms: durationMs,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        queue.push(event);
+      }
+    );
+    done();
+  };
+}
+function createMiddleware(options) {
+  const queue = new BatchQueue(options);
+  return async function validorsHonoMiddleware(c, next) {
+    const startTime = Date.now();
+    try {
+      await next();
+    } finally {
+      const durationMs = Date.now() - startTime;
+      let route;
+      try {
+        route = c.req.routePath ?? new URL(c.req.url).pathname ?? "unknown";
+      } catch {
+        route = "unknown";
+      }
+      const statusCode = c.res?.status ?? 200;
+      const event = {
+        route,
+        method: c.req.method,
+        status_code: statusCode,
+        duration_ms: durationMs,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      queue.push(event);
+    }
+  };
+}
+function wrapFetch(options, handler) {
+  const queue = new BatchQueue(options);
+  return async function wrappedFetch(request, env) {
+    const startTime = Date.now();
+    let statusCode = 200;
+    try {
+      const response = await handler(request, env);
+      statusCode = response.status;
+      return response;
+    } catch (err) {
+      statusCode = 500;
+      throw err;
+    } finally {
+      const durationMs = Date.now() - startTime;
+      let route;
+      try {
+        route = new URL(request.url).pathname ?? "unknown";
+      } catch {
+        route = "unknown";
+      }
+      const event = {
+        route,
+        method: request.method,
+        status_code: statusCode,
+        duration_ms: durationMs,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      queue.push(event);
+    }
+  };
+}
+var index_default = BatchQueue;
+export {
+  BatchQueue,
+  createMiddleware,
+  index_default as default,
+  express,
+  fastify,
+  shutdown,
+  wrapFetch
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/index.ts"],"sourcesContent":["import type { ValidorsOptions, SdkEvent, IngestPayload } from \"./types\";\n\nconst DEFAULT_INGEST_URL = \"https://validors.app/api/ingest\";\nconst DOCS_URL = \"https://validors.com\";\n\nfunction getErrorMessage(status: number, apiKey: string): string {\n  const keyHint = `(key: ${apiKey.slice(0, 8)}...)`;\n\n  switch (status) {\n    case 401:\n      return (\n        `[validors] Invalid or missing API key ${keyHint}. ` +\n        `Check your key in the dashboard → ${DOCS_URL}`\n      );\n    case 403:\n      return (\n        `[validors] Access denied ${keyHint}. Your plan may not support this. ` +\n        `Upgrade at ${DOCS_URL}`\n      );\n    case 400:\n      return (\n        `[validors] Bad request — the event payload was rejected. ` +\n        `This is likely a bug. Please report it at ${DOCS_URL}`\n      );\n    case 413:\n      return (\n        `[validors] Payload too large. ` +\n        `Reduce your batch size or flush more frequently. See ${DOCS_URL}`\n      );\n    case 429:\n      return (\n        `[validors] Rate limit exceeded ${keyHint}. ` +\n        `Events are being dropped. Reduce flush frequency or upgrade at ${DOCS_URL}`\n      );\n    case 500:\n    case 502:\n    case 503:\n    case 504:\n      return (\n        `[validors] Server error (HTTP ${status}). ` +\n        `Events may have been lost. Check status at ${DOCS_URL}`\n      );\n    default:\n      return (\n        `[validors] Unexpected response (HTTP ${status}). ` +\n        `See ${DOCS_URL} for help.`\n      );\n  }\n}\nconst DEFAULT_FLUSH_INTERVAL = 5000;\nconst DEFAULT_BATCH_SIZE = 50;\n\nexport class BatchQueue {\n  private queue: SdkEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private options: Required<ValidorsOptions>;\n\n  constructor(options: ValidorsOptions) {\n    this.options = {\n      apiKey: options.apiKey,\n      ingestUrl: options.ingestUrl ?? DEFAULT_INGEST_URL,\n      flushInterval: options.flushInterval ?? DEFAULT_FLUSH_INTERVAL,\n      batchSize: options.batchSize ?? DEFAULT_BATCH_SIZE,\n      debug: options.debug ?? false,\n      ignoreRoutes: options.ignoreRoutes ?? [],\n      environment: options.environment ?? process.env.NODE_ENV ?? \"production\",\n    };\n\n    this.timer = setInterval(() => {\n      this.flush().catch(() => undefined);\n    }, this.options.flushInterval);\n\n    // Allow process to exit even if timer is active\n    if (this.timer.unref) {\n      this.timer.unref();\n    }\n  }\n\n  push(event: SdkEvent): void {\n    // Check ignored routes\n    for (const ignored of this.options.ignoreRoutes) {\n      if (event.route === ignored || event.route.startsWith(ignored)) return;\n    }\n\n    this.queue.push(event);\n\n    if (this.options.debug) {\n      console.log(\n        `[validors] queued event: ${event.method} ${event.route} ${event.status_code} ${event.duration_ms}ms (queue=${this.queue.length})`\n      );\n    }\n\n    if (this.queue.length >= this.options.batchSize) {\n      this.flush().catch(() => undefined);\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n\n    const batch = this.queue.splice(0, this.queue.length);\n\n    if (this.options.debug) {\n      console.log(`[validors] flushing ${batch.length} events to ${this.options.ingestUrl}`);\n    }\n\n    const payload: IngestPayload = { events: batch };\n\n    try {\n      const response = await fetch(this.options.ingestUrl, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.options.apiKey,\n        },\n        body: JSON.stringify(payload),\n      });\n\n      if (response.ok) {\n        if (this.options.debug) {\n          const data = await response.json() as { received?: number };\n          console.log(`[validors] flushed successfully: received=${data.received}`);\n        }\n      } else {\n        const message = getErrorMessage(response.status, this.options.apiKey);\n        console.warn(message);\n      }\n    } catch (err) {\n      // Never throw — silently swallow network errors\n      if (this.options.debug) {\n        console.error(\"[validors] network error during flush:\", err);\n      }\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n    await this.flush();\n  }\n}\n","import { BatchQueue } from \"./core\";\nimport type { ValidorsOptions, SdkEvent } from \"./types\";\n\nexport type { ValidorsOptions, SdkEvent, IngestPayload } from \"./types\";\nexport { BatchQueue } from \"./core\";\n\n// ---------------------------------------------------------------------------\n// Module-level default queue instance (created lazily)\n// ---------------------------------------------------------------------------\n\nlet _defaultQueue: BatchQueue | null = null;\n\nfunction getOrCreateQueue(options: ValidorsOptions): BatchQueue {\n  if (!_defaultQueue) {\n    _defaultQueue = new BatchQueue(options);\n\n    process.on(\"beforeExit\", () => {\n      _defaultQueue?.flush().catch(() => undefined);\n    });\n\n    process.on(\"SIGTERM\", () => {\n      _defaultQueue?.shutdown().catch(() => undefined);\n    });\n  }\n  return _defaultQueue;\n}\n\n/** Flush all pending events immediately. Call before process exit if needed. */\nexport async function shutdown(): Promise<void> {\n  if (_defaultQueue) {\n    await _defaultQueue.shutdown();\n    _defaultQueue = null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Express middleware\n// ---------------------------------------------------------------------------\n\ntype ExpressRequest = {\n  method: string;\n  path: string;\n  route?: { path?: string };\n};\n\ntype ExpressResponse = {\n  statusCode: number;\n  locals: Record<string, unknown>;\n  on(event: string, listener: () => void): void;\n};\n\ntype NextFunction = () => void;\n\nexport type ExpressRequestHandler = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: NextFunction\n) => void;\n\n/**\n * Express middleware that tracks request latency and status codes.\n *\n * @example\n * import * as validors from '@validors/sdk';\n * app.use(validors.express({ apiKey: 'vl_...' }));\n */\nexport function express(options: ValidorsOptions): ExpressRequestHandler {\n  const queue = getOrCreateQueue(options);\n\n  return function validorsMiddleware(\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction\n  ) {\n    const startTime = Date.now();\n\n    res.on(\"finish\", () => {\n      const durationMs = Date.now() - startTime;\n      const route = req.route?.path ?? req.path ?? \"unknown\";\n      const error =\n        typeof res.locals.error === \"string\" ? res.locals.error : undefined;\n\n      const event: SdkEvent = {\n        route,\n        method: req.method,\n        status_code: res.statusCode,\n        duration_ms: durationMs,\n        ...(error ? { error } : {}),\n        timestamp: new Date().toISOString(),\n      };\n\n      queue.push(event);\n    });\n\n    next();\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Fastify plugin\n// ---------------------------------------------------------------------------\n\ntype FastifyInstance = {\n  addHook(\n    name: \"onResponse\",\n    fn: (request: FastifyRequest, reply: FastifyReply) => Promise<void>\n  ): void;\n};\n\ntype FastifyRequest = {\n  method: string;\n  routerPath?: string;\n  routeOptions?: { url?: string };\n};\n\ntype FastifyReply = {\n  statusCode: number;\n  elapsedTime?: number;\n};\n\ntype FastifyPlugin = (\n  fastify: FastifyInstance,\n  _opts: Record<string, unknown>,\n  done: () => void\n) => void;\n\n/**\n * Fastify plugin that tracks request latency and status codes.\n *\n * @example\n * import * as validors from '@validors/sdk';\n * await fastify.register(validors.fastify, { apiKey: 'vl_...' });\n */\nexport function fastify(options: ValidorsOptions): FastifyPlugin {\n  const queue = getOrCreateQueue(options);\n\n  return function validorsFastifyPlugin(\n    fastifyInstance: FastifyInstance,\n    _opts: Record<string, unknown>,\n    done: () => void\n  ) {\n    fastifyInstance.addHook(\n      \"onResponse\",\n      async (request: FastifyRequest, reply: FastifyReply) => {\n        const route =\n          request.routerPath ??\n          request.routeOptions?.url ??\n          \"unknown\";\n\n        const durationMs =\n          typeof reply.elapsedTime === \"number\"\n            ? Math.round(reply.elapsedTime)\n            : 0;\n\n        const event: SdkEvent = {\n          route,\n          method: request.method,\n          status_code: reply.statusCode,\n          duration_ms: durationMs,\n          timestamp: new Date().toISOString(),\n        };\n\n        queue.push(event);\n      }\n    );\n\n    done();\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Generic / Hono / Edge middleware\n// ---------------------------------------------------------------------------\n\ntype GenericHandler = (\n  request: Request,\n  env?: unknown\n) => Promise<Response>;\n\n/**\n * Generic fetch-based middleware wrapper for Hono, Cloudflare Workers,\n * and other edge runtimes.\n *\n * Returns a handler that you can use as a Hono middleware or wrap your\n * existing fetch handler with.\n *\n * @example\n * // Hono\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@validors/sdk';\n *\n * const app = new Hono();\n * app.use('*', createMiddleware({ apiKey: 'vl_...' }));\n */\nexport function createMiddleware(options: ValidorsOptions) {\n  const queue = new BatchQueue(options);\n\n  return async function validorsHonoMiddleware(\n    c: {\n      req: { method: string; url: string; routePath?: string };\n      res?: { status?: number };\n    },\n    next: () => Promise<void>\n  ) {\n    const startTime = Date.now();\n\n    try {\n      await next();\n    } finally {\n      const durationMs = Date.now() - startTime;\n\n      let route: string;\n      try {\n        route = c.req.routePath ?? new URL(c.req.url).pathname ?? \"unknown\";\n      } catch {\n        route = \"unknown\";\n      }\n\n      const statusCode = c.res?.status ?? 200;\n\n      const event: SdkEvent = {\n        route,\n        method: c.req.method,\n        status_code: statusCode,\n        duration_ms: durationMs,\n        timestamp: new Date().toISOString(),\n      };\n\n      queue.push(event);\n    }\n  };\n}\n\n/**\n * Wrap a generic fetch handler (for edge runtimes like Cloudflare Workers).\n *\n * @example\n * import { wrapFetch } from '@validors/sdk';\n *\n * export default {\n *   fetch: wrapFetch({ apiKey: 'vl_...' }, async (request, env) => {\n *     return new Response('Hello!');\n *   })\n * };\n */\nexport function wrapFetch(\n  options: ValidorsOptions,\n  handler: GenericHandler\n): GenericHandler {\n  const queue = new BatchQueue(options);\n\n  return async function wrappedFetch(request: Request, env?: unknown) {\n    const startTime = Date.now();\n    let statusCode = 200;\n\n    try {\n      const response = await handler(request, env);\n      statusCode = response.status;\n      return response;\n    } catch (err) {\n      statusCode = 500;\n      throw err;\n    } finally {\n      const durationMs = Date.now() - startTime;\n\n      let route: string;\n      try {\n        route = new URL(request.url).pathname ?? \"unknown\";\n      } catch {\n        route = \"unknown\";\n      }\n\n      const event: SdkEvent = {\n        route,\n        method: request.method,\n        status_code: statusCode,\n        duration_ms: durationMs,\n        timestamp: new Date().toISOString(),\n      };\n\n      queue.push(event);\n    }\n  };\n}\n\nexport default BatchQueue;\n"],"mappings":";AAEA,IAAM,qBAAqB;AAC3B,IAAM,WAAW;AAEjB,SAAS,gBAAgB,QAAgB,QAAwB;AAC/D,QAAM,UAAU,SAAS,OAAO,MAAM,GAAG,CAAC,CAAC;AAE3C,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aACE,yCAAyC,OAAO,4CACX,QAAQ;AAAA,IAEjD,KAAK;AACH,aACE,4BAA4B,OAAO,gDACrB,QAAQ;AAAA,IAE1B,KAAK;AACH,aACE,2GAC6C,QAAQ;AAAA,IAEzD,KAAK;AACH,aACE,sFACwD,QAAQ;AAAA,IAEpE,KAAK;AACH,aACE,kCAAkC,OAAO,oEACyB,QAAQ;AAAA,IAE9E,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aACE,iCAAiC,MAAM,iDACO,QAAQ;AAAA,IAE1D;AACE,aACE,wCAAwC,MAAM,UACvC,QAAQ;AAAA,EAErB;AACF;AACA,IAAM,yBAAyB;AAC/B,IAAM,qBAAqB;AAEpB,IAAM,aAAN,MAAiB;AAAA,EAKtB,YAAY,SAA0B;AAJtC,SAAQ,QAAoB,CAAC;AAC7B,SAAQ,QAA+C;AAIrD,SAAK,UAAU;AAAA,MACb,QAAQ,QAAQ;AAAA,MAChB,WAAW,QAAQ,aAAa;AAAA,MAChC,eAAe,QAAQ,iBAAiB;AAAA,MACxC,WAAW,QAAQ,aAAa;AAAA,MAChC,OAAO,QAAQ,SAAS;AAAA,MACxB,cAAc,QAAQ,gBAAgB,CAAC;AAAA,MACvC,aAAa,QAAQ,eAAe,QAAQ,IAAI,YAAY;AAAA,IAC9D;AAEA,SAAK,QAAQ,YAAY,MAAM;AAC7B,WAAK,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,IACpC,GAAG,KAAK,QAAQ,aAAa;AAG7B,QAAI,KAAK,MAAM,OAAO;AACpB,WAAK,MAAM,MAAM;AAAA,IACnB;AAAA,EACF;AAAA,EAEA,KAAK,OAAuB;AAE1B,eAAW,WAAW,KAAK,QAAQ,cAAc;AAC/C,UAAI,MAAM,UAAU,WAAW,MAAM,MAAM,WAAW,OAAO,EAAG;AAAA,IAClE;AAEA,SAAK,MAAM,KAAK,KAAK;AAErB,QAAI,KAAK,QAAQ,OAAO;AACtB,cAAQ;AAAA,QACN,4BAA4B,MAAM,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,WAAW,IAAI,MAAM,WAAW,aAAa,KAAK,MAAM,MAAM;AAAA,MACjI;AAAA,IACF;AAEA,QAAI,KAAK,MAAM,UAAU,KAAK,QAAQ,WAAW;AAC/C,WAAK,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,IACpC;AAAA,EACF;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK,MAAM,WAAW,EAAG;AAE7B,UAAM,QAAQ,KAAK,MAAM,OAAO,GAAG,KAAK,MAAM,MAAM;AAEpD,QAAI,KAAK,QAAQ,OAAO;AACtB,cAAQ,IAAI,uBAAuB,MAAM,MAAM,cAAc,KAAK,QAAQ,SAAS,EAAE;AAAA,IACvF;AAEA,UAAM,UAAyB,EAAE,QAAQ,MAAM;AAE/C,QAAI;AACF,YAAM,WAAW,MAAM,MAAM,KAAK,QAAQ,WAAW;AAAA,QACnD,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,aAAa,KAAK,QAAQ;AAAA,QAC5B;AAAA,QACA,MAAM,KAAK,UAAU,OAAO;AAAA,MAC9B,CAAC;AAED,UAAI,SAAS,IAAI;AACf,YAAI,KAAK,QAAQ,OAAO;AACtB,gBAAM,OAAO,MAAM,SAAS,KAAK;AACjC,kBAAQ,IAAI,6CAA6C,KAAK,QAAQ,EAAE;AAAA,QAC1E;AAAA,MACF,OAAO;AACL,cAAM,UAAU,gBAAgB,SAAS,QAAQ,KAAK,QAAQ,MAAM;AACpE,gBAAQ,KAAK,OAAO;AAAA,MACtB;AAAA,IACF,SAAS,KAAK;AAEZ,UAAI,KAAK,QAAQ,OAAO;AACtB,gBAAQ,MAAM,0CAA0C,GAAG;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,WAA0B;AAC9B,QAAI,KAAK,OAAO;AACd,oBAAc,KAAK,KAAK;AACxB,WAAK,QAAQ;AAAA,IACf;AACA,UAAM,KAAK,MAAM;AAAA,EACnB;AACF;;;ACpIA,IAAI,gBAAmC;AAEvC,SAAS,iBAAiB,SAAsC;AAC9D,MAAI,CAAC,eAAe;AAClB,oBAAgB,IAAI,WAAW,OAAO;AAEtC,YAAQ,GAAG,cAAc,MAAM;AAC7B,qBAAe,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,IAC9C,CAAC;AAED,YAAQ,GAAG,WAAW,MAAM;AAC1B,qBAAe,SAAS,EAAE,MAAM,MAAM,MAAS;AAAA,IACjD,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAGA,eAAsB,WAA0B;AAC9C,MAAI,eAAe;AACjB,UAAM,cAAc,SAAS;AAC7B,oBAAgB;AAAA,EAClB;AACF;AAiCO,SAAS,QAAQ,SAAiD;AACvE,QAAM,QAAQ,iBAAiB,OAAO;AAEtC,SAAO,SAAS,mBACd,KACA,KACA,MACA;AACA,UAAM,YAAY,KAAK,IAAI;AAE3B,QAAI,GAAG,UAAU,MAAM;AACrB,YAAM,aAAa,KAAK,IAAI,IAAI;AAChC,YAAM,QAAQ,IAAI,OAAO,QAAQ,IAAI,QAAQ;AAC7C,YAAM,QACJ,OAAO,IAAI,OAAO,UAAU,WAAW,IAAI,OAAO,QAAQ;AAE5D,YAAM,QAAkB;AAAA,QACtB;AAAA,QACA,QAAQ,IAAI;AAAA,QACZ,aAAa,IAAI;AAAA,QACjB,aAAa;AAAA,QACb,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,QACzB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC;AAEA,YAAM,KAAK,KAAK;AAAA,IAClB,CAAC;AAED,SAAK;AAAA,EACP;AACF;AAqCO,SAAS,QAAQ,SAAyC;AAC/D,QAAM,QAAQ,iBAAiB,OAAO;AAEtC,SAAO,SAAS,sBACd,iBACA,OACA,MACA;AACA,oBAAgB;AAAA,MACd;AAAA,MACA,OAAO,SAAyB,UAAwB;AACtD,cAAM,QACJ,QAAQ,cACR,QAAQ,cAAc,OACtB;AAEF,cAAM,aACJ,OAAO,MAAM,gBAAgB,WACzB,KAAK,MAAM,MAAM,WAAW,IAC5B;AAEN,cAAM,QAAkB;AAAA,UACtB;AAAA,UACA,QAAQ,QAAQ;AAAA,UAChB,aAAa,MAAM;AAAA,UACnB,aAAa;AAAA,UACb,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,QACpC;AAEA,cAAM,KAAK,KAAK;AAAA,MAClB;AAAA,IACF;AAEA,SAAK;AAAA,EACP;AACF;AA0BO,SAAS,iBAAiB,SAA0B;AACzD,QAAM,QAAQ,IAAI,WAAW,OAAO;AAEpC,SAAO,eAAe,uBACpB,GAIA,MACA;AACA,UAAM,YAAY,KAAK,IAAI;AAE3B,QAAI;AACF,YAAM,KAAK;AAAA,IACb,UAAE;AACA,YAAM,aAAa,KAAK,IAAI,IAAI;AAEhC,UAAI;AACJ,UAAI;AACF,gBAAQ,EAAE,IAAI,aAAa,IAAI,IAAI,EAAE,IAAI,GAAG,EAAE,YAAY;AAAA,MAC5D,QAAQ;AACN,gBAAQ;AAAA,MACV;AAEA,YAAM,aAAa,EAAE,KAAK,UAAU;AAEpC,YAAM,QAAkB;AAAA,QACtB;AAAA,QACA,QAAQ,EAAE,IAAI;AAAA,QACd,aAAa;AAAA,QACb,aAAa;AAAA,QACb,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC;AAEA,YAAM,KAAK,KAAK;AAAA,IAClB;AAAA,EACF;AACF;AAcO,SAAS,UACd,SACA,SACgB;AAChB,QAAM,QAAQ,IAAI,WAAW,OAAO;AAEpC,SAAO,eAAe,aAAa,SAAkB,KAAe;AAClE,UAAM,YAAY,KAAK,IAAI;AAC3B,QAAI,aAAa;AAEjB,QAAI;AACF,YAAM,WAAW,MAAM,QAAQ,SAAS,GAAG;AAC3C,mBAAa,SAAS;AACtB,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,mBAAa;AACb,YAAM;AAAA,IACR,UAAE;AACA,YAAM,aAAa,KAAK,IAAI,IAAI;AAEhC,UAAI;AACJ,UAAI;AACF,gBAAQ,IAAI,IAAI,QAAQ,GAAG,EAAE,YAAY;AAAA,MAC3C,QAAQ;AACN,gBAAQ;AAAA,MACV;AAEA,YAAM,QAAkB;AAAA,QACtB;AAAA,QACA,QAAQ,QAAQ;AAAA,QAChB,aAAa;AAAA,QACb,aAAa;AAAA,QACb,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC;AAEA,YAAM,KAAK,KAAK;AAAA,IAClB;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@validors/sdk",
+  "version": "0.1.5",
+  "description": "Backend API monitoring SDK for Validors",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "release": "bash scripts/release.sh",
+    "release:minor": "bash scripts/release.sh minor",
+    "release:major": "bash scripts/release.sh major"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "^20",
+    "@types/express": "^4",
+    "tsup": "^8"
+  },
+  "peerDependencies": {
+    "express": ">=4",
+    "fastify": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "monitoring",
+    "api",
+    "analytics",
+    "middleware",
+    "validors"
+  ],
+  "license": "MIT"
+}