@ripwords/myinvois-client 0.3.6 → 0.4.0

package/dist/unit-types-VgYXIwTT.d.ts

@@ -1,55 +0,0 @@
-import { UnitTypeCode_1X } from "./1X-C72Wa4pk.js";
-import { UnitTypeCode_2X } from "./2X-CH89y3Af.js";
-import { UnitTypeCode_3X } from "./3X-DryrwYRf.js";
-import { UnitTypeCode_4X } from "./4X-BPMLRoDv.js";
-import { UnitTypeCode_5X } from "./5X-Bv7M6KyG.js";
-import { UnitTypeCode_6X } from "./6X-ZeZ8OB57.js";
-import { UnitTypeCode_7X } from "./7X-Dvw2Z2VN.js";
-import { UnitTypeCode_8X } from "./8X-BkgoX8dg.js";
-import { UnitTypeCode_9X } from "./9X-Du0e44cq.js";
-import { UnitTypeCode_AX } from "./AX-BSPLpkVT.js";
-import { UnitTypeCode_BX } from "./BX-u4yMaIkz.js";
-import { UnitTypeCode_CX } from "./CX-BKZG0pVE.js";
-import { UnitTypeCode_DX } from "./DX-CwA9WJAf.js";
-import { UnitTypeCode_EX } from "./EX-BRNu1Ooi.js";
-import { UnitTypeCode_FX } from "./FX-DBxjq6xY.js";
-import { UnitTypeCode_GX } from "./GX-B3CvWNrP.js";
-import { UnitTypeCode_HX } from "./HX-D7FABgTv.js";
-import { UnitTypeCode_IX } from "./IX-D3ZknsAB.js";
-import { UnitTypeCode_JX } from "./JX-BRaZM3Gc.js";
-import { UnitTypeCode_KX } from "./KX-B1K0OWoi.js";
-import { UnitTypeCode_LX } from "./LX-CKRefinL.js";
-import { UnitTypeCode_MX } from "./MX-DKmaeO9r.js";
-import { UnitTypeCode_NX } from "./NX-CJL2Gn1U.js";
-import { UnitTypeCode_OX } from "./OX-Do2ap5v_.js";
-import { UnitTypeCode_PX } from "./PX-_DOr_rm9.js";
-import { UnitTypeCode_QX } from "./QX-HlXLkIki.js";
-import { UnitTypeCode_RX } from "./RX-DVPGOVES.js";
-import { UnitTypeCode_SX } from "./SX-OGT3qwlS.js";
-import { UnitTypeCode_TX } from "./TX-cPDINmZ5.js";
-import { UnitTypeCode_UX } from "./UX-Be3sqvPV.js";
-import { UnitTypeCode_VX } from "./VX-CoEuBNDK.js";
-import { UnitTypeCode_WX } from "./WX-DMvw__jH.js";
-import { UnitTypeCode_YX } from "./YX-F34sJ7Ik.js";
-import { UnitTypeCode_ZX } from "./ZX-CDQOfsHh.js";
-import { UnitTypeCode_XX } from "./XX-DOA-10JW.js";
-
-//#region src/types/unit-types.d.ts
-
-/**
- * Represents the allowed codes for Unit of Measurement types.
- * Based on UN/ECE Recommendation 20, Revision 17 (2021) as per the documentation:
- * https://sdk.myinvois.hasil.gov.my/codes/unit-types/
- */
-type UnitTypeCode = UnitTypeCode_1X | UnitTypeCode_2X | UnitTypeCode_3X | UnitTypeCode_4X | UnitTypeCode_5X | UnitTypeCode_6X | UnitTypeCode_7X | UnitTypeCode_8X | UnitTypeCode_9X | UnitTypeCode_AX | UnitTypeCode_BX | UnitTypeCode_CX | UnitTypeCode_DX | UnitTypeCode_EX | UnitTypeCode_FX | UnitTypeCode_GX | UnitTypeCode_HX | UnitTypeCode_IX | UnitTypeCode_JX | UnitTypeCode_KX | UnitTypeCode_LX | UnitTypeCode_MX | UnitTypeCode_NX | UnitTypeCode_OX | UnitTypeCode_PX | UnitTypeCode_QX | UnitTypeCode_RX | UnitTypeCode_SX | UnitTypeCode_TX | UnitTypeCode_UX | UnitTypeCode_VX | UnitTypeCode_WX | UnitTypeCode_YX | UnitTypeCode_ZX | UnitTypeCode_XX;
-
-/**
- * Interface representing a Unit of Measurement entry.
- * Contains the code and its corresponding name.
- */
-interface UnitType {
-  code: UnitTypeCode;
-  name: string;
-}
-//#endregion
-export { UnitType, UnitTypeCode };

package/dist/utils/apiQueue.d.ts

@@ -1,45 +0,0 @@
-//#region src/utils/apiQueue.d.ts
-// A very small utility that provides per-endpoint request queuing with rate-limits.
-// The goal is to make sure that we never exceed the vendor-defined limits while also ensuring
-// that every request is eventually executed.
-//
-// NOTE: This is intentionally minimal – no external dependencies are introduced.
-// If you need more advanced features (persistence, jitter, etc.) consider a library such as `bottleneck`.
-/*
-Rate-limit specification (per 60-second window)
-----------------------------------------------
-Login as Taxpayer System         : 12
-Login as Intermediary System     : 12
-Submit Documents                 : 100
-Get Submission                   : 300
-Cancel Document                  : 12
-Reject Document                  : 12
-Get Document                     : 60
-Get Document Details             : 125
-Get Recent Documents             : 12
-Search Documents                 : 12
-Search Taxpayer's TIN            : 60
-Taxpayer's QR Code               : 60
-*/
-type ApiCategory = "loginTaxpayer" | "loginIntermediary" | "submitDocuments" | "getSubmission" | "cancelDocument" | "rejectDocument" | "getDocument" | "getDocumentDetails" | "getRecentDocuments" | "searchDocuments" | "searchTin" | "taxpayerQr" | "default";
-type Task<T> = () => Promise<T>;
-/**
-* Public helper to schedule a request according to the category's limits.
-* Rate limits are enforced per clientId, so multiple instances with the same
-* clientId will share rate limiters, while different clientIds get separate limiters.
-*
-* This implementation uses a sliding window to track all requests within the time window.
-*/
-declare function queueRequest<T>(clientId: string, category: ApiCategory, task: Task<T>, debug?: boolean): Promise<T>;
-/**
-* Cleanup function to clear all queues and timers for a specific client.
-* Useful for testing or cleanup on application shutdown.
-*/
-declare function clearQueue(clientId: string, category?: ApiCategory): void;
-/**
-* Very naive path-based category detection. If no matcher fits, the `default` category
-* (effectively unlimited) is returned. Adjust these heuristics as your API surface evolves.
-*/
-declare function categorizeRequest(path: string, method?: string): ApiCategory;
-//#endregion
-export { ApiCategory, categorizeRequest, clearQueue, queueRequest };

package/dist/utils/apiQueue.js

@@ -1,3 +0,0 @@
-import { categorizeRequest, clearQueue, queueRequest } from "../apiQueue-B6Q644Bz.js";
-
-export { categorizeRequest, clearQueue, queueRequest };

package/dist/utils/base64.d.ts

@@ -1,5 +0,0 @@
-//#region src/utils/base64.d.ts
-declare function encodeToBase64(content: string): string;
-declare function decodeFromBase64(content: string): string;
-//#endregion
-export { decodeFromBase64, encodeToBase64 };

package/dist/utils/base64.js

@@ -1,10 +0,0 @@
-//#region src/utils/base64.ts
-function encodeToBase64(content) {
-	return Buffer.from(content).toString("base64");
-}
-function decodeFromBase64(content) {
-	return Buffer.from(content, "base64").toString("utf-8");
-}
-
-//#endregion
-export { decodeFromBase64, encodeToBase64 };

package/dist/utils/certificate.d.ts

@@ -1,26 +0,0 @@
-//#region src/utils/certificate.d.ts
-/**
-* Extracts certificate information from PEM certificate
-* Converts hex serial number to decimal as required by MyInvois
-*
-* @param certificatePem - Certificate in PEM format
-* @returns Object with issuer name and decimal serial number
-*/
-declare const extractCertificateInfo: (certificatePem: string) => {
-  issuerName: string;
-  serialNumber: string;
-};
-/**
-* Validates that certificate and private key form a valid pair
-*
-* @param certificatePem - Certificate in PEM format
-* @param privateKeyPem - Private key in PEM format
-* @returns Boolean indicating if key pair is valid
-*/
-declare const validateKeyPair: (certificatePem: string, privateKeyPem: string) => boolean;
-declare const getPemFromP12: (p12Input: Buffer | string, passphrase: string) => {
-  certificatePem: string;
-  privateKeyPem: string;
-};
-//#endregion
-export { extractCertificateInfo, getPemFromP12, validateKeyPair };

package/dist/utils/certificate.js

@@ -1,3 +0,0 @@
-import { extractCertificateInfo, getPemFromP12, validateKeyPair } from "../certificate-COwqszxD.js";
-
-export { extractCertificateInfo, getPemFromP12, validateKeyPair };

package/dist/utils/document.d.ts

@@ -1,211 +0,0 @@
-import { ClassificationCode } from "../classification-codes-C2X4xW5-.js";
-import "../country-code-DsI8Mbzx.js";
-import "../currencies-DKuDflOO.js";
-import "../e-invoice-C2TxhyrK.js";
-import "../0X-qj3c_vAo.js";
-import "../1X-B-lyAVC4.js";
-import "../2X-BfCK614i.js";
-import "../3X-Du10Ix_V.js";
-import "../4X-x3cRFuSM.js";
-import "../5X-B52AKeTz.js";
-import "../6X-DBwpWPQ6.js";
-import "../7X-C_XGDSpE.js";
-import "../8X-Di_0wuRX.js";
-import "../9X-8ZnvvViY.js";
-import "../msic-codes-CjrrJmzb.js";
-import { TaxTypeCode } from "../tax-types-ClyLgydM.js";
-import "../state-codes-Ow4oehYT.js";
-import "../1X-C72Wa4pk.js";
-import "../2X-CH89y3Af.js";
-import "../3X-DryrwYRf.js";
-import "../4X-BPMLRoDv.js";
-import "../5X-Bv7M6KyG.js";
-import "../6X-ZeZ8OB57.js";
-import "../7X-Dvw2Z2VN.js";
-import "../8X-BkgoX8dg.js";
-import "../9X-Du0e44cq.js";
-import "../AX-BSPLpkVT.js";
-import "../BX-u4yMaIkz.js";
-import "../CX-BKZG0pVE.js";
-import "../DX-CwA9WJAf.js";
-import "../EX-BRNu1Ooi.js";
-import "../FX-DBxjq6xY.js";
-import "../GX-B3CvWNrP.js";
-import "../HX-D7FABgTv.js";
-import "../IX-D3ZknsAB.js";
-import "../JX-BRaZM3Gc.js";
-import "../KX-B1K0OWoi.js";
-import "../LX-CKRefinL.js";
-import "../MX-DKmaeO9r.js";
-import "../NX-CJL2Gn1U.js";
-import "../OX-Do2ap5v_.js";
-import "../PX-_DOr_rm9.js";
-import "../QX-HlXLkIki.js";
-import "../RX-DVPGOVES.js";
-import "../SX-OGT3qwlS.js";
-import "../TX-cPDINmZ5.js";
-import "../UX-Be3sqvPV.js";
-import "../VX-CoEuBNDK.js";
-import "../WX-DMvw__jH.js";
-import "../YX-F34sJ7Ik.js";
-import "../ZX-CDQOfsHh.js";
-import "../XX-DOA-10JW.js";
-import { UnitTypeCode } from "../unit-types-VgYXIwTT.js";
-import { AllDocumentsV1_1, CompleteInvoice, InvoiceLineItem, InvoiceSubmission, SignedInfoObject, SignedPropertiesObject, SigningCredentials, UBLDocument } from "../documents-BYV12TVt.js";
-import "../payment-modes-g3DzLmWb.js";
-import "../signatures-CerHUrj3.js";
-import "../notifications-sFhgh3rJ.js";
-import "../taxpayer-BAoT73gg.js";
-import "../utils-C4FoVKLq.js";
-import "../index-CygwSf0x.js";
-
-//#region src/utils/document.d.ts
-/**
-* MyInvois v1.1 Document Generation and Signing Utilities
-* Strictly follows: https://sdk.myinvois.hasil.gov.my/documents/invoice-v1-1
-* JSON Signature Guide: https://sdk.myinvois.hasil.gov.my/signature-creation-json/
-*/
-/**
-* Determines if a line item uses fixed rate taxation
-*/
-declare const isFixedRateTax: (item: InvoiceLineItem) => boolean;
-/**
-* Determines if a line item uses percentage taxation
-*/
-declare const isPercentageTax: (item: InvoiceLineItem) => boolean;
-/**
-* Calculates expected tax amount for a line item based on its tax type
-*/
-declare const calculateExpectedTaxAmount: (item: InvoiceLineItem) => number;
-/**
-* Helper function to recursively sort object keys for JSON canonicalization
-*/
-declare function sortObjectKeys(obj: unknown): unknown;
-/**
-* Enhanced canonicalization following MyInvois specification exactly
-* Key changes: ensure consistent ordering and formatting
-*/
-declare const canonicalizeJSON: (obj: unknown) => string;
-/**
-* Generates a clean invoice object following MyInvois v1.1 specification exactly
-* This is the base invoice structure WITHOUT signature elements (for hash calculation)
-*
-* Key requirements from working documents:
-* - All mandatory fields must be present
-* - Many optional fields must be present even if empty
-* - Specific field ordering and structure
-* - Correct listID values (e.g., "3166-1" not "ISO3166-1")
-*/
-declare const generateCleanInvoiceObject: (invoice: AllDocumentsV1_1) => InvoiceSubmission;
-/**
-* Generates the complete UBL document structure with namespace declarations
-*/
-declare const generateCleanUBLDocument: (invoices: AllDocumentsV1_1[]) => UBLDocument;
-/**
-* Step 1: Transform the document for hashing or transmission
-* Removes UBLExtensions and Signature, and minifies the JSON
-* Returns the minified, cleaned JSON string
-*
-* FIXED: Use regex-based minification to match PowerShell script exactly
-*/
-declare const transformDocumentForHashing: (invoices: AllDocumentsV1_1[]) => string;
-/**
-* Step 2: Calculate Document Digest
-* FIXED: Remove UBLExtensions and Signature before hashing (DS322)
-* Based on working implementation pattern
-*/
-declare const calculateDocumentDigest: (invoices: AllDocumentsV1_1[]) => string;
-/**
-* Step 4: Calculate Certificate Digest
-* Enhanced to handle certificate content properly
-* FIXED: Match PowerShell script exactly - use raw certificate data like $cert.RawData
-*/
-declare const calculateCertificateDigest: (certificatePem: string) => string;
-/**
-* Enhanced certificate info extraction with better error handling
-* FIXED: Normalize issuer name format to match MyInvois expectations (DS326)
-*/
-declare const extractCertificateInfo: (certificatePem: string) => {
-  issuerName: string;
-  serialNumber: string;
-  subjectName: string;
-};
-/**
-* Step 5: Create SignedProperties with enhanced structure
-* FIXED: Simplified structure to match MyInvois expectations (DS320)
-* Following MyInvois JSON signature specification exactly
-*/
-declare const createSignedProperties: (certificateDigest: string, signingTime: string, issuerName: string, serialNumber: string) => SignedPropertiesObject;
-/**
-* Step 6: Calculate SignedProperties Digest
-* Calculates the digest over the correct structure for validator compliance.
-* FIXED: Calculate digest from SignedProperties only (without Target wrapper)
-*/
-declare const calculateSignedPropertiesDigest: (signedProperties: SignedPropertiesObject, useTargetWrapper?: boolean) => string;
-/**
-* Step 3: Create SignedInfo and calculate signature
-* Enhanced with better structure and signature generation
-*/
-declare const createSignedInfoAndSign: (docDigest: string, propsDigest: string, privateKeyPem: string) => {
-  signedInfo: SignedInfoObject;
-  signatureValue: string;
-};
-/**
-* Signs the minified document string using the provided private key PEM
-* Returns the signature as a base64 string
-* FIXED: Match PowerShell script exactly - first compute hash, then sign the hash
-*/
-declare const signDocumentString: (documentString: string, privateKeyPem: string) => string;
-/**
-* Complete document generation with signatures
-* Follows the complete MyInvois JSON signature creation process (Steps 1-7)
-*/
-declare const generateCompleteDocument: (invoices: AllDocumentsV1_1[], signingCredentials: SigningCredentials) => CompleteInvoice;
-/**
-* Creates a line item with percentage-based taxation (e.g., SST, GST)
-*/
-declare const createPercentageTaxLineItem: (params: {
-  itemClassificationCode: ClassificationCode;
-  itemDescription: string;
-  unitPrice: number;
-  quantity?: number;
-  measurement?: string;
-  taxType: TaxTypeCode;
-  taxRate: number;
-  totalTaxableAmountPerLine?: number;
-  discountAmount?: number;
-  discountRate?: number;
-}) => InvoiceLineItem;
-/**
-* Creates a line item with fixed rate taxation (e.g., Tourism Tax)
-*/
-declare const createFixedRateTaxLineItem: (params: {
-  itemClassificationCode: ClassificationCode;
-  itemDescription: string;
-  unitPrice: number;
-  quantity?: number;
-  measurement?: string;
-  taxType: TaxTypeCode;
-  taxPerUnitAmount: number;
-  baseUnitMeasure: number;
-  baseUnitMeasureCode: UnitTypeCode;
-  totalTaxableAmountPerLine?: number;
-  discountAmount?: number;
-  discountRate?: number;
-}) => InvoiceLineItem;
-/**
-* Calculates invoice totals from line items
-*/
-declare const calculateInvoiceTotals: (lineItems: InvoiceLineItem[], payableRoundingAmount?: number) => {
-  legalMonetaryTotal: {
-    taxExclusiveAmount: number;
-    taxInclusiveAmount: number;
-    payableRoundingAmount: number;
-    payableAmount: number;
-  };
-  taxTotal: {
-    taxAmount: number;
-  };
-};
-//#endregion
-export { calculateCertificateDigest, calculateDocumentDigest, calculateExpectedTaxAmount, calculateInvoiceTotals, calculateSignedPropertiesDigest, canonicalizeJSON, createFixedRateTaxLineItem, createPercentageTaxLineItem, createSignedInfoAndSign, createSignedProperties, extractCertificateInfo, generateCleanInvoiceObject, generateCleanUBLDocument, generateCompleteDocument, isFixedRateTax, isPercentageTax, signDocumentString, sortObjectKeys, transformDocumentForHashing };

package/dist/utils/document.js

@@ -1,4 +0,0 @@
-import "../formatIdValue-qTxJqj9o.js";
-import { calculateCertificateDigest, calculateDocumentDigest, calculateExpectedTaxAmount, calculateInvoiceTotals, calculateSignedPropertiesDigest, canonicalizeJSON, createFixedRateTaxLineItem, createPercentageTaxLineItem, createSignedInfoAndSign, createSignedProperties, extractCertificateInfo, generateCleanInvoiceObject, generateCleanUBLDocument, generateCompleteDocument, isFixedRateTax, isPercentageTax, signDocumentString, sortObjectKeys, transformDocumentForHashing } from "../document-Bb5WkhRe.js";
-
-export { calculateCertificateDigest, calculateDocumentDigest, calculateExpectedTaxAmount, calculateInvoiceTotals, calculateSignedPropertiesDigest, canonicalizeJSON, createFixedRateTaxLineItem, createPercentageTaxLineItem, createSignedInfoAndSign, createSignedProperties, extractCertificateInfo, generateCleanInvoiceObject, generateCleanUBLDocument, generateCompleteDocument, isFixedRateTax, isPercentageTax, signDocumentString, sortObjectKeys, transformDocumentForHashing };

package/dist/utils/formatIdValue.d.ts

@@ -1,4 +0,0 @@
-//#region src/utils/formatIdValue.d.ts
-declare function formatIdValue(idValue: string): string;
-//#endregion
-export { formatIdValue };

package/dist/utils/formatIdValue.js

@@ -1,3 +0,0 @@
-import { formatIdValue } from "../formatIdValue-qTxJqj9o.js";
-
-export { formatIdValue };

package/dist/utils/getBaseUrl.d.ts

@@ -1,4 +0,0 @@
-//#region src/utils/getBaseUrl.d.ts
-declare const getBaseUrl: (environment: "sandbox" | "production") => string;
-//#endregion
-export { getBaseUrl };

package/dist/utils/getBaseUrl.js

@@ -1,3 +0,0 @@
-import { getBaseUrl } from "../getBaseUrl-D7nUmoYb.js";
-
-export { getBaseUrl };

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

@@ -1,96 +0,0 @@
-import "../classification-codes-C2X4xW5-.js";
-import "../country-code-DsI8Mbzx.js";
-import "../currencies-DKuDflOO.js";
-import "../e-invoice-C2TxhyrK.js";
-import "../0X-qj3c_vAo.js";
-import "../1X-B-lyAVC4.js";
-import "../2X-BfCK614i.js";
-import "../3X-Du10Ix_V.js";
-import "../4X-x3cRFuSM.js";
-import "../5X-B52AKeTz.js";
-import "../6X-DBwpWPQ6.js";
-import "../7X-C_XGDSpE.js";
-import "../8X-Di_0wuRX.js";
-import "../9X-8ZnvvViY.js";
-import "../msic-codes-CjrrJmzb.js";
-import "../tax-types-ClyLgydM.js";
-import "../state-codes-Ow4oehYT.js";
-import "../1X-C72Wa4pk.js";
-import "../2X-CH89y3Af.js";
-import "../3X-DryrwYRf.js";
-import "../4X-BPMLRoDv.js";
-import "../5X-Bv7M6KyG.js";
-import "../6X-ZeZ8OB57.js";
-import "../7X-Dvw2Z2VN.js";
-import "../8X-BkgoX8dg.js";
-import "../9X-Du0e44cq.js";
-import "../AX-BSPLpkVT.js";
-import "../BX-u4yMaIkz.js";
-import "../CX-BKZG0pVE.js";
-import "../DX-CwA9WJAf.js";
-import "../EX-BRNu1Ooi.js";
-import "../FX-DBxjq6xY.js";
-import "../GX-B3CvWNrP.js";
-import "../HX-D7FABgTv.js";
-import "../IX-D3ZknsAB.js";
-import "../JX-BRaZM3Gc.js";
-import "../KX-B1K0OWoi.js";
-import "../LX-CKRefinL.js";
-import "../MX-DKmaeO9r.js";
-import "../NX-CJL2Gn1U.js";
-import "../OX-Do2ap5v_.js";
-import "../PX-_DOr_rm9.js";
-import "../QX-HlXLkIki.js";
-import "../RX-DVPGOVES.js";
-import "../SX-OGT3qwlS.js";
-import "../TX-cPDINmZ5.js";
-import "../UX-Be3sqvPV.js";
-import "../VX-CoEuBNDK.js";
-import "../WX-DMvw__jH.js";
-import "../YX-F34sJ7Ik.js";
-import "../ZX-CDQOfsHh.js";
-import "../XX-DOA-10JW.js";
-import "../unit-types-VgYXIwTT.js";
-import { InvoiceV1_1 } from "../documents-BYV12TVt.js";
-import "../payment-modes-g3DzLmWb.js";
-import "../signatures-CerHUrj3.js";
-import "../notifications-sFhgh3rJ.js";
-import "../taxpayer-BAoT73gg.js";
-import "../utils-C4FoVKLq.js";
-import "../index-CygwSf0x.js";
-
-//#region src/utils/signature-diagnostics.d.ts
-interface CertificateAnalysisResult {
-  organizationIdentifier?: string;
-  serialNumber?: string;
-  issuerName: string;
-  subjectName: string;
-  issues: string[];
-  recommendations: string[];
-}
-interface SignatureAnalysisResult {
-  documentDigest: string;
-  certificateDigest: string;
-  signedPropertiesDigest: string;
-  issues: string[];
-  recommendations: string[];
-}
-interface DiagnosticResult {
-  certificateAnalysis: CertificateAnalysisResult;
-  signatureAnalysis: SignatureAnalysisResult;
-  summary: {
-    totalIssues: number;
-    certificateIssues: number;
-    signatureIssues: number;
-  };
-}
-/**
-* Comprehensive signature diagnostics
-*/
-declare function diagnoseSignatureIssues(invoices: InvoiceV1_1[], certificatePem: string): DiagnosticResult;
-/**
-* Prints diagnostic results in a formatted way
-*/
-declare function printDiagnostics(result: DiagnosticResult): void;
-//#endregion
-export { CertificateAnalysisResult, DiagnosticResult, SignatureAnalysisResult, diagnoseSignatureIssues, printDiagnostics };