nostr-websocket-utils 0.3.0 → 0.3.2

package/dist/cjs/types/scoring.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * @file Scoring and metrics type definitions
+ * @module types/scoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultScoringStrategy = exports.DEFAULT_WEIGHTS = void 0;
+// Default scoring weights
+exports.DEFAULT_WEIGHTS = {
+    latency: 0.2,
+    reliability: 0.3,
+    uptime: 0.2,
+    errors: 0.2,
+    activity: 0.1,
+};
+// Default scoring strategy
+class DefaultScoringStrategy {
+    constructor(weights = exports.DEFAULT_WEIGHTS) {
+        this.weights = weights;
+    }
+    calculateScore(metrics) {
+        const now = Date.now();
+        // Basic scoring components that would work for any transport
+        const latencyScore = Math.max(0, 100 - (metrics.averageLatency / 10));
+        const activityScore = metrics.lastSeen ?
+            Math.max(0, 100 - ((now - metrics.lastSeen) / (60 * 1000))) : 0;
+        const errorScore = Math.max(0, 100 - (metrics.connectionErrors * 5));
+        return Math.round((latencyScore * this.weights.latency) +
+            (errorScore * this.weights.errors) +
+            (activityScore * this.weights.activity));
+    }
+}
+exports.DefaultScoringStrategy = DefaultScoringStrategy;
+//# sourceMappingURL=scoring.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../../src/types/scoring.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA6CH,0BAA0B;AACb,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,GAAG;IAChB,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;CACL,CAAC;AAEX,2BAA2B;AAC3B,MAAa,sBAAsB;IACjC,YAAoB,UAAU,uBAAe;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAEjD,cAAc,CAAC,OAAoB;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,6DAA6D;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC;QAErE,OAAO,IAAI,CAAC,KAAK,CACf,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACrC,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YAClC,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CACxC,CAAC;IACJ,CAAC;CACF;AAlBD,wDAkBC"}

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

@@ -0,0 +1,98 @@
+/**
+ * @file Socket type definitions
+ * @module types/socket
+ */
+import type { WebSocket } from 'ws';
+import type { NostrWSMessage } from './messages';
+/**
+ * Extended WebSocket interface with Nostr-specific properties
+ */
+export interface NostrWSSocket extends WebSocket {
+    /**
+     * Unique client ID
+     */
+    clientId?: string;
+    /**
+     * Set of subscribed channels
+     */
+    subscriptions?: Set<string>;
+    /**
+     * Whether the socket is alive (for heartbeat)
+     */
+    isAlive?: boolean;
+    /**
+     * Send a message through the WebSocket
+     */
+    send(message: string | Buffer): void;
+}
+/**
+ * WebSocket client options
+ */
+export interface NostrWSClientOptions {
+    /**
+     * WebSocket implementation to use
+     */
+    WebSocketImpl?: typeof WebSocket;
+    /**
+     * Heartbeat interval in milliseconds
+     */
+    heartbeatInterval?: number;
+    /**
+     * Reconnect interval in milliseconds
+     */
+    reconnectInterval?: number;
+    /**
+     * Maximum number of reconnect attempts
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Message handlers
+     */
+    handlers?: {
+        message?: (message: NostrWSMessage) => Promise<void>;
+        connect?: () => Promise<void>;
+        disconnect?: () => Promise<void>;
+        error?: (error: Error) => Promise<void>;
+    };
+}
+/**
+ * WebSocket server options
+ */
+export interface NostrWSServerOptions {
+    /**
+     * WebSocket server implementation to use
+     */
+    WebSocketImpl?: typeof WebSocket;
+    /**
+     * Heartbeat interval in milliseconds
+     */
+    heartbeatInterval?: number;
+    /**
+     * Message handlers
+     */
+    handlers?: {
+        message?: (ws: NostrWSSocket, message: NostrWSMessage) => Promise<void>;
+        connect?: (ws: NostrWSSocket) => Promise<void>;
+        disconnect?: (ws: NostrWSSocket) => Promise<void>;
+        error?: (ws: NostrWSSocket, error: Error) => Promise<void>;
+    };
+}
+/**
+ * Client event types
+ */
+export type NostrWSClientEvents = {
+    message: (message: NostrWSMessage) => void;
+    connect: () => void;
+    disconnect: () => void;
+    error: (error: Error) => void;
+};
+/**
+ * Server event types
+ */
+export type NostrWSServerEvents = {
+    message: (ws: NostrWSSocket, message: NostrWSMessage) => void;
+    connect: (ws: NostrWSSocket) => void;
+    disconnect: (ws: NostrWSSocket) => void;
+    error: (ws: NostrWSSocket, error: Error) => void;
+};
+//# sourceMappingURL=socket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/types/socket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IAEjC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACzC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IAEjC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACxE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClD,CAAC"}

package/dist/cjs/types/socket.js

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

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

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

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