@ripwords/myinvois-client 0.4.0 → 0.4.1

package/dist/index.d.ts

@@ -0,0 +1,616 @@
+import { Classification, ClassificationCode, ClassificationCodeEnum } from "./classification-codes-BQMnAQFr.js";
+import { Country, CountryCode, CountryCodeEnum, CountryNameEnum } from "./country-code-DAejE5RV.js";
+import { Currency, CurrencyCode, CurrencyCodeEnum } from "./currencies-Cg9RkxRB.js";
+import { EInvoiceType, EInvoiceTypeCode, EInvoiceTypeCodeEnum } from "./e-invoice-BSCFsH-H.js";
+import "./0X-bPhcc9Vv.js";
+import "./1X-DKHYQyRy.js";
+import "./2X-DN6M21cV.js";
+import "./3X-DJRj5xLv.js";
+import "./4X-BCvTomUF.js";
+import "./5X-Dji6Soz5.js";
+import "./6X-CO_u4RIY.js";
+import "./7X-vzJ01lNF.js";
+import "./8X-C4Wf4jYK.js";
+import "./9X-1VwxN9g-.js";
+import { MSICCode } from "./msic-codes-kysVPGdN.js";
+import { TaxType, TaxTypeCode, TaxTypeCodeEnum } from "./tax-types-QeZFKqew.js";
+import { State, StateCode, StateCodeEnum } from "./state-codes-CAkYQnTd.js";
+import "./1X-Bqi8dmY1.js";
+import "./2X-CemxuAeL.js";
+import "./3X-DIYh_ue4.js";
+import "./4X-CZi5nwIr.js";
+import "./5X-DyYBCAvY.js";
+import "./6X-Csxu6lwi.js";
+import "./7X-DivvfBsk.js";
+import "./8X-D_Pw1H3K.js";
+import "./9X-BwR9pibT.js";
+import "./AX-CDubGAZO.js";
+import "./BX-CBsKI8np.js";
+import "./CX-DhOdAFyg.js";
+import "./DX-CBiRJGqR.js";
+import "./EX-CAn62WaX.js";
+import "./FX-CANpsLC4.js";
+import "./GX-BvSZZ8pE.js";
+import "./HX-CxrnY-YC.js";
+import "./IX-wdAD6eW8.js";
+import "./JX-B5v815to.js";
+import "./KX-BI8n7ACj.js";
+import "./LX-BVvEz6Ji.js";
+import "./MX-D_OsOP_v.js";
+import "./NX-DIhAzAY3.js";
+import "./OX-BZrRnj5g.js";
+import "./PX-DGGrJNym.js";
+import "./QX-DuTJFnHX.js";
+import "./RX-DYQoV7am.js";
+import "./SX-Dl1RlNnc.js";
+import "./TX-SoIfFaZj.js";
+import "./UX-DqBfrSsY.js";
+import "./VX-Ahcpp3Si.js";
+import "./WX-Di6vYD7A.js";
+import "./YX-BPO04gSZ.js";
+import "./ZX-DHu4FRKS.js";
+import "./XX-BE4flzh6.js";
+import { UnitType, UnitTypeCode } from "./unit-types-CZdxXbVN.js";
+import { Address, AllDocumentsV1_1, Buyer, CompleteInvoice, CreditNoteV1_1, DebitNoteV1_1, DocumentStatus, DocumentSummary, DocumentTypeResponse, DocumentTypeVersion, DocumentTypeVersionResponse, DocumentTypesResponse, DocumentValidationResult, DocumentValidationStepResult, FinalDocumentData, GetSubmissionResponse, InvoiceLineItem, InvoiceSubmission, InvoiceV1_1, LegalMonetaryTotal, RefundNoteV1_1, RegistrationType, ResponseDocument, SelfBilledCreditNoteV1_1, SelfBilledInvoiceV1_1, SelfBilledRefundNoteV1_1, SignedInfoObject, SignedInvoiceSubmission, SignedPropertiesData, SignedPropertiesObject, SigningCredentials, StandardError, SubmissionResponse, SubmissionStatus, Supplier, TaxCategory, TaxSubtotal, TaxTotal, UBLDocument, WorkflowParameter } from "./documents-BpZn3hJq.js";
+import { PaymentMode, PaymentModeCode, PaymentModeCodeEnum } from "./payment-modes-BGP5McTY.js";
+import { CanonicalizationMethod, Cert, CertDigest, DigestMethod, IssuerDigitalSignature, IssuerSerial, KeyInfo, QualifyingProperties, Reference, SignatureMethod, SignedInfo, SignedProperties, SignedSignatureProperties, SigningCertificate, Transform, X509Data } from "./signatures-Bk5aKcq6.js";
+import { Notification, NotificationDeliveryAttempt, NotificationMetadata, NotificationResponse, NotificationSearchParams, NotificationStatus, NotificationStatusEnum, NotificationType, NotificationTypeEnum } from "./notifications-B4BymhRJ.js";
+import { TaxpayerQRCodeResponse, TinSearchParams, TinSearchResponse } from "./taxpayer-B1CSMqNS.js";
+import { Fetch } from "./utils-BYVq373g.js";
+import { ClientCredentials, TokenResponse } from "./index-Dn3JIREW.js";
+import { AggregateByTaxCategoryOptions, aggregateLineItemsByTaxCategory } from "./lineItems-CrkEXi2m.js";
+
+//#region src/index.d.ts
+declare class MyInvoisClient {
+  private readonly baseUrl;
+  private readonly clientId;
+  private readonly clientSecret;
+  private readonly environment;
+  private onBehalfOf?;
+  private readonly signingCredentials;
+  private readonly debug;
+  private token;
+  private tokenExpiration;
+  private requestCount;
+  constructor(clientId: string, clientSecret: string, environment: "sandbox" | "production", certificatePem: string, privateKeyPem: string, onBehalfOf?: string, debug?: boolean);
+  updateOnBehalfOf(onBehalfOf: string): Promise<void>;
+  private refreshToken;
+  private getToken;
+  private fetch;
+  /**
+  * Validates a TIN against a NRIC/ARMY/PASSPORT/BRN (Business Registration Number)
+  *
+  * This method verifies if a given Tax Identification Number (TIN) is valid by checking it against
+  * the provided identification type and value through the MyInvois platform's validation service.
+  *
+  * @param tin - The TIN to validate
+  * @param idType - The type of ID to validate against ('NRIC', 'ARMY', 'PASSPORT', or 'BRN')
+  * @param idValue - The value of the ID to validate against
+  * @returns Promise resolving to true if the TIN is valid, false otherwise
+  *
+  * @example
+  * ```typescript
+  * // Validate TIN against NRIC
+  * const isValid = await client.verifyTin('C12345678901234', 'NRIC', '123456789012');
+  * if (isValid) {
+  *   console.log('TIN is valid');
+  * }
+  *
+  * // Validate TIN against Business Registration Number
+  * const isValidBusiness = await client.verifyTin('C98765432109876', 'BRN', '123456-K');
+  * ```
+  *
+  * @remarks
+  * - Returns false if validation fails due to network errors or invalid credentials
+  * - Debug mode provides error logging for troubleshooting validation failures
+  * - This is a non-blocking validation that won't throw exceptions on failure
+  */
+  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>;
+  /**
+  * 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>;
+  /**
+  * 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 (max 300 characters)
+  * @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, max 300 characters
+  * - Action is irreversible once completed
+  * - Returns error if document cannot be found or action is invalid
+  */
+  private performDocumentAction;
+  /**
+  * Cancels a document that was previously submitted.
+  *
+  * This is a convenience method that wraps performDocumentAction with 'cancelled' status.
+  * Documents can only be cancelled within 72 hours of validation.
+  *
+  * @param documentUid - The unique identifier of the document to cancel
+  * @param reason - The reason for cancellation (max 300 characters)
+  * @returns Promise resolving to document action response containing UUID, status, and any errors
+  *
+  * @example
+  * ```typescript
+  * const result = await client.cancelDocument(
+  *   'doc-456',
+  *   'Duplicate submission'
+  * );
+  * if (!result.error) {
+  *   console.log('Document cancelled:', result.uuid);
+  * }
+  * ```
+  *
+  * @remarks
+  * - Must be called within 72 hours of document validation
+  * - Reason is required, max 300 characters
+  * - Action is irreversible once completed
+  * - Rate limited to 12 requests per minute
+  */
+  cancelDocument(documentUid: string, reason: string): Promise<{
+    uuid: string;
+    status: string;
+    error?: StandardError;
+  }>;
+  /**
+  * Rejects a document received from another party.
+  *
+  * This is a convenience method that wraps performDocumentAction with 'rejected' status.
+  * Only documents received from other taxpayers can be rejected.
+  *
+  * @param documentUid - The unique identifier of the document to reject
+  * @param reason - The reason for rejection (max 300 characters)
+  * @returns Promise resolving to document action response containing UUID, status, and any errors
+  *
+  * @example
+  * ```typescript
+  * const result = await client.rejectDocument(
+  *   'doc-123',
+  *   'Invalid tax calculation'
+  * );
+  * if (!result.error) {
+  *   console.log('Document rejected:', result.uuid);
+  * }
+  * ```
+  *
+  * @remarks
+  * - Only applicable to received documents
+  * - Reason is required, max 300 characters
+  * - Action is irreversible once completed
+  * - Rate limited to 12 requests per minute
+  */
+  rejectDocument(documentUid: string, 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,
+  * 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
+  */
+  submitDocument(documents: AllDocumentsV1_1[]): Promise<{
+    data: SubmissionResponse;
+    status: number;
+  }>;
+  /**
+  * Polls the MyInvois platform to get the current status of a document submission.
+  *
+  * This method continuously checks the submission status until it receives a final result
+  * (Valid or Invalid) or reaches the maximum retry limit. It's designed to handle the
+  * asynchronous nature of document processing on the MyInvois platform.
+  *
+  * @param submissionUid - The unique identifier of the submission to check
+  * @param pollInterval - Time in milliseconds between status checks (default: 1000ms)
+  * @param maxRetries - Maximum number of retry attempts (default: 10)
+  * @returns Promise resolving to submission status object with document summary and any errors
+  *
+  * @example
+  * ```typescript
+  * // Check submission status with default polling
+  * const result = await client.getSubmissionStatus('submission-uid-123');
+  * if (result.status === 'Valid') {
+  *   console.log('All documents processed successfully');
+  *   console.log('Document summaries:', result.documentSummary);
+  * }
+  *
+  * // Custom polling interval and retry count
+  * const result = await client.getSubmissionStatus(
+  *   'submission-uid-123',
+  *   2000, // Poll every 2 seconds
+  *   20    // Try up to 20 times
+  * );
+  * ```
+  *
+  * @remarks
+  * - Automatically retries on network errors until maxRetries is reached
+  * - Returns 'Invalid' status with timeout error if submission processing takes too long
+  * - Debug mode provides detailed logging of polling attempts and responses
+  * - Use reasonable poll intervals to avoid overwhelming the API
+  */
+  getSubmissionStatus(submissionUid: string, pollInterval?: number, maxRetries?: number, pageNo?: number, pageSize?: number): Promise<{
+    status: SubmissionStatus;
+    documentSummary?: DocumentSummary[];
+    error?: {
+      code: string;
+      message: string | null;
+      target: string;
+      details: {
+        code: string;
+        message: string;
+        target: string;
+      }[];
+    };
+  }>;
+  /**
+  * 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
+  * ```
+  */
+  getDocument(documentUid: string): Promise<DocumentSummary & {
+    document: string;
+  }>;
+  /**
+  * 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
+  * ```
+  */
+  getDocumentDetails(documentUid: string): Promise<DocumentSummary & {
+    validationResults: {
+      status: DocumentValidationResult;
+      validationSteps: DocumentValidationStepResult[];
+    };
+  }>;
+  /**
+  * 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'
+  * });
+  * ```
+  */
+  searchDocuments({
+    uuid,
+    submissionDateFrom,
+    submissionDateTo,
+    pageSize,
+    pageNo,
+    issueDateFrom,
+    issueDateTo,
+    invoiceDirection,
+    status,
+    documentType,
+    searchQuery
+  }: {
+    uuid?: string;
+    submissionDateFrom: string;
+    submissionDateTo?: string;
+    pageSize?: number;
+    pageNo?: number;
+    issueDateFrom?: string;
+    issueDateTo?: string;
+    invoiceDirection?: "Sent" | "Received";
+    status?: DocumentStatus;
+    documentType?: EInvoiceTypeCode;
+    searchQuery?: string;
+  }): Promise<DocumentSummary[]>;
+  /**
+  * Retrieves notifications from the MyInvois platform based on specified search criteria.
+  *
+  * This method allows you to search for system notifications, alerts, and messages
+  * sent by the MyInvois platform regarding document processing, system updates,
+  * or account-related information.
+  *
+  * @param params - Search parameters object for filtering notifications
+  * @param params.dateFrom - Optional start date for notification date range (ISO date string)
+  * @param params.dateTo - Optional end date for notification date range (ISO date string)
+  * @param params.type - Optional notification type filter
+  * @param params.language - Optional language preference for notifications
+  * @param params.status - Optional notification status filter
+  * @param params.pageNo - Optional page number for pagination (0-based)
+  * @param params.pageSize - Optional number of results per page
+  * @returns Promise resolving to notification response object or standard error
+  *
+  * @example
+  * ```typescript
+  * // Get all notifications from the last 7 days
+  * const notifications = await client.getNotifications({
+  *   dateFrom: '2024-01-01',
+  *   dateTo: '2024-01-07',
+  *   pageSize: 20
+  * });
+  *
+  * // Get unread notifications only
+  * const unreadNotifications = await client.getNotifications({
+  *   status: 0, // Assuming 0 = unread
+  *   language: 'en'
+  * });
+  *
+  * // Paginated notification retrieval
+  * const firstPage = await client.getNotifications({
+  *   dateFrom: '2024-01-01',
+  *   pageNo: 0,
+  *   pageSize: 10
+  * });
+  * ```
+  *
+  * @remarks
+  * - All parameters are optional, allowing flexible filtering
+  * - Returns paginated results when pageNo and pageSize are specified
+  * - Date parameters should be in ISO format (YYYY-MM-DD)
+  * - May return StandardError object if the request fails
+  */
+  getNotifications({
+    dateFrom,
+    dateTo,
+    type,
+    language,
+    status,
+    pageNo,
+    pageSize
+  }: NotificationSearchParams): Promise<NotificationResponse>;
+  getDocumentTypes(): Promise<DocumentTypesResponse>;
+  /**
+  * Retrieves detailed information about a specific document type from the MyInvois platform.
+  *
+  * This method fetches metadata and configuration details for a specific document type,
+  * including supported versions, validation rules, and structural requirements.
+  * Useful for understanding document format requirements before submission.
+  *
+  * @param id - The unique identifier of the document type to retrieve
+  * @returns Promise resolving to document type response object or standard error
+  *
+  * @example
+  * ```typescript
+  * // Get details for e-invoice document type
+  * const invoiceType = await client.getDocumentType(1);
+  * if ('id' in invoiceType) {
+  *   console.log('Document type name:', invoiceType.name);
+  *   console.log('Available versions:', invoiceType.versionNumber);
+  *   console.log('Description:', invoiceType.description);
+  * }
+  *
+  * // Handle potential errors
+  * const documentType = await client.getDocumentType(999);
+  * if ('error' in documentType) {
+  *   console.error('Failed to retrieve document type:', documentType.error.message);
+  * }
+  * ```
+  *
+  * @remarks
+  * - Returns StandardError object if the document type ID doesn't exist
+  * - Document type information includes validation schemas and business rules
+  * - Use this method to discover supported document formats and versions
+  * - Essential for understanding submission requirements for different document types
+  */
+  getDocumentType(id: number): Promise<DocumentTypeResponse>;
+  /**
+  * Generates a shareable QR code URL for a specific document.
+  *
+  * This method retrieves the document details using its unique identifier,
+  * then constructs a URL that can be used to access or share the document
+  * via the MyInvois platform. The URL format differs between sandbox and
+  * production environments.
+  *
+  * @param documentUid - The unique identifier of the document
+  * @returns Promise resolving to a string containing the QR code URL
+  *
+  * @example
+  * ```typescript
+  * const qrCodeUrl = await client.getDocumentQrCode('abc123');
+  * console.log('Shareable QR code URL:', qrCodeUrl);
+  * // Output (sandbox): https://preprod.myinvois.hasil.gov.my/abc123/share/longId
+  * // Output (production): https://myinvois.hasil.gov.my/abc123/share/longId
+  * ```
+  *
+  * @remarks
+  * - The returned URL can be embedded in a QR code for document sharing.
+  * - The method fetches the document to obtain its longId, which is required for the URL.
+  * - Ensure the documentUid is valid and accessible by the current client.
+  */
+  getDocumentQrCode(documentUid: string, longId?: string): Promise<string | null>;
+  /**
+  * Retrieves detailed information about a specific version of a document type.
+  *
+  * This method fetches version-specific metadata, schema definitions, and validation rules
+  * for a particular document type version. Essential for understanding the exact format
+  * and requirements for document submission in a specific version.
+  *
+  * @param id - The unique identifier of the document type
+  * @param versionId - The unique identifier of the specific version to retrieve
+  * @returns Promise resolving to document type version response object or standard error
+  *
+  * @example
+  * ```typescript
+  * // Get specific version details for e-invoice
+  * const invoiceV1_1 = await client.getDocumentTypeVersion(1, 1);
+  * if ('id' in invoiceV1_1) {
+  *   console.log('Version number:', invoiceV1_1.versionNumber);
+  *   console.log('Schema:', invoiceV1_1.jsonSchema);
+  *   console.log('Status:', invoiceV1_1.status);
+  * }
+  *
+  * // Compare different versions
+  * const [v1_0, v1_1] = await Promise.all([
+  *   client.getDocumentTypeVersion(1, 0),
+  *   client.getDocumentTypeVersion(1, 1)
+  * ]);
+  *
+  * // Handle version not found
+  * const result = await client.getDocumentTypeVersion(1, 999);
+  * if ('error' in result) {
+  *   console.error('Version not found:', result.error.message);
+  * }
+  * ```
+  *
+  * @remarks
+  * - Returns StandardError object if document type ID or version ID doesn't exist
+  * - Version information includes JSON schema for validation
+  * - Different versions may have different validation rules and field requirements
+  * - Use this to ensure your documents conform to the specific version requirements
+  * - Version status indicates if the version is active, deprecated, or under development
+  */
+  getDocumentTypeVersion(id: number, versionId: number): Promise<DocumentTypeVersionResponse>;
+  // Static helper: create a client directly from a PKCS#12 (.p12) bundle
+  static fromP12(clientId: string, clientSecret: string, environment: "sandbox" | "production", p12Input: Buffer | string, passphrase: string, onBehalfOf?: string, debug?: boolean): MyInvoisClient;
+}
+//#endregion
+export { Address, AggregateByTaxCategoryOptions, AllDocumentsV1_1, Buyer, CanonicalizationMethod, Cert, CertDigest, Classification, ClassificationCode, ClassificationCodeEnum, ClientCredentials, CompleteInvoice, Country, CountryCode, CountryCodeEnum, CountryNameEnum, CreditNoteV1_1, Currency, CurrencyCode, CurrencyCodeEnum, DebitNoteV1_1, 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, RefundNoteV1_1, RegistrationType, ResponseDocument, SelfBilledCreditNoteV1_1, SelfBilledInvoiceV1_1, SelfBilledRefundNoteV1_1, 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, aggregateLineItemsByTaxCategory };
+//# sourceMappingURL=index.d.ts.map