covara 0.0.1 → 0.6.0

package/dist/kv/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * KV Store Adapter Interface
+ *
+ * Provides a Redis-like API that can be backed by either:
+ * - In-memory store (for development/single process)
+ * - Redis (for production/multi-process)
+ *
+ * All operations are async to support both backends uniformly.
+ */
+export interface KVAdapter {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, options?: SetOptions): Promise<void>;
+    del(...keys: string[]): Promise<number>;
+    exists(...keys: string[]): Promise<number>;
+    incr(key: string): Promise<number>;
+    incrBy(key: string, increment: number): Promise<number>;
+    decr(key: string): Promise<number>;
+    expire(key: string, seconds: number): Promise<boolean>;
+    ttl(key: string): Promise<number>;
+    hget(key: string, field: string): Promise<string | null>;
+    hset(key: string, field: string, value: string): Promise<number>;
+    hmset(key: string, data: Record<string, string>): Promise<void>;
+    hgetall(key: string): Promise<Record<string, string>>;
+    hdel(key: string, ...fields: string[]): Promise<number>;
+    hexists(key: string, field: string): Promise<boolean>;
+    hkeys(key: string): Promise<string[]>;
+    hlen(key: string): Promise<number>;
+    sadd(key: string, ...members: string[]): Promise<number>;
+    srem(key: string, ...members: string[]): Promise<number>;
+    smembers(key: string): Promise<string[]>;
+    sismember(key: string, member: string): Promise<boolean>;
+    scard(key: string): Promise<number>;
+    lpush(key: string, ...values: string[]): Promise<number>;
+    rpush(key: string, ...values: string[]): Promise<number>;
+    lpop(key: string): Promise<string | null>;
+    rpop(key: string): Promise<string | null>;
+    lrange(key: string, start: number, stop: number): Promise<string[]>;
+    llen(key: string): Promise<number>;
+    ltrim(key: string, start: number, stop: number): Promise<void>;
+    zadd(key: string, score: number, member: string): Promise<number>;
+    zrem(key: string, ...members: string[]): Promise<number>;
+    zscore(key: string, member: string): Promise<number | null>;
+    zrange(key: string, start: number, stop: number): Promise<string[]>;
+    zrangebyscore(key: string, min: number | "-inf", max: number | "+inf", options?: ZRangeOptions): Promise<string[]>;
+    zcard(key: string): Promise<number>;
+    zincrby(key: string, increment: number, member: string): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    scan(cursor: string, options?: ScanOptions): Promise<ScanResult>;
+    publish(channel: string, message: string): Promise<number>;
+    subscribe(channel: string, callback: (message: string, channel: string) => void): Promise<void>;
+    psubscribe(pattern: string, callback: (message: string, channel: string) => void): Promise<void>;
+    unsubscribe(channel: string): Promise<void>;
+    punsubscribe(pattern: string): Promise<void>;
+    multi(): KVTransaction;
+    eval(script: string, keys: string[], args: string[]): Promise<unknown>;
+}
+export interface KVTransaction {
+    get(key: string): KVTransaction;
+    set(key: string, value: string, options?: SetOptions): KVTransaction;
+    del(...keys: string[]): KVTransaction;
+    incr(key: string): KVTransaction;
+    hset(key: string, field: string, value: string): KVTransaction;
+    hdel(key: string, ...fields: string[]): KVTransaction;
+    sadd(key: string, ...members: string[]): KVTransaction;
+    srem(key: string, ...members: string[]): KVTransaction;
+    lpush(key: string, ...values: string[]): KVTransaction;
+    rpush(key: string, ...values: string[]): KVTransaction;
+    zadd(key: string, score: number, member: string): KVTransaction;
+    zrem(key: string, ...members: string[]): KVTransaction;
+    expire(key: string, seconds: number): KVTransaction;
+    exec(): Promise<unknown[]>;
+    discard(): void;
+}
+export interface SetOptions {
+    ex?: number;
+    px?: number;
+    nx?: boolean;
+    xx?: boolean;
+}
+export interface ZRangeOptions {
+    limit?: {
+        offset: number;
+        count: number;
+    };
+    withScores?: boolean;
+}
+export interface ScanOptions {
+    match?: string;
+    count?: number;
+}
+export interface ScanResult {
+    cursor: string;
+    keys: string[];
+}
+export interface KVConfig {
+    type: "memory" | "redis" | "durable-object";
+    prefix?: string;
+    redis?: RedisConfig;
+    durableObject?: DurableObjectConfig;
+}
+export interface DurableObjectStubLike {
+    fetch(input: string, init?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: string;
+    }): Promise<Response>;
+}
+export interface DurableObjectNamespaceLike {
+    idFromName(name: string): unknown;
+    get(id: unknown): DurableObjectStubLike;
+}
+export interface DurableObjectConfig {
+    namespace: DurableObjectNamespaceLike;
+    name?: string;
+}
+export interface RedisConfig {
+    url?: string;
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    tls?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+export declare const setGlobalKV: (kv: KVAdapter) => void;
+export declare const getGlobalKV: () => KVAdapter;
+export declare const hasGlobalKV: () => boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/kv/types.d.ts.map

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

package/dist/kv/types.js

@@ -0,0 +1,24 @@
+/**
+ * KV Store Adapter Interface
+ *
+ * Provides a Redis-like API that can be backed by either:
+ * - In-memory store (for development/single process)
+ * - Redis (for production/multi-process)
+ *
+ * All operations are async to support both backends uniformly.
+ */
+// Global KV store instance
+let globalKV = null;
+export const setGlobalKV = (kv) => {
+    globalKV = kv;
+};
+export const getGlobalKV = () => {
+    if (!globalKV) {
+        throw new Error("KV store not initialized. Call setGlobalKV() or createKV() first.");
+    }
+    return globalKV;
+};
+export const hasGlobalKV = () => {
+    return globalKV !== null;
+};
+//# sourceMappingURL=types.js.map

package/dist/kv/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kv/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoKH,2BAA2B;AAC3B,IAAI,QAAQ,GAAqB,IAAI,CAAC;AAEtC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAa,EAAQ,EAAE;IACjD,QAAQ,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAc,EAAE;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAY,EAAE;IACvC,OAAO,QAAQ,KAAK,IAAI,CAAC;AAC3B,CAAC,CAAC"}

package/dist/middleware/error.d.ts

@@ -0,0 +1,4 @@
+import type { ErrorHandler, NotFoundHandler } from "hono";
+export declare const errorHandler: ErrorHandler;
+export declare const notFoundHandler: NotFoundHandler;
+//# sourceMappingURL=error.d.ts.map

package/dist/middleware/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/middleware/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,YAAY,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAmBnE,eAAO,MAAM,YAAY,EAAE,YAuC1B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAiB7B,CAAC"}

package/dist/middleware/error.js

@@ -0,0 +1,63 @@
+import { HTTPException } from "hono/http-exception";
+import { ZodError } from "zod";
+import { ResourceError, formatRFC7807Error, RateLimitError, ERROR_TYPES, } from "../resource/error.js";
+import { isDebugEnabled } from "../server/env.js";
+import { getLogger } from "../server/logger.js";
+const problemResponse = (c, problem, status) => {
+    c.header("Content-Type", "application/problem+json");
+    return c.body(JSON.stringify(problem), status);
+};
+export const errorHandler = (error, c) => {
+    const requestId = c.get("requestId");
+    let statusCode = 500;
+    if (error instanceof ResourceError) {
+        statusCode = error.statusCode;
+    }
+    else if (error instanceof ZodError) {
+        statusCode = 400;
+    }
+    else if (error instanceof HTTPException) {
+        statusCode = error.status;
+    }
+    // 4xx are expected client errors (validation, not-found, precondition,
+    // rate-limit, auth) — log at warn so they don't drown real 5xx server errors.
+    const logger = getLogger();
+    const fields = {
+        requestId,
+        method: c.req.method,
+        path: c.req.path,
+        status: statusCode,
+        error: error instanceof Error ? error.message : String(error),
+        stack: isDebugEnabled() && error instanceof Error ? error.stack : undefined,
+    };
+    if (statusCode >= 500) {
+        logger.error("Request error", fields);
+    }
+    else {
+        logger.warn("Request error", fields);
+    }
+    if (error instanceof HTTPException) {
+        return error.getResponse();
+    }
+    if (error instanceof RateLimitError) {
+        c.header("Retry-After", String(Math.ceil(error.retryAfter / 1000)));
+    }
+    const problem = formatRFC7807Error(error, requestId);
+    return problemResponse(c, problem, statusCode);
+};
+export const notFoundHandler = (c) => {
+    const requestId = c.get("requestId");
+    const problem = {
+        type: ERROR_TYPES.NOT_FOUND,
+        title: "Not found",
+        status: 404,
+        detail: `Route ${c.req.method} ${c.req.path} not found`,
+        code: "NOT_FOUND",
+    };
+    if (requestId) {
+        problem.instance = `/requests/${requestId}`;
+        problem.requestId = requestId;
+    }
+    return problemResponse(c, problem, 404);
+};
+//# sourceMappingURL=error.js.map

package/dist/middleware/error.js.map

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

package/dist/middleware/idempotency.d.ts

@@ -0,0 +1,21 @@
+import type { MiddlewareHandler } from "hono";
+import { KVAdapter } from "../kv/index.js";
+export interface IdempotencyConfig {
+    storage: KVAdapter;
+    ttlMs?: number;
+    methods?: ("POST" | "PATCH" | "PUT" | "DELETE")[];
+    paths?: string[];
+    excludePaths?: string[];
+    headerName?: string;
+    onStoreError?: "proceed" | "fail";
+}
+export declare const idempotencyMiddleware: (config: IdempotencyConfig) => MiddlewareHandler;
+export declare const createIdempotencyMiddleware: (config: IdempotencyConfig) => MiddlewareHandler;
+export interface IdempotencyKeyGenerator {
+    generate(): string;
+    fromMutation(type: string, resource: string, objectId?: string): string;
+}
+export declare const createIdempotencyKeyGenerator: () => IdempotencyKeyGenerator;
+export declare const validateIdempotencyKey: (key: string) => boolean;
+export declare const idempotencyKeyValidationMiddleware: (headerName?: string) => MiddlewareHandler;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/middleware/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/middleware/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAIjC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CACnC;AA4BD,eAAO,MAAM,qBAAqB,GAAI,QAAQ,iBAAiB,KAAG,iBAsGjE,CAAC;AAEF,eAAO,MAAM,2BAA2B,WAxGM,iBAAiB,KAAG,iBAwGF,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,IAAI,MAAM,CAAC;IACnB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzE;AAED,eAAO,MAAM,6BAA6B,QAAO,uBAmBhD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,OAUpD,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,aAAY,MAAuB,KAClC,iBAmBF,CAAC"}

package/dist/middleware/idempotency.js

@@ -0,0 +1,144 @@
+import { createHash } from "node:crypto";
+import { IdempotencyMismatchError } from "../resource/error.js";
+import { getLogger } from "../server/logger.js";
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_METHODS = ["POST", "PATCH", "PUT"];
+const DEFAULT_HEADER = "idempotency-key";
+const hashRequest = (method, path, body) => {
+    const data = JSON.stringify({ method, path, body });
+    return createHash("sha256").update(data).digest("hex");
+};
+const readBodyForHash = async (raw) => {
+    const text = await raw.clone().text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+};
+export const idempotencyMiddleware = (config) => {
+    const { storage, ttlMs = DEFAULT_TTL_MS, methods = DEFAULT_METHODS, paths, excludePaths, headerName = DEFAULT_HEADER, onStoreError = "proceed", } = config;
+    return async (c, next) => {
+        const key = c.req.header(headerName);
+        if (!key) {
+            return next();
+        }
+        const method = c.req.method.toUpperCase();
+        if (!methods.includes(method)) {
+            return next();
+        }
+        if (paths && !paths.some((p) => c.req.path.startsWith(p))) {
+            return next();
+        }
+        if (excludePaths && excludePaths.some((p) => c.req.path.startsWith(p))) {
+            return next();
+        }
+        const userId = c.get("user")?.id ?? "anonymous";
+        const body = await readBodyForHash(c.req.raw);
+        const requestHash = hashRequest(c.req.method, c.req.path, body);
+        const cacheKey = `idempotency:${userId}:${key}`;
+        let parsedCache = null;
+        try {
+            const cached = await storage.get(cacheKey);
+            if (cached) {
+                parsedCache = JSON.parse(cached);
+            }
+        }
+        catch (error) {
+            getLogger().warn("Idempotency store unreachable", {
+                path: c.req.path,
+                onStoreError,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (onStoreError === "fail") {
+                return c.json({
+                    type: "/__covara/problems/idempotency-store-unavailable",
+                    title: "Idempotency store unavailable",
+                    status: 503,
+                    detail: "The idempotency store is unreachable; retry shortly.",
+                }, 503);
+            }
+            return next();
+        }
+        if (parsedCache) {
+            if (parsedCache.requestHash !== requestHash) {
+                throw new IdempotencyMismatchError("Idempotency key was already used with different request parameters");
+            }
+            return c.json(parsedCache.body, parsedCache.status);
+        }
+        await next();
+        if (c.res.status >= 500)
+            return;
+        const contentType = c.res.headers.get("content-type") ?? "";
+        if (!contentType.includes("application/json"))
+            return;
+        let responseBody;
+        try {
+            responseBody = await c.res.clone().json();
+        }
+        catch {
+            return;
+        }
+        const cacheData = {
+            status: c.res.status,
+            body: responseBody,
+            requestHash,
+            createdAt: Date.now(),
+        };
+        storage
+            .set(cacheKey, JSON.stringify(cacheData), { px: ttlMs })
+            .catch((err) => {
+            getLogger().warn("Failed to cache idempotency response", {
+                path: c.req.path,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        });
+    };
+};
+export const createIdempotencyMiddleware = idempotencyMiddleware;
+export const createIdempotencyKeyGenerator = () => {
+    return {
+        generate() {
+            const timestamp = Date.now().toString(36);
+            const random = Math.random().toString(36).substring(2, 15);
+            return `${timestamp}-${random}`;
+        },
+        fromMutation(type, resource, objectId) {
+            const timestamp = Date.now().toString(36);
+            const random = Math.random().toString(36).substring(2, 8);
+            const parts = [type, resource];
+            if (objectId) {
+                parts.push(objectId);
+            }
+            parts.push(timestamp, random);
+            return parts.join("-");
+        },
+    };
+};
+export const validateIdempotencyKey = (key) => {
+    if (!key || typeof key !== "string") {
+        return false;
+    }
+    if (key.length < 8 || key.length > 256) {
+        return false;
+    }
+    return /^[a-zA-Z0-9_-]+$/.test(key);
+};
+export const idempotencyKeyValidationMiddleware = (headerName = DEFAULT_HEADER) => {
+    return async (c, next) => {
+        const key = c.req.header(headerName);
+        if (key && !validateIdempotencyKey(key)) {
+            return c.json({
+                type: "/__covara/problems/validation-error",
+                title: "Invalid idempotency key",
+                status: 400,
+                detail: "Idempotency key must be 8-256 characters and contain only alphanumeric characters, underscores, and hyphens",
+            }, 400);
+        }
+        return next();
+    };
+};
+//# sourceMappingURL=idempotency.js.map

package/dist/middleware/idempotency.js.map

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

package/dist/middleware/logging.d.ts

@@ -0,0 +1,3 @@
+export { createLogger, getLogger, setLogger, defaultSink, resolveDefaultLevel, } from "../server/logger.js";
+export type { Logger, LogLevel, LogFields, LogRecord, LogSink, CreateLoggerOptions, } from "../server/logger.js";
+//# sourceMappingURL=logging.d.ts.map

package/dist/middleware/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,OAAO,EACP,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/middleware/logging.js

@@ -0,0 +1,6 @@
+// Public entry for the structured logger, exposed at the
+// `covara/middleware/logging` subpath. The implementation lives
+// in the server runtime layer; this re-export keeps the documented import path
+// stable and runtime-agnostic.
+export { createLogger, getLogger, setLogger, defaultSink, resolveDefaultLevel, } from "../server/logger.js";
+//# sourceMappingURL=logging.js.map

package/dist/middleware/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,gEAAgE;AAChE,+EAA+E;AAC/E,+BAA+B;AAC/B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,WAAW,EACX,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/middleware/observability.d.ts

@@ -0,0 +1,104 @@
+import type { Context, MiddlewareHandler } from "hono";
+declare module "hono" {
+    interface ContextVariableMap {
+        requestStartTime?: number;
+        resource?: string;
+        operation?: string;
+        traceId?: string;
+    }
+}
+export interface RequestMetrics {
+    requestId: string;
+    traceId?: string;
+    method: string;
+    path: string;
+    resource?: string;
+    operation?: string;
+    status: number;
+    duration: number;
+    timestamp: number;
+    query?: Record<string, unknown>;
+    error?: string;
+}
+export interface SpanInfo {
+    requestId: string;
+    traceId: string;
+    method: string;
+    path: string;
+    resource?: string;
+    operation?: string;
+}
+export interface SubscriptionMetrics {
+    subscriptionId: string;
+    resource: string;
+    event: "connected" | "disconnected" | "event_sent" | "backpressure" | "invalidate";
+    userId?: string;
+    duration?: number;
+    eventCount?: number;
+}
+export interface ErrorMetrics {
+    requestId?: string;
+    method: string;
+    path: string;
+    status: number;
+    errorCode: string;
+    errorMessage: string;
+    timestamp: number;
+}
+export interface MetricsConfig {
+    onRequest?: (metrics: RequestMetrics) => void;
+    onSubscription?: (metrics: SubscriptionMetrics) => void;
+    onError?: (metrics: ErrorMetrics) => void;
+}
+export interface ObservabilityConfig {
+    enableRequestId?: boolean;
+    enableTiming?: boolean;
+    enableSlowQueryLog?: boolean;
+    slowQueryThresholdMs?: number;
+    requestIdHeader?: string;
+    traceIdHeader?: string;
+    metrics?: MetricsConfig;
+    onMetrics?: (metrics: RequestMetrics) => void;
+    onSpan?: (span: SpanInfo) => void;
+    logger?: Logger;
+}
+export interface Logger {
+    info: (msg: string | object) => void;
+    warn: (msg: string | object) => void;
+    error: (msg: string | object) => void;
+}
+export declare const observabilityMiddleware: (config?: ObservabilityConfig) => MiddlewareHandler;
+export declare const requestIdMiddleware: (headerName?: string) => MiddlewareHandler;
+export declare const timingMiddleware: (config?: {
+    slowQueryThresholdMs?: number;
+}) => MiddlewareHandler;
+export declare const resourceContextMiddleware: (resource: string, operation?: string) => MiddlewareHandler;
+export declare const getRequestId: (c: Context) => string | undefined;
+export declare const getRequestDuration: (c: Context) => number;
+export interface MetricsCollectorConfig {
+    maxMetrics?: number;
+}
+export declare const createMetricsCollector: (config?: MetricsCollectorConfig) => {
+    setMaxEntries: (max: number) => void;
+    record: (metrics: RequestMetrics) => void;
+    onRequest: (metrics: RequestMetrics) => void;
+    onSubscription: (metrics: SubscriptionMetrics) => void;
+    onError: (metrics: ErrorMetrics) => void;
+    getRecent: (count: number) => RequestMetrics[];
+    getRequestMetrics: (filter?: Partial<RequestMetrics>) => RequestMetrics[];
+    getByPath: (path: string) => RequestMetrics[];
+    getSlow: (thresholdMs: number) => RequestMetrics[];
+    getSubscriptionMetrics: () => SubscriptionMetrics[];
+    getErrorMetrics: () => ErrorMetrics[];
+    getStats: () => {
+        total: number;
+        avgDuration: number;
+        errorRate: number;
+        requestsPerMinute: number;
+        requestsLast5Minutes: number;
+        activeSubscriptions: number;
+    };
+    clear: () => void;
+};
+export type MetricsCollector = ReturnType<typeof createMetricsCollector>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/middleware/observability.d.ts.map

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