@unicitylabs/nostr-js-sdk 0.3.1 → 0.3.3

package/README.md

@@ -272,6 +272,8 @@ PaymentRequestProtocol.parseAmount('1.5', 8); // BigInt(150_000_000) (8 decimals
 
 ### Nametag Bindings
 
+Nametags are lowercase alphanumeric strings (`[a-z0-9_-]`, 3–20 chars) or phone numbers (E.164 format). All input is normalized to lowercase before hashing. Use `isValidNametag(input)` to validate.
+
 ```typescript
 import { NametagBinding, NametagUtils } from '@unicitylabs/nostr-sdk';
 

package/dist/browser/index.js

@@ -5373,6 +5373,7 @@ class Filter {
     '#p';
     '#t';
     '#d';
+    '#h';
     since;
     until;
     limit;
@@ -5396,6 +5397,8 @@ class Filter {
                 this['#t'] = [...data['#t']];
             if (data['#d'])
                 this['#d'] = [...data['#d']];
+            if (data['#h'])
+                this['#h'] = [...data['#h']];
             if (data.since !== undefined)
                 this.since = data.since;
             if (data.until !== undefined)
@@ -5432,6 +5435,8 @@ class Filter {
             result['#t'] = this['#t'];
         if (this['#d'] && this['#d'].length > 0)
             result['#d'] = this['#d'];
+        if (this['#h'] && this['#h'].length > 0)
+            result['#h'] = this['#h'];
         if (this.since !== undefined)
             result.since = this.since;
         if (this.until !== undefined)
@@ -5518,6 +5523,15 @@ class FilterBuilder {
         }
         return this;
     }
+    hTags(hTagsOrFirst, ...rest) {
+        if (Array.isArray(hTagsOrFirst)) {
+            this.data['#h'] = [...hTagsOrFirst];
+        }
+        else {
+            this.data['#h'] = [hTagsOrFirst, ...rest];
+        }
+        return this;
+    }
     /**
      * Set minimum timestamp (inclusive).
      * @param since Unix timestamp in seconds
@@ -9769,6 +9783,10 @@ function isValidPhoneNumber() {
  */
 /** Salt prefix for nametag hashing */
 const NAMETAG_SALT = 'unicity:nametag:';
+/** Minimum nametag length (after normalization) */
+const NAMETAG_MIN_LENGTH = 3;
+/** Maximum nametag length (after normalization) */
+const NAMETAG_MAX_LENGTH = 20;
 /** Default country code for phone number normalization */
 const DEFAULT_COUNTRY$1 = 'US';
 /**
@@ -9908,13 +9926,33 @@ function isPhoneNumber(str, defaultCountry = DEFAULT_COUNTRY$1) {
         return false;
     }
 }
+/**
+ * Validate a nametag string. Strips leading @, normalizes, then checks format.
+ * Regular nametags: lowercase alphanumeric, underscore, hyphen, 3-20 chars.
+ * Phone numbers: validated via libphonenumber-js.
+ * @param nametag Nametag to validate
+ * @param defaultCountry Default country code for phone normalization
+ * @returns true if the nametag is valid
+ */
+function isValidNametag(nametag, defaultCountry = DEFAULT_COUNTRY$1) {
+    const stripped = nametag.startsWith('@') ? nametag.slice(1) : nametag;
+    const normalized = normalizeNametag(stripped, defaultCountry);
+    if (isPhoneNumber(normalized)) {
+        return true;
+    }
+    const pattern = new RegExp(`^[a-z0-9_-]{${NAMETAG_MIN_LENGTH},${NAMETAG_MAX_LENGTH}}$`);
+    return pattern.test(normalized);
+}
 
 var NametagUtils = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    NAMETAG_MAX_LENGTH: NAMETAG_MAX_LENGTH,
+    NAMETAG_MIN_LENGTH: NAMETAG_MIN_LENGTH,
     areSameNametag: areSameNametag,
     formatForDisplay: formatForDisplay,
     hashNametag: hashNametag,
     isPhoneNumber: isPhoneNumber,
+    isValidNametag: isValidNametag,
     normalizeNametag: normalizeNametag
 });
 
@@ -10694,5 +10732,5 @@ function isReadReceipt(message) {
     return message.kind === 15;
 }
 
-export { AGENT_LOCATION, AGENT_PROFILE, APP_DATA, AUTH, bech32 as Bech32, CHAT_MESSAGE, CLOSED, CLOSING, CONNECTING, CONTACTS, CallbackEventListener, DELETION, ENCRYPTED_DM, Event, EventKinds, FILE_METADATA, Filter, FilterBuilder, GIFT_WRAP, nip04 as NIP04, nip17 as NIP17, nip44 as NIP44, NametagBinding, NametagUtils, NostrClient, NostrKeyManager, OPEN, PAYMENT_REQUEST, PAYMENT_REQUEST_RESPONSE, PROFILE, PaymentRequestProtocol, REACTION, READ_RECEIPT, RECOMMEND_RELAY, RELAY_LIST, SEAL, schnorr as SchnorrSigner, TEXT_NOTE, TOKEN_TRANSFER, TokenTransferProtocol, areSameNametag, createBindingEvent, createGiftWrap, createNametagToPubkeyFilter, createPubkeyToNametagFilter, createReadReceipt, createWebSocket, decode, decodeNpub, decodeNsec, encode, encodeNpub, encodeNsec, extractMessageData, formatForDisplay, getName, getPublicKey, getPublicKeyHex, hashNametag, isChatMessage, isEphemeral, isParameterizedReplaceable, isPhoneNumber, isReadReceipt, isReplaceable, isValidBindingEvent, normalizeNametag, parseAddressFromEvent, parseNametagHashFromEvent, sign, signHex, unwrap, verify, verifyHex };
+export { AGENT_LOCATION, AGENT_PROFILE, APP_DATA, AUTH, bech32 as Bech32, CHAT_MESSAGE, CLOSED, CLOSING, CONNECTING, CONTACTS, CallbackEventListener, DELETION, ENCRYPTED_DM, Event, EventKinds, FILE_METADATA, Filter, FilterBuilder, GIFT_WRAP, NAMETAG_MAX_LENGTH, NAMETAG_MIN_LENGTH, nip04 as NIP04, nip17 as NIP17, nip44 as NIP44, NametagBinding, NametagUtils, NostrClient, NostrKeyManager, OPEN, PAYMENT_REQUEST, PAYMENT_REQUEST_RESPONSE, PROFILE, PaymentRequestProtocol, REACTION, READ_RECEIPT, RECOMMEND_RELAY, RELAY_LIST, SEAL, schnorr as SchnorrSigner, TEXT_NOTE, TOKEN_TRANSFER, TokenTransferProtocol, areSameNametag, createBindingEvent, createGiftWrap, createNametagToPubkeyFilter, createPubkeyToNametagFilter, createReadReceipt, createWebSocket, decode, decodeNpub, decodeNsec, encode, encodeNpub, encodeNsec, extractMessageData, formatForDisplay, getName, getPublicKey, getPublicKeyHex, hashNametag, isChatMessage, isEphemeral, isParameterizedReplaceable, isPhoneNumber, isReadReceipt, isReplaceable, isValidBindingEvent, isValidNametag, normalizeNametag, parseAddressFromEvent, parseNametagHashFromEvent, sign, signHex, unwrap, verify, verifyHex };
 //# sourceMappingURL=index.js.map