nostr-websocket-utils 0.3.0 → 0.3.2

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-22.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-22.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAEtD;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,kBAAkB,GAAE,MAAyC,EAC7D,gBAAgB,GAAE,MAAuC,GACxD,aAAa,CAoCf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,GACb,oBAAoB,CAwBtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;OAGG;IACH,cAAc,IAAI,MAAM,CAAC;IAEzB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAgErE"}

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

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * @file NIP-22: Event Created At Limits
+ * @module nips/nip-22
+ * @see https://github.com/nostr-protocol/nips/blob/master/22.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TIME_LIMITS = void 0;
+exports.createTimeValidator = createTimeValidator;
+exports.validateEventTime = validateEventTime;
+exports.createTimeSyncManager = createTimeSyncManager;
+/**
+ * Default time limits in seconds
+ */
+exports.DEFAULT_TIME_LIMITS = {
+    FUTURE_LIMIT: 900, // 15 minutes
+    PAST_LIMIT: 31536000 // 1 year
+};
+/**
+ * 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
+ */
+function createTimeValidator(logger, futureLimitSeconds = exports.DEFAULT_TIME_LIMITS.FUTURE_LIMIT, pastLimitSeconds = exports.DEFAULT_TIME_LIMITS.PAST_LIMIT) {
+    let timeOffset = 0; // Offset between local and server time
+    return {
+        validateTime(timestamp) {
+            const now = Date.now() / 1000 + timeOffset;
+            // Check future limit
+            if (timestamp > now + futureLimitSeconds) {
+                return {
+                    valid: false,
+                    reason: 'Event timestamp too far in the future'
+                };
+            }
+            // Check past limit
+            if (timestamp < now - pastLimitSeconds) {
+                return {
+                    valid: false,
+                    reason: 'Event timestamp too far in the past'
+                };
+            }
+            return { valid: true };
+        },
+        updateTimeOffset(serverTime) {
+            const localTime = Date.now() / 1000;
+            timeOffset = serverTime - localTime;
+            logger.debug(`Updated time offset to ${timeOffset} seconds`);
+        },
+        getCurrentTime() {
+            return Math.floor(Date.now() / 1000 + timeOffset);
+        }
+    };
+}
+/**
+ * Validates event timestamp
+ * @param message - Message to validate
+ * @param validator - Time validator
+ * @param logger - Logger instance
+ * @returns {TimeValidationResult} Validation result
+ */
+function validateEventTime(message, validator, logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            return { valid: true }; // Not an event message
+        }
+        const event = message[1];
+        const { created_at: timestamp } = event;
+        if (typeof timestamp !== 'number') {
+            return {
+                valid: false,
+                reason: 'Missing or invalid timestamp'
+            };
+        }
+        return validator.validateTime(timestamp);
+    }
+    catch (error) {
+        logger.error('Error validating event time:', error);
+        return {
+            valid: false,
+            reason: 'Error validating timestamp'
+        };
+    }
+}
+/**
+ * Creates a time synchronization manager
+ * @param logger - Logger instance
+ * @returns {TimeSyncManager} Time sync manager
+ */
+function createTimeSyncManager(logger) {
+    const validator = createTimeValidator(logger);
+    let syncInterval = null;
+    async function syncTime(wsUrl) {
+        try {
+            const ws = new WebSocket(wsUrl);
+            await new Promise((resolve, reject) => {
+                ws.onopen = () => {
+                    // Send time request
+                    ws.send(JSON.stringify({
+                        type: 'TIME',
+                        data: { client_time: Math.floor(Date.now() / 1000) }
+                    }));
+                };
+                ws.onmessage = (event) => {
+                    try {
+                        const response = JSON.parse(event.data);
+                        if (response.type === 'TIME') {
+                            validator.updateTimeOffset(response.data.server_time);
+                            resolve();
+                        }
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                    ws.close();
+                };
+                ws.onerror = reject;
+                // Timeout after 5 seconds
+                setTimeout(() => reject(new Error('Time sync timeout')), 5000);
+            });
+        }
+        catch (error) {
+            logger.error('Time sync failed:', error);
+        }
+    }
+    return {
+        startSync(wsUrl) {
+            // Initial sync
+            syncTime(wsUrl);
+            // Periodic sync every 15 minutes
+            syncInterval = setInterval(() => syncTime(wsUrl), 900000);
+        },
+        stopSync() {
+            if (syncInterval) {
+                clearInterval(syncInterval);
+                syncInterval = null;
+            }
+        },
+        getCurrentTime() {
+            return validator.getCurrentTime();
+        },
+        validateEvent(event) {
+            return validateEventTime(event, validator, logger);
+        }
+    };
+}
+//# sourceMappingURL=nip-22.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * @file NIP-26: Delegated Event Signing
+ * @module nips/nip-26
+ */
+import type { NostrEvent } from '../types/events';
+/**
+ * Represents the conditions for a Nostr event delegation
+ * @interface DelegationConditions
+ * @property {number} [kind] - The kind of events this delegation is valid for
+ * @property {number} [since] - Unix timestamp from which this delegation is valid
+ * @property {number} [until] - Unix timestamp until which this delegation is valid
+ * @property {unknown} [key: string] - Any additional conditions
+ */
+interface DelegationConditions {
+    kind?: number;
+    since?: number;
+    until?: number;
+    [key: string]: unknown;
+}
+/**
+ * Represents a Nostr event delegation
+ * @interface Delegation
+ * @property {string} pubkey - The public key of the delegator
+ * @property {DelegationConditions} conditions - The conditions under which this delegation is valid
+ * @property {string} token - The delegation token signed by the delegator
+ */
+interface Delegation {
+    pubkey: string;
+    conditions: DelegationConditions;
+    token: string;
+}
+/**
+ * Create a delegation token
+ */
+export declare function createDelegation(delegatorPrivkey: string, delegateePubkey: string, conditions: DelegationConditions): Promise<string>;
+/**
+ * Verify a delegation token
+ */
+export declare function verifyDelegation(delegatorPubkey: string, delegateePubkey: string, token: string, conditions: DelegationConditions): Promise<boolean>;
+/**
+ * Add delegation tag to an event
+ */
+export declare function addDelegationTag(event: NostrEvent, delegation: Delegation): NostrEvent;
+/**
+ * Extract delegation from an event
+ */
+export declare function extractDelegation(event: NostrEvent): Delegation | null;
+/**
+ * Validate a delegated event
+ */
+export declare function validateDelegatedEvent(event: NostrEvent): Promise<boolean>;
+export {};
+//# sourceMappingURL=nip-26.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nip-26.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-26.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD;;;;;;;GAOG;AACH,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,CAYtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAyBtE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAuChF"}

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

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * @file NIP-26: Delegated Event Signing
+ * @module nips/nip-26
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDelegation = createDelegation;
+exports.verifyDelegation = verifyDelegation;
+exports.addDelegationTag = addDelegationTag;
+exports.extractDelegation = extractDelegation;
+exports.validateDelegatedEvent = validateDelegatedEvent;
+const logger_1 = require("../utils/logger");
+const nostr_crypto_utils_1 = require("nostr-crypto-utils");
+const logger = (0, logger_1.getLogger)('NIP-26');
+/**
+ * Create a delegation token
+ */
+async function createDelegation(delegatorPrivkey, delegateePubkey, conditions) {
+    try {
+        const conditionsString = Object.entries(conditions)
+            .map(([key, value]) => `${key}=${value}`)
+            .sort()
+            .join('&');
+        const message = `nostr:delegation:${delegateePubkey}:${conditionsString}`;
+        // Create a NostrEvent object for signing
+        const event = {
+            id: '', // This will be set by signEvent
+            pubkey: delegateePubkey,
+            created_at: Math.floor(Date.now() / 1000),
+            kind: 0, // Using kind 0 for delegation events
+            tags: [],
+            content: message,
+            sig: '' // This will be set by signEvent
+        };
+        const signedEvent = await (0, nostr_crypto_utils_1.signEvent)(event, delegatorPrivkey);
+        return signedEvent.sig;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to create delegation: ${errorMessage}`);
+        throw new Error(`Failed to create delegation: ${errorMessage}`);
+    }
+}
+/**
+ * Verify a delegation token
+ */
+async function verifyDelegation(delegatorPubkey, delegateePubkey, token, conditions) {
+    try {
+        const conditionsString = Object.entries(conditions)
+            .map(([key, value]) => `${key}=${value}`)
+            .sort()
+            .join('&');
+        const message = `nostr:delegation:${delegateePubkey}:${conditionsString}`;
+        const verificationEvent = {
+            id: '',
+            pubkey: delegatorPubkey,
+            created_at: Math.floor(Date.now() / 1000),
+            kind: 0,
+            tags: [],
+            content: message,
+            sig: token
+        };
+        return await (0, nostr_crypto_utils_1.verifySignature)(verificationEvent);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to verify delegation: ${errorMessage}`);
+        return false;
+    }
+}
+/**
+ * Add delegation tag to an event
+ */
+function addDelegationTag(event, delegation) {
+    const conditionsString = Object.entries(delegation.conditions)
+        .map(([key, value]) => `${key}=${value}`)
+        .sort()
+        .join('&');
+    const delegationTag = ['delegation', delegation.pubkey, conditionsString, delegation.token];
+    return {
+        ...event,
+        tags: [...event.tags, delegationTag]
+    };
+}
+/**
+ * Extract delegation from an event
+ */
+function extractDelegation(event) {
+    try {
+        const delegationTag = event.tags.find(tag => tag[0] === 'delegation');
+        if (!delegationTag || delegationTag.length !== 4) {
+            return null;
+        }
+        const [, pubkey, conditionsString, token] = delegationTag;
+        const conditions = {};
+        conditionsString.split('&').forEach(pair => {
+            const [key, value] = pair.split('=');
+            if (key === 'kind' || key === 'since' || key === 'until') {
+                conditions[key] = parseInt(value, 10);
+            }
+            else {
+                conditions[key] = value;
+            }
+        });
+        return { pubkey, conditions, token };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to extract delegation: ${errorMessage}`);
+        return null;
+    }
+}
+/**
+ * Validate a delegated event
+ */
+async function validateDelegatedEvent(event) {
+    try {
+        const delegation = extractDelegation(event);
+        if (!delegation) {
+            return false;
+        }
+        const { kind, created_at } = event;
+        const { kind: allowedKind, since, until } = delegation.conditions;
+        // Check kind constraint
+        if (allowedKind !== undefined && kind !== allowedKind) {
+            logger.debug('Event kind does not match delegation conditions');
+            return false;
+        }
+        // Check time constraints
+        if (since !== undefined && created_at < since) {
+            logger.debug('Event is before delegation start time');
+            return false;
+        }
+        if (until !== undefined && created_at > until) {
+            logger.debug('Event is after delegation end time');
+            return false;
+        }
+        // Verify delegation token
+        return await verifyDelegation(delegation.pubkey, event.pubkey, delegation.token, delegation.conditions);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Failed to validate delegated event: ${errorMessage}`);
+        return false;
+    }
+}
+//# sourceMappingURL=nip-26.js.map

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

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

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

@@ -0,0 +1,104 @@
+/**
+ * @file NIP-28: Public Chat
+ * @module nips/nip-28
+ * @see https://github.com/nostr-protocol/nips/blob/master/28.md
+ */
+import type { NostrWSMessage } from '../types/messages';
+import type { Logger } from '../types/logger';
+/**
+ * Chat event kinds
+ */
+export declare const ChatEventKinds: {
+    readonly CHANNEL_CREATION: 40;
+    readonly CHANNEL_METADATA: 41;
+    readonly CHANNEL_MESSAGE: 42;
+    readonly CHANNEL_HIDE_MESSAGE: 43;
+    readonly CHANNEL_MUTE_USER: 44;
+    readonly USER_MUTE: 45;
+};
+/**
+ * Channel metadata structure
+ */
+export interface ChannelMetadata {
+    name: string;
+    about?: string;
+    picture?: string;
+    rules?: string[];
+    moderators?: string[];
+    pinned?: string[];
+}
+/**
+ * Creates a channel creation message
+ * @param metadata - Channel metadata
+ * @returns {NostrWSMessage} Channel creation event
+ */
+export declare function createChannelCreationEvent(metadata: ChannelMetadata): NostrWSMessage;
+/**
+ * Creates a channel message
+ * @param channelId - Channel ID
+ * @param content - Message content
+ * @param replyTo - Optional ID of message being replied to
+ * @returns {NostrWSMessage} Channel message event
+ */
+export declare function createChannelMessage(channelId: string, content: string, replyTo?: string): NostrWSMessage;
+/**
+ * Creates a message moderation event
+ * @param channelId - Channel ID
+ * @param messageId - Message ID to moderate
+ * @param reason - Moderation reason
+ * @returns {NostrWSMessage} Hide message event
+ */
+export declare function createHideMessageEvent(channelId: string, messageId: string, reason: string): NostrWSMessage;
+/**
+ * Chat message handler interface
+ */
+export interface ChatMessageHandler {
+    /**
+     * Handles incoming chat message
+     * @param message - Chat message
+     * @returns {Promise<void>}
+     */
+    handleMessage(message: NostrWSMessage): Promise<void>;
+    /**
+     * Handles message moderation
+     * @param message - Moderation message
+     * @returns {Promise<void>}
+     */
+    handleModeration(message: NostrWSMessage): Promise<void>;
+}
+/**
+ * Creates a chat message handler
+ * @param logger - Logger instance
+ * @returns {ChatMessageHandler} Message handler
+ */
+export declare function createChatMessageHandler(logger: Logger): ChatMessageHandler;
+/**
+ * Channel subscription manager interface
+ */
+export interface ChannelSubscriptionManager {
+    /**
+     * Subscribes to a channel
+     * @param channelId - Channel ID
+     * @returns {NostrWSMessage} Subscription message
+     */
+    subscribe(channelId: string): NostrWSMessage;
+    /**
+     * Unsubscribes from a channel
+     * @param channelId - Channel ID
+     * @returns {NostrWSMessage} Unsubscribe message
+     */
+    unsubscribe(channelId: string): NostrWSMessage;
+    /**
+     * Gets channel metadata
+     * @param channelId - Channel ID
+     * @returns {Promise<ChannelMetadata | undefined>} Channel metadata
+     */
+    getMetadata(channelId: string): Promise<ChannelMetadata | undefined>;
+}
+/**
+ * Creates a channel subscription manager
+ * @param logger - Logger instance
+ * @returns {ChannelSubscriptionManager} Subscription manager
+ */
+export declare function createChannelSubscriptionManager(logger: Logger): ChannelSubscriptionManager;
+//# sourceMappingURL=nip-28.d.ts.map