@ripwords/myinvois-client 0.2.38 → 0.2.39

package/dist/index30.cjs

@@ -1,73 +1,193 @@
 
-//#region src/types/msic/7X.d.ts
-let MSIC_7X = /* @__PURE__ */ function(MSIC_7X$1) {
-	MSIC_7X$1["HEAD_OFFICES"] = "70100";
-	MSIC_7X$1["BUSINESS_MANAGEMENT_CONSULTANCY"] = "70201";
-	MSIC_7X$1["HR_CONSULTANCY"] = "70202";
-	MSIC_7X$1["PR_COMMUNICATIONS_CONSULTANCY"] = "70203";
-	MSIC_7X$1["OTHER_MANAGEMENT_CONSULTANCY"] = "70209";
-	MSIC_7X$1["ARCHITECTURAL_SERVICES"] = "71101";
-	MSIC_7X$1["ENGINEERING_SERVICES"] = "71102";
-	MSIC_7X$1["LAND_SURVEYING"] = "71103";
-	MSIC_7X$1["OTHER_ARCHITECTURAL_ENGINEERING"] = "71109";
-	MSIC_7X$1["TECHNICAL_TESTING"] = "71200";
-	MSIC_7X$1["NATURAL_SCIENCES_RESEARCH"] = "72101";
-	MSIC_7X$1["ENGINEERING_RESEARCH"] = "72102";
-	MSIC_7X$1["MEDICAL_SCIENCES_RESEARCH"] = "72103";
-	MSIC_7X$1["BIOTECHNOLOGY_RESEARCH"] = "72104";
-	MSIC_7X$1["AGRICULTURAL_SCIENCES_RESEARCH"] = "72105";
-	MSIC_7X$1["ICT_RESEARCH"] = "72106";
-	MSIC_7X$1["OTHER_NATURAL_SCIENCES_RESEARCH"] = "72109";
-	MSIC_7X$1["SOCIAL_SCIENCES_RESEARCH"] = "72201";
-	MSIC_7X$1["HUMANITIES_RESEARCH"] = "72202";
-	MSIC_7X$1["OTHER_SOCIAL_SCIENCES_RESEARCH"] = "72209";
-	MSIC_7X$1["ADVERTISING"] = "73100";
-	MSIC_7X$1["MARKET_RESEARCH"] = "73200";
-	MSIC_7X$1["INTERIOR_DECORATING"] = "74101";
-	MSIC_7X$1["GRAPHIC_DESIGN"] = "74102";
-	MSIC_7X$1["FASHION_DESIGN"] = "74103";
-	MSIC_7X$1["OTHER_SPECIALIZED_DESIGN"] = "74109";
-	MSIC_7X$1["PHOTOGRAPHY"] = "74200";
-	MSIC_7X$1["TRANSLATION_SERVICES"] = "74901";
-	MSIC_7X$1["BUSINESS_BROKERAGE"] = "74902";
-	MSIC_7X$1["SECURITY_CONSULTING"] = "74903";
-	MSIC_7X$1["QUANTITY_SURVEYING"] = "74904";
-	MSIC_7X$1["OTHER_CONSULTANCY"] = "74905";
-	MSIC_7X$1["OTHER_PROFESSIONAL_ACTIVITIES"] = "74909";
-	MSIC_7X$1["VETERINARY_ACTIVITIES"] = "75000";
-	MSIC_7X$1["CAR_RENTAL"] = "77101";
-	MSIC_7X$1["TRUCK_RENTAL"] = "77102";
-	MSIC_7X$1["BOAT_RENTAL"] = "77211";
-	MSIC_7X$1["BICYCLE_RENTAL"] = "77212";
-	MSIC_7X$1["BEACH_EQUIPMENT_RENTAL"] = "77213";
-	MSIC_7X$1["OTHER_SPORTS_EQUIPMENT_RENTAL"] = "77219";
-	MSIC_7X$1["VIDEO_RENTAL"] = "77220";
-	MSIC_7X$1["CLOTHING_RENTAL"] = "77291";
-	MSIC_7X$1["HOUSEHOLD_ITEMS_RENTAL"] = "77292";
-	MSIC_7X$1["JEWELRY_RENTAL"] = "77293";
-	MSIC_7X$1["BOOK_RENTAL"] = "77294";
-	MSIC_7X$1["HOBBY_EQUIPMENT_RENTAL"] = "77295";
-	MSIC_7X$1["PLANT_RENTAL"] = "77296";
-	MSIC_7X$1["ELECTRONICS_RENTAL"] = "77297";
-	MSIC_7X$1["OTHER_PERSONAL_GOODS_RENTAL"] = "77299";
-	MSIC_7X$1["INDUSTRIAL_MACHINERY_RENTAL"] = "77301";
-	MSIC_7X$1["LAND_TRANSPORT_RENTAL"] = "77302";
-	MSIC_7X$1["WATER_TRANSPORT_RENTAL"] = "77303";
-	MSIC_7X$1["AIR_TRANSPORT_RENTAL"] = "77304";
-	MSIC_7X$1["AGRICULTURAL_MACHINERY_RENTAL"] = "77305";
-	MSIC_7X$1["CONSTRUCTION_MACHINERY_RENTAL"] = "77306";
-	MSIC_7X$1["OFFICE_MACHINERY_RENTAL"] = "77307";
-	MSIC_7X$1["OTHER_MACHINERY_RENTAL"] = "77309";
-	MSIC_7X$1["INTELLECTUAL_PROPERTY_LEASING"] = "77400";
-	MSIC_7X$1["EMPLOYMENT_PLACEMENT"] = "78100";
-	MSIC_7X$1["TEMPORARY_EMPLOYMENT"] = "78200";
-	MSIC_7X$1["HR_PROVISION"] = "78300";
-	MSIC_7X$1["TRAVEL_AGENCY"] = "79110";
-	MSIC_7X$1["TOUR_OPERATOR"] = "79120";
-	MSIC_7X$1["OTHER_RESERVATION_SERVICES"] = "79900";
-	return MSIC_7X$1;
-}({});
+//#region src/utils/validation.ts
+/**
+* Validates TIN format based on registration type
+*/
+const validateTIN = (tin, registrationType) => {
+	const errors = [];
+	if (!tin) {
+		errors.push({
+			field: "tin",
+			code: "TIN_REQUIRED",
+			message: "TIN is required",
+			severity: "error"
+		});
+		return errors;
+	}
+	if (registrationType === "BRN" && !tin.startsWith("C")) errors.push({
+		field: "tin",
+		code: "TIN_FORMAT_INVALID",
+		message: "Company TIN should start with \"C\" for BRN registration",
+		severity: "warning"
+	});
+	if (registrationType === "NRIC" && !tin.startsWith("IG")) errors.push({
+		field: "tin",
+		code: "TIN_FORMAT_INVALID",
+		message: "Individual TIN should start with \"IG\" for NRIC registration",
+		severity: "warning"
+	});
+	if (tin.length > 14) errors.push({
+		field: "tin",
+		code: "TIN_LENGTH_INVALID",
+		message: "TIN cannot exceed 14 characters",
+		severity: "error"
+	});
+	return errors;
+};
+/**
+* Validates contact number format (E.164 standard)
+*/
+const validateContactNumber = (contactNumber) => {
+	const errors = [];
+	if (!contactNumber || contactNumber === "NA") return errors;
+	const e164Regex = /^\+[1-9]\d{1,14}$/;
+	if (!e164Regex.test(contactNumber)) errors.push({
+		field: "contactNumber",
+		code: "CONTACT_FORMAT_INVALID",
+		message: "Contact number must be in E.164 format (e.g., +60123456789)",
+		severity: "error"
+	});
+	if (contactNumber.length < 8) errors.push({
+		field: "contactNumber",
+		code: "CONTACT_LENGTH_INVALID",
+		message: "Contact number must be at least 8 characters",
+		severity: "error"
+	});
+	return errors;
+};
+/**
+* Validates monetary amounts
+*/
+const validateMonetaryAmount = (amount, fieldName, maxDigits = 18, maxDecimals = 2) => {
+	const errors = [];
+	if (amount < 0) errors.push({
+		field: fieldName,
+		code: "AMOUNT_NEGATIVE",
+		message: `${fieldName} cannot be negative`,
+		severity: "error"
+	});
+	const amountStr = amount.toString();
+	const [integerPart, decimalPart] = amountStr.split(".");
+	if (integerPart && integerPart.length > maxDigits - maxDecimals) errors.push({
+		field: fieldName,
+		code: "AMOUNT_DIGITS_EXCEEDED",
+		message: `${fieldName} exceeds maximum ${maxDigits} digits`,
+		severity: "error"
+	});
+	if (decimalPart && decimalPart.length > maxDecimals) errors.push({
+		field: fieldName,
+		code: "AMOUNT_DECIMALS_EXCEEDED",
+		message: `${fieldName} exceeds maximum ${maxDecimals} decimal places`,
+		severity: "error"
+	});
+	return errors;
+};
+/**
+* Validates line item tax calculation consistency for both fixed rate and percentage taxation
+*/
+const validateLineItemTax = (item, index) => {
+	const errors = [];
+	const tolerance = .01;
+	const hasFixedRate = item.taxPerUnitAmount !== void 0 && item.baseUnitMeasure !== void 0;
+	const hasPercentageRate = item.taxRate !== void 0;
+	if (!hasFixedRate && !hasPercentageRate) {
+		errors.push({
+			field: `lineItem[${index}]`,
+			code: "TAX_METHOD_MISSING",
+			message: `Line item ${index + 1} must specify either taxRate (for percentage) or taxPerUnitAmount + baseUnitMeasure (for fixed rate)`,
+			severity: "error"
+		});
+		return errors;
+	}
+	if (hasFixedRate && hasPercentageRate) errors.push({
+		field: `lineItem[${index}]`,
+		code: "TAX_METHOD_CONFLICT",
+		message: `Line item ${index + 1} cannot have both percentage and fixed rate tax methods`,
+		severity: "error"
+	});
+	if (hasFixedRate) {
+		if (item.baseUnitMeasureCode === void 0) errors.push({
+			field: `lineItem[${index}].baseUnitMeasureCode`,
+			code: "UNIT_CODE_MISSING",
+			message: `Line item ${index + 1} with fixed rate tax must specify baseUnitMeasureCode`,
+			severity: "error"
+		});
+		const expectedTaxAmount = item.taxPerUnitAmount * item.baseUnitMeasure;
+		if (Math.abs(item.taxAmount - expectedTaxAmount) > tolerance) errors.push({
+			field: `lineItem[${index}].taxAmount`,
+			code: "FIXED_TAX_CALCULATION_MISMATCH",
+			message: `Line item ${index + 1} tax amount (${item.taxAmount}) doesn't match fixed rate calculation (${item.taxPerUnitAmount} × ${item.baseUnitMeasure} = ${expectedTaxAmount})`,
+			severity: "error"
+		});
+	}
+	if (hasPercentageRate && !hasFixedRate) {
+		const expectedTaxAmount = item.totalTaxableAmountPerLine * item.taxRate / 100;
+		if (Math.abs(item.taxAmount - expectedTaxAmount) > tolerance) errors.push({
+			field: `lineItem[${index}].taxAmount`,
+			code: "PERCENTAGE_TAX_CALCULATION_MISMATCH",
+			message: `Line item ${index + 1} tax amount (${item.taxAmount}) doesn't match percentage calculation (${item.totalTaxableAmountPerLine} × ${item.taxRate}% = ${expectedTaxAmount})`,
+			severity: "error"
+		});
+	}
+	return errors;
+};
+/**
+* Validates tax calculation consistency
+*/
+const validateTaxCalculations = (invoice) => {
+	const errors = [];
+	invoice.invoiceLineItems.forEach((item, index) => {
+		errors.push(...validateLineItemTax(item, index));
+	});
+	const expectedTaxExclusive = invoice.invoiceLineItems.reduce((sum, item) => sum + item.totalTaxableAmountPerLine, 0);
+	const expectedTaxAmount = invoice.invoiceLineItems.reduce((sum, item) => sum + item.taxAmount, 0);
+	const tolerance = .01;
+	if (Math.abs(invoice.legalMonetaryTotal.taxExclusiveAmount - expectedTaxExclusive) > tolerance) errors.push({
+		field: "legalMonetaryTotal.taxExclusiveAmount",
+		code: "TAX_EXCLUSIVE_MISMATCH",
+		message: `Tax exclusive amount (${invoice.legalMonetaryTotal.taxExclusiveAmount}) doesn't match sum of line items (${expectedTaxExclusive})`,
+		severity: "error"
+	});
+	if (Math.abs(invoice.taxTotal.taxAmount - expectedTaxAmount) > tolerance) errors.push({
+		field: "taxTotal.taxAmount",
+		code: "TAX_AMOUNT_MISMATCH",
+		message: `Tax amount (${invoice.taxTotal.taxAmount}) doesn't match sum of line item taxes (${expectedTaxAmount})`,
+		severity: "error"
+	});
+	return errors;
+};
+/**
+* Main validation function for complete invoice
+*/
+const validateInvoice = (invoice) => {
+	const allErrors = [];
+	allErrors.push(...validateTIN(invoice.supplier.tin, invoice.supplier.registrationType));
+	allErrors.push(...validateTIN(invoice.buyer.tin, invoice.buyer.registrationType));
+	allErrors.push(...validateContactNumber(invoice.supplier.contactNumber));
+	allErrors.push(...validateContactNumber(invoice.buyer.contactNumber));
+	allErrors.push(...validateMonetaryAmount(invoice.legalMonetaryTotal.taxExclusiveAmount, "taxExclusiveAmount"));
+	allErrors.push(...validateMonetaryAmount(invoice.legalMonetaryTotal.payableAmount, "payableAmount"));
+	allErrors.push(...validateMonetaryAmount(invoice.taxTotal.taxAmount, "taxAmount"));
+	invoice.invoiceLineItems.forEach((item, index) => {
+		allErrors.push(...validateMonetaryAmount(item.unitPrice, `lineItem[${index}].unitPrice`));
+		allErrors.push(...validateMonetaryAmount(item.taxAmount, `lineItem[${index}].taxAmount`));
+		allErrors.push(...validateMonetaryAmount(item.totalTaxableAmountPerLine, `lineItem[${index}].totalTaxableAmountPerLine`));
+	});
+	allErrors.push(...validateTaxCalculations(invoice));
+	const errors = allErrors.filter((e) => e.severity === "error");
+	const warnings = allErrors.filter((e) => e.severity === "warning");
+	return {
+		isValid: errors.length === 0,
+		errors,
+		warnings
+	};
+};
 
 //#endregion
-exports.MSIC_7X = MSIC_7X;
+exports.validateContactNumber = validateContactNumber;
+exports.validateInvoice = validateInvoice;
+exports.validateLineItemTax = validateLineItemTax;
+exports.validateMonetaryAmount = validateMonetaryAmount;
+exports.validateTIN = validateTIN;
+exports.validateTaxCalculations = validateTaxCalculations;
 //# sourceMappingURL=index30.cjs.map

package/dist/index30.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index30.cjs","names":[],"sources":["../src/types/msic/7X.d.ts"],"sourcesContent":["export type MSIC_7X_CODE =\n  | '70100'\n  | '70201'\n  | '70202'\n  | '70203'\n  | '70209'\n  | '71101'\n  | '71102'\n  | '71103'\n  | '71109'\n  | '71200'\n  | '72101'\n  | '72102'\n  | '72103'\n  | '72104'\n  | '72105'\n  | '72106'\n  | '72109'\n  | '72201'\n  | '72202'\n  | '72209'\n  | '73100'\n  | '73200'\n  | '74101'\n  | '74102'\n  | '74103'\n  | '74109'\n  | '74200'\n  | '74901'\n  | '74902'\n  | '74903'\n  | '74904'\n  | '74905'\n  | '74909'\n  | '75000'\n  | '77101'\n  | '77102'\n  | '77211'\n  | '77212'\n  | '77213'\n  | '77219'\n  | '77220'\n  | '77291'\n  | '77292'\n  | '77293'\n  | '77294'\n  | '77295'\n  | '77296'\n  | '77297'\n  | '77299'\n  | '77301'\n  | '77302'\n  | '77303'\n  | '77304'\n  | '77305'\n  | '77306'\n  | '77307'\n  | '77309'\n  | '77400'\n  | '78100'\n  | '78200'\n  | '78300'\n  | '79110'\n  | '79120'\n  | '79900'\n\nexport enum MSIC_7X {\n  HEAD_OFFICES = '70100',\n  BUSINESS_MANAGEMENT_CONSULTANCY = '70201',\n  HR_CONSULTANCY = '70202',\n  PR_COMMUNICATIONS_CONSULTANCY = '70203',\n  OTHER_MANAGEMENT_CONSULTANCY = '70209',\n  ARCHITECTURAL_SERVICES = '71101',\n  ENGINEERING_SERVICES = '71102',\n  LAND_SURVEYING = '71103',\n  OTHER_ARCHITECTURAL_ENGINEERING = '71109',\n  TECHNICAL_TESTING = '71200',\n  NATURAL_SCIENCES_RESEARCH = '72101',\n  ENGINEERING_RESEARCH = '72102',\n  MEDICAL_SCIENCES_RESEARCH = '72103',\n  BIOTECHNOLOGY_RESEARCH = '72104',\n  AGRICULTURAL_SCIENCES_RESEARCH = '72105',\n  ICT_RESEARCH = '72106',\n  OTHER_NATURAL_SCIENCES_RESEARCH = '72109',\n  SOCIAL_SCIENCES_RESEARCH = '72201',\n  HUMANITIES_RESEARCH = '72202',\n  OTHER_SOCIAL_SCIENCES_RESEARCH = '72209',\n  ADVERTISING = '73100',\n  MARKET_RESEARCH = '73200',\n  INTERIOR_DECORATING = '74101',\n  GRAPHIC_DESIGN = '74102',\n  FASHION_DESIGN = '74103',\n  OTHER_SPECIALIZED_DESIGN = '74109',\n  PHOTOGRAPHY = '74200',\n  TRANSLATION_SERVICES = '74901',\n  BUSINESS_BROKERAGE = '74902',\n  SECURITY_CONSULTING = '74903',\n  QUANTITY_SURVEYING = '74904',\n  OTHER_CONSULTANCY = '74905',\n  OTHER_PROFESSIONAL_ACTIVITIES = '74909',\n  VETERINARY_ACTIVITIES = '75000',\n  CAR_RENTAL = '77101',\n  TRUCK_RENTAL = '77102',\n  BOAT_RENTAL = '77211',\n  BICYCLE_RENTAL = '77212',\n  BEACH_EQUIPMENT_RENTAL = '77213',\n  OTHER_SPORTS_EQUIPMENT_RENTAL = '77219',\n  VIDEO_RENTAL = '77220',\n  CLOTHING_RENTAL = '77291',\n  HOUSEHOLD_ITEMS_RENTAL = '77292',\n  JEWELRY_RENTAL = '77293',\n  BOOK_RENTAL = '77294',\n  HOBBY_EQUIPMENT_RENTAL = '77295',\n  PLANT_RENTAL = '77296',\n  ELECTRONICS_RENTAL = '77297',\n  OTHER_PERSONAL_GOODS_RENTAL = '77299',\n  INDUSTRIAL_MACHINERY_RENTAL = '77301',\n  LAND_TRANSPORT_RENTAL = '77302',\n  WATER_TRANSPORT_RENTAL = '77303',\n  AIR_TRANSPORT_RENTAL = '77304',\n  AGRICULTURAL_MACHINERY_RENTAL = '77305',\n  CONSTRUCTION_MACHINERY_RENTAL = '77306',\n  OFFICE_MACHINERY_RENTAL = '77307',\n  OTHER_MACHINERY_RENTAL = '77309',\n  INTELLECTUAL_PROPERTY_LEASING = '77400',\n  EMPLOYMENT_PLACEMENT = '78100',\n  TEMPORARY_EMPLOYMENT = '78200',\n  HR_PROVISION = '78300',\n  TRAVEL_AGENCY = '79110',\n  TOUR_OPERATOR = '79120',\n  OTHER_RESERVATION_SERVICES = '79900',\n}\n"],"mappings":";;AAkEA,IAAY,8CAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}
+{"version":3,"file":"index30.cjs","names":["tin: string","registrationType?: string","errors: ValidationError[]","contactNumber: string","amount: number","fieldName: string","item: InvoiceLineItem","index: number","invoice: InvoiceV1_1","allErrors: ValidationError[]"],"sources":["../src/utils/validation.ts"],"sourcesContent":["import type { InvoiceV1_1, InvoiceLineItem } from '../types'\n\n/**\n * MyInvois Invoice Validation Utilities\n *\n * Provides comprehensive validation for invoice data before document generation\n * and submission to ensure compliance with MyInvois business rules and format requirements.\n */\n\nexport interface ValidationResult {\n  isValid: boolean\n  errors: ValidationError[]\n  warnings: ValidationWarning[]\n}\n\nexport interface ValidationError {\n  field: string\n  code: string\n  message: string\n  severity: 'error' | 'warning'\n}\n\nexport interface ValidationWarning extends ValidationError {\n  severity: 'warning'\n}\n\n/**\n * Validates TIN format based on registration type\n */\nexport const validateTIN = (\n  tin: string,\n  registrationType?: string,\n): ValidationError[] => {\n  const errors: ValidationError[] = []\n\n  if (!tin) {\n    errors.push({\n      field: 'tin',\n      code: 'TIN_REQUIRED',\n      message: 'TIN is required',\n      severity: 'error',\n    })\n    return errors\n  }\n\n  // TIN format validation based on type\n  if (registrationType === 'BRN' && !tin.startsWith('C')) {\n    errors.push({\n      field: 'tin',\n      code: 'TIN_FORMAT_INVALID',\n      message: 'Company TIN should start with \"C\" for BRN registration',\n      severity: 'warning',\n    })\n  }\n\n  if (registrationType === 'NRIC' && !tin.startsWith('IG')) {\n    errors.push({\n      field: 'tin',\n      code: 'TIN_FORMAT_INVALID',\n      message: 'Individual TIN should start with \"IG\" for NRIC registration',\n      severity: 'warning',\n    })\n  }\n\n  // Length validation\n  if (tin.length > 14) {\n    errors.push({\n      field: 'tin',\n      code: 'TIN_LENGTH_INVALID',\n      message: 'TIN cannot exceed 14 characters',\n      severity: 'error',\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validates contact number format (E.164 standard)\n */\nexport const validateContactNumber = (\n  contactNumber: string,\n): ValidationError[] => {\n  const errors: ValidationError[] = []\n\n  if (!contactNumber || contactNumber === 'NA') {\n    return errors // Allow NA for consolidated e-invoices\n  }\n\n  // E.164 format validation\n  const e164Regex = /^\\+[1-9]\\d{1,14}$/\n  if (!e164Regex.test(contactNumber)) {\n    errors.push({\n      field: 'contactNumber',\n      code: 'CONTACT_FORMAT_INVALID',\n      message: 'Contact number must be in E.164 format (e.g., +60123456789)',\n      severity: 'error',\n    })\n  }\n\n  if (contactNumber.length < 8) {\n    errors.push({\n      field: 'contactNumber',\n      code: 'CONTACT_LENGTH_INVALID',\n      message: 'Contact number must be at least 8 characters',\n      severity: 'error',\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validates monetary amounts\n */\nexport const validateMonetaryAmount = (\n  amount: number,\n  fieldName: string,\n  maxDigits = 18,\n  maxDecimals = 2,\n): ValidationError[] => {\n  const errors: ValidationError[] = []\n\n  if (amount < 0) {\n    errors.push({\n      field: fieldName,\n      code: 'AMOUNT_NEGATIVE',\n      message: `${fieldName} cannot be negative`,\n      severity: 'error',\n    })\n  }\n\n  // Check total digits\n  const amountStr = amount.toString()\n  const [integerPart, decimalPart] = amountStr.split('.')\n\n  if (integerPart && integerPart.length > maxDigits - maxDecimals) {\n    errors.push({\n      field: fieldName,\n      code: 'AMOUNT_DIGITS_EXCEEDED',\n      message: `${fieldName} exceeds maximum ${maxDigits} digits`,\n      severity: 'error',\n    })\n  }\n\n  if (decimalPart && decimalPart.length > maxDecimals) {\n    errors.push({\n      field: fieldName,\n      code: 'AMOUNT_DECIMALS_EXCEEDED',\n      message: `${fieldName} exceeds maximum ${maxDecimals} decimal places`,\n      severity: 'error',\n    })\n  }\n\n  return errors\n}\n\n/**\n * Validates line item tax calculation consistency for both fixed rate and percentage taxation\n */\nexport const validateLineItemTax = (\n  item: InvoiceLineItem,\n  index: number,\n): ValidationError[] => {\n  const errors: ValidationError[] = []\n  const tolerance = 0.01\n\n  // Check if tax calculation method is specified\n  const hasFixedRate =\n    item.taxPerUnitAmount !== undefined && item.baseUnitMeasure !== undefined\n  const hasPercentageRate = item.taxRate !== undefined\n\n  if (!hasFixedRate && !hasPercentageRate) {\n    errors.push({\n      field: `lineItem[${index}]`,\n      code: 'TAX_METHOD_MISSING',\n      message: `Line item ${index + 1} must specify either taxRate (for percentage) or taxPerUnitAmount + baseUnitMeasure (for fixed rate)`,\n      severity: 'error',\n    })\n    return errors\n  }\n\n  if (hasFixedRate && hasPercentageRate) {\n    errors.push({\n      field: `lineItem[${index}]`,\n      code: 'TAX_METHOD_CONFLICT',\n      message: `Line item ${index + 1} cannot have both percentage and fixed rate tax methods`,\n      severity: 'error',\n    })\n  }\n\n  // Validate fixed rate tax calculation\n  if (hasFixedRate) {\n    if (item.baseUnitMeasureCode === undefined) {\n      errors.push({\n        field: `lineItem[${index}].baseUnitMeasureCode`,\n        code: 'UNIT_CODE_MISSING',\n        message: `Line item ${index + 1} with fixed rate tax must specify baseUnitMeasureCode`,\n        severity: 'error',\n      })\n    }\n\n    const expectedTaxAmount = item.taxPerUnitAmount! * item.baseUnitMeasure!\n    if (Math.abs(item.taxAmount - expectedTaxAmount) > tolerance) {\n      errors.push({\n        field: `lineItem[${index}].taxAmount`,\n        code: 'FIXED_TAX_CALCULATION_MISMATCH',\n        message: `Line item ${index + 1} tax amount (${item.taxAmount}) doesn't match fixed rate calculation (${item.taxPerUnitAmount} × ${item.baseUnitMeasure} = ${expectedTaxAmount})`,\n        severity: 'error',\n      })\n    }\n  }\n\n  // Validate percentage tax calculation\n  if (hasPercentageRate && !hasFixedRate) {\n    const expectedTaxAmount =\n      (item.totalTaxableAmountPerLine * item.taxRate!) / 100\n    if (Math.abs(item.taxAmount - expectedTaxAmount) > tolerance) {\n      errors.push({\n        field: `lineItem[${index}].taxAmount`,\n        code: 'PERCENTAGE_TAX_CALCULATION_MISMATCH',\n        message: `Line item ${index + 1} tax amount (${item.taxAmount}) doesn't match percentage calculation (${item.totalTaxableAmountPerLine} × ${item.taxRate}% = ${expectedTaxAmount})`,\n        severity: 'error',\n      })\n    }\n  }\n\n  return errors\n}\n\n/**\n * Validates tax calculation consistency\n */\nexport const validateTaxCalculations = (\n  invoice: InvoiceV1_1,\n): ValidationError[] => {\n  const errors: ValidationError[] = []\n\n  // Validate individual line item tax calculations\n  invoice.invoiceLineItems.forEach((item, index) => {\n    errors.push(...validateLineItemTax(item, index))\n  })\n\n  // Calculate expected totals from line items\n  const expectedTaxExclusive = invoice.invoiceLineItems.reduce(\n    (sum, item) => sum + item.totalTaxableAmountPerLine,\n    0,\n  )\n  const expectedTaxAmount = invoice.invoiceLineItems.reduce(\n    (sum, item) => sum + item.taxAmount,\n    0,\n  )\n\n  // Allow small rounding differences (0.01)\n  const tolerance = 0.01\n\n  if (\n    Math.abs(\n      invoice.legalMonetaryTotal.taxExclusiveAmount - expectedTaxExclusive,\n    ) > tolerance\n  ) {\n    errors.push({\n      field: 'legalMonetaryTotal.taxExclusiveAmount',\n      code: 'TAX_EXCLUSIVE_MISMATCH',\n      message: `Tax exclusive amount (${invoice.legalMonetaryTotal.taxExclusiveAmount}) doesn't match sum of line items (${expectedTaxExclusive})`,\n      severity: 'error',\n    })\n  }\n\n  if (Math.abs(invoice.taxTotal.taxAmount - expectedTaxAmount) > tolerance) {\n    errors.push({\n      field: 'taxTotal.taxAmount',\n      code: 'TAX_AMOUNT_MISMATCH',\n      message: `Tax amount (${invoice.taxTotal.taxAmount}) doesn't match sum of line item taxes (${expectedTaxAmount})`,\n      severity: 'error',\n    })\n  }\n\n  return errors\n}\n\n/**\n * Main validation function for complete invoice\n */\nexport const validateInvoice = (invoice: InvoiceV1_1): ValidationResult => {\n  const allErrors: ValidationError[] = []\n\n  // Core field validations\n  allErrors.push(\n    ...validateTIN(invoice.supplier.tin, invoice.supplier.registrationType),\n  )\n  allErrors.push(\n    ...validateTIN(invoice.buyer.tin, invoice.buyer.registrationType),\n  )\n\n  allErrors.push(...validateContactNumber(invoice.supplier.contactNumber))\n  allErrors.push(...validateContactNumber(invoice.buyer.contactNumber))\n\n  // Monetary validations\n  allErrors.push(\n    ...validateMonetaryAmount(\n      invoice.legalMonetaryTotal.taxExclusiveAmount,\n      'taxExclusiveAmount',\n    ),\n  )\n  allErrors.push(\n    ...validateMonetaryAmount(\n      invoice.legalMonetaryTotal.payableAmount,\n      'payableAmount',\n    ),\n  )\n  allErrors.push(\n    ...validateMonetaryAmount(invoice.taxTotal.taxAmount, 'taxAmount'),\n  )\n\n  // Line item validations\n  invoice.invoiceLineItems.forEach((item, index) => {\n    allErrors.push(\n      ...validateMonetaryAmount(item.unitPrice, `lineItem[${index}].unitPrice`),\n    )\n    allErrors.push(\n      ...validateMonetaryAmount(item.taxAmount, `lineItem[${index}].taxAmount`),\n    )\n    allErrors.push(\n      ...validateMonetaryAmount(\n        item.totalTaxableAmountPerLine,\n        `lineItem[${index}].totalTaxableAmountPerLine`,\n      ),\n    )\n  })\n\n  // Business rule validations\n  allErrors.push(...validateTaxCalculations(invoice))\n\n  // Separate errors and warnings\n  const errors = allErrors.filter(e => e.severity === 'error')\n  const warnings = allErrors.filter(\n    e => e.severity === 'warning',\n  ) as ValidationWarning[]\n\n  return {\n    isValid: errors.length === 0,\n    errors,\n    warnings,\n  }\n}\n"],"mappings":"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"}