@ripwords/myinvois-client 0.1.0 → 0.1.3

package/dist/utils/invoice1-1.d.ts

@@ -1,117 +0,0 @@
-import "../classification-codes-C2X4xW5-.js";
-import "../country-code-DsI8Mbzx.js";
-import "../currencies-DKuDflOO.js";
-import "../e-invoice-C2TxhyrK.js";
-import "../signatures-C9QPZTQd.js";
-import "../tax-types-CEpfSh5P.js";
-import "../1X-C-_KHV-Q.js";
-import "../2X-DkS1BoE5.js";
-import "../3X-DFI-4RQQ.js";
-import "../4X-CIJ2JJ2w.js";
-import "../5X-COsZHUaQ.js";
-import "../6X-ClZDKOTC.js";
-import "../7X-BZyesooz.js";
-import "../8X-DkuKAkHz.js";
-import "../9X-BDgifncF.js";
-import "../AX-D6XHWdrY.js";
-import "../BX-D_0C8Qbd.js";
-import "../CX-HH4cSZRX.js";
-import "../DX-Dx22ax_I.js";
-import "../EX-BRWh1wFc.js";
-import "../FX-RmjwAr40.js";
-import "../GX-CJyo7oDp.js";
-import "../HX-XALBTdLA.js";
-import "../IX-6SZ55QKb.js";
-import "../JX-hQ1XRmLp.js";
-import "../KX-BNwunEfn.js";
-import "../LX-CHYX3X3J.js";
-import "../MX-BPGLWSUz.js";
-import "../NX-RulN5Ml3.js";
-import "../OX-DgKVSp7I.js";
-import "../PX-DA4A2kEv.js";
-import "../QX-DrFqsMEs.js";
-import "../RX-Cm7vFcFN.js";
-import "../SX-CsPPTu-W.js";
-import "../TX-DCY25MdR.js";
-import "../UX-DauyagHy.js";
-import "../VX-DD4scgCe.js";
-import "../WX-CjkoppdY.js";
-import "../YX-DUdO8mRC.js";
-import "../ZX-DwfcSA-D.js";
-import "../XX-sbsIUOnA.js";
-import "../unit-types-1bF0KhIp.js";
-import "../payment-modes-B8dNy3SM.js";
-import "../0X-C4IRh_fJ.js";
-import "../1X-Brnls9Jh.js";
-import "../2X-UdQcQW24.js";
-import "../3X-DVDyspgb.js";
-import "../4X-CUR8jlaZ.js";
-import "../5X-C6db432h.js";
-import "../6X-C_fFIcJC.js";
-import "../7X-kot_VccM.js";
-import "../8X-Df4DOBOe.js";
-import "../9X-BhBWlgxG.js";
-import "../msic-codes-bs0lTfSZ.js";
-import { InvoiceV1_1, SigningCredentials } from "../invoice-1_1-BJVcw-oE.js";
-
-//#region src/utils/invoice1-1.d.ts
-/**
-* Generates a document hash for submission (separate from signature DocDigest)
-* This is the SHA256 hash required by the Submit Documents API
-*
-* OFFICIAL MyInvois FAQ: "The XML/JSON document is hashed using SHA-256 to create the documentHash value"
-* CRITICAL: Must hash the SAME document that gets encoded for submission (minified XML)
-* Source: https://sdk.myinvois.hasil.gov.my/faq/#how-to-hash-the-documenthash-value-and-encode-the-document-value
-*/
-declare const generateDocumentHash: (xmlDocument: string) => string;
-/**
-* Encodes the XML document to base64 for submission
-* Includes minification as recommended by MyInvois documentation
-*/
-declare const encodeDocumentForSubmission: (xmlDocument: string) => string;
-/**
-* Utility functions for extracting certificate information
-*/
-/**
-* Extracts certificate information from a PEM certificate file
-* @param certificatePem - The certificate in PEM format
-* @returns Object containing issuer name and serial number
-*/
-declare const extractCertificateInfo: (certificatePem: string) => {
-  issuerName: string;
-  serialNumber: string;
-};
-/**
-* Validates that certificate and private key match
-* @param certificatePem - The certificate in PEM format
-* @param privateKeyPem - The private key in PEM format
-* @returns boolean indicating if they match
-*/
-declare const validateKeyPair: (certificatePem: string, privateKeyPem: string) => boolean;
-/**
-* Helper function to create SigningCredentials from certificate and private key files
-* @param certificatePem - The certificate in PEM format
-* @param privateKeyPem - The private key in PEM format
-* @returns Complete SigningCredentials object
-*/
-declare function createSigningCredentials(certificatePem: string, privateKeyPem: string): SigningCredentials;
-/**
-* Generates the UBL XML template with complete signature structure
-*/
-declare function generateUBLXMLTemplate(invoiceInfo: InvoiceV1_1): string;
-/**
-* Generates a signed UBL XML invoice document following MyInvois specifications.
-*
-* @param invoiceInfo - The invoice data structure
-* @param signingCredentials - Digital signature credentials
-* @returns Promise<string> - The complete signed XML document ready for submission
-*/
-declare const generateSignedInvoiceXML: (invoiceInfo: InvoiceV1_1, signingCredentials: SigningCredentials) => Promise<string>;
-/**
-* Generates a document hash for submission using the same method as signature creation
-* This ensures consistency with MyInvois validation requirements
-*/
-declare const generateDocumentHashForSubmission: (xmlDocument: string) => Promise<string>;
-//#endregion
-export { createSigningCredentials, encodeDocumentForSubmission, extractCertificateInfo, generateDocumentHash, generateDocumentHashForSubmission, generateSignedInvoiceXML, generateUBLXMLTemplate, validateKeyPair };
-//# sourceMappingURL=invoice1-1.d.ts.map

package/dist/utils/invoice1-1.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"invoice1-1.d.ts","names":["xmlDocument: string","certificatePem: string","privateKeyPem: string","invoiceInfo: InvoiceV1_1","signingCredentials: SigningCredentials"],"sources":["../../src/utils/invoice1-1.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8Ta;;;;;cA2CA;;;;;;;;;cAcA;;;;;;;;;;cAoCA;;;;;;;iBA+BG,wBAAA,iDAGb;;;;iBAoBa,sBAAA,cAAoC;;;;;;;;cAgHvC,wCACE,iCACO,uBACnB;;;;AAtQH;AA2Ca,cAuRA,iCAvR+BA,EAAAA,CAAAA,WAAAA,EAAAA,MAAAA,EAAAA,GAyRzC,OAzRyCA,CAAAA,MAAAA,CAAAA"}

package/dist/utils/invoice1-1.js

@@ -1,10 +0,0 @@
-import { createSigningCredentials, encodeDocumentForSubmission, extractCertificateInfo, generateDocumentHash, generateDocumentHashForSubmission, generateSignedInvoiceXML, generateUBLXMLTemplate, validateKeyPair } from "../invoice1-1-CHuLpkFz.js";
-import "../canonicalize-DNUrCGad.js";
-import "../hashCert-Bol7lIh2.js";
-import "../hashSignedProperties-9vj5wlYR.js";
-import "../populateFinalDocument-BpLXmgLv.js";
-import "../populateSignedProperties-BvGN-YZH.js";
-import "../sign-DzHK7UhR.js";
-import "../transform-D1q-U6Zj.js";
-
-export { createSigningCredentials, encodeDocumentForSubmission, extractCertificateInfo, generateDocumentHash, generateDocumentHashForSubmission, generateSignedInvoiceXML, generateUBLXMLTemplate, validateKeyPair };

package/dist/utils/signature/canonicalize.d.ts

@@ -1,26 +0,0 @@
-//#region src/utils/signature/canonicalize.d.ts
-/**
-* Canonicalizes the XML document using the best available canonicalization algorithm,
-* hashes it using SHA-256, and returns the Base64 encoded digest.
-*
-* Corresponds to Step 3 in the MyInvois Signature Creation guide:
-* https://sdk.myinvois.hasil.gov.my/signature-creation/#step-3-canonicalize-the-document-and-generate-the-document-hash-digest
-*
-* Note: MyInvois documentation specifies C14N 1.1, but due to limited Node.js library support,
-* this implementation uses Exclusive C14N which is widely supported and should be compatible
-* in most cases. If signature validation fails, this may need to be updated.
-*
-* @param doc The XML Document object (from xmldom-ts) after transformations (Step 2).
-* @param algorithm Optional canonicalization algorithm URI. Defaults to Exclusive C14N.
-* @returns A Promise resolving to the Base64 encoded SHA-256 hash (DocDigest).
-* @throws {Error} If canonicalization or hashing fails.
-*/
-declare function canonicalizeAndHashDocument(doc: Document, algorithm?: string): Promise<string>;
-/**
-* Attempts to use C14N 1.1 if available, otherwise falls back to Exclusive C14N.
-* This function provides a way to try the MyInvois-specified algorithm first.
-*/
-declare function canonicalizeAndHashDocumentWithC14N11Fallback(doc: Document): Promise<string>;
-//#endregion
-export { canonicalizeAndHashDocument, canonicalizeAndHashDocumentWithC14N11Fallback };
-//# sourceMappingURL=canonicalize.d.ts.map

package/dist/utils/signature/canonicalize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"canonicalize.d.ts","names":["doc: Document","algorithm: string"],"sources":["../../../src/utils/signature/canonicalize.ts"],"sourcesContent":[],"mappings":";;AAmBA;;;;AAGG;AAgEH;;;;AAEG;;;;;;iBArEa,2BAAA,MACT,+BAEJ;;;;;iBAgEmB,6CAAA,MACf,WACJ"}

package/dist/utils/signature/canonicalize.js

@@ -1,3 +0,0 @@
-import { canonicalizeAndHashDocument, canonicalizeAndHashDocumentWithC14N11Fallback } from "../../canonicalize-DNUrCGad.js";
-
-export { canonicalizeAndHashDocument, canonicalizeAndHashDocumentWithC14N11Fallback };

package/dist/utils/signature/hashCert.d.ts

@@ -1,15 +0,0 @@
-//#region src/utils/signature/hashCert.d.ts
-/**
-* Hashes the signing certificate using SHA-256 and encodes the hash in Base64.
-*
-* Corresponds to Step 5 in the MyInvois Signature Creation guide:
-* https://sdk.myinvois.hasil.gov.my/signature-creation/#step-5-generate-the-certificate-hash
-*
-* @param certificatePem The signing certificate in PEM format (string).
-* @returns The Base64 encoded SHA-256 hash of the certificate (CertDigest).
-* @throws {Error} If hashing fails or PEM is invalid.
-*/
-declare function hashCertificate(certificatePem: string): string;
-//#endregion
-export { hashCertificate };
-//# sourceMappingURL=hashCert.d.ts.map

package/dist/utils/signature/hashCert.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hashCert.d.ts","names":["certificatePem: string"],"sources":["../../../src/utils/signature/hashCert.ts"],"sourcesContent":[],"mappings":";;AAgFA;;;;;;;;;iBAAgB,eAAA"}

package/dist/utils/signature/hashCert.js

@@ -1,3 +0,0 @@
-import { hashCertificate } from "../../hashCert-Bol7lIh2.js";
-
-export { hashCertificate };

package/dist/utils/signature/hashSignedProperties.d.ts

@@ -1,25 +0,0 @@
-//#region src/utils/signature/hashSignedProperties.d.ts
-/**
-* Selects the SignedProperties element, canonicalizes it using the best available
-* canonicalization algorithm, hashes it using SHA-256, and returns the Base64 encoded digest.
-*
-* Corresponds to Step 7 in the MyInvois Signature Creation guide:
-* https://sdk.myinvois.hasil.gov.my/signature-creation/#step-7-generate-signed-properties-hash
-*
-* Note: MyInvois documentation specifies C14N 1.1, but due to limited Node.js library support,
-* this implementation uses Exclusive C14N which is widely supported and should be compatible
-* in most cases. If signature validation fails, this may need to be updated.
-*
-* @param doc The XML Document object (from xmldom-ts) after SignedProperties population (Step 6).
-* @param algorithm Optional canonicalization algorithm URI. Defaults to Exclusive C14N.
-* @returns A Promise resolving to the Base64 encoded SHA-256 hash (PropsDigest).
-* @throws {Error} If the SignedProperties element cannot be found or canonicalization/hashing fails.
-*/
-declare function hashSignedProperties(doc: Document, algorithm?: string): Promise<string>;
-/**
-* Attempts to use C14N 1.1 for SignedProperties if available, otherwise falls back to Exclusive C14N.
-*/
-declare function hashSignedPropertiesWithC14N11Fallback(doc: Document): Promise<string>;
-//#endregion
-export { hashSignedProperties, hashSignedPropertiesWithC14N11Fallback };
-//# sourceMappingURL=hashSignedProperties.d.ts.map

package/dist/utils/signature/hashSignedProperties.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hashSignedProperties.d.ts","names":["doc: Document","algorithm: string"],"sources":["../../../src/utils/signature/hashSignedProperties.ts"],"sourcesContent":[],"mappings":";;AAoBA;;;;AAGG;AA+GH;;;;AAEG;;;;;;iBApHa,oBAAA,MACT,+BAEJ;;;;iBA+GmB,sCAAA,MACf,WACJ"}

package/dist/utils/signature/hashSignedProperties.js

@@ -1,3 +0,0 @@
-import { hashSignedProperties, hashSignedPropertiesWithC14N11Fallback } from "../../hashSignedProperties-9vj5wlYR.js";
-
-export { hashSignedProperties, hashSignedPropertiesWithC14N11Fallback };

package/dist/utils/signature/populateFinalDocument.d.ts

@@ -1,23 +0,0 @@
-//#region src/utils/signature/populateFinalDocument.d.ts
-interface FinalDocumentData {
-  signatureValue: string;
-  propsDigest: string;
-  docDigest: string;
-  certificatePem: string;
-}
-/**
-* Populates the final signature information fields within the UBL document's signature structure.
-*
-* Corresponds to Step 8 in the MyInvois Signature Creation guide:
-* https://sdk.myinvois.hasil.gov.my/signature-creation/#step-8-populate-the-information-in-the-document-to-create-the-signed-document
-*
-* Modifies the passed Document object in place.
-*
-* @param doc The XML Document object (from xmldom-ts) containing the signature structure.
-* @param finalData An object containing the final signature data to populate.
-* @throws {Error} If any target element cannot be found or if multiple are found.
-*/
-declare function populateFinalDocument(doc: Document, finalData: FinalDocumentData): void;
-//#endregion
-export { FinalDocumentData, populateFinalDocument };
-//# sourceMappingURL=populateFinalDocument.d.ts.map

package/dist/utils/signature/populateFinalDocument.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"populateFinalDocument.d.ts","names":["doc: Document","finalData: FinalDocumentData"],"sources":["../../../src/utils/signature/populateFinalDocument.ts"],"sourcesContent":[],"mappings":";UAEiB,iBAAA;EAAjB,cAAiB,EAAA,MAAA;EAyCjB,WAAgB,EAAA,MAAA;EAAA,SAAA,EAAA,MAAA;EAAA,cACT,EAAA,MAAA;;AACM;;;;;;;;;;;;iBAFG,qBAAA,MACT,qBACM"}

package/dist/utils/signature/populateFinalDocument.js

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

package/dist/utils/signature/populateSignedProperties.d.ts

@@ -1,23 +0,0 @@
-//#region src/utils/signature/populateSignedProperties.d.ts
-interface SignedPropertiesData {
-  certDigest: string;
-  signingTime: string;
-  issuerName: string;
-  serialNumber: string;
-}
-/**
-* Populates the SignedProperties section within the UBL document's signature structure.
-*
-* Corresponds to Step 6 in the MyInvois Signature Creation guide:
-* https://sdk.myinvois.hasil.gov.my/signature-creation/#step-6-populate-the-signed-properties-section
-*
-* Modifies the passed Document object in place.
-*
-* @param doc The XML Document object (from xmldom-ts) containing the signature structure.
-* @param properties An object containing the data to populate.
-* @throws {Error} If any target element cannot be found or if multiple are found.
-*/
-declare function populateSignedProperties(doc: Document, properties: SignedPropertiesData): void;
-//#endregion
-export { SignedPropertiesData, populateSignedProperties };
-//# sourceMappingURL=populateSignedProperties.d.ts.map

package/dist/utils/signature/populateSignedProperties.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"populateSignedProperties.d.ts","names":["doc: Document","properties: SignedPropertiesData"],"sources":["../../../src/utils/signature/populateSignedProperties.ts"],"sourcesContent":[],"mappings":";UAEiB,oBAAA;EAAjB,UAAiB,EAAA,MAAA;EAmBjB,WAAgB,EAAA,MAAA;EAAA,UAAA,EAAA,MAAA;EAAA,YACT,EAAA,MAAA;;AACO;;;;;;;;;;;;iBAFE,wBAAA,MACT,sBACO"}

package/dist/utils/signature/populateSignedProperties.js

@@ -1,3 +0,0 @@
-import { populateSignedProperties } from "../../populateSignedProperties-BvGN-YZH.js";
-
-export { populateSignedProperties };

package/dist/utils/signature/sign.d.ts

@@ -1,16 +0,0 @@
-//#region src/utils/signature/sign.d.ts
-/**
-* Signs the document hash digest using RSA-SHA256 and a private key.
-*
-* Corresponds to Step 4 in the MyInvois Signature Creation guide:
-* https://sdk.myinvois.hasil.gov.my/signature-creation/#step-4-sign-the-document-digest
-*
-* @param base64DocDigest The Base64 encoded SHA-256 hash of the canonicalized document (DocDigest from Step 3).
-* @param privateKeyPem The private key in PEM format (string or Buffer).
-* @returns The Base64 encoded RSA-SHA256 signature (Sig).
-* @throws {Error} If signing fails.
-*/
-declare function signDocumentDigest(base64DocDigest: string, privateKeyPem: string | Buffer): string;
-//#endregion
-export { signDocumentDigest };
-//# sourceMappingURL=sign.d.ts.map

package/dist/utils/signature/sign.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sign.d.ts","names":["base64DocDigest: string","privateKeyPem: string | Buffer"],"sources":["../../../src/utils/signature/sign.ts"],"sourcesContent":[],"mappings":";;AAaA;;;;;;;;;;iBAAgB,kBAAA,kDAEU"}

package/dist/utils/signature/sign.js

@@ -1,3 +0,0 @@
-import { signDocumentDigest } from "../../sign-DzHK7UhR.js";
-
-export { signDocumentDigest };

package/dist/utils/signature/transform.d.ts

@@ -1,16 +0,0 @@
-//#region src/utils/signature/transform.d.ts
-// Assuming Node and Document types are correctly exposed by xmldom-ts/xpath-ts globally or via import
-/**
-* Transforms an XML invoice string according to specific rules using xmldom-ts and xpath-ts:
-* - Removes the XML declaration.
-* - Removes UBLExtensions and Signature elements within the Invoice element.
-* Assumes the input XML is UTF-8 encoded.
-*
-* @param xmlString The raw XML invoice string.
-* @returns The transformed XML string.
-* @throws {Error} If parsing fails.
-*/
-declare function transformXmlInvoice(xmlString: string): string;
-//#endregion
-export { transformXmlInvoice };
-//# sourceMappingURL=transform.d.ts.map

package/dist/utils/signature/transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.d.ts","names":["xmlString: string"],"sources":["../../../src/utils/signature/transform.ts"],"sourcesContent":[],"mappings":";;AAeA;;;;;;;;;;iBAAgB,mBAAA"}

package/dist/utils/signature/transform.js

@@ -1,3 +0,0 @@
-import { transformXmlInvoice } from "../../transform-D1q-U6Zj.js";
-
-export { transformXmlInvoice };

package/src/types/documents/index.d.ts

@@ -1 +0,0 @@
-export type * from './invoice-1_1.d.ts'