@ripwords/myinvois-client 0.0.9 → 0.1.0

package/dist/utils/signature/hashSignedProperties.js

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

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

@@ -0,0 +1,23 @@
+//#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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1,23 @@
+//#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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1,16 @@
+//#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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1,16 @@
+//#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

@@ -0,0 +1 @@
+{"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

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

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@ripwords/myinvois-client",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "description": "MyInvois client",
   "scripts": {
-    "build": "bun run clean && rolldown -c rolldown.config.ts",
+    "build": "tsdown",
     "release": "bun run build && npm publish --access public",
     "clean": "rimraf dist",
     "lint": "oxlint",
@@ -19,15 +19,22 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/xml-c14n": "^0.0.3",
     "dotenv": "^16.5.0",
     "oxlint": "^0.16.6",
     "prettier": "^3.5.3",
-    "rimraf": "^6.0.1",
-    "rolldown": "^1.0.0-beta.7",
-    "rolldown-plugin-dts": "^0.7.13",
+    "tsdown": "^0.12.6",
     "vitest": "^3.1.1"
   },
   "peerDependencies": {
     "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@xmldom/xmldom": "^0.9.8",
+    "crypto": "^1.0.1",
+    "xml-c14n": "^0.0.6",
+    "xml-crypto": "^6.1.2",
+    "xmldom-ts": "^0.3.1",
+    "xpath-ts": "^1.3.13"
   }
 }

package/src/api/platform/{taxpayerLogin.ts → platformLogin.ts}

@@ -1,12 +1,18 @@
 import type { ClientCredentials, TokenResponse } from 'src/types'
 
-export const taxpayerLogin = async (client: ClientCredentials) => {
-  const { clientId, clientSecret, baseUrl, debug } = client
+export const platformLogin = async (
+  client: ClientCredentials,
+): Promise<{
+  token: string
+  tokenExpiration: Date
+}> => {
+  const { clientId, clientSecret, baseUrl, onBehalfOf, debug } = client
   try {
     const response = await fetch(`${baseUrl}/connect/token`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/x-www-form-urlencoded',
+        ...(onBehalfOf ? { onbehalfof: onBehalfOf } : {}),
       },
       body: new URLSearchParams({
         grant_type: 'client_credentials',

package/src/types/documents/invoice-1_1.d.ts

@@ -6,6 +6,7 @@ import type { CountryCode } from '../country-code.d.ts'
 import type { ClassificationCode } from '../classification-codes.d.ts'
 import type { UnitTypeCode } from '../unit-types.d.ts'
 import type { PaymentModeCode } from '../payment-modes.d.ts'
+import type { MSICCode } from '../msic-codes.d.ts'
 
 // Based on https://sdk.myinvois.hasil.gov.my/documents/invoice-v1-1/
 
@@ -51,6 +52,11 @@ export interface Supplier {
    * @example 1234567890
    */
   tin: string
+  /**
+   * Supplier's Registration Type. NRIC, BRN, PASSPORT
+   * @example NRIC
+   */
+  registrationType: 'BRN' | 'NRIC' | 'PASSPORT'
   /**
    * Supplier's Registration / Identification Number / Passport Number.
    * Format depends on schemeID: NRIC (12), BRN (20), PASSPORT (12), ARMY (12).
@@ -71,6 +77,10 @@ export interface Supplier {
    * @example +60123456789
    */
   contactNumber: string
+  /** Industry classification code. Max 10 chars.
+   * @example 46510
+   */
+  industryClassificationCode?: MSICCode['code']
 }
 
 /**
@@ -347,3 +357,83 @@ export interface InvoiceV1_1 {
   /** Delivery information. */
   delivery?: Delivery
 }
+
+export type SubmissionStatus =
+  | 'InProgress'
+  | 'Valid'
+  | 'PartiallyValid'
+  | 'Invalid'
+
+export type DocumentStatus = 'Valid' | 'Invalid' | 'Cancelled' | 'Submitted'
+
+export type StandardError = {
+  code: string
+  message: string
+  target: string
+  details: {
+    code: string
+    message: string
+    target: string
+  }[]
+}
+
+export type DocumentValidationResult = 'Valid' | 'Invalid' | 'Pending'
+export interface DocumentValidationStepResult {
+  name: string
+  status: DocumentValidationResult
+  error?: StandardError
+}
+export interface DocumentSummary {
+  uuid: string
+  submissionUid: string
+  longId: string
+  internalId: string
+  typeName: string
+  typeVersionName: string
+  issuerTin: string
+  issuerName: string
+  receiverId: string
+  receiverName: string
+  dateTimeIssued: string
+  dateTimeReceived: string
+  dateTimeValidated: string
+  totalPayableAmount: number
+  totalExcludingTax: number
+  totalDiscount: number
+  totalNetAmount: number
+  status: DocumentStatus
+  cancelDateTime: string | null
+  rejectRequestDateTime: string | null
+  documentStatusReason: string | null
+  createdByUserId: string
+}
+
+export interface GetSubmissionResponse {
+  submissionUid?: string
+  documentCount?: number
+  dateTimeReceived?: string
+  overallStatus?: SubmissionStatus
+  documentSummary?: DocumentSummary[]
+  error?: StandardError
+}
+
+export interface ResponseDocument {
+  invoiceCodeNumber: string
+  error?: StandardError
+}
+export interface SubmissionResponse {
+  submissionUid: string
+  acceptedDocuments: ResponseDocument[]
+  rejectedDocuments: ResponseDocument[]
+}
+
+export interface SigningCredentials {
+  /** Private key in PEM format for signing */
+  privateKeyPem: string
+  /** Certificate in PEM format */
+  certificatePem: string
+  /** Certificate issuer name (e.g., "CN=Trial LHDNM Sub CA V1, OU=Terms of use at https://www.posdigicert.com.my, O=LHDNM, C=MY") */
+  issuerName: string
+  /** Certificate serial number as string */
+  serialNumber: string
+}

package/src/types/index.d.ts

@@ -19,5 +19,6 @@ export interface ClientCredentials {
   clientId: string
   clientSecret: string
   baseUrl: string
+  onBehalfOf?: string
   debug?: boolean
 }

package/src/types/msic-codes.d.ts

@@ -9,19 +9,13 @@ import type { MSIC_7X_CODE } from './msic/7X.d.ts'
 import type { MSIC_8X_CODE } from './msic/8X.d.ts'
 import type { MSIC_9X_CODE } from './msic/9X.d.ts'
 
-export type MSICCode = {
-  code: string
-  description: string
-  msicCategoryReference: string
-}
-
 /**
  * Represents the allowed 5-digit Malaysia Standard Industrial Classification (MSIC) codes.
  * Based on the documentation: https://sdk.myinvois.hasil.gov.my/codes/msic-codes/
  * Interface representing an MSIC code entry.
  * Contains the 5-digit code and its description.
  */
-export interface MsicEntry {
+export interface MSICCode {
   code:
     | MSIC_0X_CODE
     | MSIC_1X_CODE