nostr-websocket-utils 0.3.1 → 0.3.3

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

@@ -0,0 +1,134 @@
+/**
+ * @file Nostr protocol type definitions
+ * @module types/nostr
+ */
+import type { WebSocket as WSClient } from 'ws';
+import { Logger } from './logger';
+import type { NostrWSMessage } from './messages';
+import type { NostrEvent } from './events';
+/**
+ * Signed Nostr event with id and signature
+ */
+export interface SignedNostrEvent extends NostrEvent {
+    /**
+     * Event ID (32-bytes lowercase hex of the serialized event data)
+     */
+    id: string;
+    /**
+     * Signature of the event ID (64-bytes hex of the schnorr signature)
+     */
+    sig: string;
+}
+/**
+ * Extended WebSocket interface for Nostr
+ */
+export interface NostrWSSocket extends WSClient {
+    /**
+     * Whether the socket is alive (for ping/pong)
+     */
+    isAlive?: boolean;
+    /**
+     * Set of active subscription IDs
+     */
+    subscriptions?: Set<string>;
+    /**
+     * Unique client identifier
+     */
+    clientId?: string;
+}
+/**
+ * Server configuration options
+ */
+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;
+    /**
+     * Ping interval in milliseconds
+     */
+    pingInterval?: number;
+    /**
+     * Client timeout in milliseconds
+     */
+    clientTimeout?: number;
+    /**
+     * Heartbeat interval in milliseconds
+     */
+    heartbeatInterval?: number;
+    /**
+     * Handlers for various events
+     */
+    handlers?: {
+        message?: (socket: NostrWSSocket, message: NostrWSServerMessage) => Promise<void>;
+        error?: (socket: NostrWSSocket, error: Error) => void;
+        close?: (socket: NostrWSSocket) => void;
+    };
+    /**
+     * Callback for when a new connection is established
+     */
+    onConnection?: (socket: NostrWSSocket) => void;
+}
+/**
+ * Server message structure
+ */
+export interface NostrWSServerMessage {
+    /**
+     * Message type
+     */
+    type: string;
+    /**
+     * Message data
+     */
+    data?: unknown;
+    /**
+     * Error message if applicable
+     */
+    error?: string;
+}
+/**
+ * Extended WebSocket interface for Nostr server
+ */
+export interface NostrWSServerSocket extends WSClient {
+    clientId: string;
+    subscriptions: Set<string>;
+    lastPing?: number;
+    isAlive: boolean;
+}
+/**
+ * Nostr WebSocket server options
+ */
+export interface NostrWSServerServerOptions {
+    port: number;
+    host?: string;
+    path?: string;
+    logger: Logger;
+    maxClients?: number;
+    pingInterval?: number;
+    pingTimeout?: number;
+    handlers?: {
+        message?: (message: NostrWSServerMessage, ws: NostrWSServerSocket) => Promise<void>;
+        error?: (error: Error, ws: NostrWSServerSocket) => void;
+        close?: (ws: NostrWSServerSocket) => void;
+    };
+}
+/**
+ * Nostr WebSocket server message
+ */
+export type NostrWSServerServerMessage = NostrWSMessage & {
+    clientId?: string;
+    timestamp?: number;
+};
+//# sourceMappingURL=nostr.d.ts.map

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

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

package/dist/cjs/types/nostr.js

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

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

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

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

@@ -0,0 +1,155 @@
+/**
+ * @file WebSocket client configuration options
+ * @module types/options
+ */
+import WebSocket from 'ws';
+import { NostrWSMessage } from './messages';
+/**
+ * Handler functions for WebSocket events
+ */
+export interface NostrWSHandlers {
+    /**
+     * Handler for incoming messages
+     */
+    message: (message: NostrWSMessage) => Promise<void>;
+    /**
+     * Handler for WebSocket errors
+     */
+    error: (error: Error) => void;
+    /**
+     * Handler for connection close events
+     */
+    close: () => void;
+    /**
+     * Handler for connection state changes
+     */
+    stateChange?: (state: string) => void;
+    /**
+     * Handler for heartbeat events
+     */
+    heartbeat?: () => void;
+    /**
+     * Handler for connection events
+     */
+    connect?: () => void;
+    /**
+     * Handler for disconnection events
+     */
+    disconnect?: () => void;
+    /**
+     * Handler for reconnection events
+     */
+    reconnect?: () => void;
+}
+/**
+ * Connection retry configuration
+ */
+export interface RetryConfig {
+    /**
+     * Maximum number of retry attempts
+     * @default 10
+     */
+    maxAttempts: number;
+    /**
+     * Initial delay between retries in milliseconds
+     * @default 1000
+     */
+    initialDelay: number;
+    /**
+     * Maximum delay between retries in milliseconds
+     * @default 30000
+     */
+    maxDelay: number;
+    /**
+     * Factor to multiply delay by after each attempt
+     * @default 1.5
+     */
+    backoffFactor: number;
+}
+/**
+ * Queue configuration
+ */
+export interface QueueConfig {
+    /**
+     * Maximum size of the message queue
+     * @default 1000
+     */
+    maxSize: number;
+    /**
+     * Maximum number of retry attempts per message
+     * @default 3
+     */
+    maxRetries: number;
+    /**
+     * Base delay between retries in milliseconds
+     * @default 1000
+     */
+    retryDelay: number;
+    /**
+     * Time in milliseconds after which messages are considered stale
+     * @default 300000 (5 minutes)
+     */
+    staleTimeout: number;
+}
+/**
+ * Heartbeat configuration
+ */
+export interface HeartbeatConfig {
+    /**
+     * Interval between heartbeat pings in milliseconds
+     * @default 30000
+     */
+    interval: number;
+    /**
+     * Timeout for heartbeat response in milliseconds
+     * @default 5000
+     */
+    timeout: number;
+    /**
+     * Maximum missed heartbeats before connection is considered dead
+     * @default 3
+     */
+    maxMissed: number;
+}
+/**
+ * WebSocket client configuration options
+ */
+export interface NostrWSOptions {
+    /**
+     * WebSocket implementation to use
+     * @default ws
+     */
+    WebSocketImpl: typeof WebSocket;
+    /**
+     * Event handlers
+     */
+    handlers: NostrWSHandlers;
+    /**
+     * Retry configuration
+     */
+    retry?: Partial<RetryConfig>;
+    /**
+     * Queue configuration
+     */
+    queue?: Partial<QueueConfig>;
+    /**
+     * Heartbeat configuration
+     */
+    heartbeat?: Partial<HeartbeatConfig>;
+    /**
+     * Whether to automatically reconnect on disconnection
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Whether to buffer messages when disconnected
+     * @default true
+     */
+    bufferMessages?: boolean;
+    /**
+     * Whether to automatically remove stale messages from the queue
+     * @default true
+     */
+    cleanStaleMessages?: boolean;
+}
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/types/options.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;OAEG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,EAAE,OAAO,SAAS,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/cjs/types/options.js

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

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * @file Message priority definitions
+ * @module types/priority
+ */
+/**
+ * Message priority levels for queue management
+ */
+export declare enum MessagePriority {
+    HIGH = "HIGH",
+    NORMAL = "NORMAL",
+    LOW = "LOW"
+}
+//# sourceMappingURL=priority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"priority.d.ts","sourceRoot":"","sources":["../../../src/types/priority.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ"}

package/dist/cjs/types/priority.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @file Message priority definitions
+ * @module types/priority
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagePriority = void 0;
+/**
+ * Message priority levels for queue management
+ */
+var MessagePriority;
+(function (MessagePriority) {
+    MessagePriority["HIGH"] = "HIGH";
+    MessagePriority["NORMAL"] = "NORMAL";
+    MessagePriority["LOW"] = "LOW";
+})(MessagePriority || (exports.MessagePriority = MessagePriority = {}));
+//# sourceMappingURL=priority.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../../../src/types/priority.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACH,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,oCAAiB,CAAA;IACjB,8BAAW,CAAA;AACb,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B"}

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

@@ -0,0 +1,27 @@
+/**
+ * @file Relay type definitions
+ * @module types/relays
+ */
+/**
+ * Relay information interface
+ */
+export interface NostrRelayInfo {
+    name?: string;
+    description?: string;
+    pubkey?: string;
+    contact?: string;
+    supported_nips?: number[];
+    software?: string;
+    version?: string;
+}
+/**
+ * Relay metadata interface
+ */
+export interface NostrRelayMetadata extends NostrRelayInfo {
+    url: string;
+    status: 'connected' | 'disconnected' | 'error';
+    error?: string;
+    lastConnected?: number;
+    lastDisconnected?: number;
+}
+//# sourceMappingURL=relays.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relays.d.ts","sourceRoot":"","sources":["../../../src/types/relays.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/cjs/types/relays.js

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

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

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

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

@@ -0,0 +1,59 @@
+/**
+ * @file Scoring and metrics type definitions
+ * @module types/scoring
+ */
+/**
+ * Metric value types
+ */
+export type MetricValue = number | string | boolean | Date;
+/**
+ * Transport data types
+ */
+export type TransportData = string | Buffer | ArrayBuffer | SharedArrayBuffer;
+/**
+ * Metrics update event
+ */
+export interface MetricUpdateEvent {
+    endpoint: string;
+    metricType: string;
+    value: MetricValue;
+    timestamp: number;
+}
+export interface BaseMetrics {
+    totalConnections: number;
+    activeConnections: number;
+    connectionErrors: number;
+    messagesReceived: number;
+    messagesSent: number;
+    bytesReceived: number;
+    bytesSent: number;
+    averageLatency: number;
+    lastSeen: number;
+}
+export interface ScoringStrategy {
+    calculateScore(metrics: BaseMetrics): number;
+}
+export interface MetricsProvider<T extends BaseMetrics = BaseMetrics> {
+    getMetrics(endpoint: string): T;
+    getAllMetrics(): Map<string, T>;
+    trackMetric(endpoint: string, metricType: string, value: any): void;
+}
+export declare const DEFAULT_WEIGHTS: {
+    readonly latency: 0.2;
+    readonly reliability: 0.3;
+    readonly uptime: 0.2;
+    readonly errors: 0.2;
+    readonly activity: 0.1;
+};
+export declare class DefaultScoringStrategy implements ScoringStrategy {
+    private weights;
+    constructor(weights?: {
+        readonly latency: 0.2;
+        readonly reliability: 0.3;
+        readonly uptime: 0.2;
+        readonly errors: 0.2;
+        readonly activity: 0.1;
+    });
+    calculateScore(metrics: BaseMetrics): number;
+}
+//# sourceMappingURL=scoring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/types/scoring.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAE1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAClE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;IAChC,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;CACrE;AAGD,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAGX,qBAAa,sBAAuB,YAAW,eAAe;IAChD,OAAO,CAAC,OAAO;gBAAP,OAAO;;;;;;KAAkB;IAE7C,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM;CAe7C"}

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"}