ขอบคุณที่สมัครสมาชิก
',\n 'ยินดีต้อนรับสู่ระบบ',\n 'user@example.com',\n { text_body: 'ยินดีต้อนรับ ขอบคุณที่สมัครสมาชิก' },\n);\n\n// Todo Management\nconst todo = await authClient.todo.create({\n title: 'ซื้อของใช้ในบ้าน',\n priority: 'normal',\n user_id: 'user-123',\n description: 'ซื้อน้ำยาล้างจาน, กระดาษทิชชู่',\n due_date: new Date('2024-01-20'),\n category: 'shopping',\n labels: ['บ้าน', 'จำเป็น'],\n is_send_notification: true,\n});\n\n// Workflow Management\n// Create workflow instance\nconst workflowInstance = await authClient.workflow.createInstance({\n workflow_definition_id: 'wf-def-123',\n document_id: 'doc-123',\n document_type: 'purchase_request',\n document_title: 'ขอซื้อคอมพิวเตอร์',\n priority: 'high',\n form_data: { amount: 150000, items: ['Laptop', 'Monitor'] },\n});\n\n// Get user tasks\nconst userTasks = await authClient.workflow.getUserTasks({\n status: ['assigned', 'in_progress'],\n page: 1,\n limit: 20,\n});\n\n// Perform task action (approve/reject/delegate)\nawait authClient.workflow.performTaskAction('task-123', {\n action_key: 'approve',\n comments: 'อนุมัติตามขั้นตอน',\n});\n\n// Organization Management\n// Search organizations\nconst organizations = await authClient.organization.search({\n search: 'แผนก',\n page: 1,\n limit: 20,\n});\n\n// Get organization hierarchy\nconst ancestors = await authClient.organization.getAncestors('org-123');\nconst reportingLine = await authClient.organization.getReportingLine('org-123');\nconst users = await authClient.organization.getUsers('org-123', true); // include descendants\n\n// Webhook Proxy (for external applications)\n// Send webhook through proxy\nconst webhookResult = await authClient.webhook.proxy({\n webhook_url: 'https://api.example.com/webhooks/users',\n event_type: 'user.created',\n payload: { data: { id: 'user-123', email: 'user@example.com' } },\n headers: { Authorization: 'Bearer token' },\n secret: 'webhook-secret',\n timeout_ms: 30000,\n max_retries: 3,\n});\n\n// Check webhook status\nconst webhookLog = await authClient.webhook.getStatus(webhookResult.webhook_log_id);\nconsole.log('Status:', webhookLog.status); // 'success', 'failed', 'pending'\n```\n\n**For custom endpoints, use direct HTTP methods:**\n\n```typescript\n// GET request\nconst response = await authClient.get('/api/v1/custom/endpoint');\n\n// POST request\nconst response = await authClient.post('/api/v1/custom/endpoint', data);\n```\n\n#### 3. Use with Next.js API Routes\n\n```typescript\n// app/api/users/route.ts\nimport { NextRequest, NextResponse } from 'next/server';\nimport authClient from '@/lib/auth-client';\n\nexport async function GET(request: NextRequest) {\n try {\n const response = await authClient.post('/api/v1/users/search', {\n page: 1,\n page_size: 20,\n });\n return NextResponse.json(response.data);\n } catch (error: any) {\n return NextResponse.json(\n { error: error.response?.data?.message || 'Failed to fetch users' },\n { status: error.response?.status || 500 },\n );\n }\n}\n```\n\n#### 4. Environment Variables\n\n```env\n# .env.local\nNEXT_PUBLIC_API_KEY=app_your_api_key_here\nNEXT_PUBLIC_API_URL=https://api.yourdomain.com\n```\n\n---\n\n## Backend Middleware (Express & NestJS)\n\nThe SDK provides middleware for **Express** and **Guards** for **NestJS** to easily authenticate requests using JWT tokens.\n\n### Quick Start - Express\n\n```typescript\nimport express from 'express';\nimport { authMiddleware } from '@win-portal/auth-sdk';\n\nconst app = express();\n\n// Apply middleware globally\napp.use(\n authMiddleware({\n baseURL: 'https://api.example.com',\n apiKey: 'your-api-key',\n }),\n);\n\n// Now all routes have access to req.user and req.token\napp.get('/profile', (req, res) => {\n const user = req.user; // User\n res.json({\n email: user.email,\n permissions: user.permissions,\n });\n});\n```\n\n### Quick Start - NestJS\n\n```typescript\n// auth/guards/auth.guard.ts\nimport { createAuthGuard } from '@win-portal/auth-sdk';\n\nexport const AuthGuard = createAuthGuard({\n baseURL: process.env.API_BASE_URL!,\n apiKey: process.env.API_KEY!,\n});\n\n// In controller\n@Controller('users')\nexport class UsersController {\n @Get('profile')\n @UseGuards(AuthGuard)\n getProfile(@CurrentUser() user: User) {\n return user;\n }\n}\n```\n\n### 📖 Complete Middleware Documentation\n\nFor complete documentation, examples, and advanced usage:\n\n**[View Full Middleware Guide →](./docs/middleware/usage.md)**\n\nIncludes:\n\n- Express middleware configuration\n- NestJS guards and decorators\n- Optional authentication\n- Custom token extractors\n- Cache management\n- Permission checking patterns\n- Full working examples\n\n---\n\n## Backend (NestJS - API Client)\n\nFor template-api that needs to call main API:\n\n```typescript\nimport { AuthClient } from '@win-portal/auth-sdk';\nimport { Injectable } from '@nestjs/common';\n\n@Injectable()\nexport class ExternalApiService {\n private authClient: AuthClient;\n\n constructor() {\n this.authClient = new AuthClient({\n apiKey: process.env.MAIN_API_KEY!,\n baseURL: process.env.MAIN_API_URL,\n });\n }\n\n async fetchFromMainApi() {\n const response = await this.authClient.get('/api/v1/resources');\n return response.data;\n }\n}\n```\n\n## API Reference\n\n### `AuthClient`\n\nHTTP client with automatic API key injection.\n\n```typescript\nconst client = new AuthClient({\n apiKey: string; // Required: Your API key\n baseURL?: string; // Optional: Base URL for requests\n apiKeyHeader?: string; // Optional: Custom header name (default: 'X-API-Key')\n timeout?: number; // Optional: Request timeout (default: 30000ms)\n advanced?: { // Optional: Advanced configuration\n refreshTimeoutMs?: number; // Refresh token timeout (default: 5000ms)\n }\n})\n```\n\n**Advanced Configuration:**\n\n```typescript\n// ปรับแต่ง performance และ timeout settings\nconst client = new AuthClient({\n apiKey: 'your-api-key',\n baseURL: 'https://api.example.com',\n advanced: {\n refreshTimeoutMs: 10000, // เพิ่ม timeout สำหรับ slow network\n },\n});\n```\n\n#### HTTP Methods\n\n- `get