nostr-websocket-utils 0.3.1 → 0.3.2

package/dist/cjs/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @file Main entry point for the nostr-websocket-utils library
+ * @module nostr-websocket-utils
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = exports.createServer = exports.NostrServer = exports.NostrWSServer = exports.NostrWSClient = void 0;
+// Core functionality
+var client_js_1 = require("./core/client.js");
+Object.defineProperty(exports, "NostrWSClient", { enumerable: true, get: function () { return client_js_1.NostrWSClient; } });
+var server_js_1 = require("./core/server.js");
+Object.defineProperty(exports, "NostrWSServer", { enumerable: true, get: function () { return server_js_1.NostrWSServer; } });
+var nostr_server_js_1 = require("./core/nostr-server.js");
+Object.defineProperty(exports, "NostrServer", { enumerable: true, get: function () { return nostr_server_js_1.NostrWSServer; } });
+var nostr_server_js_2 = require("./core/nostr-server.js");
+Object.defineProperty(exports, "createServer", { enumerable: true, get: function () { return nostr_server_js_2.createWSServer; } });
+// Utilities
+var logger_js_1 = require("./utils/logger.js");
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return logger_js_1.getLogger; } });
+// Crypto operations
+__exportStar(require("./crypto"), exports);
+// NIP implementations
+__exportStar(require("./nips"), exports);
+// Type definitions
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,qBAAqB;AACrB,8CAAiD;AAAxC,0GAAA,aAAa,OAAA;AACtB,8CAAiD;AAAxC,0GAAA,aAAa,OAAA;AACtB,0DAAsE;AAA7D,8GAAA,aAAa,OAAe;AACrC,0DAAwE;AAA/D,+GAAA,cAAc,OAAgB;AAEvC,YAAY;AACZ,+CAA8C;AAArC,sGAAA,SAAS,OAAA;AAElB,oBAAoB;AACpB,2CAAyB;AAEzB,sBAAsB;AACtB,yCAAuB;AAEvB,mBAAmB;AACnB,0CAAwB"}

package/dist/cjs/nips/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file NIPs implementation index
+ * @module nips
+ */
+export * from './nip-01';
+export * from './nip-02';
+export * from './nip-04';
+export * from './nip-05';
+export * from './nip-09';
+export * from './nip-19';
+export * from './nip-26';
+export * from './nip-11';
+export * from './nip-20';
+export * from './nip-13';
+export * from './nip-16';
+export * from './nip-15';
+export * from './nip-22';
+export * from './nip-28';
+export * from './nip-33';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/nips/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nips/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC"}

package/dist/cjs/nips/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * @file NIPs implementation index
+ * @module nips
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Basic protocol flow
+__exportStar(require("./nip-01"), exports);
+// Contact List and Petnames
+__exportStar(require("./nip-02"), exports);
+// Encrypted Direct Messages
+__exportStar(require("./nip-04"), exports);
+// DNS Identity Verification
+__exportStar(require("./nip-05"), exports);
+// Event Deletion
+__exportStar(require("./nip-09"), exports);
+// bech32-encoded entities
+__exportStar(require("./nip-19"), exports);
+// Delegated Event Signing
+__exportStar(require("./nip-26"), exports);
+// Relay Information Document
+__exportStar(require("./nip-11"), exports);
+// Command Results
+__exportStar(require("./nip-20"), exports);
+// Proof of Work
+__exportStar(require("./nip-13"), exports);
+// Event Treatment
+__exportStar(require("./nip-16"), exports);
+// End of Stored Events Notice
+__exportStar(require("./nip-15"), exports);
+// Event Created At Limits
+__exportStar(require("./nip-22"), exports);
+// Public Chat
+__exportStar(require("./nip-28"), exports);
+// Parameterized Replaceable Events
+__exportStar(require("./nip-33"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/nips/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nips/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,sBAAsB;AACtB,2CAAyB;AAEzB,4BAA4B;AAC5B,2CAAyB;AAEzB,4BAA4B;AAC5B,2CAAyB;AAEzB,4BAA4B;AAC5B,2CAAyB;AAEzB,iBAAiB;AACjB,2CAAyB;AAEzB,0BAA0B;AAC1B,2CAAyB;AAEzB,0BAA0B;AAC1B,2CAAyB;AAEzB,6BAA6B;AAC7B,2CAAyB;AAEzB,kBAAkB;AAClB,2CAAyB;AAEzB,gBAAgB;AAChB,2CAAyB;AAEzB,kBAAkB;AAClB,2CAAyB;AAEzB,8BAA8B;AAC9B,2CAAyB;AAEzB,0BAA0B;AAC1B,2CAAyB;AAEzB,cAAc;AACd,2CAAyB;AAEzB,mCAAmC;AACnC,2CAAyB"}

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

@@ -0,0 +1,35 @@
+/**
+ * @file NIP-01: Basic protocol flow implementation
+ * @module nips/nip-01
+ */
+import type { NostrWSMessage, NostrEvent } from '../types/messages';
+interface NostrEventValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validates a message according to NIP-01 specifications
+ */
+export declare function validateMessage(message: NostrWSMessage): boolean;
+/**
+ * Creates an EVENT message
+ */
+export declare function createEventMessage(event: NostrEvent): NostrWSMessage;
+/**
+ * Creates a REQ message
+ */
+export declare function createReqMessage(subscriptionId: string, filters: Array<Record<string, unknown>>): NostrWSMessage;
+/**
+ * Creates a CLOSE message
+ */
+export declare function createCloseMessage(subscriptionId: string): NostrWSMessage;
+/**
+ * Creates a NOTICE message
+ */
+export declare function createNoticeMessage(message: string): NostrWSMessage;
+/**
+ * Validates a Nostr event according to NIP-01
+ */
+export declare function validateEvent(event: NostrEvent): NostrEventValidationResult;
+export {};
+//# sourceMappingURL=nip-01.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-01.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-01.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpE,UAAU,0BAA0B;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAoChE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAEpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc,CAKhH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,CAIzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAInE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,0BAA0B,CA+C3E"}

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

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * @file NIP-01: Basic protocol flow implementation
+ * @module nips/nip-01
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMessage = validateMessage;
+exports.createEventMessage = createEventMessage;
+exports.createReqMessage = createReqMessage;
+exports.createCloseMessage = createCloseMessage;
+exports.createNoticeMessage = createNoticeMessage;
+exports.validateEvent = validateEvent;
+const logger_1 = require("../utils/logger");
+const messages_1 = require("../types/messages");
+const logger = (0, logger_1.getLogger)('NIP-01');
+/**
+ * Validates a message according to NIP-01 specifications
+ */
+function validateMessage(message) {
+    if (!message || !Array.isArray(message)) {
+        logger.debug('Invalid message format');
+        return false;
+    }
+    if (!message[0] || !(message[0] in messages_1.MESSAGE_TYPES)) {
+        logger.debug(`Invalid message type: ${message[0]}`);
+        return false;
+    }
+    if (!message[1] || typeof message[1] !== 'object') {
+        logger.debug('Invalid message data');
+        return false;
+    }
+    // Message type specific validation
+    if (message[0] === messages_1.MESSAGE_TYPES.EVENT) {
+        if (!validateEvent(message[1]).valid) {
+            return false;
+        }
+    }
+    if (message[0] === messages_1.MESSAGE_TYPES.REQ) {
+        if (!validateReqMessage(message)) {
+            return false;
+        }
+    }
+    if (message[0] === messages_1.MESSAGE_TYPES.CLOSE) {
+        if (!validateCloseMessage(message)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Creates an EVENT message
+ */
+function createEventMessage(event) {
+    return [messages_1.MESSAGE_TYPES.EVENT, event];
+}
+/**
+ * Creates a REQ message
+ */
+function createReqMessage(subscriptionId, filters) {
+    return [messages_1.MESSAGE_TYPES.REQ, {
+            subscription_id: subscriptionId,
+            filters
+        }];
+}
+/**
+ * Creates a CLOSE message
+ */
+function createCloseMessage(subscriptionId) {
+    return [messages_1.MESSAGE_TYPES.CLOSE, {
+            subscription_id: subscriptionId
+        }];
+}
+/**
+ * Creates a NOTICE message
+ */
+function createNoticeMessage(message) {
+    return [messages_1.MESSAGE_TYPES.NOTICE, {
+            message
+        }];
+}
+/**
+ * Validates a Nostr event according to NIP-01
+ */
+function validateEvent(event) {
+    if (typeof event !== 'object' || !event) {
+        return { valid: false, error: 'Event must be an object' };
+    }
+    const typedEvent = event;
+    if (!typedEvent.id || typeof typedEvent.id !== 'string') {
+        return { valid: false, error: 'Event must have a string id' };
+    }
+    if (!typedEvent.pubkey || typeof typedEvent.pubkey !== 'string') {
+        return { valid: false, error: 'Event must have a string pubkey' };
+    }
+    if (!typedEvent.created_at || typeof typedEvent.created_at !== 'number') {
+        return { valid: false, error: 'Event must have a number created_at' };
+    }
+    if (!typedEvent.kind || typeof typedEvent.kind !== 'number') {
+        return { valid: false, error: 'Event must have a number kind' };
+    }
+    if (!Array.isArray(typedEvent.tags)) {
+        return { valid: false, error: 'Event must have an array of tags' };
+    }
+    if (!typedEvent.content || typeof typedEvent.content !== 'string') {
+        return { valid: false, error: 'Event must have a string content' };
+    }
+    if (!typedEvent.sig || typeof typedEvent.sig !== 'string') {
+        return { valid: false, error: 'Event must have a string sig' };
+    }
+    // Validate tag structure
+    for (const tag of typedEvent.tags) {
+        if (!Array.isArray(tag) || tag.length === 0) {
+            return { valid: false, error: 'Each tag must be a non-empty array' };
+        }
+        if (typeof tag[0] !== 'string') {
+            return { valid: false, error: 'Tag identifier must be a string' };
+        }
+    }
+    return { valid: true };
+}
+// Private helper functions
+function validateReqMessage(message) {
+    const { subscription_id, filters } = message[1];
+    if (!subscription_id || typeof subscription_id !== 'string') {
+        logger.debug('Invalid subscription_id');
+        return false;
+    }
+    if (!Array.isArray(filters)) {
+        logger.debug('Invalid filters format');
+        return false;
+    }
+    return true;
+}
+function validateCloseMessage(message) {
+    const { subscription_id } = message[1];
+    if (!subscription_id || typeof subscription_id !== 'string') {
+        logger.debug('Invalid subscription_id');
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=nip-01.js.map

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

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

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

@@ -0,0 +1,83 @@
+/**
+ * @file NIP-02: Contact List and Petnames
+ * @module nips/nip-02
+ * @see https://github.com/nostr-protocol/nips/blob/master/02.md
+ */
+import type { NostrWSMessage } from '../types/messages';
+import type { Logger } from '../types/logger';
+/**
+ * Contact list event kind
+ */
+export declare const CONTACT_LIST_KIND = 3;
+/**
+ * Contact entry structure
+ */
+export interface Contact {
+    pubkey: string;
+    relay?: string;
+    petname?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Creates a contact list event
+ * @param contacts - List of contacts
+ * @param metadata - Optional metadata for the contact list
+ * @returns {NostrWSMessage} Contact list event
+ */
+export declare function createContactListEvent(contacts: Contact[], metadata?: Record<string, unknown>): NostrWSMessage;
+/**
+ * Extracts contacts from a contact list event
+ * @param message - Contact list message
+ * @returns {Contact[]} Array of contacts
+ */
+export declare function extractContacts(message: NostrWSMessage): Contact[];
+/**
+ * Creates a contact list subscription message
+ * @param pubkey - Public key to subscribe to
+ * @returns {NostrWSMessage} Subscription message
+ */
+export declare function createContactListSubscription(pubkey: string): NostrWSMessage;
+/**
+ * Contact list manager interface
+ */
+export interface ContactListManager {
+    /**
+     * Adds or updates a contact
+     * @param contact - Contact to add/update
+     */
+    addContact(contact: Contact): void;
+    /**
+     * Removes a contact
+     * @param pubkey - Public key of contact to remove
+     */
+    removeContact(pubkey: string): void;
+    /**
+     * Gets a contact by public key
+     * @param pubkey - Public key to look up
+     * @returns {Contact | undefined} Contact if found
+     */
+    getContact(pubkey: string): Contact | undefined;
+    /**
+     * Gets all contacts
+     * @returns {Contact[]} Array of all contacts
+     */
+    getAllContacts(): Contact[];
+    /**
+     * Updates contact metadata
+     * @param pubkey - Public key of contact
+     * @param metadata - New metadata
+     */
+    updateContactMetadata(pubkey: string, metadata: Record<string, unknown>): void;
+    /**
+     * Creates a contact list event
+     * @returns {NostrWSMessage} Contact list event
+     */
+    createEvent(): NostrWSMessage;
+}
+/**
+ * Creates a contact list manager
+ * @param _logger - Logger instance
+ * @returns {ContactListManager} Contact list manager
+ */
+export declare function createContactListManager(_logger: Logger): ContactListManager;
+//# sourceMappingURL=nip-02.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-02.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-02.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,iBAAiB,IAAI,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,cAAc,CAahB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,EAAE,CA4BX;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAO5E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEnC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAEhD;;;OAGG;IACH,cAAc,IAAI,OAAO,EAAE,CAAC;IAE5B;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/E;;;OAGG;IACH,WAAW,IAAI,cAAc,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAqC5E"}

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

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * @file NIP-02: Contact List and Petnames
+ * @module nips/nip-02
+ * @see https://github.com/nostr-protocol/nips/blob/master/02.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTACT_LIST_KIND = void 0;
+exports.createContactListEvent = createContactListEvent;
+exports.extractContacts = extractContacts;
+exports.createContactListSubscription = createContactListSubscription;
+exports.createContactListManager = createContactListManager;
+/**
+ * Contact list event kind
+ */
+exports.CONTACT_LIST_KIND = 3;
+/**
+ * Creates a contact list event
+ * @param contacts - List of contacts
+ * @param metadata - Optional metadata for the contact list
+ * @returns {NostrWSMessage} Contact list event
+ */
+function createContactListEvent(contacts, metadata = {}) {
+    const tags = contacts.map(contact => {
+        const tag = ['p', contact.pubkey];
+        if (contact.relay)
+            tag.push(contact.relay);
+        if (contact.petname)
+            tag.push(contact.petname);
+        return tag;
+    });
+    return ['EVENT', {
+            kind: exports.CONTACT_LIST_KIND,
+            tags,
+            content: JSON.stringify(metadata)
+        }];
+}
+/**
+ * Extracts contacts from a contact list event
+ * @param message - Contact list message
+ * @returns {Contact[]} Array of contacts
+ */
+function extractContacts(message) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            return [];
+        }
+        const event = message[1];
+        if (event.kind !== exports.CONTACT_LIST_KIND) {
+            return [];
+        }
+        if (!Array.isArray(event.tags)) {
+            return [];
+        }
+        const metadata = event.content ? JSON.parse(event.content) : {};
+        return event.tags
+            .filter(tag => Array.isArray(tag) && tag[0] === 'p')
+            .map(tag => ({
+            pubkey: tag[1],
+            relay: tag[2],
+            petname: tag[3],
+            metadata
+        }));
+    }
+    catch (error) {
+        return [];
+    }
+}
+/**
+ * Creates a contact list subscription message
+ * @param pubkey - Public key to subscribe to
+ * @returns {NostrWSMessage} Subscription message
+ */
+function createContactListSubscription(pubkey) {
+    return ['REQ', {
+            filter: {
+                authors: [pubkey],
+                kinds: [exports.CONTACT_LIST_KIND]
+            }
+        }];
+}
+/**
+ * Creates a contact list manager
+ * @param _logger - Logger instance
+ * @returns {ContactListManager} Contact list manager
+ */
+function createContactListManager(_logger) {
+    const contacts = new Map();
+    return {
+        addContact(contact) {
+            contacts.set(contact.pubkey, contact);
+        },
+        removeContact(pubkey) {
+            contacts.delete(pubkey);
+        },
+        getContact(pubkey) {
+            return contacts.get(pubkey);
+        },
+        getAllContacts() {
+            return Array.from(contacts.values());
+        },
+        updateContactMetadata(pubkey, metadata) {
+            const contact = contacts.get(pubkey);
+            if (contact) {
+                contacts.set(pubkey, {
+                    ...contact,
+                    metadata: {
+                        ...contact.metadata,
+                        ...metadata
+                    }
+                });
+            }
+        },
+        createEvent() {
+            return createContactListEvent(Array.from(contacts.values()));
+        }
+    };
+}
+//# sourceMappingURL=nip-02.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * @file NIP-04: Encrypted Direct Message Support
+ * @module nips/nip-04
+ * @see https://github.com/nostr-protocol/nips/blob/master/04.md
+ */
+import type { NostrWSMessage } from '../types/messages';
+import type { Logger } from '../types/logger';
+/**
+ * Kind value for encrypted direct messages
+ */
+export declare const ENCRYPTED_DM_KIND = 4;
+/**
+ * Creates an encrypted direct message event
+ * @param content - Message content to encrypt
+ * @param recipientPubkey - Recipient's public key
+ * @param senderPrivkey - Sender's private key
+ * @param tags - Additional tags for the event
+ * @returns {Promise<NostrWSMessage>} Encrypted message event
+ */
+export declare function createEncryptedDM(content: string, recipientPubkey: string, senderPrivkey: string, tags?: string[][]): Promise<NostrWSMessage>;
+/**
+ * Decrypts a received direct message event
+ * @param message - Received message
+ * @param recipientPrivkey - Recipient's private key
+ * @param senderPubkey - Sender's public key
+ * @param logger - Logger instance
+ * @returns {Promise<string>} Decrypted message content
+ */
+export declare function decryptDM(message: NostrWSMessage, recipientPrivkey: string, senderPubkey: string, logger: Logger): Promise<string>;
+/**
+ * Validates an encrypted DM event format
+ * @param message - Message to validate
+ * @param logger - Logger instance
+ * @returns {boolean} True if message follows NIP-04 format
+ */
+export declare function validateEncryptedDM(message: NostrWSMessage, logger: Logger): boolean;
+//# sourceMappingURL=nip-04.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-04.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-04.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,MAAM,EAAE,EAAO,GACpB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAqCT"}