@ripwords/myinvois-client 0.3.3 → 0.3.4

package/dist/{taxpayerValidation-y6P-Es0S.js → taxpayerValidation-Xd_EHDvk.js}

@@ -3,18 +3,21 @@ import { formatIdValue } from "./formatIdValue-qTxJqj9o.js";
 //#region src/api/taxpayerValidation.ts
 async function tinSearch(context, params) {
 	const { fetch, debug } = context;
-	const { taxpayerName, idType, idValue } = params;
-	if (!taxpayerName && (!idType || !idValue)) throw new Error("Either taxpayerName must be provided, or both idType and idValue must be provided");
+	const { taxpayerName, idType, idValue, fileType } = params;
 	if (idType && !idValue || !idType && idValue) throw new Error("idType and idValue must be provided together");
+	if (fileType && (!idType || !idValue)) throw new Error("fileType can only be provided together with idType and idValue");
+	if (!taxpayerName && (!idType || !idValue)) throw new Error("Either taxpayerName must be provided, or both idType and idValue must be provided");
 	const queryParams = new URLSearchParams();
-	if (taxpayerName) queryParams.append("taxpayerName", taxpayerName);
 	if (idType && idValue) {
 		queryParams.append("idType", idType);
 		queryParams.append("idValue", formatIdValue(idValue));
 	}
+	if (fileType) queryParams.append("fileType", fileType);
+	if (taxpayerName) queryParams.append("idName", taxpayerName);
 	const queryString = queryParams.toString();
 	try {
 		const response = await fetch(`/api/v1.0/taxpayer/search/tin?${queryString}`, { method: "GET" });
+		if (!response.ok) throw new Error(`Failed to search TIN: ${await response.text()}`);
 		return await response.json();
 	} catch (error) {
 		if (debug) console.error("TIN search error:", error);

package/dist/{taxpayerValidation-D_jGaVty.cjs → taxpayerValidation-j8s6YGED.cjs}

@@ -3,18 +3,21 @@ const require_formatIdValue = require('./formatIdValue-i67o4kyD.cjs');
 //#region src/api/taxpayerValidation.ts
 async function tinSearch(context, params) {
 	const { fetch, debug } = context;
-	const { taxpayerName, idType, idValue } = params;
-	if (!taxpayerName && (!idType || !idValue)) throw new Error("Either taxpayerName must be provided, or both idType and idValue must be provided");
+	const { taxpayerName, idType, idValue, fileType } = params;
 	if (idType && !idValue || !idType && idValue) throw new Error("idType and idValue must be provided together");
+	if (fileType && (!idType || !idValue)) throw new Error("fileType can only be provided together with idType and idValue");
+	if (!taxpayerName && (!idType || !idValue)) throw new Error("Either taxpayerName must be provided, or both idType and idValue must be provided");
 	const queryParams = new URLSearchParams();
-	if (taxpayerName) queryParams.append("taxpayerName", taxpayerName);
 	if (idType && idValue) {
 		queryParams.append("idType", idType);
 		queryParams.append("idValue", require_formatIdValue.formatIdValue(idValue));
 	}
+	if (fileType) queryParams.append("fileType", fileType);
+	if (taxpayerName) queryParams.append("idName", taxpayerName);
 	const queryString = queryParams.toString();
 	try {
 		const response = await fetch(`/api/v1.0/taxpayer/search/tin?${queryString}`, { method: "GET" });
+		if (!response.ok) throw new Error(`Failed to search TIN: ${await response.text()}`);
 		return await response.json();
 	} catch (error) {
 		if (debug) console.error("TIN search error:", error);
@@ -59,4 +62,4 @@ Object.defineProperty(exports, 'verifyTin', {
     return verifyTin;
   }
 });
-//# sourceMappingURL=taxpayerValidation-D_jGaVty.cjs.map
+//# sourceMappingURL=taxpayerValidation-j8s6YGED.cjs.map

package/dist/taxpayerValidation-j8s6YGED.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxpayerValidation-j8s6YGED.cjs","names":["context: TaxpayerContext","params: TinSearchParams","tin: string","idType: RegistrationType","idValue: string","qrCodeText: string"],"sources":["../src/api/taxpayerValidation.ts"],"sourcesContent":["import { formatIdValue } from 'src/utils/formatIdValue'\nimport type {\n  Fetch,\n  RegistrationType,\n  TaxpayerQRCodeResponse,\n  TinSearchParams,\n  TinSearchResponse,\n} from '../types'\n\ninterface TaxpayerContext {\n  fetch: Fetch\n  debug: boolean\n}\n\nexport async function tinSearch(\n  context: TaxpayerContext,\n  params: TinSearchParams,\n): Promise<TinSearchResponse> {\n  const { fetch, debug } = context\n  const { taxpayerName, idType, idValue, fileType } = params\n\n  // Validate input parameters according to API requirements\n  // Valid combinations:\n  // 1. taxpayerName alone\n  // 2. taxpayerName + idType + idValue (all three)\n  // 3. idType + idValue (both)\n  // 4. idType + idValue + fileType (all three)\n  // 5. All parameters together (AND operator)\n\n  // idType and idValue must be provided together\n  if ((idType && !idValue) || (!idType && idValue)) {\n    throw new Error('idType and idValue must be provided together')\n  }\n\n  // fileType can only be provided with idType and idValue\n  if (fileType && (!idType || !idValue)) {\n    throw new Error(\n      'fileType can only be provided together with idType and idValue',\n    )\n  }\n\n  // Must have at least one valid combination:\n  // - taxpayerName alone, OR\n  // - idType + idValue (with optional fileType)\n  if (!taxpayerName && (!idType || !idValue)) {\n    throw new Error(\n      'Either taxpayerName must be provided, or both idType and idValue must be provided',\n    )\n  }\n\n  // Build query parameters\n  const queryParams = new URLSearchParams()\n\n  if (idType && idValue) {\n    queryParams.append('idType', idType)\n    queryParams.append('idValue', formatIdValue(idValue))\n  }\n\n  if (fileType) {\n    queryParams.append('fileType', fileType)\n  }\n\n  if (taxpayerName) {\n    queryParams.append('idName', taxpayerName)\n  }\n\n  const queryString = queryParams.toString()\n\n  try {\n    const response = await fetch(\n      `/api/v1.0/taxpayer/search/tin?${queryString}`,\n      {\n        method: 'GET',\n      },\n    )\n    if (!response.ok) {\n      throw new Error(`Failed to search TIN: ${await response.text()}`)\n    }\n    return (await response.json()) as TinSearchResponse\n  } catch (error) {\n    if (debug) {\n      console.error('TIN search error:', error)\n    }\n    throw error\n  }\n}\n\nexport async function verifyTin(\n  context: TaxpayerContext,\n  tin: string,\n  idType: RegistrationType,\n  idValue: string,\n): Promise<boolean> {\n  const { fetch, debug } = context\n\n  try {\n    const response = await fetch(\n      `/api/v1.0/taxpayer/validate/${tin}?idType=${idType}&idValue=${formatIdValue(idValue)}`,\n      {\n        method: 'GET',\n      },\n    )\n\n    if (!response) {\n      // Fetch was stubbed to return undefined or network error occurred\n      return false\n    }\n\n    if (response.ok || response.status === 200) {\n      return true\n    }\n\n    return false\n  } catch (error) {\n    if (debug) {\n      console.error(error)\n    }\n    return false\n  }\n}\n\nexport async function taxpayerQRCode(\n  context: TaxpayerContext,\n  qrCodeText: string,\n): Promise<TaxpayerQRCodeResponse> {\n  const { fetch } = context\n\n  const base64EncodedQRCodeText = Buffer.from(qrCodeText).toString('base64')\n\n  const response = await fetch(\n    `/api/v1.0/taxpayer/qrcodeinfo/${base64EncodedQRCodeText}`,\n  )\n\n  return response.json()\n}\n"],"mappings":";;;AAcA,eAAsB,UACpBA,SACAC,QAC4B;CAC5B,MAAM,EAAE,OAAO,OAAO,GAAG;CACzB,MAAM,EAAE,cAAc,QAAQ,SAAS,UAAU,GAAG;AAWpD,KAAK,WAAW,YAAc,UAAU,QACtC,OAAM,IAAI,MAAM;AAIlB,KAAI,cAAc,WAAW,SAC3B,OAAM,IAAI,MACR;AAOJ,MAAK,kBAAkB,WAAW,SAChC,OAAM,IAAI,MACR;CAKJ,MAAM,cAAc,IAAI;AAExB,KAAI,UAAU,SAAS;AACrB,cAAY,OAAO,UAAU,OAAO;AACpC,cAAY,OAAO,WAAW,oCAAc,QAAQ,CAAC;CACtD;AAED,KAAI,SACF,aAAY,OAAO,YAAY,SAAS;AAG1C,KAAI,aACF,aAAY,OAAO,UAAU,aAAa;CAG5C,MAAM,cAAc,YAAY,UAAU;AAE1C,KAAI;EACF,MAAM,WAAW,MAAM,OACpB,gCAAgC,YAAY,GAC7C,EACE,QAAQ,MACT,EACF;AACD,OAAK,SAAS,GACZ,OAAM,IAAI,OAAO,wBAAwB,MAAM,SAAS,MAAM,CAAC;AAEjE,SAAQ,MAAM,SAAS,MAAM;CAC9B,SAAQ,OAAO;AACd,MAAI,MACF,SAAQ,MAAM,qBAAqB,MAAM;AAE3C,QAAM;CACP;AACF;AAED,eAAsB,UACpBD,SACAE,KACAC,QACAC,SACkB;CAClB,MAAM,EAAE,OAAO,OAAO,GAAG;AAEzB,KAAI;EACF,MAAM,WAAW,MAAM,OACpB,8BAA8B,IAAI,UAAU,OAAO,WAAW,oCAAc,QAAQ,CAAC,GACtF,EACE,QAAQ,MACT,EACF;AAED,OAAK,SAEH,QAAO;AAGT,MAAI,SAAS,MAAM,SAAS,WAAW,IACrC,QAAO;AAGT,SAAO;CACR,SAAQ,OAAO;AACd,MAAI,MACF,SAAQ,MAAM,MAAM;AAEtB,SAAO;CACR;AACF;AAED,eAAsB,eACpBJ,SACAK,YACiC;CACjC,MAAM,EAAE,OAAO,GAAG;CAElB,MAAM,0BAA0B,OAAO,KAAK,WAAW,CAAC,SAAS,SAAS;CAE1E,MAAM,WAAW,MAAM,OACpB,gCAAgC,wBAAwB,EAC1D;AAED,QAAO,SAAS,MAAM;AACvB"}

package/dist/types/index.d.ts

@@ -55,7 +55,7 @@ import { Address, AllDocumentsV1_1, Buyer, CompleteInvoice, CreditNoteV1_1, Debi
 import { PaymentMode, PaymentModeCode, PaymentModeCodeEnum } from "../payment-modes-g3DzLmWb.js";
 import { CanonicalizationMethod, Cert, CertDigest, DigestMethod, IssuerDigitalSignature, IssuerSerial, KeyInfo, QualifyingProperties, Reference, SignatureMethod, SignedInfo, SignedProperties, SignedSignatureProperties, SigningCertificate, Transform, X509Data } from "../signatures-CerHUrj3.js";
 import { Notification, NotificationDeliveryAttempt, NotificationMetadata, NotificationResponse, NotificationSearchParams, NotificationStatus, NotificationStatusEnum, NotificationType, NotificationTypeEnum } from "../notifications-sFhgh3rJ.js";
-import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "../taxpayer-BWpQOlug.js";
+import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "../taxpayer-BAoT73gg.js";
 import { Fetch } from "../utils-C4FoVKLq.js";
 import { ClientCredentials, TokenResponse } from "../index-CygwSf0x.js";
 export { Address, AllDocumentsV1_1, Buyer, CanonicalizationMethod, Cert, CertDigest, Classification, ClassificationCode, ClassificationCodeEnum, ClientCredentials, CompleteInvoice, Country, CountryCode, CountryCodeEnum, CountryNameEnum, CreditNoteV1_1, Currency, CurrencyCode, CurrencyCodeEnum, DebitNoteV1_1, DigestMethod, DocumentStatus, DocumentSummary, DocumentTypeResponse, DocumentTypeVersion, DocumentTypeVersionResponse, DocumentTypesResponse, DocumentValidationResult, DocumentValidationStepResult, EInvoiceType, EInvoiceTypeCode, EInvoiceTypeCodeEnum, Fetch, FinalDocumentData, GetSubmissionResponse, InvoiceLineItem, InvoiceSubmission, InvoiceV1_1, IssuerDigitalSignature, IssuerSerial, KeyInfo, LegalMonetaryTotal, MSICCode, Notification, NotificationDeliveryAttempt, NotificationMetadata, NotificationResponse, NotificationSearchParams, NotificationStatus, NotificationStatusEnum, NotificationType, NotificationTypeEnum, PaymentMode, PaymentModeCode, PaymentModeCodeEnum, QualifyingProperties, Reference, RefundNoteV1_1, RegistrationType, ResponseDocument, SelfBilledCreditNoteV1_1, SelfBilledInvoiceV1_1, SelfBilledRefundNoteV1_1, SignatureMethod, SignedInfo, SignedInfoObject, SignedInvoiceSubmission, SignedProperties, SignedPropertiesData, SignedPropertiesObject, SignedSignatureProperties, SigningCertificate, SigningCredentials, StandardError, State, StateCode, StateCodeEnum, SubmissionResponse, SubmissionStatus, Supplier, TaxCategory, TaxSubtotal, TaxTotal, TaxType, TaxTypeCode, TaxTypeCodeEnum, TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse, TokenResponse, Transform, UBLDocument, UnitType, UnitTypeCode, WorkflowParameter, X509Data };

package/dist/types/taxpayer.d.ts

@@ -52,5 +52,5 @@ import "../ZX-CDQOfsHh.js";
 import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../documents-BYV12TVt.js";
-import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "../taxpayer-BWpQOlug.js";
+import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "../taxpayer-BAoT73gg.js";
 export { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse };

package/dist/utils/document.d.ts

@@ -55,7 +55,7 @@ import { AllDocumentsV1_1, CompleteInvoice, InvoiceLineItem, InvoiceSubmission,
 import "../payment-modes-g3DzLmWb.js";
 import "../signatures-CerHUrj3.js";
 import "../notifications-sFhgh3rJ.js";
-import "../taxpayer-BWpQOlug.js";
+import "../taxpayer-BAoT73gg.js";
 import "../utils-C4FoVKLq.js";
 import "../index-CygwSf0x.js";
 

package/dist/utils/signature-diagnostics.d.ts

@@ -55,7 +55,7 @@ import { InvoiceV1_1 } from "../documents-BYV12TVt.js";
 import "../payment-modes-g3DzLmWb.js";
 import "../signatures-CerHUrj3.js";
 import "../notifications-sFhgh3rJ.js";
-import "../taxpayer-BWpQOlug.js";
+import "../taxpayer-BAoT73gg.js";
 import "../utils-C4FoVKLq.js";
 import "../index-CygwSf0x.js";
 

package/dist/utils/validation.d.ts

@@ -55,7 +55,7 @@ import { InvoiceLineItem, InvoiceV1_1 } from "../documents-BYV12TVt.js";
 import "../payment-modes-g3DzLmWb.js";
 import "../signatures-CerHUrj3.js";
 import "../notifications-sFhgh3rJ.js";
-import "../taxpayer-BWpQOlug.js";
+import "../taxpayer-BAoT73gg.js";
 import "../utils-C4FoVKLq.js";
 import "../index-CygwSf0x.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ripwords/myinvois-client",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "MyInvois client",
   "scripts": {
     "build": "tsdown",

package/dist/index15.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index15.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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"}

package/dist/index23.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index23.cjs","names":[],"sources":["../src/types/notifications.d.ts"],"sourcesContent":["export type NotificationType = 3 | 6 | 7 | 8 | 10 | 11 | 15 | 26 | 33 | 34 | 35\n\nexport enum NotificationTypeEnum {\n  'Profile data validation' = 3,\n  'Document received' = 6,\n  'Document validated' = 7,\n  'Document cancelled' = 8,\n  'User profile changed' = 10,\n  'Taxpayer profile changed' = 11,\n  'Document rejection initiated' = 15,\n  'ERP data validation' = 26,\n  'Documents processing summary' = 33,\n  'Document Template Published' = 34,\n  'Document Template Deletion' = 35,\n}\n\nexport type NotificationStatus = 1 | 2 | 3 | 4 | 5\n\nexport enum NotificationStatusEnum {\n  'New' = 1,\n  'Pending' = 2,\n  'Batched' = 3,\n  'Delivered' = 4,\n  'Error' = 5,\n}\n\nexport type NotificationDeliveryAttempt = {\n  attemptDateTime: string\n  status: string\n  statusDetails: string\n}\n\nexport type NotificationMetadata = {\n  hasNext: boolean\n}\n\nexport type Notification = {\n  notificationId: string\n  receiverNName: string\n  notificationDeliveryId: string\n  creationDateTime: string\n  receivedDateTime: string\n  notificationSubject: string\n  deliveredDateTime: string\n  typeId: string\n  typeName: string\n  finalMessage: string\n  address: string\n  language: string\n  status: string\n  deliveryAttempts: NotificationDeliveryAttempt[]\n}\n\nexport type NotificationResponse = {\n  notifications: Notification[]\n  metadata: NotificationMetadata\n}\n\nexport type NotificationSearchParams = {\n  dateFrom?: string\n  dateTo?: string\n  type?: NotificationType\n  language?: string\n  status?: NotificationStatus\n  pageNo?: number\n  pageSize?: number\n}\n"],"mappings":";;AAEA,IAAY,wEAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD;AAID,IAAY,4EAAL;AACL;AACA;AACA;AACA;AACA;;AACD"}

package/dist/index24.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index24.cjs","names":[],"sources":["../src/types/payment-modes.d.ts"],"sourcesContent":["/**\n * Represents the allowed codes for payment modes.\n * Based on the documentation: https://sdk.myinvois.hasil.gov.my/codes/payment-methods/\n */\nexport type PaymentModeCode =\n  | '01' // Cash\n  | '02' // Cheque\n  | '03' // Bank Transfer\n  | '04' // Credit Card\n  | '05' // Debit Card\n  | '06' // e-Wallet / Digital Wallet\n  | '07' // Digital Bank\n  | '08' // Others\n\n/**\n * Enum representing the allowed payment mode codes with descriptive names.\n * Provides a more readable way to reference payment modes.\n *\n * @example\n * const mode = PaymentModeCodeEnum.Cash;\n * console.log(mode); // Output: \"01\"\n */\nexport enum PaymentModeCodeEnum {\n  Cash = '01',\n  Cheque = '02',\n  BankTransfer = '03',\n  CreditCard = '04',\n  DebitCard = '05',\n  EWalletDigitalWallet = '06',\n  DigitalBank = '07',\n  Others = '08',\n}\n\n/**\n * Interface representing a payment mode entry.\n * Contains the code and its corresponding description.\n */\nexport interface PaymentMode {\n  code: PaymentModeCode\n  description: string\n}\n"],"mappings":";;;;;;;;;;AAsBA,IAAY,sEAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}

package/dist/index26.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index26.cjs","names":[],"sources":["../src/types/state-codes.d.ts"],"sourcesContent":["/**\n * Represents the allowed codes for Malaysian states and federal territories.\n * Based on the documentation: https://sdk.myinvois.hasil.gov.my/codes/state-codes/\n */\nexport type StateCode =\n  | '01' // Johor\n  | '02' // Kedah\n  | '03' // Kelantan\n  | '04' // Melaka\n  | '05' // Negeri Sembilan\n  | '06' // Pahang\n  | '07' // Pulau Pinang\n  | '08' // Perak\n  | '09' // Perlis\n  | '10' // Selangor\n  | '11' // Terengganu\n  | '12' // Sabah\n  | '13' // Sarawak\n  | '14' // Wilayah Persekutuan Kuala Lumpur\n  | '15' // Wilayah Persekutuan Labuan\n  | '16' // Wilayah Persekutuan Putrajaya\n  | '17' // Not Applicable\n\n/**\n * Enum representing the allowed state codes with descriptive names.\n * Provides a more readable way to reference states.\n *\n * @example\n * const code = StateCodeEnum.Selangor;\n * console.log(code); // Output: \"10\"\n */\nexport enum StateCodeEnum {\n  Johor = '01',\n  Kedah = '02',\n  Kelantan = '03',\n  Melaka = '04',\n  NegeriSembilan = '05',\n  Pahang = '06',\n  PulauPinang = '07',\n  Perak = '08',\n  Perlis = '09',\n  Selangor = '10',\n  Terengganu = '11',\n  Sabah = '12',\n  Sarawak = '13',\n  WPKualaLumpur = '14',\n  WPLabuan = '15',\n  WPPutrajaya = '16',\n  NotApplicable = '17',\n}\n\n/**\n * Interface representing a state code entry.\n * Contains the code and its corresponding name.\n */\nexport interface State {\n  code: StateCode\n  name: string\n}\n"],"mappings":";;;;;;;;;;AA+BA,IAAY,0DAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}

package/dist/taxpayerValidation-D_jGaVty.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"taxpayerValidation-D_jGaVty.cjs","names":["context: TaxpayerContext","params: TinSearchParams","tin: string","idType: RegistrationType","idValue: string","qrCodeText: string"],"sources":["../src/api/taxpayerValidation.ts"],"sourcesContent":["import { formatIdValue } from 'src/utils/formatIdValue'\nimport type {\n  Fetch,\n  RegistrationType,\n  TaxpayerQRCodeResponse,\n  TinSearchParams,\n  TinSearchResponse,\n} from '../types'\n\ninterface TaxpayerContext {\n  fetch: Fetch\n  debug: boolean\n}\n\nexport async function tinSearch(\n  context: TaxpayerContext,\n  params: TinSearchParams,\n): Promise<TinSearchResponse> {\n  const { fetch, debug } = context\n  const { taxpayerName, idType, idValue } = params\n\n  // Validate input parameters according to API requirements\n  if (!taxpayerName && (!idType || !idValue)) {\n    throw new Error(\n      'Either taxpayerName must be provided, or both idType and idValue must be provided',\n    )\n  }\n\n  if ((idType && !idValue) || (!idType && idValue)) {\n    throw new Error('idType and idValue must be provided together')\n  }\n\n  // Build query parameters\n  const queryParams = new URLSearchParams()\n\n  if (taxpayerName) {\n    queryParams.append('taxpayerName', taxpayerName)\n  }\n\n  if (idType && idValue) {\n    queryParams.append('idType', idType)\n    queryParams.append('idValue', formatIdValue(idValue))\n  }\n\n  const queryString = queryParams.toString()\n\n  try {\n    const response = await fetch(\n      `/api/v1.0/taxpayer/search/tin?${queryString}`,\n      {\n        method: 'GET',\n      },\n    )\n    return (await response.json()) as TinSearchResponse\n  } catch (error) {\n    if (debug) {\n      console.error('TIN search error:', error)\n    }\n    throw error\n  }\n}\n\nexport async function verifyTin(\n  context: TaxpayerContext,\n  tin: string,\n  idType: RegistrationType,\n  idValue: string,\n): Promise<boolean> {\n  const { fetch, debug } = context\n\n  try {\n    const response = await fetch(\n      `/api/v1.0/taxpayer/validate/${tin}?idType=${idType}&idValue=${formatIdValue(idValue)}`,\n      {\n        method: 'GET',\n      },\n    )\n\n    if (!response) {\n      // Fetch was stubbed to return undefined or network error occurred\n      return false\n    }\n\n    if (response.ok || response.status === 200) {\n      return true\n    }\n\n    return false\n  } catch (error) {\n    if (debug) {\n      console.error(error)\n    }\n    return false\n  }\n}\n\nexport async function taxpayerQRCode(\n  context: TaxpayerContext,\n  qrCodeText: string,\n): Promise<TaxpayerQRCodeResponse> {\n  const { fetch } = context\n\n  const base64EncodedQRCodeText = Buffer.from(qrCodeText).toString('base64')\n\n  const response = await fetch(\n    `/api/v1.0/taxpayer/qrcodeinfo/${base64EncodedQRCodeText}`,\n  )\n\n  return response.json()\n}\n"],"mappings":";;;AAcA,eAAsB,UACpBA,SACAC,QAC4B;CAC5B,MAAM,EAAE,OAAO,OAAO,GAAG;CACzB,MAAM,EAAE,cAAc,QAAQ,SAAS,GAAG;AAG1C,MAAK,kBAAkB,WAAW,SAChC,OAAM,IAAI,MACR;AAIJ,KAAK,WAAW,YAAc,UAAU,QACtC,OAAM,IAAI,MAAM;CAIlB,MAAM,cAAc,IAAI;AAExB,KAAI,aACF,aAAY,OAAO,gBAAgB,aAAa;AAGlD,KAAI,UAAU,SAAS;AACrB,cAAY,OAAO,UAAU,OAAO;AACpC,cAAY,OAAO,WAAW,oCAAc,QAAQ,CAAC;CACtD;CAED,MAAM,cAAc,YAAY,UAAU;AAE1C,KAAI;EACF,MAAM,WAAW,MAAM,OACpB,gCAAgC,YAAY,GAC7C,EACE,QAAQ,MACT,EACF;AACD,SAAQ,MAAM,SAAS,MAAM;CAC9B,SAAQ,OAAO;AACd,MAAI,MACF,SAAQ,MAAM,qBAAqB,MAAM;AAE3C,QAAM;CACP;AACF;AAED,eAAsB,UACpBD,SACAE,KACAC,QACAC,SACkB;CAClB,MAAM,EAAE,OAAO,OAAO,GAAG;AAEzB,KAAI;EACF,MAAM,WAAW,MAAM,OACpB,8BAA8B,IAAI,UAAU,OAAO,WAAW,oCAAc,QAAQ,CAAC,GACtF,EACE,QAAQ,MACT,EACF;AAED,OAAK,SAEH,QAAO;AAGT,MAAI,SAAS,MAAM,SAAS,WAAW,IACrC,QAAO;AAGT,SAAO;CACR,SAAQ,OAAO;AACd,MAAI,MACF,SAAQ,MAAM,MAAM;AAEtB,SAAO;CACR;AACF;AAED,eAAsB,eACpBJ,SACAK,YACiC;CACjC,MAAM,EAAE,OAAO,GAAG;CAElB,MAAM,0BAA0B,OAAO,KAAK,WAAW,CAAC,SAAS,SAAS;CAE1E,MAAM,WAAW,MAAM,OACpB,gCAAgC,wBAAwB,EAC1D;AAED,QAAO,SAAS,MAAM;AACvB"}