@signiphi/pdf-signer 0.2.0-beta.21 → 0.2.0-beta.22

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

@@ -0,0 +1,94 @@
+/**
+ * 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, // Deprecated: use multiSignerContext.currentSignerEmail instead
+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-metadata.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PDF Metadata Utilities
+ * Functions for storing and retrieving Signiphi metadata in PDF documents
+ */
+import type { PDFDocument } from 'pdf-lib';
+import { Acknowledgement } from '../types';
+/**
+ * Initialize PDF classes from dynamically loaded pdf-lib module
+ * Must be called before using getSigniphiMetadata or setSigniphiMetadata
+ */
+export declare function initPdfMetadata(pdfLibModule: any): void;
+/**
+ * Metadata for a single form field
+ */
+export interface FieldMetadata {
+    fieldId?: string;
+    label?: string;
+    signer?: string;
+    placeholder?: string;
+    acknowledgements?: Acknowledgement[];
+    required?: boolean;
+    options?: string[];
+}
+/**
+ * Complete metadata structure stored in PDF
+ */
+export interface SigniphiMetadata {
+    version: string;
+    fields: Record<string, FieldMetadata>;
+    fieldIdIndex?: Record<string, string>;
+}
+/**
+ * Stores Signiphi metadata in the PDF's document information dictionary
+ * @param pdfDoc - The PDF document to store metadata in
+ * @param metadata - The metadata object to store
+ */
+export declare function setSigniphiMetadata(pdfDoc: PDFDocument, metadata: SigniphiMetadata): void;
+/**
+ * Retrieves Signiphi metadata from the PDF's document information dictionary
+ * @param pdfDoc - The PDF document to read metadata from
+ * @returns The metadata object if found, null otherwise
+ */
+export declare function getSigniphiMetadata(pdfDoc: PDFDocument): SigniphiMetadata | null;
+//# sourceMappingURL=pdf-metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAsD,MAAM,SAAS,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI,CAGvD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAqBzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,GAAG,IAAI,CA2ChF"}

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

@@ -0,0 +1,35 @@
+/**
+ * PDF Signer Utilities for Multi-Signer Document Preparation
+ * Adapted from dm-web-frontend for signiphi's simpler signer model
+ */
+import { FormField, Signer } from '../types';
+export interface PrepareSignerPdfOptions {
+    activeSignerEmail: string;
+    completedSignerEmails?: string[];
+    hideMode?: 'Hidden' | 'NoView';
+    lockCompletedFields?: boolean;
+    allSignerEmails?: string[];
+}
+/**
+ * Prepare a PDF document for a specific signer by hiding/showing fields and locking completed ones
+ * Adapted for signiphi: simplified logic without role checks
+ */
+export declare function preparePdfForSigner(inputPdfBytes: Uint8Array | ArrayBuffer, formFields: FormField[], options: PrepareSignerPdfOptions): Promise<Uint8Array>;
+/**
+ * Check if all signers have completed their fields
+ */
+export declare function areAllSignersComplete(signers: Signer[], completedSignerEmails: string[]): boolean;
+/**
+ * Get next signer in the sequence who hasn't completed their fields
+ * In signiphi, signers are ordered by signOrder (1, 2, 3...)
+ */
+export declare function getNextSigner(signers: Signer[], completedSignerEmails: string[]): Signer | null;
+/**
+ * Validate field assignments for multiple signers
+ * Adapted for signiphi's flat signer model
+ */
+export declare function validateFieldAssignments(formFields: FormField[], signers: Signer[]): {
+    isValid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=pdf-signer-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-signer-utils.d.ts","sourceRoot":"","sources":["../../src/utils/pdf-signer-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAiB,MAAM,EAAE,MAAM,UAAU,CAAC;AAG5D,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAyCD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,UAAU,GAAG,WAAW,EACvC,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CA0MrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,qBAAqB,EAAE,MAAM,EAAE,GAC9B,OAAO,CAYT;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EAAE,EACjB,qBAAqB,EAAE,MAAM,EAAE,GAC9B,MAAM,GAAG,IAAI,CAaf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE,MAAM,EAAE,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuCxC"}

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

@@ -0,0 +1,184 @@
+/**
+ * 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 include:
+ * - Simple type names: "Text", "Signature", etc.
+ * - Type + timestamp: "Dropdown 12413423423", "Text 1768236803505"
+ * - Pure timestamps: "12413423423"
+ * - Type + numbers: "Dropdown1", "Text_2"
+ *
+ * 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('Dropdown 12413423423') // true
+ * isAutoGeneratedLabel('Sign here please') // false
+ * isAutoGeneratedLabel('') // true
+ * ```
+ */
+export declare function isAutoGeneratedLabel(label: string): boolean;
+/**
+ * Check if a field has a drawable label (user-set custom label that should be rendered on the PDF)
+ *
+ * Returns false when:
+ * - Label is empty or whitespace
+ * - Label was auto-generated from field name during extraction (isLabelAutoGenerated flag)
+ * - Label matches known auto-generated patterns (e.g., "Text", "Signature 1")
+ *
+ * @param field - Object with label and optional isLabelAutoGenerated flag
+ * @returns true if the label should be drawn on the PDF
+ */
+export declare function hasDrawableLabel(field: {
+    label?: string;
+    isLabelAutoGenerated?: boolean;
+}): boolean;
+/**
+ * Get a user-friendly display name for a field
+ *
+ * If the label is meaningful (not auto-generated), returns the label.
+ * Otherwise, returns a clean field type name.
+ *
+ * @param field - Object with label and type properties
+ * @returns A user-friendly name for display in error messages
+ */
+export declare function getFieldDisplayName(field: {
+    label?: string;
+    type?: string;
+    name?: string;
+}): string;
+/**
+ * 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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAqD3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAKnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAyCnG;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;AA6OnE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,cAAc,EAAE,EAC3B,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAAC,UAAU,CAAC,CA8GrB"}

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"}