nostr-websocket-utils 0.3.1 → 0.3.2

package/dist/cjs/nips/nip-33.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @file NIP-33: Parameterized Replaceable Events
+ * @module nips/nip-33
+ * @see https://github.com/nostr-protocol/nips/blob/master/33.md
+ */
+import type { NostrWSMessage } from '../types/messages';
+import type { Logger } from '../types/logger';
+/**
+ * Parameterized replaceable event kinds (30000-39999)
+ */
+export declare const PARAMETERIZED_REPLACEABLE_KINDS: {
+    CATEGORIZED_BOOKMARK: number;
+    CATEGORIZED_HIGHLIGHT: number;
+    CATEGORIZED_PEOPLE_LIST: number;
+    PROFILE_BADGES: number;
+    BADGE_DEFINITION: number;
+    CUSTOM_START: number;
+    CUSTOM_END: number;
+};
+/**
+ * Creates a parameterized replaceable event
+ * @param kind - Event kind
+ * @param content - Event content
+ * @param identifier - Unique identifier for the parameter
+ * @param additionalTags - Additional tags
+ * @returns {NostrWSMessage} Parameterized replaceable event
+ */
+export declare function createParameterizedEvent(kind: number, content: string, identifier: string, additionalTags?: string[][]): NostrWSMessage;
+/**
+ * Validates a parameterized replaceable event
+ * @param message - Message to validate
+ * @param _logger - Logger instance
+ * @returns {boolean} True if valid
+ */
+export declare function validateParameterizedEvent(message: NostrWSMessage, _logger: Logger): boolean;
+/**
+ * Parameterized event manager interface
+ */
+export interface ParameterizedEventManager {
+    /**
+     * Creates a new parameterized event
+     * @param kind - Event kind
+     * @param content - Event content
+     * @param identifier - Parameter identifier
+     * @param tags - Additional tags
+     * @returns {NostrWSMessage} Created event
+     */
+    createEvent(kind: number, content: string, identifier: string, tags?: string[][]): NostrWSMessage;
+    /**
+     * Updates an existing parameterized event
+     * @param kind - Event kind
+     * @param identifier - Parameter identifier
+     * @param content - New content
+     * @returns {NostrWSMessage} Update event
+     */
+    updateEvent(kind: number, identifier: string, content: string): NostrWSMessage;
+    /**
+     * Subscribes to parameterized events
+     * @param kinds - Event kinds to subscribe to
+     * @param identifiers - Parameter identifiers
+     * @returns {NostrWSMessage} Subscription message
+     */
+    subscribe(kinds: number[], identifiers: string[]): NostrWSMessage;
+}
+/**
+ * Creates a parameterized event manager
+ * @param _logger - Logger instance
+ * @returns {ParameterizedEventManager} Event manager
+ */
+export declare function createParameterizedEventManager(_logger: Logger): ParameterizedEventManager;
+/**
+ * Event replacement handler interface
+ */
+export interface EventReplacementHandler {
+    /**
+     * Checks if an event should replace another
+     * @param newEvent - New event
+     * @param existingEvent - Existing event
+     * @returns {boolean} True if should replace
+     */
+    shouldReplace(newEvent: Record<string, unknown>, existingEvent: Record<string, unknown>): boolean;
+    /**
+     * Gets replacement key for an event
+     * @param event - Event to get key for
+     * @returns {string} Replacement key
+     */
+    getReplacementKey(event: Record<string, unknown>): string;
+}
+/**
+ * Creates an event replacement handler
+ * @param _logger - Logger instance
+ * @returns {EventReplacementHandler} Replacement handler
+ */
+export declare function createEventReplacementHandler(_logger: Logger): EventReplacementHandler;
+//# sourceMappingURL=nip-33.d.ts.map

package/dist/cjs/nips/nip-33.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip-33.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-33.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;CAQ3C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,MAAM,EAAE,EAAO,GAC9B,cAAc,CAShB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAmCT;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAChB,cAAc,CAAC;IAElB;;;;;;OAMG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,cAAc,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,GACpB,cAAc,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,GACd,yBAAyB,CA4B3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC;IAEX;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd,uBAAuB,CAiCzB"}

package/dist/cjs/nips/nip-33.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * @file NIP-33: Parameterized Replaceable Events
+ * @module nips/nip-33
+ * @see https://github.com/nostr-protocol/nips/blob/master/33.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARAMETERIZED_REPLACEABLE_KINDS = void 0;
+exports.createParameterizedEvent = createParameterizedEvent;
+exports.validateParameterizedEvent = validateParameterizedEvent;
+exports.createParameterizedEventManager = createParameterizedEventManager;
+exports.createEventReplacementHandler = createEventReplacementHandler;
+/**
+ * Parameterized replaceable event kinds (30000-39999)
+ */
+exports.PARAMETERIZED_REPLACEABLE_KINDS = {
+    CATEGORIZED_BOOKMARK: 30000,
+    CATEGORIZED_HIGHLIGHT: 30001,
+    CATEGORIZED_PEOPLE_LIST: 30002,
+    PROFILE_BADGES: 30008,
+    BADGE_DEFINITION: 30009,
+    CUSTOM_START: 31000,
+    CUSTOM_END: 39999
+};
+/**
+ * Creates a parameterized replaceable event
+ * @param kind - Event kind
+ * @param content - Event content
+ * @param identifier - Unique identifier for the parameter
+ * @param additionalTags - Additional tags
+ * @returns {NostrWSMessage} Parameterized replaceable event
+ */
+function createParameterizedEvent(kind, content, identifier, additionalTags = []) {
+    return ['EVENT', {
+            kind,
+            content,
+            tags: [
+                ['d', identifier],
+                ...additionalTags
+            ]
+        }];
+}
+/**
+ * Validates a parameterized replaceable event
+ * @param message - Message to validate
+ * @param _logger - Logger instance
+ * @returns {boolean} True if valid
+ */
+function validateParameterizedEvent(message, _logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            return false;
+        }
+        const event = message[1];
+        const kind = event.kind;
+        // Check if kind is in valid range
+        if (kind < 30000 || kind > 39999) {
+            _logger.debug('Invalid kind for parameterized replaceable event');
+            return false;
+        }
+        // Must have exactly one 'd' tag
+        if (!Array.isArray(event.tags)) {
+            _logger.debug('Missing tags array');
+            return false;
+        }
+        const dTags = event.tags.filter(tag => Array.isArray(tag) && tag[0] === 'd' && tag[1]);
+        if (dTags.length !== 1) {
+            _logger.debug('Must have exactly one d tag');
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        _logger.error('Error validating parameterized event:', error);
+        return false;
+    }
+}
+/**
+ * Creates a parameterized event manager
+ * @param _logger - Logger instance
+ * @returns {ParameterizedEventManager} Event manager
+ */
+function createParameterizedEventManager(_logger) {
+    return {
+        createEvent(kind, content, identifier, tags = []) {
+            return createParameterizedEvent(kind, content, identifier, tags);
+        },
+        updateEvent(kind, identifier, content) {
+            return createParameterizedEvent(kind, content, identifier);
+        },
+        subscribe(kinds, identifiers) {
+            return ['REQ', {
+                    filter: {
+                        kinds,
+                        '#d': identifiers
+                    }
+                }];
+        }
+    };
+}
+/**
+ * Creates an event replacement handler
+ * @param _logger - Logger instance
+ * @returns {EventReplacementHandler} Replacement handler
+ */
+function createEventReplacementHandler(_logger) {
+    return {
+        shouldReplace(newEvent, existingEvent) {
+            try {
+                // Must be same kind
+                if (newEvent.kind !== existingEvent.kind)
+                    return false;
+                // Must have same 'd' tag value
+                const newTags = newEvent.tags;
+                const existingTags = existingEvent.tags;
+                const newDTag = newTags?.find(tag => tag[0] === 'd')?.[1];
+                const existingDTag = existingTags?.find(tag => tag[0] === 'd')?.[1];
+                if (newDTag !== existingDTag)
+                    return false;
+                // Replace if newer
+                return newEvent.created_at > existingEvent.created_at;
+            }
+            catch (error) {
+                _logger.error('Error checking event replacement:', error);
+                return false;
+            }
+        },
+        getReplacementKey(event) {
+            const kind = event.kind;
+            const dTag = event.tags?.find(tag => tag[0] === 'd')?.[1];
+            return `${kind}:${dTag}`;
+        }
+    };
+}
+//# sourceMappingURL=nip-33.js.map

package/dist/cjs/nips/nip-33.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * @file Base transport layer for Nostr connections
+ * @module transport/base
+ */
+import { EventEmitter } from 'events';
+import type { MetricsProvider, ScoringStrategy, MetricValue, TransportData } from '../types/scoring';
+export interface TransportOptions {
+    metricsProvider?: MetricsProvider;
+    scoringStrategy?: ScoringStrategy;
+    metricsEnabled?: boolean;
+}
+export declare abstract class BaseTransport extends EventEmitter {
+    protected scoringStrategy: ScoringStrategy;
+    protected metricsProvider?: MetricsProvider;
+    protected metricsEnabled: boolean;
+    constructor(options?: TransportOptions);
+    /**
+     * Create a default metrics provider if none is supplied
+     */
+    protected createDefaultMetricsProvider(): MetricsProvider;
+    /**
+     * Track a metric update
+     */
+    protected trackMetric(endpoint: string, metricType: string, value: MetricValue): void;
+    /**
+     * Gets the score for an endpoint
+     * @param endpoint - Endpoint to get score for
+     * @returns {number} Score between 0 and 100
+     */
+    getScore(endpoint: string): number;
+    /**
+     * Gets scores for all endpoints
+     * @returns {Map<string, number>} Map of endpoint scores
+     */
+    getAllScores(): Map<string, number>;
+    /**
+     * Enable/disable metrics
+     */
+    setMetricsEnabled(enabled: boolean): void;
+    /**
+     * Updates the scoring strategy
+     * @param strategy - New scoring strategy
+     */
+    updateScoringStrategy(strategy: ScoringStrategy): void;
+    /**
+     * Updates the metrics provider
+     * @param provider - New metrics provider
+     */
+    updateMetricsProvider(provider?: MetricsProvider): void;
+    abstract connect(endpoint: string): Promise<void>;
+    abstract disconnect(endpoint: string): Promise<void>;
+    abstract send(endpoint: string, data: TransportData): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/transport/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,WAAW,EACX,aAAa,EACd,MAAM,kBAAkB,CAAC;AAI1B,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,8BAAsB,aAAc,SAAQ,YAAY;IACtD,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAC3C,SAAS,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC5C,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC;gBAEtB,OAAO,GAAE,gBAAqB;IAO1C;;OAEG;IACH,SAAS,CAAC,4BAA4B,IAAI,eAAe;IAkBzD;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAoB9E;;;;OAIG;IACI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IASzC;;;OAGG;IACI,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAW1C;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,OAAO;IAIzC;;;OAGG;IACI,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI7D;;;OAGG;IACI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI;IAM9D,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpD,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CACpE"}

package/dist/cjs/transport/base.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * @file Base transport layer for Nostr connections
+ * @module transport/base
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTransport = void 0;
+const events_1 = require("events");
+const logger_1 = require("../utils/logger");
+const scoring_1 = require("../types/scoring");
+const logger = (0, logger_1.getLogger)('BaseTransport');
+class BaseTransport extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.scoringStrategy = options.scoringStrategy ?? new scoring_1.DefaultScoringStrategy();
+        this.metricsProvider = options.metricsProvider;
+        this.metricsEnabled = !!this.metricsProvider;
+    }
+    /**
+     * Create a default metrics provider if none is supplied
+     */
+    createDefaultMetricsProvider() {
+        return {
+            getMetrics: () => ({
+                totalConnections: 0,
+                activeConnections: 0,
+                connectionErrors: 0,
+                messagesReceived: 0,
+                messagesSent: 0,
+                bytesReceived: 0,
+                bytesSent: 0,
+                averageLatency: 0,
+                lastSeen: Date.now()
+            }),
+            getAllMetrics: () => new Map(),
+            trackMetric: () => { }
+        };
+    }
+    /**
+     * Track a metric update
+     */
+    trackMetric(endpoint, metricType, value) {
+        if (!this.metricsEnabled)
+            return;
+        try {
+            this.metricsProvider?.trackMetric(endpoint, metricType, value);
+            const event = {
+                endpoint,
+                metricType,
+                value,
+                timestamp: Date.now()
+            };
+            this.emit('metric', event);
+        }
+        catch (error) {
+            logger.error({ error, endpoint, metricType }, 'Error tracking metric');
+        }
+    }
+    /**
+     * Gets the score for an endpoint
+     * @param endpoint - Endpoint to get score for
+     * @returns {number} Score between 0 and 100
+     */
+    getScore(endpoint) {
+        if (!this.metricsEnabled)
+            return 100;
+        const metrics = this.metricsProvider?.getMetrics(endpoint);
+        if (!metrics)
+            return 100;
+        return this.scoringStrategy.calculateScore(metrics);
+    }
+    /**
+     * Gets scores for all endpoints
+     * @returns {Map<string, number>} Map of endpoint scores
+     */
+    getAllScores() {
+        if (!this.metricsEnabled || !this.metricsProvider)
+            return new Map();
+        const scores = new Map();
+        const allMetrics = this.metricsProvider.getAllMetrics();
+        for (const [endpoint, metrics] of allMetrics) {
+            scores.set(endpoint, this.scoringStrategy.calculateScore(metrics));
+        }
+        return scores;
+    }
+    /**
+     * Enable/disable metrics
+     */
+    setMetricsEnabled(enabled) {
+        this.metricsEnabled = enabled;
+    }
+    /**
+     * Updates the scoring strategy
+     * @param strategy - New scoring strategy
+     */
+    updateScoringStrategy(strategy) {
+        this.scoringStrategy = strategy;
+    }
+    /**
+     * Updates the metrics provider
+     * @param provider - New metrics provider
+     */
+    updateMetricsProvider(provider) {
+        this.metricsProvider = provider;
+        this.metricsEnabled = !!provider;
+    }
+}
+exports.BaseTransport = BaseTransport;
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/transport/base.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mCAAsC;AACtC,4CAA4C;AAC5C,8CAA0D;AAS1D,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,eAAe,CAAC,CAAC;AAQ1C,MAAsB,aAAc,SAAQ,qBAAY;IAKtD,YAAY,UAA4B,EAAE;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,gCAAsB,EAAE,CAAC;QAC/E,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC/C,CAAC;IAED;;OAEG;IACO,4BAA4B;QACpC,OAAO;YACL,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;gBACjB,gBAAgB,EAAE,CAAC;gBACnB,iBAAiB,EAAE,CAAC;gBACpB,gBAAgB,EAAE,CAAC;gBACnB,gBAAgB,EAAE,CAAC;gBACnB,YAAY,EAAE,CAAC;gBACf,aAAa,EAAE,CAAC;gBAChB,SAAS,EAAE,CAAC;gBACZ,cAAc,EAAE,CAAC;gBACjB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YACF,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE;YAC9B,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,QAAgB,EAAE,UAAkB,EAAE,KAAkB;QAC5E,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAEjC,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAE/D,MAAM,KAAK,GAAsB;gBAC/B,QAAQ;gBACR,UAAU;gBACV,KAAK;gBACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,uBAAuB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,QAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO,GAAG,CAAC;QAErC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC;QAEzB,OAAO,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAEpE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,CAAC;QACxD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,UAAU,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,iBAAiB,CAAC,OAAgB;QACvC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,qBAAqB,CAAC,QAAyB;QACpD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED;;;OAGG;IACI,qBAAqB,CAAC,QAA0B;QACrD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,QAAQ,CAAC;IACnC,CAAC;CAMF;AAjHD,sCAiHC"}

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

@@ -0,0 +1,24 @@
+/**
+ * @file WebSocket transport implementation
+ * @module transport/websocket
+ */
+import { BaseTransport } from './base';
+import type { TransportOptions } from './base';
+export declare class WebSocketTransport extends BaseTransport {
+    private connections;
+    constructor(options?: TransportOptions);
+    connect(endpoint: string): Promise<void>;
+    disconnect(endpoint: string): Promise<void>;
+    send(endpoint: string, data: any): Promise<void>;
+    protected trackMetric(endpoint: string, metric: string, value: unknown): void;
+    private checkEndpointHealth;
+    /**
+     * Get all active WebSocket connections
+     */
+    getActiveConnections(): string[];
+    /**
+     * Check if connected to endpoint
+     */
+    isConnected(endpoint: string): boolean;
+}
+//# sourceMappingURL=websocket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/transport/websocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAI/C,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAO,CAAC,WAAW,CAAqC;gBAE5C,OAAO,GAAE,gBAAqB;IAIpC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDxC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtD,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;YAOxD,mBAAmB;IAsBjC;;OAEG;IACI,oBAAoB,IAAI,MAAM,EAAE;IAIvC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAI9C"}

package/dist/cjs/transport/websocket.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * @file WebSocket transport implementation
+ * @module transport/websocket
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = void 0;
+const ws_1 = __importDefault(require("ws"));
+const base_1 = require("./base");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.getLogger)('WebSocketTransport');
+class WebSocketTransport extends base_1.BaseTransport {
+    constructor(options = {}) {
+        super(options);
+        this.connections = new Map();
+    }
+    async connect(endpoint) {
+        if (this.connections.has(endpoint)) {
+            logger.warn({ endpoint }, 'Already connected to endpoint');
+            return;
+        }
+        try {
+            const ws = new ws_1.default(endpoint);
+            ws.on('open', () => {
+                this.trackMetric(endpoint, 'connection', true);
+                this.trackMetric(endpoint, 'openHandshake', Date.now());
+            });
+            ws.on('close', () => {
+                this.trackMetric(endpoint, 'connection', false);
+                this.trackMetric(endpoint, 'closeHandshake', Date.now());
+                this.connections.delete(endpoint);
+            });
+            ws.on('message', (data) => {
+                const length = data instanceof Buffer ? data.length :
+                    data instanceof ArrayBuffer ? data.byteLength :
+                        data instanceof Array ? data.reduce((acc, buf) => acc + buf.length, 0) : 0;
+                this.trackMetric(endpoint, 'messageReceived', length);
+            });
+            ws.on('error', (error) => {
+                this.trackMetric(endpoint, 'error', error);
+                logger.error({ error, endpoint }, 'WebSocket error');
+            });
+            // Track ping/pong for latency
+            ws.on('ping', () => {
+                this.trackMetric(endpoint, 'ping', Date.now());
+            });
+            ws.on('pong', () => {
+                if (!this.metricsEnabled || !this.metricsProvider)
+                    return;
+                const now = Date.now();
+                const metrics = this.metricsProvider.getMetrics(endpoint);
+                if (!metrics || !metrics.lastSeen)
+                    return;
+                this.trackMetric(endpoint, 'latency', now - metrics.lastSeen);
+            });
+            this.connections.set(endpoint, ws);
+        }
+        catch (error) {
+            this.trackMetric(endpoint, 'connectionError', error);
+            throw error;
+        }
+    }
+    async disconnect(endpoint) {
+        const ws = this.connections.get(endpoint);
+        if (!ws)
+            return;
+        return new Promise((resolve, reject) => {
+            ws.close();
+            ws.on('close', () => {
+                this.connections.delete(endpoint);
+                resolve();
+            });
+            ws.on('error', reject);
+        });
+    }
+    async send(endpoint, data) {
+        const ws = this.connections.get(endpoint);
+        if (!ws)
+            throw new Error(`Not connected to ${endpoint}`);
+        return new Promise((resolve, reject) => {
+            ws.send(data, (error) => {
+                if (error) {
+                    this.trackMetric(endpoint, 'sendError', error);
+                    reject(error);
+                }
+                else {
+                    this.trackMetric(endpoint, 'messageSent', data.length);
+                    resolve();
+                }
+            });
+        });
+    }
+    trackMetric(endpoint, metric, value) {
+        if (this.metricsProvider && this.metricsEnabled) {
+            const metricValue = value instanceof Error ? value.message : String(value);
+            this.metricsProvider.trackMetric(endpoint, metric, metricValue);
+        }
+    }
+    async checkEndpointHealth(endpoint) {
+        try {
+            if (!this.metricsEnabled || !this.metricsProvider) {
+                return true;
+            }
+            const metrics = this.metricsProvider.getMetrics(endpoint);
+            if (!metrics || !metrics.lastSeen) {
+                return true;
+            }
+            const now = Date.now();
+            const elapsed = now - metrics.lastSeen;
+            // If we haven't seen a ping response in 30 seconds, consider unhealthy
+            return elapsed < 30000;
+        }
+        catch (error) {
+            logger.error('Error checking endpoint health:', error);
+            return false;
+        }
+    }
+    /**
+     * Get all active WebSocket connections
+     */
+    getActiveConnections() {
+        return Array.from(this.connections.keys());
+    }
+    /**
+     * Check if connected to endpoint
+     */
+    isConnected(endpoint) {
+        const ws = this.connections.get(endpoint);
+        return ws?.readyState === ws_1.default.OPEN;
+    }
+}
+exports.WebSocketTransport = WebSocketTransport;
+//# sourceMappingURL=websocket.js.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * @file Nostr event type definitions
+ * @module types/events
+ */
+/**
+ * Base Nostr event interface following NIP-01 specification
+ * @see https://github.com/nostr-protocol/nips/blob/master/01.md
+ */
+export interface NostrEvent {
+    /** Event ID in hex format */
+    id: string;
+    /** Public key of the event creator in hex format */
+    pubkey: string;
+    /** Unix timestamp in seconds */
+    created_at: number;
+    /** Event kind number */
+    kind: number;
+    /** Array of tags */
+    tags: string[][];
+    /** Event content */
+    content: string;
+    /** Signature of the event data in hex format */
+    sig: string;
+}
+/**
+ * Signed Nostr event with id and signature
+ * @extends NostrEvent
+ */
+export interface SignedNostrEvent extends NostrEvent {
+    /** Event ID in hex format */
+    id: string;
+    /** Signature of the event data in hex format */
+    sig: string;
+}
+/**
+ * Event validation result
+ */
+export interface NostrEventValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Event subscription filter
+ */
+export interface NostrEventFilter {
+    ids?: string[];
+    authors?: string[];
+    kinds?: number[];
+    since?: number;
+    until?: number;
+    limit?: number;
+    [key: string]: unknown;
+}
+/**
+ * Nostr subscription event interface
+ * Used for creating subscription messages to relays
+ */
+export interface NostrSubscriptionEvent {
+    /** Subscription ID */
+    subscriptionId: string;
+    /** Array of filters */
+    filters: NostrEventFilter[];
+}
+/**
+ * Event handler interface for WebSocket client
+ */
+export interface NostrWSEventHandlers {
+    onMessage?: (message: string) => void;
+    onError?: (error: Error) => void;
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+    onReconnect?: () => void;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IAEjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B"}