@winwinmbs/portal-api 1.0.0

package/dist/_tsup-dts-rollup.d.ts

@@ -0,0 +1,4113 @@
+import type { AxiosInstance } from 'axios';
+import { AxiosRequestConfig } from 'axios';
+import { AxiosResponse } from 'axios';
+
+/**
+ * Actor types
+ */
+declare enum ActorType {
+    USER = 'user',
+    SYSTEM = 'system',
+    SERVICE = 'service',
+    API_CLIENT = 'api_client',
+    SCHEDULER = 'scheduler',
+    WEBHOOK = 'webhook',
+}
+export { ActorType }
+export { ActorType as ActorType_alias_1 }
+export { ActorType as ActorType_alias_2 }
+
+declare type ActorTypeType = `${ActorType}`;
+export { ActorTypeType }
+export { ActorTypeType as ActorTypeType_alias_1 }
+export { ActorTypeType as ActorTypeType_alias_2 }
+
+/**
+ * API Paginated Response Interface
+ *
+ * @description Interface สำหรับ response ที่มีข้อมูลแบบ paginated พร้อม pagination metadata
+ * ใช้สำหรับ API endpoints ที่ส่งข้อมูลเป็น list พร้อม pagination
+ *
+ * @properties
+ * - data: array ของข้อมูลที่ส่งกลับ (required)
+ * - pagination: ข้อมูล pagination metadata (required)
+ * - success: สถานะความสำเร็จ (inherited)
+ * - message: ข้อความตอบกลับ (inherited, optional)
+ * - errors: รายการ error messages (inherited, optional)
+ * - timestamp: วันเวลาที่ response (inherited)
+ * - meta: metadata เพิ่มเติม (inherited, optional)
+ *
+ * @example
+ * ```typescript
+ * const usersResponse: ApiPaginatedResponse<IUser> = {
+ *   success: true,
+ *   data: [
+ *     {
+ *       id: "123",
+ *       first_name: "สมชาย",
+ *       last_name: "ใจดี",
+ *       email: "somchai@example.com"
+ *     },
+ *     {
+ *       id: "456",
+ *       first_name: "สมหญิง",
+ *       last_name: "รักดี",
+ *       email: "somying@example.com"
+ *     }
+ *   ],
+ *   pagination: {
+ *     page: 1,
+ *     limit: 20,
+ *     total: 100,
+ *     total_pages: 5,
+ *     has_next: true,
+ *     has_prev: false
+ *   },
+ *   message: "ดึงรายการผู้ใช้สำเร็จ",
+ *   timestamp: "2024-01-15T10:30:00Z"
+ * }
+ * ```
+ *
+ * Usage:
+ * import { ApiPaginatedResponse } from '@win-portal/shared/interfaces/helpers/api-paginated-response.interface';
+ */
+declare interface ApiPaginatedResponse<T> extends BaseApiResponse {
+    data: T[];
+    pagination: PaginationMeta;
+}
+export { ApiPaginatedResponse }
+export { ApiPaginatedResponse as ApiPaginatedResponse_alias_1 }
+
+/**
+ * API Response Interface
+ *
+ * @description Generic interface สำหรับ wrap ข้อมูลใน API response พร้อม base response structure
+ * ใช้สำหรับ response ที่มีข้อมูลเดี่ยวหรือไม่มี pagination
+ *
+ * @properties
+ * - data: ข้อมูลที่ส่งกลับ (optional)
+ * - success: สถานะความสำเร็จ (inherited)
+ * - message: ข้อความตอบกลับ (inherited, optional)
+ * - errors: รายการ error messages (inherited, optional)
+ * - timestamp: วันเวลาที่ response (inherited)
+ * - meta: metadata เพิ่มเติม (inherited, optional)
+ *
+ * @example
+ * ```typescript
+ * const userResponse: ApiResponse<IUser> = {
+ *   success: true,
+ *   data: {
+ *     id: "123",
+ *     first_name: "สมชาย",
+ *     last_name: "ใจดี",
+ *     email: "somchai@example.com"
+ *   },
+ *   message: "ดึงข้อมูลผู้ใช้สำเร็จ",
+ *   timestamp: "2024-01-15T10:30:00Z"
+ * }
+ *
+ * const errorResponse: ApiResponse<null> = {
+ *   success: false,
+ *   data: null,
+ *   errors: ["ไม่พบข้อมูลผู้ใช้"],
+ *   timestamp: "2024-01-15T10:30:00Z"
+ * }
+ * ```
+ *
+ * Usage:
+ * import { ApiResponse } from '@win-portal/shared/interfaces/helpers/api-response.interface';
+ */
+declare interface ApiResponse<T> extends BaseApiResponse {
+    data?: T;
+}
+export { ApiResponse }
+export { ApiResponse as ApiResponse_alias_1 }
+
+/**
+ * Assignment Response - ผลลัพธ์จากการมอบหมาย/ยกเลิกการมอบหมาย
+ *
+ * @note Diverges from @win-portal/shared `AssignmentResponseDto`. This SDK
+ * shape tracks `assigned / unassigned / total` counts, while the server DTO
+ * tracks `assigned_count / failed_count / total_count` plus per-item detail.
+ * Kept local to reflect the simplified summary the SDK exposes to callers.
+ */
+declare interface AssignmentResponse {
+    assigned?: number;
+    unassigned?: number;
+    total?: number;
+}
+export { AssignmentResponse }
+export { AssignmentResponse as AssignmentResponse_alias_1 }
+export { AssignmentResponse as AssignmentResponse_alias_2 }
+
+/**
+ * Assign Positions Request - ข้อมูลสำหรับการมอบหมายตำแหน่งให้ผู้ใช้
+ *
+ * Structurally identical to `@win-portal/shared` `AssignPositionsRequestDto`.
+ * Kept local so api-extractor can inline the shape into the published dts.
+ *
+ * @example
+ * ```json
+ * {
+ *   "positions": [
+ *     { "position_id": "pos-123", "is_primary": true },
+ *     { "position_id": "pos-456", "is_primary": false }
+ *   ],
+ *   "mode": "replace"
+ * }
+ * ```
+ */
+declare interface AssignPositionsRequest {
+    positions: UserPositionAssignment[];
+    mode?: 'add' | 'replace';
+}
+export { AssignPositionsRequest }
+export { AssignPositionsRequest as AssignPositionsRequest_alias_1 }
+export { AssignPositionsRequest as AssignPositionsRequest_alias_2 }
+
+/**
+ * Base API Response Interface
+ *
+ * @description Interface พื้นฐานสำหรับ response ของ API endpoints ทั้งหมด
+ * รวมถึงสถานะความสำเร็จ ข้อความ และ metadata
+ *
+ * @properties
+ * - success: สถานะความสำเร็จ (required)
+ * - message: ข้อความตอบกลับ (optional)
+ * - errors: รายการ error messages (optional)
+ * - timestamp: วันเวลาที่ response (required)
+ * - meta: metadata เพิ่มเติม (optional)
+ *
+ * @example
+ * ```typescript
+ * const baseResponse: BaseApiResponse = {
+ *   success: true,
+ *   message: "บันทึกข้อมูลเรียบร้อย",
+ *   timestamp: "2024-01-15T10:30:00Z",
+ *   meta: {
+ *     version: "1.0",
+ *     request_id: "req-123"
+ *   }
+ * }
+ * ```
+ *
+ * Usage:
+ * import { BaseApiResponse } from '@win-portal/shared/interfaces/helpers/base-api-response.interface';
+ */
+declare interface BaseApiResponse {
+    success: boolean;
+    message?: string;
+    errors?: string[];
+    timestamp: string;
+    meta?: {
+        [key: string]: any;
+    };
+}
+
+/**
+ * Bulk Create Organization Request - สร้างหลายรายการในครั้งเดียว
+ */
+declare interface BulkCreateOrganizationRequest {
+    organizations: CreateOrganizationRequest[];
+    /** ข้าม rebuild-all หลังสร้าง (default: false) */
+    skip_rebuild?: boolean;
+}
+export { BulkCreateOrganizationRequest }
+export { BulkCreateOrganizationRequest as BulkCreateOrganizationRequest_alias_1 }
+export { BulkCreateOrganizationRequest as BulkCreateOrganizationRequest_alias_2 }
+
+/**
+ * Bulk Create Organization Response
+ */
+declare interface BulkCreateOrganizationResponse {
+    created: number;
+    errors: {
+        index: number;
+        message: string;
+    }[];
+    execution_time_ms: number;
+}
+export { BulkCreateOrganizationResponse }
+export { BulkCreateOrganizationResponse as BulkCreateOrganizationResponse_alias_1 }
+export { BulkCreateOrganizationResponse as BulkCreateOrganizationResponse_alias_2 }
+
+/**
+ * Bulk Create Permission Category Item - รองรับ id เพื่อให้ child อ้างอิง parent_id ใน batch เดียวกัน
+ */
+declare interface BulkCreatePermissionCategoryItem extends CreatePermissionCategoryRequest {
+    /** Optional: หากระบุจะใช้ id นี้ (สำหรับให้ child อ้างอิง parent_id ใน batch เดียวกัน) */
+    id?: string;
+}
+export { BulkCreatePermissionCategoryItem }
+export { BulkCreatePermissionCategoryItem as BulkCreatePermissionCategoryItem_alias_1 }
+export { BulkCreatePermissionCategoryItem as BulkCreatePermissionCategoryItem_alias_2 }
+
+/**
+ * Bulk Create Permission Category Request
+ */
+declare interface BulkCreatePermissionCategoryRequest {
+    permission_categories: BulkCreatePermissionCategoryItem[];
+}
+export { BulkCreatePermissionCategoryRequest }
+export { BulkCreatePermissionCategoryRequest as BulkCreatePermissionCategoryRequest_alias_1 }
+export { BulkCreatePermissionCategoryRequest as BulkCreatePermissionCategoryRequest_alias_2 }
+
+/**
+ * Bulk Create Permission Request
+ */
+declare interface BulkCreatePermissionRequest {
+    permissions: CreatePermissionRequest[];
+}
+export { BulkCreatePermissionRequest }
+export { BulkCreatePermissionRequest as BulkCreatePermissionRequest_alias_1 }
+export { BulkCreatePermissionRequest as BulkCreatePermissionRequest_alias_2 }
+
+/**
+ * Bulk Create Response - ใช้ร่วมกับ permission และ permission-category
+ */
+declare interface BulkCreateResponse {
+    created: number;
+    errors: {
+        index: number;
+        message: string;
+    }[];
+    execution_time_ms: number;
+}
+export { BulkCreateResponse }
+export { BulkCreateResponse as BulkCreateResponse_alias_1 }
+export { BulkCreateResponse as BulkCreateResponse_alias_2 }
+
+/**
+ * Bulk Operation Response - ผลลัพธ์จาก bulk operations
+ */
+declare interface BulkOperationResponse {
+    success_count: number;
+    fail_count: number;
+}
+export { BulkOperationResponse }
+export { BulkOperationResponse as BulkOperationResponse_alias_1 }
+export { BulkOperationResponse as BulkOperationResponse_alias_2 }
+
+/**
+ * Clear All Data Response - ผลลัพธ์จากการลบข้อมูลองค์กรทั้งหมด
+ *
+ * @description ใช้กับ organization.clearAll() - ลบ user_position_assignment, organization_closure,
+ * organization และ nullify references ใน workflow/document tables
+ */
+declare interface ClearAllDataResponse {
+    user_position_assignments_deleted: number;
+    organization_closure_deleted: number;
+    organizations_deleted: number;
+    workflow_references_nullified: number;
+    document_references_cleared: number;
+}
+export { ClearAllDataResponse }
+export { ClearAllDataResponse as ClearAllDataResponse_alias_1 }
+export { ClearAllDataResponse as ClearAllDataResponse_alias_2 }
+
+/**
+ * Create Event Log Request DTO
+ *
+ * Complete interface for creating event logs
+ */
+declare interface CreateEventLogRequestDto {
+    source: string;
+    event_type: string;
+    subject?: string;
+    event_time?: Date | string;
+    application_id?: string | null;
+    application_code?: string;
+    severity?: EventSeverity;
+    outcome?: EventOutcome;
+    category?: EventCategory;
+    risk_level?: EventRiskLevel;
+    actor?: IEventLogActor;
+    target?: IEventLogTarget;
+    action?: string;
+    message?: string;
+    before_state?: Record<string, any>;
+    after_state?: Record<string, any>;
+    changed_fields?: Record<string, any>;
+    metadata?: Record<string, any>;
+    tags?: string[];
+    error?: IEventLogError;
+    trace_id?: string;
+    span_id?: string;
+    parent_span_id?: string;
+    trace_flags?: string;
+    correlation_id?: string;
+    request_id?: string;
+    business_reason?: string;
+    application_version?: string;
+    service_version?: string;
+    performance?: {
+        duration_ms?: number;
+        resource_usage?: Record<string, any>;
+    };
+    requires_approval?: boolean;
+    approval?: {
+        required: boolean;
+        approved_by?: string;
+        approved_at?: Date;
+        rejected_by?: string;
+        rejected_at?: Date;
+        reason?: string;
+    };
+    review?: {
+        required: boolean;
+        reviewed_by?: string;
+        reviewed_at?: Date;
+        status?: 'pending' | 'approved' | 'rejected';
+        notes?: string;
+    };
+    retention_period?: string;
+    expires_at?: Date;
+}
+export { CreateEventLogRequestDto }
+export { CreateEventLogRequestDto as CreateEventLogRequestDto_alias_1 }
+export { CreateEventLogRequestDto as CreateEventLogRequestDto_alias_2 }
+
+/**
+ * Create Organization Request
+ */
+declare interface CreateOrganizationRequest {
+    id?: string;
+    name: string;
+    code: string;
+    type: OrganizationType | string;
+    parent_id?: string;
+    description?: string;
+    logo_file_id?: string;
+    report_to_position_id?: string;
+}
+export { CreateOrganizationRequest }
+export { CreateOrganizationRequest as CreateOrganizationRequest_alias_1 }
+export { CreateOrganizationRequest as CreateOrganizationRequest_alias_2 }
+
+/**
+ * Create Permission Category Request
+ *
+ * @note application_id - Optional เมื่อเรียกจาก app context (API key หรือ RequestContext)
+ * API จะ inject application_id อัตโนมัติจาก API key หรือ RequestContextService
+ */
+declare interface CreatePermissionCategoryRequest {
+    /** Optional: หากระบุจะใช้ id นี้แทนการ generate ใหม่ (สำหรับ import/migration หรือให้ child อ้างอิง parent_id) */
+    id?: string;
+    /** Optional: API จะ inject จาก API key หรือ RequestContextService เมื่อมี context */
+    application_id?: string;
+    key: string;
+    name: string;
+    description?: string;
+    resource?: string;
+    parent_id?: string;
+    permissions?: Omit<CreatePermissionRequest, 'category_id'>[];
+}
+export { CreatePermissionCategoryRequest }
+export { CreatePermissionCategoryRequest as CreatePermissionCategoryRequest_alias_1 }
+export { CreatePermissionCategoryRequest as CreatePermissionCategoryRequest_alias_2 }
+
+/**
+ * Create Permission Request
+ */
+declare interface CreatePermissionRequest {
+    /** Optional: หากระบุจะใช้ id นี้แทนการ generate ใหม่ (สำหรับ import/migration) */
+    id?: string;
+    category_id: string;
+    name: string;
+    key: string;
+    description?: string;
+    application_id?: string;
+}
+export { CreatePermissionRequest }
+export { CreatePermissionRequest as CreatePermissionRequest_alias_1 }
+export { CreatePermissionRequest as CreatePermissionRequest_alias_2 }
+
+/**
+ * Create Role Request - ข้อมูลสำหรับสร้างบทบาทใหม่
+ */
+declare interface CreateRoleRequest {
+    /** Optional: หากระบุจะใช้ id นี้แทนการ generate ใหม่ (สำหรับ import/migration) */
+    id?: string;
+    name: string;
+    code: string;
+    description?: string;
+}
+export { CreateRoleRequest }
+export { CreateRoleRequest as CreateRoleRequest_alias_1 }
+export { CreateRoleRequest as CreateRoleRequest_alias_2 }
+
+/**
+ * Create Todo Request
+ *
+ * @description Request data for creating a new todo
+ *
+ * @properties
+ * - title: หัวข้องาน (required) ชื่อหรือหัวข้อของงานที่ต้องทำ
+ * - description: รายละเอียดงาน (optional) คำอธิบายเพิ่มเติมของงาน
+ * - due_date: วันครบกำหนด (optional) วันที่ต้องเสร็จงาน
+ * - priority: ระดับความสำคัญ (required) เช่น low, normal, high
+ * - category: หมวดหมู่ (optional) เช่น "work", "personal", "shopping"
+ * - labels: ป้ายกำกับ (optional) tags สำหรับการค้นหาและจัดกลุ่ม
+ * - link_url: ลิงก์อ้างอิง (optional) URL ที่เกี่ยวข้องกับงาน
+ * - metadata: ข้อมูลเพิ่มเติม (optional) object สำหรับเก็บข้อมูลที่เกี่ยวข้อง
+ * - is_send_notification: ส่งการแจ้งเตือน (optional) default = true
+ * - user_id: รหัสผู้ใช้ (required) user ID ที่เป็นเจ้าของ todo
+ * - parent_id: รหัส parent todo (optional) สำหรับสร้าง sub-task
+ * - order: ลำดับ sub-task (optional) สำหรับเรียง sub-tasks
+ * - assigned_to_id: ผู้รับผิดชอบหลัก (optional) user ID ของผู้ที่ต้องทำงาน
+ *
+ * @example
+ * ```typescript
+ * const todo = await authClient.todo.create({
+ *   title: "ซื้อของใช้ในบ้าน",
+ *   description: "ซื้อน้ำยาล้างจาน, กระดาษทิชชู่, แชมพู",
+ *   due_date: new Date("2024-01-20T17:00:00Z"),
+ *   priority: TodoPriority.NORMAL,
+ *   category: "shopping",
+ *   labels: ["บ้าน", "จำเป็น"],
+ *   link_url: "https://www.bigc.co.th/shopping-list",
+ *   user_id: "user123e4567-e89b-12d3-a456-426614174000",
+ *   is_send_notification: true
+ * });
+ * ```
+ */
+declare interface CreateTodoRequest {
+    title: string;
+    priority: TodoPriority;
+    user_id: string;
+    description?: string;
+    due_date?: Date | string;
+    category?: string;
+    labels?: string[];
+    link_url?: string;
+    metadata?: Record<string, any>;
+    is_send_notification?: boolean;
+    parent_id?: string;
+    order?: number;
+    assigned_to_id?: string;
+}
+export { CreateTodoRequest }
+export { CreateTodoRequest as CreateTodoRequest_alias_1 }
+export { CreateTodoRequest as CreateTodoRequest_alias_2 }
+
+/**
+ * Create User Request - ข้อมูลสำหรับสร้างผู้ใช้ใหม่
+ * Matches CreateUserRequestDto from @win-portal/shared
+ *
+ * @description ถ้าไม่ระบุ password ระบบจะ auto generate และส่ง reset password link ไปทางอีเมล
+ * ถ้าระบุ password ระบบจะใช้ password ที่ส่งมาและส่ง welcome email พร้อม login link
+ */
+declare interface CreateUserRequest {
+    email: string;
+    username?: string;
+    first_name: string;
+    last_name: string;
+    first_name_en?: string;
+    last_name_en?: string;
+    code?: string;
+    phone_number?: string;
+    avatar_file_id?: string;
+    signature_file_id?: string;
+    password?: string;
+    ignore_password_policies?: boolean;
+    role_ids?: string[];
+    metadata?: Record<string, any>;
+    id?: string;
+}
+export { CreateUserRequest }
+export { CreateUserRequest as CreateUserRequest_alias_1 }
+export { CreateUserRequest as CreateUserRequest_alias_2 }
+
+/**
+ * Create Workflow Instance Request
+ */
+declare interface CreateWorkflowInstanceRequest {
+    workflow_definition_id: string;
+    document_id: string;
+    document_type: string;
+    document_title: string;
+    document_url?: string;
+    priority: 'low' | 'normal' | 'high' | 'urgent';
+    position_id: string;
+    form_data: Record<string, any>;
+    context_variables?: Record<string, any>;
+    workflow_config?: Record<string, any>;
+    auto_start?: boolean;
+    due_date_override?: Date;
+    user_id: string;
+}
+export { CreateWorkflowInstanceRequest }
+export { CreateWorkflowInstanceRequest as CreateWorkflowInstanceRequest_alias_1 }
+export { CreateWorkflowInstanceRequest as CreateWorkflowInstanceRequest_alias_2 }
+
+/**
+ * Email API
+ *
+ * @example
+ * ```typescript
+ * // Template Mode
+ * const result = await authClient.email.sendEmail({
+ *   template_code: 'welcome_email',
+ *   template_data: {
+ *     userName: 'สมชาย ใจดี',
+ *     activationLink: 'https://app.com/activate?token=xxx'
+ *   },
+ *   recipient_email: 'user@example.com',
+ *   recipient_name: 'สมชาย ใจดี',
+ *   language: 'th',
+ *   cc: ['manager@example.com'],
+ *   attachments: [
+ *     {
+ *       filename: 'welcome.pdf',
+ *       href: 'https://api.example.com/files/123e4567-e89b-12d3-a456-426614174000/content' // URL จาก File API
+ *     }
+ *   ]
+ * });
+ *
+ * // Raw HTML Mode
+ * const result = await authClient.email.sendEmail({
+ *   html_body: '<h1>ยินดีต้อนรับ</h1><p>ขอบคุณที่สมัครสมาชิก</p>',
+ *   subject: 'ยินดีต้อนรับสู่ระบบ',
+ *   recipient_email: 'user@example.com',
+ *   recipient_name: 'สมชาย ใจดี',
+ *   text_body: 'ยินดีต้อนรับ ขอบคุณที่สมัครสมาชิก',
+ *   cc: ['manager@example.com'],
+ *   bcc: ['archive@example.com']
+ * });
+ * ```
+ */
+declare class EmailAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Send email (auto-detect Template Mode or Raw HTML Mode)
+     *
+     * @param request - SendEmailRequest
+     * @returns SendEmailResponse
+     *
+     * @example
+     * ```typescript
+     * // Template Mode
+     * const result = await authClient.email.sendEmail({
+     *   template_code: 'welcome_email',
+     *   template_data: { userName: 'John' },
+     *   recipient_email: 'user@example.com'
+     * });
+     *
+     * // Raw HTML Mode
+     * const result = await authClient.email.sendEmail({
+     *   html_body: '<h1>Hello</h1>',
+     *   subject: 'Welcome',
+     *   recipient_email: 'user@example.com'
+     * });
+     * ```
+     */
+    sendEmail(request: SendEmailRequest): Promise<SendEmailResponse>;
+    /**
+     * Send email with template (Template Mode - convenience method)
+     *
+     * @param templateCode - Template code from database
+     * @param templateData - Template data for rendering
+     * @param recipient - Email address or user ID
+     * @param options - Additional options (cc, bcc, attachments, etc.)
+     * @returns SendEmailResponse
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.email.sendEmailWithTemplate(
+     *   'welcome_email',
+     *   {
+     *     userName: 'สมชาย ใจดี',
+     *     activationLink: 'https://app.com/activate?token=xxx'
+     *   },
+     *   'user@example.com',
+     *   {
+     *     recipient_name: 'สมชาย ใจดี',
+     *     language: 'th',
+     *     cc: ['manager@example.com'],
+     *     attachments: [
+     *       {
+     *         filename: 'welcome.pdf',
+     *         href: 'https://storage.azure.com/container/welcome.pdf' // URL จาก cloud storage
+     *       }
+     *     ]
+     *   }
+     * );
+     * ```
+     */
+    sendEmailWithTemplate(templateCode: string, templateData: Record<string, any>, recipient: string, options?: {
+        recipient_name?: string;
+        recipient_id?: string;
+        language?: 'th' | 'en';
+        subject?: string;
+        cc?: string | string[];
+        bcc?: string | string[];
+        attachments?: Array<{
+            filename: string;
+            href: string;
+            content_type?: string;
+        }>;
+        priority?: 'low' | 'normal' | 'high' | 'urgent';
+        scheduled_at?: Date | string;
+        source?: string;
+        related_entity_id?: string;
+        related_entity_type?: string;
+    }): Promise<SendEmailResponse>;
+    /**
+     * Send email with raw HTML (Raw HTML Mode - convenience method)
+     *
+     * @param htmlBody - HTML content
+     * @param subject - Email subject
+     * @param recipient - Email address or user ID
+     * @param options - Additional options (text_body, cc, bcc, attachments, etc.)
+     * @returns SendEmailResponse
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.email.sendRawEmail(
+     *   '<h1>ยินดีต้อนรับ</h1><p>ขอบคุณที่สมัครสมาชิก</p>',
+     *   'ยินดีต้อนรับสู่ระบบ',
+     *   'user@example.com',
+     *   {
+     *     recipient_name: 'สมชาย ใจดี',
+     *     text_body: 'ยินดีต้อนรับ ขอบคุณที่สมัครสมาชิก',
+     *     cc: ['manager@example.com'],
+     *     bcc: ['archive@example.com'],
+     *     attachments: [
+     *       {
+     *         filename: 'document.pdf',
+     *         href: 'https://api.example.com/files/123e4567-e89b-12d3-a456-426614174000/content' // URL จาก File API
+     *       }
+     *     ]
+     *   }
+     * );
+     * ```
+     */
+    sendRawEmail(htmlBody: string, subject: string, recipient: string, options?: {
+        recipient_name?: string;
+        recipient_id?: string;
+        text_body?: string;
+        cc?: string | string[];
+        bcc?: string | string[];
+        attachments?: Array<{
+            filename: string;
+            href: string;
+            content_type?: string;
+        }>;
+        priority?: 'low' | 'normal' | 'high' | 'urgent';
+        scheduled_at?: Date | string;
+        source?: string;
+        related_entity_id?: string;
+        related_entity_type?: string;
+    }): Promise<SendEmailResponse>;
+}
+export { EmailAPI }
+export { EmailAPI as EmailAPI_alias_1 }
+export { EmailAPI as EmailAPI_alias_2 }
+
+/**
+ * Event categories (ISO 27001 Compliant - 8 Core Categories)
+ */
+declare enum EventCategory {
+    // === 8 Core Categories ===
+    AUTHENTICATION = 'authentication', // 1. Login, logout, password, MFA, account management
+    AUTHORIZATION = 'authorization', // 2. Permission checks, role assignments, access control
+    DATA_ACCESS = 'data_access', // 3. Data viewing, export, search, sensitive data access
+    SECURITY = 'security', // 4. Attack attempts, suspicious activities, threat detection
+    BUSINESS = 'business', // 5. CRUD operations, workflow, business operations (รวม DATA_CHANGE)
+    TECHNICAL = 'technical', // 6. System lifecycle, performance, API operations, errors
+    COMPLIANCE = 'compliance', // 7. Audit activities, GDPR, legal hold, policy compliance
+    ISO27001_AUDIT = 'iso27001_audit', // 8. Control monitoring, risk management, ISMS
+}
+export { EventCategory }
+export { EventCategory as EventCategory_alias_1 }
+export { EventCategory as EventCategory_alias_2 }
+
+declare type EventCategoryType = `${EventCategory}`;
+export { EventCategoryType }
+export { EventCategoryType as EventCategoryType_alias_1 }
+export { EventCategoryType as EventCategoryType_alias_2 }
+
+/**
+ * Event Log API Client
+ *
+ * Centralized event logging client for microservices
+ * Sends all event logs to main API for centralized storage
+ */
+declare class EventLogApi {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Log event to centralized event log system
+     */
+    logEvent(eventData: CreateEventLogRequestDto): Promise<EventLogResponseDto>;
+    /**
+     * Batch log multiple events (for performance)
+     */
+    logEvents(events: CreateEventLogRequestDto[]): Promise<{
+        success: number;
+        failed: number;
+    }>;
+}
+export { EventLogApi }
+export { EventLogApi as EventLogApi_alias_1 }
+export { EventLogApi as EventLogApi_alias_2 }
+
+/**
+ * Event Log Response DTO
+ * Matches EventLogResponseDto from @win-portal/shared
+ */
+declare interface EventLogResponseDto {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    status: string;
+    source: string;
+    event_type: string;
+    subject?: string;
+    event_time: string;
+    severity: string;
+    outcome: string;
+    category?: string;
+    risk_level?: string;
+    application_id?: string | null;
+    application_code?: string;
+    actor: {
+        type: string;
+        id?: string;
+        name?: string;
+        session_id?: string;
+        ip_address?: string;
+        user_agent?: string;
+    };
+    target?: {
+        type: string;
+        id?: string;
+        name?: string;
+    };
+    action: string;
+    message?: string;
+    before_state?: Record<string, any>;
+    after_state?: Record<string, any>;
+    changed_fields?: Record<string, any>;
+    metadata?: Record<string, any>;
+    tags?: string[];
+    error?: {
+        code?: string;
+        message?: string;
+        details?: any;
+    };
+    trace_id?: string;
+    span_id?: string;
+    parent_span_id?: string;
+    trace_flags?: string;
+    correlation_id?: string;
+    request_id?: string;
+    business_reason?: string;
+    application_version?: string;
+    service_version?: string;
+    performance?: {
+        duration_ms?: number;
+        resource_usage?: Record<string, any>;
+    };
+    requires_approval?: boolean;
+    approval?: {
+        required: boolean;
+        approved_by?: string;
+        approved_at?: Date | string;
+        rejected_by?: string;
+        rejected_at?: Date | string;
+        reason?: string;
+    };
+    review?: {
+        required: boolean;
+        reviewed_by?: string;
+        reviewed_at?: Date | string;
+        status?: 'pending' | 'approved' | 'rejected';
+        notes?: string;
+    };
+    retention_period?: string;
+    expires_at?: Date | string;
+    event_age_hours?: number;
+    is_recent?: boolean;
+    risk_score?: number;
+    related_events_count?: number;
+}
+export { EventLogResponseDto }
+export { EventLogResponseDto as EventLogResponseDto_alias_1 }
+export { EventLogResponseDto as EventLogResponseDto_alias_2 }
+
+/**
+ * Event outcome
+ */
+declare enum EventOutcome {
+    SUCCESS = 'success',
+    FAILURE = 'failure',
+    PARTIAL = 'partial',
+    UNKNOWN = 'unknown',
+}
+export { EventOutcome }
+export { EventOutcome as EventOutcome_alias_1 }
+export { EventOutcome as EventOutcome_alias_2 }
+
+declare type EventOutcomeType = `${EventOutcome}`;
+export { EventOutcomeType }
+export { EventOutcomeType as EventOutcomeType_alias_1 }
+export { EventOutcomeType as EventOutcomeType_alias_2 }
+
+/**
+ * Risk levels
+ */
+declare enum EventRiskLevel {
+    NONE = 'none',
+    LOW = 'low',
+    MEDIUM = 'medium',
+    HIGH = 'high',
+    CRITICAL = 'critical',
+}
+export { EventRiskLevel }
+export { EventRiskLevel as EventRiskLevel_alias_1 }
+export { EventRiskLevel as EventRiskLevel_alias_2 }
+
+declare type EventRiskLevelType = `${EventRiskLevel}`;
+export { EventRiskLevelType }
+export { EventRiskLevelType as EventRiskLevelType_alias_1 }
+export { EventRiskLevelType as EventRiskLevelType_alias_2 }
+
+/**
+ * Event severity levels
+ */
+declare enum EventSeverity {
+    DEBUG = 'debug',
+    INFO = 'info',
+    WARNING = 'warning',
+    ERROR = 'error',
+    CRITICAL = 'critical',
+}
+export { EventSeverity }
+export { EventSeverity as EventSeverity_alias_1 }
+export { EventSeverity as EventSeverity_alias_2 }
+
+declare type EventSeverityType = `${EventSeverity}`;
+export { EventSeverityType }
+export { EventSeverityType as EventSeverityType_alias_1 }
+export { EventSeverityType as EventSeverityType_alias_2 }
+
+/**
+ * File Types - SDK Friendly
+ *
+ * Clean, client-focused type names without DTO suffixes
+ */
+/**
+ * File Information
+ * Complete file metadata and URLs
+ * Matches FileResponseDto from @win-portal/shared
+ */
+declare interface File_2 {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    status: string;
+    original_name: string;
+    file_name: string;
+    url: string;
+    mime_type: string;
+    size: number;
+    folder?: string;
+    storage_provider: string;
+    entity_type: string;
+    entity_id: string;
+    entity_field?: string;
+    file_category: string;
+    description?: string;
+    is_public: boolean;
+    checksum?: string;
+    metadata?: Record<string, any>;
+    uploaded_by?: string;
+    uploaded_by_name?: string;
+    download_count?: number;
+    last_accessed_at?: string;
+    file_size_formatted?: string;
+    is_image?: boolean;
+    is_document?: boolean;
+    is_video?: boolean;
+    is_audio?: boolean;
+    thumbnail_url?: string;
+    preview_url?: string;
+    download_url?: string;
+}
+export { File_2 as File }
+export { File_2 as File_alias_1 }
+export { File_2 as File_alias_2 }
+
+/**
+ * Files API
+ * Methods for file management operations
+ * Based on: apps/api/src/modules/features/files/controllers/files.controller.ts
+ */
+declare class FilesAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * POST /files - อัปโหลดไฟล์ใหม่
+     * Supports both authenticated and anonymous uploads
+     */
+    upload(formData: FormData): Promise<File_2>;
+    /**
+     * GET /files/:id - ดูข้อมูลไฟล์
+     * Public access (supports both authenticated and anonymous)
+     */
+    getById(id: string): Promise<File_2>;
+    /**
+     * GET /files/:id/content - ดึง file content (รูปภาพ, เอกสาร)
+     * Returns the actual file content or redirects to cloud storage URL
+     * Public access based on file.is_public flag
+     */
+    getContentUrl(id: string): string;
+    /**
+     * PUT /files/:id - อัปเดตข้อมูลไฟล์
+     * Requires authentication
+     */
+    update(id: string, updateData: FileUpdateData): Promise<File_2>;
+    /**
+     * DELETE /files/:id - ลบไฟล์
+     * Requires authentication
+     */
+    delete(id: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * POST /files/search - ค้นหาไฟล์แบบ advanced
+     * Public access (supports both authenticated and anonymous)
+     */
+    search(searchParams?: FileSearchParams): Promise<{
+        data: File_2[];
+        total: number;
+        page: number;
+        page_size: number;
+    }>;
+    /**
+     * DELETE /files/bulk - ลบไฟล์หลายไฟล์
+     * Requires authentication
+     */
+    bulkDelete(ids: string[]): Promise<{
+        message: string;
+        deleted_count: number;
+    }>;
+}
+export { FilesAPI }
+export { FilesAPI as FilesAPI_alias_1 }
+export { FilesAPI as FilesAPI_alias_2 }
+
+/**
+ * File Search Parameters
+ * Options for searching and filtering files
+ */
+declare interface FileSearchParams {
+    entity_type?: string;
+    entity_id?: string;
+    file_category?: string;
+    search?: string;
+    page?: number;
+    page_size?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+}
+export { FileSearchParams }
+export { FileSearchParams as FileSearchParams_alias_1 }
+export { FileSearchParams as FileSearchParams_alias_2 }
+
+/**
+ * File Update Data
+ * Fields that can be updated for a file
+ */
+declare interface FileUpdateData {
+    description?: string;
+    is_public?: boolean;
+    metadata?: Record<string, any>;
+    entity_field?: string;
+}
+export { FileUpdateData }
+export { FileUpdateData as FileUpdateData_alias_1 }
+export { FileUpdateData as FileUpdateData_alias_2 }
+
+/**
+ * File Upload Options
+ * Configuration for uploading a file
+ */
+declare interface FileUploadOptions {
+    entity_type: string;
+    entity_id: string;
+    entity_field?: string;
+    folder?: string;
+    file_category?: string;
+    description?: string;
+    is_public?: boolean | string;
+    metadata?: Record<string, any>;
+    original_name?: string;
+    mime_type?: string;
+    size?: number;
+}
+export { FileUploadOptions }
+export { FileUploadOptions as FileUploadOptions_alias_1 }
+export { FileUploadOptions as FileUploadOptions_alias_2 }
+
+declare class HealthAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Check API health
+     */
+    check(): Promise<any>;
+    /**
+     * Validate if API key is still active
+     */
+    validateApiKey(): Promise<boolean>;
+}
+export { HealthAPI }
+export { HealthAPI as HealthAPI_alias_1 }
+export { HealthAPI as HealthAPI_alias_2 }
+
+/**
+ * Event Log Actor Information
+ */
+declare interface IEventLogActor {
+    type: ActorType;
+    id?: string;
+    name?: string;
+    session_id?: string;
+    ip_address?: string;
+    user_agent?: string;
+}
+export { IEventLogActor }
+export { IEventLogActor as IEventLogActor_alias_1 }
+export { IEventLogActor as IEventLogActor_alias_2 }
+
+/**
+ * Event Log Error Information
+ */
+declare interface IEventLogError {
+    code?: string;
+    message?: string;
+    details?: any;
+}
+export { IEventLogError }
+export { IEventLogError as IEventLogError_alias_1 }
+export { IEventLogError as IEventLogError_alias_2 }
+
+/**
+ * Event Log Target Information
+ */
+declare interface IEventLogTarget {
+    type: string;
+    id?: string;
+    name?: string;
+}
+export { IEventLogTarget }
+export { IEventLogTarget as IEventLogTarget_alias_1 }
+export { IEventLogTarget as IEventLogTarget_alias_2 }
+
+declare class LineAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * ส่งข้อความ text ไปยัง user
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.line.sendTextMessage({
+     *   userId: 'user-123',
+     *   message: 'สวัสดีครับ! ยินดีต้อนรับ'
+     * });
+     * ```
+     */
+    sendTextMessage(request: SendTextMessageRequest): Promise<LineMessageResponse>;
+    /**
+     * ส่ง sticker ไปยัง user
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.line.sendSticker({
+     *   userId: 'user-123',
+     *   packageId: '11537',
+     *   stickerId: '52002734'
+     * });
+     * ```
+     */
+    sendSticker(request: SendStickerRequest): Promise<LineMessageResponse>;
+    /**
+     * ส่งรูปภาพไปยัง user
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.line.sendImage({
+     *   userId: 'user-123',
+     *   originalContentUrl: 'https://example.com/image.jpg',
+     *   previewImageUrl: 'https://example.com/preview.jpg'
+     * });
+     * ```
+     */
+    sendImage(request: SendImageRequest): Promise<LineMessageResponse>;
+    /**
+     * ส่งหลายข้อความพร้อมกัน (สูงสุด 5 ข้อความ)
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.line.sendMessages({
+     *   userId: 'user-123',
+     *   messages: [
+     *     { type: 'text', text: 'ข้อความแรก' },
+     *     { type: 'sticker', packageId: '11537', stickerId: '52002734' },
+     *     { type: 'text', text: 'ข้อความสุดท้าย' }
+     *   ]
+     * });
+     * ```
+     */
+    sendMessages(request: SendMessagesRequest): Promise<LineMessageResponse>;
+    /**
+     * ส่ง notification แบบ high-level (มี title, icon และ action URL)
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.line.sendNotification({
+     *   userId: 'user-123',
+     *   title: 'งานใหม่ได้รับมอบหมาย',
+     *   message: 'คุณได้รับมอบหมายงาน: ทำรายงานประจำเดือน',
+     *   type: 'info',
+     *   action_url: 'https://app.example.com/tasks/123',
+     *   priority: 'high'
+     * });
+     * ```
+     */
+    sendNotification(request: SendNotificationRequest): Promise<LineMessageResponse>;
+    /**
+     * ตรวจสอบว่า user สามารถรับข้อความ LINE ได้หรือไม่
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.line.checkMessagingAvailability('user-123');
+     * if (result.data?.canReceiveMessages) {
+     *   console.log('User can receive LINE messages');
+     * }
+     * ```
+     */
+    checkMessagingAvailability(userId: string): Promise<LineMessagingAvailabilityResponse>;
+}
+export { LineAPI }
+export { LineAPI as LineAPI_alias_1 }
+export { LineAPI as LineAPI_alias_2 }
+
+declare interface LineMessagePayload {
+    type: 'text' | 'image' | 'video' | 'audio' | 'file' | 'location' | 'sticker';
+    text?: string;
+    originalContentUrl?: string;
+    previewImageUrl?: string;
+    title?: string;
+    address?: string;
+    latitude?: number;
+    longitude?: number;
+    packageId?: string;
+    stickerId?: string;
+}
+export { LineMessagePayload }
+export { LineMessagePayload as LineMessagePayload_alias_1 }
+export { LineMessagePayload as LineMessagePayload_alias_2 }
+
+declare interface LineMessageResponse {
+    success: boolean;
+    data?: {
+        messageSent: boolean;
+    };
+    message?: string;
+    errors?: string[];
+    timestamp: string;
+}
+export { LineMessageResponse }
+export { LineMessageResponse as LineMessageResponse_alias_1 }
+export { LineMessageResponse as LineMessageResponse_alias_2 }
+
+declare interface LineMessagingAvailabilityResponse {
+    success: boolean;
+    data?: {
+        canReceiveMessages: boolean;
+        lineUserId?: string;
+    };
+    message?: string;
+    errors?: string[];
+    timestamp: string;
+}
+export { LineMessagingAvailabilityResponse }
+export { LineMessagingAvailabilityResponse as LineMessagingAvailabilityResponse_alias_1 }
+export { LineMessagingAvailabilityResponse as LineMessagingAvailabilityResponse_alias_2 }
+
+declare class Logger {
+    private config;
+    private shouldLog;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    /**
+     * อัพเดท logging config
+     *
+     * @param config - Partial config เพื่อ merge กับ config ปัจจุบัน
+     */
+    setConfig(config: Partial<LoggerConfig>): void;
+    /**
+     * ตรวจสอบว่า logging เปิดอยู่หรือไม่
+     */
+    isEnabled(): boolean;
+    /**
+     * ดู log level ปัจจุบัน
+     */
+    getLogLevel(): LogLevel;
+}
+
+export declare const logger: Logger;
+
+declare interface LoggerConfig {
+    enabled: boolean;
+    logLevel: LogLevel;
+}
+
+/**
+ * Logger Utility
+ *
+ * @description Centralized logging utility for Auth SDK
+ * Supports different log levels and enable/disable via config
+ *
+ * @example
+ * ```typescript
+ * // ปิด log ทั้งหมด
+ * const client = new AuthClient({ apiKey: '...', logging: false });
+ *
+ * // เปิด log เฉพาะ warn ขึ้นไป
+ * const client = new AuthClient({ apiKey: '...', logging: { enabled: true, level: 'warn' } });
+ *
+ * // เปลี่ยน config ตอน runtime
+ * import { logger } from '@win-portal/auth-sdk';
+ * logger.setConfig({ enabled: false });
+ * ```
+ */
+export declare type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+/**
+ * Move Organization Request - ข้อมูลสำหรับย้าย organization ไป parent ใหม่
+ *
+ * Structurally identical to `@win-portal/shared` `MoveOrganizationRequestDto`.
+ * Kept local so api-extractor can inline the shape into the published dts
+ * without retaining a reference to `@win-portal/shared`.
+ *
+ * @example
+ * ```json
+ * { "new_parent_id": "org-456" }
+ * ```
+ *
+ * @example Root level
+ * ```json
+ * { "new_parent_id": null }
+ * ```
+ */
+declare interface MoveOrganizationRequest {
+    new_parent_id: string | null;
+}
+export { MoveOrganizationRequest }
+export { MoveOrganizationRequest as MoveOrganizationRequest_alias_1 }
+export { MoveOrganizationRequest as MoveOrganizationRequest_alias_2 }
+
+/**
+ * Organization Types
+ */
+/**
+ * Organization Entity
+ */
+declare interface Organization {
+    id: string;
+    name: string;
+    code: string;
+    description?: string;
+    type: OrganizationType | string;
+    parent_id?: string;
+    organization_id: string;
+    department_id?: string;
+    position_id?: string;
+    level: number;
+    report_to_position_id?: string;
+    logo_file_id?: string;
+    total_users?: number;
+    total_departments?: number;
+    total_positions?: number;
+    status: string;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+    parent?: Organization;
+    organization?: Organization;
+    department?: Organization;
+    position?: Organization;
+    report_to_position?: Organization;
+}
+export { Organization }
+export { Organization as Organization_alias_1 }
+export { Organization as Organization_alias_2 }
+
+declare interface OrganizationAdvancedFilters {
+    status?: string[];
+    type?: string[];
+    parent_id?: string;
+    organization_id?: string;
+    department_id?: string;
+    code?: string;
+    level?: number;
+    is_active?: boolean;
+}
+export { OrganizationAdvancedFilters }
+export { OrganizationAdvancedFilters as OrganizationAdvancedFilters_alias_1 }
+export { OrganizationAdvancedFilters as OrganizationAdvancedFilters_alias_2 }
+
+declare class OrganizationAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Search organizations with pagination and filters
+     */
+    search(params?: OrganizationSearchParams): Promise<ApiPaginatedResponse<Organization>>;
+    /**
+     * Get organization by ID
+     */
+    get(id: string): Promise<Organization>;
+    /**
+     * Find organization by code
+     *
+     * @description ค้นหาองค์กรด้วย code ที่ unique
+     *
+     * @example
+     * ```typescript
+     * const org = await authClient.organization.findByCode("WIN-CORP");
+     * if (org) {
+     *   console.log(org.name); // "บริษัท วิน คอร์ปอเรชั่น จำกัด"
+     * }
+     * ```
+     */
+    findByCode(code: string): Promise<Organization | null>;
+    /**
+     * Create a new organization
+     */
+    create(data: CreateOrganizationRequest): Promise<Organization>;
+    /**
+     * Bulk create organizations (เร็วกว่า loop create ทีละรายการ)
+     *
+     * @description สร้างองค์กรหลายรายการในครั้งเดียว ต้องเรียง parent ก่อน child
+     * หรือระบุ id ให้ parent เพื่อให้ child อ้างอิง parent_id ได้
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.organization.bulkCreate({
+     *   organizations: [
+     *     { name: "Group A", code: "GRP-A", type: "group", id: "uuid-1" },
+     *     { name: "Company 1", code: "CO-1", type: "company", parent_id: "uuid-1", id: "uuid-2" },
+     *     { name: "Dept IT", code: "IT", type: "department", parent_id: "uuid-2" },
+     *   ],
+     * });
+     * console.log(result.created); // 3
+     * ```
+     */
+    bulkCreate(data: BulkCreateOrganizationRequest): Promise<BulkCreateOrganizationResponse>;
+    /**
+     * Update organization
+     */
+    update(id: string, data: UpdateOrganizationRequest): Promise<Organization>;
+    /**
+     * Delete organization
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Get organization users
+     * @param includeDescendants If true, returns users from all descendant organizations recursively
+     */
+    getUsers(id: string, includeDescendants?: boolean): Promise<User[]>;
+    /**
+     * Get ancestors (parent organizations at all levels)
+     */
+    getAncestors(id: string, includeRoot?: boolean): Promise<Organization[]>;
+    /**
+     * Get immediate supervisor/parent organization
+     */
+    getDirectSupervisor(id: string): Promise<Organization | null>;
+    /**
+     * Get full path from root to organization
+     */
+    getPath(id: string): Promise<Organization[]>;
+    /**
+     * Get reporting line (hierarchical and functional)
+     */
+    getReportingLine(id: string): Promise<ReportingLineResponse>;
+    /**
+     * Get sibling organizations (same parent)
+     */
+    getSiblings(id: string, includeSelf?: boolean): Promise<Organization[]>;
+    /**
+     * Get organization level
+     */
+    getLevel(id: string): Promise<OrganizationLevelResponse>;
+    /**
+     * Get lowest common ancestor of two organizations
+     */
+    getCommonAncestor(orgA: string, orgB: string): Promise<Organization | null>;
+    /**
+     * Check if an organization is an ancestor of another
+     */
+    isAncestorOf(ancestorId: string, descendantId: string): Promise<boolean>;
+    /**
+     * Get organization hierarchy
+     *
+     * @description ดึง hierarchy tree ขององค์กรทั้งหมด หรือเริ่มจาก root ที่ระบุ
+     *
+     * @param rootId - Optional root organization ID. ถ้าไม่ระบุจะดึง hierarchy ทั้งหมด
+     *
+     * @example
+     * ```typescript
+     * // ดึง hierarchy ทั้งหมด
+     * const hierarchy = await authClient.organization.getHierarchy();
+     *
+     * // ดึง hierarchy จาก root ที่ระบุ
+     * const hierarchy = await authClient.organization.getHierarchy("org-root-123");
+     * ```
+     */
+    getHierarchy(rootId?: string): Promise<Organization[]>;
+    /**
+     * Get organization tree (with departments and positions)
+     *
+     * @description ดึงโครงสร้าง tree ขององค์กร รวม departments, positions และ user assignments
+     *
+     * @example
+     * ```typescript
+     * const tree = await authClient.organization.getTree("org-123");
+     * console.log(tree.children); // departments & positions
+     * console.log(tree.total_users); // จำนวนผู้ใช้ทั้งหมด
+     * ```
+     */
+    getTree(id: string): Promise<OrganizationTreeResponse>;
+    /**
+     * Get direct children of organization
+     *
+     * @description ดึงองค์กรลูกตรง (direct children) ขององค์กรที่ระบุ
+     *
+     * @example
+     * ```typescript
+     * const children = await authClient.organization.getChildren("org-123");
+     * ```
+     */
+    getChildren(id: string): Promise<Organization[]>;
+    /**
+     * Get sub-organizations
+     *
+     * @description ดึง sub-organizations ขององค์กรที่ระบุ
+     *
+     * @example
+     * ```typescript
+     * const subOrgs = await authClient.organization.getSubOrganizations("org-123");
+     * ```
+     */
+    getSubOrganizations(id: string): Promise<Organization[]>;
+    /**
+     * Get positions under organization
+     *
+     * @description ดึงรายการตำแหน่ง (position nodes) ทั้งหมดภายใต้องค์กรที่ระบุ
+     *
+     * @example
+     * ```typescript
+     * const positions = await authClient.organization.getPositions("org-123");
+     * console.log(positions.map(p => p.name)); // ["Senior Developer", "Team Lead", ...]
+     * ```
+     */
+    getPositions(id: string): Promise<Organization[]>;
+    /**
+     * Activate organization
+     *
+     * @description เปิดใช้งานองค์กร
+     *
+     * @example
+     * ```typescript
+     * await authClient.organization.activate("org-123");
+     * ```
+     */
+    activate(id: string): Promise<boolean>;
+    /**
+     * Deactivate organization
+     *
+     * @description ปิดใช้งานองค์กร
+     *
+     * @example
+     * ```typescript
+     * await authClient.organization.deactivate("org-123");
+     * ```
+     */
+    deactivate(id: string): Promise<boolean>;
+    /**
+     * Bulk activate organizations
+     *
+     * @description เปิดใช้งานหลายองค์กรพร้อมกัน
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.organization.bulkActivate(["org-1", "org-2", "org-3"]);
+     * console.log(result.success_count); // 3
+     * ```
+     */
+    bulkActivate(ids: string[]): Promise<BulkOperationResponse>;
+    /**
+     * Bulk deactivate organizations
+     *
+     * @description ปิดใช้งานหลายองค์กรพร้อมกัน
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.organization.bulkDeactivate(["org-1", "org-2"]);
+     * console.log(result.success_count); // 2
+     * ```
+     */
+    bulkDeactivate(ids: string[]): Promise<BulkOperationResponse>;
+    /**
+     * Bulk delete organizations
+     *
+     * @description ลบหลายองค์กรพร้อมกัน
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.organization.bulkDelete(["org-1", "org-2"]);
+     * console.log(result.success_count); // 2
+     * ```
+     */
+    bulkDelete(ids: string[]): Promise<BulkOperationResponse>;
+    /**
+     * Clear all organization data
+     *
+     * @description ลบข้อมูลองค์กรทั้งหมด รวมถึง:
+     * - user_position_assignment (เอาข้อมูล position ออกจาก user)
+     * - organization_closure
+     * - organization (company, department, position)
+     * - Nullify organization/position references ใน workflow และ document tables
+     *
+     * รองรับทั้ง JWT และ API Key authentication (สำหรับเรียกจากระบบอื่น)
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.organization.clearAll();
+     * console.log(result.organizations_deleted); // จำนวนองค์กรที่ลบ
+     * console.log(result.user_position_assignments_deleted); // จำนวน position assignment ที่ลบ
+     * ```
+     */
+    clearAll(): Promise<ClearAllDataResponse>;
+    /**
+     * Rebuild all organization data (รวมทุก fix ในครั้งเดียว)
+     *
+     * @description ใช้หลัง clear-all + create เพื่อให้ข้อมูลครบถ้วน:
+     * 1. fix organization_id ตาม hierarchy
+     * 2. reload organization_closure สำหรับทุก company
+     * 3. reload report_to_position
+     *
+     * @example
+     * ```typescript
+     * await authClient.organization.clearAll();
+     * // ... create organizations ...
+     * const result = await authClient.organization.rebuildAll();
+     * console.log(result.organization_ids_fixed, result.closure_companies_processed);
+     * ```
+     */
+    rebuildAll(): Promise<RebuildAllDataResponse>;
+    /**
+     * Duplicate organization (copy)
+     *
+     * @description คัดลอกองค์กรและ children ทั้งหมด สร้าง organization ใหม่พร้อม hierarchy fields และ closure records
+     *
+     * @example
+     * ```typescript
+     * const duplicated = await authClient.organization.duplicate("org-123");
+     * console.log(duplicated.id); // new organization ID
+     * ```
+     */
+    duplicate(id: string): Promise<Organization>;
+    /**
+     * Move organization to new parent
+     *
+     * @description ย้ายองค์กรไปอยู่ภายใต้ parent ใหม่ อัพเดท hierarchy fields และ closure table อัตโนมัติ
+     * ส่ง `null` เพื่อย้ายไปเป็น root level
+     *
+     * @example
+     * ```typescript
+     * // ย้ายไปอยู่ภายใต้ parent ใหม่
+     * await authClient.organization.move("org-123", { new_parent_id: "org-456" });
+     *
+     * // ย้ายไปเป็น root level
+     * await authClient.organization.move("org-123", { new_parent_id: null });
+     * ```
+     */
+    move(id: string, data: MoveOrganizationRequest): Promise<boolean>;
+}
+export { OrganizationAPI }
+export { OrganizationAPI as OrganizationAPI_alias_1 }
+export { OrganizationAPI as OrganizationAPI_alias_2 }
+
+/**
+ * Organization Level Response
+ */
+declare interface OrganizationLevelResponse {
+    level: number;
+    type: OrganizationType | string;
+}
+export { OrganizationLevelResponse }
+export { OrganizationLevelResponse as OrganizationLevelResponse_alias_1 }
+export { OrganizationLevelResponse as OrganizationLevelResponse_alias_2 }
+
+/**
+ * Organization Search Params
+ */
+declare interface OrganizationSearchParams {
+    page?: number;
+    page_size?: number;
+    search?: string;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    advanced?: OrganizationAdvancedFilters;
+}
+export { OrganizationSearchParams }
+export { OrganizationSearchParams as OrganizationSearchParams_alias_1 }
+export { OrganizationSearchParams as OrganizationSearchParams_alias_2 }
+
+/**
+ * Organization Tree Node - โหนดใน tree structure
+ *
+ * @note Diverges from @win-portal/shared `OrganizationTreeNodeDto`:
+ * - `type` is widened to `OrganizationType | string` for forward-compat with
+ *   future node types returned by the API
+ * - `department_type` is `string` (not the strict `DepartmentType` enum)
+ * - `users` uses the SDK's `UserSummary` (flat positions array) instead of
+ *   shared's `UserSummaryDto` (single `primary_position_id` field)
+ */
+declare interface OrganizationTreeNode {
+    id: string;
+    name: string;
+    code: string;
+    type: OrganizationType | string;
+    children?: OrganizationTreeNode[];
+    department_type?: string;
+    level?: number;
+    users?: UserSummary[];
+    total_users?: number;
+    total_departments?: number;
+    total_positions?: number;
+}
+export { OrganizationTreeNode }
+export { OrganizationTreeNode as OrganizationTreeNode_alias_1 }
+export { OrganizationTreeNode as OrganizationTreeNode_alias_2 }
+
+/**
+ * Organization Tree Response - root organization node พร้อม complete tree structure
+ *
+ * @note Inherits the divergence from `OrganizationTreeNode` above (widened
+ * enums and SDK-shaped `users`). Kept local rather than re-exported from shared.
+ */
+declare interface OrganizationTreeResponse extends OrganizationTreeNode {
+    type: OrganizationType.COMPANY | OrganizationType.GROUP | string;
+}
+export { OrganizationTreeResponse }
+export { OrganizationTreeResponse as OrganizationTreeResponse_alias_1 }
+export { OrganizationTreeResponse as OrganizationTreeResponse_alias_2 }
+
+declare enum OrganizationType {
+    GROUP = 'group', // กลุ่มบริษัท (Level 0)
+    COMPANY = 'company', // บริษัท/องค์กรหลัก (alias: ORGANIZATION) (Level 1)
+    BRANCH = 'branch', // สาขา (Level 1.5)
+    DIVISION = 'division', // ฝ่าย (Level 2)
+    DEPARTMENT = 'department', // แผนก (Level 3)
+    SECTION = 'section', // ส่วนงาน (Level 3.5) - ระหว่าง Department กับ Team
+    TEAM = 'team', // ทีม (Level 4)
+    POSITION = 'position', // ตำแหน่งงาน (Level 5)
+}
+export { OrganizationType }
+export { OrganizationType as OrganizationType_alias_1 }
+export { OrganizationType as OrganizationType_alias_2 }
+
+declare class OtpAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Send OTP to recipient (SMS or Email)
+     *
+     * @example
+     * ```typescript
+     * // Send SMS OTP
+     * const result = await authClient.otp.sendOTP({
+     *   method: 'sms',
+     *   recipient: '0812345678',
+     *   context: 'login'
+     * });
+     *
+     * console.log('OTP ID:', result.otp_id); // UUID
+     * console.log('Ref Code:', result.ref_code); // OTP-XXXXXX (for tracking)
+     * console.log('Expires at:', result.expires_at);
+     *
+     * // Send Email OTP
+     * const result = await authClient.otp.sendOTP({
+     *   method: 'email',
+     *   recipient: 'user@example.com',
+     *   context: 'verification'
+     * });
+     * ```
+     */
+    sendOTP(request: SendOTPRequest): Promise<SendOTPResponse>;
+    /**
+     * Verify OTP code
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.otp.verifyOTP({
+     *   otp_id: '123e4567-e89b-12d3-a456-426614174000',
+     *   code: '123456'
+     * });
+     *
+     * if (result.verified) {
+     *   console.log('OTP verified successfully');
+     * }
+     * ```
+     */
+    verifyOTP(request: VerifyOTPRequest): Promise<VerifyOTPResponse>;
+}
+export { OtpAPI }
+export { OtpAPI as OtpAPI_alias_1 }
+export { OtpAPI as OtpAPI_alias_2 }
+
+/**
+ * Pagination Meta Interface
+ *
+ * @description Interface สำหรับ metadata ที่ส่งกลับพร้อมกับ paginated response
+ * รวมถึงข้อมูลการแบ่งหน้าและ navigation
+ *
+ * @properties
+ * - page: หมายเลขหน้าปัจจุบัน (required)
+ * - limit: จำนวนรายการต่อหน้า (required)
+ * - total: จำนวนรายการทั้งหมด (required)
+ * - total_pages: จำนวนหน้าทั้งหมด (required)
+ * - has_next: มีหน้าถัดไปหรือไม่ (required)
+ * - has_prev: มีหน้าก่อนหน้าหรือไม่ (required)
+ * - start_index: index เริ่มต้นของหน้านี้ (required)
+ * - end_index: index สุดท้ายของหน้านี้ (required)
+ *
+ * @example
+ * ```typescript
+ * const paginationMeta: PaginationMeta = {
+ *   page: 2,
+ *   limit: 20,
+ *   total: 100,
+ *   total_pages: 5,
+ *   has_next: true,
+ *   has_prev: true,
+ *   start_index: 21,
+ *   end_index: 40
+ * }
+ *
+ * // First page
+ * const firstPageMeta: PaginationMeta = {
+ *   page: 1,
+ *   limit: 10,
+ *   total: 25,
+ *   total_pages: 3,
+ *   has_next: true,
+ *   has_prev: false,
+ *   start_index: 1,
+ *   end_index: 10
+ * }
+ * ```
+ *
+ * Usage:
+ * import { PaginationMeta } from '@win-portal/shared/interfaces/helpers/pagination-meta.interface';
+ */
+declare interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+    has_next: boolean;
+    has_prev: boolean;
+    start_index: number;
+    end_index: number;
+}
+export { PaginationMeta }
+export { PaginationMeta as PaginationMeta_alias_1 }
+
+/**
+ * Permission Types
+ *
+ * @description SDK-friendly shapes for permission and permission category operations.
+ * Names drop the `Dto` suffix vs @win-portal/shared; structure is intentionally a
+ * relaxed subset of the server DTOs (optional fields, string-widened enums).
+ */
+/**
+ * Permission Entity
+ */
+declare interface Permission {
+    id: string;
+    name: string;
+    key: string;
+    description?: string;
+    resource: string;
+    category_id?: string;
+    application_id?: string;
+    is_system?: boolean;
+    sort_order?: number;
+    status?: string;
+    created_at: string;
+    updated_at: string;
+}
+export { Permission }
+export { Permission as Permission_alias_1 }
+export { Permission as Permission_alias_2 }
+
+declare class PermissionAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Clear all permissions for current application (hard delete)
+     *
+     * @description ลบสิทธิ์ทั้งหมดตาม application_id จาก RequestContext (API key/context)
+     * ใช้สำหรับ migrate - ไม่ใช้ DTO, ดึง application_id จาก context อัตโนมัติ
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.permission.clear();
+     * console.log(result.permissions_deleted, result.role_permissions_deleted);
+     * ```
+     */
+    clear(): Promise<PermissionClearResponse>;
+    /**
+     * Search permissions with pagination and filters
+     */
+    search(params?: PermissionSearchParams): Promise<ApiPaginatedResponse<Permission>>;
+    /**
+     * Get permission by ID
+     */
+    get(id: string): Promise<Permission | null>;
+    /**
+     * Create a new permission
+     */
+    create(data: CreatePermissionRequest): Promise<Permission>;
+    /**
+     * Bulk create permissions ในครั้งเดียว
+     *
+     * @description สร้างสิทธิ์หลายรายการในครั้งเดียว ทุก permission ต้องมี category_id ที่มีอยู่แล้วในระบบ
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.permission.bulkCreate({
+     *   permissions: [
+     *     { category_id: "cat-uuid", name: "Create", key: "create", description: "..." },
+     *     { category_id: "cat-uuid", name: "Read", key: "read", description: "..." },
+     *   ],
+     * });
+     * console.log(result.created); // 2
+     * ```
+     */
+    bulkCreate(data: BulkCreatePermissionRequest): Promise<BulkCreateResponse>;
+    /**
+     * Update permission
+     */
+    update(id: string, data: UpdatePermissionRequest): Promise<Permission>;
+    /**
+     * Delete permission
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Activate permission
+     */
+    activate(id: string): Promise<boolean>;
+    /**
+     * Deactivate permission
+     */
+    deactivate(id: string): Promise<boolean>;
+}
+export { PermissionAPI }
+export { PermissionAPI as PermissionAPI_alias_1 }
+export { PermissionAPI as PermissionAPI_alias_2 }
+
+/**
+ * Permission Category Entity
+ */
+declare interface PermissionCategory {
+    id: string;
+    name: string;
+    key: string;
+    description?: string;
+    resource?: string;
+    application_id: string;
+    parent_id?: string;
+    is_system?: boolean;
+    sort_order?: number;
+    level?: number;
+    status?: string;
+    created_at: string;
+    updated_at: string;
+    permissions?: Permission[];
+}
+export { PermissionCategory }
+export { PermissionCategory as PermissionCategory_alias_1 }
+export { PermissionCategory as PermissionCategory_alias_2 }
+
+declare class PermissionCategoryAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Clear all permission categories for current application (hard delete)
+     *
+     * @description ลบหมวดหมู่สิทธิ์ทั้งหมดตาม application_id จาก RequestContext (API key/context)
+     * ใช้สำหรับ migrate - ไม่ใช้ DTO, ดึง application_id จาก context อัตโนมัติ
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.permissionCategory.clear();
+     * console.log(result.permission_categories_deleted, result.permissions_deleted);
+     * ```
+     */
+    clear(): Promise<PermissionCategoryClearResponse>;
+    /**
+     * Search permission categories with pagination and filters
+     */
+    search(params?: PermissionCategorySearchParams): Promise<ApiPaginatedResponse<PermissionCategory>>;
+    /**
+     * Get permission category by ID
+     */
+    get(id: string): Promise<PermissionCategory>;
+    /**
+     * Create a new permission category (พร้อม permissions ได้)
+     *
+     * @note application_id ไม่ต้องส่งเมื่อเรียกจาก app context - API จะ inject อัตโนมัติ
+     */
+    create(data: CreatePermissionCategoryRequest): Promise<PermissionCategory>;
+    /**
+     * Bulk create permission categories พร้อม permissions ในครั้งเดียว
+     *
+     * @description สร้างหมวดหมู่สิทธิ์หลายรายการพร้อม permissions ในครั้งเดียว
+     * ต้องเรียง parent ก่อน child หรือระบุ id ให้ parent เพื่อให้ child อ้างอิง parent_id ได้
+     *
+     * @note application_id ไม่ต้องส่ง - API จะ inject อัตโนมัติจาก API key หรือ RequestContextService
+     *
+     * @example
+     * ```typescript
+     * // เรียกจาก app context (API key) - application_id จะถูก inject อัตโนมัติ
+     * const result = await authClient.permissionCategory.bulkCreate({
+     *   permission_categories: [
+     *     {
+     *       id: "cat-users",
+     *       key: "users",
+     *       name: "User Management",
+     *       resource: "users",
+     *       permissions: [
+     *         { name: "Create User", key: "create", description: "..." },
+     *         { name: "Read User", key: "read", description: "..." },
+     *       ],
+     *     },
+     *     {
+     *       key: "user_profile",
+     *       name: "User Profile",
+     *       parent_id: "cat-users",
+     *       permissions: [{ name: "Edit Profile", key: "edit", description: "..." }],
+     *     },
+     *   ],
+     * });
+     * console.log(result.created); // 2
+     * ```
+     */
+    bulkCreate(data: BulkCreatePermissionCategoryRequest): Promise<BulkCreateResponse>;
+    /**
+     * Update permission category
+     */
+    update(id: string, data: UpdatePermissionCategoryRequest): Promise<PermissionCategory>;
+    /**
+     * Delete permission category
+     */
+    delete(id: string): Promise<boolean>;
+}
+export { PermissionCategoryAPI }
+export { PermissionCategoryAPI as PermissionCategoryAPI_alias_1 }
+export { PermissionCategoryAPI as PermissionCategoryAPI_alias_2 }
+
+/**
+ * Permission Category Clear Response - ผลลัพธ์จากการลบ permission categories ตาม application_id
+ * ใช้ application_id จาก RequestContext (API key/context)
+ */
+declare interface PermissionCategoryClearResponse {
+    permission_categories_deleted: number;
+    permissions_deleted: number;
+    role_permissions_deleted: number;
+}
+export { PermissionCategoryClearResponse }
+export { PermissionCategoryClearResponse as PermissionCategoryClearResponse_alias_1 }
+export { PermissionCategoryClearResponse as PermissionCategoryClearResponse_alias_2 }
+
+/**
+ * Permission Category Search Params
+ */
+declare interface PermissionCategorySearchParams {
+    search?: string;
+    page?: number;
+    page_size?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    advanced?: {
+        application_id?: string;
+        is_active?: boolean;
+        color?: string;
+        icon?: string;
+    };
+}
+export { PermissionCategorySearchParams }
+export { PermissionCategorySearchParams as PermissionCategorySearchParams_alias_1 }
+export { PermissionCategorySearchParams as PermissionCategorySearchParams_alias_2 }
+
+/**
+ * Permission Clear Response - ผลลัพธ์จากการลบ permissions ตาม application_id
+ * ใช้ application_id จาก RequestContext (API key/context)
+ */
+declare interface PermissionClearResponse {
+    permissions_deleted: number;
+    role_permissions_deleted: number;
+}
+export { PermissionClearResponse }
+export { PermissionClearResponse as PermissionClearResponse_alias_1 }
+export { PermissionClearResponse as PermissionClearResponse_alias_2 }
+
+/**
+ * Permission Search Params
+ */
+declare interface PermissionSearchParams {
+    search?: string;
+    page?: number;
+    page_size?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    advanced?: {
+        status?: string;
+        is_active?: boolean;
+        key?: string;
+        resource?: string;
+        category_id?: string;
+        application_id?: string;
+        is_system?: boolean;
+    };
+}
+export { PermissionSearchParams }
+export { PermissionSearchParams as PermissionSearchParams_alias_1 }
+export { PermissionSearchParams as PermissionSearchParams_alias_2 }
+
+declare class PortalApiClient {
+    private readonly axios;
+    readonly email: EmailAPI;
+    readonly eventLog: EventLogApi;
+    readonly files: FilesAPI;
+    readonly health: HealthAPI;
+    readonly line: LineAPI;
+    readonly organization: OrganizationAPI;
+    readonly otp: OtpAPI;
+    readonly permission: PermissionAPI;
+    readonly permissionCategory: PermissionCategoryAPI;
+    readonly role: RoleAPI;
+    readonly systemConfig: SystemConfigAPI;
+    readonly todo: TodoAPI;
+    readonly user: UserAPI;
+    readonly webhook: WebhookAPI;
+    readonly workflow: WorkflowAPI;
+    constructor(config: PortalApiConfig);
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T, any>>;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T, any>>;
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T, any>>;
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T, any>>;
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T, any>>;
+}
+export { PortalApiClient }
+export { PortalApiClient as PortalApiClient_alias_1 }
+
+declare interface PortalApiConfig {
+    apiUrl: string;
+    getToken: () => string | null;
+    apiKey?: string;
+    timeout?: number;
+}
+export { PortalApiConfig }
+export { PortalApiConfig as PortalApiConfig_alias_1 }
+
+/**
+ * Rebuild All Response - ผลลัพธ์จากการ rebuild ข้อมูลองค์กรทั้งหมด
+ *
+ * @description ใช้กับ organization.rebuildAll() - รวม fix organization_id + reload closure + report_to_position
+ */
+declare interface RebuildAllDataResponse {
+    organization_ids_fixed: number;
+    closure_companies_processed: number;
+    report_to_position_updated: number;
+    execution_time_ms: number;
+}
+export { RebuildAllDataResponse }
+export { RebuildAllDataResponse as RebuildAllDataResponse_alias_1 }
+export { RebuildAllDataResponse as RebuildAllDataResponse_alias_2 }
+
+/**
+ * Reporting Line Response
+ */
+declare interface ReportingLineResponse {
+    hierarchical: Organization[];
+    functional: Organization | null;
+}
+export { ReportingLineResponse }
+export { ReportingLineResponse as ReportingLineResponse_alias_1 }
+export { ReportingLineResponse as ReportingLineResponse_alias_2 }
+
+/**
+ * Role Types for Auth SDK
+ *
+ * @description SDK-friendly shapes for role operations. Names drop the `Dto`
+ * suffix vs @win-portal/shared; structure is a relaxed subset of the server
+ * DTOs (`Role` is a simplified view of `RoleResponseDto`).
+ */
+/**
+ * Role - ข้อมูลบทบาทพื้นฐาน
+ * Matches RoleResponseDto from @win-portal/shared
+ */
+declare interface Role {
+    id: string;
+    name: string;
+    code: string;
+    description?: string;
+    is_system: boolean;
+    status: string;
+    created_at: Date | string;
+    updated_at: Date | string;
+}
+export { Role }
+export { Role as Role_alias_1 }
+export { Role as Role_alias_2 }
+
+declare class RoleAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Search roles with pagination and filters
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.role.search({
+     *   search: "Admin",
+     *   page: 1,
+     *   limit: 20,
+     *   sort_by: "created_at",
+     *   sort_order: "desc"
+     * });
+     * ```
+     */
+    search(params?: RoleSearchParams): Promise<ApiPaginatedResponse<Role>>;
+    /**
+     * Get role by ID
+     *
+     * @example
+     * ```typescript
+     * const role = await authClient.role.get("role-123");
+     * ```
+     */
+    get(roleId: string): Promise<Role>;
+    /**
+     * Create a new role
+     *
+     * @example
+     * ```typescript
+     * const newRole = await authClient.role.create({
+     *   name: "ผู้ดูแลระบบ",
+     *   code: "ADMIN",
+     *   description: "บทบาทสำหรับผู้ดูแลระบบ"
+     * });
+     * ```
+     */
+    create(data: CreateRoleRequest): Promise<Role>;
+    /**
+     * Update role
+     *
+     * @example
+     * ```typescript
+     * const updatedRole = await authClient.role.update("role-123", {
+     *   name: "ผู้ดูแลระบบหลัก",
+     *   description: "บทบาทสำหรับผู้ดูแลระบบหลัก"
+     * });
+     * ```
+     */
+    update(roleId: string, data: UpdateRoleRequest): Promise<Role>;
+    /**
+     * Clear all roles for current application (hard delete)
+     *
+     * @description ลบบทบาททั้งหมดตาม application_id จาก RequestContext (API key/context)
+     * ใช้สำหรับ migrate - ไม่ใช้ DTO, ดึง application_id จาก context อัตโนมัติ
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.role.clear();
+     * console.log(result.roles_deleted, result.role_permissions_deleted);
+     * ```
+     */
+    clear(): Promise<RoleClearResponse>;
+    /**
+     * Delete role
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.delete("role-123");
+     * ```
+     */
+    delete(roleId: string): Promise<boolean>;
+    /**
+     * Activate role
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.activate("role-123");
+     * ```
+     */
+    activate(roleId: string): Promise<boolean>;
+    /**
+     * Deactivate role
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.deactivate("role-123");
+     * ```
+     */
+    deactivate(roleId: string): Promise<boolean>;
+    /**
+     * Get role users
+     *
+     * @description ดึงรายการผู้ใช้ทั้งหมดที่มีบทบาทนี้
+     *
+     * @example
+     * ```typescript
+     * const users = await authClient.role.getUsers("role-123");
+     * console.log(users.map(u => u.email));
+     * ```
+     */
+    getUsers(roleId: string): Promise<User[]>;
+    /**
+     * Assign users to role
+     *
+     * @description มอบหมายผู้ใช้ให้บทบาท (เพิ่มเข้าไป ไม่ลบของเดิม)
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.assignUsers("role-123", ["user-001", "user-002"]);
+     * ```
+     */
+    assignUsers(roleId: string, userIds: string[]): Promise<boolean>;
+    /**
+     * Unassign users from role
+     *
+     * @description ยกเลิกผู้ใช้จากบทบาท
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.unassignUsers("role-123", ["user-001"]);
+     * ```
+     */
+    unassignUsers(roleId: string, userIds: string[]): Promise<boolean>;
+    /**
+     * Get role permissions
+     *
+     * @description ดึงรายการสิทธิ์ทั้งหมดของบทบาท
+     *
+     * @example
+     * ```typescript
+     * const permissions = await authClient.role.getPermissions("role-123");
+     * ```
+     */
+    getPermissions(roleId: string): Promise<Array<{
+        id: string;
+        name: string;
+        code: string;
+        description?: string;
+    }>>;
+    /**
+     * Assign permissions to role
+     *
+     * @description มอบหมายสิทธิ์ให้บทบาท
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.assignPermissions("role-123", ["perm-001", "perm-002"]);
+     * ```
+     */
+    assignPermissions(roleId: string, permissionIds: string[]): Promise<boolean>;
+    /**
+     * Unassign permissions from role
+     *
+     * @description ยกเลิกสิทธิ์จากบทบาท
+     *
+     * @example
+     * ```typescript
+     * await authClient.role.unassignPermissions("role-123", ["perm-001"]);
+     * ```
+     */
+    unassignPermissions(roleId: string, permissionIds: string[]): Promise<boolean>;
+}
+export { RoleAPI }
+export { RoleAPI as RoleAPI_alias_1 }
+export { RoleAPI as RoleAPI_alias_2 }
+
+/**
+ * Role Clear Response - ผลลัพธ์จากการลบ roles ตาม application_id
+ * ใช้ application_id จาก RequestContext (API key/context)
+ */
+declare interface RoleClearResponse {
+    roles_deleted: number;
+    role_permissions_deleted: number;
+    user_role_assignments_deleted: number;
+}
+export { RoleClearResponse }
+export { RoleClearResponse as RoleClearResponse_alias_1 }
+export { RoleClearResponse as RoleClearResponse_alias_2 }
+
+/**
+ * Role Search Advanced Filters
+ */
+declare interface RoleSearchAdvancedFilters {
+    status?: string;
+    is_active?: boolean;
+    is_system?: boolean;
+}
+export { RoleSearchAdvancedFilters }
+export { RoleSearchAdvancedFilters as RoleSearchAdvancedFilters_alias_1 }
+export { RoleSearchAdvancedFilters as RoleSearchAdvancedFilters_alias_2 }
+
+/**
+ * Role Search Params - ข้อมูลสำหรับค้นหาบทบาท
+ */
+declare interface RoleSearchParams {
+    search?: string;
+    page?: number;
+    limit?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    advanced?: RoleSearchAdvancedFilters;
+}
+export { RoleSearchParams }
+export { RoleSearchParams as RoleSearchParams_alias_1 }
+export { RoleSearchParams as RoleSearchParams_alias_2 }
+
+/**
+ * Security JWT Configuration (GET /security/jwt - reads from session_management)
+ * refreshThresholdMinutes, automaticRefreshEnabled: ระบุผ่าน AuthSdkConfig.advanced ตอนสร้าง client
+ */
+declare interface SecurityJwtConfig {
+    access_token_expiry_minutes: number;
+    refresh_token_expiry_days: number;
+    jwt_last_rotated_at?: string;
+}
+export { SecurityJwtConfig }
+export { SecurityJwtConfig as SecurityJwtConfig_alias_1 }
+export { SecurityJwtConfig as SecurityJwtConfig_alias_2 }
+
+/**
+ * Send Email API Request DTO (SDK)
+ *
+ * @description DTO สำหรับส่ง email ผ่าน SDK สำหรับ external applications
+ * รองรับทั้ง Template Mode และ Raw HTML Mode
+ *
+ * === Template Mode ===
+ * - template_code (required) - Template code จาก database
+ * - template_data (optional) - ข้อมูลสำหรับ render template
+ * - subject (optional) - Override subject จาก template
+ * - language (optional) - Template language (default: 'th')
+ *
+ * === Raw HTML Mode ===
+ * - html_body (required) - HTML content โดยตรง
+ * - subject (required) - Email subject
+ * - text_body (optional) - Plain text version (auto-generated ถ้าไม่ระบุ)
+ *
+ * === Recipients ===
+ * - recipient_email (required ถ้าไม่มี recipient_id) - Email address
+ * - recipient_id (required ถ้าไม่มี recipient_email) - User ID (ส่งผ่าน notification system)
+ * - recipient_name (optional) - Display name
+ * - cc (optional) - CC recipients (string หรือ array)
+ * - bcc (optional) - BCC recipients (string หรือ array)
+ *
+ * === Attachments ===
+ * - attachments (optional) - Array ของไฟล์แนบ
+ *
+ * === Validation ===
+ * - ต้องมี template_code หรือ html_body อย่างใดอย่างหนึ่ง (mutual exclusivity)
+ * - ถ้ามี template_code: subject เป็น optional (ใช้จาก template)
+ * - ถ้ามี html_body: subject เป็น required
+ * - ต้องมี recipient_email หรือ recipient_id อย่างใดอย่างหนึ่ง
+ *
+ * @example Template Mode
+ * ```json
+ * {
+ *   "template_code": "welcome_email",
+ *   "template_data": {
+ *     "userName": "สมชาย ใจดี",
+ *     "activationLink": "https://app.com/activate?token=xxx"
+ *   },
+ *   "recipient_email": "user@example.com",
+ *   "recipient_name": "สมชาย ใจดี",
+ *   "language": "th",
+ *   "cc": ["manager@example.com"],
+ *   "attachments": [
+ *     {
+ *       "filename": "welcome.pdf",
+ *       "path": "/uploads/welcome.pdf"
+ *     }
+ *   ]
+ * }
+ * ```
+ *
+ * @example Raw HTML Mode
+ * ```json
+ * {
+ *   "html_body": "<h1>ยินดีต้อนรับ</h1><p>ขอบคุณที่สมัครสมาชิก</p>",
+ *   "subject": "ยินดีต้อนรับสู่ระบบ",
+ *   "recipient_email": "user@example.com",
+ *   "text_body": "ยินดีต้อนรับ ขอบคุณที่สมัครสมาชิก",
+ *   "cc": ["manager@example.com"],
+ *   "bcc": ["archive@example.com"]
+ * }
+ * ```
+ */
+declare interface SendEmailApiRequestDto {
+    // === Template Mode (mutual exclusive with html_body) ===
+    /**
+     * Template code จาก database (required สำหรับ Template Mode)
+     * @example "welcome_email"
+     */
+    template_code?: string;
+
+    /**
+     * Template data สำหรับ render template (optional)
+     * @example { "userName": "John", "activationLink": "https://..." }
+     */
+    template_data?: Record<string, any>;
+
+    /**
+     * Template language (optional, default: 'th')
+     * @example "th" | "en"
+     */
+    language?: 'th' | 'en';
+
+    /**
+     * Override subject จาก template (optional)
+     * ใช้เฉพาะเมื่อต้องการ override subject ที่กำหนดไว้ใน template
+     */
+    subject?: string;
+
+    // === Raw HTML Mode (mutual exclusive with template_code) ===
+    /**
+     * HTML content โดยตรง (required สำหรับ Raw HTML Mode)
+     * @example "<h1>Hello</h1><p>World</p>"
+     */
+    html_body?: string;
+
+    /**
+     * Plain text version (optional)
+     * Auto-generated จาก html_body ถ้าไม่ระบุ
+     */
+    text_body?: string;
+
+    // === Recipients (ต้องมีอย่างใดอย่างหนึ่ง) ===
+    /**
+     * Email address ของผู้รับ (required ถ้าไม่มี recipient_id)
+     * @example "user@example.com"
+     */
+    recipient_email?: string;
+
+    /**
+     * User ID ของผู้รับ (required ถ้าไม่มี recipient_email)
+     * จะส่งผ่าน notification system และสร้าง notification record
+     * @example "user-123e4567-e89b-12d3-a456-426614174000"
+     */
+    recipient_id?: string;
+
+    /**
+     * Display name ของผู้รับ (optional)
+     * @example "สมชาย ใจดี"
+     */
+    recipient_name?: string;
+
+    // === Email Options ===
+    /**
+     * CC recipients (optional)
+     * รองรับทั้ง string (single) และ array (multiple)
+     * @example "manager@example.com" หรือ ["manager@example.com", "team@example.com"]
+     */
+    cc?: string | string[];
+
+    /**
+     * BCC recipients (optional)
+     * รองรับทั้ง string (single) และ array (multiple)
+     * @example "archive@example.com" หรือ ["archive@example.com", "backup@example.com"]
+     */
+    bcc?: string | string[];
+
+    /**
+     * Attachments (optional)
+     * Array ของไฟล์แนบ
+     *
+     * ✅ **ใช้ URL (`href`) เท่านั้น** - Simple และ consistent
+     *
+     * **การใช้งาน:**
+     * 1. External applications: Upload ไฟล์ผ่าน File API (`/files/upload`) แล้วได้ URL กลับมา
+     * 2. Internal applications: ใช้ URL จาก storage service หรือ `/files/:id/content`
+     * 3. Cloud storage: ใช้ URL จาก Azure Blob Storage, AWS S3, Google Cloud Storage, etc.
+     *
+     * @example
+     * ```json
+     * [
+     *   {
+     *     "filename": "report.pdf",
+     *     "href": "https://api.example.com/files/123e4567-e89b-12d3-a456-426614174000/content"
+     *   },
+     *   {
+     *     "filename": "document.pdf",
+     *     "href": "https://storage.azure.com/container/document.pdf"
+     *   }
+     * ]
+     * ```
+     */
+    attachments?: Array<{
+        filename: string;
+        href: string; // URL ของไฟล์ (required) - จาก File API, cloud storage, หรือ public URL
+        content_type?: string; // MIME type (optional, auto-detect จาก filename หรือ URL)
+    }>;
+
+    /**
+     * Priority (optional, default: 'normal')
+     * @example "low" | "normal" | "high" | "urgent"
+     */
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+
+    /**
+     * Scheduled send time (optional)
+     * @example "2024-01-20T10:00:00Z"
+     */
+    scheduled_at?: Date | string;
+
+    /**
+     * Source identifier (optional)
+     * สำหรับ tracking แหล่งที่มาของ email
+     * @example "user_registration" | "order_confirmation"
+     */
+    source?: string;
+
+    /**
+     * Related entity ID (optional)
+     * สำหรับเชื่อมโยงกับ entity อื่น
+     */
+    related_entity_id?: string;
+
+    /**
+     * Related entity type (optional)
+     * @example "user" | "order" | "invoice"
+     */
+    related_entity_type?: string;
+}
+export { SendEmailApiRequestDto }
+export { SendEmailApiRequestDto as SendEmailApiRequestDto_alias_1 }
+export { SendEmailApiRequestDto as SendEmailApiRequestDto_alias_2 }
+
+/**
+ * Send Email API Response - ข้อมูลตอบกลับเมื่อส่ง email สำเร็จ
+ */
+declare interface SendEmailApiResponseDto {
+    /**
+     * Email queue ID (UUID)
+     */
+    email_id: string;
+    /**
+     * Email status
+     * - 'queued': ถูกเพิ่มเข้า queue แล้ว (รอส่ง)
+     * - 'sent': ส่งสำเร็จแล้ว
+     * - 'failed': ส่งล้มเหลว
+     */
+    status: 'queued' | 'sent' | 'failed';
+    /**
+     * Recipient email address
+     */
+    recipient_email: string;
+    /**
+     * Email subject
+     */
+    subject: string;
+    /**
+     * Timestamp when email was queued
+     */
+    queued_at: Date | string;
+    /**
+     * Message ID from SMTP server (optional)
+     * มีเฉพาะเมื่อส่งทันที (ไม่ผ่าน queue)
+     */
+    message_id?: string;
+}
+export { SendEmailApiResponseDto }
+export { SendEmailApiResponseDto as SendEmailApiResponseDto_alias_1 }
+export { SendEmailApiResponseDto as SendEmailApiResponseDto_alias_2 }
+
+/**
+ * Type aliases for cleaner API usage
+ * @alias SendEmailRequest = SendEmailApiRequestDto
+ * @alias SendEmailResponse = SendEmailApiResponseDto
+ */
+declare type SendEmailRequest = SendEmailApiRequestDto;
+export { SendEmailRequest }
+export { SendEmailRequest as SendEmailRequest_alias_1 }
+export { SendEmailRequest as SendEmailRequest_alias_2 }
+
+declare type SendEmailResponse = SendEmailApiResponseDto;
+export { SendEmailResponse }
+export { SendEmailResponse as SendEmailResponse_alias_1 }
+export { SendEmailResponse as SendEmailResponse_alias_2 }
+
+declare interface SendImageRequest {
+    userId: string;
+    originalContentUrl: string;
+    previewImageUrl: string;
+}
+export { SendImageRequest }
+export { SendImageRequest as SendImageRequest_alias_1 }
+export { SendImageRequest as SendImageRequest_alias_2 }
+
+declare interface SendMessagesRequest {
+    userId: string;
+    messages: LineMessagePayload[];
+}
+export { SendMessagesRequest }
+export { SendMessagesRequest as SendMessagesRequest_alias_1 }
+export { SendMessagesRequest as SendMessagesRequest_alias_2 }
+
+declare interface SendNotificationRequest {
+    userId: string;
+    title: string;
+    message: string;
+    type?: 'info' | 'success' | 'warning' | 'error';
+    action_url?: string;
+    priority?: 'low' | 'normal' | 'high';
+}
+export { SendNotificationRequest }
+export { SendNotificationRequest as SendNotificationRequest_alias_1 }
+export { SendNotificationRequest as SendNotificationRequest_alias_2 }
+
+/**
+ * Send OTP Request
+ */
+declare interface SendOTPRequest {
+    method: 'sms' | 'email';
+    recipient: string;
+    context?: string;
+    metadata?: string;
+}
+export { SendOTPRequest }
+export { SendOTPRequest as SendOTPRequest_alias_1 }
+export { SendOTPRequest as SendOTPRequest_alias_2 }
+
+/**
+ * Send OTP Response
+ */
+declare interface SendOTPResponse {
+    otp_id: string;
+    ref_code: string;
+    expires_at: Date;
+    masked_recipient: string;
+}
+export { SendOTPResponse }
+export { SendOTPResponse as SendOTPResponse_alias_1 }
+export { SendOTPResponse as SendOTPResponse_alias_2 }
+
+declare interface SendStickerRequest {
+    userId: string;
+    packageId: string;
+    stickerId: string;
+}
+export { SendStickerRequest }
+export { SendStickerRequest as SendStickerRequest_alias_1 }
+export { SendStickerRequest as SendStickerRequest_alias_2 }
+
+declare interface SendTextMessageRequest {
+    userId: string;
+    message: string;
+}
+export { SendTextMessageRequest }
+export { SendTextMessageRequest as SendTextMessageRequest_alias_1 }
+export { SendTextMessageRequest as SendTextMessageRequest_alias_2 }
+
+/**
+ * Session Management Configuration (unified with JWT)
+ * Configuration for session timeout, expiration, and token settings
+ */
+declare interface SessionManagementConfig {
+    inactivity: {
+        enabled: boolean;
+        timeout_minutes: number;
+        warning_minutes: number;
+    };
+    lifetime: {
+        enabled: boolean;
+        max_lifetime_days: number;
+    };
+    concurrent: {
+        enabled: boolean;
+        max_sessions: number;
+    };
+    notify_on_new_device?: boolean;
+    /** JWT fields (unified from session_management) */
+    jwt_last_rotated_at?: string;
+    access_token_expiry_minutes?: number;
+    refresh_token_expiry_days?: number;
+}
+export { SessionManagementConfig }
+export { SessionManagementConfig as SessionManagementConfig_alias_1 }
+export { SessionManagementConfig as SessionManagementConfig_alias_2 }
+
+/**
+ * System Config Types - SDK Friendly
+ *
+ * Clean, client-focused type names without DTO suffixes
+ */
+/**
+ * System Configuration
+ * A single configuration entry
+ * Matches SystemConfigResponseDto from @win-portal/shared
+ */
+declare interface SystemConfig {
+    id: string;
+    category: string;
+    key: string;
+    value: any;
+    description?: string;
+    data_type?: string;
+    is_secret: boolean;
+    is_read_only: boolean;
+    is_active: boolean;
+    version?: string;
+    metadata?: {
+        feature?: string;
+        last_updated_by?: string;
+        migration_source?: string;
+        validation?: {
+            required?: boolean;
+            min?: number;
+            max?: number;
+            enum?: any[];
+            pattern?: string;
+        };
+    };
+    created_at: string;
+    updated_at: string;
+    status: string;
+    full_key?: string;
+}
+export { SystemConfig }
+export { SystemConfig as SystemConfig_alias_1 }
+export { SystemConfig as SystemConfig_alias_2 }
+
+/**
+ * System Config API
+ * Methods for retrieving system configurations
+ * Based on: apps/api/src/modules/shared/core/controllers/system-config.controller.ts
+ */
+declare class SystemConfigAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * GET /system-configs/categories/:category
+     * ดึง configs ตาม category - ส่ง object ที่รวมทุก key เป็น { key1: value1, key2: value2 }
+     */
+    private getByCategory;
+    /**
+     * GET /system-configs/categories/:category/:key
+     * ดึง config value ตรงๆ (API returns config.value directly, NOT the full SystemConfig row)
+     */
+    private getByCategoryAndKey;
+    /**
+     * Get config by category (returns all keys), or by category+key (returns value directly)
+     */
+    get(category: string): Promise<SystemConfigByCategory>;
+    get<T = any>(category: string, key: string): Promise<T>;
+    /**
+     * GET /system-configs/categories/security/session_management
+     * ดึง Session Management configuration (convenience method)
+     */
+    getSessionManagement(): Promise<SessionManagementConfig>;
+    /**
+     * GET /system-configs/categories/security/jwt
+     * ดึง Security JWT configuration (convenience method)
+     */
+    getSecurityJwt(): Promise<SecurityJwtConfig>;
+}
+export { SystemConfigAPI }
+export { SystemConfigAPI as SystemConfigAPI_alias_1 }
+export { SystemConfigAPI as SystemConfigAPI_alias_2 }
+
+/**
+ * System Config by Category
+ * Returns an object with key-value pairs for a category
+ */
+declare type SystemConfigByCategory = Record<string, any>;
+export { SystemConfigByCategory }
+export { SystemConfigByCategory as SystemConfigByCategory_alias_1 }
+export { SystemConfigByCategory as SystemConfigByCategory_alias_2 }
+
+/**
+ * Task Action Request
+ */
+declare interface TaskActionRequest {
+    action_key: string;
+    comments?: string;
+    delegate_to_user_id?: string;
+    escalate_to_user_id?: string;
+    return_to_node_id?: string;
+    reason?: string;
+    [key: string]: any;
+}
+export { TaskActionRequest }
+export { TaskActionRequest as TaskActionRequest_alias_1 }
+export { TaskActionRequest as TaskActionRequest_alias_2 }
+
+/**
+ * Todo Response
+ *
+ * @description Complete todo data returned from API
+ * Matches TodoResponseDto from @win-portal/shared
+ *
+ * @properties
+ * - id: รหัส todo (required) UUID ของ todo
+ * - title: หัวข้องาน (required) ชื่อหรือหัวข้อของงานที่ต้องทำ
+ * - description: รายละเอียดงาน (optional) คำอธิบายเพิ่มเติมของงาน
+ * - due_date: วันครบกำหนด (optional) วันที่ต้องเสร็จงาน
+ * - priority: ระดับความสำคัญ (required) เช่น low, normal, high
+ * - is_completed: สถานะเสร็จ (required) true = เสร็จแล้ว, false = ยังไม่เสร็จ
+ * - completed_at: วันที่เสร็จ (optional) timestamp เมื่อ mark เป็นเสร็จ
+ * - category: หมวดหมู่ (optional) เช่น "work", "personal", "shopping"
+ * - labels: ป้ายกำกับ (optional) tags สำหรับการค้นหาและจัดกลุ่ม
+ * - link_url: ลิงก์อ้างอิง (optional) URL ที่เกี่ยวข้องกับงาน
+ * - is_send_notification: ส่งการแจ้งเตือน (required) การตั้งค่า notification
+ * - user_id: รหัสผู้ใช้ (required) เป็นของ user คนนี้
+ * - application_id: รหัสแอปพลิเคชัน (optional) แอปพลิเคชันที่สร้าง todo นี้
+ * - created_at: วันที่สร้าง (required) timestamp เมื่อสร้าง todo
+ * - updated_at: วันที่แก้ไข (required) timestamp เมื่อแก้ไขล่าสุด
+ * - status: สถานะ entity (required) จาก IBaseEntity
+ * - is_overdue: เกินกำหนด (computed) true = เกินวันครบกำหนดแล้ว
+ * - days_until_due: จำนวนวันจนครบกำหนด (computed) จำนวนวันที่เหลือ
+ * - application: ข้อมูลแอปพลิเคชัน (optional) ข้อมูลแอปพลิเคชันที่เกี่ยวข้อง
+ * - sub_tasks: รายการ sub-tasks (optional) รายการ sub-tasks ของ todo นี้
+ * - subtasks_count: จำนวน sub-tasks (optional) จำนวน sub-tasks ทั้งหมด
+ * - completed_subtasks_count: จำนวน sub-tasks ที่เสร็จแล้ว (optional)
+ * - assigned_to: ข้อมูลผู้รับผิดชอบ (optional) ข้อมูล user ที่รับผิดชอบ
+ * - assigned_by: ข้อมูลผู้มอบหมาย (optional) ข้อมูล user ที่มอบหมาย
+ *
+ * @example
+ * ```typescript
+ * const todo: Todo = {
+ *   id: "todo123e4567-e89b-12d3-a456-426614174000",
+ *   title: "ซื้อของใช้ในบ้าน",
+ *   description: "ซื้อน้ำยาล้างจาน, กระดาษทิชชู่, แชมพู",
+ *   due_date: "2024-01-20T17:00:00Z",
+ *   priority: "normal",
+ *   is_completed: false,
+ *   category: "shopping",
+ *   labels: ["บ้าน", "จำเป็น"],
+ *   link_url: "https://www.bigc.co.th/shopping-list",
+ *   is_send_notification: true,
+ *   user_id: "user123e4567-e89b-12d3-a456-426614174000",
+ *   application_id: "app123e4567-e89b-12d3-a456-426614174000",
+ *   created_at: "2024-01-15T10:00:00Z",
+ *   updated_at: "2024-01-15T10:00:00Z",
+ *   status: "active",
+ *   is_overdue: false,
+ *   days_until_due: 5
+ * };
+ * ```
+ */
+declare interface Todo {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    status: string;
+    title: string;
+    description?: string;
+    due_date?: string;
+    priority: TodoPriority | string;
+    is_completed: boolean;
+    completed_at?: string;
+    category?: string;
+    labels?: string[];
+    link_url?: string;
+    is_send_notification: boolean;
+    user_id: string;
+    application_id?: string;
+    parent_id?: string;
+    order?: number;
+    level?: number;
+    assigned_to_id?: string;
+    assigned_by_id?: string;
+    assigned_at?: string;
+    is_overdue?: boolean;
+    days_until_due?: number;
+    application?: {
+        id: string;
+        name: string;
+        code: string;
+    };
+    sub_tasks?: Todo[];
+    subtasks_count?: number;
+    completed_subtasks_count?: number;
+    assigned_to?: {
+        id: string;
+        first_name: string;
+        last_name: string;
+        email: string;
+    };
+    assigned_by?: {
+        id: string;
+        first_name: string;
+        last_name: string;
+        email: string;
+    };
+}
+export { Todo }
+export { Todo as Todo_alias_1 }
+export { Todo as Todo_alias_2 }
+
+declare class TodoAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Create a new todo
+     *
+     * @example
+     * ```typescript
+     * const todo = await authClient.todo.create({
+     *   title: "ซื้อของใช้ในบ้าน",
+     *   priority: TodoPriority.NORMAL,
+     *   user_id: "user123e4567-e89b-12d3-a456-426614174000",
+     *   description: "ซื้อน้ำยาล้างจาน, กระดาษทิชชู่, แชมพู",
+     *   due_date: new Date("2024-01-20T17:00:00Z"),
+     *   category: "shopping",
+     *   labels: ["บ้าน", "จำเป็น"],
+     *   is_send_notification: true
+     * });
+     * ```
+     */
+    create(todoData: CreateTodoRequest): Promise<Todo>;
+}
+export { TodoAPI }
+export { TodoAPI as TodoAPI_alias_1 }
+export { TodoAPI as TodoAPI_alias_2 }
+
+/**
+ * Todo Priority Enum
+ *
+ * @description ระดับความสำคัญของงานใน todo list
+ */
+declare enum TodoPriority {
+    LOW = 'low',
+    NORMAL = 'normal',
+    HIGH = 'high',
+}
+export { TodoPriority }
+export { TodoPriority as TodoPriority_alias_1 }
+export { TodoPriority as TodoPriority_alias_2 }
+
+/**
+ * Update Organization Request
+ */
+declare interface UpdateOrganizationRequest {
+    name?: string;
+    code?: string;
+    parent_id?: string;
+    description?: string;
+    logo_file_id?: string;
+    report_to_position_id?: string;
+    is_active?: boolean;
+}
+export { UpdateOrganizationRequest }
+export { UpdateOrganizationRequest as UpdateOrganizationRequest_alias_1 }
+export { UpdateOrganizationRequest as UpdateOrganizationRequest_alias_2 }
+
+/**
+ * Update Permission Category Request
+ */
+declare interface UpdatePermissionCategoryRequest {
+    name?: string;
+    key?: string;
+    description?: string;
+    resource?: string;
+    parent_id?: string;
+    permissions?: Omit<CreatePermissionRequest, 'category_id'>[];
+}
+export { UpdatePermissionCategoryRequest }
+export { UpdatePermissionCategoryRequest as UpdatePermissionCategoryRequest_alias_1 }
+export { UpdatePermissionCategoryRequest as UpdatePermissionCategoryRequest_alias_2 }
+
+/**
+ * Update Permission Request
+ */
+declare interface UpdatePermissionRequest {
+    name?: string;
+    key?: string;
+    description?: string;
+}
+export { UpdatePermissionRequest }
+export { UpdatePermissionRequest as UpdatePermissionRequest_alias_1 }
+export { UpdatePermissionRequest as UpdatePermissionRequest_alias_2 }
+
+/**
+ * Update Role Request - ข้อมูลสำหรับอัพเดทบทบาท
+ */
+declare interface UpdateRoleRequest {
+    name?: string;
+    code?: string;
+    description?: string;
+}
+export { UpdateRoleRequest }
+export { UpdateRoleRequest as UpdateRoleRequest_alias_1 }
+export { UpdateRoleRequest as UpdateRoleRequest_alias_2 }
+
+/**
+ * Update User Request - ข้อมูลสำหรับอัปเดตผู้ใช้
+ * Matches UpdateUserRequestDto from @win-portal/shared
+ */
+declare interface UpdateUserRequest {
+    first_name?: string;
+    last_name?: string;
+    first_name_en?: string;
+    last_name_en?: string;
+    username?: string;
+    code?: string;
+    phone_number?: string;
+    avatar_file_id?: string;
+    signature_file_id?: string;
+    role_ids?: string[];
+    metadata?: Record<string, any>;
+    preferences?: {
+        language?: string;
+        timezone?: string;
+        notifications?: boolean;
+        theme?: string;
+        [key: string]: any;
+    };
+}
+export { UpdateUserRequest }
+export { UpdateUserRequest as UpdateUserRequest_alias_1 }
+export { UpdateUserRequest as UpdateUserRequest_alias_2 }
+
+/**
+ * Update Workflow Instance Request
+ */
+declare interface UpdateWorkflowInstanceRequest {
+    document_title?: string;
+    document_url?: string;
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+    form_data?: Record<string, any>;
+    context_variables?: Record<string, any>;
+}
+export { UpdateWorkflowInstanceRequest }
+export { UpdateWorkflowInstanceRequest as UpdateWorkflowInstanceRequest_alias_1 }
+export { UpdateWorkflowInstanceRequest as UpdateWorkflowInstanceRequest_alias_2 }
+
+/**
+ * User Types for Auth SDK
+ *
+ * @description Types สำหรับ user CRUD operations ใน SDK
+ */
+/**
+ * User - ข้อมูลผู้ใช้พื้นฐาน
+ * Matches UserResponseDto from @win-portal/shared
+ */
+declare interface User {
+    id: string;
+    code?: string;
+    email: string;
+    username?: string;
+    first_name: string;
+    last_name: string;
+    first_name_en?: string;
+    last_name_en?: string;
+    avatar_file_id?: string;
+    avatar_url?: string;
+    signature_file_id?: string;
+    signature_url?: string;
+    phone_number?: string;
+    status: string;
+    last_login_at?: Date | string;
+    login_attempts: number;
+    locked_until?: Date | string;
+    must_change_password: boolean;
+    is_system: boolean;
+    created_at: Date | string;
+    updated_at: Date | string;
+    full_name?: string;
+    permissions: string[];
+    roles: Array<{
+        id: string;
+        name: string;
+        code: string;
+        description?: string;
+    }>;
+    positions?: Array<{
+        id: string;
+        name: string;
+        code: string;
+        type?: string;
+        is_primary: boolean;
+    }>;
+    primary_position?: {
+        id: string;
+        name: string;
+        code: string;
+        type?: string;
+    } | null;
+    primary_department?: {
+        id: string;
+        name: string;
+        code: string;
+        type?: string;
+    } | null;
+    metadata?: Record<string, any>;
+}
+export { User }
+export { User as User_alias_1 }
+export { User as User_alias_2 }
+
+declare class UserAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Search users with pagination and filters
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.user.search({
+     *   search: "สมชาย",
+     *   page: 1,
+     *   limit: 20,
+     *   sort_by: "created_at",
+     *   sort_order: "desc",
+     *   advanced: {
+     *     status: "active",
+     *     department_id: "dept-123"
+     *   }
+     * });
+     *
+     * // Access paginated data
+     * console.log(result.data); // User[]
+     * console.log(result.pagination.total); // Total count
+     * console.log(result.pagination.has_next); // Has next page
+     * ```
+     */
+    search(params?: UserSearchParams): Promise<ApiPaginatedResponse<User>>;
+    /**
+     * Get user by ID
+     *
+     * @example
+     * ```typescript
+     * const user = await authClient.user.get("user-123");
+     * ```
+     */
+    get(userId: string): Promise<User>;
+    /**
+     * Create a new user
+     *
+     * @description ถ้าไม่ระบุ password ระบบจะ auto generate และส่ง reset password link ไปทางอีเมล
+     * ถ้าระบุ password ระบบจะใช้ password ที่ส่งมาและส่ง welcome email พร้อม login link
+     *
+     * @example
+     * ```typescript
+     * // กรณีที่มี password - ระบบจะส่ง welcome email พร้อม login link
+     * const newUser = await authClient.user.create({
+     *   email: "user@example.com",
+     *   first_name: "สมชาย",
+     *   last_name: "ใจดี",
+     *   password: "SecurePassword123!",
+     *   code: "USR-2024-001",
+     *   role_ids: ["role-123", "role-456"] // Optional: assign roles immediately
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // กรณีที่ไม่มี password - ระบบจะ auto generate และส่ง welcome email พร้อม reset password link
+     * const newUser = await authClient.user.create({
+     *   email: "user@example.com",
+     *   first_name: "สมชาย",
+     *   last_name: "ใจดี",
+     *   code: "USR-2024-002"
+     * });
+     * ```
+     */
+    create(userData: CreateUserRequest): Promise<User>;
+    /**
+     * Update user
+     *
+     * @example
+     * ```typescript
+     * const updatedUser = await authClient.user.update("user-123", {
+     *   first_name: "สมชาย",
+     *   last_name: "ใจดีมาก",
+     *   phone_number: "+66812345678",
+     *   role_ids: ["role-123", "role-456"] // Optional: replace all roles
+     * });
+     * ```
+     */
+    update(userId: string, userData: UpdateUserRequest): Promise<User>;
+    /**
+     * Delete user
+     *
+     * @example
+     * ```typescript
+     * await authClient.user.delete("user-123");
+     * ```
+     */
+    delete(userId: string): Promise<void>;
+    /**
+     * Get user positions
+     *
+     * @description ดึงรายการตำแหน่งทั้งหมดของผู้ใช้
+     *
+     * @example
+     * ```typescript
+     * const positions = await authClient.user.getPositions("user-123");
+     * const primaryPosition = positions.find(p => p.is_primary);
+     * ```
+     */
+    getPositions(userId: string): Promise<User['positions']>;
+    /**
+     * Assign positions to user
+     *
+     * @description มอบหมายตำแหน่งให้ผู้ใช้ รองรับการมอบหมายหลายตำแหน่งพร้อมกัน
+     *
+     * @example
+     * ```typescript
+     * // Replace mode (default) - ทับตำแหน่งเดิมทั้งหมด
+     * const result = await authClient.user.assignPositions("user-123", {
+     *   positions: [
+     *     { position_id: "pos-001", is_primary: true },
+     *     { position_id: "pos-002", is_primary: false }
+     *   ],
+     *   mode: "replace"
+     * });
+     *
+     * // Add mode - เพิ่มตำแหน่งใหม่โดยไม่ลบของเดิม
+     * const result = await authClient.user.assignPositions("user-123", {
+     *   positions: [
+     *     { position_id: "pos-003", is_primary: false }
+     *   ],
+     *   mode: "add"
+     * });
+     * ```
+     */
+    assignPositions(userId: string, data: AssignPositionsRequest): Promise<AssignmentResponse>;
+    /**
+     * Unassign positions from user
+     *
+     * @description ยกเลิกตำแหน่งจากผู้ใช้
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.user.unassignPositions("user-123", ["pos-001", "pos-002"]);
+     * ```
+     */
+    unassignPositions(userId: string, positionIds: string[]): Promise<AssignmentResponse>;
+    /**
+     * Get user roles
+     *
+     * @description ดึงรายการบทบาททั้งหมดของผู้ใช้
+     *
+     * @example
+     * ```typescript
+     * const roles = await authClient.user.getRoles("user-123");
+     * console.log(roles.map(r => r.name)); // ["Admin", "Manager"]
+     * ```
+     */
+    getRoles(userId: string): Promise<Role[]>;
+    /**
+     * Assign roles to user
+     *
+     * @description มอบหมายบทบาทให้ผู้ใช้ (แทนที่บทบาทเดิมทั้งหมด)
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.user.assignRoles("user-123", ["role-001", "role-002"]);
+     * ```
+     */
+    assignRoles(userId: string, roleIds: string[]): Promise<AssignmentResponse>;
+    /**
+     * Unassign roles from user
+     *
+     * @description ยกเลิกบทบาทจากผู้ใช้
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.user.unassignRoles("user-123", ["role-001"]);
+     * ```
+     */
+    unassignRoles(userId: string, roleIds: string[]): Promise<AssignmentResponse>;
+    /**
+     * Sync users for external applications
+     *
+     * @description ดึงข้อมูลผู้ใช้แบบ paginated สำหรับ sync operations
+     * ใช้สำหรับ external applications ที่ต้องการ sync user data
+     * ต้องใช้ API Key authentication
+     *
+     * @example
+     * ```typescript
+     * // Sync all users (first page)
+     * const result = await authClient.user.sync({
+     *   page: 1,
+     *   page_size: 100
+     * });
+     *
+     * // Sync users updated after specific date
+     * const updatedUsers = await authClient.user.sync({
+     *   page: 1,
+     *   page_size: 100,
+     *   updated_after: new Date('2024-01-01')
+     * });
+     *
+     * // Access paginated data
+     * console.log(result.data); // UserSyncResponse[]
+     * console.log(result.pagination.total); // Total count
+     * console.log(result.pagination.has_next); // Has next page
+     * ```
+     */
+    sync(params?: UserSyncParams): Promise<ApiPaginatedResponse<UserSyncResponse>>;
+}
+export { UserAPI }
+export { UserAPI as UserAPI_alias_1 }
+export { UserAPI as UserAPI_alias_2 }
+
+/**
+ * User Position Assignment - ข้อมูลตำแหน่งสำหรับการมอบหมายให้ผู้ใช้
+ *
+ * Structurally identical to `@win-portal/shared` `UserPositionAssignmentDto`.
+ * Kept local so api-extractor can inline the shape into the published dts
+ * without retaining a reference to `@win-portal/shared`.
+ */
+declare interface UserPositionAssignment {
+    position_id: string;
+    is_primary: boolean;
+}
+export { UserPositionAssignment }
+export { UserPositionAssignment as UserPositionAssignment_alias_1 }
+export { UserPositionAssignment as UserPositionAssignment_alias_2 }
+
+/**
+ * User Search Advanced Filters
+ */
+declare interface UserSearchAdvancedFilters {
+    status?: string;
+    is_active?: boolean;
+    is_locked?: boolean;
+    department_id?: string;
+    position_id?: string;
+    role_id?: string;
+    has_roles?: boolean;
+    date_range?: {
+        start: Date | string;
+        end: Date | string;
+    };
+    has_logged_in?: boolean;
+    last_login_range?: {
+        start: Date | string;
+        end: Date | string;
+    };
+}
+export { UserSearchAdvancedFilters }
+export { UserSearchAdvancedFilters as UserSearchAdvancedFilters_alias_1 }
+export { UserSearchAdvancedFilters as UserSearchAdvancedFilters_alias_2 }
+
+/**
+ * User Search Params - ข้อมูลสำหรับค้นหาผู้ใช้
+ */
+declare interface UserSearchParams {
+    search?: string;
+    page?: number;
+    limit?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    advanced?: UserSearchAdvancedFilters;
+}
+export { UserSearchParams }
+export { UserSearchParams as UserSearchParams_alias_1 }
+export { UserSearchParams as UserSearchParams_alias_2 }
+
+/**
+ * User Summary - ข้อมูลผู้ใช้แบบย่อสำหรับ tree node
+ */
+declare interface UserSummary {
+    id: string;
+    code?: string;
+    email: string;
+    fullname: string;
+    first_name?: string;
+    last_name?: string;
+    username?: string;
+    avatar_url?: string;
+    status: string;
+    positions?: Array<{
+        id: string;
+        name: string;
+        code: string;
+        type: string;
+        is_primary: boolean;
+    }>;
+}
+export { UserSummary }
+export { UserSummary as UserSummary_alias_1 }
+export { UserSummary as UserSummary_alias_2 }
+
+/**
+ * User Sync Params - ข้อมูลสำหรับ sync users
+ */
+declare interface UserSyncParams {
+    page?: number;
+    page_size?: number;
+    updated_after?: Date | string;
+}
+export { UserSyncParams }
+export { UserSyncParams as UserSyncParams_alias_1 }
+export { UserSyncParams as UserSyncParams_alias_2 }
+
+/**
+ * User Sync Response - ข้อมูลผู้ใช้สำหรับ sync operations
+ * Matches UserSyncResponseDto from @win-portal/shared
+ */
+declare interface UserSyncResponse {
+    id: string;
+    code: string;
+    email: string;
+    username: string;
+    first_name: string;
+    last_name: string;
+    first_name_en: string;
+    last_name_en: string;
+    phone_number: string;
+    avatar_url: string;
+    signature_url: string;
+    status: string;
+    is_active: boolean;
+    is_system: boolean;
+    roles: Array<{
+        id: string;
+        name: string;
+        code: string;
+    }>;
+    positions: Array<{
+        id: string;
+        title: string;
+        code: string;
+        department: {
+            id: string;
+            name: string;
+            code: string;
+        } | null;
+        is_primary: boolean;
+    }>;
+    metadata: Record<string, any>;
+    created_at: Date | string;
+    updated_at: Date | string;
+}
+export { UserSyncResponse }
+export { UserSyncResponse as UserSyncResponse_alias_1 }
+export { UserSyncResponse as UserSyncResponse_alias_2 }
+
+/**
+ * Verify OTP Request
+ */
+declare interface VerifyOTPRequest {
+    otp_id: string;
+    code: string;
+}
+export { VerifyOTPRequest }
+export { VerifyOTPRequest as VerifyOTPRequest_alias_1 }
+export { VerifyOTPRequest as VerifyOTPRequest_alias_2 }
+
+/**
+ * Verify OTP Response
+ */
+declare interface VerifyOTPResponse {
+    verified: boolean;
+}
+export { VerifyOTPResponse }
+export { VerifyOTPResponse as VerifyOTPResponse_alias_1 }
+export { VerifyOTPResponse as VerifyOTPResponse_alias_2 }
+
+declare class WebhookAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * ส่ง webhook request ผ่าน proxy endpoint
+     *
+     * @description
+     * - ส่ง webhook request ไปยัง external URL ผ่านระบบ proxy
+     * - ระบบจะสร้าง webhook_log และยิง webhook ออกไปให้
+     * - รองรับ retry mechanism อัตโนมัติ
+     * - ส่ง async: true เพื่อยิงทันทีและรับ result (http_status, response_body) ใน response
+     *
+     * @example
+     * ```typescript
+     * // ส่ง webhook request (โหมดปกติ - ได้ webhook_log_id กลับมา แล้วค่อย getStatus ตรวจสอบ)
+     * const result = await authClient.webhook.proxy({
+     *   webhook_url: 'https://api.example.com/webhooks/users',
+     *   event_type: 'user.created',
+     *   payload: {
+     *     data: { id: 'user-123', email: 'user@example.com' },
+     *     object: 'event',
+     *     type: 'user.created'
+     *   },
+     *   headers: { 'Authorization': 'Bearer token' },
+     *   secret: 'webhook-secret',
+     *   timeout_ms: 30000,
+     *   max_retries: 3
+     * });
+     * console.log('Webhook Log ID:', result.webhook_log_id);
+     *
+     * // โหมด async: true - ยิงทันทีและได้ result กลับใน response (ไม่ต้อง getStatus)
+     * const resultAsync = await authClient.webhook.proxy({
+     *   webhook_url: 'https://api.example.com/webhooks/users',
+     *   event_type: 'user.created',
+     *   payload: { data: { id: 'user-123' }, object: 'event', type: 'user.created' },
+     *   async: true
+     * });
+     * if (resultAsync.status === 'success') {
+     *   console.log('HTTP Status:', resultAsync.http_status);
+     *   console.log('Response Body:', resultAsync.response_body);
+     *   console.log('Execution Time:', resultAsync.execution_time_ms, 'ms');
+     * } else {
+     *   console.error('Failed:', resultAsync.error_message);
+     * }
+     * ```
+     */
+    proxy(request: WebhookProxyRequest): Promise<WebhookProxyResponse>;
+    /**
+     * ดึง webhook log detail ตาม ID
+     *
+     * @description
+     * - ดึงข้อมูล webhook log ตาม ID ที่ส่งกลับมาจาก proxy()
+     * - แสดง status, response, error message, และข้อมูลอื่นๆ
+     * - สามารถดึงได้เฉพาะ webhook logs ของ application ที่ authenticate อยู่เท่านั้น
+     *
+     * @example
+     * ```typescript
+     * // ดึง webhook log detail
+     * const log = await authClient.webhook.getStatus('log-123e4567-e89b-12d3-a456-426614174000');
+     *
+     * console.log('Status:', log.status); // 'success', 'failed', 'pending', 'retrying'
+     * console.log('HTTP Status:', log.http_status); // 200, 404, 500, etc.
+     * console.log('Response Body:', log.response_body);
+     * console.log('Error:', log.error_message);
+     * console.log('Execution Time:', log.execution_time_ms, 'ms');
+     * console.log('Retry Count:', log.retry_count);
+     *
+     * // ตรวจสอบว่า webhook สำเร็จหรือไม่
+     * if (log.status === 'success') {
+     *   console.log('Webhook delivered successfully!');
+     * } else if (log.status === 'failed') {
+     *   console.error('Webhook failed:', log.error_message);
+     * }
+     * ```
+     */
+    getStatus(webhookLogId: string): Promise<WebhookLogDetail>;
+}
+export { WebhookAPI }
+export { WebhookAPI as WebhookAPI_alias_1 }
+export { WebhookAPI as WebhookAPI_alias_2 }
+
+/**
+ * Webhook Log Detail
+ * ข้อมูล detail ของ webhook log
+ */
+declare interface WebhookLogDetail {
+    /** รหัส webhook log */
+    id: string;
+    /** รหัส webhook config ที่ใช้ (optional สำหรับ proxy webhooks) */
+    webhook_config_id?: string;
+    /** รหัส application ที่เกี่ยวข้อง */
+    application_id?: string;
+    /** แหล่งที่มาของ webhook (internal/external) */
+    source: 'internal' | 'external';
+    /** URL ที่ส่ง webhook ไป */
+    webhook_url: string;
+    /** ประเภทของ event */
+    event_type: string;
+    /** Payload ที่ส่งไป */
+    payload: Record<string, any>;
+    /** สถานะของการส่ง webhook */
+    status: 'pending' | 'success' | 'failed' | 'retrying';
+    /** HTTP status code ที่ได้รับกลับมา */
+    http_status?: number;
+    /** HTTP request headers จาก external ที่เรียกเข้ามา */
+    request_headers?: Record<string, string>;
+    /** Headers ที่จะใช้ส่งไปกับ axios (จาก DTO หรือ webhook config) */
+    headers?: Record<string, string>;
+    /** Headers ที่ได้รับกลับมาจาก response */
+    response_headers?: Record<string, string>;
+    /** Response body ที่ได้รับกลับมา */
+    response_body?: string;
+    /** Error message หากเกิดข้อผิดพลาด */
+    error_message?: string;
+    /** จำนวนครั้งที่ retry แล้ว */
+    retry_count: number;
+    /** เวลาที่จะ retry ครั้งถัดไป */
+    next_retry_at?: Date | string;
+    /** เวลาที่เสร็จสิ้น (สำเร็จหรือล้มเหลว) */
+    completed_at?: Date | string;
+    /** เวลาที่ใช้ในการส่ง request (milliseconds) */
+    execution_time_ms?: number;
+    /** วันที่สร้าง */
+    created_at: Date | string;
+    /** วันที่อัพเดทล่าสุด */
+    updated_at: Date | string;
+}
+export { WebhookLogDetail }
+export { WebhookLogDetail as WebhookLogDetail_alias_1 }
+export { WebhookLogDetail as WebhookLogDetail_alias_2 }
+export { WebhookLogDetail as WebhookLogDetail_alias_3 }
+
+/**
+ * Webhook Types for Auth SDK
+ *
+ * @description Types สำหรับ webhook proxy operations ใน SDK
+ */
+/**
+ * Webhook Proxy Request
+ * สำหรับส่ง webhook request ผ่าน proxy endpoint
+ */
+declare interface WebhookProxyRequest {
+    /** URL ปลายทางที่จะส่ง webhook ไป */
+    webhook_url: string;
+    /** ประเภทของ event */
+    event_type: string;
+    /** Payload ที่จะส่งไป */
+    payload: Record<string, any>;
+    /** HTTP headers ที่จะส่งไปกับ request */
+    headers?: Record<string, string>;
+    /** Secret key สำหรับ HMAC signature */
+    secret?: string;
+    /** Timeout ในการส่ง request (milliseconds) */
+    timeout_ms?: number;
+    /** จำนวนครั้งสูงสุดที่จะ retry */
+    max_retries?: number;
+    /** ถ้า true = ยิงทันทีและส่ง result (http_status, response_body) กลับใน response */
+    async?: boolean;
+}
+export { WebhookProxyRequest }
+export { WebhookProxyRequest as WebhookProxyRequest_alias_1 }
+export { WebhookProxyRequest as WebhookProxyRequest_alias_2 }
+export { WebhookProxyRequest as WebhookProxyRequest_alias_3 }
+
+/**
+ * Webhook Proxy Response
+ * Response หลังจากส่ง webhook request
+ * เมื่อส่ง async: true จะมี http_status, response_body, execution_time_ms (และ error_message ถ้าล้มเหลว)
+ */
+declare interface WebhookProxyResponse {
+    /** รหัส webhook log ที่สร้างขึ้น */
+    webhook_log_id: string;
+    /** สถานะการส่ง webhook */
+    status: 'pending' | 'success' | 'failed' | 'retrying';
+    /** ข้อความอธิบาย */
+    message: string;
+    /** HTTP status จากปลายทาง (เมื่อ async=true) */
+    http_status?: number;
+    /** Response body จากปลายทาง (เมื่อ async=true) */
+    response_body?: unknown;
+    /** เวลาที่ใช้ส่ง request มิลลิวินาที (เมื่อ async=true) */
+    execution_time_ms?: number;
+    /** ข้อความ error (เมื่อ async=true และล้มเหลว) */
+    error_message?: string;
+}
+export { WebhookProxyResponse }
+export { WebhookProxyResponse as WebhookProxyResponse_alias_1 }
+export { WebhookProxyResponse as WebhookProxyResponse_alias_2 }
+export { WebhookProxyResponse as WebhookProxyResponse_alias_3 }
+
+declare class WorkflowAPI {
+    private readonly axios;
+    constructor(axios: AxiosInstance);
+    /**
+     * Get workflow instance by ID
+     *
+     * @example
+     * ```typescript
+     * const instance = await authClient.workflow.getInstance("wf-inst-123");
+     * ```
+     */
+    getInstance(instanceId: string): Promise<WorkflowInstance>;
+    /**
+     * Create a new workflow instance
+     *
+     * @example
+     * ```typescript
+     * const instance = await authClient.workflow.createInstance({
+     *   workflow_definition_id: "wf-def-123",
+     *   document_id: "doc-123",
+     *   document_type: "purchase_request",
+     *   document_title: "ขอซื้อคอมพิวเตอร์",
+     *   priority: "high",
+     *   position_id: "pos-123",
+     *   form_data: {
+     *     amount: 150000,
+     *     items: ["Laptop", "Monitor"]
+     *   },
+     *   user_id: "user-123"
+     * });
+     * ```
+     */
+    createInstance(instanceData: CreateWorkflowInstanceRequest): Promise<WorkflowInstance>;
+    /**
+     * Update workflow instance
+     *
+     * @example
+     * ```typescript
+     * const updatedInstance = await authClient.workflow.updateInstance("wf-inst-123", {
+     *   document_title: "ขอซื้อคอมพิวเตอร์ (แก้ไข)",
+     *   priority: "urgent"
+     * });
+     * ```
+     */
+    updateInstance(instanceId: string, instanceData: UpdateWorkflowInstanceRequest): Promise<WorkflowInstance>;
+    /**
+     * Search workflow instances with pagination and filters
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.workflow.searchInstances({
+     *   search: "ขอซื้อ",
+     *   page: 1,
+     *   limit: 20,
+     *   sort_by: "created_at",
+     *   sort_order: "desc",
+     *   filters: {
+     *     status: ["running", "pending"],
+     *     priority: ["high", "urgent"]
+     *   }
+     * });
+     *
+     * // Access paginated data
+     * console.log(result.data); // WorkflowInstance[]
+     * console.log(result.pagination.total); // Total count
+     * console.log(result.pagination.has_next); // Has next page
+     * ```
+     */
+    searchInstances(params?: WorkflowInstanceSearchParams): Promise<ApiPaginatedResponse<WorkflowInstance>>;
+    /**
+     * Get workflow task by ID
+     *
+     * @example
+     * ```typescript
+     * const task = await authClient.workflow.getTask("task-123");
+     * ```
+     */
+    getTask(taskId: string): Promise<WorkflowTask>;
+    /**
+     * Get user tasks with pagination and filters
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.workflow.getUserTasks({
+     *   status: ["assigned", "in_progress"],
+     *   priority: ["high"],
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Access paginated data
+     * console.log(result.data); // WorkflowTask[]
+     * console.log(result.pagination.total); // Total count
+     * ```
+     */
+    getUserTasks(params?: WorkflowTaskSearchParams): Promise<ApiPaginatedResponse<WorkflowTask>>;
+    /**
+     * Perform action on workflow task (approve, reject, delegate, escalate, etc.)
+     *
+     * @example
+     * ```typescript
+     * // Approve task
+     * const result = await authClient.workflow.performTaskAction("task-123", {
+     *   action_key: "approve",
+     *   comments: "อนุมัติตามขั้นตอน"
+     * });
+     *
+     * // Reject task
+     * const result = await authClient.workflow.performTaskAction("task-123", {
+     *   action_key: "reject",
+     *   comments: "ไม่ผ่านตามเงื่อนไข",
+     *   reason: "งบประมาณไม่เพียงพอ"
+     * });
+     *
+     * // Delegate task
+     * const result = await authClient.workflow.performTaskAction("task-123", {
+     *   action_key: "delegate",
+     *   delegate_to_user_id: "user-456",
+     *   comments: "มอบหมายให้ผู้จัดการพิจารณา"
+     * });
+     * ```
+     */
+    performTaskAction(taskId: string, actionData: TaskActionRequest): Promise<WorkflowTask>;
+    /**
+     * Get workflow definition by ID
+     *
+     * @example
+     * ```typescript
+     * const definition = await authClient.workflow.getDefinition("wf-def-123");
+     * ```
+     */
+    getDefinition(definitionId: string): Promise<WorkflowDefinition>;
+    /**
+     * Search workflow definitions with pagination and filters
+     *
+     * @example
+     * ```typescript
+     * const result = await authClient.workflow.searchDefinitions({
+     *   search: "อนุมัติ",
+     *   page: 1,
+     *   limit: 20,
+     *   filters: {
+     *     status: ["active"]
+     *   }
+     * });
+     *
+     * // Access paginated data
+     * console.log(result.data); // WorkflowDefinition[]
+     * console.log(result.pagination.total); // Total count
+     * ```
+     */
+    searchDefinitions(params?: {
+        search?: string;
+        page?: number;
+        limit?: number;
+        filters?: {
+            status?: string[];
+            organization_id?: string;
+            document_type_id?: string;
+            [key: string]: any;
+        };
+    }): Promise<ApiPaginatedResponse<WorkflowDefinition>>;
+}
+export { WorkflowAPI }
+export { WorkflowAPI as WorkflowAPI_alias_1 }
+export { WorkflowAPI as WorkflowAPI_alias_2 }
+
+/**
+ * Workflow Definition Response
+ */
+declare interface WorkflowDefinition {
+    id: string;
+    name: string;
+    display_name: string;
+    description?: string;
+    version: number;
+    status: string;
+    organization_ids: string[];
+    document_type_ids: string[];
+    nodes: Array<{
+        node_id: string;
+        node_name: string;
+        node_type: 'start' | 'approval' | 'decision' | 'end';
+        [key: string]: any;
+    }>;
+    edges: Array<{
+        edge_id: string;
+        from_node: string;
+        to_node: string;
+        conditions?: string;
+        [key: string]: any;
+    }>;
+    settings?: Record<string, any>;
+    nodes_count: number;
+    edges_count: number;
+    approval_nodes_count: number;
+    decision_nodes_count: number;
+    estimated_duration_hours?: number;
+    complexity_level: 'simple' | 'medium' | 'complex';
+    created_at: Date;
+    updated_at: Date;
+    created_by?: {
+        id: string;
+        name: string;
+        email: string;
+    };
+    [key: string]: any;
+}
+export { WorkflowDefinition }
+export { WorkflowDefinition as WorkflowDefinition_alias_1 }
+export { WorkflowDefinition as WorkflowDefinition_alias_2 }
+
+/**
+ * Workflow Types
+ *
+ * Type definitions for workflow operations
+ */
+/**
+ * Workflow Instance Response
+ */
+declare interface WorkflowInstance {
+    id: string;
+    workflow_definition_id: string;
+    workflow_definition_name: string;
+    document_id: string;
+    document_title: string;
+    requester_id: string;
+    requester_name: string;
+    current_node_id?: string;
+    current_node_name?: string;
+    status: string;
+    priority: string;
+    progress_percentage: number;
+    started_at?: Date;
+    completed_at?: Date;
+    due_date: Date;
+    escalation_count: number;
+    retry_count: number;
+    created_at: Date;
+    updated_at: Date;
+    final_result?: 'approved' | 'rejected' | 'cancelled' | 'expired';
+    final_decision_by?: string;
+    final_decision_by_name?: string;
+    final_decision_at?: Date;
+    performance_summary?: {
+        total_runtime_hours: number;
+        nodes_completed: number;
+        nodes_remaining: number;
+        avg_node_time_hours: number;
+        sla_compliance: boolean;
+        time_remaining_hours?: number;
+        completion_probability?: number;
+        completion_efficiency?: number;
+    };
+    current_activity?: {
+        description: string;
+        assigned_to?: string;
+        assigned_to_name?: string;
+        waiting_since?: Date;
+        expected_completion?: Date;
+        status: 'waiting_approval' | 'processing' | 'evaluating' | 'on_hold' | 'escalating';
+        can_escalate?: boolean;
+        can_remind?: boolean;
+        blocking_reason?: string;
+    };
+    workflow_path?: Array<{
+        node_id: string;
+        node_name: string;
+        node_type: 'start' | 'approval' | 'decision' | 'end';
+        status: 'pending' | 'running' | 'completed' | 'skipped' | 'failed';
+        started_at?: Date;
+        completed_at?: Date;
+        approved_by_name?: string;
+        assigned_to_name?: string;
+        approval_result?: 'approved' | 'rejected' | 'returned';
+        approvers?: Array<{
+            user_id: string;
+            name: string;
+            email?: string;
+            task_id?: string;
+            status: 'pending' | 'completed' | 'rejected';
+        }>;
+        result?: string;
+    }>;
+    approvers?: Array<{
+        user_id: string;
+        name: string;
+        email?: string;
+        task_id?: string;
+        status?: 'pending' | 'completed' | 'rejected';
+    }>;
+    next_approvers?: Array<{
+        user_id: string;
+        name: string;
+        email?: string;
+        task_title: string;
+        node_id?: string;
+    }>;
+    [key: string]: any;
+}
+export { WorkflowInstance }
+export { WorkflowInstance as WorkflowInstance_alias_1 }
+export { WorkflowInstance as WorkflowInstance_alias_2 }
+
+/**
+ * Workflow Instance Search Params
+ */
+declare interface WorkflowInstanceSearchParams {
+    search?: string;
+    page?: number;
+    limit?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    filters?: {
+        status?: string[];
+        priority?: string[];
+        workflow_definition_id?: string;
+        requester_id?: string;
+        current_node_id?: string;
+        [key: string]: any;
+    };
+}
+export { WorkflowInstanceSearchParams }
+export { WorkflowInstanceSearchParams as WorkflowInstanceSearchParams_alias_1 }
+export { WorkflowInstanceSearchParams as WorkflowInstanceSearchParams_alias_2 }
+
+/**
+ * Workflow Task Response
+ */
+declare interface WorkflowTask {
+    id: string;
+    workflow_instance_id: string;
+    node_id: string;
+    task_type: string;
+    task_title: string;
+    task_description?: string;
+    assigned_to: string;
+    assignee_id?: string;
+    assignee_code?: string;
+    assignee_name: string;
+    assignee_email?: string;
+    status: string;
+    priority: string;
+    assigned_at: Date;
+    due_date?: Date;
+    completed_at?: Date;
+    available_actions?: Array<{
+        action_key: string;
+        action_type: string;
+        action_label: string;
+        requires_comment: boolean;
+    }>;
+    requires_comment: boolean;
+    can_delegate: boolean;
+    workflow_title?: string;
+    created_at: Date;
+    updated_at: Date;
+    [key: string]: any;
+}
+export { WorkflowTask }
+export { WorkflowTask as WorkflowTask_alias_1 }
+export { WorkflowTask as WorkflowTask_alias_2 }
+
+/**
+ * Workflow Task Search Params
+ */
+declare interface WorkflowTaskSearchParams {
+    status?: string[];
+    priority?: string[];
+    workflow_instance_id?: string;
+    assigned_to?: string;
+    page?: number;
+    limit?: number;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+}
+export { WorkflowTaskSearchParams }
+export { WorkflowTaskSearchParams as WorkflowTaskSearchParams_alias_1 }
+export { WorkflowTaskSearchParams as WorkflowTaskSearchParams_alias_2 }
+
+export { }