@signiphi/pdf-signer 0.1.1

package/dist/types/index.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Form field types supported by the PDF signer
+ */
+export declare enum FormFieldType {
+    TEXT = "text",
+    SIGNATURE = "signature",
+    INITIALS = "initials",
+    DATE = "date",
+    CHECKBOX = "checkbox",
+    RADIO = "radio",
+    DROPDOWN = "dropdown",
+    TEXT_LABEL = "text_label"
+}
+/**
+ * Position and dimensions of a form field on a PDF page
+ */
+export interface FormFieldPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    page: number;
+}
+/**
+ * Form field definition with all properties
+ */
+export interface FormField {
+    id: string;
+    type: FormFieldType;
+    name: string;
+    label: string;
+    position: FormFieldPosition;
+    required: boolean;
+    placeholder?: string;
+    options?: string[];
+    radioPositions?: FormFieldPosition[];
+    defaultValue?: string;
+    value?: string;
+    fontSize?: number;
+    multiline?: boolean;
+    maxLength?: number;
+    assignedSignerEmail?: string;
+    assignedSignerRole?: string;
+    visibleToOthers?: boolean;
+}
+/**
+ * PDF page information with rendered image
+ */
+export interface PdfPage {
+    pageNumber: number;
+    width: number;
+    height: number;
+    imageUrl: string;
+    renderWidth?: number;
+    renderHeight?: number;
+}
+/**
+ * PDF viewer application interface (for PDF.js integration)
+ */
+export interface PDFViewerApplication {
+    initializedPromise?: Promise<void>;
+    pdfLoadingTask?: {
+        promise: Promise<void>;
+    };
+    pdfDocument?: {
+        annotationStorage?: {
+            serializable?: {
+                map?: Map<string, unknown>;
+            };
+            getAll?: () => Record<string, unknown>;
+            getValue?: (key: string) => unknown;
+            setValue?: (key: string, value: unknown) => void;
+        };
+        getFieldObjects?: () => Promise<Record<string, unknown[]>>;
+        saveDocument?: () => Promise<Uint8Array>;
+        getData?: () => Promise<Uint8Array>;
+    };
+    pdfViewer?: {
+        currentPageNumber?: number;
+        pagesCount?: number;
+        container?: HTMLElement;
+        update?: () => void;
+        increaseScale?: () => void;
+        decreaseScale?: () => void;
+        nextPage?: () => void;
+        previousPage?: () => void;
+    };
+}
+/**
+ * Configuration for PDF.js worker and viewer
+ */
+export interface PdfJsConfig {
+    workerSrc?: string;
+    viewerBasePath?: string;
+}
+/**
+ * Attachment metadata
+ */
+export interface Attachment {
+    id: string;
+    file: File;
+    name: string;
+    size: number;
+    type: string;
+    uploadedAt: Date;
+    preview?: string;
+}
+/**
+ * Attachment validation constraints
+ */
+export interface AttachmentConstraints {
+    maxFileSize: number;
+    maxTotalSize: number;
+    maxFiles: number;
+    allowedTypes: string[];
+    allowedExtensions?: string[];
+}
+/**
+ * Attachment validation result
+ */
+export interface AttachmentValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Audit trail metadata for compliance and forensics
+ */
+export interface AuditTrailMetadata {
+    userAgent?: string;
+    screenResolution?: string;
+    timezone?: string;
+    language?: string;
+    platform?: string;
+    ipAddress?: string;
+    geolocation?: {
+        latitude: number;
+        longitude: number;
+        accuracy?: number;
+    };
+}
+/**
+ * Document metadata for PDF properties
+ */
+export interface DocumentMetadata {
+    submissionId?: string;
+    documentId?: string;
+    author?: string;
+    signerEmail?: string;
+    signerInitials?: string;
+    createdAt?: Date;
+}
+/**
+ * Form submission data
+ */
+export interface SubmissionData {
+    formFieldValues: Record<string, string>;
+    signatures: Record<string, string>;
+    attachments?: Attachment[];
+    pdfBytes: Uint8Array;
+    auditTrail?: AuditTrailMetadata;
+    metadata?: DocumentMetadata;
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * PDF viewer ref methods
+ */
+export interface PdfViewerRef {
+    loadPdf: (pdfUrl: string) => Promise<void>;
+    getFormFieldValues: () => Promise<Record<string, string>>;
+    setFormFieldValues: (values: Record<string, string>) => Promise<void>;
+    getAllFieldNames: () => Promise<string[]>;
+    saveDocument: () => Promise<Uint8Array | null>;
+    getPDFViewerApplication: () => PDFViewerApplication | null;
+    injectPlaceholders: (fields: Array<{
+        id: string;
+        name: string;
+        placeholder?: string;
+    }>) => void;
+    zoomIn: () => Promise<void>;
+    zoomOut: () => Promise<void>;
+    nextPage: () => Promise<void>;
+    previousPage: () => Promise<void>;
+    getCurrentPage: () => Promise<number | null>;
+    getTotalPages: () => Promise<number | null>;
+}
+/**
+ * Signature canvas ref methods
+ */
+export interface SignatureCanvasRef {
+    clear: () => void;
+    getSignatureDataUrl: () => string | null;
+    isEmpty: () => boolean;
+}
+/**
+ * Signer information for multi-signer documents
+ */
+export interface Signer {
+    id: string;
+    email: string;
+    name: string;
+    signOrder: number;
+    status: 'pending' | 'viewed' | 'signed' | 'declined';
+    signedAt?: string;
+}
+/**
+ * Multi-signer context for determining field visibility and behavior
+ * Used internally by hooks and utilities to manage multi-signer logic
+ */
+export interface MultiSignerContext {
+    /** Whether this is a multi-signer document */
+    isMultiSigner: boolean;
+    /** Current signer object (null for single-signer mode) */
+    currentSigner: Signer | null;
+    /** Current signer's email address */
+    currentSignerEmail: string;
+    /** Whether current signer is a primary signer (signOrder === 1) */
+    isPrimarySigner: boolean;
+    /** Whether current signer is the final signer (signOrder === totalSigners) */
+    isFinalSigner: boolean;
+}
+/**
+ * Document submission
+ */
+export interface Submission {
+    id: string;
+    documentId: string;
+    status: 'pending' | 'signed' | 'declined' | 'expired';
+    createdAt: string;
+    updatedAt: string;
+    formFields?: FormField[];
+    pdfUrl?: string;
+    signedAt?: string;
+    declinedAt?: string;
+    expiresAt?: string;
+    isMultipleSignature?: boolean;
+    signers?: Signer[];
+}
+/**
+ * Type aliases for compatibility with dm-web-frontend naming conventions
+ */
+export type EsignFormField = FormField;
+export type EsignSigner = Signer;
+/**
+ * Submission status enum
+ */
+export declare enum SubmissionStatus {
+    PENDING = "pending",
+    SIGNED = "signed",
+    DECLINED = "declined",
+    EXPIRED = "expired"
+}
+/**
+ * Field error type for validation
+ */
+export interface FieldError {
+    fieldName: string;
+    message: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAC5C,WAAW,CAAC,EAAE;QACZ,iBAAiB,CAAC,EAAE;YAClB,YAAY,CAAC,EAAE;gBACb,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aAC5B,CAAC;YACF,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;YACpC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;SAClD,CAAC;QACF,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;KACrC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,WAAW,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,YAAY,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC/C,uBAAuB,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAC;IAC3D,kBAAkB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;IAChG,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mBAAmB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qCAAqC;IACrC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;IACzB,8EAA8E;IAC9E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/index.js

@@ -0,0 +1,26 @@
+'use strict';
+
+// src/types/index.ts
+var FormFieldType = /* @__PURE__ */ ((FormFieldType2) => {
+  FormFieldType2["TEXT"] = "text";
+  FormFieldType2["SIGNATURE"] = "signature";
+  FormFieldType2["INITIALS"] = "initials";
+  FormFieldType2["DATE"] = "date";
+  FormFieldType2["CHECKBOX"] = "checkbox";
+  FormFieldType2["RADIO"] = "radio";
+  FormFieldType2["DROPDOWN"] = "dropdown";
+  FormFieldType2["TEXT_LABEL"] = "text_label";
+  return FormFieldType2;
+})(FormFieldType || {});
+var SubmissionStatus = /* @__PURE__ */ ((SubmissionStatus2) => {
+  SubmissionStatus2["PENDING"] = "pending";
+  SubmissionStatus2["SIGNED"] = "signed";
+  SubmissionStatus2["DECLINED"] = "declined";
+  SubmissionStatus2["EXPIRED"] = "expired";
+  return SubmissionStatus2;
+})(SubmissionStatus || {});
+
+exports.FormFieldType = FormFieldType;
+exports.SubmissionStatus = SubmissionStatus;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"names":["FormFieldType","SubmissionStatus"],"mappings":";;;AAGO,IAAK,aAAA,qBAAAA,cAAAA,KAAL;AACL,EAAAA,eAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,eAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,YAAA,CAAA,GAAa,YAAA;AARH,EAAA,OAAAA,cAAAA;AAAA,CAAA,EAAA,aAAA,IAAA,EAAA;AAuQL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AACL,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,kBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,kBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAJA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\r\n * Form field types supported by the PDF signer\r\n */\r\nexport enum FormFieldType {\r\n  TEXT = 'text',\r\n  SIGNATURE = 'signature',\r\n  INITIALS = 'initials',\r\n  DATE = 'date',\r\n  CHECKBOX = 'checkbox',\r\n  RADIO = 'radio',\r\n  DROPDOWN = 'dropdown',\r\n  TEXT_LABEL = 'text_label',\r\n}\r\n\r\n/**\r\n * Position and dimensions of a form field on a PDF page\r\n */\r\nexport interface FormFieldPosition {\r\n  x: number;\r\n  y: number;\r\n  width: number;\r\n  height: number;\r\n  page: number; // 1-indexed page number\r\n}\r\n\r\n/**\r\n * Form field definition with all properties\r\n */\r\nexport interface FormField {\r\n  id: string;\r\n  type: FormFieldType;\r\n  name: string;\r\n  label: string;\r\n  position: FormFieldPosition;\r\n  required: boolean;\r\n  placeholder?: string;\r\n  options?: string[]; // For dropdown/radio fields\r\n  radioPositions?: FormFieldPosition[]; // For radio fields with multiple option positions\r\n  defaultValue?: string;\r\n  value?: string; // For filled values\r\n  fontSize?: number; // Font size for text fields (8-72 points)\r\n  multiline?: boolean; // Enable multiline text input for text fields\r\n  maxLength?: number; // Maximum character length for text fields\r\n\r\n  // Multiple signers support\r\n  assignedSignerEmail?: string; // Email of the signer this field is assigned to\r\n  assignedSignerRole?: string; // Role of the signer (for display purposes)\r\n  visibleToOthers?: boolean; // Whether other signers can see this field (default: false)\r\n}\r\n\r\n/**\r\n * PDF page information with rendered image\r\n */\r\nexport interface PdfPage {\r\n  pageNumber: number;\r\n  width: number;\r\n  height: number;\r\n  imageUrl: string;\r\n  renderWidth?: number; // Rendered image width (for scale calculation)\r\n  renderHeight?: number; // Rendered image height (for scale calculation)\r\n}\r\n\r\n/**\r\n * PDF viewer application interface (for PDF.js integration)\r\n */\r\nexport interface PDFViewerApplication {\r\n  initializedPromise?: Promise<void>;\r\n  pdfLoadingTask?: { promise: Promise<void> };\r\n  pdfDocument?: {\r\n    annotationStorage?: {\r\n      serializable?: {\r\n        map?: Map<string, unknown>;\r\n      };\r\n      getAll?: () => Record<string, unknown>;\r\n      getValue?: (key: string) => unknown;\r\n      setValue?: (key: string, value: unknown) => void;\r\n    };\r\n    getFieldObjects?: () => Promise<Record<string, unknown[]>>;\r\n    saveDocument?: () => Promise<Uint8Array>;\r\n    getData?: () => Promise<Uint8Array>;\r\n  };\r\n  pdfViewer?: {\r\n    currentPageNumber?: number;\r\n    pagesCount?: number;\r\n    container?: HTMLElement;\r\n    update?: () => void;\r\n    increaseScale?: () => void;\r\n    decreaseScale?: () => void;\r\n    nextPage?: () => void;\r\n    previousPage?: () => void;\r\n  };\r\n}\r\n\r\n/**\r\n * Configuration for PDF.js worker and viewer\r\n */\r\nexport interface PdfJsConfig {\r\n  workerSrc?: string;\r\n  viewerBasePath?: string; // Base path for PDF.js viewer (defaults to CDN)\r\n}\r\n\r\n/**\r\n * Attachment metadata\r\n */\r\nexport interface Attachment {\r\n  id: string;\r\n  file: File;\r\n  name: string;\r\n  size: number;\r\n  type: string;\r\n  uploadedAt: Date;\r\n  preview?: string; // Data URL for image previews\r\n}\r\n\r\n/**\r\n * Attachment validation constraints\r\n */\r\nexport interface AttachmentConstraints {\r\n  maxFileSize: number; // in bytes (default: 10MB)\r\n  maxTotalSize: number; // in bytes (default: 50MB)\r\n  maxFiles: number; // maximum number of files (default: 10)\r\n  allowedTypes: string[]; // MIME types (e.g., ['image/*', 'application/pdf'])\r\n  allowedExtensions?: string[]; // File extensions (e.g., ['.pdf', '.jpg', '.png'])\r\n}\r\n\r\n/**\r\n * Attachment validation result\r\n */\r\nexport interface AttachmentValidationResult {\r\n  isValid: boolean;\r\n  errors: string[];\r\n}\r\n\r\n/**\r\n * Audit trail metadata for compliance and forensics\r\n */\r\nexport interface AuditTrailMetadata {\r\n  userAgent?: string;\r\n  screenResolution?: string;\r\n  timezone?: string;\r\n  language?: string;\r\n  platform?: string;\r\n  ipAddress?: string;\r\n  geolocation?: {\r\n    latitude: number;\r\n    longitude: number;\r\n    accuracy?: number;\r\n  };\r\n}\r\n\r\n/**\r\n * Document metadata for PDF properties\r\n */\r\nexport interface DocumentMetadata {\r\n  submissionId?: string;\r\n  documentId?: string;\r\n  author?: string;\r\n  signerEmail?: string;\r\n  signerInitials?: string;\r\n  createdAt?: Date;\r\n}\r\n\r\n/**\r\n * Form submission data\r\n */\r\nexport interface SubmissionData {\r\n  formFieldValues: Record<string, string>;\r\n  signatures: Record<string, string>; // Base64 data URLs\r\n  attachments?: Attachment[];\r\n  pdfBytes: Uint8Array;\r\n  auditTrail?: AuditTrailMetadata;\r\n  metadata?: DocumentMetadata;\r\n}\r\n\r\n/**\r\n * Validation error\r\n */\r\nexport interface ValidationError {\r\n  field: string;\r\n  message: string;\r\n}\r\n\r\n/**\r\n * PDF viewer ref methods\r\n */\r\nexport interface PdfViewerRef {\r\n  loadPdf: (pdfUrl: string) => Promise<void>;\r\n  getFormFieldValues: () => Promise<Record<string, string>>;\r\n  setFormFieldValues: (values: Record<string, string>) => Promise<void>;\r\n  getAllFieldNames: () => Promise<string[]>;\r\n  saveDocument: () => Promise<Uint8Array | null>;\r\n  getPDFViewerApplication: () => PDFViewerApplication | null;\r\n  injectPlaceholders: (fields: Array<{ id: string; name: string; placeholder?: string }>) => void;\r\n  zoomIn: () => Promise<void>;\r\n  zoomOut: () => Promise<void>;\r\n  nextPage: () => Promise<void>;\r\n  previousPage: () => Promise<void>;\r\n  getCurrentPage: () => Promise<number | null>;\r\n  getTotalPages: () => Promise<number | null>;\r\n}\r\n\r\n/**\r\n * Signature canvas ref methods\r\n */\r\nexport interface SignatureCanvasRef {\r\n  clear: () => void;\r\n  getSignatureDataUrl: () => string | null;\r\n  isEmpty: () => boolean;\r\n}\r\n\r\n/**\r\n * Signer information for multi-signer documents\r\n */\r\nexport interface Signer {\r\n  id: string;\r\n  email: string;\r\n  name: string;\r\n  signOrder: number; // 1 = primary, 2+ = secondary\r\n  status: 'pending' | 'viewed' | 'signed' | 'declined';\r\n  signedAt?: string;\r\n}\r\n\r\n/**\r\n * Multi-signer context for determining field visibility and behavior\r\n * Used internally by hooks and utilities to manage multi-signer logic\r\n */\r\nexport interface MultiSignerContext {\r\n  /** Whether this is a multi-signer document */\r\n  isMultiSigner: boolean;\r\n  /** Current signer object (null for single-signer mode) */\r\n  currentSigner: Signer | null;\r\n  /** Current signer's email address */\r\n  currentSignerEmail: string;\r\n  /** Whether current signer is a primary signer (signOrder === 1) */\r\n  isPrimarySigner: boolean;\r\n  /** Whether current signer is the final signer (signOrder === totalSigners) */\r\n  isFinalSigner: boolean;\r\n}\r\n\r\n/**\r\n * Document submission\r\n */\r\nexport interface Submission {\r\n  id: string;\r\n  documentId: string;\r\n  status: 'pending' | 'signed' | 'declined' | 'expired';\r\n  createdAt: string;\r\n  updatedAt: string;\r\n  formFields?: FormField[];\r\n  pdfUrl?: string;\r\n  signedAt?: string;\r\n  declinedAt?: string;\r\n  expiresAt?: string;\r\n  isMultipleSignature?: boolean;\r\n  signers?: Signer[];\r\n}\r\n\r\n/**\r\n * Type aliases for compatibility with dm-web-frontend naming conventions\r\n */\r\nexport type EsignFormField = FormField;\r\nexport type EsignSigner = Signer;\r\n\r\n/**\r\n * Submission status enum\r\n */\r\nexport enum SubmissionStatus {\r\n  PENDING = 'pending',\r\n  SIGNED = 'signed',\r\n  DECLINED = 'declined',\r\n  EXPIRED = 'expired',\r\n}\r\n\r\n/**\r\n * Field error type for validation\r\n */\r\nexport interface FieldError {\r\n  fieldName: string;\r\n  message: string;\r\n}\r\n\r\n"]}

package/dist/types/index.mjs

@@ -0,0 +1,23 @@
+// src/types/index.ts
+var FormFieldType = /* @__PURE__ */ ((FormFieldType2) => {
+  FormFieldType2["TEXT"] = "text";
+  FormFieldType2["SIGNATURE"] = "signature";
+  FormFieldType2["INITIALS"] = "initials";
+  FormFieldType2["DATE"] = "date";
+  FormFieldType2["CHECKBOX"] = "checkbox";
+  FormFieldType2["RADIO"] = "radio";
+  FormFieldType2["DROPDOWN"] = "dropdown";
+  FormFieldType2["TEXT_LABEL"] = "text_label";
+  return FormFieldType2;
+})(FormFieldType || {});
+var SubmissionStatus = /* @__PURE__ */ ((SubmissionStatus2) => {
+  SubmissionStatus2["PENDING"] = "pending";
+  SubmissionStatus2["SIGNED"] = "signed";
+  SubmissionStatus2["DECLINED"] = "declined";
+  SubmissionStatus2["EXPIRED"] = "expired";
+  return SubmissionStatus2;
+})(SubmissionStatus || {});
+
+export { FormFieldType, SubmissionStatus };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"names":["FormFieldType","SubmissionStatus"],"mappings":";AAGO,IAAK,aAAA,qBAAAA,cAAAA,KAAL;AACL,EAAAA,eAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,eAAA,WAAA,CAAA,GAAY,WAAA;AACZ,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,MAAA,CAAA,GAAO,MAAA;AACP,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,OAAA,CAAA,GAAQ,OAAA;AACR,EAAAA,eAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,eAAA,YAAA,CAAA,GAAa,YAAA;AARH,EAAA,OAAAA,cAAAA;AAAA,CAAA,EAAA,aAAA,IAAA,EAAA;AAuQL,IAAK,gBAAA,qBAAAC,iBAAAA,KAAL;AACL,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,kBAAA,QAAA,CAAA,GAAS,QAAA;AACT,EAAAA,kBAAA,UAAA,CAAA,GAAW,UAAA;AACX,EAAAA,kBAAA,SAAA,CAAA,GAAU,SAAA;AAJA,EAAA,OAAAA,iBAAAA;AAAA,CAAA,EAAA,gBAAA,IAAA,EAAA","file":"index.mjs","sourcesContent":["/**\r\n * Form field types supported by the PDF signer\r\n */\r\nexport enum FormFieldType {\r\n  TEXT = 'text',\r\n  SIGNATURE = 'signature',\r\n  INITIALS = 'initials',\r\n  DATE = 'date',\r\n  CHECKBOX = 'checkbox',\r\n  RADIO = 'radio',\r\n  DROPDOWN = 'dropdown',\r\n  TEXT_LABEL = 'text_label',\r\n}\r\n\r\n/**\r\n * Position and dimensions of a form field on a PDF page\r\n */\r\nexport interface FormFieldPosition {\r\n  x: number;\r\n  y: number;\r\n  width: number;\r\n  height: number;\r\n  page: number; // 1-indexed page number\r\n}\r\n\r\n/**\r\n * Form field definition with all properties\r\n */\r\nexport interface FormField {\r\n  id: string;\r\n  type: FormFieldType;\r\n  name: string;\r\n  label: string;\r\n  position: FormFieldPosition;\r\n  required: boolean;\r\n  placeholder?: string;\r\n  options?: string[]; // For dropdown/radio fields\r\n  radioPositions?: FormFieldPosition[]; // For radio fields with multiple option positions\r\n  defaultValue?: string;\r\n  value?: string; // For filled values\r\n  fontSize?: number; // Font size for text fields (8-72 points)\r\n  multiline?: boolean; // Enable multiline text input for text fields\r\n  maxLength?: number; // Maximum character length for text fields\r\n\r\n  // Multiple signers support\r\n  assignedSignerEmail?: string; // Email of the signer this field is assigned to\r\n  assignedSignerRole?: string; // Role of the signer (for display purposes)\r\n  visibleToOthers?: boolean; // Whether other signers can see this field (default: false)\r\n}\r\n\r\n/**\r\n * PDF page information with rendered image\r\n */\r\nexport interface PdfPage {\r\n  pageNumber: number;\r\n  width: number;\r\n  height: number;\r\n  imageUrl: string;\r\n  renderWidth?: number; // Rendered image width (for scale calculation)\r\n  renderHeight?: number; // Rendered image height (for scale calculation)\r\n}\r\n\r\n/**\r\n * PDF viewer application interface (for PDF.js integration)\r\n */\r\nexport interface PDFViewerApplication {\r\n  initializedPromise?: Promise<void>;\r\n  pdfLoadingTask?: { promise: Promise<void> };\r\n  pdfDocument?: {\r\n    annotationStorage?: {\r\n      serializable?: {\r\n        map?: Map<string, unknown>;\r\n      };\r\n      getAll?: () => Record<string, unknown>;\r\n      getValue?: (key: string) => unknown;\r\n      setValue?: (key: string, value: unknown) => void;\r\n    };\r\n    getFieldObjects?: () => Promise<Record<string, unknown[]>>;\r\n    saveDocument?: () => Promise<Uint8Array>;\r\n    getData?: () => Promise<Uint8Array>;\r\n  };\r\n  pdfViewer?: {\r\n    currentPageNumber?: number;\r\n    pagesCount?: number;\r\n    container?: HTMLElement;\r\n    update?: () => void;\r\n    increaseScale?: () => void;\r\n    decreaseScale?: () => void;\r\n    nextPage?: () => void;\r\n    previousPage?: () => void;\r\n  };\r\n}\r\n\r\n/**\r\n * Configuration for PDF.js worker and viewer\r\n */\r\nexport interface PdfJsConfig {\r\n  workerSrc?: string;\r\n  viewerBasePath?: string; // Base path for PDF.js viewer (defaults to CDN)\r\n}\r\n\r\n/**\r\n * Attachment metadata\r\n */\r\nexport interface Attachment {\r\n  id: string;\r\n  file: File;\r\n  name: string;\r\n  size: number;\r\n  type: string;\r\n  uploadedAt: Date;\r\n  preview?: string; // Data URL for image previews\r\n}\r\n\r\n/**\r\n * Attachment validation constraints\r\n */\r\nexport interface AttachmentConstraints {\r\n  maxFileSize: number; // in bytes (default: 10MB)\r\n  maxTotalSize: number; // in bytes (default: 50MB)\r\n  maxFiles: number; // maximum number of files (default: 10)\r\n  allowedTypes: string[]; // MIME types (e.g., ['image/*', 'application/pdf'])\r\n  allowedExtensions?: string[]; // File extensions (e.g., ['.pdf', '.jpg', '.png'])\r\n}\r\n\r\n/**\r\n * Attachment validation result\r\n */\r\nexport interface AttachmentValidationResult {\r\n  isValid: boolean;\r\n  errors: string[];\r\n}\r\n\r\n/**\r\n * Audit trail metadata for compliance and forensics\r\n */\r\nexport interface AuditTrailMetadata {\r\n  userAgent?: string;\r\n  screenResolution?: string;\r\n  timezone?: string;\r\n  language?: string;\r\n  platform?: string;\r\n  ipAddress?: string;\r\n  geolocation?: {\r\n    latitude: number;\r\n    longitude: number;\r\n    accuracy?: number;\r\n  };\r\n}\r\n\r\n/**\r\n * Document metadata for PDF properties\r\n */\r\nexport interface DocumentMetadata {\r\n  submissionId?: string;\r\n  documentId?: string;\r\n  author?: string;\r\n  signerEmail?: string;\r\n  signerInitials?: string;\r\n  createdAt?: Date;\r\n}\r\n\r\n/**\r\n * Form submission data\r\n */\r\nexport interface SubmissionData {\r\n  formFieldValues: Record<string, string>;\r\n  signatures: Record<string, string>; // Base64 data URLs\r\n  attachments?: Attachment[];\r\n  pdfBytes: Uint8Array;\r\n  auditTrail?: AuditTrailMetadata;\r\n  metadata?: DocumentMetadata;\r\n}\r\n\r\n/**\r\n * Validation error\r\n */\r\nexport interface ValidationError {\r\n  field: string;\r\n  message: string;\r\n}\r\n\r\n/**\r\n * PDF viewer ref methods\r\n */\r\nexport interface PdfViewerRef {\r\n  loadPdf: (pdfUrl: string) => Promise<void>;\r\n  getFormFieldValues: () => Promise<Record<string, string>>;\r\n  setFormFieldValues: (values: Record<string, string>) => Promise<void>;\r\n  getAllFieldNames: () => Promise<string[]>;\r\n  saveDocument: () => Promise<Uint8Array | null>;\r\n  getPDFViewerApplication: () => PDFViewerApplication | null;\r\n  injectPlaceholders: (fields: Array<{ id: string; name: string; placeholder?: string }>) => void;\r\n  zoomIn: () => Promise<void>;\r\n  zoomOut: () => Promise<void>;\r\n  nextPage: () => Promise<void>;\r\n  previousPage: () => Promise<void>;\r\n  getCurrentPage: () => Promise<number | null>;\r\n  getTotalPages: () => Promise<number | null>;\r\n}\r\n\r\n/**\r\n * Signature canvas ref methods\r\n */\r\nexport interface SignatureCanvasRef {\r\n  clear: () => void;\r\n  getSignatureDataUrl: () => string | null;\r\n  isEmpty: () => boolean;\r\n}\r\n\r\n/**\r\n * Signer information for multi-signer documents\r\n */\r\nexport interface Signer {\r\n  id: string;\r\n  email: string;\r\n  name: string;\r\n  signOrder: number; // 1 = primary, 2+ = secondary\r\n  status: 'pending' | 'viewed' | 'signed' | 'declined';\r\n  signedAt?: string;\r\n}\r\n\r\n/**\r\n * Multi-signer context for determining field visibility and behavior\r\n * Used internally by hooks and utilities to manage multi-signer logic\r\n */\r\nexport interface MultiSignerContext {\r\n  /** Whether this is a multi-signer document */\r\n  isMultiSigner: boolean;\r\n  /** Current signer object (null for single-signer mode) */\r\n  currentSigner: Signer | null;\r\n  /** Current signer's email address */\r\n  currentSignerEmail: string;\r\n  /** Whether current signer is a primary signer (signOrder === 1) */\r\n  isPrimarySigner: boolean;\r\n  /** Whether current signer is the final signer (signOrder === totalSigners) */\r\n  isFinalSigner: boolean;\r\n}\r\n\r\n/**\r\n * Document submission\r\n */\r\nexport interface Submission {\r\n  id: string;\r\n  documentId: string;\r\n  status: 'pending' | 'signed' | 'declined' | 'expired';\r\n  createdAt: string;\r\n  updatedAt: string;\r\n  formFields?: FormField[];\r\n  pdfUrl?: string;\r\n  signedAt?: string;\r\n  declinedAt?: string;\r\n  expiresAt?: string;\r\n  isMultipleSignature?: boolean;\r\n  signers?: Signer[];\r\n}\r\n\r\n/**\r\n * Type aliases for compatibility with dm-web-frontend naming conventions\r\n */\r\nexport type EsignFormField = FormField;\r\nexport type EsignSigner = Signer;\r\n\r\n/**\r\n * Submission status enum\r\n */\r\nexport enum SubmissionStatus {\r\n  PENDING = 'pending',\r\n  SIGNED = 'signed',\r\n  DECLINED = 'declined',\r\n  EXPIRED = 'expired',\r\n}\r\n\r\n/**\r\n * Field error type for validation\r\n */\r\nexport interface FieldError {\r\n  fieldName: string;\r\n  message: string;\r\n}\r\n\r\n"]}

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

@@ -0,0 +1,118 @@
+/**
+ * Attachment Validation Utilities
+ * Validation functions for file attachments
+ */
+import type { AttachmentConstraints, Attachment } from '../types';
+/**
+ * Default attachment constraints
+ */
+export declare const DEFAULT_ATTACHMENT_CONSTRAINTS: AttachmentConstraints;
+/**
+ * Validate a single file against constraints
+ *
+ * @param file - File to validate
+ * @param constraints - Validation constraints
+ * @returns Validation result with errors array
+ *
+ * @example
+ * ```ts
+ * const result = validateFile(file, DEFAULT_ATTACHMENT_CONSTRAINTS);
+ * if (result.errors.length > 0) {
+ *   console.error('File validation failed:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateFile(file: File, constraints?: AttachmentConstraints): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate multiple files against constraints
+ *
+ * @param files - Files to validate
+ * @param existingAttachments - Existing attachments to consider for total size/count
+ * @param constraints - Validation constraints
+ * @returns Validation result with errors array
+ *
+ * @example
+ * ```ts
+ * const result = validateFiles(newFiles, existingAttachments, DEFAULT_ATTACHMENT_CONSTRAINTS);
+ * if (result.errors.length > 0) {
+ *   alert('Some files cannot be uploaded: ' + result.errors.join(', '));
+ * }
+ * ```
+ */
+export declare function validateFiles(files: File[], existingAttachments?: Attachment[], constraints?: AttachmentConstraints): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate file and throw error if invalid
+ *
+ * Convenience function that throws AttachmentValidationError if validation fails.
+ *
+ * @param file - File to validate
+ * @param constraints - Validation constraints
+ * @throws {AttachmentValidationError} If validation fails
+ *
+ * @example
+ * ```ts
+ * try {
+ *   validateFileOrThrow(file);
+ *   // File is valid, proceed with upload
+ * } catch (err) {
+ *   if (err instanceof AttachmentValidationError) {
+ *     alert(err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare function validateFileOrThrow(file: File, constraints?: AttachmentConstraints): void;
+/**
+ * Validate multiple files and throw error if invalid
+ *
+ * @param files - Files to validate
+ * @param existingAttachments - Existing attachments
+ * @param constraints - Validation constraints
+ * @throws {AttachmentValidationError} If validation fails
+ *
+ * @example
+ * ```ts
+ * try {
+ *   validateFilesOrThrow(selectedFiles, currentAttachments);
+ *   // All files are valid
+ * } catch (err) {
+ *   if (err instanceof AttachmentValidationError) {
+ *     alert(err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare function validateFilesOrThrow(files: File[], existingAttachments?: Attachment[], constraints?: AttachmentConstraints): void;
+/**
+ * Check if a file type is an image
+ *
+ * @param fileType - MIME type of the file
+ * @returns true if the file is an image
+ *
+ * @example
+ * ```ts
+ * if (isImageType(file.type)) {
+ *   // Generate preview
+ * }
+ * ```
+ */
+export declare function isImageType(fileType: string): boolean;
+/**
+ * Format file size for display
+ *
+ * @param bytes - File size in bytes
+ * @returns Formatted size string (e.g., "1.5 MB")
+ *
+ * @example
+ * ```ts
+ * const sizeDisplay = formatFileSize(file.size); // "1.5 MB"
+ * ```
+ */
+export declare function formatFileSize(bytes: number): string;
+//# sourceMappingURL=attachment-validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-validators.d.ts","sourceRoot":"","sources":["../../src/utils/attachment-validators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGlE;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,qBAM5C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,WAAW,GAAE,qBAAsD,GAClE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA4CA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,EAAE,EACb,mBAAmB,GAAE,UAAU,EAAO,EACtC,WAAW,GAAE,qBAAsD,GAClE;IACD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAkCA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,GAAE,qBAAsD,GAClE,IAAI,CASN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,mBAAmB,GAAE,UAAU,EAAO,EACtC,WAAW,GAAE,qBAAsD,GAClE,IAAI,CASN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD"}

package/dist/utils/audit-trail.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Audit Trail Utilities
+ * Captures device metadata, IP address, and geolocation for compliance and forensics
+ */
+import type { AuditTrailMetadata } from '../types';
+/**
+ * Synchronously capture device and browser metadata
+ */
+export declare function captureDeviceMetadata(): Partial<AuditTrailMetadata>;
+/**
+ * Capture IP address using public API
+ */
+export declare function captureIpAddress(): Promise<string>;
+/**
+ * Capture geolocation using browser geolocation API
+ */
+export declare function captureGeolocation(): Promise<{
+    latitude: number;
+    longitude: number;
+    accuracy?: number;
+} | null>;
+/**
+ * Capture complete audit trail metadata
+ * Combines device metadata, IP address, and geolocation
+ */
+export declare function captureAuditTrail(): Promise<AuditTrailMetadata>;
+//# sourceMappingURL=audit-trail.d.ts.map

package/dist/utils/audit-trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.d.ts","sourceRoot":"","sources":["../../src/utils/audit-trail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAsCnE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuBxD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAAC,CAiCR;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAgCrE"}

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

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

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

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

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