lcbp3/frontend/hooks/__tests__/use-workflow-action.test.ts

// ADR-021 T027a: ทดสอบ HTTP 503 / 409 / 403 error handling ใน useWorkflowAction
import { describe, it, expect, vi, beforeEach } from 'vitest';
import { renderHook, waitFor, act } from '@testing-library/react';
import { createTestQueryClient } from '@/lib/test-utils';
import { useWorkflowAction } from '../use-workflow-action';
import { workflowEngineService } from '@/lib/services/workflow-engine.service';
import { toast } from 'sonner';

// Mock service
vi.mock('@/lib/services/workflow-engine.service', () => ({
  workflowEngineService: {
    transition: vi.fn(),
  },
}));

// Mock sonner toast
vi.mock('sonner', () => ({
  toast: {
    success: vi.fn(),
    error: vi.fn(),
  },
}));

// Helper — สร้าง ApiErrorResponse ปลอมตามรูปแบบ parseApiError
function makeApiError(statusCode: number, message: string, recoveryActions?: string[]) {
  return {
    error: {
      type: 'BUSINESS',
      code: 'HTTP_ERROR',
      message,
      severity: statusCode >= 500 ? 'HIGH' : 'MEDIUM',
      timestamp: new Date().toISOString(),
      statusCode,
      recoveryActions,
    },
  };
}

describe('useWorkflowAction — T027a error handling (Clarify Q1+Q2)', () => {
  beforeEach(() => {
    vi.clearAllMocks();
  });

  it('Q2 (503): should show "ระบบยุ่ง" toast when Redlock Fail-closed', async () => {
    vi.mocked(workflowEngineService.transition).mockRejectedValue(
      makeApiError(503, 'ระบบยุ่งชั่วคราว กรุณาลองใหม่ภายหลัง')
    );

    const { wrapper } = createTestQueryClient();
    const { result } = renderHook(() => useWorkflowAction('inst-1'), { wrapper });

    await act(async () => {
      result.current.mutate({ action: 'APPROVE' });
    });

    await waitFor(() => {
      expect(result.current.isError).toBe(true);
    });

    expect(toast.error).toHaveBeenCalledWith(
      'ระบบยุ่งชั่วคราว กรุณาลองใหม่อีกครั้งภายหลัง',
      expect.objectContaining({
        description: expect.stringContaining('ข้อมูลของคุณปลอดภัย'),
      })
    );
  });

  it('Q1 (409): should show state violation toast with backend message', async () => {
    vi.mocked(workflowEngineService.transition).mockRejectedValue(
      makeApiError(409, 'ไม่สามารถอัปโหลดไฟล์ในสถานะนี้ได้', [
        'อนุญาตเฉพาะสถานะ PENDING_REVIEW หรือ PENDING_APPROVAL',
      ])
    );

    const { wrapper } = createTestQueryClient();
    const { result } = renderHook(() => useWorkflowAction('inst-1'), { wrapper });

    await act(async () => {
      result.current.mutate({ action: 'APPROVE', attachmentPublicIds: ['a1'] });
    });

    await waitFor(() => {
      expect(result.current.isError).toBe(true);
    });

    expect(toast.error).toHaveBeenCalledWith(
      'ไม่สามารถอัปโหลดไฟล์ในสถานะนี้ได้',
      expect.objectContaining({
        description: 'อนุญาตเฉพาะสถานะ PENDING_REVIEW หรือ PENDING_APPROVAL',
      })
    );
  });

  it('403: should show unauthorized toast', async () => {
    vi.mocked(workflowEngineService.transition).mockRejectedValue(
      makeApiError(403, 'ไม่มีสิทธิ์', ['ติดต่อ Admin'])
    );

    const { wrapper } = createTestQueryClient();
    const { result } = renderHook(() => useWorkflowAction('inst-1'), { wrapper });

    await act(async () => {
      result.current.mutate({ action: 'APPROVE' });
    });

    await waitFor(() => {
      expect(result.current.isError).toBe(true);
    });

    expect(toast.error).toHaveBeenCalledWith(
      'คุณไม่มีสิทธิ์ดำเนินการในขั้นตอนนี้',
      expect.objectContaining({
        description: 'ติดต่อ Admin',
      })
    );
  });

  it('should show success toast on 200', async () => {
    vi.mocked(workflowEngineService.transition).mockResolvedValue({
      success: true,
      nextState: 'APPROVED',
    });

    const { wrapper } = createTestQueryClient();
    const { result } = renderHook(() => useWorkflowAction('inst-1'), { wrapper });

    await act(async () => {
      result.current.mutate({ action: 'APPROVE' });
    });

    await waitFor(() => {
      expect(result.current.isSuccess).toBe(true);
    });

    expect(toast.success).toHaveBeenCalledWith('ดำเนินการเรียบร้อยแล้ว');
  });

  it('should reject when instanceId is undefined', async () => {
    const { wrapper } = createTestQueryClient();
    const { result } = renderHook(() => useWorkflowAction(undefined), { wrapper });

    await act(async () => {
      result.current.mutate({ action: 'APPROVE' });
    });

    await waitFor(() => {
      expect(result.current.isError).toBe(true);
    });

    expect(toast.error).toHaveBeenCalledWith(
      expect.stringContaining('ไม่พบ Workflow Instance ID')
    );
  });
});