@signiphi/pdf-signer 0.1.1

package/dist/hooks/useAttachments.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hook for managing file attachments
+ * Handles file uploads, validation, and state management
+ */
+import type { Attachment, AttachmentConstraints, AttachmentValidationResult } from '../types';
+export interface UseAttachmentsOptions {
+    constraints?: Partial<AttachmentConstraints>;
+    onError?: (errors: string[]) => void;
+}
+export declare function useAttachments(options?: UseAttachmentsOptions): {
+    attachments: Attachment[];
+    isUploading: boolean;
+    validationErrors: string[];
+    constraints: AttachmentConstraints;
+    addFiles: (files: File[] | FileList) => Promise<{
+        added: number;
+        errors: string[];
+    }>;
+    removeAttachment: (attachmentId: string) => void;
+    clearAttachments: () => void;
+    getTotalSize: () => number;
+    formatSize: (bytes: number) => string;
+    validateAll: () => AttachmentValidationResult;
+};
+//# sourceMappingURL=useAttachments.d.ts.map

package/dist/hooks/useAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachments.d.ts","sourceRoot":"","sources":["../../src/hooks/useAttachments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,UAAU,CAAC;AA0BlB,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACtC;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B;;;;;sBAchD,IAAI,EAAE,GAAG,QAAQ;;;;qCAwEmB,MAAM;;;wBAuBnB,MAAM,KAAG,MAAM;uBAOlB,0BAA0B;EAsC/D"}

package/dist/hooks/useFieldFiltering.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hook for filtering form fields by signer with multi-signer support
+ * Implements Dockmaster's exact field visibility logic
+ */
+import type { EsignFormField, MultiSignerContext } from '../types';
+/**
+ * Hook for filtering form fields based on multi-signer context
+ *
+ * @param allFields - All form fields extracted from the PDF
+ * @param multiSignerContext - Multi-signer context (from useMultiSignerContext)
+ * @returns Filtered fields and utility functions
+ *
+ * @example
+ * ```tsx
+ * const context = useMultiSignerContext(currentSigner, isMultipleSignature, totalSigners);
+ * const { filteredFields } = useFieldFiltering(allFields, context);
+ * ```
+ */
+export declare function useFieldFiltering(allFields: EsignFormField[], multiSignerContext: MultiSignerContext): {
+    filteredFields: import("..").FormField[];
+    requiredFields: import("..").FormField[];
+    optionalFields: import("..").FormField[];
+    isFieldVisible: (field: EsignFormField) => boolean;
+    totalFields: number;
+    filteredCount: number;
+    requiredCount: number;
+    optionalCount: number;
+};
+//# sourceMappingURL=useFieldFiltering.d.ts.map

package/dist/hooks/useFieldFiltering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldFiltering.d.ts","sourceRoot":"","sources":["../../src/hooks/useFieldFiltering.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,cAAc,EAAE,EAC3B,kBAAkB,EAAE,kBAAkB;;;;4BA4CP,cAAc,KAAG,OAAO;;;;;EAmBxD"}

package/dist/hooks/useFormFields.d.ts

@@ -0,0 +1,23 @@
+import type { FormField, ValidationError } from '../types';
+/**
+ * Hook to manage form field state and validation
+ */
+export declare function useFormFields(fields?: FormField[]): {
+    fieldValues: Record<string, string>;
+    errors: ValidationError[];
+    hasErrors: boolean;
+    touched: Record<string, boolean>;
+    updateField: (fieldId: string, value: string) => void;
+    updateMultipleFields: (values: Record<string, string>) => void;
+    validateField: (fieldId: string) => boolean;
+    validateFields: (signatures?: Record<string, string>) => boolean;
+    resetFields: () => void;
+    resetValidation: () => void;
+    getFieldValue: (fieldId: string) => string;
+    getFieldError: (fieldId: string) => string | undefined;
+    isFieldTouched: (fieldId: string) => boolean;
+    setFieldValue: (fieldId: string, value: string) => void;
+    setMultipleFieldValues: (values: Record<string, string>) => void;
+    clearFields: () => void;
+};
+//# sourceMappingURL=useFormFields.d.ts.map

package/dist/hooks/useFormFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFields.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormFields.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAiB,MAAM,UAAU,CAAC;AAG1E;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,SAAS,EAAO;;;;;2BAKV,MAAM,SAAS,MAAM;mCAcb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;6BAoB5D,MAAM;kCAyCF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;6BA+D1B,MAAM;6BAON,MAAM;8BAQN,MAAM;6BAzJwB,MAAM,SAAS,MAAM;qCAcb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;EA0KzE"}

package/dist/hooks/useMultiSignerContext.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hook for managing multi-signer context and determining signer roles
+ */
+import type { Signer, MultiSignerContext } from '../types';
+/**
+ * Calculate multi-signer context from simplified props
+ *
+ * @param currentSigner - The signer who is currently viewing/signing (if multi-signer)
+ * @param isMultipleSignature - Whether this is a multi-signer document
+ * @param totalSigners - Total number of signers (for determining if current is final)
+ * @returns MultiSignerContext with calculated roles and flags
+ *
+ * @example
+ * ```tsx
+ * const context = useMultiSignerContext(
+ *   { id: '1', email: 'user@example.com', name: 'John', signOrder: 1, status: 'pending' },
+ *   true,
+ *   3
+ * );
+ * // context.isPrimarySigner === true (signOrder === 1)
+ * // context.isFinalSigner === false (signOrder !== totalSigners)
+ * ```
+ */
+export declare function useMultiSignerContext(currentSigner?: Signer, isMultipleSignature?: boolean, totalSigners?: number): MultiSignerContext;
+//# sourceMappingURL=useMultiSignerContext.d.ts.map

package/dist/hooks/useMultiSignerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMultiSignerContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useMultiSignerContext.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,CAAC,EAAE,MAAM,EACtB,mBAAmB,CAAC,EAAE,OAAO,EAC7B,YAAY,CAAC,EAAE,MAAM,GACpB,kBAAkB,CA+BpB"}

package/dist/hooks/usePdfViewer.d.ts

@@ -0,0 +1,52 @@
+import type { PdfViewerRef, EsignFormField, MultiSignerContext } from '../types';
+/**
+ * Hook to manage PDF viewer state and operations with multi-signer support
+ *
+ * @param multiSignerContext - Multi-signer context (from useMultiSignerContext)
+ */
+export declare function usePdfViewer(multiSignerContext?: MultiSignerContext): {
+    viewerRef: import("react").RefObject<PdfViewerRef>;
+    isLoading: boolean;
+    error: string | null;
+    isLoaded: boolean;
+    pdfUrl: string | null;
+    pdfBytes: Uint8Array<ArrayBufferLike> | null;
+    extractedFields: import("..").FormField[];
+    loadPdf: (url: string) => Promise<void>;
+    handleLoad: () => void;
+    handleError: (errorMessage: string) => void;
+    getFormFieldValues: () => Promise<Record<string, string>>;
+    setFormFieldValues: (values: Record<string, string>) => Promise<void>;
+    getAllFieldNames: () => Promise<string[]>;
+    saveDocument: () => Promise<Uint8Array<ArrayBufferLike> | null>;
+    extractFormFields: (currentSignerEmail?: string) => Promise<import("..").FormField[]>;
+    fillPdf: (fieldValues: Record<string, string>, signatures: Record<string, string>, currentSignerEmail?: string, 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;
+        };
+    }) => Promise<Uint8Array>;
+    validatePdf: (fieldValues: Record<string, string>, signatures: Record<string, string>, visibleFields?: EsignFormField[]) => Promise<{
+        isValid: boolean;
+        errors: string[];
+    }>;
+    getRequiredFieldsMap: () => Promise<Record<string, boolean>>;
+    getCurrentPdfBytes: () => Uint8Array<ArrayBufferLike> | null;
+    reloadPdfWithBytes: (newPdfBytes: Uint8Array) => Promise<void>;
+    reset: () => void;
+};
+//# sourceMappingURL=usePdfViewer.d.ts.map

package/dist/hooks/usePdfViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfViewer.d.ts","sourceRoot":"","sources":["../../src/hooks/usePdfViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAkBjF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,kBAAkB,CAAC,EAAE,kBAAkB;;;;;;;;mBAeC,MAAM;;gCAyCC,MAAM;;iCAaC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;6CA0B9C,MAAM;2BA6EnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,uBACb,MAAM,aAChB;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,IAAI,CAAA;KAAE,eAC9H;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KACpN,OAAO,CAAC,UAAU,CAAC;+BA4CP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,kBAClB,cAAc,EAAE,KAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;gCA+BD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;sCAoC7D,UAAU;;EA6DjC"}

package/dist/hooks/useSignatureCapture.d.ts

@@ -0,0 +1,17 @@
+import type { SignatureCanvasRef } from '../types';
+/**
+ * Hook to manage signature capture state and operations
+ */
+export declare function useSignatureCapture(): {
+    canvasRef: import("react").RefObject<SignatureCanvasRef>;
+    signatureDataUrl: string | null;
+    uploadedImage: string | null;
+    uploadError: string | null;
+    clear: () => void;
+    saveSignature: () => string | null;
+    isEmpty: () => boolean;
+    handleFileUpload: (file: File) => void;
+    clearUpload: () => void;
+    reset: () => void;
+};
+//# sourceMappingURL=useSignatureCapture.d.ts.map

package/dist/hooks/useSignatureCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSignatureCapture.d.ts","sourceRoot":"","sources":["../../src/hooks/useSignatureCapture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,wBAAgB,mBAAmB;;;;;;;;6BAwBW,IAAI;;;EAsDjD"}

package/dist/hooks/useSignatures.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hook to manage signature and initials state
+ */
+import type { FormField } from '../types';
+export interface SignatureData {
+    [fieldId: string]: string;
+}
+/**
+ * Hook for managing signatures and initials
+ */
+export declare function useSignatures(): {
+    signatures: SignatureData;
+    setSignature: (fieldId: string, dataUrl: string) => void;
+    clearSignature: (fieldId: string) => void;
+    clearAllSignatures: () => void;
+    hasSignature: (fieldId: string) => boolean;
+    getSignature: (fieldId: string) => string | null;
+    validateSignatures: (fields: FormField[], currentSignatures?: SignatureData) => {
+        isValid: boolean;
+        errors: string[];
+    };
+    signatureCount: number;
+    hasAnySignatures: boolean;
+};
+//# sourceMappingURL=useSignatures.d.ts.map

package/dist/hooks/useSignatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSignatures.d.ts","sourceRoot":"","sources":["../../src/hooks/useSignatures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa;;4BAMgB,MAAM,WAAW,MAAM;8BAUrB,MAAM;;4BAmBvC,MAAM;4BAUN,MAAM;iCAUP,SAAS,EAAE,sBAAsB,aAAa;;;;;;EAyC1D"}