@signiphi/pdf-signer 0.1.1

package/dist/utils/pdf-field-type-helpers.d.ts

@@ -0,0 +1,78 @@
+/**
+ * PDF Field Type Helper Utilities
+ * Common utilities for detecting field types and extracting values
+ *
+ * Used across pdf-manipulation.ts for consistent field processing
+ */
+/**
+ * PDF form field type for operations
+ */
+interface PDFFormField {
+    getName(): string;
+    constructor: {
+        name: string;
+    };
+    getText?(): string;
+    setText?(text: string): void;
+    isRequired?(): boolean;
+    isChecked?(): boolean;
+    getSelected?(): string[];
+    enableReadOnly?(): void;
+}
+/**
+ * Detect the field type from a PDF field
+ *
+ * Maps pdf-lib's field constructor names to standardized type strings.
+ *
+ * @param field - The PDF form field
+ * @returns Standardized field type string
+ *
+ * @example
+ * ```ts
+ * const fieldType = detectFieldType(field);
+ * // Returns: 'text', 'checkbox', 'dropdown', 'radiogroup', 'signature', etc.
+ * ```
+ */
+export declare function detectFieldType(field: PDFFormField): string;
+/**
+ * Extract the current value from a PDF field based on its type
+ *
+ * Handles different field types appropriately:
+ * - Text fields: getText()
+ * - Checkboxes: isChecked() → 'true'/'false'
+ * - Dropdowns: getSelected()[0]
+ * - Radio groups: getSelected()[0]
+ *
+ * @param field - The PDF form field
+ * @param fieldType - The field type (from detectFieldType)
+ * @returns The field value as a string, or empty string if no value
+ *
+ * @example
+ * ```ts
+ * const fieldType = detectFieldType(field);
+ * const value = extractFieldValue(field, fieldType);
+ * ```
+ */
+export declare function extractFieldValue(field: PDFFormField, fieldType: string): string;
+/**
+ * Check if a field is required based on field metadata and name patterns
+ *
+ * Attempts to determine required status through:
+ * 1. field.isRequired() method (if available)
+ * 2. Field name patterns (signature, initials, required)
+ * 3. Field type (signatures are always required)
+ *
+ * @param field - The PDF form field
+ * @param fieldName - The field name
+ * @param fieldType - The field type (from detectFieldType)
+ * @returns true if field is required
+ *
+ * @example
+ * ```ts
+ * const isRequired = isRequiredField(field, 'signature_1', 'text');
+ * // Returns: true (signature fields are required)
+ * ```
+ */
+export declare function isRequiredField(field: PDFFormField, fieldName: string, fieldType: string): boolean;
+export {};
+//# sourceMappingURL=pdf-field-type-helpers.d.ts.map

package/dist/utils/pdf-field-type-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-field-type-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-field-type-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,UAAU,YAAY;IACpB,OAAO,IAAI,MAAM,CAAC;IAClB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,IAAI,MAAM,CAAC;IACnB,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,IAAI,OAAO,CAAC;IACvB,SAAS,CAAC,IAAI,OAAO,CAAC;IACtB,WAAW,CAAC,IAAI,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,IAAI,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAkB3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAoBhF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAyBT"}

package/dist/utils/pdf-helpers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PDF utility helper functions
+ */
+/**
+ * Create a blob URL from PDF bytes for preview
+ */
+export declare function createPdfBlobUrl(pdfBytes: Uint8Array): string;
+/**
+ * Download PDF file
+ */
+export declare function downloadPdf(pdfBytes: Uint8Array, filename: string): void;
+/**
+ * Convert URL to PDF bytes
+ * @param url - The URL to fetch the PDF from
+ * @returns PDF bytes as Uint8Array
+ */
+export declare function urlToPdfBytes(url: string): Promise<Uint8Array>;
+/**
+ * Validate that data is a valid PDF
+ */
+export declare function isValidPdf(pdfBytes: Uint8Array): boolean;
+/**
+ * Convert base64 data URL to image bytes
+ */
+export declare function dataUrlToBytes(dataUrl: string): Uint8Array;
+/**
+ * Format field name for display
+ */
+export declare function formatFieldName(fieldName: string): string;
+/**
+ * Check if a field is a signature field
+ */
+export declare function isSignatureField(fieldName: string): boolean;
+/**
+ * Check if a field is an initials field
+ */
+export declare function isInitialsField(fieldName: string): boolean;
+//# sourceMappingURL=pdf-helpers.d.ts.map

package/dist/utils/pdf-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAG7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAM1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/utils/pdf-lib-loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Lazy loader for pdf-lib
+ *
+ * This module provides a lazy loading mechanism for the pdf-lib library (~150KB).
+ * By deferring the import until actually needed, we can significantly reduce
+ * the initial bundle size for consumers who only view PDFs without filling forms.
+ *
+ * The pdf-lib library is only loaded when:
+ * - fillPdf() is called
+ * - combinePdfs() is called
+ * - Other PDF manipulation functions are used
+ */
+/**
+ * Dynamically import pdf-lib library
+ *
+ * This function lazily loads pdf-lib only when needed. The import is cached
+ * so subsequent calls return the same promise, avoiding multiple imports.
+ *
+ * @returns Promise resolving to the pdf-lib module
+ *
+ * @example
+ * ```typescript
+ * const { PDFDocument, rgb, StandardFonts } = await loadPdfLib();
+ * const pdfDoc = await PDFDocument.load(pdfBytes);
+ * ```
+ */
+export declare function loadPdfLib(): Promise<typeof import("pdf-lib")>;
+/**
+ * Check if pdf-lib has been loaded
+ *
+ * Useful for debugging and testing to verify lazy loading behavior.
+ *
+ * @returns true if pdf-lib has been loaded, false otherwise
+ */
+export declare function isPdfLibLoaded(): boolean;
+/**
+ * Reset the pdf-lib cache (primarily for testing)
+ *
+ * This should only be used in test environments to reset state
+ * between tests.
+ *
+ * @internal
+ */
+export declare function resetPdfLibCache(): void;
+//# sourceMappingURL=pdf-lib-loader.d.ts.map

package/dist/utils/pdf-lib-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-lib-loader.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-lib-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,sCAK/B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/utils/pdf-manipulation.d.ts

@@ -0,0 +1,93 @@
+/**
+ * PDF Manipulation Utilities
+ * Core utilities for PDF processing, page manipulation, and file combining
+ */
+import { PdfPage, EsignFormField, FormFieldPosition, MultiSignerContext } from '../types';
+/**
+ * Convert PDF pages to images for rendering in the UI using PDF.js
+ */
+export declare function pdfToImages(pdfBytes: Uint8Array, options?: {
+    hideFormFields?: boolean;
+}): Promise<PdfPage[]>;
+/**
+ * Remove all existing form fields from a PDF using robust widget cleanup
+ * @param pdfBytes - The PDF bytes
+ * @param stripAllAnnotations - If true, removes all annotations from pages (more aggressive cleanup)
+ * @returns The PDF bytes with all form fields removed
+ */
+export declare function removeAllFormFields(pdfBytes: Uint8Array, stripAllAnnotations?: boolean): Promise<Uint8Array>;
+/**
+ * Read existing PDF form fields and their properties
+ */
+export declare function readPdfFormFields(pdfBytes: Uint8Array): Promise<{
+    name: string;
+    type: string;
+    required: boolean;
+    value?: string;
+}[]>;
+/**
+ * Read current PDF form field values (including user-filled data)
+ */
+export declare function readCurrentPdfFormValues(pdfBytes: Uint8Array): Promise<Record<string, string>>;
+/**
+ * Validate PDF form fields against provided values
+ * In multi-signer mode, only validates fields visible to the current signer
+ */
+export declare function validatePdfFormFields(pdfBytes: Uint8Array, fieldValues: Record<string, string>, signatures: Record<string, string>, extractedFields?: EsignFormField[], // Pass extracted fields to know which are visible
+multiSignerContext?: MultiSignerContext): Promise<string[]>;
+/**
+ * Validate PDF form fields against current form state
+ */
+export declare function validateCurrentPdfState(pdfBytes: Uint8Array, signatures: Record<string, string>, formFieldValues?: Record<string, string>): Promise<string[]>;
+/**
+ * Fill PDF with signature images and form field values, then flatten the form
+ * @param pdfBytes - The PDF bytes
+ * @param signatures - The signature data URLs (field name -> base64 PNG)
+ * @param formFieldValues - The form field values to fill
+ * @returns The filled and flattened PDF bytes
+ */
+export declare function fillPdfWithSignatures(pdfBytes: Uint8Array, signatures: Record<string, string>, formFieldValues?: Record<string, string>, currentSignerEmail?: string, extractedFormFields?: EsignFormField[], metadata?: {
+    submissionId?: string;
+    documentId?: string;
+    author?: string;
+    signerEmail?: string;
+    signerInitials?: string;
+    createdAt?: Date;
+}, auditTrail?: {
+    userAgent?: string;
+    screenResolution?: string;
+    timezone?: string;
+    language?: string;
+    platform?: string;
+    ipAddress?: string;
+    geolocation?: {
+        latitude: number;
+        longitude: number;
+        accuracy?: number;
+    };
+}, multiSignerContext?: {
+    isMultiSigner: boolean;
+    currentSigner: any;
+    currentSignerEmail: string;
+    isPrimarySigner: boolean;
+    isFinalSigner: boolean;
+}): Promise<Uint8Array>;
+/**
+ * Fill form fields and replace signature/initials with actual signature images
+ * This is used when fields are rendered as overlays on the PDF
+ * @param pdfBytes - The PDF bytes
+ * @param formFields - The form fields with their positions
+ * @param fieldValues - The field values to fill
+ * @param signatures - The signature images (base64 data URLs)
+ * @returns The filled PDF bytes
+ */
+export declare function fillFormFieldsWithSignatures(pdfBytes: Uint8Array, formFields: EsignFormField[], fieldValues: Record<string, string>, signatures: Record<string, string>): Promise<Uint8Array>;
+/**
+ * Extract field positions and page numbers from a PDF document
+ * Returns maps for field name -> page number and field name -> position
+ */
+export declare function getFieldPageNumbers(pdfBytes: Uint8Array): Promise<{
+    pageMap: Record<string, number>;
+    positionMap: Record<string, FormFieldPosition>;
+}>;
+//# sourceMappingURL=pdf-manipulation.d.ts.map

package/dist/utils/pdf-manipulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-manipulation.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-manipulation.ts"],"names":[],"mappings":"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"}

package/dist/utils/pdf-validators.d.ts

@@ -0,0 +1,149 @@
+/**
+ * PDF Validation Utilities
+ * Common validation functions used across the package
+ */
+/**
+ * Validate that bytes represent a valid PDF file
+ *
+ * Checks for:
+ * - Non-empty bytes
+ * - Valid PDF header (%PDF-)
+ *
+ * @param pdfBytes - The PDF bytes to validate
+ * @returns Validation result with valid flag and optional error message
+ *
+ * @example
+ * ```ts
+ * const result = validatePdfBytes(pdfBytes);
+ * if (!result.valid) {
+ *   console.error(result.error);
+ *   return;
+ * }
+ * ```
+ */
+export declare function validatePdfBytes(pdfBytes: Uint8Array): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Check if a label is auto-generated (not user-typed)
+ *
+ * Auto-generated labels are simple type names like "Text", "Signature", etc.
+ * These are default labels assigned by the form builder and should not be
+ * displayed to users in the same way as custom labels.
+ *
+ * Works identically in both single-signer and multi-signer flows.
+ *
+ * @param label - The label to check
+ * @returns true if the label is auto-generated, false if it's a custom user label
+ *
+ * @example
+ * ```ts
+ * isAutoGeneratedLabel('Signature') // true
+ * isAutoGeneratedLabel('Sign here please') // false
+ * isAutoGeneratedLabel('') // true
+ * ```
+ */
+export declare function isAutoGeneratedLabel(label: string): boolean;
+/**
+ * Validate field values object
+ *
+ * Checks that the values object is properly formatted and contains
+ * only string values for field IDs.
+ *
+ * @param values - Field values to validate
+ * @returns Validation result with valid flag and errors array
+ *
+ * @example
+ * ```ts
+ * const result = validateFieldValues({ field1: 'value1', field2: 'value2' });
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateFieldValues(values: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate signatures object
+ *
+ * Checks that signatures are properly formatted data URLs.
+ *
+ * @param signatures - Signatures to validate
+ * @returns Validation result with valid flag and errors array
+ *
+ * @example
+ * ```ts
+ * const result = validateSignatures({
+ *   sig1: 'data:image/png;base64,iVBORw0KG...',
+ *   sig2: 'data:image/png;base64,iVBORw0KG...'
+ * });
+ * if (!result.valid) {
+ *   console.error('Invalid signatures:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateSignatures(signatures: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate a form field definition
+ *
+ * Checks that a field has all required properties and they are valid.
+ *
+ * @param field - Form field to validate
+ * @returns Validation result with valid flag and errors array
+ *
+ * @example
+ * ```ts
+ * const result = validateFormField({
+ *   id: 'field1',
+ *   name: 'firstName',
+ *   type: FormFieldType.TEXT,
+ *   label: 'First Name',
+ *   position: { x: 100, y: 200, width: 150, height: 30, page: 1 },
+ *   required: true
+ * });
+ * if (!result.valid) {
+ *   console.error('Field validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateFormField(field: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate PDF URL format
+ *
+ * Accepts absolute URLs, relative paths, and data URLs.
+ *
+ * @param url - URL to validate
+ * @returns Validation result with valid flag and optional error message
+ *
+ * @example
+ * ```ts
+ * // Absolute URLs
+ * validatePdfUrl('https://example.com/document.pdf'); // valid
+ * validatePdfUrl('http://localhost:3000/doc.pdf'); // valid
+ *
+ * // Relative paths
+ * validatePdfUrl('/public/document.pdf'); // valid
+ * validatePdfUrl('./document.pdf'); // valid
+ *
+ * // Data URLs and blobs
+ * validatePdfUrl('data:application/pdf;base64,...'); // valid
+ * validatePdfUrl('blob:http://localhost/...'); // valid
+ *
+ * // Local files
+ * validatePdfUrl('file:///C:/path/to/file.pdf'); // valid
+ * ```
+ */
+export declare function validatePdfUrl(url: unknown): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=pdf-validators.d.ts.map

package/dist/utils/pdf-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-validators.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-validators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAmBA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAe3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAqBA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAiCA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAuEA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA6BA"}

package/dist/utils/pdf-viewer-filter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PDF Viewer Filtering Utility
+ * Removes other signers' fields from PDF for viewer display
+ * Based on Dockmaster's field removal logic (lines 977-1037)
+ */
+import type { EsignFormField, MultiSignerContext } from '../types';
+/**
+ * Filter PDF for current signer by removing other signers' fields
+ * This creates a modified PDF for the viewer while preserving the original
+ *
+ * @param pdfBytes - Original PDF bytes with ALL fields
+ * @param allFields - All form fields extracted from the PDF
+ * @param multiSignerContext - Multi-signer context
+ * @returns Modified PDF bytes with other signers' fields removed (for viewer only)
+ *
+ * @example
+ * ```ts
+ * const originalPdfBytes = await urlToPdfBytes(pdfUrl);
+ * const allFields = await extractFormFields(originalPdfBytes);
+ *
+ * if (multiSignerContext.isMultiSigner) {
+ *   // Create filtered PDF for viewer
+ *   const viewerPdfBytes = await filterPdfForCurrentSigner(
+ *     originalPdfBytes,
+ *     allFields,
+ *     multiSignerContext
+ *   );
+ *   loadPdfIntoViewer(viewerPdfBytes);
+ *
+ *   // CRITICAL: Keep originalPdfBytes for submission
+ * }
+ * ```
+ */
+export declare function filterPdfForCurrentSigner(pdfBytes: Uint8Array, allFields: EsignFormField[], multiSignerContext: MultiSignerContext): Promise<Uint8Array>;
+//# sourceMappingURL=pdf-viewer-filter.d.ts.map

package/dist/utils/pdf-viewer-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-viewer-filter.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-viewer-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AA6LnE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,cAAc,EAAE,EAC3B,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAAC,UAAU,CAAC,CA6GrB"}

package/dist/utils/pdf-widget-helpers.d.ts

@@ -0,0 +1,98 @@
+/**
+ * PDF Widget Helper Utilities
+ * Common utilities for working with PDF widgets and pages
+ *
+ * Used across pdf-manipulation.ts and pdf-viewer-filter.ts
+ */
+import type { PDFPage } from 'pdf-lib';
+/**
+ * Find the page index for a given page reference
+ *
+ * This is a common pattern used when working with PDF widgets to determine
+ * which page a widget belongs to by comparing page references.
+ *
+ * @param pages - Array of PDF pages
+ * @param pageRef - The page reference to search for
+ * @returns Page index (0-based), or -1 if not found
+ *
+ * @example
+ * ```ts
+ * const widget = widgets[0];
+ * const pageRef = widget.P?.();
+ * const pageIndex = findPageIndexByRef(pages, pageRef);
+ * if (pageIndex >= 0) {
+ *   const page = pages[pageIndex];
+ *   // Draw on the page
+ * }
+ * ```
+ */
+export declare function findPageIndexByRef(pages: PDFPage[], pageRef: unknown): number;
+/**
+ * Extended type for PDF widgets with rectangle and page methods
+ */
+export interface PDFWidgetWithExtensions {
+    getRectangle?: () => {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+    P?: () => unknown;
+}
+/**
+ * Get widget rectangle and its page
+ *
+ * Helper to extract both the rectangle coordinates and the page that a widget
+ * belongs to in a single operation.
+ *
+ * @param widget - The PDF widget
+ * @param pages - Array of PDF pages
+ * @returns Object with rect, page, and pageIndex, or null if unable to determine
+ *
+ * @example
+ * ```ts
+ * for (const widget of widgets) {
+ *   const result = getWidgetRectangleAndPage(widget, pages);
+ *   if (result) {
+ *     const { rect, page, pageIndex } = result;
+ *     // Draw something at rect coordinates on page
+ *     page.drawRectangle({ x: rect.x, y: rect.y, ... });
+ *   }
+ * }
+ * ```
+ */
+export declare function getWidgetRectangleAndPage(widget: PDFWidgetWithExtensions, pages: PDFPage[]): {
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    page: PDFPage;
+    pageIndex: number;
+} | null;
+/**
+ * Find page index with fallback to single-page PDFs
+ *
+ * Same as findPageIndexByRef but with a fallback: if pageRef lookup fails
+ * and there's only one page in the document, returns index 0.
+ *
+ * This is useful for label drawing where single-page PDFs might not have
+ * proper page references but we can safely assume page 0.
+ *
+ * @param pages - Array of PDF pages
+ * @param pageRef - The page reference to search for
+ * @returns Page index (0-based), 0 if single-page PDF, or -1 if not found
+ *
+ * @example
+ * ```ts
+ * // Used in pdf-viewer-filter for label drawing
+ * const pageIndex = findPageIndexWithFallback(pages, pageRef);
+ * if (pageIndex >= 0) {
+ *   const page = pages[pageIndex];
+ *   page.drawText(label, ...);
+ * }
+ * ```
+ */
+export declare function findPageIndexWithFallback(pages: PDFPage[], pageRef: unknown): number;
+//# sourceMappingURL=pdf-widget-helpers.d.ts.map

package/dist/utils/pdf-widget-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-widget-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-widget-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAUvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,EAAE,OAAO,GACf,MAAM,CAWR;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzF,CAAC,CAAC,EAAE,MAAM,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE,OAAO,EAAE,GACf;IACD,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAcP;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,EAAE,OAAO,GACf,MAAM,CAcR"}

package/dist/utils/pdfjs-config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * PDF.js Configuration Provider
+ * Manages global configuration for PDF.js worker and viewer paths
+ *
+ * COMPATIBILITY NOTE: This module is designed to work with both Vite and Next.js/webpack.
+ * The worker source URL is computed lazily to avoid issues with webpack's handling of import.meta.
+ */
+import type { PdfJsConfig } from '../types';
+/**
+ * CDN paths for PDF.js (exported for manual fallback configuration)
+ * Note: CDN URLs may cause CORS issues in some environments
+ *
+ * @example
+ * // Manually configure CDN (not recommended)
+ * setPdfJsConfig({
+ *   viewerBasePath: CDN_VIEWER,
+ *   workerSrc: CDN_WORKER
+ * });
+ */
+export declare const CDN_WORKER = "https://cdn.jsdelivr.net/npm/pdfjs-dist@5.3.93/build/pdf.worker.mjs";
+export declare const CDN_VIEWER = "https://mozilla.github.io/pdf.js";
+/**
+ * Set PDF.js configuration
+ * @param config - Partial configuration to merge with defaults
+ *
+ * @example
+ * // Use self-hosted PDF.js files
+ * setPdfJsConfig({ viewerBasePath: '/pdfjs' });
+ *
+ * @example
+ * // Use custom CDN
+ * setPdfJsConfig({
+ *   viewerBasePath: 'https://my-cdn.com/pdfjs',
+ *   workerSrc: 'https://my-cdn.com/pdfjs/build/pdf.worker.mjs'
+ * });
+ */
+export declare function setPdfJsConfig(config: Partial<PdfJsConfig>): void;
+/**
+ * Get current PDF.js configuration
+ * @returns Current configuration
+ */
+export declare function getPdfJsConfig(): Required<PdfJsConfig>;
+/**
+ * Reset configuration to defaults (local files)
+ */
+export declare function resetPdfJsConfig(): void;
+/**
+ * Initialize PDF.js configuration
+ * This is called automatically when the first PDF operation is attempted,
+ * but can also be called manually to pre-initialize the configuration.
+ *
+ * Unlike previous versions, this does NOT run at module load time to
+ * ensure compatibility with Next.js/webpack environments.
+ */
+export declare function initializePdfJs(): void;
+//# sourceMappingURL=pdfjs-config.d.ts.map

package/dist/utils/pdfjs-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfjs-config.d.ts","sourceRoot":"","sources":["../../src/utils/pdfjs-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,wEAAwE,CAAC;AAChG,eAAO,MAAM,UAAU,qCAAqC,CAAC;AA4F7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAmBjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAAC,WAAW,CAAC,CAItD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/utils/pdfjs-version-check.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PDF.js Version Check Utility
+ * Detects version mismatches between viewer and worker
+ */
+export interface PdfJsVersionCheckResult {
+    viewerExists: boolean;
+    versionMatch: boolean;
+    viewerVersion?: string;
+    workerVersion: string;
+    errorMessage?: string;
+}
+/**
+ * Check if PDF.js viewer files exist and versions match
+ * @param viewerBasePath - Base path for the viewer (e.g., '/pdfjs')
+ * @returns Version check result
+ */
+export declare function checkPdfJsVersion(viewerBasePath?: string): Promise<PdfJsVersionCheckResult>;
+/**
+ * Log version check warnings to console
+ * @param result - Version check result
+ */
+export declare function logVersionCheckWarning(result: PdfJsVersionCheckResult): void;
+/**
+ * Check version and log warnings automatically
+ * @param viewerBasePath - Base path for the viewer
+ */
+export declare function checkAndLogPdfJsVersion(viewerBasePath?: string): Promise<PdfJsVersionCheckResult>;
+//# sourceMappingURL=pdfjs-version-check.d.ts.map

package/dist/utils/pdfjs-version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfjs-version-check.d.ts","sourceRoot":"","sources":["../../src/utils/pdfjs-version-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,GAAE,MAAiB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA4ClC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAgB5E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,GAAE,MAAiB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAQlC"}