docs: fix broken typedoc links in README

NostrWSMessage was refactored from interface to type alias;
update README link from docs/interfaces/ to docs/type-aliases/.
Also fix nonexistent NostrWSMessageType enumeration link.

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

Author: vveerrgg

README.md

@@ -191,7 +191,7 @@ Comprehensive API documentation is available in our [documentation site](https:/
 - [NostrServer](docs/classes/NostrServer.md) - High-level Nostr server
 
 ### Types and Interfaces
-- [NostrWSMessage](docs/interfaces/NostrWSMessage.md) - Message structure
+- [NostrWSMessage](docs/type-aliases/NostrWSMessage.md) - Message structure
 - [NostrWSOptions](docs/interfaces/NostrWSOptions.md) - Configuration options
 - [NostrWSSubscription](docs/interfaces/NostrWSSubscription.md) - Subscription interface
 - [ExtendedWebSocket](docs/interfaces/ExtendedWebSocket.md) - Enhanced WebSocket interface
@@ -201,7 +201,7 @@ Comprehensive API documentation is available in our [documentation site](https:/
 - [getLogger](docs/functions/getLogger.md) - Logging utility
 
 ### Type Definitions
-- [MessageType](docs/enumerations/NostrWSMessageType.md) - Message type enumeration
+- [ConnectionState](docs/enumerations/ConnectionState.md) - Connection state enumeration
 - [Global Types](docs/globals.md) - Global type definitions
 
 ## Examples

docs/README.md

@@ -1,11 +1,11 @@
-**nostr-websocket-utils v0.3.0**
+**nostr-websocket-utils v0.3.16**
 
 ***
 
 # nostr-websocket-utils
 
-[![npm version](https://img.shields.io/npm/v/@humanjavaenterprises/nostr-websocket-utils.svg)](https://www.npmjs.com/package/@humanjavaenterprises/nostr-websocket-utils)
-[![License](https://img.shields.io/npm/l/@humanjavaenterprises/nostr-websocket-utils.svg)](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/nostr-websocket-utils.svg)](https://www.npmjs.com/package/nostr-websocket-utils)
+[![License](https://img.shields.io/npm/l/nostr-websocket-utils.svg)](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/LICENSE)
 [![Build Status](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/workflows/CI/badge.svg)](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/actions)
 [![Documentation](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/workflows/Documentation/badge.svg)](https://humanjavaenterprises.github.io/nostr-websocket-utils/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org)
@@ -15,13 +15,14 @@ A TypeScript library for building Nostr protocol WebSocket clients and servers.
 
 ## Features
 
-- 🚀 Full Nostr protocol support
+- 🚀 Full Nostr protocol support with nostr-crypto-utils integration
 - 🔒 Secure WebSocket connections
 - ♥️ Heartbeat mechanism for connection health
 - 🔄 Automatic reconnection handling
-- 📝 Comprehensive logging
+- 📝 Comprehensive logging with Pino v8
 - 🎯 Type-safe message handling
 - 📦 Easy to use API
+- 🧪 Vitest-powered test suite
 
 ## NIPs Support Status
 
@@ -106,7 +107,7 @@ await client.connect();
 ### Creating a Nostr WebSocket Server
 
 ```typescript
-import { createNostrServer } from '@humanjavaenterprises/nostr-websocket-utils';
+import { createNostrServer } from 'nostr-websocket-utils';
 
 const server = await createNostrServer(8080, {
   logger: console,
@@ -120,13 +121,69 @@ const server = await createNostrServer(8080, {
 });
 ```
 
+## Browser Usage
+
+This library now supports direct browser usage! You can use it in your client-side applications in two ways:
+
+### Via NPM (Recommended)
+
+```javascript
+import { NostrWSClient } from 'nostr-websocket-utils';
+
+const client = new NostrWSClient({
+  url: 'wss://relay.damus.io',
+  options: {
+    autoReconnect: true,
+    maxRetries: 3
+  }
+});
+
+client.onMessage((message) => {
+  console.log('Received:', message);
+});
+
+client.connect();
+```
+
+### Via CDN
+
+```html
+<script src="https://unpkg.com/nostr-websocket-utils/dist/browser/nostr-websocket-utils.min.js"></script>
+<script>
+  const client = new NostrWebSocketUtils.NostrWSClient({
+    url: 'wss://relay.damus.io',
+    options: {
+      autoReconnect: true,
+      maxRetries: 3
+    }
+  });
+
+  client.onMessage((message) => {
+    console.log('Received:', message);
+  });
+
+  client.connect();
+</script>
+```
+
+### Features in Browser Environment
+
+- Direct WebSocket connections to Nostr relays
+- Automatic reconnection handling
+- Message queueing
+- Type-safe handlers
+- Full compatibility with browser environments
+- Source maps for better debugging
+
+See the `examples/browser.html` file for a complete example of browser usage.
+
 ## Dependencies
 
-This package relies on:
-- [nostr-crypto-utils](https://github.com/HumanjavaEnterprises/nostr-crypto-utils) - For all cryptographic operations
-- [ws](https://github.com/websockets/ws) - For WebSocket functionality
-- [pino](https://github.com/pinojs/pino) - For logging
-- [uuid](https://github.com/uuidjs/uuid) - For unique identifiers
+This package uses:
+- nostr-crypto-utils (^0.4.2) for cryptographic operations
+- pino (^8.17.2) for logging
+- ws (^8.16.0) for WebSocket functionality
+- uuid (^9.0.0) for unique identifiers
 
 ## Documentation
 
@@ -148,7 +205,7 @@ Comprehensive API documentation is available in our [documentation site](https:/
 - [getLogger](_media/getLogger.md) - Logging utility
 
 ### Type Definitions
-- [MessageType](docs/enumerations/NostrWSMessageType.md) - Message type enumeration
+- [ConnectionState](_media/ConnectionState.md) - Connection state enumeration
 - [Global Types](_media/globals.md) - Global type definitions
 
 ## Examples
@@ -176,6 +233,14 @@ server.broadcast({
 });
 ```
 
+## Security
+
+### Dependency Vulnerability Status
+
+We actively monitor and address security vulnerabilities in this codebase. **`npm audit --omit=dev` reports zero vulnerabilities** for this package — there are no known security issues in production dependencies.
+
+Any remaining `npm audit` findings are in development-only tooling (eslint, typescript-eslint, vitest, typedoc, etc.) and stem from transitive dependencies with no upstream fix available. These are devDependencies that are never included in the published package and pose no risk to consumers of this library. We monitor upstream fixes and update promptly when they become available.
+
 ## Contributing
 
 Contributions are welcome! Please read our [Contributing Guide](_media/CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.

docs/_media/ConnectionState.md

@@ -0,0 +1,51 @@
+[**nostr-websocket-utils v0.3.16**](../README.md)
+
+***
+
+[nostr-websocket-utils](../globals.md) / ConnectionState
+
+# Enumeration: ConnectionState
+
+Defined in: [types/index.ts:36](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L36)
+
+WebSocket connection states
+
+## Enumeration Members
+
+### CONNECTING
+
+> **CONNECTING**: `"CONNECTING"`
+
+Defined in: [types/index.ts:37](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L37)
+
+***
+
+### CONNECTED
+
+> **CONNECTED**: `"CONNECTED"`
+
+Defined in: [types/index.ts:38](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L38)
+
+***
+
+### DISCONNECTED
+
+> **DISCONNECTED**: `"DISCONNECTED"`
+
+Defined in: [types/index.ts:39](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L39)
+
+***
+
+### RECONNECTING
+
+> **RECONNECTING**: `"RECONNECTING"`
+
+Defined in: [types/index.ts:40](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L40)
+
+***
+
+### FAILED
+
+> **FAILED**: `"FAILED"`
+
+Defined in: [types/index.ts:41](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L41)

docs/_media/ExtendedWebSocket.md

@@ -1,11 +1,13 @@
-[**nostr-websocket-utils v0.3.0**](../README.md)
+[**nostr-websocket-utils v0.3.16**](../README.md)
 
 ***
 
 [nostr-websocket-utils](../globals.md) / ExtendedWebSocket
 
 # Interface: ExtendedWebSocket
 
+Defined in: [types/index.ts:24](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L24)
+
 Extended WebSocket interface with client ID
 
 ## Extends
@@ -18,56 +20,44 @@ Extended WebSocket interface with client ID
 
 > `optional` **clientId**: `string`
 
-#### Defined in
-
-[types/index.ts:21](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L21)
+Defined in: [types/index.ts:25](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L25)
 
 ***
 
 ### isAlive?
 
 > `optional` **isAlive**: `boolean`
 
-#### Defined in
-
-[types/index.ts:22](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L22)
+Defined in: [types/index.ts:26](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L26)
 
 ***
 
 ### subscriptions?
 
 > `optional` **subscriptions**: `Set`\<`string`\>
 
-#### Defined in
-
-[types/index.ts:23](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L23)
+Defined in: [types/index.ts:27](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L27)
 
 ***
 
 ### lastPing?
 
 > `optional` **lastPing**: `number`
 
-#### Defined in
-
-[types/index.ts:24](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L24)
+Defined in: [types/index.ts:28](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L28)
 
 ***
 
 ### reconnectAttempts?
 
 > `optional` **reconnectAttempts**: `number`
 
-#### Defined in
-
-[types/index.ts:25](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L25)
+Defined in: [types/index.ts:29](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L29)
 
 ***
 
 ### messageQueue?
 
-> `optional` **messageQueue**: [`NostrWSMessage`](NostrWSMessage.md)[]
-
-#### Defined in
+> `optional` **messageQueue**: [`NostrWSMessage`](../type-aliases/NostrWSMessage.md)[]
 
-[types/index.ts:26](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L26)
+Defined in: [types/index.ts:30](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/types/index.ts#L30)

docs/_media/NostrServer.md

@@ -1,18 +1,22 @@
-[**nostr-websocket-utils v0.3.0**](../README.md)
+[**nostr-websocket-utils v0.3.16**](../README.md)
 
 ***
 
 [nostr-websocket-utils](../globals.md) / NostrServer
 
 # Class: NostrServer
 
+Defined in: [core/nostr-server.ts:11](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L11)
+
 Represents a Nostr WebSocket server
 
 ## Constructors
 
-### new NostrServer()
+### Constructor
+
+> **new NostrServer**(`options`): `NostrWSServer`
 
-> **new NostrServer**(`options`): [`NostrServer`](NostrServer.md)
+Defined in: [core/nostr-server.ts:22](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L22)
 
 Creates a new Nostr WebSocket server instance
 
@@ -26,36 +30,28 @@ Server configuration options
 
 #### Returns
 
-[`NostrServer`](NostrServer.md)
-
-#### Defined in
-
-[core/nostr-server.ts:22](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L22)
+`NostrWSServer`
 
 ## Properties
 
 ### server
 
 > `private` **server**: `WebSocketServer`
 
-The underlying WebSocket server instance
-
-#### Defined in
+Defined in: [core/nostr-server.ts:15](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L15)
 
-[core/nostr-server.ts:15](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L15)
+The underlying WebSocket server instance
 
 ## Methods
 
 ### stop()
 
 > **stop**(): `void`
 
+Defined in: [core/nostr-server.ts:98](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L98)
+
 Closes the WebSocket server
 
 #### Returns
 
 `void`
-
-#### Defined in
-
-[core/nostr-server.ts:97](https://github.com/HumanjavaEnterprises/nostr-websocket-utils/blob/main/src/core/nostr-server.ts#L97)