@finsys/core 4.1.0 → 4.2.0

package/dist/index.d.cts

@@ -990,6 +990,30 @@ interface AdapterExtraction {
      * The canonical field values for this instance.
      */
     readonly values: CanonicalFieldValues;
+    /**
+     * SYS-2502: when this instance's data was OBSERVED at the source
+     * (ISO-8601) — the statement's own date, the partner snapshot's
+     * timestamp — as distinct from when the adapter RAN. Optional for
+     * backward compatibility with already-shipped adapters (the host
+     * falls back to the run's ranAt when absent, exactly the inference
+     * it always did), but new adapters should treat it as required:
+     * ranAt-inference conflates "when we fetched" with "when it was
+     * true", which corrupts recency ordering for backfilled or delayed
+     * data. Expected to become mandatory at the next major version.
+     */
+    readonly observedAt?: string;
+    /**
+     * SYS-2502 (prototyped in finsys-api under SYS-2977): optional
+     * per-field extraction confidence, 0..1, keyed by canonical field
+     * name. This is the provenance slot SYS-2819 identified as the
+     * missing precondition for FinXtract-as-adapter — probabilistic
+     * extractors (OCR/LLM) carry real per-field confidence; partner-API
+     * adapters (a telco returning a number) simply omit it. `null` marks
+     * a field whose value is derived/computed rather than directly
+     * extracted (renders as "no confidence" rather than low confidence,
+     * matching IhsFieldProvenance.origin semantics).
+     */
+    readonly confidence?: Partial<Record<CanonicalFieldName, number | null>>;
 }
 /**
  * Allowed value shapes for canonical fields. Per-field type narrowing
@@ -1383,8 +1407,47 @@ interface AdapterManifest {
      *     code is loaded.
      *   - `typescript` — TS/JS adapter; `entryPoint` is required, the
      *     host imports it dynamically.
+     *   - `form-intake` — SYS-2501: data-only adapter declaring
+     *     form-field-id → canonical-field mappings. No code is loaded and
+     *     no fetch()/extract() ever runs; the host's form submission
+     *     handler IS the runtime, and this manifest is how a
+     *     borrower-entered scalar becomes a canonical, provenance-carrying
+     *     field instead of a hand-wired column write.
+     *   - `manual-override` — SYS-2501: data-only adapter declaring that
+     *     this category's fields may be operator-overridden
+     *     post-extraction. `produces` IS the override surface (a separate
+     *     list could only duplicate or contradict it); the host's
+     *     override endpoints gate on membership.
+     */
+    readonly implementation: DeclarativeImplementation | TypescriptImplementation | FormIntakeImplementation | ManualOverrideImplementation;
+    /**
+     * SYS-2502: explicit instance cardinality.
+     *
+     *   - `single` — at most one instance per applicant; extract() returns
+     *     one AdapterExtraction with `instanceKey: ""`.
+     *   - `multi` — unbounded instances per applicant, each with a stable,
+     *     non-empty instanceKey.
+     *
+     * OPTIONAL for backward compatibility: manifests written before this
+     * field existed rely on the original implicit convention
+     * (instanceKey `""` → single, non-empty → multi), and the host infers
+     * accordingly when the field is absent. New manifests should declare
+     * it — an explicit declaration lets the host REJECT a mismatched
+     * extraction (a multi-keyed instance from a declared-single adapter,
+     * or vice versa) at persistence time instead of silently storing it.
+     */
+    readonly cardinality?: "single" | "multi";
+    /**
+     * SYS-2502: per-applicant singleton fields on a multi-instance
+     * category — fields whose value describes the APPLICANT (one value
+     * regardless of how many instances exist) rather than the instance,
+     * e.g. accountHolderName on bank statements. Every entry MUST also
+     * appear in `produces` (host validates at registration, same as
+     * `produces` ⊆ category fields). Only meaningful when cardinality is
+     * `multi`; the host treats a singleton field's value as shared across
+     * the instance set.
      */
-    readonly implementation: DeclarativeImplementation | TypescriptImplementation;
+    readonly singletonFields?: ReadonlyArray<CanonicalFieldName>;
     /**
      * v2.7.0 — partner-specific identity fields the adapter needs from
      * the IHS row when fetch() is invoked. Strings name the keys that
@@ -1432,6 +1495,45 @@ interface TypescriptImplementation {
      */
     readonly entryPoint: string;
 }
+/**
+ * SYS-2501: data-only implementation for borrower/operator form intake.
+ * The manifest declares which form fields feed which canonical fields;
+ * the host's form submission handler applies the mapping — no adapter
+ * code exists to load, and neither fetch() nor extract() ever runs.
+ */
+interface FormIntakeImplementation {
+    readonly type: "form-intake";
+    /**
+     * form-field-id → canonical-field mappings. `formFieldId` is the form
+     * spec's field name (the same identifier UnifiedFormConfig fields
+     * carry); `canonical` MUST be declared by the adapter's category —
+     * host validates at registration, exactly like declarative fieldMap
+     * entries. Values arrive already typed from the form layer, so there
+     * is deliberately no transform slot here: a form field needing value
+     * transformation is a form-spec concern, not an adapter one.
+     */
+    readonly fieldMap: ReadonlyArray<FormIntakeFieldMapEntry>;
+}
+interface FormIntakeFieldMapEntry {
+    /** The form spec's field name this mapping consumes. */
+    readonly formFieldId: string;
+    /**
+     * Canonical field name this maps to. MUST be declared by the
+     * adapter's category. Host validates at registration.
+     */
+    readonly canonical: CanonicalFieldName;
+}
+/**
+ * SYS-2501: data-only implementation declaring that the adapter's
+ * `produces` list is operator-overridable post-extraction. The manifest
+ * gates the override surface; the host's override endpoints check
+ * membership in `produces` before accepting a manual value. No code, no
+ * fetch(), no extract() — the discriminator alone carries the meaning,
+ * so this shape is intentionally empty beyond `type`.
+ */
+interface ManualOverrideImplementation {
+    readonly type: "manual-override";
+}
 interface FieldMapEntry {
     /**
      * JSONPath expression into the raw payload. E.g.
@@ -1459,4 +1561,4 @@ interface FieldMapEntry {
     readonly transform?: "identity" | "pct_to_ratio01" | "to_boolean" | "to_integer";
 }
 
-export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type PageConfig, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };
+export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };

package/dist/index.d.ts

@@ -990,6 +990,30 @@ interface AdapterExtraction {
      * The canonical field values for this instance.
      */
     readonly values: CanonicalFieldValues;
+    /**
+     * SYS-2502: when this instance's data was OBSERVED at the source
+     * (ISO-8601) — the statement's own date, the partner snapshot's
+     * timestamp — as distinct from when the adapter RAN. Optional for
+     * backward compatibility with already-shipped adapters (the host
+     * falls back to the run's ranAt when absent, exactly the inference
+     * it always did), but new adapters should treat it as required:
+     * ranAt-inference conflates "when we fetched" with "when it was
+     * true", which corrupts recency ordering for backfilled or delayed
+     * data. Expected to become mandatory at the next major version.
+     */
+    readonly observedAt?: string;
+    /**
+     * SYS-2502 (prototyped in finsys-api under SYS-2977): optional
+     * per-field extraction confidence, 0..1, keyed by canonical field
+     * name. This is the provenance slot SYS-2819 identified as the
+     * missing precondition for FinXtract-as-adapter — probabilistic
+     * extractors (OCR/LLM) carry real per-field confidence; partner-API
+     * adapters (a telco returning a number) simply omit it. `null` marks
+     * a field whose value is derived/computed rather than directly
+     * extracted (renders as "no confidence" rather than low confidence,
+     * matching IhsFieldProvenance.origin semantics).
+     */
+    readonly confidence?: Partial<Record<CanonicalFieldName, number | null>>;
 }
 /**
  * Allowed value shapes for canonical fields. Per-field type narrowing
@@ -1383,8 +1407,47 @@ interface AdapterManifest {
      *     code is loaded.
      *   - `typescript` — TS/JS adapter; `entryPoint` is required, the
      *     host imports it dynamically.
+     *   - `form-intake` — SYS-2501: data-only adapter declaring
+     *     form-field-id → canonical-field mappings. No code is loaded and
+     *     no fetch()/extract() ever runs; the host's form submission
+     *     handler IS the runtime, and this manifest is how a
+     *     borrower-entered scalar becomes a canonical, provenance-carrying
+     *     field instead of a hand-wired column write.
+     *   - `manual-override` — SYS-2501: data-only adapter declaring that
+     *     this category's fields may be operator-overridden
+     *     post-extraction. `produces` IS the override surface (a separate
+     *     list could only duplicate or contradict it); the host's
+     *     override endpoints gate on membership.
+     */
+    readonly implementation: DeclarativeImplementation | TypescriptImplementation | FormIntakeImplementation | ManualOverrideImplementation;
+    /**
+     * SYS-2502: explicit instance cardinality.
+     *
+     *   - `single` — at most one instance per applicant; extract() returns
+     *     one AdapterExtraction with `instanceKey: ""`.
+     *   - `multi` — unbounded instances per applicant, each with a stable,
+     *     non-empty instanceKey.
+     *
+     * OPTIONAL for backward compatibility: manifests written before this
+     * field existed rely on the original implicit convention
+     * (instanceKey `""` → single, non-empty → multi), and the host infers
+     * accordingly when the field is absent. New manifests should declare
+     * it — an explicit declaration lets the host REJECT a mismatched
+     * extraction (a multi-keyed instance from a declared-single adapter,
+     * or vice versa) at persistence time instead of silently storing it.
+     */
+    readonly cardinality?: "single" | "multi";
+    /**
+     * SYS-2502: per-applicant singleton fields on a multi-instance
+     * category — fields whose value describes the APPLICANT (one value
+     * regardless of how many instances exist) rather than the instance,
+     * e.g. accountHolderName on bank statements. Every entry MUST also
+     * appear in `produces` (host validates at registration, same as
+     * `produces` ⊆ category fields). Only meaningful when cardinality is
+     * `multi`; the host treats a singleton field's value as shared across
+     * the instance set.
      */
-    readonly implementation: DeclarativeImplementation | TypescriptImplementation;
+    readonly singletonFields?: ReadonlyArray<CanonicalFieldName>;
     /**
      * v2.7.0 — partner-specific identity fields the adapter needs from
      * the IHS row when fetch() is invoked. Strings name the keys that
@@ -1432,6 +1495,45 @@ interface TypescriptImplementation {
      */
     readonly entryPoint: string;
 }
+/**
+ * SYS-2501: data-only implementation for borrower/operator form intake.
+ * The manifest declares which form fields feed which canonical fields;
+ * the host's form submission handler applies the mapping — no adapter
+ * code exists to load, and neither fetch() nor extract() ever runs.
+ */
+interface FormIntakeImplementation {
+    readonly type: "form-intake";
+    /**
+     * form-field-id → canonical-field mappings. `formFieldId` is the form
+     * spec's field name (the same identifier UnifiedFormConfig fields
+     * carry); `canonical` MUST be declared by the adapter's category —
+     * host validates at registration, exactly like declarative fieldMap
+     * entries. Values arrive already typed from the form layer, so there
+     * is deliberately no transform slot here: a form field needing value
+     * transformation is a form-spec concern, not an adapter one.
+     */
+    readonly fieldMap: ReadonlyArray<FormIntakeFieldMapEntry>;
+}
+interface FormIntakeFieldMapEntry {
+    /** The form spec's field name this mapping consumes. */
+    readonly formFieldId: string;
+    /**
+     * Canonical field name this maps to. MUST be declared by the
+     * adapter's category. Host validates at registration.
+     */
+    readonly canonical: CanonicalFieldName;
+}
+/**
+ * SYS-2501: data-only implementation declaring that the adapter's
+ * `produces` list is operator-overridable post-extraction. The manifest
+ * gates the override surface; the host's override endpoints check
+ * membership in `produces` before accepting a manual value. No code, no
+ * fetch(), no extract() — the discriminator alone carries the meaning,
+ * so this shape is intentionally empty beyond `type`.
+ */
+interface ManualOverrideImplementation {
+    readonly type: "manual-override";
+}
 interface FieldMapEntry {
     /**
      * JSONPath expression into the raw payload. E.g.
@@ -1459,4 +1561,4 @@ interface FieldMapEntry {
     readonly transform?: "identity" | "pct_to_ratio01" | "to_boolean" | "to_integer";
 }
 
-export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type PageConfig, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };
+export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };