Add version info with update availability to SDK

- Add getVersion() method to REST client (NFCAgentClient)
- Update WebSocket version handler to include update availability info
- Fix VersionInfo TypeScript type to match actual API response
- Document version API in both README files

SDK v0.2.0

Author: AlbertMN

README.md

@@ -176,9 +176,26 @@ Configure via environment variables:
 | `DELETE` | `/v1/readers/{n}/password` | Remove password |
 | `POST` | `/v1/readers/{n}/records` | Write multiple NDEF records |
 | `GET` | `/v1/supported-readers` | List supported reader models |
-| `GET` | `/v1/version` | Get version info |
+| `GET` | `/v1/version` | Get version and update info |
 | `GET` | `/v1/health` | Health check |
 
+#### Version Endpoint
+
+The `/v1/version` endpoint returns version information and checks for available updates:
+
+```json
+{
+  "version": "1.2.3",
+  "buildTime": "2025-01-15T10:30:00Z",
+  "gitCommit": "abc123def456...",
+  "updateAvailable": true,
+  "latestVersion": "1.3.0",
+  "releaseUrl": "https://github.com/SimplyPrint/nfc-agent/releases/tag/v1.3.0"
+}
+```
+
+The `updateAvailable`, `latestVersion`, and `releaseUrl` fields are only present when the agent has checked for updates.
+
 ### WebSocket
 
 Connect to `ws://127.0.0.1:32145/v1/ws` for real-time card events.
@@ -189,6 +206,7 @@ Connect to `ws://127.0.0.1:32145/v1/ws` for real-time card events.
 - `write_card` - Write data to card
 - `subscribe` / `unsubscribe` - Real-time card detection
 - `erase_card`, `lock_card`, `set_password`, `remove_password`
+- `version` - Get version and update info (same response as HTTP endpoint)
 
 **Events:**
 - `card_detected` - Card placed on reader

internal/api/websocket.go

@@ -663,11 +663,25 @@ func (c *WSClient) handleSupportedReaders(id string) {
 }
 
 func (c *WSClient) handleVersion(id string) {
-	c.sendResponse(id, "version", map[string]string{
+	response := map[string]interface{}{
 		"version":   Version,
 		"buildTime": BuildTime,
 		"gitCommit": GitCommit,
-	})
+	}
+
+	// Include update info if available (for JS SDK / SimplyPrint integration)
+	if updateChecker != nil {
+		info := updateChecker.Check(false) // Use cached result
+		response["updateAvailable"] = info.Available
+		if info.LatestVersion != "" {
+			response["latestVersion"] = info.LatestVersion
+		}
+		if info.ReleaseURL != "" {
+			response["releaseUrl"] = info.ReleaseURL
+		}
+	}
+
+	c.sendResponse(id, "version", response)
 }
 
 func (c *WSClient) handleHealth(id string) {

sdk/README.md

@@ -173,9 +173,14 @@ await ws.removePassword(0, 'mypassword');
 // Lock card permanently (IRREVERSIBLE!)
 await ws.lockCard(0);
 
-// Get version info
+// Get version info (includes update availability)
 const version = await ws.getVersion();
 console.log('Agent version:', version.version);
+console.log('Build time:', version.buildTime);
+if (version.updateAvailable) {
+  console.log('Update available:', version.latestVersion);
+  console.log('Download:', version.releaseUrl);
+}
 
 // Health check
 const health = await ws.health();
@@ -212,6 +217,13 @@ await client.writeCard(0, { data: 'Hello!', dataType: 'text' });
 
 // Get supported readers info
 const supported = await client.getSupportedReaders();
+
+// Get version info (includes update availability)
+const version = await client.getVersion();
+console.log('Version:', version.version);
+if (version.updateAvailable) {
+  console.log('Update available:', version.latestVersion);
+}
 ```
 
 ### Card Polling (REST)
@@ -276,6 +288,7 @@ poller.start();
 | `readCard(reader)` | Read card data |
 | `writeCard(reader, options)` | Write data to card |
 | `getSupportedReaders()` | Get supported hardware info |
+| `getVersion()` | Get agent version and update info |
 | `pollCard(reader, options)` | Create a CardPoller |
 
 ### Types
@@ -311,6 +324,15 @@ interface CardDetectedEvent {
 interface CardRemovedEvent {
   reader: number;
 }
+
+interface VersionInfo {
+  version: string;
+  buildTime: string;
+  gitCommit: string;
+  updateAvailable?: boolean;  // true if a newer version exists
+  latestVersion?: string;     // latest available version
+  releaseUrl?: string;        // URL to download the update
+}
 ```
 
 ---

sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplyprint/nfc-agent",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "JavaScript SDK for NFC Agent - read and write NFC cards via local nfc-agent server",
   "type": "module",
   "main": "./dist/index.cjs",

sdk/src/client.ts

@@ -6,6 +6,7 @@ import type {
   PollOptions,
   SupportedReadersResponse,
   APIErrorResponse,
+  VersionInfo,
 } from './types.js';
 import { ConnectionError, CardError, APIError } from './errors.js';
 import { CardPoller } from './poller.js';
@@ -167,6 +168,14 @@ export class NFCAgentClient {
     return this.request<SupportedReadersResponse>('/v1/supported-readers');
   }
 
+  /**
+   * Get agent version information
+   * @returns Version info including build details and update availability
+   */
+  async getVersion(): Promise<VersionInfo> {
+    return this.request<VersionInfo>('/v1/version');
+  }
+
   /**
    * Create a card poller for automatic card detection
    * @param readerIndex - Index of the reader to poll

sdk/src/types.ts

@@ -240,8 +240,14 @@ export interface SubscribePayload {
  */
 export interface VersionInfo {
   version: string;
-  build?: string;
-  platform?: string;
+  buildTime: string;
+  gitCommit: string;
+  /** Whether a newer version is available */
+  updateAvailable?: boolean;
+  /** Latest available version (if updateAvailable is true) */
+  latestVersion?: string;
+  /** URL to download the latest release */
+  releaseUrl?: string;
 }
 
 /**