@ripwords/myinvois-client 0.1.4 → 0.1.5

package/dist/e-invoice-BuwtFnlI.d.cts

@@ -0,0 +1,44 @@
+//#region src/types/e-invoice.d.ts
+/**
+ * Represents the allowed codes for e-Invoice types.
+ * Based on the documentation: https://sdk.myinvois.hasil.gov.my/codes/e-invoice-types/
+ */
+type EInvoiceTypeCode = '01' // Invoice
+| '02' // Credit Note
+| '03' // Debit Note
+| '04' // Refund Note
+| '11' // Self-billed Invoice
+| '12' // Self-billed Credit Note
+| '13' // Self-billed Debit Note
+| '14'; // Self-billed Refund Note
+
+/**
+ * Interface representing an e-Invoice type entry.
+ * Contains the code and its corresponding description.
+ */
+interface EInvoiceType {
+  code: EInvoiceTypeCode;
+  description: string;
+}
+
+/**
+ * Enum representing the allowed codes for e-Invoice types with descriptive names.
+ * Provides a more readable way to reference e-Invoice types compared to using raw codes.
+ *
+ * @example
+ * const invoiceCode = EInvoiceTypeCodeEnum.Invoice;
+ * console.log(invoiceCode); // Output: "01"
+ */
+declare enum EInvoiceTypeCodeEnum {
+  Invoice = '01',
+  CreditNote = '02',
+  DebitNote = '03',
+  RefundNote = '04',
+  SelfBilledInvoice = '11',
+  SelfBilledCreditNote = '12',
+  SelfBilledDebitNote = '13',
+  SelfBilledRefundNote = '14',
+}
+//#endregion
+export { EInvoiceType, EInvoiceTypeCode, EInvoiceTypeCodeEnum };
+//# sourceMappingURL=e-invoice-BuwtFnlI.d.cts.map

package/dist/e-invoice-CmbLQkHw.d.ts

@@ -0,0 +1,43 @@
+//#region src/types/e-invoice.d.ts
+/**
+ * Represents the allowed codes for e-Invoice types.
+ * Based on the documentation: https://sdk.myinvois.hasil.gov.my/codes/e-invoice-types/
+ */
+type EInvoiceTypeCode = '01' // Invoice
+| '02' // Credit Note
+| '03' // Debit Note
+| '04' // Refund Note
+| '11' // Self-billed Invoice
+| '12' // Self-billed Credit Note
+| '13' // Self-billed Debit Note
+| '14'; // Self-billed Refund Note
+
+/**
+ * Interface representing an e-Invoice type entry.
+ * Contains the code and its corresponding description.
+ */
+interface EInvoiceType {
+  code: EInvoiceTypeCode;
+  description: string;
+}
+
+/**
+ * Enum representing the allowed codes for e-Invoice types with descriptive names.
+ * Provides a more readable way to reference e-Invoice types compared to using raw codes.
+ *
+ * @example
+ * const invoiceCode = EInvoiceTypeCodeEnum.Invoice;
+ * console.log(invoiceCode); // Output: "01"
+ */
+declare enum EInvoiceTypeCodeEnum {
+  Invoice = '01',
+  CreditNote = '02',
+  DebitNote = '03',
+  RefundNote = '04',
+  SelfBilledInvoice = '11',
+  SelfBilledCreditNote = '12',
+  SelfBilledDebitNote = '13',
+  SelfBilledRefundNote = '14',
+}
+//#endregion
+export { EInvoiceType, EInvoiceTypeCode, EInvoiceTypeCodeEnum };

package/dist/getBaseUrl-CO7Jp27d.cjs

@@ -0,0 +1,14 @@
+
+//#region src/utils/getBaseUrl.ts
+const getBaseUrl = (environment) => {
+	return environment === "sandbox" ? "https://preprod-api.myinvois.hasil.gov.my" : "https://api.myinvois.hasil.gov.my";
+};
+
+//#endregion
+Object.defineProperty(exports, 'getBaseUrl', {
+  enumerable: true,
+  get: function () {
+    return getBaseUrl;
+  }
+});
+//# sourceMappingURL=getBaseUrl-CO7Jp27d.cjs.map

package/dist/getBaseUrl-CO7Jp27d.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBaseUrl-CO7Jp27d.cjs","names":["environment: 'sandbox' | 'production'"],"sources":["../src/utils/getBaseUrl.ts"],"sourcesContent":["export const getBaseUrl = (environment: 'sandbox' | 'production'): string => {\n  return environment === 'sandbox'\n    ? 'https://preprod-api.myinvois.hasil.gov.my'\n    : 'https://api.myinvois.hasil.gov.my'\n}\n"],"mappings":";;AAAA,MAAa,aAAa,CAACA,gBAAkD;AAC3E,QAAO,gBAAgB,YACnB,8CACA;AACL"}

package/dist/getBaseUrl-R3IdgCu3.js

@@ -0,0 +1,7 @@
+//#region src/utils/getBaseUrl.ts
+const getBaseUrl = (environment) => {
+	return environment === "sandbox" ? "https://preprod-api.myinvois.hasil.gov.my" : "https://api.myinvois.hasil.gov.my";
+};
+
+//#endregion
+export { getBaseUrl };

package/dist/index-0-EvC6Nv.d.ts

@@ -0,0 +1,15 @@
+//#region src/types/index.d.ts
+
+interface TokenResponse {
+  access_token: string;
+  expires_in: number;
+}
+interface ClientCredentials {
+  clientId: string;
+  clientSecret: string;
+  baseUrl: string;
+  onBehalfOf?: string;
+  debug?: boolean;
+}
+//#endregion
+export { ClientCredentials, TokenResponse };

package/dist/index-D2_HVwCz.d.cts

@@ -0,0 +1,16 @@
+//#region src/types/index.d.ts
+
+interface TokenResponse {
+  access_token: string;
+  expires_in: number;
+}
+interface ClientCredentials {
+  clientId: string;
+  clientSecret: string;
+  baseUrl: string;
+  onBehalfOf?: string;
+  debug?: boolean;
+}
+//#endregion
+export { ClientCredentials, TokenResponse };
+//# sourceMappingURL=index-D2_HVwCz.d.cts.map

package/dist/index.cjs

@@ -0,0 +1,309 @@
+const require_platformLogin = require('./platformLogin-PGzMhw1X.cjs');
+const require_getBaseUrl = require('./getBaseUrl-CO7Jp27d.cjs');
+const require_certificate = require('./certificate-DFK-788s.cjs');
+const require_document = require('./document-CARHiGdp.cjs');
+
+//#region src/index.ts
+var MyInvoisClient = class {
+	baseUrl;
+	clientId;
+	clientSecret;
+	onBehalfOf;
+	signingCredentials;
+	debug;
+	token = "";
+	tokenExpiration = void 0;
+	constructor(clientId, clientSecret, environment, certificatePem, privateKeyPem, onBehalfOf, debug) {
+		if (!privateKeyPem || !certificatePem) throw new Error("Missing required environment variables: PRIVATE_KEY and CERTIFICATE");
+		if (!require_certificate.validateKeyPair(certificatePem, privateKeyPem)) throw new Error("Certificate and private key do not match");
+		this.clientId = clientId;
+		this.clientSecret = clientSecret;
+		this.baseUrl = require_getBaseUrl.getBaseUrl(environment);
+		this.onBehalfOf = onBehalfOf;
+		this.debug = debug ?? process.env.MYINVOIS_DEBUG === "true" ? true : false;
+		const { issuerName, serialNumber } = require_certificate.extractCertificateInfo(certificatePem);
+		this.signingCredentials = {
+			privateKeyPem,
+			certificatePem,
+			issuerName,
+			serialNumber
+		};
+	}
+	async refreshToken() {
+		const tokenResponse = await require_platformLogin.platformLogin({
+			clientId: this.clientId,
+			clientSecret: this.clientSecret,
+			baseUrl: this.baseUrl,
+			onBehalfOf: this.onBehalfOf,
+			debug: this.debug
+		});
+		this.token = tokenResponse.token;
+		this.tokenExpiration = tokenResponse.tokenExpiration;
+	}
+	async getToken() {
+		if (!this.tokenExpiration || this.tokenExpiration < /* @__PURE__ */ new Date() || isNaN(this.tokenExpiration.getTime())) {
+			if (this.debug) {
+				console.log("Token expired");
+				console.log("Refreshing token");
+			}
+			await this.refreshToken();
+		}
+		return this.token;
+	}
+	async fetch(path, options = {}) {
+		const token = await this.getToken();
+		return fetch(`${this.baseUrl}${path}`, {
+			...options,
+			headers: {
+				...options.headers,
+				Authorization: `Bearer ${token}`
+			}
+		});
+	}
+	/**
+	* Validates a TIN against a NRIC/ARMY/PASSPORT/BRN (Business Registration Number)
+	*
+	* @param tin - The TIN to validate
+	* @param idType - The type of ID to validate against
+	* @param idValue - The value of the ID to validate against
+	* @returns true if the TIN is valid, false otherwise
+	*/
+	async verifyTin(tin, idType, idValue) {
+		try {
+			const response = await this.fetch(`/api/v1.0/taxpayer/validate/${tin}?idType=${idType}&idValue=${idValue}`, { method: "GET" });
+			if (response.status === 200) return true;
+			return false;
+		} catch (error) {
+			if (this.debug) console.error(error);
+			return false;
+		}
+	}
+	/**
+	* Submits one or more e-invoice documents to the MyInvois platform for processing.
+	*
+	* This method digitally signs each document using the provided certificate and private key,
+	* generates document hashes, encodes them for submission, and sends them to the platform.
+	* The method includes comprehensive validation warnings for document size and count limits.
+	*
+	* @param documents - Array of InvoiceV1_1 documents to be submitted
+	* @returns Promise resolving to submission response containing the submission data and HTTP status
+	* @throws {Error} If PRIVATE_KEY or CERTIFICATE environment variables are missing
+	* @throws {Error} If document signing, encoding, or API submission fails
+	*
+	* @example
+	* ```typescript
+	* // Submit a single invoice
+	* const result = await client.submitDocument([invoiceData]);
+	* console.log(result.data.submissionUid); // Track submission with this UID
+	*
+	* // Submit multiple invoices
+	* const result = await client.submitDocument([invoice1, invoice2, invoice3]);
+	* if (result.status === 202) {
+	*   console.log('Documents submitted successfully');
+	* }
+	* ```
+	*
+	* @remarks
+	* - Requires PRIVATE_KEY and CERTIFICATE environment variables for document signing
+	* - Each document is digitally signed with XML-DSIG before submission
+	* - Documents are base64-encoded for transmission
+	* - API limits: Max 100 documents per submission, 5MB total payload, 300KB per document
+	* - Debug mode provides detailed logging of payload sizes and validation warnings
+	* - Returns HTTP 202 for successful submissions that require processing
+	*/
+	async submitDocument(documents) {
+		if (this.debug) console.log(`📦 Preparing to submit ${documents.length} document(s)...`);
+		const completeDocument = require_document.generateCompleteDocument(documents, this.signingCredentials);
+		if (this.debug) {
+			console.log("✅ Documents signed successfully");
+			console.log("📄 Document structure keys:", Object.keys(completeDocument));
+			console.log("📊 Number of invoices:", completeDocument.Invoice.length);
+		}
+		const documentJson = JSON.stringify(completeDocument);
+		if (this.debug) console.log(`📏 Document JSON size: ${documentJson.length} bytes`);
+		const crypto = await import("crypto");
+		const documentHash = crypto.createHash("sha256").update(documentJson, "utf8").digest("hex");
+		const documentBase64 = Buffer.from(documentJson, "utf8").toString("base64");
+		if (this.debug) {
+			console.log(`🔒 Document hash: ${documentHash.substring(0, 16)}...`);
+			console.log(`📦 Base64 size: ${documentBase64.length} bytes`);
+		}
+		const submissionPayload = { documents: documents.map((doc) => ({
+			format: "JSON",
+			document: documentBase64,
+			documentHash,
+			codeNumber: doc.eInvoiceCodeOrNumber
+		})) };
+		if (this.debug) {
+			console.log("🚀 Submission payload structure:");
+			console.log("- Format: JSON");
+			console.log("- Documents count:", submissionPayload.documents.length);
+			console.log("- Total payload size:", JSON.stringify(submissionPayload).length, "bytes");
+			const payloadSize = JSON.stringify(submissionPayload).length;
+			if (payloadSize > 5 * 1024 * 1024) console.warn("⚠️  WARNING: Payload size exceeds 5MB limit");
+			if (documents.length > 100) console.warn("⚠️  WARNING: Document count exceeds 100 document limit");
+			if (documentJson.length > 300 * 1024) console.warn("⚠️  WARNING: Document size exceeds 300KB limit");
+		}
+		const response = await this.fetch("/api/v1.0/documentsubmissions", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(submissionPayload)
+		});
+		if (this.debug) console.log(`📡 API Response status: ${response.status}`);
+		const data = await response.json();
+		if (this.debug) if (response.status !== 202) {
+			console.error("❌ Submission failed with status:", response.status);
+			console.error("❌ Response data:", data);
+		} else {
+			console.log("✅ Submission successful!");
+			console.log(`📋 Submission UID: ${data.submissionUid}`);
+			console.log(`✅ Accepted documents: ${data.acceptedDocuments?.length || 0}`);
+			console.log(`❌ Rejected documents: ${data.rejectedDocuments?.length || 0}`);
+		}
+		return {
+			data,
+			status: response.status
+		};
+	}
+	async getSubmissionStatus(submissionUid, pollInterval = 1e3, maxRetries = 10) {
+		try {
+			const response = await this.fetch(`/api/v1.0/documentsubmissions/${submissionUid}`);
+			const data = await response.json();
+			if (this.debug) {
+				console.log("Submission:", data);
+				if (data.error) console.log("Submission error details:", data.error.details);
+			}
+			if (data.overallStatus === "Valid") return {
+				status: data.overallStatus,
+				documentSummary: data.documentSummary
+			};
+			if (data.overallStatus === "Invalid") return {
+				status: "Invalid",
+				documentSummary: data.documentSummary
+			};
+			if (maxRetries > 0) {
+				await new Promise((resolve) => setTimeout(resolve, pollInterval));
+				return await this.getSubmissionStatus(submissionUid, pollInterval, maxRetries - 1);
+			}
+			return {
+				status: "Invalid",
+				error: {
+					code: "Timeout",
+					message: "Submission timed out",
+					target: "submission",
+					details: []
+				}
+			};
+		} catch (error) {
+			if (maxRetries > 0) {
+				if (this.debug) console.log("Request error, retrying...", error);
+				await new Promise((resolve) => setTimeout(resolve, pollInterval));
+				return await this.getSubmissionStatus(submissionUid, pollInterval, maxRetries - 1);
+			}
+			return {
+				status: "Invalid",
+				error: {
+					code: "Timeout",
+					message: "Submission timed out after request errors",
+					target: "submission",
+					details: []
+				}
+			};
+		}
+	}
+	/**
+	* Retrieves a document by its unique identifier with the raw document content.
+	*
+	* @param documentUid - The unique identifier of the document to retrieve
+	* @returns Promise resolving to document summary with raw document content as a string
+	* @throws {Error} If the document is not found or request fails
+	*
+	* @example
+	* ```typescript
+	* const document = await client.getDocument('doc-uuid-123');
+	* console.log(document.document); // Raw XML/JSON content
+	* console.log(document.uuid); // Document UUID
+	* ```
+	*/
+	async getDocument(documentUid) {
+		const response = await this.fetch(`/api/v1.0/documents/${documentUid}/raw`);
+		const data = await response.json();
+		return data;
+	}
+	/**
+	* Retrieves detailed information about a document including validation results.
+	*
+	* @param documentUid - The unique identifier of the document to get details for
+	* @returns Promise resolving to document summary with detailed validation results
+	* @throws {Error} If the document is not found or request fails
+	*
+	* @example
+	* ```typescript
+	* const details = await client.getDocumentDetails('doc-uuid-123');
+	* console.log(details.validationResults.status); // 'Valid' | 'Invalid' | 'Processing'
+	* console.log(details.validationResults.validationSteps); // Array of validation step results
+	* ```
+	*/
+	async getDocumentDetails(documentUid) {
+		const response = await this.fetch(`/api/v1.0/documents/${documentUid}/details`);
+		const data = await response.json();
+		return data;
+	}
+	/**
+	* Searches for documents based on various filter criteria.
+	*
+	* @param params - Search parameters object
+	* @param params.uuid - Optional specific document UUID to search for
+	* @param params.submissionDateFrom - Required start date for submission date range (ISO date string)
+	* @param params.submissionDateTo - Optional end date for submission date range (ISO date string)
+	* @param params.pageSize - Optional number of results per page (default handled by API)
+	* @param params.pageNo - Optional page number for pagination (0-based)
+	* @param params.issueDateFrom - Optional start date for issue date range (ISO date string)
+	* @param params.issueDateTo - Optional end date for issue date range (ISO date string)
+	* @param params.invoiceDirection - Optional filter by invoice direction ('Sent' or 'Received')
+	* @param params.status - Optional filter by document status
+	* @param params.documentType - Optional filter by e-invoice type code
+	* @param params.searchQuery - Optional text search across uuid, buyerTIN, supplierTIN, buyerName, supplierName, internalID, total
+	* @returns Promise resolving to array of document summaries matching the search criteria
+	* @throws {Error} If the search request fails
+	*
+	* @example
+	* ```typescript
+	* // Search for documents submitted in the last 30 days
+	* const documents = await client.searchDocuments({
+	*   submissionDateFrom: '2024-01-01',
+	*   submissionDateTo: '2024-01-31',
+	*   status: 'Valid',
+	*   pageSize: 10
+	* });
+	*
+	* // Search by supplier name
+	* const supplierDocs = await client.searchDocuments({
+	*   submissionDateFrom: '2024-01-01',
+	*   searchQuery: 'ACME Corp',
+	*   invoiceDirection: 'Received'
+	* });
+	* ```
+	*/
+	async searchDocuments({ uuid, submissionDateFrom, submissionDateTo, pageSize, pageNo, issueDateFrom, issueDateTo, invoiceDirection, status, documentType, searchQuery }) {
+		const queryParams = new URLSearchParams();
+		if (uuid) queryParams.set("uuid", uuid);
+		if (submissionDateFrom) queryParams.set("submissionDateFrom", submissionDateFrom);
+		if (submissionDateTo) queryParams.set("submissionDateTo", submissionDateTo);
+		if (pageSize) queryParams.set("pageSize", pageSize.toString());
+		if (pageNo) queryParams.set("pageNo", pageNo.toString());
+		if (issueDateFrom) queryParams.set("issueDateFrom", issueDateFrom);
+		if (issueDateTo) queryParams.set("issueDateTo", issueDateTo);
+		if (invoiceDirection) queryParams.set("invoiceDirection", invoiceDirection);
+		if (status) queryParams.set("status", status);
+		if (documentType) queryParams.set("documentType", documentType);
+		if (searchQuery) queryParams.set("searchQuery", searchQuery);
+		const response = await this.fetch(`/api/v1.0/documents/search?${queryParams.toString()}`);
+		const data = await response.json();
+		return data;
+	}
+};
+
+//#endregion
+exports.MyInvoisClient = MyInvoisClient;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["clientId: string","clientSecret: string","environment: 'sandbox' | 'production'","certificatePem: string","privateKeyPem: string","onBehalfOf?: string","debug?: boolean","path: string","options: Parameters<typeof fetch>[1]","tin: string","idType: RegistrationType","idValue: string","documents: InvoiceV1_1[]","submissionUid: string","pollInterval: number","maxRetries: number","documentUid: string"],"sources":["../src/index.ts"],"sourcesContent":["import { EInvoiceTypeCode } from './types'\nimport { platformLogin } from './api/platform/platformLogin'\nimport type {\n  DocumentStatus,\n  InvoiceV1_1,\n  RegistrationType,\n  SigningCredentials,\n} from './types/documents'\nimport { getBaseUrl } from './utils/getBaseUrl'\nimport { extractCertificateInfo, validateKeyPair } from './utils/certificate'\n\nimport type {\n  DocumentSummary,\n  DocumentValidationResult,\n  DocumentValidationStepResult,\n  GetSubmissionResponse,\n  SubmissionResponse,\n  SubmissionStatus,\n} from './types/documents'\nimport { generateCompleteDocument } from './utils/document'\n\nexport class MyInvoisClient {\n  private readonly baseUrl: string\n  private readonly clientId: string\n  private readonly clientSecret: string\n  private readonly onBehalfOf?: string\n  private readonly signingCredentials: SigningCredentials\n  private readonly debug: boolean\n  private token = ''\n  private tokenExpiration: Date | undefined = undefined\n\n  constructor(\n    clientId: string,\n    clientSecret: string,\n    environment: 'sandbox' | 'production',\n    certificatePem: string,\n    privateKeyPem: string,\n    onBehalfOf?: string,\n    debug?: boolean,\n  ) {\n    // Check if basic signing credentials are available\n    if (!privateKeyPem || !certificatePem) {\n      throw new Error(\n        'Missing required environment variables: PRIVATE_KEY and CERTIFICATE',\n      )\n    }\n\n    // Validate that the key pair matches\n    if (!validateKeyPair(certificatePem, privateKeyPem)) {\n      throw new Error('Certificate and private key do not match')\n    }\n\n    this.clientId = clientId\n    this.clientSecret = clientSecret\n    this.baseUrl = getBaseUrl(environment)\n    this.onBehalfOf = onBehalfOf\n    this.debug = (debug ?? process.env.MYINVOIS_DEBUG === 'true') ? true : false\n\n    // Extract certificate information\n    const { issuerName, serialNumber } = extractCertificateInfo(certificatePem)\n\n    this.signingCredentials = {\n      privateKeyPem,\n      certificatePem,\n      issuerName,\n      serialNumber,\n    }\n  }\n\n  private async refreshToken() {\n    const tokenResponse = await platformLogin({\n      clientId: this.clientId,\n      clientSecret: this.clientSecret,\n      baseUrl: this.baseUrl,\n      onBehalfOf: this.onBehalfOf,\n      debug: this.debug,\n    })\n\n    this.token = tokenResponse.token\n    this.tokenExpiration = tokenResponse.tokenExpiration\n  }\n\n  private async getToken() {\n    if (\n      !this.tokenExpiration ||\n      this.tokenExpiration < new Date() ||\n      isNaN(this.tokenExpiration.getTime())\n    ) {\n      if (this.debug) {\n        console.log('Token expired')\n        console.log('Refreshing token')\n      }\n      await this.refreshToken()\n    }\n\n    return this.token\n  }\n\n  private async fetch(path: string, options: Parameters<typeof fetch>[1] = {}) {\n    const token = await this.getToken()\n\n    return fetch(`${this.baseUrl}${path}`, {\n      ...options,\n      headers: { ...options.headers, Authorization: `Bearer ${token}` },\n    })\n  }\n\n  /**\n   * Validates a TIN against a NRIC/ARMY/PASSPORT/BRN (Business Registration Number)\n   *\n   * @param tin - The TIN to validate\n   * @param idType - The type of ID to validate against\n   * @param idValue - The value of the ID to validate against\n   * @returns true if the TIN is valid, false otherwise\n   */\n  async verifyTin(\n    tin: string,\n    idType: RegistrationType,\n    idValue: string,\n  ): Promise<boolean> {\n    try {\n      const response = await this.fetch(\n        `/api/v1.0/taxpayer/validate/${tin}?idType=${idType}&idValue=${idValue}`,\n        {\n          method: 'GET',\n        },\n      )\n\n      if (response.status === 200) {\n        return true\n      }\n\n      return false\n    } catch (error) {\n      if (this.debug) {\n        console.error(error)\n      }\n      return false\n    }\n  }\n\n  /**\n   * Submits one or more e-invoice documents to the MyInvois platform for processing.\n   *\n   * This method digitally signs each document using the provided certificate and private key,\n   * generates document hashes, encodes them for submission, and sends them to the platform.\n   * The method includes comprehensive validation warnings for document size and count limits.\n   *\n   * @param documents - Array of InvoiceV1_1 documents to be submitted\n   * @returns Promise resolving to submission response containing the submission data and HTTP status\n   * @throws {Error} If PRIVATE_KEY or CERTIFICATE environment variables are missing\n   * @throws {Error} If document signing, encoding, or API submission fails\n   *\n   * @example\n   * ```typescript\n   * // Submit a single invoice\n   * const result = await client.submitDocument([invoiceData]);\n   * console.log(result.data.submissionUid); // Track submission with this UID\n   *\n   * // Submit multiple invoices\n   * const result = await client.submitDocument([invoice1, invoice2, invoice3]);\n   * if (result.status === 202) {\n   *   console.log('Documents submitted successfully');\n   * }\n   * ```\n   *\n   * @remarks\n   * - Requires PRIVATE_KEY and CERTIFICATE environment variables for document signing\n   * - Each document is digitally signed with XML-DSIG before submission\n   * - Documents are base64-encoded for transmission\n   * - API limits: Max 100 documents per submission, 5MB total payload, 300KB per document\n   * - Debug mode provides detailed logging of payload sizes and validation warnings\n   * - Returns HTTP 202 for successful submissions that require processing\n   */\n  async submitDocument(documents: InvoiceV1_1[]): Promise<{\n    data: SubmissionResponse\n    status: number\n  }> {\n    if (this.debug) {\n      console.log(`📦 Preparing to submit ${documents.length} document(s)...`)\n    }\n\n    // Generate the complete signed document structure first\n    const completeDocument = generateCompleteDocument(\n      documents,\n      this.signingCredentials,\n    )\n\n    if (this.debug) {\n      console.log('✅ Documents signed successfully')\n      console.log('📄 Document structure keys:', Object.keys(completeDocument))\n      console.log('📊 Number of invoices:', completeDocument.Invoice.length)\n    }\n\n    // Convert the complete document to JSON string\n    const documentJson = JSON.stringify(completeDocument)\n\n    if (this.debug) {\n      console.log(`📏 Document JSON size: ${documentJson.length} bytes`)\n    }\n\n    // Generate SHA256 hash of the JSON document\n    const crypto = await import('crypto')\n    const documentHash = crypto\n      .createHash('sha256')\n      .update(documentJson, 'utf8')\n      .digest('hex')\n\n    // Base64 encode the JSON document\n    const documentBase64 = Buffer.from(documentJson, 'utf8').toString('base64')\n\n    if (this.debug) {\n      console.log(`🔒 Document hash: ${documentHash.substring(0, 16)}...`)\n      console.log(`📦 Base64 size: ${documentBase64.length} bytes`)\n    }\n\n    // Build the submission payload according to MyInvois API format\n    const submissionPayload = {\n      documents: documents.map(doc => ({\n        format: 'JSON', // We're submitting JSON format\n        document: documentBase64, // Base64 encoded complete document\n        documentHash: documentHash, // SHA256 hash of the JSON\n        codeNumber: doc.eInvoiceCodeOrNumber, // Document reference number\n      })),\n    }\n\n    if (this.debug) {\n      console.log('🚀 Submission payload structure:')\n      console.log('- Format: JSON')\n      console.log('- Documents count:', submissionPayload.documents.length)\n      console.log(\n        '- Total payload size:',\n        JSON.stringify(submissionPayload).length,\n        'bytes',\n      )\n\n      // Validate submission constraints\n      const payloadSize = JSON.stringify(submissionPayload).length\n      if (payloadSize > 5 * 1024 * 1024) {\n        // 5MB\n        console.warn('⚠️  WARNING: Payload size exceeds 5MB limit')\n      }\n\n      if (documents.length > 100) {\n        console.warn('⚠️  WARNING: Document count exceeds 100 document limit')\n      }\n\n      if (documentJson.length > 300 * 1024) {\n        // 300KB per document\n        console.warn('⚠️  WARNING: Document size exceeds 300KB limit')\n      }\n    }\n\n    // Submit to MyInvois API with proper headers\n    const response = await this.fetch('/api/v1.0/documentsubmissions', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(submissionPayload),\n    })\n\n    if (this.debug) {\n      console.log(`📡 API Response status: ${response.status}`)\n    }\n\n    const data = (await response.json()) as SubmissionResponse\n\n    if (this.debug) {\n      if (response.status !== 202) {\n        console.error('❌ Submission failed with status:', response.status)\n        console.error('❌ Response data:', data)\n      } else {\n        console.log('✅ Submission successful!')\n        console.log(`📋 Submission UID: ${data.submissionUid}`)\n        console.log(\n          `✅ Accepted documents: ${data.acceptedDocuments?.length || 0}`,\n        )\n        console.log(\n          `❌ Rejected documents: ${data.rejectedDocuments?.length || 0}`,\n        )\n      }\n    }\n\n    return {\n      data,\n      status: response.status,\n    }\n  }\n\n  async getSubmissionStatus(\n    submissionUid: string,\n    pollInterval: number = 1000,\n    maxRetries: number = 10,\n  ): Promise<{\n    status: SubmissionStatus\n    documentSummary?: DocumentSummary[]\n    error?: {\n      code: string\n      message: string | null\n      target: string\n      details: {\n        code: string\n        message: string\n        target: string\n      }[]\n    }\n  }> {\n    try {\n      const response = await this.fetch(\n        `/api/v1.0/documentsubmissions/${submissionUid}`,\n      )\n\n      const data = (await response.json()) as GetSubmissionResponse\n\n      if (this.debug) {\n        console.log('Submission:', data)\n        if (data.error) {\n          console.log('Submission error details:', data.error.details)\n        }\n      }\n\n      // If we have a successful response and status is completed, return success\n      if (data.overallStatus === 'Valid') {\n        return {\n          status: data.overallStatus,\n          documentSummary: data.documentSummary,\n        }\n      }\n      if (data.overallStatus === 'Invalid') {\n        return {\n          status: 'Invalid',\n          documentSummary: data.documentSummary,\n        }\n      }\n\n      // If we have retries left, continue polling for any non-completed status or errors\n      if (maxRetries > 0) {\n        await new Promise(resolve => setTimeout(resolve, pollInterval))\n        return await this.getSubmissionStatus(\n          submissionUid,\n          pollInterval,\n          maxRetries - 1,\n        )\n      }\n\n      // No retries left - return timeout\n      return {\n        status: 'Invalid',\n        error: {\n          code: 'Timeout',\n          message: 'Submission timed out',\n          target: 'submission',\n          details: [],\n        },\n      }\n    } catch (error) {\n      // Handle any request errors by retrying if we have retries left\n      if (maxRetries > 0) {\n        if (this.debug) {\n          console.log('Request error, retrying...', error)\n        }\n        await new Promise(resolve => setTimeout(resolve, pollInterval))\n        return await this.getSubmissionStatus(\n          submissionUid,\n          pollInterval,\n          maxRetries - 1,\n        )\n      }\n\n      // No retries left - return timeout\n      return {\n        status: 'Invalid',\n        error: {\n          code: 'Timeout',\n          message: 'Submission timed out after request errors',\n          target: 'submission',\n          details: [],\n        },\n      }\n    }\n  }\n\n  /**\n   * Retrieves a document by its unique identifier with the raw document content.\n   *\n   * @param documentUid - The unique identifier of the document to retrieve\n   * @returns Promise resolving to document summary with raw document content as a string\n   * @throws {Error} If the document is not found or request fails\n   *\n   * @example\n   * ```typescript\n   * const document = await client.getDocument('doc-uuid-123');\n   * console.log(document.document); // Raw XML/JSON content\n   * console.log(document.uuid); // Document UUID\n   * ```\n   */\n  async getDocument(\n    documentUid: string,\n  ): Promise<DocumentSummary & { document: string }> {\n    const response = await this.fetch(`/api/v1.0/documents/${documentUid}/raw`)\n\n    const data = await response.json()\n\n    return data as DocumentSummary & { document: string }\n  }\n\n  /**\n   * Retrieves detailed information about a document including validation results.\n   *\n   * @param documentUid - The unique identifier of the document to get details for\n   * @returns Promise resolving to document summary with detailed validation results\n   * @throws {Error} If the document is not found or request fails\n   *\n   * @example\n   * ```typescript\n   * const details = await client.getDocumentDetails('doc-uuid-123');\n   * console.log(details.validationResults.status); // 'Valid' | 'Invalid' | 'Processing'\n   * console.log(details.validationResults.validationSteps); // Array of validation step results\n   * ```\n   */\n  async getDocumentDetails(documentUid: string): Promise<\n    DocumentSummary & {\n      validationResults: {\n        status: DocumentValidationResult\n        validationSteps: DocumentValidationStepResult[]\n      }\n    }\n  > {\n    const response = await this.fetch(\n      `/api/v1.0/documents/${documentUid}/details`,\n    )\n\n    const data = (await response.json()) as DocumentSummary & {\n      validationResults: {\n        status: DocumentValidationResult\n        validationSteps: DocumentValidationStepResult[]\n      }\n    }\n\n    return data\n  }\n\n  /**\n   * Searches for documents based on various filter criteria.\n   *\n   * @param params - Search parameters object\n   * @param params.uuid - Optional specific document UUID to search for\n   * @param params.submissionDateFrom - Required start date for submission date range (ISO date string)\n   * @param params.submissionDateTo - Optional end date for submission date range (ISO date string)\n   * @param params.pageSize - Optional number of results per page (default handled by API)\n   * @param params.pageNo - Optional page number for pagination (0-based)\n   * @param params.issueDateFrom - Optional start date for issue date range (ISO date string)\n   * @param params.issueDateTo - Optional end date for issue date range (ISO date string)\n   * @param params.invoiceDirection - Optional filter by invoice direction ('Sent' or 'Received')\n   * @param params.status - Optional filter by document status\n   * @param params.documentType - Optional filter by e-invoice type code\n   * @param params.searchQuery - Optional text search across uuid, buyerTIN, supplierTIN, buyerName, supplierName, internalID, total\n   * @returns Promise resolving to array of document summaries matching the search criteria\n   * @throws {Error} If the search request fails\n   *\n   * @example\n   * ```typescript\n   * // Search for documents submitted in the last 30 days\n   * const documents = await client.searchDocuments({\n   *   submissionDateFrom: '2024-01-01',\n   *   submissionDateTo: '2024-01-31',\n   *   status: 'Valid',\n   *   pageSize: 10\n   * });\n   *\n   * // Search by supplier name\n   * const supplierDocs = await client.searchDocuments({\n   *   submissionDateFrom: '2024-01-01',\n   *   searchQuery: 'ACME Corp',\n   *   invoiceDirection: 'Received'\n   * });\n   * ```\n   */\n  async searchDocuments({\n    uuid,\n    submissionDateFrom,\n    submissionDateTo,\n    pageSize,\n    pageNo,\n    issueDateFrom,\n    issueDateTo,\n    invoiceDirection,\n    status,\n    documentType,\n    searchQuery,\n  }: {\n    uuid?: string\n    submissionDateFrom: string\n    submissionDateTo?: string\n    pageSize?: number\n    pageNo?: number\n    issueDateFrom?: string\n    issueDateTo?: string\n    invoiceDirection?: 'Sent' | 'Received'\n    status?: DocumentStatus\n    documentType?: EInvoiceTypeCode\n    searchQuery?: string // Search by uuid, buyerTIN, supplierTIN, buyerName, supplierName, internalID, total\n  }): Promise<DocumentSummary[]> {\n    const queryParams = new URLSearchParams()\n\n    if (uuid) queryParams.set('uuid', uuid)\n    if (submissionDateFrom)\n      queryParams.set('submissionDateFrom', submissionDateFrom)\n    if (submissionDateTo) queryParams.set('submissionDateTo', submissionDateTo)\n    if (pageSize) queryParams.set('pageSize', pageSize.toString())\n    if (pageNo) queryParams.set('pageNo', pageNo.toString())\n    if (issueDateFrom) queryParams.set('issueDateFrom', issueDateFrom)\n    if (issueDateTo) queryParams.set('issueDateTo', issueDateTo)\n    if (invoiceDirection) queryParams.set('invoiceDirection', invoiceDirection)\n    if (status) queryParams.set('status', status)\n    if (documentType) queryParams.set('documentType', documentType)\n    if (searchQuery) queryParams.set('searchQuery', searchQuery)\n\n    const response = await this.fetch(\n      `/api/v1.0/documents/search?${queryParams.toString()}`,\n    )\n\n    const data = (await response.json()) as DocumentSummary[]\n\n    return data\n  }\n}\n\nexport type * from './types/index.d.ts'\n"],"mappings":"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"}