Fix buildz.ai workspace loading error

[vdimarco]

Summary

This PR addresses the 500 error encountered when loading buildz.ai/workspace and resolves WebSocket connection failures.

The 500 error on /api/workspaces is fixed by implementing comprehensive error handling and logging within the API routes, providing more specific error messages, especially for database-related issues.

WebSocket connection problems are resolved by:

1. Correctly configuring the socket URL in socket-context.tsx to use a relative path in production when NEXT_PUBLIC_SOCKET_URL is not explicitly set, ensuring the client connects to the same origin.
2. Adding graceful fallbacks for socket token generation failures, allowing the application to attempt connection without a token and reducing console spam for expected connection errors when the socket server is unavailable.
3. Improving error handling and logging in the socket token generation endpoint.

These changes ensure the application handles API and WebSocket issues more robustly, provides better diagnostics, and gracefully degrades functionality if the socket server is not deployed.

Fixes #

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation
• Other: ___________

Testing

Reviewers should focus on:

• Verifying the improved error logging in /api/workspaces and /api/auth/socket-token by simulating errors (e.g., database connection issues).
• Confirming correct WebSocket connection behavior in both local development (with and without NEXT_PUBLIC_SOCKET_URL set) and a deployed environment.
• Testing scenarios where the socket server is intentionally unavailable to ensure the application degrades gracefully without critical failures or excessive console errors.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

---

 

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch cursor/fix-buildz-ai-workspace-loading-error-4b9d

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}