Add SDK CodeGen

Initially C

(Largely vibecoded, lol)

Changelog(feat)

Author: Alia5

.gitignore

@@ -32,4 +32,4 @@ dist/
 logs/
 log/
 !*/internal/log
-*.log
+*.log

README.md

@@ -4,6 +4,7 @@
 
 [![Build Status](https://github.com/alia5/VIIPER/actions/workflows/snapshots.yml/badge.svg)](https://github.com/alia5/VIIPER/actions/workflows/snapshots.yml)
 [![License: GPL-3.0](https://img.shields.io/github/license/alia5/VIIPER)](https://github.com/alia5/VIIPER/blob/main/LICENSE)
+[![Client SDKs: MIT](https://img.shields.io/badge/Client_SDKs-MIT-green)](https://github.com/alia5/VIIPER/blob/main/viiper/internal/codegen/common/license.go)
 [![Release](https://img.shields.io/github/v/release/alia5/VIIPER?include_prereleases&sort=semver)](https://github.com/alia5/VIIPER/releases)
 [![Issues](https://img.shields.io/github/issues/alia5/VIIPER)](https://github.com/alia5/VIIPER/issues)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/alia5/VIIPER/pulls)
@@ -37,6 +38,8 @@ All devices _can and must be_ controlled programmatically via an API.
 - ✅ Cross-platform: works on Linux and Windows
 - ✅ Flexible logging (including raw USB packet logs)
 - ✅ API server for device/bus management and controlling virtual devices programmatically
+- ✅ Multiple client SDKs for easy integration; see [Client SDKs](docs/api/overview.md)  
+  MIT Licensed
 
 ## 🔌 Requirements
 

clients/.gitignore

@@ -0,0 +1,3 @@
+*
+*/
+!.gitignore

docs/api/overview.md

@@ -1,6 +1,15 @@
 # API Reference
 
-VIIPER ships a lightweight TCP API for managing virtual buses/devices and for device-specific streaming. It’s designed to be trivial to drive from any language that can open a TCP socket and send newline-terminated commands.
+VIIPER ships a lightweight TCP API for managing virtual buses/devices and for device-specific streaming. It's designed to be trivial to drive from any language that can open a TCP socket and send newline-terminated commands.
+
+!!! tip "Client SDKs Available"
+    Generated client libraries are available that abstract away the protocol details described below. For most use cases, you should use one of the provided SDKs rather than implementing the raw protocol yourself:
+    
+    - [C SDK](../clients/c.md): Generated C library with type-safe device streams
+    - [Go Client](../clients/go.md): Reference implementation included in the repository
+    - [Generator Documentation](../clients/generator.md): Information about code generation for additional languages
+    
+    The documentation below is provided for reference and for implementing clients in languages not yet supported by the generator.
 
 ## Protocol overview
 

docs/cli/codegen.md

@@ -0,0 +1,130 @@
+# Code Generation Command
+
+The `codegen` command generates type-safe client SDKs from Go source code annotations.
+
+## Usage
+
+```bash
+viiper codegen [flags]
+```
+
+## Description
+
+Scans the VIIPER server codebase to extract:
+- API routes and response DTOs
+- Device wire formats from `viiper:wire` comment tags
+- Device constants (keycodes, modifiers, button masks)
+
+Then generates client SDKs for C, C#, and TypeScript with:
+- Management API clients
+- Device-agnostic stream wrappers
+- Per-device encode/decode functions
+- Typed constants and enums
+
+## Flags
+
+### `--output`
+
+Output directory for generated SDKs (relative to repository root).
+
+**Default:** `../clients`  
+**Environment Variable:** `VIIPER_CODEGEN_OUTPUT`
+
+**Example:**
+
+```bash
+viiper codegen --output=../sdk-output
+```
+
+### `--lang`
+
+Target language to generate.
+
+**Values:** `c`, `csharp`, `typescript`, `all`  
+**Default:** `all`  
+**Environment Variable:** `VIIPER_CODEGEN_LANG`
+
+**Examples:**
+
+```bash
+# Generate all SDKs
+viiper codegen --lang=all
+
+# Generate C SDK only
+viiper codegen --lang=c
+
+# Generate C# SDK only
+viiper codegen --lang=csharp
+
+# Generate TypeScript SDK only
+viiper codegen --lang=typescript
+```
+
+## Output Structure
+
+Generated files are organized by language:
+
+```
+clients/
+├── c/
+│   ├── include/viiper/
+│   │   ├── viiper.h
+│   │   ├── viiper_keyboard.h
+│   │   ├── viiper_mouse.h
+│   │   └── viiper_xbox360.h
+│   ├── src/
+│   │   ├── viiper.c
+│   │   ├── viiper_keyboard.c
+│   │   ├── viiper_mouse.c
+│   │   └── viiper_xbox360.c
+│   └── CMakeLists.txt
+├── csharp/
+│   └── Viiper.Client/
+│       └── (generated C# files)
+└── ts/
+    └── viiperclient/
+        └── (generated TypeScript files)
+```
+
+## Examples
+
+### Generate All SDKs
+
+```bash
+cd viiper
+go run ./cmd/viiper codegen
+```
+
+### Generate C SDK and Rebuild Examples
+
+```bash
+cd viiper
+go run ./cmd/viiper codegen --lang=c
+cd ../examples/c
+cmake --build build --config Release
+```
+
+### CI/CD Integration
+
+```yaml
+- name: Generate Client SDKs
+  run: |
+    cd viiper
+    go run ./cmd/viiper codegen --lang=all
+```
+
+## When to Regenerate
+
+Run codegen when any of these change:
+
+- `pkg/apitypes/*.go`: API response structures
+- `pkg/device/*/inputstate.go`: Wire format annotations
+- `pkg/device/*/const.go`: Exported constants
+- `internal/server/api/*.go`: Route registrations
+- Generator templates in `internal/codegen/generator/`
+
+## See Also
+
+- [Generator Documentation](../clients/generator.md): Detailed explanation of tagging system and code generation flow
+- [C SDK Documentation](../clients/c.md): C-specific usage and build instructions
+- [Configuration](configuration.md): Global configuration options

docs/cli/overview.md

@@ -6,6 +6,7 @@ VIIPER provides a command-line interface for running the USBIP server and proxy.
 
 - [`server`](server.md) - Start the VIIPER USBIP server
 - [`proxy`](proxy.md) - Start the VIIPER USBIP proxy
+- [`codegen`](codegen.md) - Generate client SDKs from source code annotations
 
 ## Global Options