@signiphi/pdf-signer 0.1.1

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

@@ -0,0 +1,27 @@
+/**
+ * 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
+ */
+export declare function decodeFieldName(fieldName: string): {
+    decodedFieldName: string;
+    displayLabel: string;
+    assignedSignerEmail?: string;
+    fieldPlaceholder: 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

@@ -0,0 +1 @@
+{"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;AAuBzD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,UAAU,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAmL3B;AAED;;;GAGG;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;CAC1B,CA8DA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,CAgChG"}

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

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

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

@@ -0,0 +1,17 @@
+export * from './pdf-helpers';
+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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,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"}