@unicitylabs/nostr-js-sdk 0.3.2 → 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

@@ -9783,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';
 /**
@@ -9922,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
 });
 
@@ -10708,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