@signiphi/pdf-signer 0.1.1

package/dist/utils/performance-monitor.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Performance Monitoring Utility
+ *
+ * Provides utilities for tracking and measuring performance metrics
+ * in critical operations like PDF loading, form filling, and signature capture.
+ *
+ * Usage:
+ * ```typescript
+ * const monitor = createPerformanceMonitor();
+ * const endTimer = monitor.startTimer('pdf-load');
+ * await loadPdf(url);
+ * endTimer();
+ * const metrics = monitor.getMetrics();
+ * ```
+ */
+export interface PerformanceMetric {
+    label: string;
+    duration: number;
+    timestamp: number;
+}
+export interface PerformanceMetrics {
+    [label: string]: {
+        count: number;
+        total: number;
+        avg: number;
+        min: number;
+        max: number;
+        last: number;
+    };
+}
+/**
+ * Performance Monitor Class
+ *
+ * Tracks performance metrics for various operations.
+ * Maintains history and calculates statistics (avg, min, max).
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private enabled;
+    constructor(enabled?: boolean);
+    /**
+     * Start a timer for a labeled operation
+     *
+     * @param label - Unique label for the operation
+     * @returns Function to call when operation completes
+     *
+     * @example
+     * ```typescript
+     * const endTimer = monitor.startTimer('pdf-load');
+     * await loadPdf(url);
+     * endTimer(); // Records duration
+     * ```
+     */
+    startTimer(label: string): () => void;
+    /**
+     * Manually record a performance measurement
+     *
+     * @param label - Unique label for the operation
+     * @param duration - Duration in milliseconds
+     *
+     * @example
+     * ```typescript
+     * monitor.measure('pdf-load', 1234.56);
+     * ```
+     */
+    measure(label: string, duration: number): void;
+    /**
+     * Get all recorded metrics with statistics
+     *
+     * @returns Object containing metrics for all labels
+     *
+     * @example
+     * ```typescript
+     * const metrics = monitor.getMetrics();
+     * console.log(`PDF load avg: ${metrics['pdf-load'].avg}ms`);
+     * ```
+     */
+    getMetrics(): PerformanceMetrics;
+    /**
+     * Get metrics for a specific label
+     *
+     * @param label - Label to get metrics for
+     * @returns Metrics for the label, or null if not found
+     */
+    getMetric(label: string): PerformanceMetrics[string] | null;
+    /**
+     * Get raw measurements for a label
+     *
+     * @param label - Label to get measurements for
+     * @returns Array of duration measurements in milliseconds
+     */
+    getRawMeasurements(label: string): number[];
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Clear metrics for a specific label
+     *
+     * @param label - Label to clear metrics for
+     */
+    clearLabel(label: string): void;
+    /**
+     * Enable or disable performance monitoring
+     *
+     * @param enabled - Whether to enable monitoring
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if monitoring is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Generate a performance report as a string
+     *
+     * @returns Formatted performance report
+     */
+    generateReport(): string;
+}
+/**
+ * Create a new performance monitor instance
+ *
+ * @param enabled - Whether to enable monitoring (default: true in development)
+ * @returns PerformanceMonitor instance
+ *
+ * @example
+ * ```typescript
+ * const monitor = createPerformanceMonitor();
+ * ```
+ */
+export declare function createPerformanceMonitor(enabled?: boolean): PerformanceMonitor;
+/**
+ * Global performance monitor instance
+ * Can be used across the application for centralized monitoring
+ */
+export declare const globalPerformanceMonitor: PerformanceMonitor;
+/**
+ * Decorator for measuring function performance
+ *
+ * @param label - Label for the performance measurement
+ * @param monitor - Performance monitor instance (defaults to global)
+ * @returns Function decorator
+ *
+ * @example
+ * ```typescript
+ * class MyClass {
+ *   @measurePerformance('my-operation')
+ *   async myOperation() {
+ *     // ... operation code ...
+ *   }
+ * }
+ * ```
+ */
+export declare function measurePerformance(label: string, monitor?: PerformanceMonitor): (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Higher-order function to wrap async functions with performance monitoring
+ *
+ * @param label - Label for the performance measurement
+ * @param fn - Function to wrap
+ * @param monitor - Performance monitor instance (defaults to global)
+ * @returns Wrapped function
+ *
+ * @example
+ * ```typescript
+ * const loadPdfWithMonitoring = withPerformanceMonitoring(
+ *   'pdf-load',
+ *   loadPdf
+ * );
+ * ```
+ */
+export declare function withPerformanceMonitoring<T extends (...args: any[]) => Promise<any>>(label: string, fn: T, monitor?: PerformanceMonitor): T;
+//# sourceMappingURL=performance-monitor.d.ts.map

package/dist/utils/performance-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-monitor.d.ts","sourceRoot":"","sources":["../../src/utils/performance-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,KAAK,EAAE,MAAM,GAAG;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,GAAE,OAAc;IAInC;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,IAAI;IAarC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAY9C;;;;;;;;;;OAUG;IACH,UAAU,IAAI,kBAAkB;IAyBhC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI;IAsB3D;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAI3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAoBzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAG9E;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,oBAA6B,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,kBAA6C,IAGpD,SAAS,GAAG,EACZ,cAAc,MAAM,EACpB,YAAY,kBAAkB,wBAgBjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAClF,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,kBAA6C,GACrD,CAAC,CASH"}

package/dist/utils/tracking.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Usage tracking utilities for signiphi API integration.
+ * Enables automatic tracking of document sends and signings via API key.
+ */
+/**
+ * Configuration for the tracking API
+ */
+export interface TrackingConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Custom API endpoint (defaults to https://api.signiphi.ai) */
+    endpoint?: string;
+}
+/**
+ * Data for tracking a document send event
+ */
+export interface TrackSendData {
+    /** Email address of the recipient */
+    recipientEmail: string;
+    /** Optional document ID for correlation */
+    documentId?: string;
+    /** Optional idempotency key to prevent duplicate tracking */
+    idempotencyKey?: string;
+    /** Optional additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Data for tracking a document signing event
+ */
+export interface TrackSigningData {
+    /** Email address of the signer */
+    signerEmail: string;
+    /** Optional document ID for correlation */
+    documentId?: string;
+    /** Optional idempotency key to prevent duplicate tracking */
+    idempotencyKey?: string;
+    /** Optional additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Response from tracking API
+ */
+export interface TrackingResponse {
+    success: boolean;
+    eventId: string;
+    idempotencyKey: string;
+    usage: {
+        currentMonth: number;
+        limit: number;
+        remaining: number;
+    };
+}
+/**
+ * Track a document send event.
+ * Call this when a document is sent to a recipient for signing.
+ *
+ * @param config - Tracking configuration with API key
+ * @param data - Send event data
+ * @returns Tracking response with usage stats
+ */
+export declare function trackDocumentSent(config: TrackingConfig, data: TrackSendData): Promise<TrackingResponse>;
+/**
+ * Track a document signing event.
+ * Call this when a document is signed by a recipient.
+ *
+ * @param config - Tracking configuration with API key
+ * @param data - Signing event data
+ * @returns Tracking response with usage stats
+ */
+export declare function trackDocumentSigned(config: TrackingConfig, data: TrackSigningData): Promise<TrackingResponse>;
+/**
+ * Silently track a document signing event (non-blocking).
+ * This version catches errors and logs them without throwing.
+ * Use this when tracking failure should not affect the main flow.
+ *
+ * @param config - Tracking configuration with API key
+ * @param data - Signing event data
+ */
+export declare function trackDocumentSignedSilent(config: TrackingConfig, data: TrackSigningData): Promise<void>;
+/**
+ * Silently track a document send event (non-blocking).
+ * This version catches errors and logs them without throwing.
+ * Use this when tracking failure should not affect the main flow.
+ *
+ * @param config - Tracking configuration with API key
+ * @param data - Send event data
+ */
+export declare function trackDocumentSentSilent(config: TrackingConfig, data: TrackSendData): Promise<void>;
+//# sourceMappingURL=tracking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/utils/tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/package.json

@@ -0,0 +1,180 @@
+{
+  "name": "@signiphi/pdf-signer",
+  "version": "0.1.1",
+  "description": "Flexible React components for PDF viewing, form filling, and signature capture",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "*.css",
+    "./src/utils/pdfjs-config.ts",
+    "./dist/styles/*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./styles": "./dist/styles/index.css",
+    "./styles/source": "./src/styles/index.css",
+    "./src/styles/index.css": "./src/styles/index.css",
+    "./dist/styles/index.css": "./dist/styles/index.css",
+    "./package.json": "./package.json",
+    "./vite": {
+      "types": "./dist/integrations/index.d.ts",
+      "import": "./dist/integrations/index.mjs",
+      "require": "./dist/integrations/index.js"
+    },
+    "./next": {
+      "types": "./dist/integrations/index.d.ts",
+      "import": "./dist/integrations/index.mjs",
+      "require": "./dist/integrations/index.js"
+    },
+    "./headless": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.mjs",
+      "require": "./dist/core/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.mjs",
+      "require": "./dist/components/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.mjs",
+      "require": "./dist/hooks/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "require": "./dist/types/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/styles",
+    "scripts",
+    "assets",
+    "README.md",
+    "INSTALLING_LOCALLY.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "signiphi-setup": "./scripts/setup.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "prepare": "node scripts/postinstall.js || true",
+    "dev": "tsup --watch",
+    "build": "tsup && tsc --emitDeclarationOnly && node -e \"require('fs').mkdirSync('dist/styles', {recursive: true})\" && postcss src/styles/index.css -o dist/styles/index.css",
+    "build:analyze": "pnpm build && node scripts/analyze-bundle.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts,.tsx",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "analyze": "node scripts/analyze-bundle.js",
+    "analyze:check": "node scripts/analyze-bundle.js --check-budgets"
+  },
+  "keywords": [
+    "pdf",
+    "signature",
+    "esign",
+    "react",
+    "headless",
+    "form",
+    "document"
+  ],
+  "author": "signiphi",
+  "license": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/signiphi/signiphi.git",
+    "directory": "packages/pdf-signer"
+  },
+  "bundleSize": {
+    "index.mjs": {
+      "limit": "200kb",
+      "gzip": "60kb"
+    },
+    "core/index.mjs": {
+      "limit": "50kb",
+      "gzip": "15kb"
+    },
+    "components/index.mjs": {
+      "limit": "120kb",
+      "gzip": "35kb"
+    },
+    "hooks/index.mjs": {
+      "limit": "80kb",
+      "gzip": "25kb"
+    },
+    "types/index.mjs": {
+      "limit": "5kb",
+      "gzip": "2kb"
+    },
+    "utils/index.mjs": {
+      "limit": "100kb",
+      "gzip": "30kb"
+    }
+  },
+  "peerDependencies": {
+    "@radix-ui/react-checkbox": "^1.1.0",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-popover": "^1.1.0",
+    "@radix-ui/react-radio-group": "^1.2.0",
+    "@radix-ui/react-select": "^2.1.0",
+    "@radix-ui/react-tabs": "^1.1.0",
+    "date-fns": "^3.0.0",
+    "lucide-react": "^0.400.0",
+    "react": ">=18.0.0",
+    "react-day-picker": "^9.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "tailwindcss": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@radix-ui/react-slot": "^1.2.3",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "pdf-lib": "^1.17.1",
+    "pdfjs-dist": "5.3.93",
+    "react-error-boundary": "^5.0.0",
+    "tailwind-merge": "^3.3.1"
+  },
+  "devDependencies": {
+    "@jridgewell/remapping": "^2.3.5",
+    "@tailwindcss/postcss": "^4.1.4",
+    "@testing-library/react": "^14.1.2",
+    "@types/react": "^18.3.17",
+    "@types/react-dom": "^18.3.5",
+    "@vitest/coverage-v8": "^1.0.4",
+    "@vitest/ui": "^1.0.4",
+    "esbuild": "0.19.12",
+    "eslint": "^9.25.1",
+    "happy-dom": "^20.0.10",
+    "jsdom": "^23.0.1",
+    "postcss": "^8.5.6",
+    "postcss-cli": "^11.0.0",
+    "postcss-nesting": "^13.0.2",
+    "postcss-preset-env": "^10.4.0",
+    "tailwindcss": "^4.1.4",
+    "tailwindcss-animate": "^1.0.7",
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3",
+    "vitest": "^1.0.4"
+  }
+}