@unicitylabs/nostr-js-sdk 0.0.1

package/dist/cjs/crypto/schnorr.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * BIP-340 Schnorr signature implementation using secp256k1.
+ * Uses @noble/curves for cryptographic operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPublicKey = getPublicKey;
+exports.getPublicKeyHex = getPublicKeyHex;
+exports.sign = sign;
+exports.signHex = signHex;
+exports.verify = verify;
+exports.verifyHex = verifyHex;
+const secp256k1_1 = require("@noble/curves/secp256k1");
+const utils_1 = require("@noble/hashes/utils");
+/**
+ * Get the x-only public key from a private key (BIP-340)
+ * @param privateKey 32-byte private key
+ * @returns 32-byte x-only public key
+ */
+function getPublicKey(privateKey) {
+    if (privateKey.length !== 32) {
+        throw new Error('Private key must be 32 bytes');
+    }
+    return secp256k1_1.schnorr.getPublicKey(privateKey);
+}
+/**
+ * Get the x-only public key from a hex-encoded private key
+ * @param privateKeyHex Hex-encoded private key
+ * @returns Hex-encoded x-only public key
+ */
+function getPublicKeyHex(privateKeyHex) {
+    const privateKey = (0, utils_1.hexToBytes)(privateKeyHex);
+    const publicKey = getPublicKey(privateKey);
+    return (0, utils_1.bytesToHex)(publicKey);
+}
+/**
+ * Sign a message using BIP-340 Schnorr signature
+ * @param message 32-byte message hash to sign
+ * @param privateKey 32-byte private key
+ * @returns 64-byte Schnorr signature (R.x || s)
+ */
+function sign(message, privateKey) {
+    if (message.length !== 32) {
+        throw new Error('Message must be 32 bytes');
+    }
+    if (privateKey.length !== 32) {
+        throw new Error('Private key must be 32 bytes');
+    }
+    return secp256k1_1.schnorr.sign(message, privateKey);
+}
+/**
+ * Sign a message and return hex-encoded signature
+ * @param message 32-byte message hash to sign
+ * @param privateKey 32-byte private key
+ * @returns Hex-encoded 64-byte Schnorr signature
+ */
+function signHex(message, privateKey) {
+    return (0, utils_1.bytesToHex)(sign(message, privateKey));
+}
+/**
+ * Verify a BIP-340 Schnorr signature
+ * @param signature 64-byte Schnorr signature
+ * @param message 32-byte message hash
+ * @param publicKey 32-byte x-only public key
+ * @returns true if the signature is valid
+ */
+function verify(signature, message, publicKey) {
+    if (signature.length !== 64) {
+        return false;
+    }
+    if (message.length !== 32) {
+        return false;
+    }
+    if (publicKey.length !== 32) {
+        return false;
+    }
+    try {
+        return secp256k1_1.schnorr.verify(signature, message, publicKey);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Verify a hex-encoded Schnorr signature
+ * @param signatureHex Hex-encoded 64-byte signature
+ * @param message 32-byte message hash
+ * @param publicKeyHex Hex-encoded 32-byte public key
+ * @returns true if the signature is valid
+ */
+function verifyHex(signatureHex, message, publicKeyHex) {
+    try {
+        const signature = (0, utils_1.hexToBytes)(signatureHex);
+        const publicKey = (0, utils_1.hexToBytes)(publicKeyHex);
+        return verify(signature, message, publicKey);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=schnorr.js.map

package/dist/cjs/crypto/schnorr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schnorr.js","sourceRoot":"","sources":["../../../src/crypto/schnorr.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAUH,oCAKC;AAOD,0CAIC;AAQD,oBAQC;AAQD,0BAEC;AASD,wBAoBC;AASD,8BAYC;AApGD,uDAAkD;AAClD,+CAA6D;AAE7D;;;;GAIG;AACH,SAAgB,YAAY,CAAC,UAAsB;IACjD,IAAI,UAAU,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,mBAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,aAAqB;IACnD,MAAM,UAAU,GAAG,IAAA,kBAAU,EAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,IAAA,kBAAU,EAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,IAAI,CAAC,OAAmB,EAAE,UAAsB;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,mBAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,OAAmB,EAAE,UAAsB;IACjE,OAAO,IAAA,kBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,MAAM,CACpB,SAAqB,EACrB,OAAmB,EACnB,SAAqB;IAErB,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,mBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CACvB,YAAoB,EACpB,OAAmB,EACnB,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAA,kBAAU,EAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAA,kBAAU,EAAC,YAAY,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Unicity Nostr SDK
+ *
+ * A TypeScript SDK for Nostr protocol with Unicity extensions.
+ * Works in both Node.js and browser environments.
+ *
+ * Features:
+ * - BIP-340 Schnorr signatures
+ * - NIP-04 encrypted direct messages with GZIP compression
+ * - Multi-relay WebSocket connections with auto-reconnection
+ * - Token transfers over Nostr
+ * - Privacy-preserving nametag bindings
+ *
+ * @packageDocumentation
+ */
+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 __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.TokenTransferProtocol = exports.NametagBinding = exports.NametagUtils = exports.EventKinds = exports.NIP04 = exports.SchnorrSigner = exports.Bech32 = exports.NostrKeyManager = void 0;
+// Core key management
+var NostrKeyManager_js_1 = require("./NostrKeyManager.js");
+Object.defineProperty(exports, "NostrKeyManager", { enumerable: true, get: function () { return NostrKeyManager_js_1.NostrKeyManager; } });
+// Crypto utilities
+__exportStar(require("./crypto/index.js"), exports);
+var index_js_1 = require("./crypto/index.js");
+Object.defineProperty(exports, "Bech32", { enumerable: true, get: function () { return index_js_1.Bech32; } });
+Object.defineProperty(exports, "SchnorrSigner", { enumerable: true, get: function () { return index_js_1.SchnorrSigner; } });
+Object.defineProperty(exports, "NIP04", { enumerable: true, get: function () { return index_js_1.NIP04; } });
+// Protocol types and classes
+__exportStar(require("./protocol/index.js"), exports);
+var index_js_2 = require("./protocol/index.js");
+Object.defineProperty(exports, "EventKinds", { enumerable: true, get: function () { return index_js_2.EventKinds; } });
+// Client
+__exportStar(require("./client/index.js"), exports);
+// Nametag utilities
+__exportStar(require("./nametag/index.js"), exports);
+var index_js_3 = require("./nametag/index.js");
+Object.defineProperty(exports, "NametagUtils", { enumerable: true, get: function () { return index_js_3.NametagUtils; } });
+Object.defineProperty(exports, "NametagBinding", { enumerable: true, get: function () { return index_js_3.NametagBinding; } });
+// Token transfer
+__exportStar(require("./token/index.js"), exports);
+var index_js_4 = require("./token/index.js");
+Object.defineProperty(exports, "TokenTransferProtocol", { enumerable: true, get: function () { return index_js_4.TokenTransferProtocol; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;AAEH,sBAAsB;AACtB,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AAExB,mBAAmB;AACnB,oDAAkC;AAClC,8CAI2B;AAHzB,kGAAA,MAAM,OAAA;AACN,yGAAA,aAAa,OAAA;AACb,iGAAA,KAAK,OAAA;AAGP,6BAA6B;AAC7B,sDAAoC;AACpC,gDAAiD;AAAxC,sGAAA,UAAU,OAAA;AAEnB,SAAS;AACT,oDAAkC;AAElC,oBAAoB;AACpB,qDAAmC;AACnC,+CAAkE;AAAzD,wGAAA,YAAY,OAAA;AAAE,0GAAA,cAAc,OAAA;AAErC,iBAAiB;AACjB,mDAAiC;AACjC,6CAAyD;AAAhD,iHAAA,qBAAqB,OAAA"}

package/dist/cjs/nametag/NametagBinding.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * NametagBinding - Create and parse nametag binding events.
+ * Uses kind 30078 (APP_DATA) for parameterized replaceable events.
+ */
+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.createBindingEvent = createBindingEvent;
+exports.createNametagToPubkeyFilter = createNametagToPubkeyFilter;
+exports.createPubkeyToNametagFilter = createPubkeyToNametagFilter;
+exports.parseNametagHashFromEvent = parseNametagHashFromEvent;
+exports.parseAddressFromEvent = parseAddressFromEvent;
+exports.isValidBindingEvent = isValidBindingEvent;
+const Event_js_1 = require("../protocol/Event.js");
+const Filter_js_1 = require("../protocol/Filter.js");
+const EventKinds = __importStar(require("../protocol/EventKinds.js"));
+const NametagUtils = __importStar(require("./NametagUtils.js"));
+/** Default country code for phone number normalization */
+const DEFAULT_COUNTRY = 'US';
+/**
+ * Create a nametag binding event.
+ *
+ * Event structure:
+ * - Kind: 30078 (APP_DATA - parameterized replaceable)
+ * - Tags:
+ *   - ["d", "<hashed_nametag>"] - Required for parameterized replaceable
+ *   - ["nametag", "<hashed_nametag>"] - Hashed for privacy
+ *   - ["t", "<hashed_nametag>"] - Indexed tag for relay search
+ *   - ["address", "<unicity_addr>"] - Unicity blockchain address
+ * - Content: JSON with nametag_hash, address, verified timestamp
+ *
+ * @param keyManager Key manager with signing keys
+ * @param nametagId Nametag identifier (phone number or username)
+ * @param unicityAddress Unicity blockchain address
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Signed event
+ */
+async function createBindingEvent(keyManager, nametagId, unicityAddress, defaultCountry = DEFAULT_COUNTRY) {
+    const hashedNametag = NametagUtils.hashNametag(nametagId, defaultCountry);
+    const content = {
+        nametag_hash: hashedNametag,
+        address: unicityAddress,
+        verified: Date.now(),
+    };
+    const event = Event_js_1.Event.create(keyManager, {
+        kind: EventKinds.APP_DATA,
+        tags: [
+            ['d', hashedNametag],
+            ['nametag', hashedNametag],
+            ['t', hashedNametag],
+            ['address', unicityAddress],
+        ],
+        content: JSON.stringify(content),
+    });
+    return event;
+}
+/**
+ * Create a filter to query pubkey by nametag.
+ * Query direction: nametag → pubkey
+ *
+ * @param nametagId Nametag identifier
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Filter for nametag binding events
+ */
+function createNametagToPubkeyFilter(nametagId, defaultCountry = DEFAULT_COUNTRY) {
+    const hashedNametag = NametagUtils.hashNametag(nametagId, defaultCountry);
+    return Filter_js_1.Filter.builder()
+        .kinds(EventKinds.APP_DATA)
+        .tTags(hashedNametag)
+        .build();
+}
+/**
+ * Create a filter to query nametags by pubkey.
+ * Query direction: pubkey → nametags
+ *
+ * @param nostrPubkey Nostr public key (hex)
+ * @returns Filter for nametag binding events
+ */
+function createPubkeyToNametagFilter(nostrPubkey) {
+    return Filter_js_1.Filter.builder()
+        .kinds(EventKinds.APP_DATA)
+        .authors(nostrPubkey)
+        .limit(10)
+        .build();
+}
+/**
+ * Parse the hashed nametag from a binding event.
+ * Tries tags first, then content JSON.
+ *
+ * @param event Binding event
+ * @returns Hashed nametag, or undefined if not found
+ */
+function parseNametagHashFromEvent(event) {
+    // Try "nametag" tag first
+    const fromTag = event.getTagValue('nametag');
+    if (fromTag) {
+        return fromTag;
+    }
+    // Try "d" tag
+    const fromDTag = event.getTagValue('d');
+    if (fromDTag) {
+        return fromDTag;
+    }
+    // Try content JSON
+    try {
+        const content = JSON.parse(event.content);
+        return content.nametag_hash;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse the Unicity address from a binding event.
+ * Tries tags first, then content JSON.
+ *
+ * @param event Binding event
+ * @returns Unicity address, or undefined if not found
+ */
+function parseAddressFromEvent(event) {
+    // Try "address" tag first
+    const fromTag = event.getTagValue('address');
+    if (fromTag) {
+        return fromTag;
+    }
+    // Try content JSON
+    try {
+        const content = JSON.parse(event.content);
+        return content.address;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Verify that a binding event is valid.
+ * Checks signature and structure.
+ *
+ * @param event Event to verify
+ * @returns true if the binding event is valid
+ */
+function isValidBindingEvent(event) {
+    // Check event kind
+    if (event.kind !== EventKinds.APP_DATA) {
+        return false;
+    }
+    // Check required tags
+    if (!event.hasTag('d')) {
+        return false;
+    }
+    // Check content structure
+    try {
+        const content = JSON.parse(event.content);
+        if (!content.nametag_hash || !content.address) {
+            return false;
+        }
+    }
+    catch {
+        return false;
+    }
+    // Verify signature
+    return event.verify();
+}
+//# sourceMappingURL=NametagBinding.js.map

package/dist/cjs/nametag/NametagBinding.js.map

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

package/dist/cjs/nametag/NametagUtils.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * NametagUtils - Privacy-preserving nametag normalization and hashing.
+ * Supports phone number normalization to E.164 format.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeNametag = normalizeNametag;
+exports.hashNametag = hashNametag;
+exports.areSameNametag = areSameNametag;
+exports.formatForDisplay = formatForDisplay;
+exports.isPhoneNumber = isPhoneNumber;
+const sha256_1 = require("@noble/hashes/sha256");
+const utils_1 = require("@noble/hashes/utils");
+const libphonenumber_js_1 = require("libphonenumber-js");
+/** Salt prefix for nametag hashing */
+const NAMETAG_SALT = 'unicity:nametag:';
+/** Default country code for phone number normalization */
+const DEFAULT_COUNTRY = 'US';
+/**
+ * Compute SHA-256 hash of a string.
+ * @param input String to hash
+ * @returns Hex-encoded hash
+ */
+function sha256Hex(input) {
+    const bytes = new TextEncoder().encode(input);
+    return (0, utils_1.bytesToHex)((0, sha256_1.sha256)(bytes));
+}
+/**
+ * Check if a string looks like a phone number.
+ * Heuristic: starts with + OR has >50% digits AND >= 7 digits total.
+ * @param str String to check
+ * @returns true if the string looks like a phone number
+ */
+function isLikelyPhoneNumber(str) {
+    if (str.startsWith('+')) {
+        return true;
+    }
+    const digitsOnly = str.replace(/\D/g, '');
+    const digitCount = digitsOnly.length;
+    if (digitCount < 7) {
+        return false;
+    }
+    // Count non-digit characters (excluding common phone number chars)
+    const cleanedLength = str.replace(/[\s\-\(\)\.]/g, '').length;
+    const digitRatio = digitCount / cleanedLength;
+    return digitRatio > 0.5;
+}
+/**
+ * Normalize a phone number to E.164 format.
+ * @param phoneNumber Phone number string
+ * @param defaultCountry Default country code
+ * @returns E.164 formatted phone number, or null if invalid
+ */
+function normalizePhoneNumber(phoneNumber, defaultCountry) {
+    try {
+        // Try to parse with default country
+        if ((0, libphonenumber_js_1.isValidPhoneNumber)(phoneNumber, defaultCountry)) {
+            const parsed = (0, libphonenumber_js_1.parsePhoneNumber)(phoneNumber, defaultCountry);
+            return parsed.format('E.164');
+        }
+        // Try without default country (for numbers with country code)
+        if ((0, libphonenumber_js_1.isValidPhoneNumber)(phoneNumber)) {
+            const parsed = (0, libphonenumber_js_1.parsePhoneNumber)(phoneNumber);
+            return parsed.format('E.164');
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Normalize a nametag for hashing.
+ * - If it looks like a phone number, normalize to E.164
+ * - Otherwise, lowercase and remove @unicity suffix
+ * @param nametag Nametag to normalize
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Normalized nametag
+ */
+function normalizeNametag(nametag, defaultCountry = DEFAULT_COUNTRY) {
+    const trimmed = nametag.trim();
+    if (isLikelyPhoneNumber(trimmed)) {
+        const normalized = normalizePhoneNumber(trimmed, defaultCountry);
+        if (normalized) {
+            return normalized;
+        }
+        // If phone normalization fails, fall through to standard normalization
+    }
+    // Standard normalization: lowercase, remove @unicity suffix
+    let normalized = trimmed.toLowerCase();
+    if (normalized.endsWith('@unicity')) {
+        normalized = normalized.slice(0, -8);
+    }
+    return normalized;
+}
+/**
+ * Hash a nametag with the standard salt.
+ * @param nametag Nametag to hash
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Hex-encoded SHA-256 hash
+ */
+function hashNametag(nametag, defaultCountry = DEFAULT_COUNTRY) {
+    const normalized = normalizeNametag(nametag, defaultCountry);
+    return sha256Hex(NAMETAG_SALT + normalized);
+}
+/**
+ * Compare two nametags for equality (handling format variations).
+ * @param tag1 First nametag
+ * @param tag2 Second nametag
+ * @param defaultCountry Default country code for phone normalization
+ * @returns true if the nametags represent the same identity
+ */
+function areSameNametag(tag1, tag2, defaultCountry = DEFAULT_COUNTRY) {
+    const normalized1 = normalizeNametag(tag1, defaultCountry);
+    const normalized2 = normalizeNametag(tag2, defaultCountry);
+    return normalized1 === normalized2;
+}
+/**
+ * Format a nametag for display (privacy-preserving).
+ * For phone numbers, hides middle digits.
+ * @param nametag Nametag to format
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Display-safe formatted nametag
+ */
+function formatForDisplay(nametag, defaultCountry = DEFAULT_COUNTRY) {
+    const trimmed = nametag.trim();
+    if (isLikelyPhoneNumber(trimmed)) {
+        const normalized = normalizePhoneNumber(trimmed, defaultCountry);
+        if (normalized) {
+            // Hide middle digits: +1415***2671
+            const digits = normalized.slice(1); // Remove +
+            if (digits.length > 6) {
+                const start = digits.slice(0, 4);
+                const end = digits.slice(-4);
+                return '+' + start + '***' + end;
+            }
+        }
+    }
+    return normalizeNametag(nametag, defaultCountry);
+}
+/**
+ * Check if a string is a valid phone number.
+ * @param str String to check
+ * @param defaultCountry Default country code
+ * @returns true if the string is a valid phone number
+ */
+function isPhoneNumber(str, defaultCountry = DEFAULT_COUNTRY) {
+    try {
+        return (0, libphonenumber_js_1.isValidPhoneNumber)(str, defaultCountry) ||
+            (0, libphonenumber_js_1.isValidPhoneNumber)(str);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=NametagUtils.js.map

package/dist/cjs/nametag/NametagUtils.js.map

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

package/dist/cjs/nametag/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Nametag module - Privacy-preserving identity bindings
+ */
+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.NametagBinding = exports.NametagUtils = void 0;
+exports.NametagUtils = __importStar(require("./NametagUtils.js"));
+__exportStar(require("./NametagUtils.js"), exports);
+exports.NametagBinding = __importStar(require("./NametagBinding.js"));
+__exportStar(require("./NametagBinding.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nametag/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kEAAkD;AAClD,oDAAkC;AAClC,sEAAsD;AACtD,sDAAoC"}