feat: add comprehensive OpenAPI documentation and refactor routes

CHANGELOG.md

@@ -1,9 +1,8 @@
 ## [1.7.2](https://github.com/typelets/typelets-api/compare/v1.7.1...v1.7.2) (2025-10-15)
 
-
 ### Bug Fixes
 
-* restore JSON string format for CloudWatch compatibility ([dc2b7aa](https://github.com/typelets/typelets-api/commit/dc2b7aa8474ade322fcc383db7b103f1796ef6c4))
+- restore JSON string format for CloudWatch compatibility ([dc2b7aa](https://github.com/typelets/typelets-api/commit/dc2b7aa8474ade322fcc383db7b103f1796ef6c4))
 
 ## [1.7.1](https://github.com/typelets/typelets-api/compare/v1.7.0...v1.7.1) (2025-10-15)
 

README.md

@@ -170,6 +170,8 @@ If you prefer to install PostgreSQL locally instead of Docker:
 
 ## API Endpoints
 
+📚 **Full API documentation with interactive examples available at [https://api.typelets.com/docs](https://api.typelets.com/docs)** (Swagger/OpenAPI)
+
 ### Public Endpoints
 
 - `GET /` - API information and health status

package.json

@@ -39,7 +39,9 @@
   "dependencies": {
     "@clerk/backend": "^2.5.0",
     "@hono/node-server": "^1.15.0",
-    "@hono/zod-validator": "^0.7.0",
+    "@hono/swagger-ui": "^0.5.2",
+    "@hono/zod-openapi": "^1.1.3",
+    "@hono/zod-validator": "^0.7.2",
     "@types/ws": "^8.18.1",
     "dotenv": "^17.0.1",
     "dotenv-flow": "^4.1.0",
@@ -49,7 +51,7 @@
     "newrelic": "latest",
     "postgres": "^3.4.7",
     "ws": "^8.18.3",
-    "zod": "^3.25.67"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@eslint/js": "^9.37.0",