{tool.icon}
@@ -126,4 +142,4 @@ const ToolSearch = ({
);
};
-export default ToolSearch;
\ No newline at end of file
+export default ToolSearch;
diff --git a/frontend/src/constants/automation.ts b/frontend/src/constants/automation.ts
new file mode 100644
index 000000000..c1aeaeff0
--- /dev/null
+++ b/frontend/src/constants/automation.ts
@@ -0,0 +1,42 @@
+/**
+ * Constants for automation functionality
+ */
+
+export const AUTOMATION_CONSTANTS = {
+ // Timeouts
+ OPERATION_TIMEOUT: 300000, // 5 minutes in milliseconds
+
+ // Default values
+ DEFAULT_TOOL_COUNT: 2,
+ MIN_TOOL_COUNT: 2,
+
+ // File prefixes
+ FILE_PREFIX: 'automated_',
+ RESPONSE_ZIP_PREFIX: 'response_',
+ RESULT_FILE_PREFIX: 'result_',
+ PROCESSED_FILE_PREFIX: 'processed_',
+
+ // Operation types
+ CONVERT_OPERATION_TYPE: 'convert',
+
+ // Storage keys
+ DB_NAME: 'StirlingPDF_Automations',
+ DB_VERSION: 1,
+ STORE_NAME: 'automations',
+
+ // UI delays
+ SPINNER_ANIMATION_DURATION: '1s'
+} as const;
+
+export const AUTOMATION_STEPS = {
+ SELECTION: 'selection',
+ CREATION: 'creation',
+ RUN: 'run'
+} as const;
+
+export const EXECUTION_STATUS = {
+ PENDING: 'pending',
+ RUNNING: 'running',
+ COMPLETED: 'completed',
+ ERROR: 'error'
+} as const;
\ No newline at end of file
diff --git a/frontend/src/contexts/NavigationContext.tsx b/frontend/src/contexts/NavigationContext.tsx
index c85eef158..532eb20bb 100644
--- a/frontend/src/contexts/NavigationContext.tsx
+++ b/frontend/src/contexts/NavigationContext.tsx
@@ -1,5 +1,6 @@
import React, { createContext, useContext, useReducer, useCallback } from 'react';
import { useNavigationUrlSync } from '../hooks/useUrlSync';
+import { ModeType, isValidMode, getDefaultMode } from '../types/navigation';
/**
* NavigationContext - Complete navigation management system
@@ -9,32 +10,13 @@ import { useNavigationUrlSync } from '../hooks/useUrlSync';
* maintain clear separation of concerns.
*/
-// Navigation mode types - complete list to match fileContext.ts
-export type ModeType =
- | 'viewer'
- | 'pageEditor'
- | 'fileEditor'
- | 'merge'
- | 'split'
- | 'compress'
- | 'ocr'
- | 'convert'
- | 'sanitize'
- | 'addPassword'
- | 'changePermissions'
- | 'addWatermark'
- | 'removePassword'
- | 'single-large-page'
- | 'repair'
- | 'unlockPdfForms'
- | 'removeCertificateSign';
-
// Navigation state
interface NavigationState {
currentMode: ModeType;
hasUnsavedChanges: boolean;
pendingNavigation: (() => void) | null;
showNavigationWarning: boolean;
+ selectedToolKey: string | null; // Add tool selection to navigation state
}
// Navigation actions
@@ -42,7 +24,8 @@ type NavigationAction =
| { type: 'SET_MODE'; payload: { mode: ModeType } }
| { type: 'SET_UNSAVED_CHANGES'; payload: { hasChanges: boolean } }
| { type: 'SET_PENDING_NAVIGATION'; payload: { navigationFn: (() => void) | null } }
- | { type: 'SHOW_NAVIGATION_WARNING'; payload: { show: boolean } };
+ | { type: 'SHOW_NAVIGATION_WARNING'; payload: { show: boolean } }
+ | { type: 'SET_SELECTED_TOOL'; payload: { toolKey: string | null } };
// Navigation reducer
const navigationReducer = (state: NavigationState, action: NavigationAction): NavigationState => {
@@ -59,6 +42,9 @@ const navigationReducer = (state: NavigationState, action: NavigationAction): Na
case 'SHOW_NAVIGATION_WARNING':
return { ...state, showNavigationWarning: action.payload.show };
+ case 'SET_SELECTED_TOOL':
+ return { ...state, selectedToolKey: action.payload.toolKey };
+
default:
return state;
}
@@ -66,10 +52,11 @@ const navigationReducer = (state: NavigationState, action: NavigationAction): Na
// Initial state
const initialState: NavigationState = {
- currentMode: 'pageEditor',
+ currentMode: getDefaultMode(),
hasUnsavedChanges: false,
pendingNavigation: null,
- showNavigationWarning: false
+ showNavigationWarning: false,
+ selectedToolKey: null
};
// Navigation context actions interface
@@ -80,6 +67,9 @@ export interface NavigationContextActions {
requestNavigation: (navigationFn: () => void) => void;
confirmNavigation: () => void;
cancelNavigation: () => void;
+ selectTool: (toolKey: string) => void;
+ clearToolSelection: () => void;
+ handleToolSelect: (toolId: string) => void;
}
// Split context values
@@ -88,6 +78,7 @@ export interface NavigationContextStateValue {
hasUnsavedChanges: boolean;
pendingNavigation: (() => void) | null;
showNavigationWarning: boolean;
+ selectedToolKey: string | null;
}
export interface NavigationContextActionsValue {
@@ -145,6 +136,31 @@ export const NavigationProvider: React.FC<{
// Clear navigation without executing
dispatch({ type: 'SET_PENDING_NAVIGATION', payload: { navigationFn: null } });
dispatch({ type: 'SHOW_NAVIGATION_WARNING', payload: { show: false } });
+ }, []),
+
+ selectTool: useCallback((toolKey: string) => {
+ dispatch({ type: 'SET_SELECTED_TOOL', payload: { toolKey } });
+ }, []),
+
+ clearToolSelection: useCallback(() => {
+ dispatch({ type: 'SET_SELECTED_TOOL', payload: { toolKey: null } });
+ }, []),
+
+ handleToolSelect: useCallback((toolId: string) => {
+ // Handle special cases
+ if (toolId === 'allTools') {
+ dispatch({ type: 'SET_SELECTED_TOOL', payload: { toolKey: null } });
+ return;
+ }
+
+ // Special-case: if tool is a dedicated reader tool, enter reader mode
+ if (toolId === 'read' || toolId === 'view-pdf') {
+ dispatch({ type: 'SET_SELECTED_TOOL', payload: { toolKey: null } });
+ return;
+ }
+
+ dispatch({ type: 'SET_SELECTED_TOOL', payload: { toolKey: toolId } });
+ dispatch({ type: 'SET_MODE', payload: { mode: 'fileEditor' as ModeType } });
}, [])
};
@@ -152,7 +168,8 @@ export const NavigationProvider: React.FC<{
currentMode: state.currentMode,
hasUnsavedChanges: state.hasUnsavedChanges,
pendingNavigation: state.pendingNavigation,
- showNavigationWarning: state.showNavigationWarning
+ showNavigationWarning: state.showNavigationWarning,
+ selectedToolKey: state.selectedToolKey
};
const actionsValue: NavigationContextActionsValue = {
@@ -212,16 +229,8 @@ export const useNavigationGuard = () => {
};
};
-// Utility functions for mode handling
-export const isValidMode = (mode: string): mode is ModeType => {
- const validModes: ModeType[] = [
- 'viewer', 'pageEditor', 'fileEditor', 'merge', 'split',
- 'compress', 'ocr', 'convert', 'addPassword', 'changePermissions', 'sanitize'
- ];
- return validModes.includes(mode as ModeType);
-};
-
-export const getDefaultMode = (): ModeType => 'pageEditor';
+// Re-export utility functions from types for backward compatibility
+export { isValidMode, getDefaultMode, type ModeType } from '../types/navigation';
// TODO: This will be expanded for URL-based routing system
// - URL parsing utilities
diff --git a/frontend/src/contexts/ToolWorkflowContext.tsx b/frontend/src/contexts/ToolWorkflowContext.tsx
index 1ee211312..f784dd49a 100644
--- a/frontend/src/contexts/ToolWorkflowContext.tsx
+++ b/frontend/src/contexts/ToolWorkflowContext.tsx
@@ -8,6 +8,7 @@ import { useToolManagement } from '../hooks/useToolManagement';
import { PageEditorFunctions } from '../types/pageEditor';
import { ToolRegistryEntry } from '../data/toolsTaxonomy';
import { useToolWorkflowUrlSync } from '../hooks/useUrlSync';
+import { useNavigationActions, useNavigationState } from './NavigationContext';
// State interface
interface ToolWorkflowState {
@@ -100,23 +101,23 @@ const ToolWorkflowContext = createContext
(
// Provider component
interface ToolWorkflowProviderProps {
children: React.ReactNode;
- /** Handler for view changes (passed from parent) */
- onViewChange?: (view: string) => void;
- /** Enable URL synchronization for tool selection */
- enableUrlSync?: boolean;
}
-export function ToolWorkflowProvider({ children, onViewChange, enableUrlSync = true }: ToolWorkflowProviderProps) {
+export function ToolWorkflowProvider({ children }: ToolWorkflowProviderProps) {
const [state, dispatch] = useReducer(toolWorkflowReducer, initialState);
+ // Navigation actions and state are available since we're inside NavigationProvider
+ const { actions } = useNavigationActions();
+ const navigationState = useNavigationState();
+
// Tool management hook
const {
- selectedToolKey,
- selectedTool,
toolRegistry,
- selectTool,
- clearToolSelection,
+ getSelectedTool,
} = useToolManagement();
+
+ // Get selected tool from navigation context
+ const selectedTool = getSelectedTool(navigationState.selectedToolKey);
// UI Action creators
const setSidebarsVisible = useCallback((visible: boolean) => {
@@ -145,28 +146,30 @@ export function ToolWorkflowProvider({ children, onViewChange, enableUrlSync = t
// Workflow actions (compound actions that coordinate multiple state changes)
const handleToolSelect = useCallback((toolId: string) => {
- // Special-case: if tool is a dedicated reader tool, enter reader mode and do not go to toolContent
- if (toolId === 'read' || toolId === 'view-pdf') {
- setReaderMode(true);
- setLeftPanelView('toolPicker');
- clearToolSelection();
- setSearchQuery('');
- return;
- }
-
- selectTool(toolId);
- onViewChange?.('fileEditor');
- setLeftPanelView('toolContent');
- setReaderMode(false);
- // Clear search so the tool content becomes visible immediately
+ actions.handleToolSelect(toolId);
+
+ // Clear search query when selecting a tool
setSearchQuery('');
- }, [selectTool, onViewChange, setLeftPanelView, setReaderMode, setSearchQuery, clearToolSelection]);
+
+ // Handle view switching logic
+ if (toolId === 'allTools' || toolId === 'read' || toolId === 'view-pdf') {
+ setLeftPanelView('toolPicker');
+ if (toolId === 'read' || toolId === 'view-pdf') {
+ setReaderMode(true);
+ } else {
+ setReaderMode(false);
+ }
+ } else {
+ setLeftPanelView('toolContent');
+ setReaderMode(false); // Disable read mode when selecting tools
+ }
+ }, [actions, setLeftPanelView, setReaderMode, setSearchQuery]);
const handleBackToTools = useCallback(() => {
setLeftPanelView('toolPicker');
setReaderMode(false);
- clearToolSelection();
- }, [setLeftPanelView, setReaderMode, clearToolSelection]);
+ actions.clearToolSelection();
+ }, [setLeftPanelView, setReaderMode, actions]);
const handleReaderToggle = useCallback(() => {
setReaderMode(true);
@@ -186,13 +189,13 @@ export function ToolWorkflowProvider({ children, onViewChange, enableUrlSync = t
);
// Enable URL synchronization for tool selection
- useToolWorkflowUrlSync(selectedToolKey, selectTool, clearToolSelection, enableUrlSync);
+ useToolWorkflowUrlSync(navigationState.selectedToolKey, actions.selectTool, actions.clearToolSelection, true);
- // Simple context value with basic memoization
+ // Properly memoized context value
const contextValue = useMemo((): ToolWorkflowContextValue => ({
// State
...state,
- selectedToolKey,
+ selectedToolKey: navigationState.selectedToolKey,
selectedTool,
toolRegistry,
@@ -203,8 +206,8 @@ export function ToolWorkflowProvider({ children, onViewChange, enableUrlSync = t
setPreviewFile,
setPageEditorFunctions,
setSearchQuery,
- selectTool,
- clearToolSelection,
+ selectTool: actions.selectTool,
+ clearToolSelection: actions.clearToolSelection,
// Workflow Actions
handleToolSelect,
@@ -214,7 +217,25 @@ export function ToolWorkflowProvider({ children, onViewChange, enableUrlSync = t
// Computed
filteredTools,
isPanelVisible,
- }), [state, selectedToolKey, selectedTool, toolRegistry, filteredTools, isPanelVisible]);
+ }), [
+ state,
+ navigationState.selectedToolKey,
+ selectedTool,
+ toolRegistry,
+ setSidebarsVisible,
+ setLeftPanelView,
+ setReaderMode,
+ setPreviewFile,
+ setPageEditorFunctions,
+ setSearchQuery,
+ actions.selectTool,
+ actions.clearToolSelection,
+ handleToolSelect,
+ handleBackToTools,
+ handleReaderToggle,
+ filteredTools,
+ isPanelVisible,
+ ]);
return (
@@ -227,6 +248,38 @@ export function ToolWorkflowProvider({ children, onViewChange, enableUrlSync = t
export function useToolWorkflow(): ToolWorkflowContextValue {
const context = useContext(ToolWorkflowContext);
if (!context) {
+ // During development hot reload, temporarily return a safe fallback
+ if (false && process.env.NODE_ENV === 'development') {
+ console.warn('ToolWorkflowContext temporarily unavailable during hot reload, using fallback');
+
+ // Return minimal safe fallback to prevent crashes
+ return {
+ sidebarsVisible: true,
+ leftPanelView: 'toolPicker',
+ readerMode: false,
+ previewFile: null,
+ pageEditorFunctions: null,
+ searchQuery: '',
+ selectedToolKey: null,
+ selectedTool: null,
+ toolRegistry: {},
+ filteredTools: [],
+ isPanelVisible: true,
+ setSidebarsVisible: () => {},
+ setLeftPanelView: () => {},
+ setReaderMode: () => {},
+ setPreviewFile: () => {},
+ setPageEditorFunctions: () => {},
+ setSearchQuery: () => {},
+ selectTool: () => {},
+ clearToolSelection: () => {},
+ handleToolSelect: () => {},
+ handleBackToTools: () => {},
+ handleReaderToggle: () => {}
+ } as ToolWorkflowContextValue;
+ }
+
+ console.error('ToolWorkflowContext not found. Current stack:', new Error().stack);
throw new Error('useToolWorkflow must be used within a ToolWorkflowProvider');
}
return context;
diff --git a/frontend/src/data/toolsTaxonomy.ts b/frontend/src/data/toolsTaxonomy.ts
index 2dff2b8e4..0892b8b6c 100644
--- a/frontend/src/data/toolsTaxonomy.ts
+++ b/frontend/src/data/toolsTaxonomy.ts
@@ -1,6 +1,8 @@
import { type TFunction } from 'i18next';
import React from 'react';
+import { ToolOperationHook, ToolOperationConfig } from '../hooks/tools/shared/useToolOperation';
import { BaseToolProps } from '../types/tool';
+import { BaseParameters } from '../types/parameters';
export enum SubcategoryId {
SIGNING = 'signing',
@@ -23,18 +25,22 @@ export enum ToolCategoryId {
}
export type ToolRegistryEntry = {
- icon: React.ReactNode;
- name: string;
- component: React.ComponentType | null;
- view: 'sign' | 'security' | 'format' | 'extract' | 'view' | 'merge' | 'pageEditor' | 'convert' | 'redact' | 'split' | 'convert' | 'remove' | 'compress' | 'external';
- description: string;
- categoryId: ToolCategoryId;
- subcategoryId: SubcategoryId;
- maxFiles?: number;
- supportedFormats?: string[];
- endpoints?: string[];
- link?: string;
- type?: string;
+ icon: React.ReactNode;
+ name: string;
+ component: React.ComponentType | null;
+ view: 'sign' | 'security' | 'format' | 'extract' | 'view' | 'merge' | 'pageEditor' | 'convert' | 'redact' | 'split' | 'convert' | 'remove' | 'compress' | 'external';
+ description: string;
+ categoryId: ToolCategoryId;
+ subcategoryId: SubcategoryId;
+ maxFiles?: number;
+ supportedFormats?: string[];
+ endpoints?: string[];
+ link?: string;
+ type?: string;
+ // Operation configuration for automation
+ operationConfig?: ToolOperationConfig;
+ // Settings component for automation configuration
+ settingsComponent?: React.ComponentType;
}
export type ToolRegistry = Record;
diff --git a/frontend/src/data/useTranslatedToolRegistry.tsx b/frontend/src/data/useTranslatedToolRegistry.tsx
index 0426a7bf6..3c3b5e89b 100644
--- a/frontend/src/data/useTranslatedToolRegistry.tsx
+++ b/frontend/src/data/useTranslatedToolRegistry.tsx
@@ -1,3 +1,4 @@
+import React, { useMemo } from 'react';
import { useTranslation } from 'react-i18next';
import SplitPdfPanel from "../tools/Split";
import CompressPdfPanel from "../tools/Compress";
@@ -13,6 +14,30 @@ import Repair from '../tools/Repair';
import SingleLargePage from '../tools/SingleLargePage';
import UnlockPdfForms from '../tools/UnlockPdfForms';
import RemoveCertificateSign from '../tools/RemoveCertificateSign';
+import { compressOperationConfig } from '../hooks/tools/compress/useCompressOperation';
+import { splitOperationConfig } from '../hooks/tools/split/useSplitOperation';
+import { addPasswordOperationConfig } from '../hooks/tools/addPassword/useAddPasswordOperation';
+import { removePasswordOperationConfig } from '../hooks/tools/removePassword/useRemovePasswordOperation';
+import { sanitizeOperationConfig } from '../hooks/tools/sanitize/useSanitizeOperation';
+import { repairOperationConfig } from '../hooks/tools/repair/useRepairOperation';
+import { addWatermarkOperationConfig } from '../hooks/tools/addWatermark/useAddWatermarkOperation';
+import { unlockPdfFormsOperationConfig } from '../hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation';
+import { singleLargePageOperationConfig } from '../hooks/tools/singleLargePage/useSingleLargePageOperation';
+import { ocrOperationConfig } from '../hooks/tools/ocr/useOCROperation';
+import { convertOperationConfig } from '../hooks/tools/convert/useConvertOperation';
+import { removeCertificateSignOperationConfig } from '../hooks/tools/removeCertificateSign/useRemoveCertificateSignOperation';
+import { changePermissionsOperationConfig } from '../hooks/tools/changePermissions/useChangePermissionsOperation';
+import CompressSettings from '../components/tools/compress/CompressSettings';
+import SplitSettings from '../components/tools/split/SplitSettings';
+import AddPasswordSettings from '../components/tools/addPassword/AddPasswordSettings';
+import RemovePasswordSettings from '../components/tools/removePassword/RemovePasswordSettings';
+import SanitizeSettings from '../components/tools/sanitize/SanitizeSettings';
+import RepairSettings from '../components/tools/repair/RepairSettings';
+import UnlockPdfFormsSettings from '../components/tools/unlockPdfForms/UnlockPdfFormsSettings';
+import AddWatermarkSingleStepSettings from '../components/tools/addWatermark/AddWatermarkSingleStepSettings';
+import OCRSettings from '../components/tools/ocr/OCRSettings';
+import ConvertSettings from '../components/tools/convert/ConvertSettings';
+import ChangePermissionsSettings from '../components/tools/changePermissions/ChangePermissionsSettings';
const showPlaceholderTools = false; // For development purposes. Allows seeing the full list of tools, even if they're unimplemented
@@ -20,7 +45,8 @@ const showPlaceholderTools = false; // For development purposes. Allows seeing t
export function useFlatToolRegistry(): ToolRegistry {
const { t } = useTranslation();
- const allTools: ToolRegistry = {
+ return useMemo(() => {
+ const allTools: ToolRegistry = {
// Signing
"certSign": {
@@ -54,7 +80,9 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
maxFiles: -1,
- endpoints: ["add-password"]
+ endpoints: ["add-password"],
+ operationConfig: addPasswordOperationConfig,
+ settingsComponent: AddPasswordSettings
},
"watermark": {
icon: branding_watermark,
@@ -65,7 +93,9 @@ export function useFlatToolRegistry(): ToolRegistry {
description: t("home.watermark.desc", "Add a custom watermark to your PDF document."),
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
- endpoints: ["add-watermark"]
+ endpoints: ["add-watermark"],
+ operationConfig: addWatermarkOperationConfig,
+ settingsComponent: AddWatermarkSingleStepSettings
},
"add-stamp": {
icon: approval,
@@ -85,7 +115,9 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
description: t("home.sanitize.desc", "Remove potentially harmful elements from PDF files"),
- endpoints: ["sanitize-pdf"]
+ endpoints: ["sanitize-pdf"],
+ operationConfig: sanitizeOperationConfig,
+ settingsComponent: SanitizeSettings
},
"flatten": {
icon: layers_clear,
@@ -105,7 +137,9 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
maxFiles: -1,
- endpoints: ["unlock-pdf-forms"]
+ endpoints: ["unlock-pdf-forms"],
+ operationConfig: unlockPdfFormsOperationConfig,
+ settingsComponent: UnlockPdfFormsSettings
},
"manage-certificates": {
icon: license,
@@ -125,7 +159,9 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.DOCUMENT_SECURITY,
maxFiles: -1,
- endpoints: ["add-password"]
+ endpoints: ["add-password"],
+ operationConfig: changePermissionsOperationConfig,
+ settingsComponent: ChangePermissionsSettings
},
// Verification
@@ -196,7 +232,9 @@ export function useFlatToolRegistry(): ToolRegistry {
view: "split",
description: t("home.split.desc", "Split PDFs into multiple documents"),
categoryId: ToolCategoryId.STANDARD_TOOLS,
- subcategoryId: SubcategoryId.PAGE_FORMATTING
+ subcategoryId: SubcategoryId.PAGE_FORMATTING,
+ operationConfig: splitOperationConfig,
+ settingsComponent: SplitSettings
},
"reorganize-pages": {
icon: move_down,
@@ -243,7 +281,8 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.PAGE_FORMATTING,
maxFiles: -1,
- endpoints: ["pdf-to-single-page"]
+ endpoints: ["pdf-to-single-page"],
+ operationConfig: singleLargePageOperationConfig
},
"add-attachments": {
icon: attachment,
@@ -326,7 +365,8 @@ export function useFlatToolRegistry(): ToolRegistry {
subcategoryId: SubcategoryId.REMOVAL,
endpoints: ["remove-password"],
maxFiles: -1,
-
+ operationConfig: removePasswordOperationConfig,
+ settingsComponent: RemovePasswordSettings
},
"remove-certificate-sign": {
icon: remove_moderator,
@@ -337,7 +377,8 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.STANDARD_TOOLS,
subcategoryId: SubcategoryId.REMOVAL,
maxFiles: -1,
- endpoints: ["remove-certificate-sign"]
+ endpoints: ["remove-certificate-sign"],
+ operationConfig: removeCertificateSignOperationConfig
},
@@ -346,11 +387,13 @@ export function useFlatToolRegistry(): ToolRegistry {
"automate": {
icon: automation,
name: t("home.automate.title", "Automate"),
- component: null,
+ component: React.lazy(() => import('../tools/Automate')),
view: "format",
description: t("home.automate.desc", "Build multi-step workflows by chaining together PDF actions. Ideal for recurring tasks."),
categoryId: ToolCategoryId.ADVANCED_TOOLS,
- subcategoryId: SubcategoryId.AUTOMATION
+ subcategoryId: SubcategoryId.AUTOMATION,
+ maxFiles: -1,
+ endpoints: ["handleData"]
},
"auto-rename-pdf-file": {
icon: match_word,
@@ -401,7 +444,9 @@ export function useFlatToolRegistry(): ToolRegistry {
categoryId: ToolCategoryId.ADVANCED_TOOLS,
subcategoryId: SubcategoryId.ADVANCED_FORMATTING,
maxFiles: -1,
- endpoints: ["repair"]
+ endpoints: ["repair"],
+ operationConfig: repairOperationConfig,
+ settingsComponent: RepairSettings
},
"detect-split-scanned-photos": {
icon: scanner,
@@ -530,7 +575,9 @@ export function useFlatToolRegistry(): ToolRegistry {
description: t("home.compress.desc", "Compress PDFs to reduce their file size."),
categoryId: ToolCategoryId.RECOMMENDED_TOOLS,
subcategoryId: SubcategoryId.GENERAL,
- maxFiles: -1
+ maxFiles: -1,
+ operationConfig: compressOperationConfig,
+ settingsComponent: CompressSettings
},
"convert": {
icon: sync_alt,
@@ -574,7 +621,9 @@ export function useFlatToolRegistry(): ToolRegistry {
"zip",
// Other
"dbf", "fods", "vsd", "vor", "vor3", "vor4", "uop", "pct", "ps", "pdf"
- ]
+ ],
+ operationConfig: convertOperationConfig,
+ settingsComponent: ConvertSettings
},
"mergePdfs": {
icon: library_add,
@@ -604,7 +653,9 @@ export function useFlatToolRegistry(): ToolRegistry {
description: t("home.ocr.desc", "Extract text from scanned PDFs using Optical Character Recognition"),
categoryId: ToolCategoryId.RECOMMENDED_TOOLS,
subcategoryId: SubcategoryId.GENERAL,
- maxFiles: -1
+ maxFiles: -1,
+ operationConfig: ocrOperationConfig,
+ settingsComponent: OCRSettings
},
"redact": {
icon: visibility_off,
@@ -617,15 +668,16 @@ export function useFlatToolRegistry(): ToolRegistry {
},
};
- if (showPlaceholderTools) {
- return allTools;
- } else {
- const filteredTools = Object.keys(allTools)
- .filter(key => allTools[key].component !== null || allTools[key].link)
- .reduce((obj, key) => {
- obj[key] = allTools[key];
- return obj;
- }, {} as ToolRegistry);
- return filteredTools;
- }
+ if (showPlaceholderTools) {
+ return allTools;
+ } else {
+ const filteredTools = Object.keys(allTools)
+ .filter(key => allTools[key].component !== null || allTools[key].link)
+ .reduce((obj, key) => {
+ obj[key] = allTools[key];
+ return obj;
+ }, {} as ToolRegistry);
+ return filteredTools;
+ }
+ }, [t]); // Only re-compute when translations change
}
diff --git a/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.test.ts b/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.test.ts
index 747cd67b7..7e6032214 100644
--- a/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.test.ts
+++ b/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.test.ts
@@ -26,7 +26,7 @@ import { ToolOperationConfig, ToolOperationHook, useToolOperation } from '../sha
describe('useAddPasswordOperation', () => {
const mockUseToolOperation = vi.mocked(useToolOperation);
- const getToolConfig = (): ToolOperationConfig => mockUseToolOperation.mock.calls[0][0];
+ const getToolConfig = (): ToolOperationConfig => mockUseToolOperation.mock.calls[0][0] as ToolOperationConfig;
const mockToolOperationReturn: ToolOperationHook = {
files: [],
diff --git a/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.ts b/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.ts
index d94b9650e..bd2f2176c 100644
--- a/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.ts
+++ b/frontend/src/hooks/tools/addPassword/useAddPasswordOperation.ts
@@ -1,30 +1,45 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { AddPasswordFullParameters } from './useAddPasswordParameters';
+import { AddPasswordFullParameters, defaultParameters } from './useAddPasswordParameters';
+import { defaultParameters as permissionsDefaults } from '../changePermissions/useChangePermissionsParameters';
import { getFormData } from '../changePermissions/useChangePermissionsOperation';
+// Static function that can be used by both the hook and automation executor
+export const buildAddPasswordFormData = (parameters: AddPasswordFullParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+ formData.append("password", parameters.password);
+ formData.append("ownerPassword", parameters.ownerPassword);
+ formData.append("keyLength", parameters.keyLength.toString());
+ getFormData(parameters.permissions).forEach(([key, value]) => {
+ formData.append(key, value);
+ });
+ return formData;
+};
+
+// Full default parameters including permissions for automation
+const fullDefaultParameters: AddPasswordFullParameters = {
+ ...defaultParameters,
+ permissions: permissionsDefaults,
+};
+
+// Static configuration object
+export const addPasswordOperationConfig = {
+ operationType: 'addPassword',
+ endpoint: '/api/v1/security/add-password',
+ buildFormData: buildAddPasswordFormData,
+ filePrefix: 'encrypted_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters: fullDefaultParameters,
+} as const;
+
export const useAddPasswordOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: AddPasswordFullParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
- formData.append("password", parameters.password);
- formData.append("ownerPassword", parameters.ownerPassword);
- formData.append("keyLength", parameters.keyLength.toString());
- getFormData(parameters.permissions).forEach(([key, value]) => {
- formData.append(key, value);
- });
- return formData;
- };
-
return useToolOperation({
- operationType: 'addPassword',
- endpoint: '/api/v1/security/add-password',
- buildFormData,
+ ...addPasswordOperationConfig,
filePrefix: t('addPassword.filenamePrefix', 'encrypted') + '_',
- multiFileEndpoint: false,
getErrorMessage: createStandardErrorHandler(t('addPassword.error.failed', 'An error occurred while encrypting the PDF.'))
});
};
diff --git a/frontend/src/hooks/tools/addWatermark/useAddWatermarkOperation.ts b/frontend/src/hooks/tools/addWatermark/useAddWatermarkOperation.ts
index a5f28bc06..5c07ee6e7 100644
--- a/frontend/src/hooks/tools/addWatermark/useAddWatermarkOperation.ts
+++ b/frontend/src/hooks/tools/addWatermark/useAddWatermarkOperation.ts
@@ -1,9 +1,10 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { AddWatermarkParameters } from './useAddWatermarkParameters';
+import { AddWatermarkParameters, defaultParameters } from './useAddWatermarkParameters';
-const buildFormData = (parameters: AddWatermarkParameters, file: File): FormData => {
+// Static function that can be used by both the hook and automation executor
+export const buildAddWatermarkFormData = (parameters: AddWatermarkParameters, file: File): FormData => {
const formData = new FormData();
formData.append("fileInput", file);
@@ -32,15 +33,22 @@ const buildFormData = (parameters: AddWatermarkParameters, file: File): FormData
return formData;
};
+// Static configuration object
+export const addWatermarkOperationConfig = {
+ operationType: 'watermark',
+ endpoint: '/api/v1/security/add-watermark',
+ buildFormData: buildAddWatermarkFormData,
+ filePrefix: 'watermarked_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
+
export const useAddWatermarkOperation = () => {
const { t } = useTranslation();
return useToolOperation({
- operationType: 'watermark',
- endpoint: '/api/v1/security/add-watermark',
- buildFormData,
+ ...addWatermarkOperationConfig,
filePrefix: t('watermark.filenamePrefix', 'watermarked') + '_',
- multiFileEndpoint: false, // Individual API calls per file
getErrorMessage: createStandardErrorHandler(t('watermark.error.failed', 'An error occurred while adding watermark to the PDF.'))
});
};
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/addWatermark/useAddWatermarkParameters.ts b/frontend/src/hooks/tools/addWatermark/useAddWatermarkParameters.ts
index a7cb23430..5b9a25da6 100644
--- a/frontend/src/hooks/tools/addWatermark/useAddWatermarkParameters.ts
+++ b/frontend/src/hooks/tools/addWatermark/useAddWatermarkParameters.ts
@@ -46,3 +46,4 @@ export const useAddWatermarkParameters = (): AddWatermarkParametersHook => {
},
});
};
+
diff --git a/frontend/src/hooks/tools/automate/useAutomateOperation.ts b/frontend/src/hooks/tools/automate/useAutomateOperation.ts
new file mode 100644
index 000000000..f1aeaf900
--- /dev/null
+++ b/frontend/src/hooks/tools/automate/useAutomateOperation.ts
@@ -0,0 +1,49 @@
+import { useToolOperation } from '../shared/useToolOperation';
+import { useCallback } from 'react';
+import { executeAutomationSequence } from '../../../utils/automationExecutor';
+import { useFlatToolRegistry } from '../../../data/useTranslatedToolRegistry';
+import { AutomateParameters } from '../../../types/automation';
+import { AUTOMATION_CONSTANTS } from '../../../constants/automation';
+
+export function useAutomateOperation() {
+ const toolRegistry = useFlatToolRegistry();
+
+ const customProcessor = useCallback(async (params: AutomateParameters, files: File[]) => {
+ console.log('🚀 Starting automation execution via customProcessor', { params, files });
+
+ if (!params.automationConfig) {
+ throw new Error('No automation configuration provided');
+ }
+
+ // Execute the automation sequence and return the final results
+ const finalResults = await executeAutomationSequence(
+ params.automationConfig!,
+ files,
+ toolRegistry,
+ (stepIndex: number, operationName: string) => {
+ console.log(`Step ${stepIndex + 1} started: ${operationName}`);
+ params.onStepStart?.(stepIndex, operationName);
+ },
+ (stepIndex: number, resultFiles: File[]) => {
+ console.log(`Step ${stepIndex + 1} completed with ${resultFiles.length} files`);
+ params.onStepComplete?.(stepIndex, resultFiles);
+ },
+ (stepIndex: number, error: string) => {
+ console.error(`Step ${stepIndex + 1} failed:`, error);
+ params.onStepError?.(stepIndex, error);
+ throw new Error(`Automation step ${stepIndex + 1} failed: ${error}`);
+ }
+ );
+
+ console.log(`✅ Automation completed, returning ${finalResults.length} files`);
+ return finalResults;
+ }, [toolRegistry]);
+
+ return useToolOperation({
+ operationType: 'automate',
+ endpoint: '/api/v1/pipeline/handleData', // Not used with customProcessor
+ buildFormData: () => new FormData(), // Not used with customProcessor
+ customProcessor,
+ filePrefix: AUTOMATION_CONSTANTS.FILE_PREFIX
+ });
+}
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/automate/useAutomationForm.ts b/frontend/src/hooks/tools/automate/useAutomationForm.ts
new file mode 100644
index 000000000..11464a329
--- /dev/null
+++ b/frontend/src/hooks/tools/automate/useAutomationForm.ts
@@ -0,0 +1,114 @@
+import { useState, useEffect } from 'react';
+import { useTranslation } from 'react-i18next';
+import { AutomationTool, AutomationConfig, AutomationMode } from '../../../types/automation';
+import { AUTOMATION_CONSTANTS } from '../../../constants/automation';
+import { ToolRegistryEntry } from '../../../data/toolsTaxonomy';
+
+interface UseAutomationFormProps {
+ mode: AutomationMode;
+ existingAutomation?: AutomationConfig;
+ toolRegistry: Record;
+}
+
+export function useAutomationForm({ mode, existingAutomation, toolRegistry }: UseAutomationFormProps) {
+ const { t } = useTranslation();
+
+ const [automationName, setAutomationName] = useState('');
+ const [selectedTools, setSelectedTools] = useState([]);
+
+ const getToolName = (operation: string) => {
+ const tool = toolRegistry?.[operation] as any;
+ return tool?.name || t(`tools.${operation}.name`, operation);
+ };
+
+ const getToolDefaultParameters = (operation: string): Record => {
+ const config = toolRegistry[operation]?.operationConfig;
+ if (config?.defaultParameters) {
+ return { ...config.defaultParameters };
+ }
+ return {};
+ };
+
+ // Initialize based on mode and existing automation
+ useEffect(() => {
+ if ((mode === AutomationMode.SUGGESTED || mode === AutomationMode.EDIT) && existingAutomation) {
+ setAutomationName(existingAutomation.name || '');
+
+ const operations = existingAutomation.operations || [];
+ const tools = operations.map((op, index) => {
+ const operation = typeof op === 'string' ? op : op.operation;
+ return {
+ id: `${operation}-${Date.now()}-${index}`,
+ operation: operation,
+ name: getToolName(operation),
+ configured: mode === AutomationMode.EDIT ? true : false,
+ parameters: typeof op === 'object' ? op.parameters || {} : {}
+ };
+ });
+
+ setSelectedTools(tools);
+ } else if (mode === AutomationMode.CREATE && selectedTools.length === 0) {
+ // Initialize with default empty tools for new automation
+ const defaultTools = Array.from({ length: AUTOMATION_CONSTANTS.DEFAULT_TOOL_COUNT }, (_, index) => ({
+ id: `tool-${index + 1}-${Date.now()}`,
+ operation: '',
+ name: t('automate.creation.tools.selectTool', 'Select a tool...'),
+ configured: false,
+ parameters: {}
+ }));
+ setSelectedTools(defaultTools);
+ }
+ }, [mode, existingAutomation, selectedTools.length, t, getToolName]);
+
+ const addTool = (operation: string) => {
+ const newTool: AutomationTool = {
+ id: `${operation}-${Date.now()}`,
+ operation,
+ name: getToolName(operation),
+ configured: false,
+ parameters: getToolDefaultParameters(operation)
+ };
+
+ setSelectedTools([...selectedTools, newTool]);
+ };
+
+ const removeTool = (index: number) => {
+ if (selectedTools.length <= AUTOMATION_CONSTANTS.MIN_TOOL_COUNT) return;
+ setSelectedTools(selectedTools.filter((_, i) => i !== index));
+ };
+
+ const updateTool = (index: number, updates: Partial) => {
+ const updatedTools = [...selectedTools];
+ updatedTools[index] = { ...updatedTools[index], ...updates };
+ setSelectedTools(updatedTools);
+ };
+
+ const hasUnsavedChanges = () => {
+ return (
+ automationName.trim() !== '' ||
+ selectedTools.some(tool => tool.operation !== '' || tool.configured)
+ );
+ };
+
+ const canSaveAutomation = () => {
+ return (
+ automationName.trim() !== '' &&
+ selectedTools.length > 0 &&
+ selectedTools.every(tool => tool.configured && tool.operation !== '')
+ );
+ };
+
+ return {
+ automationName,
+ setAutomationName,
+ selectedTools,
+ setSelectedTools,
+ addTool,
+ removeTool,
+ updateTool,
+ hasUnsavedChanges,
+ canSaveAutomation,
+ getToolName,
+ getToolDefaultParameters
+ };
+}
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/automate/useSavedAutomations.ts b/frontend/src/hooks/tools/automate/useSavedAutomations.ts
new file mode 100644
index 000000000..c52e4c784
--- /dev/null
+++ b/frontend/src/hooks/tools/automate/useSavedAutomations.ts
@@ -0,0 +1,55 @@
+import { useState, useEffect, useCallback } from 'react';
+import { AutomationConfig } from '../../../services/automationStorage';
+
+export interface SavedAutomation extends AutomationConfig {}
+
+export function useSavedAutomations() {
+ const [savedAutomations, setSavedAutomations] = useState([]);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState(null);
+
+ const loadSavedAutomations = useCallback(async () => {
+ try {
+ setLoading(true);
+ setError(null);
+ const { automationStorage } = await import('../../../services/automationStorage');
+ const automations = await automationStorage.getAllAutomations();
+ setSavedAutomations(automations);
+ } catch (err) {
+ console.error('Error loading saved automations:', err);
+ setError(err as Error);
+ setSavedAutomations([]);
+ } finally {
+ setLoading(false);
+ }
+ }, []);
+
+ const refreshAutomations = useCallback(() => {
+ loadSavedAutomations();
+ }, [loadSavedAutomations]);
+
+ const deleteAutomation = useCallback(async (id: string) => {
+ try {
+ const { automationStorage } = await import('../../../services/automationStorage');
+ await automationStorage.deleteAutomation(id);
+ // Refresh the list after deletion
+ refreshAutomations();
+ } catch (err) {
+ console.error('Error deleting automation:', err);
+ throw err;
+ }
+ }, [refreshAutomations]);
+
+ // Load automations on mount
+ useEffect(() => {
+ loadSavedAutomations();
+ }, [loadSavedAutomations]);
+
+ return {
+ savedAutomations,
+ loading,
+ error,
+ refreshAutomations,
+ deleteAutomation
+ };
+}
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/automate/useSuggestedAutomations.ts b/frontend/src/hooks/tools/automate/useSuggestedAutomations.ts
new file mode 100644
index 000000000..bb1ed5916
--- /dev/null
+++ b/frontend/src/hooks/tools/automate/useSuggestedAutomations.ts
@@ -0,0 +1,53 @@
+import { useMemo } from 'react';
+import { useTranslation } from 'react-i18next';
+import StarIcon from '@mui/icons-material/Star';
+import { SuggestedAutomation } from '../../../types/automation';
+
+export function useSuggestedAutomations(): SuggestedAutomation[] {
+ const { t } = useTranslation();
+
+ const suggestedAutomations = useMemo(() => {
+ const now = new Date().toISOString();
+ return [
+ {
+ id: "compress-and-merge",
+ name: t("automation.suggested.compressAndMerge", "Compress & Merge"),
+ description: t("automation.suggested.compressAndMergeDesc", "Compress PDFs and merge them into one file"),
+ operations: [
+ { operation: "compress", parameters: {} },
+ { operation: "merge", parameters: {} }
+ ],
+ createdAt: now,
+ updatedAt: now,
+ icon: StarIcon,
+ },
+ {
+ id: "ocr-and-convert",
+ name: t("automation.suggested.ocrAndConvert", "OCR & Convert"),
+ description: t("automation.suggested.ocrAndConvertDesc", "Extract text via OCR and convert to different format"),
+ operations: [
+ { operation: "ocr", parameters: {} },
+ { operation: "convert", parameters: {} }
+ ],
+ createdAt: now,
+ updatedAt: now,
+ icon: StarIcon,
+ },
+ {
+ id: "secure-workflow",
+ name: t("automation.suggested.secureWorkflow", "Secure Workflow"),
+ description: t("automation.suggested.secureWorkflowDesc", "Sanitize, add password, and set permissions"),
+ operations: [
+ { operation: "sanitize", parameters: {} },
+ { operation: "addPassword", parameters: {} },
+ { operation: "changePermissions", parameters: {} }
+ ],
+ createdAt: now,
+ updatedAt: now,
+ icon: StarIcon,
+ },
+ ];
+ }, [t]);
+
+ return suggestedAutomations;
+}
diff --git a/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.test.ts b/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.test.ts
index 845403841..4ffd9b45c 100644
--- a/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.test.ts
+++ b/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.test.ts
@@ -25,7 +25,7 @@ import { ToolOperationConfig, ToolOperationHook, useToolOperation } from '../sha
describe('useChangePermissionsOperation', () => {
const mockUseToolOperation = vi.mocked(useToolOperation);
- const getToolConfig = (): ToolOperationConfig => mockUseToolOperation.mock.calls[0][0];
+ const getToolConfig = (): ToolOperationConfig => mockUseToolOperation.mock.calls[0][0] as ToolOperationConfig;
const mockToolOperationReturn: ToolOperationHook = {
files: [],
@@ -109,7 +109,7 @@ describe('useChangePermissionsOperation', () => {
{ property: 'multiFileEndpoint' as const, expectedValue: false },
{ property: 'endpoint' as const, expectedValue: '/api/v1/security/add-password' },
{ property: 'filePrefix' as const, expectedValue: 'permissions_' },
- { property: 'operationType' as const, expectedValue: 'changePermissions' }
+ { property: 'operationType' as const, expectedValue: 'change-permissions' }
])('should configure $property correctly', ({ property, expectedValue }) => {
renderHook(() => useChangePermissionsOperation());
diff --git a/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.ts b/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.ts
index 664a423ff..ee28d5381 100644
--- a/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.ts
+++ b/frontend/src/hooks/tools/changePermissions/useChangePermissionsOperation.ts
@@ -1,7 +1,7 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import type { ChangePermissionsParameters } from './useChangePermissionsParameters';
+import { ChangePermissionsParameters, defaultParameters } from './useChangePermissionsParameters';
export const getFormData = ((parameters: ChangePermissionsParameters) =>
Object.entries(parameters).map(([key, value]) =>
@@ -9,27 +9,34 @@ export const getFormData = ((parameters: ChangePermissionsParameters) =>
) as string[][]
);
+// Static function that can be used by both the hook and automation executor
+export const buildChangePermissionsFormData = (parameters: ChangePermissionsParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+
+ // Add all permission parameters
+ getFormData(parameters).forEach(([key, value]) => {
+ formData.append(key, value);
+ });
+
+ return formData;
+};
+
+// Static configuration object
+export const changePermissionsOperationConfig = {
+ operationType: 'change-permissions',
+ endpoint: '/api/v1/security/add-password', // Change Permissions is a fake endpoint for the Add Password tool
+ buildFormData: buildChangePermissionsFormData,
+ filePrefix: 'permissions_',
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
+
export const useChangePermissionsOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: ChangePermissionsParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
-
- // Add all permission parameters
- getFormData(parameters).forEach(([key, value]) => {
- formData.append(key, value);
- });
-
- return formData;
- };
-
return useToolOperation({
- operationType: 'changePermissions',
- endpoint: '/api/v1/security/add-password', // Change Permissions is a fake endpoint for the Add Password tool
- buildFormData,
- filePrefix: 'permissions_',
- multiFileEndpoint: false,
+ ...changePermissionsOperationConfig,
getErrorMessage: createStandardErrorHandler(
t('changePermissions.error.failed', 'An error occurred while changing PDF permissions.')
)
diff --git a/frontend/src/hooks/tools/compress/useCompressOperation.ts b/frontend/src/hooks/tools/compress/useCompressOperation.ts
index c93d4b9e7..08d73859e 100644
--- a/frontend/src/hooks/tools/compress/useCompressOperation.ts
+++ b/frontend/src/hooks/tools/compress/useCompressOperation.ts
@@ -1,9 +1,10 @@
import { useTranslation } from 'react-i18next';
-import { useToolOperation } from '../shared/useToolOperation';
+import { useToolOperation, ToolOperationConfig } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { CompressParameters } from './useCompressParameters';
+import { CompressParameters, defaultParameters } from './useCompressParameters';
-const buildFormData = (parameters: CompressParameters, file: File): FormData => {
+// Static configuration that can be used by both the hook and automation executor
+export const buildCompressFormData = (parameters: CompressParameters, file: File): FormData => {
const formData = new FormData();
formData.append("fileInput", file);
@@ -21,15 +22,21 @@ const buildFormData = (parameters: CompressParameters, file: File): FormData =>
return formData;
};
+// Static configuration object
+export const compressOperationConfig = {
+ operationType: 'compress',
+ endpoint: '/api/v1/misc/compress-pdf',
+ buildFormData: buildCompressFormData,
+ filePrefix: 'compressed_',
+ multiFileEndpoint: false, // Individual API calls per file
+ defaultParameters,
+} as const;
+
export const useCompressOperation = () => {
const { t } = useTranslation();
return useToolOperation({
- operationType: 'compress',
- endpoint: '/api/v1/misc/compress-pdf',
- buildFormData,
- filePrefix: 'compressed_',
- multiFileEndpoint: false, // Individual API calls per file
+ ...compressOperationConfig,
getErrorMessage: createStandardErrorHandler(t('compress.error.failed', 'An error occurred while compressing the PDF.'))
});
};
diff --git a/frontend/src/hooks/tools/compress/useCompressParameters.ts b/frontend/src/hooks/tools/compress/useCompressParameters.ts
index b423bdbec..d551dc292 100644
--- a/frontend/src/hooks/tools/compress/useCompressParameters.ts
+++ b/frontend/src/hooks/tools/compress/useCompressParameters.ts
@@ -10,7 +10,7 @@ export interface CompressParameters extends BaseParameters {
fileSizeUnit: 'KB' | 'MB';
}
-const defaultParameters: CompressParameters = {
+export const defaultParameters: CompressParameters = {
compressionLevel: 5,
grayscale: false,
expectedSize: '',
diff --git a/frontend/src/hooks/tools/convert/useConvertOperation.ts b/frontend/src/hooks/tools/convert/useConvertOperation.ts
index f14302aaa..28b854d4b 100644
--- a/frontend/src/hooks/tools/convert/useConvertOperation.ts
+++ b/frontend/src/hooks/tools/convert/useConvertOperation.ts
@@ -1,13 +1,14 @@
import { useCallback } from 'react';
import axios from 'axios';
import { useTranslation } from 'react-i18next';
-import { ConvertParameters } from './useConvertParameters';
+import { ConvertParameters, defaultParameters } from './useConvertParameters';
import { detectFileExtension } from '../../../utils/fileUtils';
import { createFileFromApiResponse } from '../../../utils/fileResponseUtils';
import { useToolOperation, ToolOperationConfig } from '../shared/useToolOperation';
import { getEndpointUrl, isImageFormat, isWebFormat } from '../../../utils/convertUtils';
-const shouldProcessFilesSeparately = (
+// Static function that can be used by both the hook and automation executor
+export const shouldProcessFilesSeparately = (
selectedFiles: File[],
parameters: ConvertParameters
): boolean => {
@@ -29,7 +30,8 @@ const shouldProcessFilesSeparately = (
);
};
-const buildFormData = (parameters: ConvertParameters, selectedFiles: File[]): FormData => {
+// Static function that can be used by both the hook and automation executor
+export const buildConvertFormData = (parameters: ConvertParameters, selectedFiles: File[]): FormData => {
const formData = new FormData();
selectedFiles.forEach(file => {
@@ -69,7 +71,8 @@ const buildFormData = (parameters: ConvertParameters, selectedFiles: File[]): Fo
return formData;
};
-const createFileFromResponse = (
+// Static function that can be used by both the hook and automation executor
+export const createFileFromResponse = (
responseData: any,
headers: any,
originalFileName: string,
@@ -81,6 +84,59 @@ const createFileFromResponse = (
return createFileFromApiResponse(responseData, headers, fallbackFilename);
};
+// Static processor that can be used by both the hook and automation executor
+export const convertProcessor = async (
+ parameters: ConvertParameters,
+ selectedFiles: File[]
+): Promise => {
+ const processedFiles: File[] = [];
+ const endpoint = getEndpointUrl(parameters.fromExtension, parameters.toExtension);
+
+ if (!endpoint) {
+ throw new Error('Unsupported conversion format');
+ }
+
+ // Convert-specific routing logic: decide batch vs individual processing
+ if (shouldProcessFilesSeparately(selectedFiles, parameters)) {
+ // Individual processing for complex cases (PDF→image, smart detection, etc.)
+ for (const file of selectedFiles) {
+ try {
+ const formData = buildConvertFormData(parameters, [file]);
+ const response = await axios.post(endpoint, formData, { responseType: 'blob' });
+
+ const convertedFile = createFileFromResponse(response.data, response.headers, file.name, parameters.toExtension);
+
+ processedFiles.push(convertedFile);
+ } catch (error) {
+ console.warn(`Failed to convert file ${file.name}:`, error);
+ }
+ }
+ } else {
+ // Batch processing for simple cases (image→PDF combine)
+ const formData = buildConvertFormData(parameters, selectedFiles);
+ const response = await axios.post(endpoint, formData, { responseType: 'blob' });
+
+ const baseFilename = selectedFiles.length === 1
+ ? selectedFiles[0].name
+ : 'converted_files';
+
+ const convertedFile = createFileFromResponse(response.data, response.headers, baseFilename, parameters.toExtension);
+ processedFiles.push(convertedFile);
+ }
+
+ return processedFiles;
+};
+
+// Static configuration object
+export const convertOperationConfig = {
+ operationType: 'convert',
+ endpoint: '', // Not used with customProcessor but required
+ buildFormData: buildConvertFormData, // Not used with customProcessor but required
+ filePrefix: 'converted_',
+ customProcessor: convertProcessor,
+ defaultParameters,
+} as const;
+
export const useConvertOperation = () => {
const { t } = useTranslation();
@@ -88,52 +144,12 @@ export const useConvertOperation = () => {
parameters: ConvertParameters,
selectedFiles: File[]
): Promise => {
-
- const processedFiles: File[] = [];
- const endpoint = getEndpointUrl(parameters.fromExtension, parameters.toExtension);
-
- if (!endpoint) {
- throw new Error(t('errorNotSupported', 'Unsupported conversion format'));
- }
-
- // Convert-specific routing logic: decide batch vs individual processing
- if (shouldProcessFilesSeparately(selectedFiles, parameters)) {
- // Individual processing for complex cases (PDF→image, smart detection, etc.)
- for (const file of selectedFiles) {
- try {
- const formData = buildFormData(parameters, [file]);
- const response = await axios.post(endpoint, formData, { responseType: 'blob' });
-
- const convertedFile = createFileFromResponse(response.data, response.headers, file.name, parameters.toExtension);
-
- processedFiles.push(convertedFile);
- } catch (error) {
- console.warn(`Failed to convert file ${file.name}:`, error);
- }
- }
- } else {
- // Batch processing for simple cases (image→PDF combine)
- const formData = buildFormData(parameters, selectedFiles);
- const response = await axios.post(endpoint, formData, { responseType: 'blob' });
-
- const baseFilename = selectedFiles.length === 1
- ? selectedFiles[0].name
- : 'converted_files';
-
- const convertedFile = createFileFromResponse(response.data, response.headers, baseFilename, parameters.toExtension);
- processedFiles.push(convertedFile);
-
- }
-
- return processedFiles;
- }, [t]);
+ return convertProcessor(parameters, selectedFiles);
+ }, []);
return useToolOperation({
- operationType: 'convert',
- endpoint: '', // Not used with customProcessor but required
- buildFormData, // Not used with customProcessor but required
- filePrefix: 'converted_',
- customProcessor: customConvertProcessor, // Convert handles its own routing
+ ...convertOperationConfig,
+ customProcessor: customConvertProcessor, // Use instance-specific processor for translation support
getErrorMessage: (error) => {
if (error.response?.data && typeof error.response.data === 'string') {
return error.response.data;
diff --git a/frontend/src/hooks/tools/convert/useConvertParameters.ts b/frontend/src/hooks/tools/convert/useConvertParameters.ts
index 4d04dd8f0..2a7b7d523 100644
--- a/frontend/src/hooks/tools/convert/useConvertParameters.ts
+++ b/frontend/src/hooks/tools/convert/useConvertParameters.ts
@@ -8,7 +8,7 @@ import {
type OutputOption,
type FitOption
} from '../../../constants/convertConstants';
-import { getEndpointName as getEndpointNameUtil, getEndpointUrl, isImageFormat, isWebFormat } from '../../../utils/convertUtils';
+import { getEndpointName as getEndpointNameUtil, getEndpointUrl, isImageFormat, isWebFormat, getAvailableToExtensions as getAvailableToExtensionsUtil } from '../../../utils/convertUtils';
import { detectFileExtension as detectFileExtensionUtil } from '../../../utils/fileUtils';
import { BaseParameters } from '../../../types/parameters';
import { useBaseParameters, BaseParametersHook } from '../shared/useBaseParameters';
@@ -47,7 +47,7 @@ export interface ConvertParametersHook extends BaseParametersHook) => void;
}
-const defaultParameters: ConvertParameters = {
+export const defaultParameters: ConvertParameters = {
fromExtension: '',
toExtension: '',
imageOptions: {
@@ -155,30 +155,7 @@ export const useConvertParameters = (): ConvertParametersHook => {
return getEndpointUrl(fromExtension, toExtension);
};
- const getAvailableToExtensions = (fromExtension: string) => {
- if (!fromExtension) return [];
-
- // Handle dynamic format identifiers (file-)
- if (fromExtension.startsWith('file-')) {
- // Dynamic format - use 'any' conversion options (file-to-pdf)
- const supportedExtensions = CONVERSION_MATRIX['any'] || [];
- return TO_FORMAT_OPTIONS.filter(option =>
- supportedExtensions.includes(option.value)
- );
- }
-
- let supportedExtensions = CONVERSION_MATRIX[fromExtension] || [];
-
- // If no explicit conversion exists, but file-to-pdf might be available,
- // fall back to 'any' conversion (which converts unknown files to PDF via file-to-pdf)
- if (supportedExtensions.length === 0 && fromExtension !== 'any') {
- supportedExtensions = CONVERSION_MATRIX['any'] || [];
- }
-
- return TO_FORMAT_OPTIONS.filter(option =>
- supportedExtensions.includes(option.value)
- );
- };
+ const getAvailableToExtensions = getAvailableToExtensionsUtil;
const analyzeFileTypes = useCallback((files: Array<{name: string}>) => {
diff --git a/frontend/src/hooks/tools/ocr/useOCROperation.ts b/frontend/src/hooks/tools/ocr/useOCROperation.ts
index 8beeff950..b816b3773 100644
--- a/frontend/src/hooks/tools/ocr/useOCROperation.ts
+++ b/frontend/src/hooks/tools/ocr/useOCROperation.ts
@@ -1,6 +1,6 @@
import { useCallback } from 'react';
import { useTranslation } from 'react-i18next';
-import { OCRParameters } from './useOCRParameters';
+import { OCRParameters, defaultParameters } from './useOCRParameters';
import { useToolOperation, ToolOperationConfig } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
import { useToolResources } from '../shared/useToolResources';
@@ -37,7 +37,8 @@ function stripExt(name: string): string {
return i > 0 ? name.slice(0, i) : name;
}
-const buildFormData = (parameters: OCRParameters, file: File): FormData => {
+// Static function that can be used by both the hook and automation executor
+export const buildOCRFormData = (parameters: OCRParameters, file: File): FormData => {
const formData = new FormData();
formData.append('fileInput', file);
parameters.languages.forEach((lang) => formData.append('languages', lang));
@@ -51,57 +52,70 @@ const buildFormData = (parameters: OCRParameters, file: File): FormData => {
return formData;
};
+// Static response handler for OCR - can be used by automation executor
+export const ocrResponseHandler = async (blob: Blob, originalFiles: File[], extractZipFiles: (blob: Blob) => Promise): Promise => {
+ const headBuf = await blob.slice(0, 8).arrayBuffer();
+ const head = new TextDecoder().decode(new Uint8Array(headBuf));
+
+ // ZIP: sidecar or multi-asset output
+ if (head.startsWith('PK')) {
+ const base = stripExt(originalFiles[0].name);
+ try {
+ const extractedFiles = await extractZipFiles(blob);
+ if (extractedFiles.length > 0) return extractedFiles;
+ } catch { /* ignore and try local extractor */ }
+ try {
+ const local = await extractZipFile(blob); // local fallback
+ if (local.length > 0) return local;
+ } catch { /* fall through */ }
+ return [new File([blob], `ocr_${base}.zip`, { type: 'application/zip' })];
+ }
+
+ // Not a PDF: surface error details if present
+ if (!head.startsWith('%PDF')) {
+ const textBuf = await blob.slice(0, 1024).arrayBuffer();
+ const text = new TextDecoder().decode(new Uint8Array(textBuf));
+ if (/error|exception|html/i.test(text)) {
+ if (text.includes('OCR tools') && text.includes('not installed')) {
+ throw new Error('OCR tools (OCRmyPDF or Tesseract) are not installed on the server. Use the standard or fat Docker image instead of ultra-lite, or install OCR tools manually.');
+ }
+ const title =
+ text.match(/]*>([^<]+)<\/title>/i)?.[1] ||
+ text.match(/]*>([^<]+)<\/h1>/i)?.[1] ||
+ 'Unknown error';
+ throw new Error(`OCR service error: ${title}`);
+ }
+ throw new Error(`Response is not a valid PDF. Header: "${head}"`);
+ }
+
+ const base = stripExt(originalFiles[0].name);
+ return [new File([blob], `ocr_${base}.pdf`, { type: 'application/pdf' })];
+};
+
+// Static configuration object (without t function dependencies)
+export const ocrOperationConfig = {
+ operationType: 'ocr',
+ endpoint: '/api/v1/misc/ocr-pdf',
+ buildFormData: buildOCRFormData,
+ filePrefix: 'ocr_',
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
+
export const useOCROperation = () => {
const { t } = useTranslation();
const { extractZipFiles } = useToolResources();
// OCR-specific parsing: ZIP (sidecar) vs PDF vs HTML error
const responseHandler = useCallback(async (blob: Blob, originalFiles: File[]): Promise => {
- const headBuf = await blob.slice(0, 8).arrayBuffer();
- const head = new TextDecoder().decode(new Uint8Array(headBuf));
-
- // ZIP: sidecar or multi-asset output
- if (head.startsWith('PK')) {
- const base = stripExt(originalFiles[0].name);
- try {
- const extracted = await extractZipFiles(blob);
- if (extracted.length > 0) return extracted;
- } catch { /* ignore and try local extractor */ }
- try {
- const local = await extractZipFile(blob); // local fallback
- if (local.length > 0) return local;
- } catch { /* fall through */ }
- return [new File([blob], `ocr_${base}.zip`, { type: 'application/zip' })];
- }
-
- // Not a PDF: surface error details if present
- if (!head.startsWith('%PDF')) {
- const textBuf = await blob.slice(0, 1024).arrayBuffer();
- const text = new TextDecoder().decode(new Uint8Array(textBuf));
- if (/error|exception|html/i.test(text)) {
- if (text.includes('OCR tools') && text.includes('not installed')) {
- throw new Error('OCR tools (OCRmyPDF or Tesseract) are not installed on the server. Use the standard or fat Docker image instead of ultra-lite, or install OCR tools manually.');
- }
- const title =
- text.match(/]*>([^<]+)<\/title>/i)?.[1] ||
- text.match(/]*>([^<]+)<\/h1>/i)?.[1] ||
- t('ocr.error.unknown', 'Unknown error');
- throw new Error(`OCR service error: ${title}`);
- }
- throw new Error(`Response is not a valid PDF. Header: "${head}"`);
- }
-
- const base = stripExt(originalFiles[0].name);
- return [new File([blob], `ocr_${base}.pdf`, { type: 'application/pdf' })];
- }, [t, extractZipFiles]);
+ // extractZipFiles from useToolResources already returns File[] directly
+ const simpleExtractZipFiles = extractZipFiles;
+ return ocrResponseHandler(blob, originalFiles, simpleExtractZipFiles);
+ }, [extractZipFiles]);
const ocrConfig: ToolOperationConfig = {
- operationType: 'ocr',
- endpoint: '/api/v1/misc/ocr-pdf',
- buildFormData,
- filePrefix: 'ocr_',
- multiFileEndpoint: false, // Process files individually
- responseHandler, // use shared flow
+ ...ocrOperationConfig,
+ responseHandler,
getErrorMessage: (error) =>
error.message?.includes('OCR tools') && error.message?.includes('not installed')
? 'OCR tools (OCRmyPDF or Tesseract) are not installed on the server. Use the standard or fat Docker image instead of ultra-lite, or install OCR tools manually.'
diff --git a/frontend/src/hooks/tools/ocr/useOCRParameters.ts b/frontend/src/hooks/tools/ocr/useOCRParameters.ts
index 0fbda4a33..a3fd546d2 100644
--- a/frontend/src/hooks/tools/ocr/useOCRParameters.ts
+++ b/frontend/src/hooks/tools/ocr/useOCRParameters.ts
@@ -10,7 +10,7 @@ export interface OCRParameters extends BaseParameters {
export type OCRParametersHook = BaseParametersHook;
-const defaultParameters: OCRParameters = {
+export const defaultParameters: OCRParameters = {
languages: [],
ocrType: 'skip-text',
ocrRenderType: 'hocr',
diff --git a/frontend/src/hooks/tools/removeCertificateSign/useRemoveCertificateSignOperation.ts b/frontend/src/hooks/tools/removeCertificateSign/useRemoveCertificateSignOperation.ts
index 5987944ec..c466606bc 100644
--- a/frontend/src/hooks/tools/removeCertificateSign/useRemoveCertificateSignOperation.ts
+++ b/frontend/src/hooks/tools/removeCertificateSign/useRemoveCertificateSignOperation.ts
@@ -1,23 +1,31 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { RemoveCertificateSignParameters } from './useRemoveCertificateSignParameters';
+import { RemoveCertificateSignParameters, defaultParameters } from './useRemoveCertificateSignParameters';
+
+// Static function that can be used by both the hook and automation executor
+export const buildRemoveCertificateSignFormData = (parameters: RemoveCertificateSignParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+ return formData;
+};
+
+// Static configuration object
+export const removeCertificateSignOperationConfig = {
+ operationType: 'remove-certificate-sign',
+ endpoint: '/api/v1/security/remove-cert-sign',
+ buildFormData: buildRemoveCertificateSignFormData,
+ filePrefix: 'unsigned_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
export const useRemoveCertificateSignOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: RemoveCertificateSignParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
- return formData;
- };
-
return useToolOperation({
- operationType: 'removeCertificateSign',
- endpoint: '/api/v1/security/remove-cert-sign',
- buildFormData,
+ ...removeCertificateSignOperationConfig,
filePrefix: t('removeCertSign.filenamePrefix', 'unsigned') + '_',
- multiFileEndpoint: false,
getErrorMessage: createStandardErrorHandler(t('removeCertSign.error.failed', 'An error occurred while removing certificate signatures.'))
});
};
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.test.ts b/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.test.ts
index 66cd240fc..61faef9a4 100644
--- a/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.test.ts
+++ b/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.test.ts
@@ -25,7 +25,7 @@ import { ToolOperationConfig, ToolOperationHook, useToolOperation } from '../sha
describe('useRemovePasswordOperation', () => {
const mockUseToolOperation = vi.mocked(useToolOperation);
- const getToolConfig = (): ToolOperationConfig => mockUseToolOperation.mock.calls[0][0];
+ const getToolConfig = (): ToolOperationConfig => mockUseToolOperation.mock.calls[0][0] as ToolOperationConfig;
const mockToolOperationReturn: ToolOperationHook = {
files: [],
diff --git a/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.ts b/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.ts
index 37f8fa0db..9d61d3c59 100644
--- a/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.ts
+++ b/frontend/src/hooks/tools/removePassword/useRemovePasswordOperation.ts
@@ -1,24 +1,32 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { RemovePasswordParameters } from './useRemovePasswordParameters';
+import { RemovePasswordParameters, defaultParameters } from './useRemovePasswordParameters';
+
+// Static function that can be used by both the hook and automation executor
+export const buildRemovePasswordFormData = (parameters: RemovePasswordParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+ formData.append("password", parameters.password);
+ return formData;
+};
+
+// Static configuration object
+export const removePasswordOperationConfig = {
+ operationType: 'removePassword',
+ endpoint: '/api/v1/security/remove-password',
+ buildFormData: buildRemovePasswordFormData,
+ filePrefix: 'decrypted_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
export const useRemovePasswordOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: RemovePasswordParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
- formData.append("password", parameters.password);
- return formData;
- };
-
return useToolOperation({
- operationType: 'removePassword',
- endpoint: '/api/v1/security/remove-password',
- buildFormData,
+ ...removePasswordOperationConfig,
filePrefix: t('removePassword.filenamePrefix', 'decrypted') + '_',
- multiFileEndpoint: false,
getErrorMessage: createStandardErrorHandler(t('removePassword.error.failed', 'An error occurred while removing the password from the PDF.'))
});
};
diff --git a/frontend/src/hooks/tools/repair/useRepairOperation.ts b/frontend/src/hooks/tools/repair/useRepairOperation.ts
index b547bbd8f..8be4fb13f 100644
--- a/frontend/src/hooks/tools/repair/useRepairOperation.ts
+++ b/frontend/src/hooks/tools/repair/useRepairOperation.ts
@@ -1,23 +1,31 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { RepairParameters } from './useRepairParameters';
+import { RepairParameters, defaultParameters } from './useRepairParameters';
+
+// Static function that can be used by both the hook and automation executor
+export const buildRepairFormData = (parameters: RepairParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+ return formData;
+};
+
+// Static configuration object
+export const repairOperationConfig = {
+ operationType: 'repair',
+ endpoint: '/api/v1/misc/repair',
+ buildFormData: buildRepairFormData,
+ filePrefix: 'repaired_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
export const useRepairOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: RepairParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
- return formData;
- };
-
return useToolOperation({
- operationType: 'repair',
- endpoint: '/api/v1/misc/repair',
- buildFormData,
+ ...repairOperationConfig,
filePrefix: t('repair.filenamePrefix', 'repaired') + '_',
- multiFileEndpoint: false,
getErrorMessage: createStandardErrorHandler(t('repair.error.failed', 'An error occurred while repairing the PDF.'))
});
};
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/sanitize/useSanitizeOperation.ts b/frontend/src/hooks/tools/sanitize/useSanitizeOperation.ts
index c83086121..284b715f8 100644
--- a/frontend/src/hooks/tools/sanitize/useSanitizeOperation.ts
+++ b/frontend/src/hooks/tools/sanitize/useSanitizeOperation.ts
@@ -1,9 +1,10 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { SanitizeParameters } from './useSanitizeParameters';
+import { SanitizeParameters, defaultParameters } from './useSanitizeParameters';
-const buildFormData = (parameters: SanitizeParameters, file: File): FormData => {
+// Static function that can be used by both the hook and automation executor
+export const buildSanitizeFormData = (parameters: SanitizeParameters, file: File): FormData => {
const formData = new FormData();
formData.append('fileInput', file);
@@ -18,15 +19,22 @@ const buildFormData = (parameters: SanitizeParameters, file: File): FormData =>
return formData;
};
+// Static configuration object
+export const sanitizeOperationConfig = {
+ operationType: 'sanitize',
+ endpoint: '/api/v1/security/sanitize-pdf',
+ buildFormData: buildSanitizeFormData,
+ filePrefix: 'sanitized_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
+
export const useSanitizeOperation = () => {
const { t } = useTranslation();
return useToolOperation({
- operationType: 'sanitize',
- endpoint: '/api/v1/security/sanitize-pdf',
- buildFormData,
+ ...sanitizeOperationConfig,
filePrefix: t('sanitize.filenamePrefix', 'sanitized') + '_',
- multiFileEndpoint: false, // Individual API calls per file
getErrorMessage: createStandardErrorHandler(t('sanitize.error.failed', 'An error occurred while sanitising the PDF.'))
});
};
diff --git a/frontend/src/hooks/tools/shared/useToolOperation.ts b/frontend/src/hooks/tools/shared/useToolOperation.ts
index 4e76e6e7d..299568afd 100644
--- a/frontend/src/hooks/tools/shared/useToolOperation.ts
+++ b/frontend/src/hooks/tools/shared/useToolOperation.ts
@@ -61,6 +61,9 @@ export interface ToolOperationConfig {
/** Extract user-friendly error messages from API errors */
getErrorMessage?: (error: any) => string;
+
+ /** Default parameter values for automation */
+ defaultParameters?: TParams;
}
/**
diff --git a/frontend/src/hooks/tools/singleLargePage/useSingleLargePageOperation.ts b/frontend/src/hooks/tools/singleLargePage/useSingleLargePageOperation.ts
index e73944864..41cbb6dd3 100644
--- a/frontend/src/hooks/tools/singleLargePage/useSingleLargePageOperation.ts
+++ b/frontend/src/hooks/tools/singleLargePage/useSingleLargePageOperation.ts
@@ -1,23 +1,31 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { SingleLargePageParameters } from './useSingleLargePageParameters';
+import { SingleLargePageParameters, defaultParameters } from './useSingleLargePageParameters';
+
+// Static function that can be used by both the hook and automation executor
+export const buildSingleLargePageFormData = (parameters: SingleLargePageParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+ return formData;
+};
+
+// Static configuration object
+export const singleLargePageOperationConfig = {
+ operationType: 'single-large-page',
+ endpoint: '/api/v1/general/pdf-to-single-page',
+ buildFormData: buildSingleLargePageFormData,
+ filePrefix: 'single_page_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
export const useSingleLargePageOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: SingleLargePageParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
- return formData;
- };
-
return useToolOperation({
- operationType: 'singleLargePage',
- endpoint: '/api/v1/general/pdf-to-single-page',
- buildFormData,
+ ...singleLargePageOperationConfig,
filePrefix: t('pdfToSinglePage.filenamePrefix', 'single_page') + '_',
- multiFileEndpoint: false,
getErrorMessage: createStandardErrorHandler(t('pdfToSinglePage.error.failed', 'An error occurred while converting to single page.'))
});
};
\ No newline at end of file
diff --git a/frontend/src/hooks/tools/split/useSplitOperation.ts b/frontend/src/hooks/tools/split/useSplitOperation.ts
index 7702bffad..cc1c6a5d9 100644
--- a/frontend/src/hooks/tools/split/useSplitOperation.ts
+++ b/frontend/src/hooks/tools/split/useSplitOperation.ts
@@ -1,11 +1,11 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { SplitParameters } from './useSplitParameters';
+import { SplitParameters, defaultParameters } from './useSplitParameters';
import { SPLIT_MODES } from '../../../constants/splitConstants';
-
-const buildFormData = (parameters: SplitParameters, selectedFiles: File[]): FormData => {
+// Static functions that can be used by both the hook and automation executor
+export const buildSplitFormData = (parameters: SplitParameters, selectedFiles: File[]): FormData => {
const formData = new FormData();
selectedFiles.forEach(file => {
@@ -40,7 +40,7 @@ const buildFormData = (parameters: SplitParameters, selectedFiles: File[]): Form
return formData;
};
-const getEndpoint = (parameters: SplitParameters): string => {
+export const getSplitEndpoint = (parameters: SplitParameters): string => {
switch (parameters.mode) {
case SPLIT_MODES.BY_PAGES:
return "/api/v1/general/split-pages";
@@ -55,15 +55,21 @@ const getEndpoint = (parameters: SplitParameters): string => {
}
};
+// Static configuration object
+export const splitOperationConfig = {
+ operationType: 'splitPdf',
+ endpoint: getSplitEndpoint,
+ buildFormData: buildSplitFormData,
+ filePrefix: 'split_',
+ multiFileEndpoint: true, // Single API call with all files
+ defaultParameters,
+} as const;
+
export const useSplitOperation = () => {
const { t } = useTranslation();
return useToolOperation({
- operationType: 'split',
- endpoint: (params) => getEndpoint(params),
- buildFormData: buildFormData, // Multi-file signature: (params, selectedFiles) => FormData
- filePrefix: 'split_',
- multiFileEndpoint: true, // Single API call with all files
+ ...splitOperationConfig,
getErrorMessage: createStandardErrorHandler(t('split.error.failed', 'An error occurred while splitting the PDF.'))
});
};
diff --git a/frontend/src/hooks/tools/split/useSplitParameters.ts b/frontend/src/hooks/tools/split/useSplitParameters.ts
index b31ddbae6..e48504304 100644
--- a/frontend/src/hooks/tools/split/useSplitParameters.ts
+++ b/frontend/src/hooks/tools/split/useSplitParameters.ts
@@ -17,7 +17,7 @@ export interface SplitParameters extends BaseParameters {
export type SplitParametersHook = BaseParametersHook;
-const defaultParameters: SplitParameters = {
+export const defaultParameters: SplitParameters = {
mode: '',
pages: '',
hDiv: '2',
diff --git a/frontend/src/hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation.ts b/frontend/src/hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation.ts
index 3b648762b..d6081452f 100644
--- a/frontend/src/hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation.ts
+++ b/frontend/src/hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation.ts
@@ -1,23 +1,31 @@
import { useTranslation } from 'react-i18next';
import { useToolOperation } from '../shared/useToolOperation';
import { createStandardErrorHandler } from '../../../utils/toolErrorHandler';
-import { UnlockPdfFormsParameters } from './useUnlockPdfFormsParameters';
+import { UnlockPdfFormsParameters, defaultParameters } from './useUnlockPdfFormsParameters';
+
+// Static function that can be used by both the hook and automation executor
+export const buildUnlockPdfFormsFormData = (parameters: UnlockPdfFormsParameters, file: File): FormData => {
+ const formData = new FormData();
+ formData.append("fileInput", file);
+ return formData;
+};
+
+// Static configuration object
+export const unlockPdfFormsOperationConfig = {
+ operationType: 'unlock-pdf-forms',
+ endpoint: '/api/v1/misc/unlock-pdf-forms',
+ buildFormData: buildUnlockPdfFormsFormData,
+ filePrefix: 'unlocked_forms_', // Will be overridden in hook with translation
+ multiFileEndpoint: false,
+ defaultParameters,
+} as const;
export const useUnlockPdfFormsOperation = () => {
const { t } = useTranslation();
- const buildFormData = (parameters: UnlockPdfFormsParameters, file: File): FormData => {
- const formData = new FormData();
- formData.append("fileInput", file);
- return formData;
- };
-
return useToolOperation({
- operationType: 'unlockPdfForms',
- endpoint: '/api/v1/misc/unlock-pdf-forms',
- buildFormData,
+ ...unlockPdfFormsOperationConfig,
filePrefix: t('unlockPDFForms.filenamePrefix', 'unlocked_forms') + '_',
- multiFileEndpoint: false,
getErrorMessage: createStandardErrorHandler(t('unlockPDFForms.error.failed', 'An error occurred while unlocking PDF forms.'))
});
};
\ No newline at end of file
diff --git a/frontend/src/hooks/useSuggestedTools.ts b/frontend/src/hooks/useSuggestedTools.ts
index effbe2397..f179a744f 100644
--- a/frontend/src/hooks/useSuggestedTools.ts
+++ b/frontend/src/hooks/useSuggestedTools.ts
@@ -1,5 +1,5 @@
import { useMemo } from 'react';
-import { useToolWorkflow } from '../contexts/ToolWorkflowContext';
+import { useNavigationActions, useNavigationState } from '../contexts/NavigationContext';
// Material UI Icons
import CompressIcon from '@mui/icons-material/Compress';
@@ -44,7 +44,8 @@ const ALL_SUGGESTED_TOOLS: Omit[] = [
];
export function useSuggestedTools(): SuggestedTool[] {
- const { handleToolSelect, selectedToolKey } = useToolWorkflow();
+ const { actions } = useNavigationActions();
+ const { selectedToolKey } = useNavigationState();
return useMemo(() => {
// Filter out the current tool
@@ -53,7 +54,7 @@ export function useSuggestedTools(): SuggestedTool[] {
// Add navigation function to each tool
return filteredTools.map(tool => ({
...tool,
- navigate: () => handleToolSelect(tool.id)
+ navigate: () => actions.handleToolSelect(tool.id)
}));
- }, [selectedToolKey, handleToolSelect]);
+ }, [selectedToolKey, actions]);
}
diff --git a/frontend/src/hooks/useToolManagement.tsx b/frontend/src/hooks/useToolManagement.tsx
index a4c481fcc..9ea048f65 100644
--- a/frontend/src/hooks/useToolManagement.tsx
+++ b/frontend/src/hooks/useToolManagement.tsx
@@ -5,19 +5,16 @@ import { getAllEndpoints, type ToolRegistryEntry } from "../data/toolsTaxonomy";
import { useMultipleEndpointsEnabled } from "./useEndpointConfig";
interface ToolManagementResult {
- selectedToolKey: string | null;
selectedTool: ToolRegistryEntry | null;
toolSelectedFileIds: string[];
toolRegistry: Record;
- selectTool: (toolKey: string) => void;
- clearToolSelection: () => void;
setToolSelectedFileIds: (fileIds: string[]) => void;
+ getSelectedTool: (toolKey: string | null) => ToolRegistryEntry | null;
}
export const useToolManagement = (): ToolManagementResult => {
const { t } = useTranslation();
- const [selectedToolKey, setSelectedToolKey] = useState(null);
const [toolSelectedFileIds, setToolSelectedFileIds] = useState([]);
// Build endpoints list from registry entries with fallback to legacy mapping
@@ -56,35 +53,15 @@ export const useToolManagement = (): ToolManagementResult => {
return availableToolRegistry;
}, [isToolAvailable, t, baseRegistry]);
- useEffect(() => {
- if (!endpointsLoading && selectedToolKey && !toolRegistry[selectedToolKey]) {
- const firstAvailableTool = Object.keys(toolRegistry)[0];
- if (firstAvailableTool) {
- setSelectedToolKey(firstAvailableTool);
- } else {
- setSelectedToolKey(null);
- }
- }
- }, [endpointsLoading, selectedToolKey, toolRegistry]);
-
- const selectTool = useCallback((toolKey: string) => {
- setSelectedToolKey(toolKey);
- }, []);
-
- const clearToolSelection = useCallback(() => {
- setSelectedToolKey(null);
- }, []);
-
- const selectedTool = selectedToolKey ? toolRegistry[selectedToolKey] : null;
+ const getSelectedTool = useCallback((toolKey: string | null): ToolRegistryEntry | null => {
+ return toolKey ? toolRegistry[toolKey] || null : null;
+ }, [toolRegistry]);
return {
- selectedToolKey,
- selectedTool,
+ selectedTool: getSelectedTool(null), // This will be unused, kept for compatibility
toolSelectedFileIds,
toolRegistry,
- selectTool,
- clearToolSelection,
setToolSelectedFileIds,
-
+ getSelectedTool,
};
};
diff --git a/frontend/src/hooks/useUrlSync.ts b/frontend/src/hooks/useUrlSync.ts
index ef181c04b..4a50a36ba 100644
--- a/frontend/src/hooks/useUrlSync.ts
+++ b/frontend/src/hooks/useUrlSync.ts
@@ -3,7 +3,7 @@
*/
import { useEffect, useCallback } from 'react';
-import { ModeType } from '../contexts/NavigationContext';
+import { ModeType } from '../types/navigation';
import { parseToolRoute, updateToolRoute, clearToolRoute } from '../utils/urlRouting';
/**
diff --git a/frontend/src/pages/HomePage.tsx b/frontend/src/pages/HomePage.tsx
index 022789f6c..eeb23e83f 100644
--- a/frontend/src/pages/HomePage.tsx
+++ b/frontend/src/pages/HomePage.tsx
@@ -1,10 +1,8 @@
import React, { useEffect } from "react";
import { useTranslation } from "react-i18next";
-import { useFileActions, useFileSelection } from "../contexts/FileContext";
-import { useNavigationActions } from "../contexts/NavigationContext";
-import { ToolWorkflowProvider, useToolWorkflow } from "../contexts/ToolWorkflowContext";
+import { useToolWorkflow } from "../contexts/ToolWorkflowContext";
import { Group } from "@mantine/core";
-import { SidebarProvider, useSidebarContext } from "../contexts/SidebarContext";
+import { useSidebarContext } from "../contexts/SidebarContext";
import { useDocumentMeta } from "../hooks/useDocumentMeta";
import { getBaseUrl } from "../constants/app";
@@ -14,7 +12,7 @@ import QuickAccessBar from "../components/shared/QuickAccessBar";
import FileManager from "../components/FileManager";
-function HomePageContent() {
+export default function HomePage() {
const { t } = useTranslation();
const {
sidebarRefs,
@@ -22,8 +20,6 @@ function HomePageContent() {
const { quickAccessRef } = sidebarRefs;
- const { setSelectedFiles } = useFileSelection();
-
const { selectedTool, selectedToolKey } = useToolWorkflow();
const baseUrl = getBaseUrl();
@@ -54,24 +50,3 @@ function HomePageContent() {
);
}
-
-function HomePageWithProviders() {
- const { actions } = useNavigationActions();
-
- // Wrapper to convert string to ModeType
- const handleViewChange = (view: string) => {
- actions.setMode(view as any); // ToolWorkflowContext should validate this
- };
-
- return (
-
-
-
-
-
- );
-}
-
-export default function HomePage() {
- return ;
-}
diff --git a/frontend/src/services/automationStorage.ts b/frontend/src/services/automationStorage.ts
new file mode 100644
index 000000000..990e95a7f
--- /dev/null
+++ b/frontend/src/services/automationStorage.ts
@@ -0,0 +1,183 @@
+/**
+ * Service for managing automation configurations in IndexedDB
+ */
+
+export interface AutomationConfig {
+ id: string;
+ name: string;
+ description?: string;
+ operations: Array<{
+ operation: string;
+ parameters: any;
+ }>;
+ createdAt: string;
+ updatedAt: string;
+}
+
+class AutomationStorage {
+ private dbName = 'StirlingPDF_Automations';
+ private dbVersion = 1;
+ private storeName = 'automations';
+ private db: IDBDatabase | null = null;
+
+ async init(): Promise {
+ return new Promise((resolve, reject) => {
+ const request = indexedDB.open(this.dbName, this.dbVersion);
+
+ request.onerror = () => {
+ reject(new Error('Failed to open automation storage database'));
+ };
+
+ request.onsuccess = () => {
+ this.db = request.result;
+ resolve();
+ };
+
+ request.onupgradeneeded = (event) => {
+ const db = (event.target as IDBOpenDBRequest).result;
+
+ if (!db.objectStoreNames.contains(this.storeName)) {
+ const store = db.createObjectStore(this.storeName, { keyPath: 'id' });
+ store.createIndex('name', 'name', { unique: false });
+ store.createIndex('createdAt', 'createdAt', { unique: false });
+ }
+ };
+ });
+ }
+
+ async ensureDB(): Promise {
+ if (!this.db) {
+ await this.init();
+ }
+
+ if (!this.db) {
+ throw new Error('Database not initialized');
+ }
+
+ return this.db;
+ }
+
+ async saveAutomation(automation: Omit): Promise {
+ const db = await this.ensureDB();
+ const timestamp = new Date().toISOString();
+
+ const automationWithMeta: AutomationConfig = {
+ id: `automation-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+ ...automation,
+ createdAt: timestamp,
+ updatedAt: timestamp
+ };
+
+ return new Promise((resolve, reject) => {
+ const transaction = db.transaction([this.storeName], 'readwrite');
+ const store = transaction.objectStore(this.storeName);
+ const request = store.add(automationWithMeta);
+
+ request.onsuccess = () => {
+ resolve(automationWithMeta);
+ };
+
+ request.onerror = () => {
+ reject(new Error('Failed to save automation'));
+ };
+ });
+ }
+
+ async updateAutomation(automation: AutomationConfig): Promise {
+ const db = await this.ensureDB();
+
+ const updatedAutomation: AutomationConfig = {
+ ...automation,
+ updatedAt: new Date().toISOString()
+ };
+
+ return new Promise((resolve, reject) => {
+ const transaction = db.transaction([this.storeName], 'readwrite');
+ const store = transaction.objectStore(this.storeName);
+ const request = store.put(updatedAutomation);
+
+ request.onsuccess = () => {
+ resolve(updatedAutomation);
+ };
+
+ request.onerror = () => {
+ reject(new Error('Failed to update automation'));
+ };
+ });
+ }
+
+ async getAutomation(id: string): Promise {
+ const db = await this.ensureDB();
+
+ return new Promise((resolve, reject) => {
+ const transaction = db.transaction([this.storeName], 'readonly');
+ const store = transaction.objectStore(this.storeName);
+ const request = store.get(id);
+
+ request.onsuccess = () => {
+ resolve(request.result || null);
+ };
+
+ request.onerror = () => {
+ reject(new Error('Failed to get automation'));
+ };
+ });
+ }
+
+ async getAllAutomations(): Promise {
+ const db = await this.ensureDB();
+
+ return new Promise((resolve, reject) => {
+ const transaction = db.transaction([this.storeName], 'readonly');
+ const store = transaction.objectStore(this.storeName);
+ const request = store.getAll();
+
+ request.onsuccess = () => {
+ const automations = request.result || [];
+ // Sort by creation date, newest first
+ automations.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+ resolve(automations);
+ };
+
+ request.onerror = () => {
+ reject(new Error('Failed to get automations'));
+ };
+ });
+ }
+
+ async deleteAutomation(id: string): Promise {
+ const db = await this.ensureDB();
+
+ return new Promise((resolve, reject) => {
+ const transaction = db.transaction([this.storeName], 'readwrite');
+ const store = transaction.objectStore(this.storeName);
+ const request = store.delete(id);
+
+ request.onsuccess = () => {
+ resolve();
+ };
+
+ request.onerror = () => {
+ reject(new Error('Failed to delete automation'));
+ };
+ });
+ }
+
+ async searchAutomations(query: string): Promise {
+ const automations = await this.getAllAutomations();
+
+ if (!query.trim()) {
+ return automations;
+ }
+
+ const lowerQuery = query.toLowerCase();
+ return automations.filter(automation =>
+ automation.name.toLowerCase().includes(lowerQuery) ||
+ (automation.description && automation.description.toLowerCase().includes(lowerQuery)) ||
+ automation.operations.some(op => op.operation.toLowerCase().includes(lowerQuery))
+ );
+ }
+}
+
+// Export singleton instance
+export const automationStorage = new AutomationStorage();
\ No newline at end of file
diff --git a/frontend/src/tests/convert/ConvertIntegration.test.tsx b/frontend/src/tests/convert/ConvertIntegration.test.tsx
index c966615f4..41a768838 100644
--- a/frontend/src/tests/convert/ConvertIntegration.test.tsx
+++ b/frontend/src/tests/convert/ConvertIntegration.test.tsx
@@ -409,7 +409,7 @@ describe('Convert Tool Integration Tests', () => {
// Verify integration: utils validation prevents API call, hook shows error
expect(mockedAxios.post).not.toHaveBeenCalled();
- expect(result.current.errorMessage).toContain('errorNotSupported');
+ expect(result.current.errorMessage).toContain('Unsupported conversion format');
expect(result.current.isLoading).toBe(false);
expect(result.current.downloadUrl).toBe(null);
});
diff --git a/frontend/src/tools/AddPassword.tsx b/frontend/src/tools/AddPassword.tsx
index 5b8b33adc..b12598e26 100644
--- a/frontend/src/tools/AddPassword.tsx
+++ b/frontend/src/tools/AddPassword.tsx
@@ -9,11 +9,11 @@ import { createToolFlow } from "../components/tools/shared/createToolFlow";
import AddPasswordSettings from "../components/tools/addPassword/AddPasswordSettings";
import ChangePermissionsSettings from "../components/tools/changePermissions/ChangePermissionsSettings";
-import { useAddPasswordParameters } from "../hooks/tools/addPassword/useAddPasswordParameters";
+import { useAddPasswordParameters, defaultParameters } from "../hooks/tools/addPassword/useAddPasswordParameters";
import { useAddPasswordOperation } from "../hooks/tools/addPassword/useAddPasswordOperation";
import { useAddPasswordTips } from "../components/tooltips/useAddPasswordTips";
import { useAddPasswordPermissionsTips } from "../components/tooltips/useAddPasswordPermissionsTips";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const AddPassword = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -114,4 +114,4 @@ const AddPassword = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default AddPassword;
+export default AddPassword as ToolComponent;
diff --git a/frontend/src/tools/AddWatermark.tsx b/frontend/src/tools/AddWatermark.tsx
index 1e36a3820..1638ceb1c 100644
--- a/frontend/src/tools/AddWatermark.tsx
+++ b/frontend/src/tools/AddWatermark.tsx
@@ -21,7 +21,7 @@ import {
useWatermarkFileTips,
useWatermarkFormattingTips,
} from "../components/tooltips/useWatermarkTips";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const AddWatermark = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -208,4 +208,7 @@ const AddWatermark = ({ onPreviewFile, onComplete, onError }: BaseToolProps) =>
});
};
-export default AddWatermark;
+// Static method to get the operation hook for automation
+AddWatermark.tool = () => useAddWatermarkOperation;
+
+export default AddWatermark as ToolComponent;
diff --git a/frontend/src/tools/Automate.tsx b/frontend/src/tools/Automate.tsx
new file mode 100644
index 000000000..54538781b
--- /dev/null
+++ b/frontend/src/tools/Automate.tsx
@@ -0,0 +1,168 @@
+import React, { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { useFileContext } from "../contexts/FileContext";
+import { useFileSelection } from "../contexts/FileContext";
+
+import { createToolFlow } from "../components/tools/shared/createToolFlow";
+import { createFilesToolStep } from "../components/tools/shared/FilesToolStep";
+import AutomationSelection from "../components/tools/automate/AutomationSelection";
+import AutomationCreation from "../components/tools/automate/AutomationCreation";
+import AutomationRun from "../components/tools/automate/AutomationRun";
+
+import { useAutomateOperation } from "../hooks/tools/automate/useAutomateOperation";
+import { BaseToolProps } from "../types/tool";
+import { useFlatToolRegistry } from "../data/useTranslatedToolRegistry";
+import { useSavedAutomations } from "../hooks/tools/automate/useSavedAutomations";
+import { AutomationConfig, AutomationStepData, AutomationMode } from "../types/automation";
+import { AUTOMATION_STEPS } from "../constants/automation";
+
+const Automate = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
+ const { t } = useTranslation();
+ const { selectedFiles } = useFileSelection();
+
+ const [currentStep, setCurrentStep] = useState<'selection' | 'creation' | 'run'>(AUTOMATION_STEPS.SELECTION);
+ const [stepData, setStepData] = useState({ step: AUTOMATION_STEPS.SELECTION });
+
+ const automateOperation = useAutomateOperation();
+ const toolRegistry = useFlatToolRegistry();
+ const hasResults = automateOperation.files.length > 0 || automateOperation.downloadUrl !== null;
+ const { savedAutomations, deleteAutomation, refreshAutomations } = useSavedAutomations();
+
+ const handleStepChange = (data: AutomationStepData) => {
+ // If navigating away from run step, reset automation results
+ if (currentStep === AUTOMATION_STEPS.RUN && data.step !== AUTOMATION_STEPS.RUN) {
+ automateOperation.resetResults();
+ }
+
+ // If navigating to run step with a different automation, reset results
+ if (data.step === AUTOMATION_STEPS.RUN && data.automation &&
+ stepData.automation && data.automation.id !== stepData.automation.id) {
+ automateOperation.resetResults();
+ }
+
+ setStepData(data);
+ setCurrentStep(data.step);
+ };
+
+ const handleComplete = () => {
+ // Reset automation results when completing
+ automateOperation.resetResults();
+
+ // Reset to selection step
+ setCurrentStep(AUTOMATION_STEPS.SELECTION);
+ setStepData({ step: AUTOMATION_STEPS.SELECTION });
+ onComplete?.([]); // Pass empty array since automation creation doesn't produce files
+ };
+
+ const renderCurrentStep = () => {
+ switch (currentStep) {
+ case 'selection':
+ return (
+ handleStepChange({ step: AUTOMATION_STEPS.CREATION, mode: AutomationMode.CREATE })}
+ onRun={(automation: AutomationConfig) => handleStepChange({ step: AUTOMATION_STEPS.RUN, automation })}
+ onEdit={(automation: AutomationConfig) => handleStepChange({ step: AUTOMATION_STEPS.CREATION, mode: AutomationMode.EDIT, automation })}
+ onDelete={async (automation: AutomationConfig) => {
+ try {
+ await deleteAutomation(automation.id);
+ } catch (error) {
+ console.error('Failed to delete automation:', error);
+ onError?.(`Failed to delete automation: ${automation.name}`);
+ }
+ }}
+ />
+ );
+
+ case 'creation':
+ if (!stepData.mode) {
+ console.error('Creation mode is undefined');
+ return null;
+ }
+ return (
+ handleStepChange({ step: AUTOMATION_STEPS.SELECTION })}
+ onComplete={() => {
+ refreshAutomations();
+ handleStepChange({ step: AUTOMATION_STEPS.SELECTION });
+ }}
+ toolRegistry={toolRegistry}
+ />
+ );
+
+ case 'run':
+ if (!stepData.automation) {
+ console.error('Automation config is undefined');
+ return null;
+ }
+ return (
+
+ );
+
+ default:
+ return {t('automate.invalidStep', 'Invalid step')}
;
+ }
+ };
+
+ const createStep = (title: string, props: any, content?: React.ReactNode) => ({
+ title,
+ ...props,
+ content
+ });
+
+ // Always create files step to avoid conditional hook calls
+ const filesStep = createFilesToolStep(createStep, {
+ selectedFiles,
+ isCollapsed: hasResults,
+ placeholder: t('automate.files.placeholder', 'Select files to process with this automation')
+ });
+
+ const automationSteps = [
+ createStep(t('automate.selection.title', 'Automation Selection'), {
+ isVisible: true,
+ isCollapsed: currentStep !== AUTOMATION_STEPS.SELECTION,
+ onCollapsedClick: () => setCurrentStep(AUTOMATION_STEPS.SELECTION)
+ }, currentStep === AUTOMATION_STEPS.SELECTION ? renderCurrentStep() : null),
+
+ createStep(stepData.mode === AutomationMode.EDIT
+ ? t('automate.creation.editTitle', 'Edit Automation')
+ : t('automate.creation.createTitle', 'Create Automation'), {
+ isVisible: currentStep === AUTOMATION_STEPS.CREATION,
+ isCollapsed: false
+ }, currentStep === AUTOMATION_STEPS.CREATION ? renderCurrentStep() : null),
+
+ // Files step - only visible during run mode
+ {
+ ...filesStep,
+ isVisible: currentStep === AUTOMATION_STEPS.RUN
+ },
+
+ // Run step
+ createStep(t('automate.run.title', 'Run Automation'), {
+ isVisible: currentStep === AUTOMATION_STEPS.RUN,
+ isCollapsed: hasResults,
+ }, currentStep === AUTOMATION_STEPS.RUN ? renderCurrentStep() : null)
+ ];
+
+ return createToolFlow({
+ files: {
+ selectedFiles: currentStep === AUTOMATION_STEPS.RUN ? selectedFiles : [],
+ isCollapsed: currentStep !== AUTOMATION_STEPS.RUN || hasResults,
+ isVisible: false, // Hide the default files step since we add our own
+ },
+ steps: automationSteps,
+ review: {
+ isVisible: hasResults,
+ operation: automateOperation,
+ title: t('automate.reviewTitle', 'Automation Results')
+ }
+ });
+};
+
+export default Automate;
diff --git a/frontend/src/tools/ChangePermissions.tsx b/frontend/src/tools/ChangePermissions.tsx
index 254dd4d2f..e9a4eaa80 100644
--- a/frontend/src/tools/ChangePermissions.tsx
+++ b/frontend/src/tools/ChangePermissions.tsx
@@ -11,7 +11,7 @@ import ChangePermissionsSettings from "../components/tools/changePermissions/Cha
import { useChangePermissionsParameters } from "../hooks/tools/changePermissions/useChangePermissionsParameters";
import { useChangePermissionsOperation } from "../hooks/tools/changePermissions/useChangePermissionsOperation";
import { useChangePermissionsTips } from "../components/tooltips/useChangePermissionsTips";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const ChangePermissions = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -95,4 +95,7 @@ const ChangePermissions = ({ onPreviewFile, onComplete, onError }: BaseToolProps
});
};
-export default ChangePermissions;
+// Static method to get the operation hook for automation
+ChangePermissions.tool = () => useChangePermissionsOperation;
+
+export default ChangePermissions as ToolComponent;
diff --git a/frontend/src/tools/Compress.tsx b/frontend/src/tools/Compress.tsx
index ea3fdf977..4dbd3d985 100644
--- a/frontend/src/tools/Compress.tsx
+++ b/frontend/src/tools/Compress.tsx
@@ -1,4 +1,4 @@
-import React, { useEffect } from "react";
+import React, { use, useEffect } from "react";
import { useTranslation } from "react-i18next";
import { useEndpointEnabled } from "../hooks/useEndpointConfig";
import { useFileSelection } from "../contexts/FileContext";
@@ -10,7 +10,7 @@ import CompressSettings from "../components/tools/compress/CompressSettings";
import { useCompressParameters } from "../hooks/tools/compress/useCompressParameters";
import { useCompressOperation } from "../hooks/tools/compress/useCompressOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
import { useCompressTips } from "../components/tooltips/useCompressTips";
const Compress = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
@@ -94,4 +94,5 @@ const Compress = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default Compress;
+
+export default Compress as ToolComponent;
diff --git a/frontend/src/tools/Convert.tsx b/frontend/src/tools/Convert.tsx
index e2220f9ce..f0612ea83 100644
--- a/frontend/src/tools/Convert.tsx
+++ b/frontend/src/tools/Convert.tsx
@@ -10,7 +10,7 @@ import ConvertSettings from "../components/tools/convert/ConvertSettings";
import { useConvertParameters } from "../hooks/tools/convert/useConvertParameters";
import { useConvertOperation } from "../hooks/tools/convert/useConvertOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const Convert = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -133,4 +133,7 @@ const Convert = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default Convert;
+// Static method to get the operation hook for automation
+Convert.tool = () => useConvertOperation;
+
+export default Convert as ToolComponent;
diff --git a/frontend/src/tools/OCR.tsx b/frontend/src/tools/OCR.tsx
index 7f918759e..52db3b0de 100644
--- a/frontend/src/tools/OCR.tsx
+++ b/frontend/src/tools/OCR.tsx
@@ -11,7 +11,7 @@ import AdvancedOCRSettings from "../components/tools/ocr/AdvancedOCRSettings";
import { useOCRParameters } from "../hooks/tools/ocr/useOCRParameters";
import { useOCROperation } from "../hooks/tools/ocr/useOCROperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
import { useOCRTips } from "../components/tooltips/useOCRTips";
const OCR = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
@@ -134,4 +134,7 @@ const OCR = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default OCR;
+// Static method to get the operation hook for automation
+OCR.tool = () => useOCROperation;
+
+export default OCR as ToolComponent;
diff --git a/frontend/src/tools/RemoveCertificateSign.tsx b/frontend/src/tools/RemoveCertificateSign.tsx
index 0e08e117c..c9a3f4b82 100644
--- a/frontend/src/tools/RemoveCertificateSign.tsx
+++ b/frontend/src/tools/RemoveCertificateSign.tsx
@@ -9,7 +9,7 @@ import { createToolFlow } from "../components/tools/shared/createToolFlow";
import { useRemoveCertificateSignParameters } from "../hooks/tools/removeCertificateSign/useRemoveCertificateSignParameters";
import { useRemoveCertificateSignOperation } from "../hooks/tools/removeCertificateSign/useRemoveCertificateSignOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const RemoveCertificateSign = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -77,4 +77,7 @@ const RemoveCertificateSign = ({ onPreviewFile, onComplete, onError }: BaseToolP
});
};
-export default RemoveCertificateSign;
\ No newline at end of file
+// Static method to get the operation hook for automation
+RemoveCertificateSign.tool = () => useRemoveCertificateSignOperation;
+
+export default RemoveCertificateSign as ToolComponent;
\ No newline at end of file
diff --git a/frontend/src/tools/RemovePassword.tsx b/frontend/src/tools/RemovePassword.tsx
index 4b4d1f8d6..e84cf6e6c 100644
--- a/frontend/src/tools/RemovePassword.tsx
+++ b/frontend/src/tools/RemovePassword.tsx
@@ -11,7 +11,7 @@ import RemovePasswordSettings from "../components/tools/removePassword/RemovePas
import { useRemovePasswordParameters } from "../hooks/tools/removePassword/useRemovePasswordParameters";
import { useRemovePasswordOperation } from "../hooks/tools/removePassword/useRemovePasswordOperation";
import { useRemovePasswordTips } from "../components/tooltips/useRemovePasswordTips";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const RemovePassword = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -94,4 +94,7 @@ const RemovePassword = ({ onPreviewFile, onComplete, onError }: BaseToolProps) =
});
};
-export default RemovePassword;
+// Static method to get the operation hook for automation
+RemovePassword.tool = () => useRemovePasswordOperation;
+
+export default RemovePassword as ToolComponent;
diff --git a/frontend/src/tools/Repair.tsx b/frontend/src/tools/Repair.tsx
index 8cb061085..f5f09017a 100644
--- a/frontend/src/tools/Repair.tsx
+++ b/frontend/src/tools/Repair.tsx
@@ -9,7 +9,7 @@ import { createToolFlow } from "../components/tools/shared/createToolFlow";
import { useRepairParameters } from "../hooks/tools/repair/useRepairParameters";
import { useRepairOperation } from "../hooks/tools/repair/useRepairOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const Repair = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -77,4 +77,7 @@ const Repair = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default Repair;
+// Static method to get the operation hook for automation
+Repair.tool = () => useRepairOperation;
+
+export default Repair as ToolComponent;
diff --git a/frontend/src/tools/Sanitize.tsx b/frontend/src/tools/Sanitize.tsx
index 1d12d1bee..274331fd6 100644
--- a/frontend/src/tools/Sanitize.tsx
+++ b/frontend/src/tools/Sanitize.tsx
@@ -2,20 +2,18 @@ import { useEffect } from "react";
import { useTranslation } from "react-i18next";
import { useEndpointEnabled } from "../hooks/useEndpointConfig";
import { useFileSelection } from "../contexts/FileContext";
-import { useNavigationActions } from "../contexts/NavigationContext";
import { createToolFlow } from "../components/tools/shared/createToolFlow";
import SanitizeSettings from "../components/tools/sanitize/SanitizeSettings";
import { useSanitizeParameters } from "../hooks/tools/sanitize/useSanitizeParameters";
import { useSanitizeOperation } from "../hooks/tools/sanitize/useSanitizeOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const Sanitize = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
const { selectedFiles } = useFileSelection();
- const { actions } = useNavigationActions();
const sanitizeParams = useSanitizeParameters();
const sanitizeOperation = useSanitizeOperation();
@@ -91,4 +89,7 @@ const Sanitize = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default Sanitize;
+// Static method to get the operation hook for automation
+Sanitize.tool = () => useSanitizeOperation;
+
+export default Sanitize as ToolComponent;
diff --git a/frontend/src/tools/SingleLargePage.tsx b/frontend/src/tools/SingleLargePage.tsx
index 7d268d11c..d071c2b99 100644
--- a/frontend/src/tools/SingleLargePage.tsx
+++ b/frontend/src/tools/SingleLargePage.tsx
@@ -9,7 +9,7 @@ import { createToolFlow } from "../components/tools/shared/createToolFlow";
import { useSingleLargePageParameters } from "../hooks/tools/singleLargePage/useSingleLargePageParameters";
import { useSingleLargePageOperation } from "../hooks/tools/singleLargePage/useSingleLargePageOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const SingleLargePage = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -77,4 +77,7 @@ const SingleLargePage = ({ onPreviewFile, onComplete, onError }: BaseToolProps)
});
};
-export default SingleLargePage;
\ No newline at end of file
+// Static method to get the operation hook for automation
+SingleLargePage.tool = () => useSingleLargePageOperation;
+
+export default SingleLargePage as ToolComponent;
\ No newline at end of file
diff --git a/frontend/src/tools/Split.tsx b/frontend/src/tools/Split.tsx
index 18997e6a6..580b27c63 100644
--- a/frontend/src/tools/Split.tsx
+++ b/frontend/src/tools/Split.tsx
@@ -9,7 +9,7 @@ import SplitSettings from "../components/tools/split/SplitSettings";
import { useSplitParameters } from "../hooks/tools/split/useSplitParameters";
import { useSplitOperation } from "../hooks/tools/split/useSplitOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const Split = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -90,4 +90,4 @@ const Split = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
});
};
-export default Split;
+export default Split as ToolComponent;
diff --git a/frontend/src/tools/UnlockPdfForms.tsx b/frontend/src/tools/UnlockPdfForms.tsx
index a169c8e58..6c5bd4cb5 100644
--- a/frontend/src/tools/UnlockPdfForms.tsx
+++ b/frontend/src/tools/UnlockPdfForms.tsx
@@ -9,7 +9,7 @@ import { createToolFlow } from "../components/tools/shared/createToolFlow";
import { useUnlockPdfFormsParameters } from "../hooks/tools/unlockPdfForms/useUnlockPdfFormsParameters";
import { useUnlockPdfFormsOperation } from "../hooks/tools/unlockPdfForms/useUnlockPdfFormsOperation";
-import { BaseToolProps } from "../types/tool";
+import { BaseToolProps, ToolComponent } from "../types/tool";
const UnlockPdfForms = ({ onPreviewFile, onComplete, onError }: BaseToolProps) => {
const { t } = useTranslation();
@@ -77,4 +77,7 @@ const UnlockPdfForms = ({ onPreviewFile, onComplete, onError }: BaseToolProps) =
});
};
-export default UnlockPdfForms;
\ No newline at end of file
+// Static method to get the operation hook for automation
+UnlockPdfForms.tool = () => useUnlockPdfFormsOperation;
+
+export default UnlockPdfForms as ToolComponent;
\ No newline at end of file
diff --git a/frontend/src/types/automation.ts b/frontend/src/types/automation.ts
new file mode 100644
index 000000000..ffbfe36b2
--- /dev/null
+++ b/frontend/src/types/automation.ts
@@ -0,0 +1,70 @@
+/**
+ * Types for automation functionality
+ */
+
+export interface AutomationOperation {
+ operation: string;
+ parameters: Record;
+}
+
+export interface AutomationConfig {
+ id: string;
+ name: string;
+ description?: string;
+ operations: AutomationOperation[];
+ createdAt: string;
+ updatedAt: string;
+}
+
+export interface AutomationTool {
+ id: string;
+ operation: string;
+ name: string;
+ configured: boolean;
+ parameters?: Record;
+}
+
+export interface AutomationStepData {
+ step: 'selection' | 'creation' | 'run';
+ mode?: AutomationMode;
+ automation?: AutomationConfig;
+}
+
+export interface ExecutionStep {
+ id: string;
+ operation: string;
+ name: string;
+ status: 'pending' | 'running' | 'completed' | 'error';
+ error?: string;
+}
+
+export interface AutomationExecutionCallbacks {
+ onStepStart?: (stepIndex: number, operationName: string) => void;
+ onStepComplete?: (stepIndex: number, resultFiles: File[]) => void;
+ onStepError?: (stepIndex: number, error: string) => void;
+}
+
+export interface AutomateParameters extends AutomationExecutionCallbacks {
+ automationConfig?: AutomationConfig;
+}
+
+export enum AutomationMode {
+ CREATE = 'create',
+ EDIT = 'edit',
+ SUGGESTED = 'suggested'
+}
+
+export interface SuggestedAutomation {
+ id: string;
+ name: string;
+ description?: string;
+ operations: AutomationOperation[];
+ createdAt: string;
+ updatedAt: string;
+ icon: any; // MUI Icon component
+}
+
+// Export the AutomateParameters interface that was previously defined inline
+export interface AutomateParameters extends AutomationExecutionCallbacks {
+ automationConfig?: AutomationConfig;
+}
\ No newline at end of file
diff --git a/frontend/src/types/navigation.ts b/frontend/src/types/navigation.ts
new file mode 100644
index 000000000..61aa24cc3
--- /dev/null
+++ b/frontend/src/types/navigation.ts
@@ -0,0 +1,42 @@
+/**
+ * Shared navigation types to avoid circular dependencies
+ */
+
+// Navigation mode types - complete list to match contexts
+export type ModeType =
+ | 'viewer'
+ | 'pageEditor'
+ | 'fileEditor'
+ | 'merge'
+ | 'split'
+ | 'compress'
+ | 'ocr'
+ | 'convert'
+ | 'sanitize'
+ | 'addPassword'
+ | 'changePermissions'
+ | 'addWatermark'
+ | 'removePassword'
+ | 'single-large-page'
+ | 'repair'
+ | 'unlockPdfForms'
+ | 'removeCertificateSign';
+
+// Utility functions for mode handling
+export const isValidMode = (mode: string): mode is ModeType => {
+ const validModes: ModeType[] = [
+ 'viewer', 'pageEditor', 'fileEditor', 'merge', 'split',
+ 'compress', 'ocr', 'convert', 'addPassword', 'changePermissions',
+ 'sanitize', 'addWatermark', 'removePassword', 'single-large-page',
+ 'repair', 'unlockPdfForms', 'removeCertificateSign'
+ ];
+ return validModes.includes(mode as ModeType);
+};
+
+export const getDefaultMode = (): ModeType => 'pageEditor';
+
+// Route parsing result
+export interface ToolRoute {
+ mode: ModeType;
+ toolKey: string | null;
+}
\ No newline at end of file
diff --git a/frontend/src/types/navigationActions.ts b/frontend/src/types/navigationActions.ts
new file mode 100644
index 000000000..b227dac9d
--- /dev/null
+++ b/frontend/src/types/navigationActions.ts
@@ -0,0 +1,21 @@
+/**
+ * Navigation action interfaces to break circular dependencies
+ */
+
+import { ModeType } from './navigation';
+
+export interface NavigationActions {
+ setMode: (mode: ModeType) => void;
+ setHasUnsavedChanges: (hasChanges: boolean) => void;
+ showNavigationWarning: (show: boolean) => void;
+ requestNavigation: (navigationFn: () => void) => void;
+ confirmNavigation: () => void;
+ cancelNavigation: () => void;
+}
+
+export interface NavigationState {
+ currentMode: ModeType;
+ hasUnsavedChanges: boolean;
+ pendingNavigation: (() => void) | null;
+ showNavigationWarning: boolean;
+}
\ No newline at end of file
diff --git a/frontend/src/types/tool.ts b/frontend/src/types/tool.ts
index 463b6a63e..0e1d48992 100644
--- a/frontend/src/types/tool.ts
+++ b/frontend/src/types/tool.ts
@@ -1,4 +1,5 @@
import React from 'react';
+import { ToolOperationHook } from '../hooks/tools/shared/useToolOperation';
export type MaxFiles = number; // 1=single, >1=limited, -1=unlimited
export type ToolCategory = 'manipulation' | 'conversion' | 'analysis' | 'utility' | 'optimization' | 'security';
@@ -11,6 +12,29 @@ export interface BaseToolProps {
onPreviewFile?: (file: File | null) => void;
}
+/**
+ * Interface for tool components that support automation.
+ * Tools implementing this interface can be used in automation workflows.
+ */
+export interface AutomationCapableTool {
+ /**
+ * Static method that returns the operation hook for this tool.
+ * This enables automation to execute the tool programmatically.
+ */
+ tool: () => () => ToolOperationHook;
+
+ /**
+ * Static method that returns the default parameters for this tool.
+ * This enables automation creation to initialize tools with proper defaults.
+ */
+ getDefaultParameters: () => any;
+}
+
+/**
+ * Type for tool components that can be used in automation
+ */
+export type ToolComponent = React.ComponentType & AutomationCapableTool;
+
export interface ToolStepConfig {
type: ToolStepType;
title: string;
diff --git a/frontend/src/utils/automationExecutor.ts b/frontend/src/utils/automationExecutor.ts
new file mode 100644
index 000000000..9ef1f6e2f
--- /dev/null
+++ b/frontend/src/utils/automationExecutor.ts
@@ -0,0 +1,157 @@
+import axios from 'axios';
+import { ToolRegistry } from '../data/toolsTaxonomy';
+import { AutomationConfig, AutomationExecutionCallbacks } from '../types/automation';
+import { AUTOMATION_CONSTANTS } from '../constants/automation';
+import { AutomationFileProcessor } from './automationFileProcessor';
+import { ResourceManager } from './resourceManager';
+
+
+/**
+ * Execute a tool operation directly without using React hooks
+ */
+export const executeToolOperation = async (
+ operationName: string,
+ parameters: any,
+ files: File[],
+ toolRegistry: ToolRegistry
+): Promise => {
+ console.log(`🔧 Executing tool: ${operationName}`, { parameters, fileCount: files.length });
+
+ const config = toolRegistry[operationName]?.operationConfig;
+ if (!config) {
+ console.error(`❌ Tool operation not supported: ${operationName}`);
+ throw new Error(`Tool operation not supported: ${operationName}`);
+ }
+
+ console.log(`📋 Using config:`, config);
+
+ try {
+ // Check if tool uses custom processor (like Convert tool)
+ if (config.customProcessor) {
+ console.log(`🎯 Using custom processor for ${config.operationType}`);
+ const resultFiles = await config.customProcessor(parameters, files);
+ console.log(`✅ Custom processor returned ${resultFiles.length} files`);
+ return resultFiles;
+ }
+
+ if (config.multiFileEndpoint) {
+ // Multi-file processing - single API call with all files
+ const endpoint = typeof config.endpoint === 'function'
+ ? config.endpoint(parameters)
+ : config.endpoint;
+
+ console.log(`🌐 Making multi-file request to: ${endpoint}`);
+ const formData = (config.buildFormData as (params: any, files: File[]) => FormData)(parameters, files);
+ console.log(`📤 FormData entries:`, Array.from(formData.entries()));
+
+ const response = await axios.post(endpoint, formData, {
+ responseType: 'blob',
+ timeout: AUTOMATION_CONSTANTS.OPERATION_TIMEOUT
+ });
+
+ console.log(`📥 Response status: ${response.status}, size: ${response.data.size} bytes`);
+
+ // Multi-file responses are typically ZIP files, but may be single files
+ const result = await AutomationFileProcessor.extractAutomationZipFiles(response.data);
+
+ if (result.errors.length > 0) {
+ console.warn(`⚠️ File processing warnings:`, result.errors);
+ }
+
+ console.log(`📁 Processed ${result.files.length} files from response`);
+ return result.files;
+
+ } else {
+ // Single-file processing - separate API call per file
+ console.log(`🔄 Processing ${files.length} files individually`);
+ const resultFiles: File[] = [];
+
+ for (let i = 0; i < files.length; i++) {
+ const file = files[i];
+ const endpoint = typeof config.endpoint === 'function'
+ ? config.endpoint(parameters)
+ : config.endpoint;
+
+ console.log(`🌐 Making single-file request ${i+1}/${files.length} to: ${endpoint} for file: ${file.name}`);
+ const formData = (config.buildFormData as (params: any, file: File) => FormData)(parameters, file);
+ console.log(`📤 FormData entries:`, Array.from(formData.entries()));
+
+ const response = await axios.post(endpoint, formData, {
+ responseType: 'blob',
+ timeout: AUTOMATION_CONSTANTS.OPERATION_TIMEOUT
+ });
+
+ console.log(`📥 Response ${i+1} status: ${response.status}, size: ${response.data.size} bytes`);
+
+ // Create result file
+ const resultFile = ResourceManager.createResultFile(
+ response.data,
+ file.name,
+ AUTOMATION_CONSTANTS.FILE_PREFIX
+ );
+ resultFiles.push(resultFile);
+ console.log(`✅ Created result file: ${resultFile.name}`);
+ }
+
+ console.log(`🎉 Single-file processing complete: ${resultFiles.length} files`);
+ return resultFiles;
+ }
+
+ } catch (error: any) {
+ console.error(`Tool operation ${operationName} failed:`, error);
+ throw new Error(`${operationName} operation failed: ${error.response?.data || error.message}`);
+ }
+};
+
+/**
+ * Execute an entire automation sequence
+ */
+export const executeAutomationSequence = async (
+ automation: any,
+ initialFiles: File[],
+ toolRegistry: ToolRegistry,
+ onStepStart?: (stepIndex: number, operationName: string) => void,
+ onStepComplete?: (stepIndex: number, resultFiles: File[]) => void,
+ onStepError?: (stepIndex: number, error: string) => void
+): Promise => {
+ console.log(`🚀 Starting automation sequence: ${automation.name || 'Unnamed'}`);
+ console.log(`📁 Initial files: ${initialFiles.length}`);
+ console.log(`🔧 Operations: ${automation.operations?.length || 0}`);
+
+ if (!automation?.operations || automation.operations.length === 0) {
+ throw new Error('No operations in automation');
+ }
+
+ let currentFiles = [...initialFiles];
+
+ for (let i = 0; i < automation.operations.length; i++) {
+ const operation = automation.operations[i];
+
+ console.log(`📋 Step ${i + 1}/${automation.operations.length}: ${operation.operation}`);
+ console.log(`📄 Input files: ${currentFiles.length}`);
+ console.log(`⚙️ Parameters:`, operation.parameters || {});
+
+ try {
+ onStepStart?.(i, operation.operation);
+
+ const resultFiles = await executeToolOperation(
+ operation.operation,
+ operation.parameters || {},
+ currentFiles,
+ toolRegistry
+ );
+
+ console.log(`✅ Step ${i + 1} completed: ${resultFiles.length} result files`);
+ currentFiles = resultFiles;
+ onStepComplete?.(i, resultFiles);
+
+ } catch (error: any) {
+ console.error(`❌ Step ${i + 1} failed:`, error);
+ onStepError?.(i, error.message);
+ throw error;
+ }
+ }
+
+ console.log(`🎉 Automation sequence completed: ${currentFiles.length} final files`);
+ return currentFiles;
+};
\ No newline at end of file
diff --git a/frontend/src/utils/automationFileProcessor.ts b/frontend/src/utils/automationFileProcessor.ts
new file mode 100644
index 000000000..45abbaafc
--- /dev/null
+++ b/frontend/src/utils/automationFileProcessor.ts
@@ -0,0 +1,186 @@
+/**
+ * File processing utilities specifically for automation workflows
+ */
+
+import axios, { AxiosResponse } from 'axios';
+import { zipFileService } from '../services/zipFileService';
+import { ResourceManager } from './resourceManager';
+import { AUTOMATION_CONSTANTS } from '../constants/automation';
+
+export interface AutomationProcessingOptions {
+ timeout?: number;
+ responseType?: 'blob' | 'json';
+}
+
+export interface AutomationProcessingResult {
+ success: boolean;
+ files: File[];
+ errors: string[];
+}
+
+export class AutomationFileProcessor {
+ /**
+ * Check if a blob is a ZIP file by examining its header
+ */
+ static isZipFile(blob: Blob): boolean {
+ // This is a simple check - in a real implementation you might want to read the first few bytes
+ // For now, we'll rely on the extraction attempt and fallback
+ return blob.type === 'application/zip' || blob.type === 'application/x-zip-compressed';
+ }
+
+ /**
+ * Extract files from a ZIP blob during automation execution, with fallback for non-ZIP files
+ */
+ static async extractAutomationZipFiles(blob: Blob): Promise {
+ try {
+ const zipFile = ResourceManager.createTimestampedFile(
+ blob,
+ AUTOMATION_CONSTANTS.RESPONSE_ZIP_PREFIX,
+ '.zip',
+ 'application/zip'
+ );
+
+ const result = await zipFileService.extractPdfFiles(zipFile);
+
+ if (!result.success || result.extractedFiles.length === 0) {
+ // Fallback: treat as single PDF file
+ const fallbackFile = ResourceManager.createTimestampedFile(
+ blob,
+ AUTOMATION_CONSTANTS.RESULT_FILE_PREFIX,
+ '.pdf'
+ );
+
+ return {
+ success: true,
+ files: [fallbackFile],
+ errors: [`ZIP extraction failed, treated as single file: ${result.errors?.join(', ') || 'Unknown error'}`]
+ };
+ }
+
+ return {
+ success: true,
+ files: result.extractedFiles,
+ errors: []
+ };
+ } catch (error) {
+ console.warn('Failed to extract automation ZIP files, falling back to single file:', error);
+ // Fallback: treat as single PDF file
+ const fallbackFile = ResourceManager.createTimestampedFile(
+ blob,
+ AUTOMATION_CONSTANTS.RESULT_FILE_PREFIX,
+ '.pdf'
+ );
+
+ return {
+ success: true,
+ files: [fallbackFile],
+ errors: [`ZIP extraction failed, treated as single file: ${error}`]
+ };
+ }
+ }
+
+ /**
+ * Process a single file through an automation step
+ */
+ static async processAutomationSingleFile(
+ endpoint: string,
+ formData: FormData,
+ originalFileName: string,
+ options: AutomationProcessingOptions = {}
+ ): Promise {
+ try {
+ const response = await axios.post(endpoint, formData, {
+ responseType: options.responseType || 'blob',
+ timeout: options.timeout || AUTOMATION_CONSTANTS.OPERATION_TIMEOUT
+ });
+
+ if (response.status !== 200) {
+ return {
+ success: false,
+ files: [],
+ errors: [`Automation step failed - HTTP ${response.status}: ${response.statusText}`]
+ };
+ }
+
+ const resultFile = ResourceManager.createResultFile(
+ response.data,
+ originalFileName,
+ AUTOMATION_CONSTANTS.FILE_PREFIX
+ );
+
+ return {
+ success: true,
+ files: [resultFile],
+ errors: []
+ };
+ } catch (error: any) {
+ return {
+ success: false,
+ files: [],
+ errors: [`Automation step failed: ${error.response?.data || error.message}`]
+ };
+ }
+ }
+
+ /**
+ * Process multiple files through an automation step
+ */
+ static async processAutomationMultipleFiles(
+ endpoint: string,
+ formData: FormData,
+ options: AutomationProcessingOptions = {}
+ ): Promise {
+ try {
+ const response = await axios.post(endpoint, formData, {
+ responseType: options.responseType || 'blob',
+ timeout: options.timeout || AUTOMATION_CONSTANTS.OPERATION_TIMEOUT
+ });
+
+ if (response.status !== 200) {
+ return {
+ success: false,
+ files: [],
+ errors: [`Automation step failed - HTTP ${response.status}: ${response.statusText}`]
+ };
+ }
+
+ // Multi-file responses are typically ZIP files
+ return await this.extractAutomationZipFiles(response.data);
+ } catch (error: any) {
+ return {
+ success: false,
+ files: [],
+ errors: [`Automation step failed: ${error.response?.data || error.message}`]
+ };
+ }
+ }
+
+ /**
+ * Build form data for automation tool operations
+ */
+ static buildAutomationFormData(
+ parameters: Record,
+ files: File | File[],
+ fileFieldName: string = 'fileInput'
+ ): FormData {
+ const formData = new FormData();
+
+ // Add files
+ if (Array.isArray(files)) {
+ files.forEach(file => formData.append(fileFieldName, file));
+ } else {
+ formData.append(fileFieldName, files);
+ }
+
+ // Add parameters
+ Object.entries(parameters).forEach(([key, value]) => {
+ if (Array.isArray(value)) {
+ value.forEach(item => formData.append(key, item));
+ } else if (value !== undefined && value !== null) {
+ formData.append(key, value);
+ }
+ });
+
+ return formData;
+ }
+}
diff --git a/frontend/src/utils/convertUtils.ts b/frontend/src/utils/convertUtils.ts
index 9c058c5ce..63e00da46 100644
--- a/frontend/src/utils/convertUtils.ts
+++ b/frontend/src/utils/convertUtils.ts
@@ -1,7 +1,9 @@
import {
CONVERSION_ENDPOINTS,
ENDPOINT_NAMES,
- EXTENSION_TO_ENDPOINT
+ EXTENSION_TO_ENDPOINT,
+ CONVERSION_MATRIX,
+ TO_FORMAT_OPTIONS
} from '../constants/convertConstants';
/**
@@ -56,4 +58,33 @@ export const isImageFormat = (extension: string): boolean => {
*/
export const isWebFormat = (extension: string): boolean => {
return ['html', 'zip'].includes(extension.toLowerCase());
+};
+
+/**
+ * Gets available target extensions for a given source extension
+ * Extracted from useConvertParameters to be reusable in automation settings
+ */
+export const getAvailableToExtensions = (fromExtension: string): Array<{value: string, label: string, group: string}> => {
+ if (!fromExtension) return [];
+
+ // Handle dynamic format identifiers (file-)
+ if (fromExtension.startsWith('file-')) {
+ // Dynamic format - use 'any' conversion options (file-to-pdf)
+ const supportedExtensions = CONVERSION_MATRIX['any'] || [];
+ return TO_FORMAT_OPTIONS.filter(option =>
+ supportedExtensions.includes(option.value)
+ );
+ }
+
+ let supportedExtensions = CONVERSION_MATRIX[fromExtension] || [];
+
+ // If no explicit conversion exists, but file-to-pdf might be available,
+ // fall back to 'any' conversion (which converts unknown files to PDF via file-to-pdf)
+ if (supportedExtensions.length === 0 && fromExtension !== 'any') {
+ supportedExtensions = CONVERSION_MATRIX['any'] || [];
+ }
+
+ return TO_FORMAT_OPTIONS.filter(option =>
+ supportedExtensions.includes(option.value)
+ );
};
\ No newline at end of file
diff --git a/frontend/src/utils/resourceManager.ts b/frontend/src/utils/resourceManager.ts
new file mode 100644
index 000000000..4dae97e01
--- /dev/null
+++ b/frontend/src/utils/resourceManager.ts
@@ -0,0 +1,71 @@
+/**
+ * Utilities for managing file resources and blob URLs
+ */
+
+import { useCallback } from 'react';
+import { AUTOMATION_CONSTANTS } from '../constants/automation';
+
+export class ResourceManager {
+ private static blobUrls = new Set();
+
+ /**
+ * Create a blob URL and track it for cleanup
+ */
+ static createBlobUrl(blob: Blob): string {
+ const url = URL.createObjectURL(blob);
+ this.blobUrls.add(url);
+ return url;
+ }
+
+ /**
+ * Revoke a specific blob URL
+ */
+ static revokeBlobUrl(url: string): void {
+ if (this.blobUrls.has(url)) {
+ URL.revokeObjectURL(url);
+ this.blobUrls.delete(url);
+ }
+ }
+
+ /**
+ * Revoke all tracked blob URLs
+ */
+ static revokeAllBlobUrls(): void {
+ this.blobUrls.forEach(url => URL.revokeObjectURL(url));
+ this.blobUrls.clear();
+ }
+
+ /**
+ * Create a File with proper naming convention
+ */
+ static createResultFile(
+ data: BlobPart,
+ originalName: string,
+ prefix: string = AUTOMATION_CONSTANTS.PROCESSED_FILE_PREFIX,
+ type: string = 'application/pdf'
+ ): File {
+ return new File([data], `${prefix}${originalName}`, { type });
+ }
+
+ /**
+ * Create a timestamped file for responses
+ */
+ static createTimestampedFile(
+ data: BlobPart,
+ prefix: string,
+ extension: string = '.pdf',
+ type: string = 'application/pdf'
+ ): File {
+ const timestamp = Date.now();
+ return new File([data], `${prefix}${timestamp}${extension}`, { type });
+ }
+}
+
+/**
+ * Hook for automatic cleanup on component unmount
+ */
+export function useResourceCleanup(): () => void {
+ return useCallback(() => {
+ ResourceManager.revokeAllBlobUrls();
+ }, []);
+}
\ No newline at end of file
diff --git a/frontend/src/utils/urlRouting.ts b/frontend/src/utils/urlRouting.ts
index fbf6c1c3c..05493423a 100644
--- a/frontend/src/utils/urlRouting.ts
+++ b/frontend/src/utils/urlRouting.ts
@@ -3,12 +3,7 @@
* Provides clean URL routing for the V2 tool system
*/
-import { ModeType } from '../contexts/NavigationContext';
-
-export interface ToolRoute {
- mode: ModeType;
- toolKey?: string;
-}
+import { ModeType, isValidMode as isValidModeType, getDefaultMode, ToolRoute } from '../types/navigation';
/**
* Parse the current URL to extract tool routing information
@@ -45,7 +40,7 @@ export function parseToolRoute(): ToolRoute {
// Check for query parameter fallback (e.g., ?tool=split)
const toolParam = searchParams.get('tool');
- if (toolParam && isValidMode(toolParam)) {
+ if (toolParam && isValidModeType(toolParam)) {
return {
mode: toolParam as ModeType,
toolKey: toolParam
@@ -54,7 +49,8 @@ export function parseToolRoute(): ToolRoute {
// Default to page editor for home page
return {
- mode: 'pageEditor'
+ mode: getDefaultMode(),
+ toolKey: null
};
}
@@ -137,16 +133,7 @@ export function getToolDisplayName(toolKey: string): string {
return displayNames[toolKey] || toolKey;
}
-/**
- * Check if a mode is valid
- */
-function isValidMode(mode: string): mode is ModeType {
- const validModes: ModeType[] = [
- 'viewer', 'pageEditor', 'fileEditor', 'merge', 'split',
- 'compress', 'ocr', 'convert', 'addPassword', 'changePermissions', 'sanitize'
- ];
- return validModes.includes(mode as ModeType);
-}
+// Note: isValidMode is now imported from types/navigation.ts
/**
* Generate shareable URL for current tool state