mirror of
https://github.com/arsvendg/Stirling-PDF.git
synced 2026-07-15 11:00:47 +02:00
# Description of Changes Upgrades embedPDF from v2.5.0 to v2.6.0 and migrates from unmaintained pdf-lib to @cantoo/pdf-lib fork. Adds defensive error handling for malformed PDFs and improves bridge lifecycle management. ### Changes **Dependencies** - Upgrade all @embedpdf/* packages from ^2.5.0 to ^2.6.0 - Replace pdf-lib with @cantoo/pdf-lib (maintained fork with better TypeScript support) **PDF Viewer Infrastructure (attachment/bookmark fix)** - Add useDocumentReady hook to track document lifecycle across bridges - Implement defensive bridge cleanup to prevent stale registrations - Fix race condition in document ready state detection by subscribing to events before checking state **Link Extraction (updated to cantoo/pdf-lib)** - Add graceful error handling for PDFs with invalid catalog structures - Extract enhanced link metadata (tooltips, colors, border styles, highlight modes) - Return empty results instead of throwing on malformed PDFs - Add validation for link creation (destination page bounds, rect dimensions, color values) **Signature Flattening (updated to cantoo/pdf-lib)** - Improve SVG embedding with three-tier fallback strategy (native vector, rasterized PNG, placeholder) - Add proper Unicode handling for PDF form tooltips via PDFString.decodeText() - Extract SVG utilities into cleaner strategy pattern **Form Field Processing (updated to cantoo/pdf-lib)** - Add support for display labels vs export values in dropdown/list fields per PDF spec 12.7.4.4 - Implement caching for expensive field property lookups - Add proper handling of malformed /Opt arrays <!-- Please provide a summary of the changes, including: - What was changed - Why the change was made - Any challenges encountered Closes #(issue_number) --> --- ## Checklist ### General - [X] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [X] 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) - [X] I have performed a self-review of my own code - [X] 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) ### Translations (if applicable) - [ ] I ran [`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md) ### 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) - [X] 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. --------- Signed-off-by: Balázs Szücs <[email protected]>
72 lines
2.5 KiB
TypeScript
72 lines
2.5 KiB
TypeScript
import { useEffect, useMemo } from 'react';
|
|
import { useViewer } from '@app/contexts/ViewerContext';
|
|
import { useDocumentReady } from '@app/components/viewer/hooks/useDocumentReady';
|
|
import {
|
|
PdfPermissionFlag,
|
|
DocumentPermissionsState,
|
|
DocumentPermissionsAPIWrapper,
|
|
} from '@app/contexts/viewer/viewerBridges';
|
|
|
|
function hasPermissionFlag(permissions: number, flag: PdfPermissionFlag): boolean {
|
|
if (permissions === 0 || permissions === PdfPermissionFlag.AllowAll) {
|
|
return true;
|
|
}
|
|
return (permissions & flag) !== 0;
|
|
}
|
|
|
|
interface DocumentPermissionsAPIBridgeProps {
|
|
isEncrypted?: boolean;
|
|
isOwnerUnlocked?: boolean;
|
|
permissions?: number;
|
|
}
|
|
|
|
export function DocumentPermissionsAPIBridge({
|
|
isEncrypted = false,
|
|
isOwnerUnlocked = false,
|
|
permissions = PdfPermissionFlag.AllowAll,
|
|
}: DocumentPermissionsAPIBridgeProps) {
|
|
const { registerBridge } = useViewer();
|
|
const documentReady = useDocumentReady();
|
|
|
|
const state = useMemo<DocumentPermissionsState>(() => ({
|
|
isEncrypted,
|
|
isOwnerUnlocked,
|
|
permissions,
|
|
canPrint: hasPermissionFlag(permissions, PdfPermissionFlag.Print),
|
|
canModifyContents: hasPermissionFlag(permissions, PdfPermissionFlag.ModifyContents),
|
|
canCopyContents: hasPermissionFlag(permissions, PdfPermissionFlag.CopyContents),
|
|
canModifyAnnotations: hasPermissionFlag(permissions, PdfPermissionFlag.ModifyAnnotations),
|
|
canFillForms: hasPermissionFlag(permissions, PdfPermissionFlag.FillForms),
|
|
canExtractForAccessibility: hasPermissionFlag(permissions, PdfPermissionFlag.ExtractForAccessibility),
|
|
canAssembleDocument: hasPermissionFlag(permissions, PdfPermissionFlag.AssembleDocument),
|
|
canPrintHighQuality: hasPermissionFlag(permissions, PdfPermissionFlag.PrintHighQuality),
|
|
}), [isEncrypted, isOwnerUnlocked, permissions]);
|
|
|
|
const api = useMemo<DocumentPermissionsAPIWrapper>(() => ({
|
|
hasPermission: (flag: PdfPermissionFlag) => hasPermissionFlag(permissions, flag),
|
|
hasAllPermissions: (flags: PdfPermissionFlag[]) =>
|
|
flags.every(flag => hasPermissionFlag(permissions, flag)),
|
|
getEffectivePermission: (flag: PdfPermissionFlag) => {
|
|
if (isOwnerUnlocked) return true;
|
|
return hasPermissionFlag(permissions, flag);
|
|
},
|
|
}), [permissions, isOwnerUnlocked]);
|
|
|
|
useEffect(() => {
|
|
if (documentReady) {
|
|
registerBridge('permissions', {
|
|
state,
|
|
api,
|
|
});
|
|
}
|
|
|
|
return () => {
|
|
registerBridge('permissions', null);
|
|
};
|
|
}, [registerBridge, state, api, documentReady]);
|
|
|
|
return null;
|
|
}
|
|
|
|
export { PdfPermissionFlag };
|