Add custom peer ID support to register method

- Update register() to accept optional customPeerId parameter
- Add TypeScript documentation with JSDoc comments
- Update README with usage examples and documentation
- Maintain backward compatibility with auto-generated IDs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

README.md

@@ -436,14 +436,26 @@ const newPeers = await client.offers.findByTopic('movie-xyz', {
 
 ### Authentication
 
-#### `client.register()`
+#### `client.register(customPeerId?)`
 Register a new peer and receive credentials.
 
 ```typescript
+// Auto-generate peer ID
 const creds = await client.register();
-// { peerId: '...', secret: '...' }
+// { peerId: 'f17c195f067255e357232e34cf0735d9', secret: '...' }
+
+// Or use a custom peer ID (1-128 characters)
+const customCreds = await client.register('my-custom-peer-id');
+// { peerId: 'my-custom-peer-id', secret: '...' }
 ```
 
+**Parameters:**
+- `customPeerId` (optional): Custom peer ID (1-128 characters). If not provided, a random ID will be generated.
+
+**Notes:**
+- Returns 409 Conflict if the custom peer ID is already in use
+- Custom peer IDs must be non-empty and between 1-128 characters
+
 ### Topics
 
 #### `client.offers.getTopics(options?)`

src/auth.ts

@@ -29,14 +29,21 @@ export class RondevuAuth {
 
   /**
    * Register a new peer and receive credentials
+   * @param customPeerId - Optional custom peer ID (1-128 characters). If not provided, a random ID will be generated.
+   * @throws Error if registration fails (e.g., peer ID already in use)
    */
-  async register(): Promise<Credentials> {
+  async register(customPeerId?: string): Promise<Credentials> {
+    const body: { peerId?: string } = {};
+    if (customPeerId !== undefined) {
+      body.peerId = customPeerId;
+    }
+
     const response = await this.fetchFn(`${this.baseUrl}/register`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
       },
-      body: JSON.stringify({}),
+      body: JSON.stringify(body),
     });
 
     if (!response.ok) {

src/rondevu.ts

@@ -100,9 +100,10 @@ export class Rondevu {
 
   /**
    * Register and initialize authenticated client
+   * @param customPeerId - Optional custom peer ID (1-128 characters). If not provided, a random ID will be generated.
    */
-  async register(): Promise<Credentials> {
+  async register(customPeerId?: string): Promise<Credentials> {
-    this.credentials = await this.auth.register();
+    this.credentials = await this.auth.register(customPeerId);
 
     // Create offers API instance
     this._offers = new RondevuOffers(