@cobre-npm/library-onboarding-core 0.3.0 → 0.5.0

package/dist/constants/fieldValidations.d.ts

@@ -0,0 +1,23 @@
+export declare const DEFAULT_MAX_LENGTH = 500;
+export declare const DEFAULT_PHONE_MAX_LENGTH = 30;
+export declare const DEFAULT_NAME_MIN_LENGTH = 2;
+export type FieldValidationRule = {
+    readonly kind: "name";
+    readonly minLength: number;
+} | {
+    readonly kind: "numericRange";
+    readonly min: number;
+    readonly max: number;
+} | {
+    readonly kind: "pastDate";
+    readonly minAgeYears?: number;
+};
+export interface FieldValidation {
+    readonly maxLength?: number;
+    readonly rule?: FieldValidationRule;
+}
+export declare const FIELD_VALIDATIONS: Record<string, FieldValidation>;
+export declare const getFieldValidation: (fieldName: string) => FieldValidation | undefined;
+export declare const getFieldRule: (fieldName: string) => FieldValidationRule | undefined;
+export declare const getFieldMaxLength: (fieldName: string, fallback?: number) => number;
+export declare const hasFieldValidation: (fieldName: string) => boolean;

package/dist/constants/fieldValidations.js

@@ -0,0 +1,72 @@
+"use strict";
+/*
+ * Single source of truth for per-field-name validation, keyed by data point name.
+ * Each entry declares everything the front enforces on a field — its max length
+ * AND its semantic rule (person-name format, numeric range, past-date cap).
+ *
+ * Replaces the former fieldMaxLength.ts: max lengths are now just one facet of a
+ * field's validation. Consumers turn these declarations into their own runtime
+ * (input validation, date bounds); this module holds data + pure lookups only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasFieldValidation = exports.getFieldMaxLength = exports.getFieldRule = exports.getFieldValidation = exports.FIELD_VALIDATIONS = exports.DEFAULT_NAME_MIN_LENGTH = exports.DEFAULT_PHONE_MAX_LENGTH = exports.DEFAULT_MAX_LENGTH = void 0;
+// Fallback max length when a field declares none.
+exports.DEFAULT_MAX_LENGTH = 500;
+// Fallback max length for phone fields specifically.
+exports.DEFAULT_PHONE_MAX_LENGTH = 30;
+// A name must be at least this many characters when a rule omits its own.
+exports.DEFAULT_NAME_MIN_LENGTH = 2;
+exports.FIELD_VALIDATIONS = {
+    // Person names — max length + name-format rule. Never legal_name/dba_name (may carry digits/&).
+    full_name: { maxLength: 200, rule: { kind: "name", minLength: exports.DEFAULT_NAME_MIN_LENGTH } },
+    first_name: { maxLength: 100, rule: { kind: "name", minLength: exports.DEFAULT_NAME_MIN_LENGTH } },
+    middle_name: { maxLength: 100, rule: { kind: "name", minLength: exports.DEFAULT_NAME_MIN_LENGTH } },
+    last_name: { maxLength: 100, rule: { kind: "name", minLength: exports.DEFAULT_NAME_MIN_LENGTH } },
+    // Date rules — capped at today (or minAgeYears back for birth dates).
+    incorporation_date: { rule: { kind: "pastDate" } },
+    operations_start_date: { rule: { kind: "pastDate" } },
+    birth_date: { rule: { kind: "pastDate", minAgeYears: 18 } },
+    // Percentage KYC data points.
+    percentage_ownership: { rule: { kind: "numericRange", min: 1, max: 100 } },
+    cash_transaction_percentage: { rule: { kind: "numericRange", min: 0, max: 100 } },
+    // Length-only fields.
+    phone: { maxLength: exports.DEFAULT_PHONE_MAX_LENGTH },
+    legal_name: { maxLength: 300 },
+    dba_name: { maxLength: 300 },
+    tax_id_number: { maxLength: 50 },
+    e_sign_number: { maxLength: 50 },
+    incorporation_state: { maxLength: 100 },
+    incorporation_city: { maxLength: 100 },
+    business_description: { maxLength: 2000 },
+    website: { maxLength: 500 },
+    line_1: { maxLength: 200 },
+    line_2: { maxLength: 200 },
+    city: { maxLength: 100 },
+    state: { maxLength: 100 },
+    postal_code: { maxLength: 20 },
+    tax_id_type: { maxLength: 50 },
+    curp: { maxLength: 18 },
+    migration_status: { maxLength: 100 },
+    migration_form_number: { maxLength: 50 },
+    nationality: { maxLength: 100 },
+    birth_country: { maxLength: 100 },
+    country_of_birth: { maxLength: 100 },
+    country_of_residence: { maxLength: 100 },
+    state_of_birth: { maxLength: 100 },
+    occupation: { maxLength: 200 },
+    number: { maxLength: 50 },
+    company_relationship: { maxLength: 200 },
+    public_office_position: { maxLength: 500 },
+    legal_proceedings_description: { maxLength: 5000 },
+    funds_source_other_description: { maxLength: 1000 },
+    monthly_counterparties_count: { maxLength: 100 },
+    third_party_id: { maxLength: 100 },
+};
+const getFieldValidation = (fieldName) => exports.FIELD_VALIDATIONS[fieldName];
+exports.getFieldValidation = getFieldValidation;
+const getFieldRule = (fieldName) => exports.FIELD_VALIDATIONS[fieldName]?.rule;
+exports.getFieldRule = getFieldRule;
+const getFieldMaxLength = (fieldName, fallback = exports.DEFAULT_MAX_LENGTH) => exports.FIELD_VALIDATIONS[fieldName]?.maxLength ?? fallback;
+exports.getFieldMaxLength = getFieldMaxLength;
+const hasFieldValidation = (fieldName) => (0, exports.getFieldValidation)(fieldName) !== undefined;
+exports.hasFieldValidation = hasFieldValidation;