nostr-websocket-utils 0.3.1 → 0.3.3

package/dist/cjs/types/transport.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @file Transport type definitions
+ * @module types/transport
+ */
+import { NostrEvent } from './events';
+import { NostrWSMessage } from './messages';
+/**
+ * Base transport interface
+ */
+export interface Transport {
+    /**
+     * Connect to the transport
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the transport
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send a message through the transport
+     */
+    send(message: NostrWSMessage): Promise<void>;
+    /**
+     * Subscribe to events
+     */
+    subscribe(filter: NostrEvent): Promise<void>;
+    /**
+     * Unsubscribe from events
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Check if transport is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get transport metrics
+     */
+    getMetrics(): TransportMetrics;
+}
+/**
+ * Transport metrics
+ */
+export interface TransportMetrics {
+    /**
+     * Total number of messages sent
+     */
+    messagesSent: number;
+    /**
+     * Total number of messages received
+     */
+    messagesReceived: number;
+    /**
+     * Total number of bytes sent
+     */
+    bytesSent: number;
+    /**
+     * Total number of bytes received
+     */
+    bytesReceived: number;
+    /**
+     * Average message latency in milliseconds
+     */
+    averageLatency: number;
+    /**
+     * Number of active subscriptions
+     */
+    activeSubscriptions: number;
+    /**
+     * Connection uptime in milliseconds
+     */
+    uptime: number;
+    /**
+     * Number of connection attempts
+     */
+    connectionAttempts: number;
+    /**
+     * Number of successful connections
+     */
+    successfulConnections: number;
+    /**
+     * Number of failed connections
+     */
+    failedConnections: number;
+    /**
+     * Transport-specific metrics
+     */
+    [key: string]: number | string | boolean | undefined;
+}
+/**
+ * Transport factory interface
+ */
+export interface TransportFactory {
+    /**
+     * Create a new transport instance
+     */
+    create(options: unknown): Transport;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/cjs/types/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/types/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,IAAI,gBAAgB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC"}

package/dist/cjs/types/transport.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @file Transport type definitions
+ * @module types/transport
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transport.js.map

package/dist/cjs/types/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/types/transport.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/cjs/types/validation.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file Validation type definitions
+ * @module types/validation
+ */
+import { NostrEvent } from './events';
+import { NostrWSMessage } from './messages';
+/**
+ * Validation result interface
+ */
+export interface NostrWSValidationResult {
+    /**
+     * Whether the validation passed
+     */
+    isValid: boolean;
+    /**
+     * Error message if validation failed
+     */
+    error?: string;
+}
+/**
+ * Event validator interface
+ */
+export interface NostrEventValidator {
+    /**
+     * Validate a Nostr event
+     */
+    validateEvent(event: NostrEvent): NostrWSValidationResult;
+}
+/**
+ * Message validator interface
+ */
+export interface NostrMessageValidator {
+    /**
+     * Validate a WebSocket message
+     */
+    validateMessage(message: NostrWSMessage): NostrWSValidationResult;
+}
+/**
+ * Validator factory interface
+ */
+export interface ValidatorFactory {
+    /**
+     * Create an event validator
+     */
+    createEventValidator(): NostrEventValidator;
+    /**
+     * Create a message validator
+     */
+    createMessageValidator(): NostrMessageValidator;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/cjs/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,uBAAuB,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,uBAAuB,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,oBAAoB,IAAI,mBAAmB,CAAC;IAE5C;;OAEG;IACH,sBAAsB,IAAI,qBAAqB,CAAC;CACjD"}

package/dist/cjs/types/validation.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @file Validation type definitions
+ * @module types/validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=validation.js.map

package/dist/cjs/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/cjs/types/websocket.d.ts

@@ -0,0 +1,250 @@
+/**
+ * @file WebSocket type definitions
+ * @module types/websocket
+ */
+import { WebSocket } from 'ws';
+import { MessageType, NostrWSMessage } from './messages';
+import { MessagePriority } from './priority';
+import { RateLimitConfig } from '../utils/rate-limiter';
+import { Logger } from 'pino';
+/**
+ * Extended WebSocket interface with additional properties
+ * @interface ExtendedWebSocket
+ */
+export interface ExtendedWebSocket extends WebSocket {
+    /**
+     * Whether the WebSocket connection is alive
+     */
+    isAlive?: boolean;
+    /**
+     * Set of subscription channels
+     */
+    subscriptions?: Set<string>;
+    /**
+     * Unique client identifier
+     */
+    clientId?: string;
+    /**
+     * Queue of messages to be sent
+     */
+    messageQueue?: NostrWSMessage[];
+    /**
+     * Timestamp of the last ping message
+     */
+    lastPing?: number;
+    /**
+     * Timestamp of the last pong message
+     */
+    lastPong?: number;
+}
+/**
+ * WebSocket client configuration options
+ */
+export interface NostrWSClientOptions {
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Connection timeout in milliseconds
+     */
+    connectionTimeout?: number;
+    /**
+     * Number of retry attempts for reconnection
+     */
+    retryAttempts?: number;
+    /**
+     * Delay between retry attempts in milliseconds
+     */
+    retryDelay?: number;
+    /**
+     * Maximum queue size
+     */
+    queueSize?: number;
+    /**
+     * Maximum number of retries for sending messages
+     */
+    maxRetries?: number;
+    /**
+     * Message handler callback
+     */
+    onMessage?: (message: string) => void;
+    /**
+     * Error handler callback
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * WebSocket client event handlers
+ */
+export interface NostrWSEventHandlers {
+    /**
+     * Message handler callback
+     */
+    onMessage?: (message: string) => void;
+    /**
+     * Error handler callback
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Queue configuration options
+ */
+export interface QueueOptions {
+    /**
+     * Maximum size of the queue
+     */
+    maxSize?: number;
+    /**
+     * Maximum number of retries for failed messages
+     */
+    maxRetries?: number;
+    /**
+     * Delay between retries in milliseconds
+     */
+    retryDelay?: number;
+    /**
+     * Timeout for stale messages in milliseconds
+     */
+    staleTimeout?: number;
+}
+/**
+ * Message queue item
+ */
+export interface QueueItem {
+    /**
+     * Message to be sent
+     */
+    message: NostrWSMessage;
+    /**
+     * Message priority
+     */
+    priority: MessagePriority;
+    /**
+     * Timestamp when the message was queued
+     */
+    queuedAt: number;
+    /**
+     * Number of retries for the message
+     */
+    retryCount?: number;
+}
+/**
+ * State of the NostrWSClient connection
+ * @interface NostrWSConnectionState
+ */
+export interface NostrWSConnectionState {
+    /**
+     * Whether the client is currently connected
+     */
+    isConnected: boolean;
+    /**
+     * Number of reconnection attempts made
+     */
+    reconnectAttempts: number;
+    /**
+     * Last error encountered
+     */
+    lastError?: string;
+}
+/**
+ * Server configuration options
+ * @interface NostrWSServerOptions
+ */
+export interface NostrWSServerOptions {
+    /**
+     * Port to listen on
+     */
+    port: number;
+    /**
+     * Host to bind to
+     */
+    host?: string;
+    /**
+     * Path for the WebSocket endpoint
+     */
+    path?: string;
+    /**
+     * Maximum payload size in bytes
+     */
+    maxPayload?: number;
+    /**
+     * Maximum number of concurrent connections
+     */
+    maxConnections?: number;
+    /**
+     * Ping interval in milliseconds
+     */
+    pingInterval?: number;
+    /**
+     * Rate limiting configuration
+     */
+    rateLimits?: RateLimitConfig;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+    /**
+     * Message handler callback
+     */
+    onMessage?: (message: NostrWSMessage, socket: NostrWSServerSocket) => void;
+    /**
+     * Error handler callback
+     */
+    onError?: (error: Error, socket: NostrWSServerSocket) => void;
+    /**
+     * Close handler
+     */
+    onClose?: (socket: NostrWSServerSocket) => void;
+    /**
+     * Connection handler
+     */
+    onConnection?: (socket: NostrWSServerSocket) => Promise<void>;
+}
+/**
+ * Server message structure
+ * @interface NostrWSServerMessage
+ */
+export type NostrWSServerMessage = NostrWSMessage & {
+    /**
+     * Unique client identifier
+     */
+    clientId?: string;
+};
+/**
+ * Extended WebSocket interface for Nostr server
+ * @interface NostrWSServerSocket
+ */
+export interface NostrWSServerSocket extends WebSocket {
+    /**
+     * Unique client identifier
+     */
+    clientId: string;
+    /**
+     * Set of subscription channels
+     */
+    subscriptions: Set<string>;
+    /**
+     * Timestamp of the last ping message
+     */
+    lastPing?: number;
+    /**
+     * Whether the WebSocket connection is alive
+     */
+    isAlive: boolean;
+}
+/**
+ * Nostr WebSocket server message with client info
+ * @interface NostrWSServerClientMessage
+ */
+export type NostrWSServerClientMessage = [MessageType, ...unknown[]] & {
+    /**
+     * Unique client identifier
+     */
+    clientId?: string;
+    /**
+     * Timestamp of the message
+     */
+    timestamp?: number;
+};
+//# sourceMappingURL=websocket.d.ts.map

package/dist/cjs/types/websocket.d.ts.map

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

package/dist/cjs/types/websocket.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @file WebSocket type definitions
+ * @module types/websocket
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=websocket.js.map

package/dist/cjs/types/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/types/websocket.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/cjs/utils/http.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @file HTTP utility functions
+ * @module utils/http
+ */
+/**
+ * Fetches JSON data from a URL
+ * @param url URL to fetch from
+ * @returns Parsed JSON data
+ */
+export declare function fetchJson<T>(url: string): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/cjs/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAW1D"}

package/dist/cjs/utils/http.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @file HTTP utility functions
+ * @module utils/http
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchJson = fetchJson;
+const logger_1 = require("./logger");
+const logger = (0, logger_1.getLogger)('http');
+/**
+ * Fetches JSON data from a URL
+ * @param url URL to fetch from
+ * @returns Parsed JSON data
+ */
+async function fetchJson(url) {
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        return await response.json();
+    }
+    catch (error) {
+        logger.error({ error, url }, 'Failed to fetch JSON');
+        throw error;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/cjs/utils/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/utils/http.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAWH,8BAWC;AApBD,qCAAqC;AAErC,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,MAAM,CAAC,CAAC;AAEjC;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAAI,GAAW;IAC5C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACrD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cjs/utils/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @file Logger utility
+ * @module utils/logger
+ */
+import { Logger } from 'pino';
+/**
+ * Create a new logger instance
+ * @param name Name of the logger
+ * @returns Logger instance
+ */
+export declare function createLogger(name: string): Logger;
+/**
+ * Get a logger instance for a specific component
+ * @param component Component name for the logger
+ * @returns Logger instance
+ */
+export declare function getLogger(component: string): Logger;
+/**
+ * Get a child logger instance
+ * @param parent Parent logger instance
+ * @param bindings Additional bindings for the child logger
+ * @returns Child logger instance
+ */
+export declare function getChildLogger(parent: Logger, bindings: object): Logger;
+export { Logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/cjs/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAa,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/cjs/utils/logger.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @file Logger utility
+ * @module utils/logger
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+exports.getLogger = getLogger;
+exports.getChildLogger = getChildLogger;
+const pino_1 = __importDefault(require("pino"));
+/**
+ * Create a new logger instance
+ * @param name Name of the logger
+ * @returns Logger instance
+ */
+function createLogger(name) {
+    return (0, pino_1.default)({
+        name,
+        level: process.env.LOG_LEVEL || 'info',
+        timestamp: pino_1.default.stdTimeFunctions.isoTime
+    });
+}
+/**
+ * Get a logger instance for a specific component
+ * @param component Component name for the logger
+ * @returns Logger instance
+ */
+function getLogger(component) {
+    return createLogger(component);
+}
+/**
+ * Get a child logger instance
+ * @param parent Parent logger instance
+ * @param bindings Additional bindings for the child logger
+ * @returns Child logger instance
+ */
+function getChildLogger(parent, bindings) {
+    return parent.child(bindings);
+}
+//# sourceMappingURL=logger.js.map

package/dist/cjs/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AASH,oCAMC;AAOD,8BAEC;AAQD,wCAEC;AAhCD,gDAAoC;AAEpC;;;;GAIG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,IAAA,cAAI,EAAC;QACV,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,SAAS,EAAE,cAAI,CAAC,gBAAgB,CAAC,OAAO;KACzC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,SAAiB;IACzC,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/cjs/utils/metrics.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @file Metrics tracking for Nostr WebSocket connections
+ * @module metrics
+ */
+import { EventEmitter } from 'events';
+export interface RelayMetrics {
+    totalConnections: number;
+    activeConnections: number;
+    connectionErrors: number;
+    messagesReceived: number;
+    messagesSent: number;
+    bytesReceived: number;
+    bytesSent: number;
+    averageLatency: number;
+    maxLatency: number;
+    minLatency: number;
+    totalErrors: number;
+    lastError?: string;
+    eventsReceived: number;
+    eventsSent: number;
+    subscriptions: number;
+    uptime: number;
+    reliability: number;
+    lastSeen: number;
+    score: number;
+}
+export declare class RelayMetricsTracker extends EventEmitter {
+    private metrics;
+    private startTime;
+    constructor();
+    /**
+     * Get metrics for a specific relay
+     */
+    getRelayMetrics(relayUrl: string): RelayMetrics;
+    /**
+     * Get metrics for all relays
+     */
+    getAllMetrics(): Map<string, RelayMetrics>;
+    /**
+     * Initialize metrics for a new relay
+     */
+    private initializeMetrics;
+    /**
+     * Update connection metrics
+     */
+    trackConnection(relayUrl: string, connected: boolean): void;
+    /**
+     * Track message metrics
+     */
+    trackMessage(relayUrl: string, sent: boolean, bytes: number): void;
+    /**
+     * Track latency
+     */
+    trackLatency(relayUrl: string, latencyMs: number): void;
+    /**
+     * Track errors
+     */
+    trackError(relayUrl: string, error: Error): void;
+    /**
+     * Track protocol-specific events
+     */
+    trackProtocolEvent(relayUrl: string, type: 'event' | 'subscription', sent: boolean): void;
+    /**
+     * Calculate relay score based on metrics
+     */
+    private calculateScore;
+    /**
+     * Update scores for all relays
+     */
+    private updateScores;
+    /**
+     * Get high-value relays (score > threshold)
+     */
+    getHighValueRelays(threshold?: number): string[];
+    /**
+     * Export metrics in Prometheus format
+     */
+    getPrometheusMetrics(): string;
+}
+export declare const metricsTracker: RelayMetricsTracker;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/cjs/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/utils/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,MAAM,WAAW,YAAY;IAE3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IAGzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAGlB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IAGtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,SAAS,CAAsB;;IAQvC;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAOtD;;OAEG;IACI,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAIjD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;IAY3D;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IAalE;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IASvD;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAQhD;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE,IAAI,EAAE,OAAO;IAWzF;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACI,kBAAkB,CAAC,SAAS,GAAE,MAAW,GAAG,MAAM,EAAE;IAM3D;;OAEG;IACI,oBAAoB,IAAI,MAAM;CA2CtC;AAGD,eAAO,MAAM,cAAc,qBAA4B,CAAC"}