Add gRPC Support, Fix PreAuth Key/Routes API, and Enable Display Name for User Creation

[OwnDing]

Pull Request Description:
This PR introduces several improvements and bug fixes to enhance the functionality and usability of headscale-admin. Below is a summary of the changes:

✅ Key Additions & Fixes

1. gRPC Integration

   • Added support for gRPC calls and debugging tools to streamline communication with the headscale backend. This improves performance and simplifies interactions with gRPC-based APIs.

2. API Endpoint Fixes

   • Fixed /api/v1/preauthkey: Resolved issues with pre-auth key creation and retrieval, ensuring seamless integration with headscale.
   • Fixed /api/v1/routes: Corrected route management functionality, enabling proper enable/disable operations for advertised routes.

3. Enhanced User Management

   • Added displayName Support: Users can now create users with an optional displayName field, improving user identification and organization in larger deployments.

🧪 Testing & Validation

All changes have been tested locally and verified against the latest headscale v0.26.1 backend. The gRPC integration has been validated for compatibility with both existing and new API endpoints.

📝 Notes for Reviewers

• The gRPC implementation follows the project’s existing architecture patterns and avoids introducing breaking changes.
• The displayName feature is backward-compatible and does not affect existing user data.
• Updated documentation (if applicable) is included in this PR.

This PR aligns with the project’s goal of providing a modern, stateless web interface for headscale while addressing critical bugs and expanding functionality. Let me know if further adjustments or clarifications are needed!

[awalon]

Hello OwnDing,
may I ask you why are you using 'vpn.ownding.xyz'? This could cause at least a bad feeling seeing third party URLs and could cause a security risk for you and other users where C'n'P is used.
For documentation and as fallback something generic like 'example.com' further Information or 'enter your domain here' should be used whenever configured headscale instance cannot be used (ex. Documentation) and no fallback to somewhere else (there could be an error for missing value instead).
Thanks & Greets, Awalon

[OwnDing]

Hi Awalon, @awalon
Thanks for pointing that out!
The domain vpn.ownding.xyz was used temporarily for testing headscale-related features. After the test, I forgot to replace it with example.com . I'm glad you caught this issue — really appreciate it!

Best regards,
OwnDing

[macvenez]

Any updates on this?
Preauthkeys seems to be broken with headscale-admin v0.25.6 and headscale v0.27.1
Thanks!