@ripwords/myinvois-client 0.2.0 → 0.2.2

package/dist/api/documentManagement.d.ts

@@ -55,7 +55,7 @@ import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../state-codes-VOFWhHA0.js";
 import "../notifications-B4l_qRj7.js";
-import "../taxpayer-D67d2zAC.js";
+import "../taxpayer-fpGIHNXp.js";
 import { Fetch } from "../utils-B3mo51Zp.js";
 import "../index-FTgB2nM6.js";
 

package/dist/api/documentSubmission.d.ts

@@ -55,7 +55,7 @@ import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../state-codes-VOFWhHA0.js";
 import "../notifications-B4l_qRj7.js";
-import "../taxpayer-D67d2zAC.js";
+import "../taxpayer-fpGIHNXp.js";
 import { Fetch } from "../utils-B3mo51Zp.js";
 import "../index-FTgB2nM6.js";
 

package/dist/api/documentTypeManagement.d.ts

@@ -55,7 +55,7 @@ import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../state-codes-VOFWhHA0.js";
 import "../notifications-B4l_qRj7.js";
-import "../taxpayer-D67d2zAC.js";
+import "../taxpayer-fpGIHNXp.js";
 import { Fetch } from "../utils-B3mo51Zp.js";
 import "../index-FTgB2nM6.js";
 

package/dist/api/notificationManagement.d.ts

@@ -55,7 +55,7 @@ import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../state-codes-VOFWhHA0.js";
 import { NotificationResponse, NotificationSearchParams } from "../notifications-B4l_qRj7.js";
-import "../taxpayer-D67d2zAC.js";
+import "../taxpayer-fpGIHNXp.js";
 import { Fetch } from "../utils-B3mo51Zp.js";
 import "../index-FTgB2nM6.js";
 

package/dist/api/platformLogin.d.ts

@@ -55,7 +55,7 @@ import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../state-codes-VOFWhHA0.js";
 import "../notifications-B4l_qRj7.js";
-import "../taxpayer-D67d2zAC.js";
+import "../taxpayer-fpGIHNXp.js";
 import "../utils-B3mo51Zp.js";
 import { ClientCredentials } from "../index-FTgB2nM6.js";
 

package/dist/api/taxpayerValidation.d.ts

@@ -55,7 +55,7 @@ import "../XX-DOA-10JW.js";
 import "../unit-types-VgYXIwTT.js";
 import "../state-codes-VOFWhHA0.js";
 import "../notifications-B4l_qRj7.js";
-import { TaxpayerQRCodeResponse } from "../taxpayer-D67d2zAC.js";
+import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "../taxpayer-fpGIHNXp.js";
 import { Fetch } from "../utils-B3mo51Zp.js";
 import "../index-FTgB2nM6.js";
 
@@ -64,14 +64,6 @@ interface TaxpayerContext {
   fetch: Fetch;
   debug: boolean;
 }
-interface TinSearchParams {
-  taxpayerName?: string;
-  idType?: RegistrationType;
-  idValue?: string;
-}
-interface TinSearchResponse {
-  tin: string;
-}
 declare function tinSearch(context: TaxpayerContext, params: TinSearchParams): Promise<TinSearchResponse | StandardError>;
 declare function verifyTin(context: TaxpayerContext, tin: string, idType: RegistrationType, idValue: string): Promise<boolean>;
 declare function taxpayerQRCode(context: TaxpayerContext, qrCodeText: string): Promise<TaxpayerQRCodeResponse | StandardError>;

package/dist/index.cjs

@@ -100,6 +100,115 @@ var MyInvoisClient = class {
 		}, tin, idType, idValue);
 	}
 	/**
+	* Searches for a Tax Identification Number (TIN) using taxpayer information.
+	*
+	* This method allows searching for a TIN using either a taxpayer name or a combination
+	* of identification type and value. The search is flexible and supports multiple
+	* identification types including NRIC, ARMY, PASSPORT, and BRN.
+	*
+	* @param params - Search parameters object
+	* @param params.taxpayerName - Optional name of the taxpayer to search for
+	* @param params.idType - Optional type of ID to search with (NRIC, ARMY, PASSPORT, BRN)
+	* @param params.idValue - Optional value of the ID to search with
+	* @returns Promise resolving to TIN search response or standard error
+	*
+	* @example
+	* ```typescript
+	* // Search by taxpayer name
+	* const result = await client.searchTin({ taxpayerName: 'John Doe' });
+	* if ('tin' in result) {
+	*   console.log('Found TIN:', result.tin);
+	* }
+	*
+	* // Search by ID type and value
+	* const result = await client.searchTin({
+	*   idType: 'NRIC',
+	*   idValue: '123456789012'
+	* });
+	* ```
+	*
+	* @remarks
+	* - Either taxpayerName or both idType and idValue must be provided
+	* - Returns StandardError object if search criteria are invalid or inconclusive
+	* - Debug mode provides detailed error logging for troubleshooting
+	* - Search results are not guaranteed to be unique
+	*/
+	async searchTin(params) {
+		return require_taxpayerValidation.tinSearch({
+			fetch: this.fetch.bind(this),
+			debug: this.debug
+		}, params);
+	}
+	/**
+	* Retrieves taxpayer information from a QR code.
+	* 
+	* This method decodes a QR code containing taxpayer information and returns
+	* detailed taxpayer data including TIN, name, contact details, and business information.
+	* 
+	* @param qrCodeText - The QR code text to decode
+	* @returns Promise resolving to taxpayer QR code response or standard error
+	* 
+	* @example
+	* ```typescript
+	* // Get taxpayer info from QR code
+	* const taxpayerInfo = await client.getTaxpayerQRCode('QR_CODE_TEXT');
+	* if ('tin' in taxpayerInfo) {
+	*   console.log('Taxpayer TIN:', taxpayerInfo.tin);
+	*   console.log('Business Name:', taxpayerInfo.name);
+	*   console.log('Address:', taxpayerInfo.addressLine1);
+	* }
+	* ```
+	* 
+	* @remarks
+	* - QR code must be in the correct format specified by MyInvois
+	* - Returns StandardError if QR code is invalid or cannot be decoded
+	* - Debug mode provides detailed error logging
+	*/
+	async getTaxpayerQRCode(qrCodeText) {
+		return require_taxpayerValidation.taxpayerQRCode({
+			fetch: this.fetch.bind(this),
+			debug: this.debug
+		}, qrCodeText);
+	}
+	/**
+	* Performs an action on a document such as rejection or cancellation.
+	* 
+	* This method allows updating the status of a document to either rejected or cancelled,
+	* along with providing a reason for the action. Useful for managing document workflow
+	* and maintaining audit trails.
+	* 
+	* @param documentUid - The unique identifier of the document
+	* @param status - The new status to set ('rejected' or 'cancelled')
+	* @param reason - The reason for the status change
+	* @returns Promise resolving to document action response containing UUID, status, and any errors
+	* 
+	* @example
+	* ```typescript
+	* // Reject a document with reason
+	* const result = await client.performDocumentAction(
+	*   'doc-123',
+	*   'rejected',
+	*   'Invalid tax calculation'
+	* );
+	* 
+	* // Cancel a document
+	* const result = await client.performDocumentAction(
+	*   'doc-456',
+	*   'cancelled',
+	*   'Duplicate submission'
+	* );
+	* ```
+	* 
+	* @remarks
+	* - Only valid for documents in appropriate states
+	* - Reason is required and should be descriptive
+	* - Action is irreversible once completed
+	* - Returns error if document cannot be found or action is invalid
+	*/
+	async performDocumentAction(documentUid, status, reason) {
+		return require_documentSubmission.performDocumentAction(documentUid, status, reason);
+	}
+	/**
 	* 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,

package/dist/index.cjs.map

@@ -1 +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","id: number","versionId: number"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  DocumentStatus,\n  DocumentSummary,\n  DocumentTypeResponse,\n  DocumentTypesResponse,\n  DocumentTypeVersionResponse,\n  DocumentValidationResult,\n  DocumentValidationStepResult,\n  EInvoiceTypeCode,\n  InvoiceV1_1,\n  NotificationResponse,\n  NotificationSearchParams,\n  RegistrationType,\n  SigningCredentials,\n  StandardError,\n  SubmissionResponse,\n  SubmissionStatus,\n} from './types'\n\nimport * as DocumentManagementAPI from './api/documentManagement'\nimport * as DocumentSubmissionAPI from './api/documentSubmission'\nimport * as DocumentTypeManagementAPI from './api/documentTypeManagement'\nimport * as NotificationManagementAPI from './api/notificationManagement'\nimport { platformLogin } from './api/platformLogin'\nimport * as TaxpayerValidationAPI from './api/taxpayerValidation'\nimport { extractCertificateInfo, validateKeyPair } from './utils/certificate'\nimport { getBaseUrl } from './utils/getBaseUrl'\n\nexport type * from './types/index.d.ts'\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   * This method verifies if a given Tax Identification Number (TIN) is valid by checking it against\n   * the provided identification type and value through the MyInvois platform's validation service.\n   *\n   * @param tin - The TIN to validate\n   * @param idType - The type of ID to validate against ('NRIC', 'ARMY', 'PASSPORT', or 'BRN')\n   * @param idValue - The value of the ID to validate against\n   * @returns Promise resolving to true if the TIN is valid, false otherwise\n   *\n   * @example\n   * ```typescript\n   * // Validate TIN against NRIC\n   * const isValid = await client.verifyTin('C12345678901234', 'NRIC', '123456789012');\n   * if (isValid) {\n   *   console.log('TIN is valid');\n   * }\n   *\n   * // Validate TIN against Business Registration Number\n   * const isValidBusiness = await client.verifyTin('C98765432109876', 'BRN', '123456-K');\n   * ```\n   *\n   * @remarks\n   * - Returns false if validation fails due to network errors or invalid credentials\n   * - Debug mode provides error logging for troubleshooting validation failures\n   * - This is a non-blocking validation that won't throw exceptions on failure\n   */\n  async verifyTin(\n    tin: string,\n    idType: RegistrationType,\n    idValue: string,\n  ): Promise<boolean> {\n    return TaxpayerValidationAPI.verifyTin(\n      { fetch: this.fetch.bind(this), debug: this.debug },\n      tin,\n      idType,\n      idValue,\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    return DocumentSubmissionAPI.submitDocument(\n      {\n        fetch: this.fetch.bind(this),\n        debug: this.debug,\n        signingCredentials: this.signingCredentials,\n      },\n      documents,\n    )\n  }\n\n  /**\n   * Polls the MyInvois platform to get the current status of a document submission.\n   *\n   * This method continuously checks the submission status until it receives a final result\n   * (Valid or Invalid) or reaches the maximum retry limit. It's designed to handle the\n   * asynchronous nature of document processing on the MyInvois platform.\n   *\n   * @param submissionUid - The unique identifier of the submission to check\n   * @param pollInterval - Time in milliseconds between status checks (default: 1000ms)\n   * @param maxRetries - Maximum number of retry attempts (default: 10)\n   * @returns Promise resolving to submission status object with document summary and any errors\n   *\n   * @example\n   * ```typescript\n   * // Check submission status with default polling\n   * const result = await client.getSubmissionStatus('submission-uid-123');\n   * if (result.status === 'Valid') {\n   *   console.log('All documents processed successfully');\n   *   console.log('Document summaries:', result.documentSummary);\n   * }\n   *\n   * // Custom polling interval and retry count\n   * const result = await client.getSubmissionStatus(\n   *   'submission-uid-123',\n   *   2000, // Poll every 2 seconds\n   *   20    // Try up to 20 times\n   * );\n   * ```\n   *\n   * @remarks\n   * - Automatically retries on network errors until maxRetries is reached\n   * - Returns 'Invalid' status with timeout error if submission processing takes too long\n   * - Debug mode provides detailed logging of polling attempts and responses\n   * - Use reasonable poll intervals to avoid overwhelming the API\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    return DocumentSubmissionAPI.getSubmissionStatus(\n      { fetch: this.fetch.bind(this), debug: this.debug },\n      submissionUid,\n      pollInterval,\n      maxRetries,\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    return DocumentManagementAPI.getDocument(\n      { fetch: this.fetch.bind(this) },\n      documentUid,\n    )\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    return DocumentManagementAPI.getDocumentDetails(\n      { fetch: this.fetch.bind(this) },\n      documentUid,\n    )\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    return DocumentManagementAPI.searchDocuments(\n      { fetch: this.fetch.bind(this) },\n      {\n        uuid,\n        submissionDateFrom,\n        submissionDateTo,\n        pageSize,\n        pageNo,\n        issueDateFrom,\n        issueDateTo,\n        invoiceDirection,\n        status,\n        documentType,\n        searchQuery,\n      },\n    )\n  }\n\n  /**\n   * Retrieves notifications from the MyInvois platform based on specified search criteria.\n   *\n   * This method allows you to search for system notifications, alerts, and messages\n   * sent by the MyInvois platform regarding document processing, system updates,\n   * or account-related information.\n   *\n   * @param params - Search parameters object for filtering notifications\n   * @param params.dateFrom - Optional start date for notification date range (ISO date string)\n   * @param params.dateTo - Optional end date for notification date range (ISO date string)\n   * @param params.type - Optional notification type filter\n   * @param params.language - Optional language preference for notifications\n   * @param params.status - Optional notification status filter\n   * @param params.pageNo - Optional page number for pagination (0-based)\n   * @param params.pageSize - Optional number of results per page\n   * @returns Promise resolving to notification response object or standard error\n   *\n   * @example\n   * ```typescript\n   * // Get all notifications from the last 7 days\n   * const notifications = await client.getNotifications({\n   *   dateFrom: '2024-01-01',\n   *   dateTo: '2024-01-07',\n   *   pageSize: 20\n   * });\n   *\n   * // Get unread notifications only\n   * const unreadNotifications = await client.getNotifications({\n   *   status: 0, // Assuming 0 = unread\n   *   language: 'en'\n   * });\n   *\n   * // Paginated notification retrieval\n   * const firstPage = await client.getNotifications({\n   *   dateFrom: '2024-01-01',\n   *   pageNo: 0,\n   *   pageSize: 10\n   * });\n   * ```\n   *\n   * @remarks\n   * - All parameters are optional, allowing flexible filtering\n   * - Returns paginated results when pageNo and pageSize are specified\n   * - Date parameters should be in ISO format (YYYY-MM-DD)\n   * - May return StandardError object if the request fails\n   */\n  async getNotifications({\n    dateFrom,\n    dateTo,\n    type,\n    language,\n    status,\n    pageNo,\n    pageSize,\n  }: NotificationSearchParams): Promise<NotificationResponse | StandardError> {\n    return NotificationManagementAPI.getNotifications(\n      { fetch: this.fetch.bind(this) },\n      {\n        dateFrom,\n        dateTo,\n        type,\n        language,\n        status,\n        pageNo,\n        pageSize,\n      },\n    )\n  }\n\n  async getDocumentTypes(): Promise<DocumentTypesResponse | StandardError> {\n    return DocumentTypeManagementAPI.getDocumentTypes({\n      fetch: this.fetch.bind(this),\n    })\n  }\n\n  /**\n   * Retrieves detailed information about a specific document type from the MyInvois platform.\n   *\n   * This method fetches metadata and configuration details for a specific document type,\n   * including supported versions, validation rules, and structural requirements.\n   * Useful for understanding document format requirements before submission.\n   *\n   * @param id - The unique identifier of the document type to retrieve\n   * @returns Promise resolving to document type response object or standard error\n   *\n   * @example\n   * ```typescript\n   * // Get details for e-invoice document type\n   * const invoiceType = await client.getDocumentType(1);\n   * if ('id' in invoiceType) {\n   *   console.log('Document type name:', invoiceType.name);\n   *   console.log('Available versions:', invoiceType.versionNumber);\n   *   console.log('Description:', invoiceType.description);\n   * }\n   *\n   * // Handle potential errors\n   * const documentType = await client.getDocumentType(999);\n   * if ('error' in documentType) {\n   *   console.error('Failed to retrieve document type:', documentType.error.message);\n   * }\n   * ```\n   *\n   * @remarks\n   * - Returns StandardError object if the document type ID doesn't exist\n   * - Document type information includes validation schemas and business rules\n   * - Use this method to discover supported document formats and versions\n   * - Essential for understanding submission requirements for different document types\n   */\n  async getDocumentType(\n    id: number,\n  ): Promise<DocumentTypeResponse | StandardError> {\n    return DocumentTypeManagementAPI.getDocumentType(\n      { fetch: this.fetch.bind(this) },\n      id,\n    )\n  }\n\n  /**\n   * Retrieves detailed information about a specific version of a document type.\n   *\n   * This method fetches version-specific metadata, schema definitions, and validation rules\n   * for a particular document type version. Essential for understanding the exact format\n   * and requirements for document submission in a specific version.\n   *\n   * @param id - The unique identifier of the document type\n   * @param versionId - The unique identifier of the specific version to retrieve\n   * @returns Promise resolving to document type version response object or standard error\n   *\n   * @example\n   * ```typescript\n   * // Get specific version details for e-invoice\n   * const invoiceV1_1 = await client.getDocumentTypeVersion(1, 1);\n   * if ('id' in invoiceV1_1) {\n   *   console.log('Version number:', invoiceV1_1.versionNumber);\n   *   console.log('Schema:', invoiceV1_1.jsonSchema);\n   *   console.log('Status:', invoiceV1_1.status);\n   * }\n   *\n   * // Compare different versions\n   * const [v1_0, v1_1] = await Promise.all([\n   *   client.getDocumentTypeVersion(1, 0),\n   *   client.getDocumentTypeVersion(1, 1)\n   * ]);\n   *\n   * // Handle version not found\n   * const result = await client.getDocumentTypeVersion(1, 999);\n   * if ('error' in result) {\n   *   console.error('Version not found:', result.error.message);\n   * }\n   * ```\n   *\n   * @remarks\n   * - Returns StandardError object if document type ID or version ID doesn't exist\n   * - Version information includes JSON schema for validation\n   * - Different versions may have different validation rules and field requirements\n   * - Use this to ensure your documents conform to the specific version requirements\n   * - Version status indicates if the version is active, deprecated, or under development\n   */\n  async getDocumentTypeVersion(\n    id: number,\n    versionId: number,\n  ): Promise<DocumentTypeVersionResponse | StandardError> {\n    return DocumentTypeManagementAPI.getDocumentTypeVersion(\n      { fetch: this.fetch.bind(this) },\n      id,\n      versionId,\n    )\n  }\n}\n"],"mappings":"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"}
+{"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","params: TinSearchParams","qrCodeText: string","documentUid: string","status: 'rejected' | 'cancelled'","reason: string","documents: InvoiceV1_1[]","submissionUid: string","pollInterval: number","maxRetries: number","id: number","versionId: number"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  DocumentStatus,\n  DocumentSummary,\n  DocumentTypeResponse,\n  DocumentTypesResponse,\n  DocumentTypeVersionResponse,\n  DocumentValidationResult,\n  DocumentValidationStepResult,\n  EInvoiceTypeCode,\n  InvoiceV1_1,\n  NotificationResponse,\n  NotificationSearchParams,\n  RegistrationType,\n  SigningCredentials,\n  StandardError,\n  SubmissionResponse,\n  SubmissionStatus,\n  TaxpayerQRCodeResponse,\n  TinSearchParams,\n  TinSearchResponse,\n} from './types'\n\nimport * as DocumentManagementAPI from './api/documentManagement'\nimport * as DocumentSubmissionAPI from './api/documentSubmission'\nimport * as DocumentTypeManagementAPI from './api/documentTypeManagement'\nimport * as NotificationManagementAPI from './api/notificationManagement'\nimport { platformLogin } from './api/platformLogin'\nimport * as TaxpayerValidationAPI from './api/taxpayerValidation'\nimport { extractCertificateInfo, validateKeyPair } from './utils/certificate'\nimport { getBaseUrl } from './utils/getBaseUrl'\n\nexport type * from './types/index.d.ts'\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   * This method verifies if a given Tax Identification Number (TIN) is valid by checking it against\n   * the provided identification type and value through the MyInvois platform's validation service.\n   *\n   * @param tin - The TIN to validate\n   * @param idType - The type of ID to validate against ('NRIC', 'ARMY', 'PASSPORT', or 'BRN')\n   * @param idValue - The value of the ID to validate against\n   * @returns Promise resolving to true if the TIN is valid, false otherwise\n   *\n   * @example\n   * ```typescript\n   * // Validate TIN against NRIC\n   * const isValid = await client.verifyTin('C12345678901234', 'NRIC', '123456789012');\n   * if (isValid) {\n   *   console.log('TIN is valid');\n   * }\n   *\n   * // Validate TIN against Business Registration Number\n   * const isValidBusiness = await client.verifyTin('C98765432109876', 'BRN', '123456-K');\n   * ```\n   *\n   * @remarks\n   * - Returns false if validation fails due to network errors or invalid credentials\n   * - Debug mode provides error logging for troubleshooting validation failures\n   * - This is a non-blocking validation that won't throw exceptions on failure\n   */\n  async verifyTin(\n    tin: string,\n    idType: RegistrationType,\n    idValue: string,\n  ): Promise<boolean> {\n    return TaxpayerValidationAPI.verifyTin(\n      { fetch: this.fetch.bind(this), debug: this.debug },\n      tin,\n      idType,\n      idValue,\n    )\n  }\n\n  /**\n   * Searches for a Tax Identification Number (TIN) using taxpayer information.\n   *\n   * This method allows searching for a TIN using either a taxpayer name or a combination\n   * of identification type and value. The search is flexible and supports multiple\n   * identification types including NRIC, ARMY, PASSPORT, and BRN.\n   *\n   * @param params - Search parameters object\n   * @param params.taxpayerName - Optional name of the taxpayer to search for\n   * @param params.idType - Optional type of ID to search with (NRIC, ARMY, PASSPORT, BRN)\n   * @param params.idValue - Optional value of the ID to search with\n   * @returns Promise resolving to TIN search response or standard error\n   *\n   * @example\n   * ```typescript\n   * // Search by taxpayer name\n   * const result = await client.searchTin({ taxpayerName: 'John Doe' });\n   * if ('tin' in result) {\n   *   console.log('Found TIN:', result.tin);\n   * }\n   *\n   * // Search by ID type and value\n   * const result = await client.searchTin({\n   *   idType: 'NRIC',\n   *   idValue: '123456789012'\n   * });\n   * ```\n   *\n   * @remarks\n   * - Either taxpayerName or both idType and idValue must be provided\n   * - Returns StandardError object if search criteria are invalid or inconclusive\n   * - Debug mode provides detailed error logging for troubleshooting\n   * - Search results are not guaranteed to be unique\n   */\n  async searchTin(\n    params: TinSearchParams,\n  ): Promise<TinSearchResponse | StandardError> {\n    return TaxpayerValidationAPI.tinSearch(\n      { fetch: this.fetch.bind(this), debug: this.debug },\n      params,\n    )\n  }\n\n  /**\n   * Retrieves taxpayer information from a QR code.\n   * \n   * This method decodes a QR code containing taxpayer information and returns\n   * detailed taxpayer data including TIN, name, contact details, and business information.\n   * \n   * @param qrCodeText - The QR code text to decode\n   * @returns Promise resolving to taxpayer QR code response or standard error\n   * \n   * @example\n   * ```typescript\n   * // Get taxpayer info from QR code\n   * const taxpayerInfo = await client.getTaxpayerQRCode('QR_CODE_TEXT');\n   * if ('tin' in taxpayerInfo) {\n   *   console.log('Taxpayer TIN:', taxpayerInfo.tin);\n   *   console.log('Business Name:', taxpayerInfo.name);\n   *   console.log('Address:', taxpayerInfo.addressLine1);\n   * }\n   * ```\n   * \n   * @remarks\n   * - QR code must be in the correct format specified by MyInvois\n   * - Returns StandardError if QR code is invalid or cannot be decoded\n   * - Debug mode provides detailed error logging\n   */\n  async getTaxpayerQRCode(\n    qrCodeText: string,\n  ): Promise<TaxpayerQRCodeResponse | StandardError> {\n    return TaxpayerValidationAPI.taxpayerQRCode(\n      { fetch: this.fetch.bind(this), debug: this.debug },\n      qrCodeText,\n    )\n  }\n\n  /**\n   * Performs an action on a document such as rejection or cancellation.\n   * \n   * This method allows updating the status of a document to either rejected or cancelled,\n   * along with providing a reason for the action. Useful for managing document workflow\n   * and maintaining audit trails.\n   * \n   * @param documentUid - The unique identifier of the document\n   * @param status - The new status to set ('rejected' or 'cancelled')\n   * @param reason - The reason for the status change\n   * @returns Promise resolving to document action response containing UUID, status, and any errors\n   * \n   * @example\n   * ```typescript\n   * // Reject a document with reason\n   * const result = await client.performDocumentAction(\n   *   'doc-123',\n   *   'rejected',\n   *   'Invalid tax calculation'\n   * );\n   * \n   * // Cancel a document\n   * const result = await client.performDocumentAction(\n   *   'doc-456',\n   *   'cancelled',\n   *   'Duplicate submission'\n   * );\n   * ```\n   * \n   * @remarks\n   * - Only valid for documents in appropriate states\n   * - Reason is required and should be descriptive\n   * - Action is irreversible once completed\n   * - Returns error if document cannot be found or action is invalid\n   */\n  async performDocumentAction(\n    documentUid: string,\n    status: 'rejected' | 'cancelled',\n    reason: string,\n  ): Promise<{\n    uuid: string\n    status: string\n    error: StandardError\n  }> {\n    return DocumentSubmissionAPI.performDocumentAction(\n      documentUid,\n      status,\n      reason,\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    return DocumentSubmissionAPI.submitDocument(\n      {\n        fetch: this.fetch.bind(this),\n        debug: this.debug,\n        signingCredentials: this.signingCredentials,\n      },\n      documents,\n    )\n  }\n\n  /**\n   * Polls the MyInvois platform to get the current status of a document submission.\n   *\n   * This method continuously checks the submission status until it receives a final result\n   * (Valid or Invalid) or reaches the maximum retry limit. It's designed to handle the\n   * asynchronous nature of document processing on the MyInvois platform.\n   *\n   * @param submissionUid - The unique identifier of the submission to check\n   * @param pollInterval - Time in milliseconds between status checks (default: 1000ms)\n   * @param maxRetries - Maximum number of retry attempts (default: 10)\n   * @returns Promise resolving to submission status object with document summary and any errors\n   *\n   * @example\n   * ```typescript\n   * // Check submission status with default polling\n   * const result = await client.getSubmissionStatus('submission-uid-123');\n   * if (result.status === 'Valid') {\n   *   console.log('All documents processed successfully');\n   *   console.log('Document summaries:', result.documentSummary);\n   * }\n   *\n   * // Custom polling interval and retry count\n   * const result = await client.getSubmissionStatus(\n   *   'submission-uid-123',\n   *   2000, // Poll every 2 seconds\n   *   20    // Try up to 20 times\n   * );\n   * ```\n   *\n   * @remarks\n   * - Automatically retries on network errors until maxRetries is reached\n   * - Returns 'Invalid' status with timeout error if submission processing takes too long\n   * - Debug mode provides detailed logging of polling attempts and responses\n   * - Use reasonable poll intervals to avoid overwhelming the API\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    return DocumentSubmissionAPI.getSubmissionStatus(\n      { fetch: this.fetch.bind(this), debug: this.debug },\n      submissionUid,\n      pollInterval,\n      maxRetries,\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    return DocumentManagementAPI.getDocument(\n      { fetch: this.fetch.bind(this) },\n      documentUid,\n    )\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    return DocumentManagementAPI.getDocumentDetails(\n      { fetch: this.fetch.bind(this) },\n      documentUid,\n    )\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    return DocumentManagementAPI.searchDocuments(\n      { fetch: this.fetch.bind(this) },\n      {\n        uuid,\n        submissionDateFrom,\n        submissionDateTo,\n        pageSize,\n        pageNo,\n        issueDateFrom,\n        issueDateTo,\n        invoiceDirection,\n        status,\n        documentType,\n        searchQuery,\n      },\n    )\n  }\n\n  /**\n   * Retrieves notifications from the MyInvois platform based on specified search criteria.\n   *\n   * This method allows you to search for system notifications, alerts, and messages\n   * sent by the MyInvois platform regarding document processing, system updates,\n   * or account-related information.\n   *\n   * @param params - Search parameters object for filtering notifications\n   * @param params.dateFrom - Optional start date for notification date range (ISO date string)\n   * @param params.dateTo - Optional end date for notification date range (ISO date string)\n   * @param params.type - Optional notification type filter\n   * @param params.language - Optional language preference for notifications\n   * @param params.status - Optional notification status filter\n   * @param params.pageNo - Optional page number for pagination (0-based)\n   * @param params.pageSize - Optional number of results per page\n   * @returns Promise resolving to notification response object or standard error\n   *\n   * @example\n   * ```typescript\n   * // Get all notifications from the last 7 days\n   * const notifications = await client.getNotifications({\n   *   dateFrom: '2024-01-01',\n   *   dateTo: '2024-01-07',\n   *   pageSize: 20\n   * });\n   *\n   * // Get unread notifications only\n   * const unreadNotifications = await client.getNotifications({\n   *   status: 0, // Assuming 0 = unread\n   *   language: 'en'\n   * });\n   *\n   * // Paginated notification retrieval\n   * const firstPage = await client.getNotifications({\n   *   dateFrom: '2024-01-01',\n   *   pageNo: 0,\n   *   pageSize: 10\n   * });\n   * ```\n   *\n   * @remarks\n   * - All parameters are optional, allowing flexible filtering\n   * - Returns paginated results when pageNo and pageSize are specified\n   * - Date parameters should be in ISO format (YYYY-MM-DD)\n   * - May return StandardError object if the request fails\n   */\n  async getNotifications({\n    dateFrom,\n    dateTo,\n    type,\n    language,\n    status,\n    pageNo,\n    pageSize,\n  }: NotificationSearchParams): Promise<NotificationResponse | StandardError> {\n    return NotificationManagementAPI.getNotifications(\n      { fetch: this.fetch.bind(this) },\n      {\n        dateFrom,\n        dateTo,\n        type,\n        language,\n        status,\n        pageNo,\n        pageSize,\n      },\n    )\n  }\n\n  async getDocumentTypes(): Promise<DocumentTypesResponse | StandardError> {\n    return DocumentTypeManagementAPI.getDocumentTypes({\n      fetch: this.fetch.bind(this),\n    })\n  }\n\n  /**\n   * Retrieves detailed information about a specific document type from the MyInvois platform.\n   *\n   * This method fetches metadata and configuration details for a specific document type,\n   * including supported versions, validation rules, and structural requirements.\n   * Useful for understanding document format requirements before submission.\n   *\n   * @param id - The unique identifier of the document type to retrieve\n   * @returns Promise resolving to document type response object or standard error\n   *\n   * @example\n   * ```typescript\n   * // Get details for e-invoice document type\n   * const invoiceType = await client.getDocumentType(1);\n   * if ('id' in invoiceType) {\n   *   console.log('Document type name:', invoiceType.name);\n   *   console.log('Available versions:', invoiceType.versionNumber);\n   *   console.log('Description:', invoiceType.description);\n   * }\n   *\n   * // Handle potential errors\n   * const documentType = await client.getDocumentType(999);\n   * if ('error' in documentType) {\n   *   console.error('Failed to retrieve document type:', documentType.error.message);\n   * }\n   * ```\n   *\n   * @remarks\n   * - Returns StandardError object if the document type ID doesn't exist\n   * - Document type information includes validation schemas and business rules\n   * - Use this method to discover supported document formats and versions\n   * - Essential for understanding submission requirements for different document types\n   */\n  async getDocumentType(\n    id: number,\n  ): Promise<DocumentTypeResponse | StandardError> {\n    return DocumentTypeManagementAPI.getDocumentType(\n      { fetch: this.fetch.bind(this) },\n      id,\n    )\n  }\n\n  /**\n   * Retrieves detailed information about a specific version of a document type.\n   *\n   * This method fetches version-specific metadata, schema definitions, and validation rules\n   * for a particular document type version. Essential for understanding the exact format\n   * and requirements for document submission in a specific version.\n   *\n   * @param id - The unique identifier of the document type\n   * @param versionId - The unique identifier of the specific version to retrieve\n   * @returns Promise resolving to document type version response object or standard error\n   *\n   * @example\n   * ```typescript\n   * // Get specific version details for e-invoice\n   * const invoiceV1_1 = await client.getDocumentTypeVersion(1, 1);\n   * if ('id' in invoiceV1_1) {\n   *   console.log('Version number:', invoiceV1_1.versionNumber);\n   *   console.log('Schema:', invoiceV1_1.jsonSchema);\n   *   console.log('Status:', invoiceV1_1.status);\n   * }\n   *\n   * // Compare different versions\n   * const [v1_0, v1_1] = await Promise.all([\n   *   client.getDocumentTypeVersion(1, 0),\n   *   client.getDocumentTypeVersion(1, 1)\n   * ]);\n   *\n   * // Handle version not found\n   * const result = await client.getDocumentTypeVersion(1, 999);\n   * if ('error' in result) {\n   *   console.error('Version not found:', result.error.message);\n   * }\n   * ```\n   *\n   * @remarks\n   * - Returns StandardError object if document type ID or version ID doesn't exist\n   * - Version information includes JSON schema for validation\n   * - Different versions may have different validation rules and field requirements\n   * - Use this to ensure your documents conform to the specific version requirements\n   * - Version status indicates if the version is active, deprecated, or under development\n   */\n  async getDocumentTypeVersion(\n    id: number,\n    versionId: number,\n  ): Promise<DocumentTypeVersionResponse | StandardError> {\n    return DocumentTypeManagementAPI.getDocumentTypeVersion(\n      { fetch: this.fetch.bind(this) },\n      id,\n      versionId,\n    )\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -55,7 +55,7 @@ import "./XX-DOA-10JW.js";
 import { UnitType, UnitTypeCode } from "./unit-types-VgYXIwTT.js";
 import { State, StateCode, StateCodeEnum } from "./state-codes-VOFWhHA0.js";
 import { Notification, NotificationDeliveryAttempt, NotificationMetadata, NotificationResponse, NotificationSearchParams, NotificationStatus, NotificationStatusEnum, NotificationType, NotificationTypeEnum } from "./notifications-B4l_qRj7.js";
-import { TaxpayerQRCodeResponse } from "./taxpayer-D67d2zAC.js";
+import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "./taxpayer-fpGIHNXp.js";
 import { Fetch } from "./utils-B3mo51Zp.js";
 import { ClientCredentials, TokenResponse } from "./index-FTgB2nM6.js";
 
@@ -103,6 +103,107 @@ declare class MyInvoisClient {
   */
   verifyTin(tin: string, idType: RegistrationType, idValue: string): Promise<boolean>;
   /**
+  * Searches for a Tax Identification Number (TIN) using taxpayer information.
+  *
+  * This method allows searching for a TIN using either a taxpayer name or a combination
+  * of identification type and value. The search is flexible and supports multiple
+  * identification types including NRIC, ARMY, PASSPORT, and BRN.
+  *
+  * @param params - Search parameters object
+  * @param params.taxpayerName - Optional name of the taxpayer to search for
+  * @param params.idType - Optional type of ID to search with (NRIC, ARMY, PASSPORT, BRN)
+  * @param params.idValue - Optional value of the ID to search with
+  * @returns Promise resolving to TIN search response or standard error
+  *
+  * @example
+  * ```typescript
+  * // Search by taxpayer name
+  * const result = await client.searchTin({ taxpayerName: 'John Doe' });
+  * if ('tin' in result) {
+  *   console.log('Found TIN:', result.tin);
+  * }
+  *
+  * // Search by ID type and value
+  * const result = await client.searchTin({
+  *   idType: 'NRIC',
+  *   idValue: '123456789012'
+  * });
+  * ```
+  *
+  * @remarks
+  * - Either taxpayerName or both idType and idValue must be provided
+  * - Returns StandardError object if search criteria are invalid or inconclusive
+  * - Debug mode provides detailed error logging for troubleshooting
+  * - Search results are not guaranteed to be unique
+  */
+  searchTin(params: TinSearchParams): Promise<TinSearchResponse | StandardError>;
+  /**
+  * Retrieves taxpayer information from a QR code.
+  * 
+  * This method decodes a QR code containing taxpayer information and returns
+  * detailed taxpayer data including TIN, name, contact details, and business information.
+  * 
+  * @param qrCodeText - The QR code text to decode
+  * @returns Promise resolving to taxpayer QR code response or standard error
+  * 
+  * @example
+  * ```typescript
+  * // Get taxpayer info from QR code
+  * const taxpayerInfo = await client.getTaxpayerQRCode('QR_CODE_TEXT');
+  * if ('tin' in taxpayerInfo) {
+  *   console.log('Taxpayer TIN:', taxpayerInfo.tin);
+  *   console.log('Business Name:', taxpayerInfo.name);
+  *   console.log('Address:', taxpayerInfo.addressLine1);
+  * }
+  * ```
+  * 
+  * @remarks
+  * - QR code must be in the correct format specified by MyInvois
+  * - Returns StandardError if QR code is invalid or cannot be decoded
+  * - Debug mode provides detailed error logging
+  */
+  getTaxpayerQRCode(qrCodeText: string): Promise<TaxpayerQRCodeResponse | StandardError>;
+  /**
+  * Performs an action on a document such as rejection or cancellation.
+  * 
+  * This method allows updating the status of a document to either rejected or cancelled,
+  * along with providing a reason for the action. Useful for managing document workflow
+  * and maintaining audit trails.
+  * 
+  * @param documentUid - The unique identifier of the document
+  * @param status - The new status to set ('rejected' or 'cancelled')
+  * @param reason - The reason for the status change
+  * @returns Promise resolving to document action response containing UUID, status, and any errors
+  * 
+  * @example
+  * ```typescript
+  * // Reject a document with reason
+  * const result = await client.performDocumentAction(
+  *   'doc-123',
+  *   'rejected',
+  *   'Invalid tax calculation'
+  * );
+  * 
+  * // Cancel a document
+  * const result = await client.performDocumentAction(
+  *   'doc-456',
+  *   'cancelled',
+  *   'Duplicate submission'
+  * );
+  * ```
+  * 
+  * @remarks
+  * - Only valid for documents in appropriate states
+  * - Reason is required and should be descriptive
+  * - Action is irreversible once completed
+  * - Returns error if document cannot be found or action is invalid
+  */
+  performDocumentAction(documentUid: string, status: "rejected" | "cancelled", reason: string): Promise<{
+    uuid: string;
+    status: string;
+    error: StandardError;
+  }>;
+  /**
   * 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,
@@ -420,4 +521,4 @@ declare class MyInvoisClient {
   getDocumentTypeVersion(id: number, versionId: number): Promise<DocumentTypeVersionResponse | StandardError>;
 }
 //#endregion
-export { Address, Buyer, CanonicalizationMethod, Cert, CertDigest, Classification, ClassificationCode, ClassificationCodeEnum, ClientCredentials, CompleteInvoice, Country, CountryCode, CountryCodeEnum, CountryNameEnum, Currency, CurrencyCode, CurrencyCodeEnum, DigestMethod, DocumentStatus, DocumentSummary, DocumentTypeResponse, DocumentTypeVersion, DocumentTypeVersionResponse, DocumentTypesResponse, DocumentValidationResult, DocumentValidationStepResult, EInvoiceType, EInvoiceTypeCode, EInvoiceTypeCodeEnum, Fetch, FinalDocumentData, GetSubmissionResponse, InvoiceLineItem, InvoiceSubmission, InvoiceV1_1, IssuerDigitalSignature, IssuerSerial, KeyInfo, LegalMonetaryTotal, MSICCode, MyInvoisClient, Notification, NotificationDeliveryAttempt, NotificationMetadata, NotificationResponse, NotificationSearchParams, NotificationStatus, NotificationStatusEnum, NotificationType, NotificationTypeEnum, PaymentMode, PaymentModeCode, PaymentModeCodeEnum, QualifyingProperties, Reference, RegistrationType, ResponseDocument, SignatureMethod, SignedInfo, SignedInfoObject, SignedInvoiceSubmission, SignedProperties, SignedPropertiesData, SignedPropertiesObject, SignedSignatureProperties, SigningCertificate, SigningCredentials, StandardError, State, StateCode, StateCodeEnum, SubmissionResponse, SubmissionStatus, Supplier, TaxCategory, TaxSubtotal, TaxTotal, TaxType, TaxTypeCode, TaxTypeCodeEnum, TaxpayerQRCodeResponse, TokenResponse, Transform, UBLDocument, UnitType, UnitTypeCode, WorkflowParameter, X509Data };
+export { Address, Buyer, CanonicalizationMethod, Cert, CertDigest, Classification, ClassificationCode, ClassificationCodeEnum, ClientCredentials, CompleteInvoice, Country, CountryCode, CountryCodeEnum, CountryNameEnum, Currency, CurrencyCode, CurrencyCodeEnum, DigestMethod, DocumentStatus, DocumentSummary, DocumentTypeResponse, DocumentTypeVersion, DocumentTypeVersionResponse, DocumentTypesResponse, DocumentValidationResult, DocumentValidationStepResult, EInvoiceType, EInvoiceTypeCode, EInvoiceTypeCodeEnum, Fetch, FinalDocumentData, GetSubmissionResponse, InvoiceLineItem, InvoiceSubmission, InvoiceV1_1, IssuerDigitalSignature, IssuerSerial, KeyInfo, LegalMonetaryTotal, MSICCode, MyInvoisClient, Notification, NotificationDeliveryAttempt, NotificationMetadata, NotificationResponse, NotificationSearchParams, NotificationStatus, NotificationStatusEnum, NotificationType, NotificationTypeEnum, PaymentMode, PaymentModeCode, PaymentModeCodeEnum, QualifyingProperties, Reference, RegistrationType, ResponseDocument, 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/index.js

@@ -1,10 +1,10 @@
 import { getDocument, getDocumentDetails, searchDocuments } from "./documentManagement-CIQPkmyb.js";
 import "./document-BSuYbfXR.js";
-import { getSubmissionStatus, submitDocument } from "./documentSubmission-BdJxIB_I.js";
+import { getSubmissionStatus, performDocumentAction, submitDocument } from "./documentSubmission-BdJxIB_I.js";
 import { getDocumentType, getDocumentTypeVersion, getDocumentTypes } from "./documentTypeManagement-tojgXfm9.js";
 import { getNotifications } from "./notificationManagement-CHDRVy8J.js";
 import { platformLogin } from "./platformLogin-Ck1Fge2n.js";
-import { verifyTin } from "./taxpayerValidation-DI4B6kWx.js";
+import { taxpayerQRCode, tinSearch, verifyTin } from "./taxpayerValidation-DI4B6kWx.js";
 import { extractCertificateInfo, validateKeyPair } from "./certificate-BDECQL9C.js";
 import { getBaseUrl } from "./getBaseUrl-BYkBwhQP.js";
 
@@ -100,6 +100,115 @@ var MyInvoisClient = class {
 		}, tin, idType, idValue);
 	}
 	/**
+	* Searches for a Tax Identification Number (TIN) using taxpayer information.
+	*
+	* This method allows searching for a TIN using either a taxpayer name or a combination
+	* of identification type and value. The search is flexible and supports multiple
+	* identification types including NRIC, ARMY, PASSPORT, and BRN.
+	*
+	* @param params - Search parameters object
+	* @param params.taxpayerName - Optional name of the taxpayer to search for
+	* @param params.idType - Optional type of ID to search with (NRIC, ARMY, PASSPORT, BRN)
+	* @param params.idValue - Optional value of the ID to search with
+	* @returns Promise resolving to TIN search response or standard error
+	*
+	* @example
+	* ```typescript
+	* // Search by taxpayer name
+	* const result = await client.searchTin({ taxpayerName: 'John Doe' });
+	* if ('tin' in result) {
+	*   console.log('Found TIN:', result.tin);
+	* }
+	*
+	* // Search by ID type and value
+	* const result = await client.searchTin({
+	*   idType: 'NRIC',
+	*   idValue: '123456789012'
+	* });
+	* ```
+	*
+	* @remarks
+	* - Either taxpayerName or both idType and idValue must be provided
+	* - Returns StandardError object if search criteria are invalid or inconclusive
+	* - Debug mode provides detailed error logging for troubleshooting
+	* - Search results are not guaranteed to be unique
+	*/
+	async searchTin(params) {
+		return tinSearch({
+			fetch: this.fetch.bind(this),
+			debug: this.debug
+		}, params);
+	}
+	/**
+	* Retrieves taxpayer information from a QR code.
+	* 
+	* This method decodes a QR code containing taxpayer information and returns
+	* detailed taxpayer data including TIN, name, contact details, and business information.
+	* 
+	* @param qrCodeText - The QR code text to decode
+	* @returns Promise resolving to taxpayer QR code response or standard error
+	* 
+	* @example
+	* ```typescript
+	* // Get taxpayer info from QR code
+	* const taxpayerInfo = await client.getTaxpayerQRCode('QR_CODE_TEXT');
+	* if ('tin' in taxpayerInfo) {
+	*   console.log('Taxpayer TIN:', taxpayerInfo.tin);
+	*   console.log('Business Name:', taxpayerInfo.name);
+	*   console.log('Address:', taxpayerInfo.addressLine1);
+	* }
+	* ```
+	* 
+	* @remarks
+	* - QR code must be in the correct format specified by MyInvois
+	* - Returns StandardError if QR code is invalid or cannot be decoded
+	* - Debug mode provides detailed error logging
+	*/
+	async getTaxpayerQRCode(qrCodeText) {
+		return taxpayerQRCode({
+			fetch: this.fetch.bind(this),
+			debug: this.debug
+		}, qrCodeText);
+	}
+	/**
+	* Performs an action on a document such as rejection or cancellation.
+	* 
+	* This method allows updating the status of a document to either rejected or cancelled,
+	* along with providing a reason for the action. Useful for managing document workflow
+	* and maintaining audit trails.
+	* 
+	* @param documentUid - The unique identifier of the document
+	* @param status - The new status to set ('rejected' or 'cancelled')
+	* @param reason - The reason for the status change
+	* @returns Promise resolving to document action response containing UUID, status, and any errors
+	* 
+	* @example
+	* ```typescript
+	* // Reject a document with reason
+	* const result = await client.performDocumentAction(
+	*   'doc-123',
+	*   'rejected',
+	*   'Invalid tax calculation'
+	* );
+	* 
+	* // Cancel a document
+	* const result = await client.performDocumentAction(
+	*   'doc-456',
+	*   'cancelled',
+	*   'Duplicate submission'
+	* );
+	* ```
+	* 
+	* @remarks
+	* - Only valid for documents in appropriate states
+	* - Reason is required and should be descriptive
+	* - Action is irreversible once completed
+	* - Returns error if document cannot be found or action is invalid
+	*/
+	async performDocumentAction(documentUid, status, reason) {
+		return performDocumentAction(documentUid, status, reason);
+	}
+	/**
 	* 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,