docs: polish README, CHANGELOG, and package metadata

Remove duplicate Install/Quick Start section, fix scoped package references
to unscoped, add repository/homepage/bugs fields, normalize author, add
CHANGELOG entries for v0.4.11-0.4.16, and create example files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: vveerrgg

CHANGELOG.md

@@ -7,6 +7,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.16] - 2025-02-19
+
+### Changed
+- Updated dependencies to latest within major versions
+
+### Fixed
+- Updated exports to include validation functions
+
+## [0.4.15] - 2025-02-09
+
+### Changed
+- Bumped version for npm publish
+
+### Fixed
+- Fixed Vite security vulnerability
+
+### Refactored
+- Updated build configuration for better ESM/CJS compatibility
+
+## [0.4.14] - 2025-01-15
+
+### Added
+- NIP-19 support and updated dependencies
+
+### Changed
+- Improved types and NIP support
+
+## [0.4.13] - 2025-01-10
+
+### Added
+- Improved NIP-19 documentation and exports
+
+## [0.4.12] - 2025-01-05
+
+### Fixed
+- Improved TypeScript type handling and browser compatibility
+- Removed unused imports
+
+## [0.4.11] - 2025-01-03
+
+### Changed
+- Updated dist files after build cleanup
+- Fixed linting issues and removed unused imports
+
 ## [0.4.10] - 2025-01-02
 
 ### Fixed

README.md

@@ -63,7 +63,7 @@ This library provides essential cryptographic operations and utilities required
 - Supports both ESM and CJS formats
 - Cross-platform compatible (Node.js and browser environments)
 
-[![npm version](https://badge.fury.io/js/%40humanjavaenterprises%2Fnostr-crypto-utils.svg)](https://www.npmjs.com/package/@humanjavaenterprises/nostr-crypto-utils)
+[![npm version](https://badge.fury.io/js/nostr-crypto-utils.svg)](https://www.npmjs.com/package/nostr-crypto-utils)
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/HumanjavaEnterprises/nostr-crypto-utils/blob/main/LICENSE)
 [![Documentation](https://img.shields.io/badge/docs-TypeDoc-blue.svg)](https://humanjavaenterprises.github.io/nostr-crypto-utils/)
@@ -148,7 +148,7 @@ import {
   naddrEncode,
   nrelayEncode,
   decode 
-} from '@humanjavaenterprises/nostr-crypto-utils';
+} from 'nostr-crypto-utils';
 
 // Encode a public key
 const npub = npubEncode('7f3b6c2444c526fc7b3a48b0a1e38fb6a5a4062d4a097c9e96feb3c1df2f36d0');
@@ -202,6 +202,7 @@ try {
 } catch (error) {
   console.error(error); // Error: Invalid hex string
 }
+```
 
 ### Type System
 
@@ -448,11 +449,11 @@ These examples demonstrate real-world usage patterns from production Nostr appli
 
 ## Integration with nostr-nsec-seedphrase
 
-This library is designed to work seamlessly with [@humanjavaenterprises/nostr-nsec-seedphrase](https://github.com/HumanjavaEnterprises/nostr-nsec-seedphrase) to provide a complete solution for Nostr key management and cryptographic operations:
+This library is designed to work seamlessly with [nostr-nsec-seedphrase](https://github.com/HumanjavaEnterprises/nostr-nsec-seedphrase) to provide a complete solution for Nostr key management and cryptographic operations:
 
 ```typescript
-import { generateSeedPhrase } from '@humanjavaenterprises/nostr-nsec-seedphrase';
-import { createTextNoteEvent, signEvent } from '@humanjavaenterprises/nostr-crypto-utils';
+import { generateSeedPhrase } from 'nostr-nsec-seedphrase';
+import { createTextNoteEvent, signEvent } from 'nostr-crypto-utils';
 
 // Generate keys using nostr-nsec-seedphrase
 const seedPhrase = generateSeedPhrase();
@@ -481,7 +482,7 @@ You can use this library to create delegate tokens for use on web servers or oth
 ### Basic Delegation Example
 
 ```typescript
-import { createDelegation, validateDelegation } from '@humanjavaenterprises/nostr-crypto-utils';
+import { createDelegation, validateDelegation } from 'nostr-crypto-utils';
 
 // Create a delegation token (delegator's perspective)
 const delegatorKeyPair = await generateKeyPair();
@@ -510,7 +511,7 @@ const isValid = await validateDelegation({
 Here's how to use delegation tokens in a web server context:
 
 ```typescript
-import { createEvent, signEventWithDelegation } from '@humanjavaenterprises/nostr-crypto-utils';
+import { createEvent, signEventWithDelegation } from 'nostr-crypto-utils';
 
 // On your server, store these securely
 const DELEGATE_PRIVKEY = 'nsec1...';  // Your server's private key
@@ -589,7 +590,7 @@ For more details on delegation, see the [NIP-26 specification](https://github.co
 Enable debug mode to get detailed logging:
 
 ```typescript
-import { setDebugLevel } from '@humanjavaenterprises/nostr-crypto-utils';
+import { setDebugLevel } from 'nostr-crypto-utils';
 
 // Enable debug logging
 setDebugLevel('debug');
@@ -671,53 +672,6 @@ const testEventSigning = async (event, delegation) => {
 
 For more help, join our [Discord community](https://discord.gg/nostr) or [open an issue](https://github.com/humanjavaenterprises/nostr-crypto-utils/issues).
 
-## Installation
-
-```bash
-npm install @humanjavaenterprises/nostr-crypto-utils
-```
-
-## Quick Start
-
-```typescript
-import { createKeyPair, createTextNoteEvent, signEvent } from '@humanjavaenterprises/nostr-crypto-utils';
-
-// Generate a new key pair
-const keyPair = createKeyPair();
-
-// Create a text note event
-const event = createTextNoteEvent({
-  content: 'Hello Nostr!',
-  pubkey: keyPair.publicKey,
-  created_at: Math.floor(Date.now() / 1000)
-});
-
-// Sign the event
-const signedEvent = signEvent(event, keyPair.privateKey);
-```
-
-## Documentation
-
-Comprehensive documentation is available at [https://humanjavaenterprises.github.io/nostr-crypto-utils/](https://humanjavaenterprises.github.io/nostr-crypto-utils/)
-
-## Type Safety
-
-This library is written in TypeScript and provides comprehensive type definitions for all functions and data structures. Type checking is enforced at compile time to catch potential errors early.
-
-```typescript
-import { NostrEvent, NostrFilter, ValidationResult } from '@humanjavaenterprises/nostr-crypto-utils';
-
-// All types are properly defined
-const filter: NostrFilter = {
-  kinds: [NostrEventKind.TEXT_NOTE],
-  "#t": ["nostr", "crypto"],  // Filter by custom tag
-  limit: 10
-};
-
-// Validation results include type information
-const result: ValidationResult = validateEvent(event);
-```
-
 ## Contributing
 
 We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
@@ -728,29 +682,14 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Changelog
 
-### v0.3.0 (2024-12-28)
-- 🔒 Improved type safety with stricter TypeScript checks
-- 🐛 Fixed crypto implementation for cross-platform compatibility
-- ✨ Added comprehensive validation for all message types
-- 📝 Updated documentation with more examples
-
-### v0.2.0 (2024-12-26)
-- 🎉 Initial public release
-- ✨ Added support for NIP-01 and NIP-04
-- 🔑 Implemented key pair generation and management
-- 📝 Added comprehensive documentation
+See [CHANGELOG.md](CHANGELOG.md) for a detailed history of changes.
 
 ## Support
 
-- 📖 [Documentation](https://humanjavaenterprises.github.io/nostr-crypto-utils/)
-- 🐛 [Issue Tracker](https://github.com/humanjavaenterprises/nostr-crypto-utils/issues)
-- 💬 [Discussions](https://github.com/humanjavaenterprises/nostr-crypto-utils/discussions)
+- [Documentation](https://humanjavaenterprises.github.io/nostr-crypto-utils/)
+- [Issue Tracker](https://github.com/HumanjavaEnterprises/nostr-crypto-utils/issues)
+- [Discussions](https://github.com/HumanjavaEnterprises/nostr-crypto-utils/discussions)
 
 ## Related Projects
 
-- [@humanjavaenterprises/nostr-nsec-seedphrase](https://github.com/HumanjavaEnterprises/nostr-nsec-seedphrase) - Generate and manage Nostr private keys using BIP-39 seed phrases
-
----
-<div align="center">
-Made with ❤️ by <a href="https://github.com/humanjavaenterprises">Humanjava Enterprises</a>
-</div>
+- [nostr-nsec-seedphrase](https://github.com/HumanjavaEnterprises/nostr-nsec-seedphrase) - Generate and manage Nostr private keys using BIP-39 seed phrases

examples/basic-usage.ts

@@ -0,0 +1,33 @@
+/**
+ * Basic Usage Example — nostr-crypto-utils
+ *
+ * Demonstrates key generation, event creation, and event signing.
+ */
+import { generateKeyPair, createEvent, signEvent, verifySignature } from 'nostr-crypto-utils';
+
+async function main() {
+  // Generate a new Nostr key pair
+  const keyPair = generateKeyPair();
+  console.log('Public key:', keyPair.publicKey);
+  console.log('Private key:', keyPair.privateKey);
+
+  // Create an unsigned text note event (kind 1)
+  const event = createEvent({
+    pubkey: keyPair.publicKey,
+    kind: 1,
+    content: 'Hello Nostr!',
+    tags: [],
+    created_at: Math.floor(Date.now() / 1000),
+  });
+
+  // Sign the event
+  const signedEvent = await signEvent(event, keyPair.privateKey);
+  console.log('Signed event ID:', signedEvent.id);
+  console.log('Signature:', signedEvent.sig);
+
+  // Verify the signature
+  const isValid = await verifySignature(signedEvent);
+  console.log('Signature valid:', isValid);
+}
+
+main().catch(console.error);

examples/nip-04.ts

@@ -0,0 +1,35 @@
+/**
+ * NIP-04 Example — nostr-crypto-utils
+ *
+ * Demonstrates encrypted direct message creation and decryption.
+ */
+import { generateKeyPair, encryptMessage, decryptMessage } from 'nostr-crypto-utils';
+
+async function main() {
+  // Generate two key pairs (sender and recipient)
+  const sender = generateKeyPair();
+  const recipient = generateKeyPair();
+
+  console.log('Sender pubkey:', sender.publicKey);
+  console.log('Recipient pubkey:', recipient.publicKey);
+
+  // Encrypt a message from sender to recipient
+  const plaintext = 'Hello, this is a secret message!';
+  const encrypted = await encryptMessage(
+    plaintext,
+    recipient.publicKey,
+    sender.privateKey,
+  );
+  console.log('Encrypted:', encrypted);
+
+  // Decrypt the message as the recipient
+  const decrypted = await decryptMessage(
+    encrypted,
+    sender.publicKey,
+    recipient.privateKey,
+  );
+  console.log('Decrypted:', decrypted);
+  console.log('Match:', plaintext === decrypted);
+}
+
+main().catch(console.error);

examples/nip-19.ts

@@ -0,0 +1,46 @@
+/**
+ * NIP-19 Example — nostr-crypto-utils
+ *
+ * Demonstrates encoding and decoding of bech32-encoded Nostr entities.
+ */
+import {
+  generateKeyPair,
+  npubEncode,
+  nsecEncode,
+  noteEncode,
+  nprofileEncode,
+  decode,
+} from 'nostr-crypto-utils';
+
+async function main() {
+  const keyPair = generateKeyPair();
+
+  // Encode public key as npub
+  const npub = npubEncode(keyPair.publicKey);
+  console.log('npub:', npub);
+
+  // Encode private key as nsec
+  const nsec = nsecEncode(keyPair.privateKey);
+  console.log('nsec:', nsec);
+
+  // Encode an event ID as note
+  const exampleEventId = keyPair.publicKey; // using pubkey as stand-in
+  const note = noteEncode(exampleEventId);
+  console.log('note:', note);
+
+  // Encode a profile with relay hints
+  const nprofile = nprofileEncode(keyPair.publicKey, [
+    'wss://relay.damus.io',
+    'wss://nos.lol',
+  ]);
+  console.log('nprofile:', nprofile);
+
+  // Decode any bech32 entity back
+  const decoded = decode(npub);
+  console.log('Decoded npub:', decoded);
+
+  const decodedProfile = decode(nprofile);
+  console.log('Decoded nprofile:', decodedProfile);
+}
+
+main().catch(console.error);

package.json

@@ -17,6 +17,7 @@
   "files": [
     "dist",
     "src",
+    "examples/**/*",
     "README.md",
     "LICENSE"
   ],
@@ -40,8 +41,16 @@
     "utilities",
     "typescript"
   ],
-  "author": "Humanjava Enterprises",
+  "author": "vveerrgg",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HumanjavaEnterprises/nostr-crypto-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/HumanjavaEnterprises/nostr-crypto-utils/issues"
+  },
+  "homepage": "https://github.com/HumanjavaEnterprises/nostr-crypto-utils#readme",
   "dependencies": {
     "@noble/curves": "^1.9.7",
     "@noble/hashes": "^1.8.0",