nostr-websocket-utils 0.3.1 → 0.3.2

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

@@ -0,0 +1,89 @@
+/**
+ * @file NIP-16: Event Treatment
+ * @module nips/nip-16
+ * @see https://github.com/nostr-protocol/nips/blob/master/16.md
+ */
+import type { NostrWSMessage } from '../types/messages';
+import type { Logger } from '../types/logger';
+/**
+ * Event treatment types
+ */
+export declare const EventTreatment: {
+    readonly EPHEMERAL: "ephemeral";
+    readonly REPLACEABLE: "replaceable";
+    readonly PERSISTENT: "persistent";
+};
+export type EventTreatmentType = typeof EventTreatment[keyof typeof EventTreatment];
+/**
+ * Replaceable event kinds (10000-19999)
+ */
+export declare const REPLACEABLE_EVENT_KINDS: {
+    METADATA: number;
+    CONTACT_LIST: number;
+    CHANNEL_METADATA: number;
+    CHANNEL_MESSAGE: number;
+    USER_STATUS: number;
+    USER_PROFILE: number;
+    RELAY_LIST: number;
+    BOOKMARKS: number;
+    MUTE_LIST: number;
+    PIN_LIST: number;
+    RELAY_METADATA: number;
+    CLIENT_PREFERENCES: number;
+    CUSTOM_START: number;
+    CUSTOM_END: number;
+};
+/**
+ * Ephemeral event kinds (20000-29999)
+ */
+export declare const EPHEMERAL_EVENT_KINDS: {
+    TYPING_INDICATOR: number;
+    ONLINE_STATUS: number;
+    USER_PRESENCE: number;
+    CUSTOM_START: number;
+    CUSTOM_END: number;
+};
+/**
+ * Determines event treatment type
+ * @param eventKind - Event kind number
+ * @returns {EventTreatmentType} Event treatment type
+ */
+export declare function getEventTreatment(eventKind: number): EventTreatmentType;
+/**
+ * Validates event treatment rules
+ * @param message - Message to validate
+ * @param logger - Logger instance
+ * @returns {boolean} True if event follows treatment rules
+ */
+export declare function validateEventTreatment(message: NostrWSMessage, logger: Logger): boolean;
+/**
+ * Storage management interface for different event types
+ */
+export interface EventStorageManager {
+    /**
+     * Determines if an event should be stored
+     * @param event - Event to check
+     * @returns {boolean} True if event should be stored
+     */
+    shouldStore(event: Record<string, unknown>): boolean;
+    /**
+     * Gets storage duration for an event
+     * @param event - Event to check
+     * @returns {number} Storage duration in seconds (0 for permanent)
+     */
+    getStorageDuration(event: Record<string, unknown>): number;
+    /**
+     * Checks if an event should replace another
+     * @param newEvent - New event
+     * @param existingEvent - Existing event
+     * @returns {boolean} True if new event should replace existing
+     */
+    shouldReplace(newEvent: Record<string, unknown>, existingEvent: Record<string, unknown>): boolean;
+}
+/**
+ * Creates default event storage manager
+ * @param logger - Logger instance
+ * @returns {EventStorageManager} Storage manager
+ */
+export declare function createEventStorageManager(logger: Logger): EventStorageManager;
+//# sourceMappingURL=nip-16.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-16.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-16.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,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;CAenC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAMjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAuCT;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IAErD;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAE3D;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACnG;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAwD7E"}

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

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * @file NIP-16: Event Treatment
+ * @module nips/nip-16
+ * @see https://github.com/nostr-protocol/nips/blob/master/16.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EPHEMERAL_EVENT_KINDS = exports.REPLACEABLE_EVENT_KINDS = exports.EventTreatment = void 0;
+exports.getEventTreatment = getEventTreatment;
+exports.validateEventTreatment = validateEventTreatment;
+exports.createEventStorageManager = createEventStorageManager;
+/**
+ * Event treatment types
+ */
+exports.EventTreatment = {
+    EPHEMERAL: 'ephemeral',
+    REPLACEABLE: 'replaceable',
+    PERSISTENT: 'persistent'
+};
+/**
+ * Replaceable event kinds (10000-19999)
+ */
+exports.REPLACEABLE_EVENT_KINDS = {
+    METADATA: 0,
+    CONTACT_LIST: 3,
+    CHANNEL_METADATA: 41,
+    CHANNEL_MESSAGE: 42,
+    USER_STATUS: 10000,
+    USER_PROFILE: 10001,
+    RELAY_LIST: 10002,
+    BOOKMARKS: 10003,
+    MUTE_LIST: 10004,
+    PIN_LIST: 10005,
+    RELAY_METADATA: 10010,
+    CLIENT_PREFERENCES: 10015,
+    CUSTOM_START: 11000,
+    CUSTOM_END: 19999
+};
+/**
+ * Ephemeral event kinds (20000-29999)
+ */
+exports.EPHEMERAL_EVENT_KINDS = {
+    TYPING_INDICATOR: 20001,
+    ONLINE_STATUS: 20002,
+    USER_PRESENCE: 20003,
+    CUSTOM_START: 21000,
+    CUSTOM_END: 29999
+};
+/**
+ * Determines event treatment type
+ * @param eventKind - Event kind number
+ * @returns {EventTreatmentType} Event treatment type
+ */
+function getEventTreatment(eventKind) {
+    if (eventKind >= 20000 && eventKind < 30000) {
+        return exports.EventTreatment.EPHEMERAL;
+    }
+    if (eventKind >= 10000 && eventKind < 20000 || [0, 3, 41, 42].includes(eventKind)) {
+        return exports.EventTreatment.REPLACEABLE;
+    }
+    return exports.EventTreatment.PERSISTENT;
+}
+/**
+ * Validates event treatment rules
+ * @param message - Message to validate
+ * @param logger - Logger instance
+ * @returns {boolean} True if event follows treatment rules
+ */
+function validateEventTreatment(message, logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            return true; // Not an event message
+        }
+        const event = message[1];
+        const kind = event.kind;
+        const treatment = getEventTreatment(kind);
+        // Validate based on treatment type
+        switch (treatment) {
+            case exports.EventTreatment.EPHEMERAL:
+                // Ephemeral events shouldn't have large content
+                if (typeof event.content === 'string' && event.content.length > 1000) {
+                    logger.debug('Ephemeral event content too large');
+                    return false;
+                }
+                break;
+            case exports.EventTreatment.REPLACEABLE:
+                // Replaceable events must have proper 'd' tag for uniqueness
+                if (Array.isArray(event.tags)) {
+                    const dTags = event.tags.filter(tag => Array.isArray(tag) && tag[0] === 'd');
+                    if (dTags.length > 1) {
+                        logger.debug('Multiple d tags in replaceable event');
+                        return false;
+                    }
+                }
+                break;
+        }
+        return true;
+    }
+    catch (error) {
+        logger.error('Error validating event treatment:', error);
+        return false;
+    }
+}
+/**
+ * Creates default event storage manager
+ * @param logger - Logger instance
+ * @returns {EventStorageManager} Storage manager
+ */
+function createEventStorageManager(logger) {
+    return {
+        shouldStore(event) {
+            const kind = event.kind;
+            const treatment = getEventTreatment(kind);
+            // Don't store ephemeral events by default
+            if (treatment === exports.EventTreatment.EPHEMERAL) {
+                return false;
+            }
+            return true;
+        },
+        getStorageDuration(event) {
+            const kind = event.kind;
+            const treatment = getEventTreatment(kind);
+            switch (treatment) {
+                case exports.EventTreatment.EPHEMERAL:
+                    return 300; // 5 minutes
+                case exports.EventTreatment.REPLACEABLE:
+                    return 0; // Permanent until replaced
+                default:
+                    return 0; // Permanent
+            }
+        },
+        shouldReplace(newEvent, existingEvent) {
+            try {
+                const kind = newEvent.kind;
+                if (kind !== existingEvent.kind)
+                    return false;
+                const treatment = getEventTreatment(kind);
+                if (treatment !== exports.EventTreatment.REPLACEABLE)
+                    return false;
+                // Check 'd' tag for parameterized replaceable events
+                if (Array.isArray(newEvent.tags) && Array.isArray(existingEvent.tags)) {
+                    const newDTag = newEvent.tags.find(tag => Array.isArray(tag) && tag[0] === 'd')?.[1];
+                    const existingDTag = existingEvent.tags.find(tag => Array.isArray(tag) && tag[0] === 'd')?.[1];
+                    if (newDTag !== existingDTag)
+                        return false;
+                }
+                // Replace if new event is newer
+                return newEvent.created_at > existingEvent.created_at;
+            }
+            catch (error) {
+                logger.error('Error checking event replacement:', error);
+                return false;
+            }
+        }
+    };
+}
+//# sourceMappingURL=nip-16.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-16.js","sourceRoot":"","sources":["../../../src/nips/nip-16.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAoDH,8CAQC;AAQD,wDA0CC;AAkCD,8DAwDC;AAnMD;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;CAChB,CAAC;AAIX;;GAEG;AACU,QAAA,uBAAuB,GAAG;IACrC,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE,CAAC;IACf,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,QAAQ,EAAE,KAAK;IACf,cAAc,EAAE,KAAK;IACrB,kBAAkB,EAAE,KAAK;IACzB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACnC,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,SAAiB;IACjD,IAAI,SAAS,IAAI,KAAK,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;QAC5C,OAAO,sBAAc,CAAC,SAAS,CAAC;IAClC,CAAC;IACD,IAAI,SAAS,IAAI,KAAK,IAAI,SAAS,GAAG,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAClF,OAAO,sBAAc,CAAC,WAAW,CAAC;IACpC,CAAC;IACD,OAAO,sBAAc,CAAC,UAAU,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,OAAuB,EACvB,MAAc;IAEd,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC,CAAC,uBAAuB;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAA4B,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAc,CAAC;QAClC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE1C,mCAAmC;QACnC,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,sBAAc,CAAC,SAAS;gBAC3B,gDAAgD;gBAChD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;oBACrE,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;oBAClD,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,MAAM;YAER,KAAK,sBAAc,CAAC,WAAW;gBAC7B,6DAA6D;gBAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CACrC,CAAC;oBACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;wBACrD,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;gBACD,MAAM;QACV,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AA6BD;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,MAAc;IACtD,OAAO;QACL,WAAW,CAAC,KAA8B;YACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAc,CAAC;YAClC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAE1C,0CAA0C;YAC1C,IAAI,SAAS,KAAK,sBAAc,CAAC,SAAS,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kBAAkB,CAAC,KAA8B;YAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAc,CAAC;YAClC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAE1C,QAAQ,SAAS,EAAE,CAAC;gBAClB,KAAK,sBAAc,CAAC,SAAS;oBAC3B,OAAO,GAAG,CAAC,CAAC,YAAY;gBAC1B,KAAK,sBAAc,CAAC,WAAW;oBAC7B,OAAO,CAAC,CAAC,CAAC,2BAA2B;gBACvC;oBACE,OAAO,CAAC,CAAC,CAAC,YAAY;YAC1B,CAAC;QACH,CAAC;QAED,aAAa,CAAC,QAAiC,EAAE,aAAsC;YACrF,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAc,CAAC;gBACrC,IAAI,IAAI,KAAK,aAAa,CAAC,IAAI;oBAAE,OAAO,KAAK,CAAC;gBAE9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC1C,IAAI,SAAS,KAAK,sBAAc,CAAC,WAAW;oBAAE,OAAO,KAAK,CAAC;gBAE3D,qDAAqD;gBACrD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACvC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CACrC,EAAE,CAAC,CAAC,CAAC,CAAC;oBACP,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACjD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CACrC,EAAE,CAAC,CAAC,CAAC,CAAC;oBAEP,IAAI,OAAO,KAAK,YAAY;wBAAE,OAAO,KAAK,CAAC;gBAC7C,CAAC;gBAED,gCAAgC;gBAChC,OAAQ,QAAQ,CAAC,UAAqB,GAAI,aAAa,CAAC,UAAqB,CAAC;YAChF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;gBACzD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * @file NIP-19: bech32-encoded entities
+ * @module nips/nip-19
+ */
+/**
+ * Encode a public key to bech32 npub format
+ */
+export declare function encodePubkey(pubkey: string): string;
+/**
+ * Encode a private key to bech32 nsec format
+ */
+export declare function encodePrivkey(privkey: string): string;
+/**
+ * Decode a bech32 npub to hex pubkey
+ */
+export declare function decodePubkey(npub: string): string;
+/**
+ * Decode a bech32 nsec to hex privkey
+ */
+export declare function decodePrivkey(nsec: string): string;
+/**
+ * Process tags containing bech32-encoded entities
+ */
+export declare function processBech32Tags(tags: string[][]): string[][];
+/**
+ * Encode tags containing hex pubkeys to bech32
+ */
+export declare function encodeBech32Tags(tags: string[][]): string[][];
+//# sourceMappingURL=nip-19.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-19.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-19.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAa9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAa7D"}

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

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * @file NIP-19: bech32-encoded entities
+ * @module nips/nip-19
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodePubkey = encodePubkey;
+exports.encodePrivkey = encodePrivkey;
+exports.decodePubkey = decodePubkey;
+exports.decodePrivkey = decodePrivkey;
+exports.processBech32Tags = processBech32Tags;
+exports.encodeBech32Tags = encodeBech32Tags;
+const logger_1 = require("../utils/logger");
+const bech32_1 = require("../crypto/bech32");
+const logger = (0, logger_1.getLogger)('NIP-19');
+/**
+ * Encode a public key to bech32 npub format
+ */
+function encodePubkey(pubkey) {
+    try {
+        return (0, bech32_1.encodeToBech32)('npub', pubkey);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to encode pubkey: ${errorMessage}`);
+        throw new Error(`Failed to encode pubkey: ${errorMessage}`);
+    }
+}
+/**
+ * Encode a private key to bech32 nsec format
+ */
+function encodePrivkey(privkey) {
+    try {
+        return (0, bech32_1.encodeToBech32)('nsec', privkey);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to encode private key: ${errorMessage}`);
+        throw new Error(`Failed to encode private key: ${errorMessage}`);
+    }
+}
+/**
+ * Decode a bech32 npub to hex pubkey
+ */
+function decodePubkey(npub) {
+    try {
+        const { prefix, hex } = (0, bech32_1.decodeFromBech32)(npub);
+        if (prefix !== 'npub') {
+            throw new Error('Invalid prefix for public key');
+        }
+        return hex;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to decode pubkey: ${errorMessage}`);
+        throw new Error(`Failed to decode pubkey: ${errorMessage}`);
+    }
+}
+/**
+ * Decode a bech32 nsec to hex privkey
+ */
+function decodePrivkey(nsec) {
+    try {
+        const { prefix, hex } = (0, bech32_1.decodeFromBech32)(nsec);
+        if (prefix !== 'nsec') {
+            throw new Error('Invalid prefix for private key');
+        }
+        return hex;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to decode private key: ${errorMessage}`);
+        throw new Error(`Failed to decode private key: ${errorMessage}`);
+    }
+}
+/**
+ * Process tags containing bech32-encoded entities
+ */
+function processBech32Tags(tags) {
+    return tags.map(tag => {
+        try {
+            if (tag[0] === 'p' && tag[1].startsWith('npub')) {
+                return [tag[0], decodePubkey(tag[1])];
+            }
+            return tag;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.debug(`Failed to decode pubkey ${tag[1]}: ${errorMessage}`);
+            return tag;
+        }
+    });
+}
+/**
+ * Encode tags containing hex pubkeys to bech32
+ */
+function encodeBech32Tags(tags) {
+    return tags.map(tag => {
+        try {
+            if (tag[0] === 'p' && !tag[1].startsWith('npub')) {
+                return [tag[0], encodePubkey(tag[1])];
+            }
+            return tag;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.debug(`Failed to encode pubkey ${tag[1]}: ${errorMessage}`);
+            return tag;
+        }
+    });
+}
+//# sourceMappingURL=nip-19.js.map

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

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

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

@@ -0,0 +1,60 @@
+/**
+ * @file NIP-20 Command Results implementation
+ * @module nips/nip-20
+ */
+import { NostrWSMessage } from '../types';
+/**
+ * Command status types
+ */
+export declare enum CommandStatus {
+    SUCCESS = "success",
+    error = "error",
+    PENDING = "pending",
+    RATE_LIMITED = "rate_limited",
+    AUTH_REQUIRED = "auth_required",
+    RESTRICTED = "restricted"
+}
+export type CommandStatusType = CommandStatus;
+/**
+ * Command result interface
+ */
+export interface CommandResult {
+    status: boolean;
+    message?: string;
+    code?: CommandStatusType;
+    details?: Record<string, unknown>;
+}
+/**
+ * Represents the data structure for command messages
+ * @interface CommandMessageData
+ * @property {string} [event_id] - ID of the event this command relates to
+ * @property {boolean} [status] - Status of the command execution
+ * @property {string} [message] - Human-readable message about the command result
+ * @property {CommandStatusType} [code] - Status code of the command result
+ * @property {Record<string, unknown>} [details] - Additional details about the command result
+ */
+interface CommandMessageData {
+    event_id?: string;
+    status?: boolean;
+    message?: string;
+    code?: CommandStatusType;
+    details?: Record<string, unknown>;
+}
+/**
+ * Validates a command message according to NIP-20
+ */
+export declare function validateCommandMessage(message: NostrWSMessage): boolean;
+/**
+ * Creates a command result message
+ */
+export declare function createCommandResult(data: CommandMessageData): CommandResult;
+/**
+ * Creates an OK message
+ */
+export declare function createOkMessage(eventId: string, success?: boolean, details?: Record<string, unknown>): NostrWSMessage;
+/**
+ * Creates a NOTICE message
+ */
+export declare function createCommandNoticeMessage(code: CommandStatusType, message: string, details?: Record<string, unknown>): NostrWSMessage;
+export {};
+//# sourceMappingURL=nip-20.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-20.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-20.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK1C;;GAEG;AACH,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,UAAU,eAAe;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CA+CvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAU3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAMlH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAMtI"}

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

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * @file NIP-20 Command Results implementation
+ * @module nips/nip-20
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandStatus = void 0;
+exports.validateCommandMessage = validateCommandMessage;
+exports.createCommandResult = createCommandResult;
+exports.createOkMessage = createOkMessage;
+exports.createCommandNoticeMessage = createCommandNoticeMessage;
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.getLogger)('NIP-20');
+/**
+ * Command status types
+ */
+var CommandStatus;
+(function (CommandStatus) {
+    CommandStatus["SUCCESS"] = "success";
+    CommandStatus["error"] = "error";
+    CommandStatus["PENDING"] = "pending";
+    CommandStatus["RATE_LIMITED"] = "rate_limited";
+    CommandStatus["AUTH_REQUIRED"] = "auth_required";
+    CommandStatus["RESTRICTED"] = "restricted";
+})(CommandStatus || (exports.CommandStatus = CommandStatus = {}));
+/**
+ * Validates a command message according to NIP-20
+ */
+function validateCommandMessage(message) {
+    if (!Array.isArray(message) || message.length < 2) {
+        logger.debug('Invalid command message format');
+        return false;
+    }
+    const [type, data] = message;
+    if (typeof data !== 'object' || !data) {
+        logger.debug('Invalid command message data');
+        return false;
+    }
+    const commandData = data;
+    // For OK/NOTICE messages
+    if (type === 'OK') {
+        if (!commandData.event_id || typeof commandData.event_id !== 'string') {
+            logger.debug('Invalid event_id in OK message');
+            return false;
+        }
+        if (typeof commandData.status !== 'boolean') {
+            logger.debug('Invalid status in OK message');
+            return false;
+        }
+    }
+    // For NOTICE messages
+    if (type === 'NOTICE' && commandData.code) {
+        if (!Object.values(CommandStatus).includes(commandData.code)) {
+            logger.debug('Invalid command status code');
+            return false;
+        }
+    }
+    // Optional fields validation
+    if (commandData.message && typeof commandData.message !== 'string') {
+        logger.debug('Invalid message field');
+        return false;
+    }
+    if (commandData.details && typeof commandData.details !== 'object') {
+        logger.debug('Invalid details field');
+        return false;
+    }
+    return true;
+}
+/**
+ * Creates a command result message
+ */
+function createCommandResult(data) {
+    const status = data.status ?? false;
+    const code = status ? CommandStatus.SUCCESS : data.code;
+    return {
+        status,
+        code,
+        message: data.message,
+        details: data.details
+    };
+}
+/**
+ * Creates an OK message
+ */
+function createOkMessage(eventId, success = true, details) {
+    return ['OK', {
+            event_id: eventId,
+            status: success,
+            ...details && { details }
+        }];
+}
+/**
+ * Creates a NOTICE message
+ */
+function createCommandNoticeMessage(code, message, details) {
+    return ['NOTICE', {
+            code,
+            message,
+            ...details && { details }
+        }];
+}
+//# sourceMappingURL=nip-20.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-20.js","sourceRoot":"","sources":["../../../src/nips/nip-20.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmDH,wDA+CC;AAKD,kDAUC;AAKD,0CAMC;AAKD,gEAMC;AApID,4CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,QAAQ,CAAC,CAAC;AAEnC;;GAEG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,8CAA6B,CAAA;IAC7B,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;AAC3B,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AA+BD;;GAEG;AACH,SAAgB,sBAAsB,CAAC,OAAuB;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC;IAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAA0B,CAAC;IAE/C,yBAAyB;IACzB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,OAAO,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAqB,CAAC,EAAE,CAAC;YAC9E,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,WAAW,CAAC,OAAO,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,WAAW,CAAC,OAAO,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,IAAwB;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAExD,OAAO;QACL,MAAM;QACN,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,OAAO,GAAG,IAAI,EAAE,OAAiC;IAChG,OAAO,CAAC,IAAI,EAAE;YACZ,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,OAAO;YACf,GAAG,OAAO,IAAI,EAAE,OAAO,EAAE;SAC1B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,0BAA0B,CAAC,IAAuB,EAAE,OAAe,EAAE,OAAiC;IACpH,OAAO,CAAC,QAAQ,EAAE;YAChB,IAAI;YACJ,OAAO;YACP,GAAG,OAAO,IAAI,EAAE,OAAO,EAAE;SAC1B,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * @file NIP-22: Event Created At Limits
+ * @module nips/nip-22
+ * @see https://github.com/nostr-protocol/nips/blob/master/22.md
+ */
+import type { NostrWSMessage } from '../types/messages';
+import type { Logger } from '../types/logger';
+/**
+ * Default time limits in seconds
+ */
+export declare const DEFAULT_TIME_LIMITS: {
+    FUTURE_LIMIT: number;
+    PAST_LIMIT: number;
+};
+/**
+ * Time validation result
+ */
+export interface TimeValidationResult {
+    valid: boolean;
+    reason?: string;
+}
+/**
+ * Time validator interface
+ */
+export interface TimeValidator {
+    /**
+     * Validates event timestamp
+     * @param timestamp - Event timestamp
+     * @returns {TimeValidationResult} Validation result
+     */
+    validateTime(timestamp: number): TimeValidationResult;
+    /**
+     * Updates server time offset
+     * @param serverTime - Server timestamp
+     */
+    updateTimeOffset(serverTime: number): void;
+    /**
+     * Gets current adjusted timestamp
+     * @returns {number} Adjusted timestamp
+     */
+    getCurrentTime(): number;
+}
+/**
+ * Creates a time validator
+ * @param logger - Logger instance
+ * @param futureLimitSeconds - Future time limit in seconds
+ * @param pastLimitSeconds - Past time limit in seconds
+ * @returns {TimeValidator} Time validator
+ */
+export declare function createTimeValidator(logger: Logger, futureLimitSeconds?: number, pastLimitSeconds?: number): TimeValidator;
+/**
+ * Validates event timestamp
+ * @param message - Message to validate
+ * @param validator - Time validator
+ * @param logger - Logger instance
+ * @returns {TimeValidationResult} Validation result
+ */
+export declare function validateEventTime(message: NostrWSMessage, validator: TimeValidator, logger: Logger): TimeValidationResult;
+/**
+ * Time synchronization manager interface
+ */
+export interface TimeSyncManager {
+    /**
+     * Starts time synchronization
+     * @param wsUrl - WebSocket URL for time sync
+     */
+    startSync(wsUrl: string): void;
+    /**
+     * Stops time synchronization
+     */
+    stopSync(): void;
+    /**
+     * Gets current synchronized time
+     * @returns {number} Current timestamp
+     */
+    getCurrentTime(): number;
+    /**
+     * Validates event timing
+     * @param event - Event to validate
+     * @returns {TimeValidationResult} Validation result
+     */
+    validateEvent(event: NostrWSMessage): TimeValidationResult;
+}
+/**
+ * Creates a time synchronization manager
+ * @param logger - Logger instance
+ * @returns {TimeSyncManager} Time sync manager
+ */
+export declare function createTimeSyncManager(logger: Logger): TimeSyncManager;
+//# sourceMappingURL=nip-22.d.ts.map