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

package/dist/utils/date-validation.d.ts

@@ -1,30 +0,0 @@
-/**
- * Date Validation and Parsing Utility
- * Handles parsing of various date formats and validation
- */
-export interface DateValidationResult {
-    isValid: boolean;
-    date: Date | null;
-    isoString: string | null;
-    originalValue: string;
-    error?: string;
-}
-/**
- * Parse and validate a date string from various formats
- * Attempts to parse common formats: ISO, US, EU, timestamps
- *
- * Format priority:
- * 1. ISO 8601 (YYYY-MM-DD)
- * 2. US format (MM/DD/YYYY) - assumes US format for ambiguous dates
- * 3. EU format (DD/MM/YYYY)
- * 4. Timestamp (numeric string)
- *
- * @param value - The date string to parse
- * @returns Validation result with parsed date or error
- */
-export declare function parseAndValidateDate(value: string | null | undefined): DateValidationResult;
-/**
- * Validate if a string is a valid ISO date (YYYY-MM-DD)
- */
-export declare function isValidISODate(value: string | null | undefined): boolean;
-//# sourceMappingURL=date-validation.d.ts.map

package/dist/utils/date-validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"date-validation.d.ts","sourceRoot":"","sources":["../../src/utils/date-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,CAoJ3F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAgBxE"}

package/dist/utils/errors.d.ts

@@ -1,106 +0,0 @@
-/**
- * Custom Error Classes
- * Domain-specific error types for better error handling and debugging
- */
-/**
- * Error thrown when PDF validation fails
- *
- * @example
- * ```ts
- * const validation = validatePdfBytes(bytes);
- * if (!validation.valid) {
- *   throw new PdfValidationError(validation.error || 'Invalid PDF');
- * }
- * ```
- */
-export declare class PdfValidationError extends Error {
-    readonly details?: unknown | undefined;
-    constructor(message: string, details?: unknown | undefined);
-}
-/**
- * Error thrown during PDF processing operations
- *
- * @example
- * ```ts
- * try {
- *   const pdfDoc = await PDFDocument.load(bytes);
- * } catch (err) {
- *   throw new PdfProcessingError('Failed to load PDF document', err);
- * }
- * ```
- */
-export declare class PdfProcessingError extends Error {
-    readonly details?: unknown | undefined;
-    constructor(message: string, details?: unknown | undefined);
-}
-/**
- * Error thrown for form field related issues
- *
- * @example
- * ```ts
- * if (!field.value && field.required) {
- *   throw new FormFieldError(
- *     'Required field is empty',
- *     field.name
- *   );
- * }
- * ```
- */
-export declare class FormFieldError extends Error {
-    readonly fieldName?: string | undefined;
-    readonly details?: unknown | undefined;
-    constructor(message: string, fieldName?: string | undefined, details?: unknown | undefined);
-}
-/**
- * Error thrown for attachment validation failures
- *
- * @example
- * ```ts
- * if (file.size > maxFileSize) {
- *   throw new AttachmentValidationError(
- *     `File size exceeds limit: ${file.name}`,
- *     file.name
- *   );
- * }
- * ```
- */
-export declare class AttachmentValidationError extends Error {
-    readonly fileName?: string | undefined;
-    readonly details?: unknown | undefined;
-    constructor(message: string, fileName?: string | undefined, details?: unknown | undefined);
-}
-/**
- * Type guard to check if an error is a PdfValidationError
- */
-export declare function isPdfValidationError(error: unknown): error is PdfValidationError;
-/**
- * Type guard to check if an error is a PdfProcessingError
- */
-export declare function isPdfProcessingError(error: unknown): error is PdfProcessingError;
-/**
- * Type guard to check if an error is a FormFieldError
- */
-export declare function isFormFieldError(error: unknown): error is FormFieldError;
-/**
- * Type guard to check if an error is an AttachmentValidationError
- */
-export declare function isAttachmentValidationError(error: unknown): error is AttachmentValidationError;
-/**
- * Extract error message from unknown error type
- *
- * @param error - The error to extract message from
- * @param defaultMessage - Default message if extraction fails
- * @returns Error message string
- *
- * @example
- * ```ts
- * try {
- *   // ... operation
- * } catch (err) {
- *   const message = getErrorMessage(err, 'Operation failed');
- *   logger.error(message);
- * }
- * ```
- */
-export declare function getErrorMessage(error: unknown, defaultMessage?: string): string;
-//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,OAAO,CAAC,EAAE,OAAO;gBADjC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CASpC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,OAAO,CAAC,EAAE,OAAO;gBADjC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;CAQpC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,SAAS,CAAC,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,OAAO,CAAC,EAAE,OAAO,YAAA;CAQpC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aAGhC,QAAQ,CAAC,EAAE,MAAM;aACjB,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,OAAO,CAAC,EAAE,OAAO,YAAA;CAQpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAE9F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,SAAkB,GAAG,MAAM,CAQxF"}

package/dist/utils/field-extraction.d.ts

@@ -1,36 +0,0 @@
-/**
- * PDF Form Field Extraction Utilities
- * Functions for extracting and decoding form fields from PDFs
- */
-import { EsignFormField, FormFieldType } from '../types';
-/**
- * Extract visible form fields from a PDF document
- * @param pdfBytes - The PDF bytes to extract fields from
- * @param currentSignerEmail - Optional email of the current signer (for multi-signer filtering)
- * @returns Array of extracted form fields
- */
-export declare function extractVisibleFormFields(pdfBytes: Uint8Array, currentSignerEmail?: string): Promise<EsignFormField[]>;
-/**
- * Decode a field name to extract label, signer email, and placeholder
- * Format: fieldName__LABEL__labelText__SIGNER__email__PLACEHOLDER__placeholderText
- *
- * @deprecated This function is deprecated and kept only for backward compatibility with old PDFs.
- * New PDFs store metadata in the PDF's document information dictionary instead of encoding it in field names.
- * Use getSigniphiMetadata() for new PDFs.
- */
-export declare function decodeFieldName(fieldName: string): {
-    decodedFieldName: string;
-    displayLabel: string;
-    assignedSignerEmail?: string;
-    fieldPlaceholder: string;
-    acknowledgements?: Array<{
-        id: string;
-        title: string;
-        description: string;
-    }>;
-};
-/**
- * Generate a fallback label from a decoded field name
- */
-export declare function generateFallbackLabel(decodedFieldName: string, fieldType: FormFieldType): string;
-//# sourceMappingURL=field-extraction.d.ts.map

package/dist/utils/field-extraction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-extraction.d.ts","sourceRoot":"","sources":["../../src/utils/field-extraction.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAwBzD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,UAAU,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAgN3B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAC5E,CAmFA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAgChG"}

package/dist/utils/field-visibility.d.ts

@@ -1,104 +0,0 @@
-/**
- * Field Visibility Utilities
- * Core logic for determining which fields are visible/editable in multi-signer mode
- *
- * CRITICAL: This logic must work identically in both flows:
- * - Single-signer flow: isMultiSigner = false, all fields visible
- * - Multi-signer flow: isMultiSigner = true, filtered by assignment rules
- */
-import type { EsignFormField, MultiSignerContext } from '../types';
-/**
- * Determine if a field should be visible to the current signer
- *
- * Implements the 5-rule visibility logic used throughout the application:
- * - Rule 1: Unassigned fields → only final signer sees them
- * - Rule 2: Direct assignment → show if assigned to current signer
- * - Rule 3: Recipients group → only primary signers (signOrder === 1)
- * - Rule 4: Signers group → only final signer
- * - Rule 5: Assigned to different signer → hide
- *
- * @param field - The form field to check
- * @param multiSignerContext - Multi-signer context with current signer info
- * @returns true if field should be visible, false if hidden
- *
- * @example Single-signer flow
- * ```ts
- * const context = { isMultiSigner: false, ... };
- * isFieldVisibleToSigner(anyField, context); // always returns true
- * ```
- *
- * @example Multi-signer flow
- * ```ts
- * const context = {
- *   isMultiSigner: true,
- *   currentSignerEmail: 'signer1@example.com',
- *   isPrimarySigner: true,
- *   isFinalSigner: false
- * };
- *
- * // Unassigned field - only final signer sees it
- * isFieldVisibleToSigner({ assignedSignerEmail: undefined, ... }, context); // false
- *
- * // Direct assignment to current signer
- * isFieldVisibleToSigner({ assignedSignerEmail: 'signer1@example.com', ... }, context); // true
- *
- * // Recipients group - primary signer sees it
- * isFieldVisibleToSigner({ assignedSignerEmail: 'recipients', ... }, context); // true
- * ```
- */
-export declare function isFieldVisibleToSigner(field: EsignFormField, multiSignerContext: MultiSignerContext): boolean;
-/**
- * Filter an array of fields to only those visible to the current signer
- *
- * @param fields - All form fields
- * @param multiSignerContext - Multi-signer context
- * @returns Filtered array of visible fields
- *
- * @example
- * ```ts
- * const allFields = [...]; // 10 fields
- * const context = { isMultiSigner: true, isPrimarySigner: true, ... };
- * const visible = filterFieldsBySigner(allFields, context); // 5 fields (only primary signer's)
- * ```
- */
-export declare function filterFieldsBySigner(fields: EsignFormField[], multiSignerContext: MultiSignerContext): EsignFormField[];
-/**
- * Determine if a field should be flattened (made non-editable) by the current signer
- *
- * Used during PDF submission to determine which fields to flatten.
- * In multi-signer mode, only flatten fields assigned to current signer.
- * In single-signer mode, flatten all fields.
- *
- * CRITICAL: This affects PDF flattening behavior - must preserve exact logic!
- *
- * @param field - The form field to check
- * @param multiSignerContext - Multi-signer context
- * @returns true if current signer should flatten this field
- *
- * @example Single-signer flow
- * ```ts
- * const context = { isMultiSigner: false, ... };
- * shouldFlattenField(anyField, context); // always returns true
- * ```
- *
- * @example Multi-signer flow
- * ```ts
- * const context = {
- *   isMultiSigner: true,
- *   currentSignerEmail: 'signer1@example.com',
- *   isPrimarySigner: true,
- *   isFinalSigner: false
- * };
- *
- * // Current signer's field - flatten it
- * shouldFlattenField({ assignedSignerEmail: 'signer1@example.com', ... }, context); // true
- *
- * // Different signer's field - don't flatten (keep editable for them)
- * shouldFlattenField({ assignedSignerEmail: 'signer2@example.com', ... }, context); // false
- *
- * // Unassigned field - only final signer flattens
- * shouldFlattenField({ assignedSignerEmail: undefined, ... }, context); // false (not final)
- * ```
- */
-export declare function shouldFlattenField(field: EsignFormField, multiSignerContext: MultiSignerContext): boolean;
-//# sourceMappingURL=field-visibility.d.ts.map

package/dist/utils/field-visibility.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-visibility.d.ts","sourceRoot":"","sources":["../../src/utils/field-visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CA8BT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EAAE,EACxB,kBAAkB,EAAE,kBAAkB,GACrC,cAAc,EAAE,CAQlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CA8BT"}

package/dist/utils/index.d.ts

@@ -1,18 +0,0 @@
-export * from './pdf-helpers';
-export * from './pdf-metadata';
-export * from './pdf-manipulation';
-export * from './field-extraction';
-export * from './pdfjs-config';
-export * from './pdfjs-version-check';
-export * from './audit-trail';
-export * from './pdf-validators';
-export * from './field-visibility';
-export * from './pdf-widget-helpers';
-export * from './pdf-field-type-helpers';
-export * from './errors';
-export * from './attachment-validators';
-export { logger } from './logger';
-export * from './performance-monitor';
-export * from './date-validation';
-export * from './tracking';
-//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/utils/logger.d.ts

@@ -1,16 +0,0 @@
-/**
- * Logger Utility
- * Centralized logging system with environment-based log level control
- */
-interface Logger {
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-}
-/**
- * Singleton logger instance
- */
-export declare const logger: Logger;
-export {};
-//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,MAAM;IACd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAgDD;;GAEG;AACH,eAAO,MAAM,MAAM,QAAiB,CAAC"}

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

@@ -1,78 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,38 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,45 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,93 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,41 +0,0 @@
-/**
- * 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[];
-}
-/**
- * Complete metadata structure stored in PDF
- */
-export interface SigniphiMetadata {
-    version: string;
-    fields: Record<string, FieldMetadata>;
-}
-/**
- * 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

@@ -1 +0,0 @@
-{"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;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,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"}