@hiai-gg/hiai-docs 0.0.1

package/docs/DEPLOYMENT.md

@@ -0,0 +1,113 @@
+# Deployment Guide
+
+## Quick Start (Docker Compose)
+
+```bash
+git clone https://github.com/hiai-gg/hiai-docs.git
+cd hiai-docs
+cp .env.example .env
+# Edit .env with your values (see Environment Variables below)
+
+docker compose up -d
+```
+
+The app will be available at:
+- Frontend: `http://localhost:50701`
+- API: `http://localhost:50700`
+- API Docs: `http://localhost:50700/api/docs`
+- MinIO Console: `http://localhost:9001`
+
+## Local Development
+
+```bash
+bun install
+
+# Start infrastructure only (use shared ai-core services or local docker)
+docker compose -f docker-compose.dev.yml up -d
+
+# Push database schema
+cd packages/db && bun run db:push && cd ../..
+
+# Start backend and frontend in separate terminals
+cd backend && bun run dev     # → localhost:50700
+cd frontend && bun run dev    # → localhost:50701
+```
+
+## Environment Variables
+
+Copy `.env.example` and fill in:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `DB_USER` | Yes | `aiuser` | PostgreSQL username |
+| `DB_PASSWORD` | Yes | `changeme` | PostgreSQL password |
+| `DB_NAME` | Yes | `hiai_docs` | Database name |
+| `DB_HOST` | Yes | `localhost` | PostgreSQL host |
+| `DB_PORT` | Yes | `5433` | PostgreSQL port |
+| `BETTER_AUTH_SECRET` | **Yes** | — | Random 32+ char string |
+| `BETTER_AUTH_URL` | Yes | `http://localhost:50700` | Public API URL |
+| `MINIO_ACCESS_KEY` | Yes | `minioadmin` | MinIO access key |
+| `MINIO_SECRET_KEY` | Yes | `minioadmin` | MinIO secret key |
+| `MINIO_BUCKET` | Yes | `hiai-docs` | MinIO bucket name |
+| `EMBEDDING_PROVIDER` | No | `ollama` | `ollama`, `openrouter`, or `voyage` |
+| `EMBEDDING_MODEL` | No | `nomic-embed-text` | Model name |
+| `OPENROUTER_API_KEY` | If fallback | — | OpenRouter API key |
+| `API_PORT` | No | `50700` | Backend port |
+| `WEB_PORT` | No | `50701` | Frontend port |
+| `NODE_ENV` | No | `development` | `development` or `production` |
+| `LOG_LEVEL` | No | `info` | `trace`/`debug`/`info`/`warn`/`error`/`fatal` |
+
+## Production Considerations
+
+### TLS
+
+Use Caddy (included) or a reverse proxy. The default Caddyfile routes:
+- `/api/*` → backend
+- `/*` → frontend
+
+For custom domains, update `Caddyfile` with your domain.
+
+### Backups
+
+```bash
+# Database
+docker compose exec postgres pg_dump -U aiuser hiai_docs > backup.sql
+
+# Restore
+cat backup.sql | docker compose exec -T postgres psql -U aiuser -d hiai_docs
+
+# MinIO attachments
+docker compose exec minio mc mirror /data ./backup-minio/
+```
+
+### Health Checks
+
+```bash
+curl -fsS http://localhost:50700/api/health
+# → {"status":"ok","timestamp":"..."}
+```
+
+## Database Migrations
+
+```bash
+# Generate migration from schema changes
+cd packages/db && bun run db:generate
+
+# Apply migration
+bun run db:migrate
+
+# Push schema directly (dev only)
+bun run db:push
+```
+
+## Services
+
+| Container | Port | Purpose |
+|-----------|------|---------|
+| postgres | 5433 | PostgreSQL 18 + pgvector |
+| redis | 6380 | Cache/queue |
+| ollama | 11434 | Embedding provider |
+| minio | 9000/9001 | S3-compatible file storage |
+| api | 50700 | Elysia REST API |
+| web | 50701 | SvelteKit frontend |
+| caddy | 80/443 | Reverse proxy |

package/docs/PRODUCTION_STATUS.md

@@ -0,0 +1,61 @@
+# Production Status Report
+
+> **Status:** ✅ READY FOR DEPLOYMENT
+> **Last verified:** 2026-06-14
+
+---
+
+## 1. Verification Results
+
+| Check | Status |
+|-------|--------|
+| Typecheck | ✅ PASS — 0 errors across all packages |
+| Tests | ✅ PASS — 178/178 passing |
+| Build | ✅ PASS — Docker multi-stage builds |
+| Health checks | ✅ PASS |
+
+## 2. Architecture
+
+10 route files: auth, documents, folders, search, share, tags, attachments, versions, webhooks, collaboration.
+
+Security: rate limiting, Zod validation, owner_id scoping, CSRF protection, CORS, security headers.
+
+## 3. Deployment
+
+```bash
+git clone https://github.com/hiai-gg/hiai-docs.git && cd hiai-docs
+cp .env.example .env
+docker compose pull && docker compose up -d
+docker compose exec api bun run db:migrate
+```
+
+### Ports
+
+| Port | Service |
+|------|---------|
+| 50700 | API |
+| 50701 | Frontend |
+| 5433 | PostgreSQL |
+| 6384 | Redis |
+| 9020 | MinIO S3 |
+| 80/443 | Caddy |
+
+## 4. Testing
+
+178 tests passing. Run: `bun test`, `cd backend && bun test`, `cd frontend && bun test`.
+
+## 5. Security Checklist
+
+Authentication, CSRF, rate limiting, Zod validation, owner scoping, CORS, HSTS, CSP, X-Frame-Options, password hashing (Argon2id), API key auth, non-root containers, parameterized queries — all in place.
+
+## 6. Known Issues
+
+- **Biome/Svelte 5:** 44 false-positive lint errors on Svelte 5 runes (non-blocking)
+- **Typebox pin:** required for Elysia 1.4.28 compatibility
+- **OPENROUTER_API_KEY:** placeholder, replace before production
+- **No E2E tests:** tracked in todo.md T6.3
+- **No automated backups:** operator responsibility
+
+---
+
+*Status: ✅ READY FOR DEPLOYMENT*

package/docs/openapi.json

@@ -0,0 +1,385 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "hiai-docs API",
+    "version": "0.1.0",
+    "description": "Self-hosted AI-first documentation platform. Full-text + semantic search, version history, sharing, and folder organization.",
+    "contact": {
+      "name": "hiai-gg",
+      "url": "https://github.com/hiai-gg/hiai-docs"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://opensource.org/licenses/MIT"
+    }
+  },
+  "servers": [
+    { "url": "http://localhost:50700", "description": "Local development" }
+  ],
+  "tags": [
+    { "name": "Health", "description": "Health check" },
+    { "name": "Auth", "description": "Authentication" },
+    { "name": "Documents", "description": "Document CRUD" },
+    { "name": "Folders", "description": "Folder management" },
+    { "name": "Tags", "description": "Tag management" },
+    { "name": "Versions", "description": "Document version history" },
+    { "name": "Search", "description": "Hybrid full-text + semantic search" },
+    { "name": "Share", "description": "Sharing and guest access" }
+  ],
+  "paths": {
+    "/api/health": {
+      "get": {
+        "tags": ["Health"],
+        "summary": "Health check",
+        "operationId": "getHealth",
+        "responses": {
+          "200": {
+            "description": "Service is healthy",
+            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }
+          }
+        }
+      }
+    },
+    "/api/documents": {
+      "get": {
+        "tags": ["Documents"],
+        "summary": "List documents",
+        "operationId": "listDocuments",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [
+          { "name": "folderId", "in": "query", "schema": { "type": "string", "format": "uuid" } },
+          { "name": "tag", "in": "query", "schema": { "type": "string", "format": "uuid" } },
+          { "name": "page", "in": "query", "schema": { "type": "integer", "default": 1, "minimum": 1 } },
+          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 } }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated list of documents",
+            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentListResponse" } } }
+          },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      },
+      "post": {
+        "tags": ["Documents"],
+        "summary": "Create document",
+        "operationId": "createDocument",
+        "security": [{ "sessionAuth": [] }],
+        "requestBody": {
+          "required": true,
+          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDocument" } } }
+        },
+        "responses": {
+          "201": { "description": "Document created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Document" } } } },
+          "400": { "$ref": "#/components/responses/BadRequest" },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/documents/{id}": {
+      "get": {
+        "tags": ["Documents"],
+        "summary": "Get document with tags",
+        "operationId": "getDocument",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "responses": {
+          "200": { "description": "Document details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentWithTags" } } } },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      },
+      "patch": {
+        "tags": ["Documents"],
+        "summary": "Update document (auto-saves version)",
+        "operationId": "updateDocument",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "requestBody": {
+          "required": true,
+          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateDocument" } } }
+        },
+        "responses": {
+          "200": { "description": "Document updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Document" } } } },
+          "400": { "$ref": "#/components/responses/BadRequest" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      },
+      "delete": {
+        "tags": ["Documents"],
+        "summary": "Delete document",
+        "operationId": "deleteDocument",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "responses": {
+          "200": { "description": "Document deleted" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/api/folders": {
+      "get": {
+        "tags": ["Folders"],
+        "summary": "List folders",
+        "operationId": "listFolders",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "parentId", "in": "query", "schema": { "type": "string", "format": "uuid" } }],
+        "responses": {
+          "200": { "description": "List of folders", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Folder" } } } } },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      },
+      "post": {
+        "tags": ["Folders"],
+        "summary": "Create folder",
+        "operationId": "createFolder",
+        "security": [{ "sessionAuth": [] }],
+        "requestBody": {
+          "required": true,
+          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFolder" } } }
+        },
+        "responses": {
+          "201": { "description": "Folder created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Folder" } } } },
+          "400": { "$ref": "#/components/responses/BadRequest" },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/folders/{id}": {
+      "patch": {
+        "tags": ["Folders"],
+        "summary": "Update folder",
+        "operationId": "updateFolder",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateFolder" } } } },
+        "responses": {
+          "200": { "description": "Folder updated" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      },
+      "delete": {
+        "tags": ["Folders"],
+        "summary": "Delete folder",
+        "operationId": "deleteFolder",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "responses": {
+          "200": { "description": "Folder deleted" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/api/tags": {
+      "get": {
+        "tags": ["Tags"],
+        "summary": "List tags with document counts",
+        "operationId": "listTags",
+        "security": [{ "sessionAuth": [] }],
+        "responses": {
+          "200": { "description": "List of tags", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TagWithCount" } } } } },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      },
+      "post": {
+        "tags": ["Tags"],
+        "summary": "Create tag",
+        "operationId": "createTag",
+        "security": [{ "sessionAuth": [] }],
+        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTag" } } } },
+        "responses": {
+          "201": { "description": "Tag created" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "409": { "description": "Tag name already exists" }
+        }
+      }
+    },
+    "/api/tags/{id}": {
+      "patch": {
+        "tags": ["Tags"],
+        "summary": "Update tag",
+        "operationId": "updateTag",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTag" } } } },
+        "responses": {
+          "200": { "description": "Tag updated" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      },
+      "delete": {
+        "tags": ["Tags"],
+        "summary": "Delete tag",
+        "operationId": "deleteTag",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "responses": {
+          "200": { "description": "Tag deleted" },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/documents/{id}/tags": {
+      "post": {
+        "tags": ["Tags"],
+        "summary": "Add tag to document",
+        "operationId": "addTagToDocument",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tagId": { "type": "string", "format": "uuid" } }, "required": ["tagId"] } } } },
+        "responses": {
+          "201": { "description": "Tag added" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/api/documents/{id}/tags/{tagId}": {
+      "delete": {
+        "tags": ["Tags"],
+        "summary": "Remove tag from document",
+        "operationId": "removeTagFromDocument",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [
+          { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } },
+          { "name": "tagId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }
+        ],
+        "responses": {
+          "200": { "description": "Tag removed" },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/documents/{id}/versions": {
+      "get": {
+        "tags": ["Versions"],
+        "summary": "List document versions",
+        "operationId": "listVersions",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
+        "responses": {
+          "200": { "description": "List of versions", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Version" } } } } },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/api/documents/{id}/versions/{vid}": {
+      "get": {
+        "tags": ["Versions"],
+        "summary": "Get specific version",
+        "operationId": "getVersion",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [
+          { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } },
+          { "name": "vid", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }
+        ],
+        "responses": {
+          "200": { "description": "Version details" },
+          "401": { "$ref": "#/components/responses/Unauthorized" },
+          "404": { "$ref": "#/components/responses/NotFound" }
+        }
+      }
+    },
+    "/api/search": {
+      "get": {
+        "tags": ["Search"],
+        "summary": "Hybrid full-text + semantic search",
+        "operationId": "search",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [
+          { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query" },
+          { "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
+          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20, "maximum": 100 } }
+        ],
+        "responses": {
+          "200": { "description": "Search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" } } } },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/search/suggest": {
+      "get": {
+        "tags": ["Search"],
+        "summary": "Title autocomplete suggestions",
+        "operationId": "searchSuggest",
+        "security": [{ "sessionAuth": [] }],
+        "parameters": [{ "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }],
+        "responses": {
+          "200": { "description": "Suggestions", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/SearchSuggestion" } } } } },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/share/link": {
+      "post": {
+        "tags": ["Share"],
+        "summary": "Create share link",
+        "operationId": "createShareLink",
+        "security": [{ "sessionAuth": [] }],
+        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShareLink" } } } },
+        "responses": {
+          "201": { "description": "Share link created" },
+          "401": { "$ref": "#/components/responses/Unauthorized" }
+        }
+      }
+    },
+    "/api/share/{token}": {
+      "get": {
+        "tags": ["Share"],
+        "summary": "Access shared document/folder (public)",
+        "operationId": "accessShareLink",
+        "parameters": [
+          { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } },
+          { "name": "password", "in": "query", "schema": { "type": "string" } }
+        ],
+        "responses": {
+          "200": { "description": "Shared content" },
+          "401": { "description": "Password required or invalid" },
+          "404": { "$ref": "#/components/responses/NotFound" },
+          "429": { "description": "Rate limited" }
+        }
+      }
+    }
+  },
+  "components": {
+    "securitySchemes": {
+      "sessionAuth": {
+        "type": "apiKey",
+        "in": "cookie",
+        "name": "better-auth.session_token",
+        "description": "Session cookie from Better Auth"
+      }
+    },
+    "responses": {
+      "Unauthorized": { "description": "Authentication required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "Unauthorized" } } } } } },
+      "BadRequest": { "description": "Invalid input", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "details": { "type": "object" } } } } } },
+      "NotFound": { "description": "Resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "Document not found" } } } } } }
+    },
+    "schemas": {
+      "HealthResponse": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "timestamp": { "type": "string", "format": "date-time" } } },
+      "Document": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "ownerId": { "type": "string", "format": "uuid" }, "folderId": { "type": "string", "format": "uuid", "nullable": true }, "title": { "type": "string" }, "content": { "type": "string" }, "contentJson": { "nullable": true }, "metadata": { "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } },
+      "DocumentWithTags": { "allOf": [{ "$ref": "#/components/schemas/Document" }, { "type": "object", "properties": { "tags": { "type": "array", "items": { "$ref": "#/components/schemas/Tag" } } } }] },
+      "DocumentListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Document" } }, "total": { "type": "integer" }, "page": { "type": "integer" }, "limit": { "type": "integer" } } },
+      "CreateDocument": { "type": "object", "properties": { "title": { "type": "string", "default": "Untitled" }, "content": { "type": "string" }, "folderId": { "type": "string", "format": "uuid" } } },
+      "UpdateDocument": { "type": "object", "properties": { "title": { "type": "string" }, "content": { "type": "string" }, "contentJson": {}, "metadata": {}, "folderId": { "type": "string", "format": "uuid", "nullable": true } } },
+      "Folder": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "ownerId": { "type": "string", "format": "uuid" }, "parentId": { "type": "string", "format": "uuid", "nullable": true }, "name": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } },
+      "CreateFolder": { "type": "object", "required": ["name"], "properties": { "name": { "type": "string" }, "parentId": { "type": "string", "format": "uuid" } } },
+      "UpdateFolder": { "type": "object", "properties": { "name": { "type": "string" }, "parentId": { "type": "string", "format": "uuid", "nullable": true } } },
+      "Tag": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "color": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" } } },
+      "TagWithCount": { "allOf": [{ "$ref": "#/components/schemas/Tag" }, { "type": "object", "properties": { "documentCount": { "type": "integer" } } }] },
+      "CreateTag": { "type": "object", "required": ["name"], "properties": { "name": { "type": "string" }, "color": { "type": "string" } } },
+      "UpdateTag": { "type": "object", "properties": { "name": { "type": "string" }, "color": { "type": "string" } } },
+      "Version": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "documentId": { "type": "string", "format": "uuid" }, "content": { "type": "string" }, "contentJson": { "nullable": true }, "createdBy": { "type": "string", "format": "uuid" }, "createdAt": { "type": "string", "format": "date-time" } } },
+      "SearchResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/SearchResult" } }, "total": { "type": "integer" }, "page": { "type": "integer" }, "limit": { "type": "integer" } } },
+      "SearchResult": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "snippet": { "type": "string" }, "score": { "type": "number" }, "folder_id": { "type": "string", "format": "uuid", "nullable": true }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } } },
+      "SearchSuggestion": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "score": { "type": "number" } } },
+      "CreateShareLink": { "type": "object", "properties": { "documentId": { "type": "string", "format": "uuid" }, "folderId": { "type": "string", "format": "uuid" }, "password": { "type": "string" }, "expiresIn": { "type": "integer", "description": "Seconds until expiration" } } }
+    }
+  }
+}