mirror of
https://github.com/Frooodle/Stirling-PDF.git
synced 2026-02-01 20:10:35 +01:00
🔄 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>
59 lines
1.8 KiB
TypeScript
59 lines
1.8 KiB
TypeScript
import {
|
|
CONVERSION_ENDPOINTS,
|
|
ENDPOINT_NAMES,
|
|
EXTENSION_TO_ENDPOINT
|
|
} from '../constants/convertConstants';
|
|
|
|
/**
|
|
* Resolves the endpoint name for a given conversion
|
|
*/
|
|
export const getEndpointName = (fromExtension: string, toExtension: string): string => {
|
|
if (!fromExtension || !toExtension) return '';
|
|
|
|
let endpointKey = EXTENSION_TO_ENDPOINT[fromExtension]?.[toExtension];
|
|
|
|
// If no explicit mapping exists and we're converting to PDF,
|
|
// fall back to 'any' which uses file-to-pdf endpoint
|
|
if (!endpointKey && toExtension === 'pdf' && fromExtension !== 'any') {
|
|
endpointKey = EXTENSION_TO_ENDPOINT['any']?.[toExtension];
|
|
}
|
|
|
|
return endpointKey || '';
|
|
};
|
|
|
|
/**
|
|
* Resolves the full endpoint URL for a given conversion
|
|
*/
|
|
export const getEndpointUrl = (fromExtension: string, toExtension: string): string => {
|
|
const endpointName = getEndpointName(fromExtension, toExtension);
|
|
if (!endpointName) return '';
|
|
|
|
// Find the endpoint URL from CONVERSION_ENDPOINTS using the endpoint name
|
|
for (const [key, endpoint] of Object.entries(CONVERSION_ENDPOINTS)) {
|
|
if (ENDPOINT_NAMES[key as keyof typeof ENDPOINT_NAMES] === endpointName) {
|
|
return endpoint;
|
|
}
|
|
}
|
|
return '';
|
|
};
|
|
|
|
/**
|
|
* Checks if a conversion is supported
|
|
*/
|
|
export const isConversionSupported = (fromExtension: string, toExtension: string): boolean => {
|
|
return getEndpointName(fromExtension, toExtension) !== '';
|
|
};
|
|
|
|
/**
|
|
* Checks if the given extension is an image format
|
|
*/
|
|
export const isImageFormat = (extension: string): boolean => {
|
|
return ['png', 'jpg', 'jpeg', 'gif', 'tiff', 'bmp', 'webp', 'svg'].includes(extension.toLowerCase());
|
|
};
|
|
|
|
/**
|
|
* Checks if the given extension is a web format
|
|
*/
|
|
export const isWebFormat = (extension: string): boolean => {
|
|
return ['html', 'zip'].includes(extension.toLowerCase());
|
|
}; |