@unicitylabs/nostr-js-sdk 0.0.1

package/dist/cjs/protocol/Event.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Event - Represents a Nostr event (NIP-01).
+ * Provides serialization, signing, and verification functionality.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Event = void 0;
+const sha256_1 = require("@noble/hashes/sha256");
+const utils_1 = require("@noble/hashes/utils");
+const Schnorr = __importStar(require("../crypto/schnorr.js"));
+/**
+ * Event class representing a Nostr event (NIP-01).
+ */
+class Event {
+    /** Event ID - SHA-256 hash of the serialized event data (hex) */
+    id;
+    /** Creator's x-only public key (hex) */
+    pubkey;
+    /** Unix timestamp in seconds */
+    created_at;
+    /** Event kind (type) */
+    kind;
+    /** Event tags */
+    tags;
+    /** Event content */
+    content;
+    /** Schnorr signature (hex) */
+    sig;
+    /**
+     * Create an Event instance.
+     * @param data Signed event data
+     */
+    constructor(data) {
+        this.id = data.id;
+        this.pubkey = data.pubkey;
+        this.created_at = data.created_at;
+        this.kind = data.kind;
+        this.tags = data.tags;
+        this.content = data.content;
+        this.sig = data.sig;
+    }
+    /**
+     * Create and sign a new event.
+     * @param keyManager Key manager with signing key
+     * @param data Unsigned event data
+     * @returns Signed Event instance
+     */
+    static create(keyManager, data) {
+        const pubkey = keyManager.getPublicKeyHex();
+        const created_at = data.created_at ?? Math.floor(Date.now() / 1000);
+        // Calculate event ID
+        const id = Event.calculateId(pubkey, created_at, data.kind, data.tags, data.content);
+        // Sign the event ID
+        const idBytes = (0, utils_1.hexToBytes)(id);
+        const sig = keyManager.signHex(idBytes);
+        return new Event({
+            id,
+            pubkey,
+            created_at,
+            kind: data.kind,
+            tags: data.tags,
+            content: data.content,
+            sig,
+        });
+    }
+    /**
+     * Calculate the event ID from event data.
+     * ID = SHA-256(serialized event data)
+     * Serialized format: [0, pubkey, created_at, kind, tags, content]
+     */
+    static calculateId(pubkey, created_at, kind, tags, content) {
+        const serialized = JSON.stringify([0, pubkey, created_at, kind, tags, content]);
+        const hash = (0, sha256_1.sha256)(new TextEncoder().encode(serialized));
+        return (0, utils_1.bytesToHex)(hash);
+    }
+    /**
+     * Verify the event signature.
+     * @returns true if the signature is valid
+     */
+    verify() {
+        try {
+            // Verify the ID
+            const calculatedId = Event.calculateId(this.pubkey, this.created_at, this.kind, this.tags, this.content);
+            if (calculatedId !== this.id) {
+                return false;
+            }
+            // Verify the signature
+            const idBytes = (0, utils_1.hexToBytes)(this.id);
+            const sigBytes = (0, utils_1.hexToBytes)(this.sig);
+            const pubkeyBytes = (0, utils_1.hexToBytes)(this.pubkey);
+            return Schnorr.verify(sigBytes, idBytes, pubkeyBytes);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Parse an event from JSON data.
+     * @param json JSON object or string
+     * @returns Event instance
+     */
+    static fromJSON(json) {
+        const data = typeof json === 'string' ? JSON.parse(json) : json;
+        if (!Event.isValidEventData(data)) {
+            throw new Error('Invalid event data');
+        }
+        return new Event(data);
+    }
+    /**
+     * Check if data has valid event structure.
+     */
+    static isValidEventData(data) {
+        if (typeof data !== 'object' || data === null) {
+            return false;
+        }
+        const obj = data;
+        return (typeof obj.id === 'string' &&
+            typeof obj.pubkey === 'string' &&
+            typeof obj.created_at === 'number' &&
+            typeof obj.kind === 'number' &&
+            Array.isArray(obj.tags) &&
+            typeof obj.content === 'string' &&
+            typeof obj.sig === 'string');
+    }
+    /**
+     * Convert the event to a plain object.
+     * @returns Plain object representation
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            pubkey: this.pubkey,
+            created_at: this.created_at,
+            kind: this.kind,
+            tags: this.tags,
+            content: this.content,
+            sig: this.sig,
+        };
+    }
+    /**
+     * Get the first value of a tag by name.
+     * @param tagName Tag name to find
+     * @returns First value of the tag, or undefined if not found
+     */
+    getTagValue(tagName) {
+        const tag = this.tags.find((t) => t[0] === tagName);
+        return tag?.[1];
+    }
+    /**
+     * Get all values of a tag by name.
+     * @param tagName Tag name to find
+     * @returns Array of tag values
+     */
+    getTagValues(tagName) {
+        return this.tags.filter((t) => t[0] === tagName).map((t) => t[1] ?? '');
+    }
+    /**
+     * Check if a tag exists.
+     * @param tagName Tag name to check
+     * @returns true if the tag exists
+     */
+    hasTag(tagName) {
+        return this.tags.some((t) => t[0] === tagName);
+    }
+    /**
+     * Get all values from a single tag entry (excluding the tag name).
+     * @param tagName Tag name to find
+     * @returns Array of values from the first matching tag, or empty array
+     */
+    getTagEntryValues(tagName) {
+        const tag = this.tags.find((t) => t[0] === tagName);
+        return tag ? tag.slice(1) : [];
+    }
+}
+exports.Event = Event;
+//# sourceMappingURL=Event.js.map

package/dist/cjs/protocol/Event.js.map

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

package/dist/cjs/protocol/EventKinds.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * EventKinds - Standardized Nostr event kind definitions.
+ * Includes both standard NIP kinds and Unicity custom kinds.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_METADATA = exports.TOKEN_TRANSFER = exports.AGENT_LOCATION = exports.AGENT_PROFILE = exports.APP_DATA = exports.RELAY_LIST = exports.GIFT_WRAP = exports.REACTION = exports.DELETION = exports.ENCRYPTED_DM = exports.CONTACTS = exports.RECOMMEND_RELAY = exports.TEXT_NOTE = exports.PROFILE = void 0;
+exports.isReplaceable = isReplaceable;
+exports.isEphemeral = isEphemeral;
+exports.isParameterizedReplaceable = isParameterizedReplaceable;
+exports.getName = getName;
+// ============================================================================
+// Standard NIP Event Kinds
+// ============================================================================
+/** NIP-01: User profile metadata */
+exports.PROFILE = 0;
+/** NIP-01: Short text note */
+exports.TEXT_NOTE = 1;
+/** NIP-01: Recommend relay to followers */
+exports.RECOMMEND_RELAY = 2;
+/** NIP-02: Contact list (follows) */
+exports.CONTACTS = 3;
+/** NIP-04: Encrypted direct messages */
+exports.ENCRYPTED_DM = 4;
+/** NIP-09: Event deletion */
+exports.DELETION = 5;
+/** NIP-25: Reactions (likes, etc.) */
+exports.REACTION = 7;
+/** NIP-59: Gift wrap for private events */
+exports.GIFT_WRAP = 1059;
+/** NIP-65: Relay list metadata */
+exports.RELAY_LIST = 10002;
+/** NIP-78: Application-specific data (parameterized replaceable) */
+exports.APP_DATA = 30078;
+// ============================================================================
+// Unicity Custom Event Kinds
+// ============================================================================
+/** Unicity: Agent profile information */
+exports.AGENT_PROFILE = 31111;
+/** Unicity: Agent GPS location */
+exports.AGENT_LOCATION = 31112;
+/** Unicity: Token transfer event */
+exports.TOKEN_TRANSFER = 31113;
+/** Unicity: File metadata */
+exports.FILE_METADATA = 31114;
+// ============================================================================
+// Event Kind Classification Functions
+// ============================================================================
+/**
+ * Check if an event kind is replaceable.
+ * Replaceable events (kinds 0, 3, or 10000-19999) are replaced when a new
+ * event with the same kind and pubkey is published.
+ * @param kind Event kind number
+ * @returns true if the event kind is replaceable
+ */
+function isReplaceable(kind) {
+    return kind === 0 || kind === 3 || (kind >= 10000 && kind < 20000);
+}
+/**
+ * Check if an event kind is ephemeral.
+ * Ephemeral events (kinds 20000-29999) are not stored by relays.
+ * @param kind Event kind number
+ * @returns true if the event kind is ephemeral
+ */
+function isEphemeral(kind) {
+    return kind >= 20000 && kind < 30000;
+}
+/**
+ * Check if an event kind is parameterized replaceable.
+ * Parameterized replaceable events (kinds 30000-39999) are replaced when a
+ * new event with the same kind, pubkey, and "d" tag value is published.
+ * @param kind Event kind number
+ * @returns true if the event kind is parameterized replaceable
+ */
+function isParameterizedReplaceable(kind) {
+    return kind >= 30000 && kind < 40000;
+}
+/**
+ * Get a human-readable name for an event kind.
+ * @param kind Event kind number
+ * @returns Human-readable name for the event kind
+ */
+function getName(kind) {
+    switch (kind) {
+        case exports.PROFILE:
+            return 'Profile';
+        case exports.TEXT_NOTE:
+            return 'Text Note';
+        case exports.RECOMMEND_RELAY:
+            return 'Recommend Relay';
+        case exports.CONTACTS:
+            return 'Contacts';
+        case exports.ENCRYPTED_DM:
+            return 'Encrypted DM';
+        case exports.DELETION:
+            return 'Deletion';
+        case exports.REACTION:
+            return 'Reaction';
+        case exports.GIFT_WRAP:
+            return 'Gift Wrap';
+        case exports.RELAY_LIST:
+            return 'Relay List';
+        case exports.APP_DATA:
+            return 'App Data';
+        case exports.AGENT_PROFILE:
+            return 'Agent Profile';
+        case exports.AGENT_LOCATION:
+            return 'Agent Location';
+        case exports.TOKEN_TRANSFER:
+            return 'Token Transfer';
+        case exports.FILE_METADATA:
+            return 'File Metadata';
+        default:
+            if (isReplaceable(kind)) {
+                return `Replaceable (${kind})`;
+            }
+            if (isEphemeral(kind)) {
+                return `Ephemeral (${kind})`;
+            }
+            if (isParameterizedReplaceable(kind)) {
+                return `Parameterized Replaceable (${kind})`;
+            }
+            return `Unknown (${kind})`;
+    }
+}
+//# sourceMappingURL=EventKinds.js.map

package/dist/cjs/protocol/EventKinds.js.map

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

package/dist/cjs/protocol/Filter.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Filter - Nostr subscription filter (NIP-01).
+ * Provides a builder pattern for constructing filters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterBuilder = exports.Filter = void 0;
+/**
+ * Filter class for Nostr subscription queries.
+ * Use the builder pattern to construct filters.
+ */
+class Filter {
+    ids;
+    authors;
+    kinds;
+    '#e';
+    '#p';
+    '#t';
+    '#d';
+    since;
+    until;
+    limit;
+    /**
+     * Create a Filter instance.
+     * @param data Optional filter data
+     */
+    constructor(data) {
+        if (data) {
+            if (data.ids)
+                this.ids = [...data.ids];
+            if (data.authors)
+                this.authors = [...data.authors];
+            if (data.kinds)
+                this.kinds = [...data.kinds];
+            if (data['#e'])
+                this['#e'] = [...data['#e']];
+            if (data['#p'])
+                this['#p'] = [...data['#p']];
+            if (data['#t'])
+                this['#t'] = [...data['#t']];
+            if (data['#d'])
+                this['#d'] = [...data['#d']];
+            if (data.since !== undefined)
+                this.since = data.since;
+            if (data.until !== undefined)
+                this.until = data.until;
+            if (data.limit !== undefined)
+                this.limit = data.limit;
+        }
+    }
+    /**
+     * Create a new Filter builder.
+     * @returns Filter builder instance
+     */
+    static builder() {
+        return new FilterBuilder();
+    }
+    /**
+     * Convert the filter to a plain object for JSON serialization.
+     * Only includes defined properties.
+     * @returns Plain object representation
+     */
+    toJSON() {
+        const result = {};
+        if (this.ids && this.ids.length > 0)
+            result.ids = this.ids;
+        if (this.authors && this.authors.length > 0)
+            result.authors = this.authors;
+        if (this.kinds && this.kinds.length > 0)
+            result.kinds = this.kinds;
+        if (this['#e'] && this['#e'].length > 0)
+            result['#e'] = this['#e'];
+        if (this['#p'] && this['#p'].length > 0)
+            result['#p'] = this['#p'];
+        if (this['#t'] && this['#t'].length > 0)
+            result['#t'] = this['#t'];
+        if (this['#d'] && this['#d'].length > 0)
+            result['#d'] = this['#d'];
+        if (this.since !== undefined)
+            result.since = this.since;
+        if (this.until !== undefined)
+            result.until = this.until;
+        if (this.limit !== undefined)
+            result.limit = this.limit;
+        return result;
+    }
+    /**
+     * Parse a filter from JSON data.
+     * @param json JSON object or string
+     * @returns Filter instance
+     */
+    static fromJSON(json) {
+        const data = typeof json === 'string' ? JSON.parse(json) : json;
+        return new Filter(data);
+    }
+}
+exports.Filter = Filter;
+/**
+ * Builder class for constructing Filter instances.
+ */
+class FilterBuilder {
+    data = {};
+    ids(idsOrFirst, ...rest) {
+        if (Array.isArray(idsOrFirst)) {
+            this.data.ids = [...idsOrFirst];
+        }
+        else {
+            this.data.ids = [idsOrFirst, ...rest];
+        }
+        return this;
+    }
+    authors(authorsOrFirst, ...rest) {
+        if (Array.isArray(authorsOrFirst)) {
+            this.data.authors = [...authorsOrFirst];
+        }
+        else {
+            this.data.authors = [authorsOrFirst, ...rest];
+        }
+        return this;
+    }
+    kinds(kindsOrFirst, ...rest) {
+        if (Array.isArray(kindsOrFirst)) {
+            this.data.kinds = [...kindsOrFirst];
+        }
+        else {
+            this.data.kinds = [kindsOrFirst, ...rest];
+        }
+        return this;
+    }
+    eTags(eTagsOrFirst, ...rest) {
+        if (Array.isArray(eTagsOrFirst)) {
+            this.data['#e'] = [...eTagsOrFirst];
+        }
+        else {
+            this.data['#e'] = [eTagsOrFirst, ...rest];
+        }
+        return this;
+    }
+    pTags(pTagsOrFirst, ...rest) {
+        if (Array.isArray(pTagsOrFirst)) {
+            this.data['#p'] = [...pTagsOrFirst];
+        }
+        else {
+            this.data['#p'] = [pTagsOrFirst, ...rest];
+        }
+        return this;
+    }
+    tTags(tTagsOrFirst, ...rest) {
+        if (Array.isArray(tTagsOrFirst)) {
+            this.data['#t'] = [...tTagsOrFirst];
+        }
+        else {
+            this.data['#t'] = [tTagsOrFirst, ...rest];
+        }
+        return this;
+    }
+    dTags(dTagsOrFirst, ...rest) {
+        if (Array.isArray(dTagsOrFirst)) {
+            this.data['#d'] = [...dTagsOrFirst];
+        }
+        else {
+            this.data['#d'] = [dTagsOrFirst, ...rest];
+        }
+        return this;
+    }
+    /**
+     * Set minimum timestamp (inclusive).
+     * @param since Unix timestamp in seconds
+     * @returns This builder for chaining
+     */
+    since(since) {
+        this.data.since = since;
+        return this;
+    }
+    /**
+     * Set maximum timestamp (inclusive).
+     * @param until Unix timestamp in seconds
+     * @returns This builder for chaining
+     */
+    until(until) {
+        this.data.until = until;
+        return this;
+    }
+    /**
+     * Set maximum number of events to return.
+     * @param limit Maximum number of events
+     * @returns This builder for chaining
+     */
+    limit(limit) {
+        this.data.limit = limit;
+        return this;
+    }
+    /**
+     * Build the Filter instance.
+     * @returns Filter instance
+     */
+    build() {
+        return new Filter(this.data);
+    }
+}
+exports.FilterBuilder = FilterBuilder;
+//# sourceMappingURL=Filter.js.map

package/dist/cjs/protocol/Filter.js.map

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

package/dist/cjs/protocol/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Protocol module - Nostr protocol types and classes
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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.EventKinds = exports.FilterBuilder = exports.Filter = exports.Event = void 0;
+var Event_js_1 = require("./Event.js");
+Object.defineProperty(exports, "Event", { enumerable: true, get: function () { return Event_js_1.Event; } });
+var Filter_js_1 = require("./Filter.js");
+Object.defineProperty(exports, "Filter", { enumerable: true, get: function () { return Filter_js_1.Filter; } });
+Object.defineProperty(exports, "FilterBuilder", { enumerable: true, get: function () { return Filter_js_1.FilterBuilder; } });
+exports.EventKinds = __importStar(require("./EventKinds.js"));
+__exportStar(require("./EventKinds.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AAEd,yCAAoD;AAA3C,mGAAA,MAAM,OAAA;AAAE,0GAAA,aAAa,OAAA;AAE9B,8DAA8C;AAC9C,kDAAgC"}