@signiphi/page-assembly 0.2.0-beta.8 → 0.2.0-beta.9

package/dist/index.d.mts

@@ -187,6 +187,26 @@ declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAtt
 declare function pdfToImages(pdfBytes: Uint8Array, options?: {
     hideFormFields?: boolean;
 }): Promise<PageImage[]>;
+/**
+ * Last-resort rebuild for encrypted PDFs whose structure pdf-lib cannot
+ * parse even with `ignoreEncryption`: render every page with PDF.js (which
+ * has full decryption support) and re-emit them as an image-based PDF.
+ *
+ * @param pdfBytes - The source PDF as a Uint8Array
+ * @returns Promise resolving to rebuilt (unencrypted, image-based) PDF bytes
+ */
+declare function rasterizePdfToPdf(pdfBytes: Uint8Array): Promise<Uint8Array>;
+/**
+ * Prepares uploaded PDF bytes for the pdf-lib based assembly pipeline.
+ * Regular PDFs pass through untouched. Encrypted PDFs (typically
+ * permission-restricted documents that open without a password) are
+ * decrypted once here so every downstream `PDFDocument.load` — assembly,
+ * field extraction — sees a normal document. When structural decryption is
+ * impossible the document is rebuilt from rendered pages as a last resort.
+ *
+ * @throws {PdfPasswordRequiredError} when the PDF needs a real password
+ */
+declare function normalizeUploadedPdfBytes(pdfBytes: Uint8Array): Promise<Uint8Array>;
 /**
  * Converts an image file to a PDF document with a single page
  *
@@ -226,6 +246,31 @@ declare function createPdfBlobUrl(pdfBytes: Uint8Array): string;
  */
 declare function downloadPdf(pdfBytes: Uint8Array, filename: string): void;
 
+declare class PdfPasswordRequiredError extends Error {
+    code: string;
+    recoverable: boolean;
+    userMessage: string;
+    constructor();
+}
+declare class UnsupportedPdfEncryptionError extends Error {
+    constructor(detail: string);
+}
+/**
+ * Decrypt an encrypted PDF that opens with an empty user password.
+ * Returns re-saved, fully decrypted bytes with `/Encrypt` removed.
+ *
+ * @throws {PdfPasswordRequiredError} when a non-empty password is required
+ * @throws {UnsupportedPdfEncryptionError} for non-standard security handlers
+ */
+declare function decryptPdf(pdfBytes: Uint8Array): Promise<Uint8Array>;
+declare function isEncryptedPdfError(error: unknown): boolean;
+/**
+ * Ingestion gate: returns the bytes untouched for regular PDFs, and a
+ * decrypted re-save for encrypted ones so every downstream `PDFDocument.load`
+ * (page assembly, field extraction) sees a normal document.
+ */
+declare function normalizePdfEncryption(pdfBytes: Uint8Array): Promise<Uint8Array>;
+
 /**
  * PDF Field Extraction Utilities
  * Extract form fields from PDFs with metadata support for preserving field properties
@@ -354,4 +399,4 @@ declare function mapFieldPositionsAfterAssembly<T extends {
     position: FormFieldPosition;
 }>(fields: T[], pageMapping: Map<string, number>): T[];
 
-export { type AssembleOptions, Button, type ExtractedField, type FileExtractedFields, type FileInfo, type FormFieldForPdf, type FormFieldPosition, FormFieldType, PageAssembler, type PageAssemblerHandle, type PageAssemblerProps, type PageAssemblerState, type PageImage, type PageInfo, type TrackedFormField, addFormFieldsToPdf, createPdfBlobUrl, downloadPdf, extractFieldsFromPdf, getSigniphiMetadata, imageToPdf, mapFieldPositionsAfterAssembly, pdfToImages, setSigniphiMetadata };
+export { type AssembleOptions, Button, type ExtractedField, type FileExtractedFields, type FileInfo, type FormFieldForPdf, type FormFieldPosition, FormFieldType, PageAssembler, type PageAssemblerHandle, type PageAssemblerProps, type PageAssemblerState, type PageImage, type PageInfo, PdfPasswordRequiredError, type TrackedFormField, UnsupportedPdfEncryptionError, addFormFieldsToPdf, createPdfBlobUrl, decryptPdf, downloadPdf, extractFieldsFromPdf, getSigniphiMetadata, imageToPdf, isEncryptedPdfError, mapFieldPositionsAfterAssembly, normalizePdfEncryption, normalizeUploadedPdfBytes, pdfToImages, rasterizePdfToPdf, setSigniphiMetadata };

package/dist/index.d.ts

@@ -187,6 +187,26 @@ declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAtt
 declare function pdfToImages(pdfBytes: Uint8Array, options?: {
     hideFormFields?: boolean;
 }): Promise<PageImage[]>;
+/**
+ * Last-resort rebuild for encrypted PDFs whose structure pdf-lib cannot
+ * parse even with `ignoreEncryption`: render every page with PDF.js (which
+ * has full decryption support) and re-emit them as an image-based PDF.
+ *
+ * @param pdfBytes - The source PDF as a Uint8Array
+ * @returns Promise resolving to rebuilt (unencrypted, image-based) PDF bytes
+ */
+declare function rasterizePdfToPdf(pdfBytes: Uint8Array): Promise<Uint8Array>;
+/**
+ * Prepares uploaded PDF bytes for the pdf-lib based assembly pipeline.
+ * Regular PDFs pass through untouched. Encrypted PDFs (typically
+ * permission-restricted documents that open without a password) are
+ * decrypted once here so every downstream `PDFDocument.load` — assembly,
+ * field extraction — sees a normal document. When structural decryption is
+ * impossible the document is rebuilt from rendered pages as a last resort.
+ *
+ * @throws {PdfPasswordRequiredError} when the PDF needs a real password
+ */
+declare function normalizeUploadedPdfBytes(pdfBytes: Uint8Array): Promise<Uint8Array>;
 /**
  * Converts an image file to a PDF document with a single page
  *
@@ -226,6 +246,31 @@ declare function createPdfBlobUrl(pdfBytes: Uint8Array): string;
  */
 declare function downloadPdf(pdfBytes: Uint8Array, filename: string): void;
 
+declare class PdfPasswordRequiredError extends Error {
+    code: string;
+    recoverable: boolean;
+    userMessage: string;
+    constructor();
+}
+declare class UnsupportedPdfEncryptionError extends Error {
+    constructor(detail: string);
+}
+/**
+ * Decrypt an encrypted PDF that opens with an empty user password.
+ * Returns re-saved, fully decrypted bytes with `/Encrypt` removed.
+ *
+ * @throws {PdfPasswordRequiredError} when a non-empty password is required
+ * @throws {UnsupportedPdfEncryptionError} for non-standard security handlers
+ */
+declare function decryptPdf(pdfBytes: Uint8Array): Promise<Uint8Array>;
+declare function isEncryptedPdfError(error: unknown): boolean;
+/**
+ * Ingestion gate: returns the bytes untouched for regular PDFs, and a
+ * decrypted re-save for encrypted ones so every downstream `PDFDocument.load`
+ * (page assembly, field extraction) sees a normal document.
+ */
+declare function normalizePdfEncryption(pdfBytes: Uint8Array): Promise<Uint8Array>;
+
 /**
  * PDF Field Extraction Utilities
  * Extract form fields from PDFs with metadata support for preserving field properties
@@ -354,4 +399,4 @@ declare function mapFieldPositionsAfterAssembly<T extends {
     position: FormFieldPosition;
 }>(fields: T[], pageMapping: Map<string, number>): T[];
 
-export { type AssembleOptions, Button, type ExtractedField, type FileExtractedFields, type FileInfo, type FormFieldForPdf, type FormFieldPosition, FormFieldType, PageAssembler, type PageAssemblerHandle, type PageAssemblerProps, type PageAssemblerState, type PageImage, type PageInfo, type TrackedFormField, addFormFieldsToPdf, createPdfBlobUrl, downloadPdf, extractFieldsFromPdf, getSigniphiMetadata, imageToPdf, mapFieldPositionsAfterAssembly, pdfToImages, setSigniphiMetadata };
+export { type AssembleOptions, Button, type ExtractedField, type FileExtractedFields, type FileInfo, type FormFieldForPdf, type FormFieldPosition, FormFieldType, PageAssembler, type PageAssemblerHandle, type PageAssemblerProps, type PageAssemblerState, type PageImage, type PageInfo, PdfPasswordRequiredError, type TrackedFormField, UnsupportedPdfEncryptionError, addFormFieldsToPdf, createPdfBlobUrl, decryptPdf, downloadPdf, extractFieldsFromPdf, getSigniphiMetadata, imageToPdf, isEncryptedPdfError, mapFieldPositionsAfterAssembly, normalizePdfEncryption, normalizeUploadedPdfBytes, pdfToImages, rasterizePdfToPdf, setSigniphiMetadata };