nostr-websocket-utils 0.3.0 → 0.3.2

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

@@ -0,0 +1,133 @@
+/**
+ * @file Message type definitions
+ * @module types/messages
+ */
+import { MessagePriority } from './priority';
+/**
+ * Message types that can be sent through the WebSocket connection
+ * Following NIP-01 and other NIPs message types
+ */
+export declare const MESSAGE_TYPES: {
+    readonly EVENT: "EVENT";
+    readonly REQ: "REQ";
+    readonly CLOSE: "CLOSE";
+    readonly NOTICE: "NOTICE";
+    readonly EOSE: "EOSE";
+    readonly OK: "OK";
+    readonly AUTH: "AUTH";
+    readonly COUNT: "COUNT";
+    readonly PING: "PING";
+    readonly PONG: "PONG";
+    readonly ERROR: "error";
+};
+export type MessageType = keyof typeof MESSAGE_TYPES;
+/**
+ * Base Nostr WebSocket message interface
+ */
+export interface NostrWSMessageBase {
+    type: MessageType;
+    data?: unknown;
+    priority?: MessagePriority;
+    queuedAt?: number;
+    retryCount?: number;
+}
+/**
+ * Nostr WebSocket message type
+ * Array format: [<message_type>, ...data]
+ */
+export type NostrWSMessage = [MessageType, ...unknown[]];
+/**
+ * Queue item interface for message queue
+ */
+export interface QueueItem extends NostrWSMessageBase {
+    priority: MessagePriority;
+    queuedAt: number;
+    retryCount: number;
+}
+/**
+ * Nostr event message
+ */
+export interface NostrEvent {
+    id: string;
+    kind: number;
+    content: string;
+    tags: string[][];
+    created_at?: number;
+    pubkey?: string;
+    sig?: string;
+}
+/**
+ * Server-side Nostr WebSocket message
+ * Extends the base NostrWSMessage tuple type with additional server-specific metadata
+ */
+export type NostrWSServerMessage = NostrWSMessage & {
+    clientId?: string;
+    timestamp?: number;
+};
+/**
+ * Helper function to create server messages
+ */
+export declare function createServerMessage(type: MessageType, data: unknown[], clientId?: string): NostrWSServerMessage;
+/**
+ * Structure of a Nostr WebSocket filter
+ */
+export interface NostrWSFilter {
+    /** Array of event IDs */
+    ids?: string[];
+    /** Array of pubkeys */
+    authors?: string[];
+    /** Array of event kinds */
+    kinds?: number[];
+    /** Event tags */
+    tags?: Record<string, string[]>;
+    /** Unix timestamp range */
+    since?: number;
+    until?: number;
+    /** Maximum number of events to return */
+    limit?: number;
+}
+/**
+ * Represents a subscription to a Nostr relay
+ */
+export interface NostrWSSubscription {
+    /**
+     * Unique identifier for the subscription
+     */
+    subscription_id: string;
+    /**
+     * Filters for the subscription
+     */
+    filters: Array<Record<string, unknown>>;
+    /**
+     * Active state of the subscription
+     */
+    active?: boolean;
+    /**
+     * Timestamp when the subscription was created
+     */
+    createdAt?: number;
+}
+/**
+ * Result of validating a NostrWSMessage
+ */
+export interface NostrWSValidationResult {
+    /**
+     * Whether the message is valid
+     */
+    isValid: boolean;
+    /**
+     * Error message if validation failed
+     */
+    error?: string;
+}
+/**
+ * Connection states for WebSocket client
+ */
+export declare enum ConnectionState {
+    CONNECTING = "CONNECTING",
+    CONNECTED = "CONNECTED",
+    DISCONNECTED = "DISCONNECTED",
+    RECONNECTING = "RECONNECTING",
+    FAILED = "FAILED"
+}
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/types/messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,aAAa,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,kBAAkB;IACnD,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAK/G;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAC7B,MAAM,WAAW;CAClB"}

package/dist/cjs/types/messages.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @file Message type definitions
+ * @module types/messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionState = exports.MESSAGE_TYPES = void 0;
+exports.createServerMessage = createServerMessage;
+/**
+ * Message types that can be sent through the WebSocket connection
+ * Following NIP-01 and other NIPs message types
+ */
+exports.MESSAGE_TYPES = {
+    EVENT: 'EVENT', // NIP-01: Basic protocol flow events
+    REQ: 'REQ', // NIP-01: Request events
+    CLOSE: 'CLOSE', // NIP-01: Close subscription
+    NOTICE: 'NOTICE', // NIP-01: Human-readable messages
+    EOSE: 'EOSE', // NIP-15: End of stored events notice
+    OK: 'OK', // NIP-20: Command result
+    AUTH: 'AUTH', // NIP-42: Authentication
+    COUNT: 'COUNT', // NIP-45: Event counts
+    PING: 'PING', // Internal heartbeat ping
+    PONG: 'PONG', // Internal heartbeat pong
+    ERROR: 'error' // Internal error type (lowercase to differentiate)
+};
+/**
+ * Helper function to create server messages
+ */
+function createServerMessage(type, data, clientId) {
+    const message = [type, ...data];
+    message.clientId = clientId;
+    message.timestamp = Date.now();
+    return message;
+}
+/**
+ * Connection states for WebSocket client
+ */
+var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState["CONNECTING"] = "CONNECTING";
+    ConnectionState["CONNECTED"] = "CONNECTED";
+    ConnectionState["DISCONNECTED"] = "DISCONNECTED";
+    ConnectionState["RECONNECTING"] = "RECONNECTING";
+    ConnectionState["FAILED"] = "FAILED";
+})(ConnectionState || (exports.ConnectionState = ConnectionState = {}));
+//# sourceMappingURL=messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/types/messages.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2EH,kDAKC;AA5ED;;;GAGG;AACU,QAAA,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO,EAAK,qCAAqC;IACxD,GAAG,EAAE,KAAK,EAAQ,yBAAyB;IAC3C,KAAK,EAAE,OAAO,EAAI,6BAA6B;IAC/C,MAAM,EAAE,QAAQ,EAAE,kCAAkC;IACpD,IAAI,EAAE,MAAM,EAAM,sCAAsC;IACxD,EAAE,EAAE,IAAI,EAAU,yBAAyB;IAC3C,IAAI,EAAE,MAAM,EAAM,yBAAyB;IAC3C,KAAK,EAAE,OAAO,EAAI,uBAAuB;IACzC,IAAI,EAAE,MAAM,EAAM,0BAA0B;IAC5C,IAAI,EAAE,MAAM,EAAM,0BAA0B;IAC5C,KAAK,EAAE,OAAO,CAAI,mDAAmD;CAC7D,CAAC;AAoDX;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAAiB,EAAE,IAAe,EAAE,QAAiB;IACvF,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAyB,CAAC;IACxD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AA6DD;;GAEG;AACH,IAAY,eAMX;AAND,WAAY,eAAe;IACzB,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,gDAA6B,CAAA;IAC7B,gDAA6B,CAAA;IAC7B,oCAAiB,CAAA;AACnB,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B"}

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