@adyllsxn/kwavalidator 1.0.0

package/dist/abstractions/i-bi-validator.d.ts

@@ -0,0 +1,4 @@
+import { BiValidationResult } from '../models/bi-validation-result.js';
+export interface IBiValidator {
+    validate(bi: string): BiValidationResult;
+}

package/dist/abstractions/i-bi-validator.js

@@ -0,0 +1 @@
+export {};

package/dist/enums/bi-validation-error.d.ts

@@ -0,0 +1,6 @@
+export declare enum BiValidationError {
+    Empty = "Empty",
+    InvalidLength = "InvalidLength",
+    InvalidFormat = "InvalidFormat",
+    InvalidProvince = "InvalidProvince"
+}

package/dist/enums/bi-validation-error.js

@@ -0,0 +1,7 @@
+export var BiValidationError;
+(function (BiValidationError) {
+    BiValidationError["Empty"] = "Empty";
+    BiValidationError["InvalidLength"] = "InvalidLength";
+    BiValidationError["InvalidFormat"] = "InvalidFormat";
+    BiValidationError["InvalidProvince"] = "InvalidProvince";
+})(BiValidationError || (BiValidationError = {}));

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { BiValidationResult } from './models/bi-validation-result.js';
+export * from './abstractions/i-bi-validator.js';
+export * from './enums/bi-validation-error.js';
+export * from './models/province.js';
+export * from './models/bi-validation-result.js';
+export * from './services/bi-validator.js';
+export declare function validateBI(bi: string): BiValidationResult;

package/dist/index.js

@@ -0,0 +1,11 @@
+import { BiValidator } from './services/bi-validator.js';
+export * from './abstractions/i-bi-validator.js';
+export * from './enums/bi-validation-error.js';
+export * from './models/province.js';
+export * from './models/bi-validation-result.js';
+export * from './services/bi-validator.js';
+// Adicione esta função que o teu app.js está a tentar chamar:
+export function validateBI(bi) {
+    const validator = new BiValidator();
+    return validator.validate(bi);
+}

package/dist/models/bi-validation-result.d.ts

@@ -0,0 +1,11 @@
+import { BiValidationError } from '../enums/bi-validation-error.js';
+import { Province } from './province.js';
+export declare class BiValidationResult {
+    readonly isValid: boolean;
+    readonly errorMessage?: string;
+    readonly errorCode?: BiValidationError;
+    readonly province?: Province;
+    private constructor();
+    static success(province: Province): BiValidationResult;
+    static failure(error: BiValidationError, message: string): BiValidationResult;
+}

package/dist/models/bi-validation-result.js

@@ -0,0 +1,18 @@
+export class BiValidationResult {
+    isValid;
+    errorMessage;
+    errorCode;
+    province;
+    constructor(init) {
+        this.isValid = init.isValid ?? false;
+        this.errorMessage = init.errorMessage;
+        this.errorCode = init.errorCode;
+        this.province = init.province;
+    }
+    static success(province) {
+        return new BiValidationResult({ isValid: true, province });
+    }
+    static failure(error, message) {
+        return new BiValidationResult({ isValid: false, errorCode: error, errorMessage: message });
+    }
+}

package/dist/models/province.d.ts

@@ -0,0 +1,5 @@
+export declare class Province {
+    readonly code: string;
+    readonly name: string;
+    constructor(code: string, name: string);
+}

package/dist/models/province.js

@@ -0,0 +1,8 @@
+export class Province {
+    code;
+    name;
+    constructor(code, name) {
+        this.code = code;
+        this.name = name;
+    }
+}

package/dist/services/bi-validator.d.ts

@@ -0,0 +1,7 @@
+import { IBiValidator } from '../abstractions/i-bi-validator.js';
+import { BiValidationResult } from '../models/bi-validation-result.js';
+export declare class BiValidator implements IBiValidator {
+    private static readonly BiRegex;
+    private static readonly Provinces;
+    validate(bi: string): BiValidationResult;
+}

package/dist/services/bi-validator.js

@@ -0,0 +1,48 @@
+import { BiValidationResult } from '../models/bi-validation-result.js';
+import { BiValidationError } from '../enums/bi-validation-error.js';
+import { Province } from '../models/province.js';
+export class BiValidator {
+    // Regex atualizada para suportar as 2 letras das províncias normais E as 3 letras de KNo/KSu
+    static BiRegex = /^\d{9}([A-Z]{2}\d{3}|K[A-Za-z]{2}\d{2})$/;
+    static Provinces = {
+        'BL': new Province('BL', 'Bengo'),
+        'BG': new Province('BG', 'Benguela'),
+        'BI': new Province('BI', 'Bié'),
+        'CB': new Province('CB', 'Cabinda'),
+        'CC': new Province('CC', 'Cuando Cubango'),
+        'CN': new Province('CN', 'Cunene'),
+        'HU': new Province('HU', 'Huambo'),
+        'HL': new Province('HL', 'Huíla'),
+        'LA': new Province('LA', 'Luanda'),
+        'LN': new Province('LN', 'Lunda Norte'), // Corrigido de LD para LN (padrão oficial)
+        'LS': new Province('LS', 'Lunda Sul'),
+        'ML': new Province('ML', 'Malanje'),
+        'MO': new Province('MO', 'Moxico'),
+        'NA': new Province('NA', 'Namibe'),
+        'UI': new Province('UI', 'Uíge'),
+        'ZA': new Province('ZA', 'Zaire'),
+        'KNO': new Province('KNO', 'Cuanza Norte'),
+        'KSU': new Province('KSU', 'Cuanza Sul')
+    };
+    validate(bi) {
+        if (!bi || bi.trim() === '') {
+            return BiValidationResult.failure(BiValidationError.Empty, 'BI is required');
+        }
+        if (bi.length !== 14) {
+            return BiValidationResult.failure(BiValidationError.InvalidLength, 'BI must have 14 characters');
+        }
+        const upperBi = bi.toUpperCase();
+        if (!BiValidator.BiRegex.test(upperBi)) {
+            return BiValidationResult.failure(BiValidationError.InvalidFormat, 'BI format is invalid');
+        }
+        // Captura o código da província de forma dinâmica (se começa com K pega 3 letras, senão 2)
+        const provinceCode = upperBi.startsWith('K', 9)
+            ? upperBi.substring(9, 12)
+            : upperBi.substring(9, 11);
+        const province = BiValidator.Provinces[provinceCode];
+        if (!province) {
+            return BiValidationResult.failure(BiValidationError.InvalidProvince, 'Invalid province code');
+        }
+        return BiValidationResult.success(province);
+    }
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@adyllsxn/kwavalidator",
+  "version": "1.0.0",
+  "description": "Cross-platform library for validating Angolan documents with speed, simplicity",
+  "keywords": [
+    "bi",
+    "nif"
+  ],
+  "license": "MIT",
+  "author": "Domingos Nascimento",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}

package/src/abstractions/i-bi-validator.ts

@@ -0,0 +1,5 @@
+import { BiValidationResult } from '../models/bi-validation-result.js';
+
+export interface IBiValidator {
+  validate(bi: string): BiValidationResult;
+}

package/src/enums/bi-validation-error.ts

@@ -0,0 +1,6 @@
+export enum BiValidationError {
+  Empty = 'Empty',
+  InvalidLength = 'InvalidLength',
+  InvalidFormat = 'InvalidFormat',
+  InvalidProvince = 'InvalidProvince'
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+import { BiValidator } from './services/bi-validator.js';
+import { BiValidationResult } from './models/bi-validation-result.js';
+
+export * from './abstractions/i-bi-validator.js';
+export * from './enums/bi-validation-error.js';
+export * from './models/province.js';
+export * from './models/bi-validation-result.js';
+export * from './services/bi-validator.js';
+
+// Adicione esta função que o teu app.js está a tentar chamar:
+export function validateBI(bi: string): BiValidationResult {
+  const validator = new BiValidator();
+  return validator.validate(bi);
+}

package/src/models/bi-validation-result.ts

@@ -0,0 +1,24 @@
+import { BiValidationError } from '../enums/bi-validation-error.js';
+import { Province } from './province.js';
+
+export class BiValidationResult {
+  public readonly isValid: boolean;
+  public readonly errorMessage?: string;
+  public readonly errorCode?: BiValidationError;
+  public readonly province?: Province;
+
+  private constructor(init: Partial<BiValidationResult>) {
+    this.isValid = init.isValid ?? false;
+    this.errorMessage = init.errorMessage;
+    this.errorCode = init.errorCode;
+    this.province = init.province;
+  }
+
+  public static success(province: Province): BiValidationResult {
+    return new BiValidationResult({ isValid: true, province });
+  }
+
+  public static failure(error: BiValidationError, message: string): BiValidationResult {
+    return new BiValidationResult({ isValid: false, errorCode: error, errorMessage: message });
+  }
+}

package/src/models/province.ts

@@ -0,0 +1,6 @@
+export class Province {
+  constructor(
+    public readonly code: string,
+    public readonly name: string
+  ) {}
+}

package/src/services/bi-validator.ts

@@ -0,0 +1,59 @@
+import { IBiValidator } from '../abstractions/i-bi-validator.js';
+import { BiValidationResult } from '../models/bi-validation-result.js';
+import { BiValidationError } from '../enums/bi-validation-error.js';
+import { Province } from '../models/province.js';
+
+export class BiValidator implements IBiValidator {
+  // Regex atualizada para suportar as 2 letras das províncias normais E as 3 letras de KNo/KSu
+  private static readonly BiRegex = /^\d{9}([A-Z]{2}\d{3}|K[A-Za-z]{2}\d{2})$/;
+
+  private static readonly Provinces: Record<string, Province> = {
+    'BL': new Province('BL', 'Bengo'),
+    'BG': new Province('BG', 'Benguela'),
+    'BI': new Province('BI', 'Bié'),
+    'CB': new Province('CB', 'Cabinda'),
+    'CC': new Province('CC', 'Cuando Cubango'),
+    'CN': new Province('CN', 'Cunene'),
+    'HU': new Province('HU', 'Huambo'),
+    'HL': new Province('HL', 'Huíla'),
+    'LA': new Province('LA', 'Luanda'),
+    'LN': new Province('LN', 'Lunda Norte'), // Corrigido de LD para LN (padrão oficial)
+    'LS': new Province('LS', 'Lunda Sul'),
+    'ML': new Province('ML', 'Malanje'),
+    'MO': new Province('MO', 'Moxico'),
+    'NA': new Province('NA', 'Namibe'),
+    'UI': new Province('UI', 'Uíge'),
+    'ZA': new Province('ZA', 'Zaire'),
+    'KNO': new Province('KNO', 'Cuanza Norte'),
+    'KSU': new Province('KSU', 'Cuanza Sul')
+  };
+
+  public validate(bi: string): BiValidationResult {
+    if (!bi || bi.trim() === '') {
+      return BiValidationResult.failure(BiValidationError.Empty, 'BI is required');
+    }
+
+    if (bi.length !== 14) {
+      return BiValidationResult.failure(BiValidationError.InvalidLength, 'BI must have 14 characters');
+    }
+
+    const upperBi = bi.toUpperCase();
+
+    if (!BiValidator.BiRegex.test(upperBi)) {
+      return BiValidationResult.failure(BiValidationError.InvalidFormat, 'BI format is invalid');
+    }
+
+    // Captura o código da província de forma dinâmica (se começa com K pega 3 letras, senão 2)
+    const provinceCode = upperBi.startsWith('K', 9) 
+      ? upperBi.substring(9, 12) 
+      : upperBi.substring(9, 11);
+
+    const province = BiValidator.Provinces[provinceCode];
+
+    if (!province) {
+      return BiValidationResult.failure(BiValidationError.InvalidProvince, 'Invalid province code');
+    }
+
+    return BiValidationResult.success(province);
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}