Feature/v2/redact (#5249)

# Description of Changes

- Add manual redaction and added it to the right rail in the viewer

---

## Checklist

### General

- [ ] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [ ] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md)
(if applicable)
- [ ] I have read the [How to add new languages to
Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md)
(if applicable)
- [ ] I have performed a self-review of my own code
- [ ] My changes generate no new warnings

### Documentation

- [ ] I have updated relevant docs on [Stirling-PDF's doc
repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/)
(if functionality has heavily changed)
- [ ] I have read the section [Add New Translation
Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags)
(for new translation tags only)

### UI Changes (if applicable)

- [ ] Screenshots or videos demonstrating the UI changes are attached
(e.g., as comments or direct attachments in the PR)

### Testing (if applicable)

- [ ] I have tested my changes locally. Refer to the [Testing
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing)
for more details.

frontend/src/core/hooks/tools/redact/useRedactOperation.test.ts

@@ -103,13 +103,14 @@ describe('buildRedactFormData', () => {
     expect(formData.get('convertPDFToImage')).toBe('false');
   });
 
-  test('should throw error for manual mode (not implemented)', () => {
+  test('should return empty form data for manual mode (handled client-side)', () => {
     const parameters: RedactParameters = {
       ...defaultParameters,
       mode: 'manual',
     };
 
-    expect(() => buildRedactFormData(parameters, mockFile)).toThrow('Manual redaction not yet implemented');
+    const formData = buildRedactFormData(parameters, mockFile);
+    expect(formData.get('fileInput')).toBeNull();
   });
 });
 

frontend/src/core/hooks/tools/redact/useRedactOperation.ts

@@ -6,9 +6,10 @@ import { RedactParameters, defaultParameters } from '@app/hooks/tools/redact/use
 // Static configuration that can be used by both the hook and automation executor
 export const buildRedactFormData = (parameters: RedactParameters, file: File): FormData => {
   const formData = new FormData();
-  formData.append("fileInput", file);
 
+  // For automatic mode we hit the backend and need full payload
   if (parameters.mode === 'automatic') {
+    formData.append("fileInput", file);
     // Convert array to newline-separated string as expected by backend
     formData.append("listOfText", parameters.wordsToRedact.join('\n'));
     formData.append("useRegex", parameters.useRegex.toString());
@@ -17,8 +18,8 @@ export const buildRedactFormData = (parameters: RedactParameters, file: File): F
     formData.append("customPadding", parameters.customPadding.toString());
     formData.append("convertPDFToImage", parameters.convertPDFToImage.toString());
   } else {
-    // Manual mode parameters would go here when implemented
-    throw new Error('Manual redaction not yet implemented');
+    // Manual redaction uses EmbedPDF in-viewer; we don't call the API.
+    // Return an empty formData to satisfy shared interfaces without throwing.
   }
 
   return formData;
@@ -32,10 +33,9 @@ export const redactOperationConfig = {
   endpoint: (parameters: RedactParameters) => {
     if (parameters.mode === 'automatic') {
       return '/api/v1/security/auto-redact';
-    } else {
-      // Manual redaction endpoint would go here when implemented
-      throw new Error('Manual redaction not yet implemented');
     }
+    // Manual redaction is handled by EmbedPDF in the viewer; no endpoint call.
+    return "";  
   },
   defaultParameters,
 } as const;

frontend/src/core/hooks/tools/redact/useRedactParameters.test.ts

@@ -84,14 +84,14 @@ describe('useRedactParameters', () => {
       expect(result.current.getEndpointName()).toBe('/api/v1/security/auto-redact');
     });
 
-    test('should throw error for manual mode (not implemented)', () => {
+    test('should return empty endpoint for manual mode (handled client-side)', () => {
       const { result } = renderHook(() => useRedactParameters());
 
       act(() => {
         result.current.updateParameter('mode', 'manual');
       });
 
-      expect(() => result.current.getEndpointName()).toThrow('Manual redaction not yet implemented');
+      expect(result.current.getEndpointName()).toBe('');
     });
   });
 

frontend/src/core/hooks/tools/redact/useRedactParameters.ts

@@ -34,14 +34,14 @@ export const useRedactParameters = (): RedactParametersHook => {
       if (params.mode === 'automatic') {
         return '/api/v1/security/auto-redact';
       }
-      // Manual redaction endpoint would go here when implemented
-      throw new Error('Manual redaction not yet implemented');
+      // Manual redaction handled client-side (validation prevents this path)
+      return '';
     },
     validateFn: (params) => {
       if (params.mode === 'automatic') {
         return params.wordsToRedact.length > 0 && params.wordsToRedact.some(word => word.trim().length > 0);
       }
-      // Manual mode validation would go here when implemented
+      // Manual mode is not yet supported via this flow
       return false;
     }
   });