@cobre-npm/library-onboarding-core 0.4.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;

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-export * from "./constants/fieldMaxLength";
-export * from "./constants/documentAutofillFields";
+export * from "./constants/fieldValidations";
 export declare const locales: {
     Shared: {
         en: {
@@ -1099,10 +1098,6 @@ export declare const locales: {
                 ZMB: string;
                 ZWE: string;
             };
-            validation: {
-                required: string;
-                invalid: string;
-            };
         };
         es: {
             document: {
@@ -2201,10 +2196,6 @@ export declare const locales: {
                 ZMB: string;
                 ZWE: string;
             };
-            validation: {
-                required: string;
-                invalid: string;
-            };
         };
     };
     Summary: {
@@ -2419,6 +2410,14 @@ export declare const locales: {
                 beneficial_owners: string;
                 maximal_controllers: string;
             };
+            validation: {
+                required: string;
+                invalid: string;
+                nameFormat: string;
+                nameMinLength: string;
+                numericRange: string;
+                emailFormat: string;
+            };
         };
         es: {
             buttons: {
@@ -2483,6 +2482,14 @@ export declare const locales: {
                 beneficial_owners: string;
                 maximal_controllers: string;
             };
+            validation: {
+                required: string;
+                invalid: string;
+                nameFormat: string;
+                nameMinLength: string;
+                numericRange: string;
+                emailFormat: string;
+            };
         };
     };
     Host: {

package/dist/index.js

@@ -26,8 +26,7 @@ const en_json_3 = __importDefault(require("./locales/Common/en.json"));
 const es_json_3 = __importDefault(require("./locales/Common/es.json"));
 const en_json_4 = __importDefault(require("./locales/Host/en.json"));
 const es_json_4 = __importDefault(require("./locales/Host/es.json"));
-__exportStar(require("./constants/fieldMaxLength"), exports);
-__exportStar(require("./constants/documentAutofillFields"), exports);
+__exportStar(require("./constants/fieldValidations"), exports);
 exports.locales = {
     Shared: { en: en_json_1.default, es: es_json_1.default },
     Summary: { en: en_json_2.default, es: es_json_2.default },

package/dist/locales/Common/en.json

@@ -60,5 +60,13 @@
     "legal_representatives": "Legal Representatives",
     "beneficial_owners": "Beneficial Owners",
     "maximal_controllers": "Maximal Controllers"
+  },
+  "validation": {
+    "required": "This field is required",
+    "invalid": "This field is invalid",
+    "nameFormat": "Enter a valid name (letters, spaces, apostrophes and hyphens only)",
+    "nameMinLength": "Name must be at least {min} characters",
+    "numericRange": "Enter a value between {min} and {max}",
+    "emailFormat": "Enter a valid email"
   }
 }

package/dist/locales/Common/es.json

@@ -60,5 +60,13 @@
     "legal_representatives": "Representantes Legales",
     "beneficial_owners": "Beneficiarios Finales",
     "maximal_controllers": "Controladores Máximos"
+  },
+  "validation": {
+    "required": "Este campo es requerido",
+    "invalid": "Este campo es inválido",
+    "nameFormat": "Ingresa un nombre válido (solo letras, espacios, apóstrofes y guiones)",
+    "nameMinLength": "El nombre debe tener al menos {min} caracteres",
+    "numericRange": "Ingresa un valor entre {min} y {max}",
+    "emailFormat": "Ingresa un correo válido"
   }
 }

package/dist/locales/Shared/en.json

@@ -1094,10 +1094,6 @@
       "ZAF": "South Africa",
       "ZMB": "Zambia",
       "ZWE": "Zimbabwe"
-    },
-    "validation": {
-      "required": "This field is required",
-      "invalid": "This field is invalid"
     }
   }
   

package/dist/locales/Shared/es.json

@@ -1094,10 +1094,6 @@
       "ZAF": "Sudáfrica",
       "ZMB": "Zambia",
       "ZWE": "Zimbabue"
-    },
-    "validation": {
-      "required": "Este campo es requerido",
-      "invalid": "Este campo es inválido"
     }
   }
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobre-npm/library-onboarding-core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Shared configurations and resources for onboarding MFEs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/constants/documentAutofillFields.d.ts

@@ -1 +0,0 @@
-export declare const DOCUMENT_AUTOFILL_FIELDS: Record<string, string[]>;

package/dist/constants/documentAutofillFields.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DOCUMENT_AUTOFILL_FIELDS = void 0;
-exports.DOCUMENT_AUTOFILL_FIELDS = {
-    certificate_of_incorporation: [
-        "legal_name", "dba_name", "entity_type", "tax_id_type", "tax_id_number",
-        "incorporation_date", "incorporation_country", "incorporation_state",
-        "incorporation_city", "economic_activity", "business_description",
-        "website", "email", "phone", "registered_address", "operational_address",
-    ],
-    tax_id_documentation: [
-        "tax_id_type", "tax_id_number", "legal_name", "entity_type", "dba_name",
-        "operations_start_date", "economic_activity", "registered_address",
-    ],
-    articles_of_incorporation: [
-        "legal_name", "entity_type", "dba_name", "incorporation_date",
-        "incorporation_country", "incorporation_state", "incorporation_city",
-        "economic_activity", "business_description", "website", "email",
-        "phone", "registered_address", "operational_address",
-    ],
-    shareholder_structure: [
-        "beneficial_owner[].full_name", "beneficial_owner[].percentage_ownership",
-    ],
-    legal_rep_power_of_attorney: [
-        "legal_representative[].full_name", "legal_representative[].identification[]",
-    ],
-    control_documents: [
-        "beneficial_owner[].full_name", "beneficial_owner[].identification[]",
-        "beneficial_owner[].birth_date", "beneficial_owner[].country_of_birth",
-        "beneficial_owner[].nationality", "beneficial_owner[].country_of_residence",
-        "beneficial_owner[].address", "beneficial_owner[].tax_id_type",
-        "beneficial_owner[].tax_id_number", "beneficial_owner[].email",
-        "beneficial_owner[].percentage_ownership",
-    ],
-    bank_certificate_30_days: [],
-};

package/dist/constants/fieldMaxLength.d.ts

@@ -1,3 +0,0 @@
-export declare const DEFAULT_MAX_LENGTH = 500;
-export declare const DEFAULT_PHONE_MAX_LENGTH = 30;
-export declare const FIELD_MAX_LENGTH: Record<string, number>;

package/dist/constants/fieldMaxLength.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FIELD_MAX_LENGTH = exports.DEFAULT_PHONE_MAX_LENGTH = exports.DEFAULT_MAX_LENGTH = void 0;
-exports.DEFAULT_MAX_LENGTH = 500;
-exports.DEFAULT_PHONE_MAX_LENGTH = 30;
-exports.FIELD_MAX_LENGTH = {
-    full_name: 200,
-    phone: 30,
-    legal_name: 300,
-    dba_name: 300,
-    tax_id_number: 50,
-    e_sign_number: 50,
-    incorporation_state: 100,
-    incorporation_city: 100,
-    business_description: 2000,
-    website: 500,
-    line_1: 200,
-    line_2: 200,
-    city: 100,
-    state: 100,
-    postal_code: 20,
-    tax_id_type: 50,
-    curp: 18,
-    migration_status: 100,
-    migration_form_number: 50,
-    nationality: 100,
-    birth_country: 100,
-    country_of_birth: 100,
-    country_of_residence: 100,
-    state_of_birth: 100,
-    occupation: 200,
-    number: 50,
-    first_name: 100,
-    middle_name: 100,
-    last_name: 100,
-    company_relationship: 200,
-    public_office_position: 500,
-    legal_proceedings_description: 5000,
-    funds_source_other_description: 1000,
-    monthly_counterparties_count: 100,
-    third_party_id: 100,
-};