🔄 Dynamic Processing Strategies - Adaptive routing: Same tool uses different backend endpoints based on file analysis - Combined vs separate processing: Intelligently chooses between merge operations and individual file processing - Cross-format workflows: Enable complex conversions like "mixed files → PDF" that other tools can't handle ⚙️ Format-Specific Intelligence Each conversion type gets tailored options: - HTML/ZIP → PDF: Zoom controls (0.1-3.0 increments) with live preview - Email → PDF: Attachment handling, size limits, recipient control - PDF → PDF/A: Digital signature detection with warnings - Images → PDF: Smart combining vs individual file options File Architecture Core Implementation: ├── Convert.tsx # Main stepped workflow UI ├── ConvertSettings.tsx # Centralized settings with smart detection ├── GroupedFormatDropdown.tsx # Enhanced format selector with grouping ├── useConvertParameters.ts # Smart detection & parameter management ├── useConvertOperation.ts # Multi-strategy processing logic └── Settings Components: ├── ConvertFromWebSettings.tsx # HTML zoom controls ├── ConvertFromEmailSettings.tsx # Email attachment options ├── ConvertToPdfaSettings.tsx # PDF/A with signature detection ├── ConvertFromImageSettings.tsx # Image PDF options └── ConvertToImageSettings.tsx # PDF to image options Utility Layer Utils & Services: ├── convertUtils.ts # Format detection & endpoint routing ├── fileResponseUtils.ts # Generic API response handling └── setupTests.ts # Enhanced test environment with crypto mocks Testing & Quality Comprehensive Test Coverage Test Suite: ├── useConvertParameters.test.ts # Parameter logic & smart detection ├── useConvertParametersAutoDetection.test.ts # File type analysis ├── ConvertIntegration.test.tsx # End-to-end conversion workflows ├── ConvertSmartDetectionIntegration.test.tsx # Mixed file scenarios ├── ConvertE2E.spec.ts # Playwright browser tests ├── convertUtils.test.ts # Utility function validation └── fileResponseUtils.test.ts # API response handling Advanced Test Features - Crypto API mocking: Proper test environment for file hashing - File.arrayBuffer() polyfills: Complete browser API simulation - Multi-file scenario testing: Complex batch processing validation - CI/CD integration: Vitest runs in GitHub Actions with proper artifacts --------- Co-authored-by: Connor Yoh <connor@stirlingpdf.com> Co-authored-by: Anthony Stirling <77850077+Frooodle@users.noreply.github.com>
223 lines
7.7 KiB
TypeScript
223 lines
7.7 KiB
TypeScript
/**
|
|
* Unit tests for useConvertParameters hook
|
|
*/
|
|
|
|
import { describe, test, expect } from 'vitest';
|
|
import { renderHook, act } from '@testing-library/react';
|
|
import { useConvertParameters } from './useConvertParameters';
|
|
|
|
describe('useConvertParameters', () => {
|
|
|
|
describe('Parameter Management', () => {
|
|
|
|
test('should initialize with default parameters', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
expect(result.current.parameters.fromExtension).toBe('');
|
|
expect(result.current.parameters.toExtension).toBe('');
|
|
expect(result.current.parameters.imageOptions.colorType).toBe('color');
|
|
expect(result.current.parameters.imageOptions.dpi).toBe(300);
|
|
expect(result.current.parameters.imageOptions.singleOrMultiple).toBe('multiple');
|
|
expect(result.current.parameters.htmlOptions.zoomLevel).toBe(1.0);
|
|
expect(result.current.parameters.emailOptions.includeAttachments).toBe(true);
|
|
expect(result.current.parameters.emailOptions.maxAttachmentSizeMB).toBe(10);
|
|
expect(result.current.parameters.emailOptions.downloadHtml).toBe(false);
|
|
expect(result.current.parameters.emailOptions.includeAllRecipients).toBe(false);
|
|
expect(result.current.parameters.pdfaOptions.outputFormat).toBe('pdfa-1');
|
|
});
|
|
|
|
test('should update individual parameters', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'pdf');
|
|
});
|
|
|
|
expect(result.current.parameters.fromExtension).toBe('pdf');
|
|
expect(result.current.parameters.toExtension).toBe(''); // Should not affect other params
|
|
});
|
|
|
|
test('should update nested image options', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('imageOptions', {
|
|
colorType: 'grayscale',
|
|
dpi: 150,
|
|
singleOrMultiple: 'single'
|
|
});
|
|
});
|
|
|
|
expect(result.current.parameters.imageOptions.colorType).toBe('grayscale');
|
|
expect(result.current.parameters.imageOptions.dpi).toBe(150);
|
|
expect(result.current.parameters.imageOptions.singleOrMultiple).toBe('single');
|
|
});
|
|
|
|
test('should update nested HTML options', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('htmlOptions', {
|
|
zoomLevel: 1.5
|
|
});
|
|
});
|
|
|
|
expect(result.current.parameters.htmlOptions.zoomLevel).toBe(1.5);
|
|
});
|
|
|
|
test('should update nested email options', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('emailOptions', {
|
|
includeAttachments: false,
|
|
maxAttachmentSizeMB: 20,
|
|
downloadHtml: true,
|
|
includeAllRecipients: true
|
|
});
|
|
});
|
|
|
|
expect(result.current.parameters.emailOptions.includeAttachments).toBe(false);
|
|
expect(result.current.parameters.emailOptions.maxAttachmentSizeMB).toBe(20);
|
|
expect(result.current.parameters.emailOptions.downloadHtml).toBe(true);
|
|
expect(result.current.parameters.emailOptions.includeAllRecipients).toBe(true);
|
|
});
|
|
|
|
test('should update nested PDF/A options', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('pdfaOptions', {
|
|
outputFormat: 'pdfa'
|
|
});
|
|
});
|
|
|
|
expect(result.current.parameters.pdfaOptions.outputFormat).toBe('pdfa');
|
|
});
|
|
|
|
test('should reset parameters to defaults', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'pdf');
|
|
result.current.updateParameter('toExtension', 'png');
|
|
});
|
|
|
|
expect(result.current.parameters.fromExtension).toBe('pdf');
|
|
|
|
act(() => {
|
|
result.current.resetParameters();
|
|
});
|
|
|
|
expect(result.current.parameters.fromExtension).toBe('');
|
|
expect(result.current.parameters.toExtension).toBe('');
|
|
});
|
|
});
|
|
|
|
describe('Parameter Validation', () => {
|
|
|
|
test('should validate parameters correctly', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
// No parameters - should be invalid
|
|
expect(result.current.validateParameters()).toBe(false);
|
|
|
|
// Only fromExtension - should be invalid
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'pdf');
|
|
});
|
|
expect(result.current.validateParameters()).toBe(false);
|
|
|
|
// Both extensions with supported conversion - should be valid
|
|
act(() => {
|
|
result.current.updateParameter('toExtension', 'png');
|
|
});
|
|
expect(result.current.validateParameters()).toBe(true);
|
|
});
|
|
|
|
test('should validate unsupported conversions', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'pdf');
|
|
result.current.updateParameter('toExtension', 'unsupported');
|
|
});
|
|
|
|
expect(result.current.validateParameters()).toBe(false);
|
|
});
|
|
|
|
});
|
|
|
|
describe('Endpoint Generation', () => {
|
|
|
|
test('should generate correct endpoint names', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'pdf');
|
|
result.current.updateParameter('toExtension', 'png');
|
|
});
|
|
|
|
const endpointName = result.current.getEndpointName();
|
|
expect(endpointName).toBe('pdf-to-img');
|
|
});
|
|
|
|
test('should generate correct endpoint URLs', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'pdf');
|
|
result.current.updateParameter('toExtension', 'png');
|
|
});
|
|
|
|
const endpoint = result.current.getEndpoint();
|
|
expect(endpoint).toBe('/api/v1/convert/pdf/img');
|
|
});
|
|
|
|
test('should return empty strings for invalid conversions', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
act(() => {
|
|
result.current.updateParameter('fromExtension', 'invalid');
|
|
result.current.updateParameter('toExtension', 'invalid');
|
|
});
|
|
|
|
expect(result.current.getEndpointName()).toBe('');
|
|
expect(result.current.getEndpoint()).toBe('');
|
|
});
|
|
});
|
|
|
|
describe('Available Extensions', () => {
|
|
|
|
test('should return available extensions for valid source format', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
const availableExtensions = result.current.getAvailableToExtensions('pdf');
|
|
|
|
expect(availableExtensions.length).toBeGreaterThan(0);
|
|
expect(availableExtensions.some(ext => ext.value === 'png')).toBe(true);
|
|
expect(availableExtensions.some(ext => ext.value === 'jpg')).toBe(true);
|
|
});
|
|
|
|
test('should return empty array for invalid source format', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
const availableExtensions = result.current.getAvailableToExtensions('invalid');
|
|
|
|
expect(availableExtensions).toEqual([{
|
|
"group": "Document",
|
|
"label": "PDF",
|
|
"value": "pdf",
|
|
}]);
|
|
});
|
|
|
|
test('should return empty array for empty source format', () => {
|
|
const { result } = renderHook(() => useConvertParameters());
|
|
|
|
const availableExtensions = result.current.getAvailableToExtensions('');
|
|
|
|
expect(availableExtensions).toEqual([]);
|
|
});
|
|
});
|
|
|
|
}); |