@ripwords/myinvois-client 0.1.7 → 0.2.0

package/dist/index59.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index59.cts","names":[],"sources":["../src/index.d.ts"],"sourcesContent":["import { EInvoiceTypeCode } from './types';\nimport type { DocumentStatus, InvoiceV1_1, RegistrationType } from './types/documents';\nimport type { DocumentSummary, DocumentValidationResult, DocumentValidationStepResult, SubmissionResponse, SubmissionStatus } from './types/documents';\nexport declare class MyInvoisClient {\n    private readonly baseUrl;\n    private readonly clientId;\n    private readonly clientSecret;\n    private readonly onBehalfOf?;\n    private readonly signingCredentials;\n    private readonly debug;\n    private token;\n    private tokenExpiration;\n    constructor(clientId: string, clientSecret: string, environment: 'sandbox' | 'production', certificatePem: string, privateKeyPem: string, onBehalfOf?: string, debug?: boolean);\n    private refreshToken;\n    private getToken;\n    private fetch;\n    /**\n     * Validates a TIN against a NRIC/ARMY/PASSPORT/BRN (Business Registration Number)\n     *\n     * @param tin - The TIN to validate\n     * @param idType - The type of ID to validate against\n     * @param idValue - The value of the ID to validate against\n     * @returns true if the TIN is valid, false otherwise\n     */\n    verifyTin(tin: string, idType: RegistrationType, idValue: string): Promise<boolean>;\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    submitDocument(documents: InvoiceV1_1[]): Promise<{\n        data: SubmissionResponse;\n        status: number;\n    }>;\n    getSubmissionStatus(submissionUid: string, pollInterval?: number, maxRetries?: number): 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    /**\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    getDocument(documentUid: string): Promise<DocumentSummary & {\n        document: string;\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    getDocumentDetails(documentUid: string): Promise<DocumentSummary & {\n        validationResults: {\n            status: DocumentValidationResult;\n            validationSteps: DocumentValidationStepResult[];\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    searchDocuments({ uuid, submissionDateFrom, submissionDateTo, pageSize, pageNo, issueDateFrom, issueDateTo, invoiceDirection, status, documentType, searchQuery, }: {\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;\n    }): Promise<DocumentSummary[]>;\n}\nexport type * from './types/index.d.ts';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,IAAW,iBAAiB;CAAC;CAAK,MAAE;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;CAAA,MAAA;AAAA"}

package/dist/index6.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index6.cjs","names":[],"sources":["../src/types/e-invoice.d.ts"],"sourcesContent":["/**\n * Represents the allowed codes for e-Invoice types.\n * Based on the documentation: https://sdk.myinvois.hasil.gov.my/codes/e-invoice-types/\n */\nexport type EInvoiceTypeCode =\n  | '01' // Invoice\n  | '02' // Credit Note\n  | '03' // Debit Note\n  | '04' // Refund Note\n  | '11' // Self-billed Invoice\n  | '12' // Self-billed Credit Note\n  | '13' // Self-billed Debit Note\n  | '14' // Self-billed Refund Note\n\n/**\n * Interface representing an e-Invoice type entry.\n * Contains the code and its corresponding description.\n */\nexport interface EInvoiceType {\n  code: EInvoiceTypeCode\n  description: string\n}\n\n/**\n * Enum representing the allowed codes for e-Invoice types with descriptive names.\n * Provides a more readable way to reference e-Invoice types compared to using raw codes.\n *\n * @example\n * const invoiceCode = EInvoiceTypeCodeEnum.Invoice;\n * console.log(invoiceCode); // Output: \"01\"\n */\nexport enum EInvoiceTypeCodeEnum {\n  Invoice = '01',\n  CreditNote = '02',\n  DebitNote = '03',\n  RefundNote = '04',\n  SelfBilledInvoice = '11',\n  SelfBilledCreditNote = '12',\n  SelfBilledDebitNote = '13',\n  SelfBilledRefundNote = '14',\n}\n"],"mappings":";;;;;;;;;;AA+BA,IAAY,wEAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}

package/dist/platformLogin-PGzMhw1X.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"platformLogin-PGzMhw1X.cjs","names":["client: ClientCredentials","tokenResponse: TokenResponse"],"sources":["../src/api/platform/platformLogin.ts"],"sourcesContent":["import type { ClientCredentials, TokenResponse } from '../../types'\n\nexport const platformLogin = async (\n  client: ClientCredentials,\n): Promise<{\n  token: string\n  tokenExpiration: Date\n}> => {\n  const { clientId, clientSecret, baseUrl, onBehalfOf, debug } = client\n  try {\n    const response = await fetch(`${baseUrl}/connect/token`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/x-www-form-urlencoded',\n        ...(onBehalfOf ? { onbehalfof: onBehalfOf } : {}),\n      },\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n        client_id: clientId,\n        client_secret: clientSecret,\n        scope: 'InvoicingAPI',\n      }),\n    })\n\n    const tokenResponse: TokenResponse = await response.json()\n    return {\n      token: tokenResponse.access_token,\n      tokenExpiration: new Date(Date.now() + tokenResponse.expires_in * 1000),\n    }\n  } catch (error) {\n    if (debug) console.error(error)\n    throw error\n  }\n}\n"],"mappings":";;AAEA,MAAa,gBAAgB,OAC3BA,WAII;CACJ,MAAM,EAAE,UAAU,cAAc,SAAS,YAAY,OAAO,GAAG;AAC/D,KAAI;EACF,MAAM,WAAW,MAAM,OAAO,EAAE,QAAQ,iBAAiB;GACvD,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,GAAI,aAAa,EAAE,YAAY,WAAY,IAAG,CAAE;GACjD;GACD,MAAM,IAAI,gBAAgB;IACxB,YAAY;IACZ,WAAW;IACX,eAAe;IACf,OAAO;GACR;EACF,EAAC;EAEF,MAAMC,gBAA+B,MAAM,SAAS,MAAM;AAC1D,SAAO;GACL,OAAO,cAAc;GACrB,iBAAiB,IAAI,KAAK,KAAK,KAAK,GAAG,cAAc,aAAa;EACnE;CACF,SAAQ,OAAO;AACd,MAAI,MAAO,SAAQ,MAAM,MAAM;AAC/B,QAAM;CACP;AACF"}

package/dist/unit-types-B41YFOLT.d.ts

@@ -1,55 +0,0 @@
-import { UnitTypeCode_1X } from "./1X-BywXCqtn.js";
-import { UnitTypeCode_2X } from "./2X-3fSEGIuE.js";
-import { UnitTypeCode_3X } from "./3X-Ynjfgoll.js";
-import { UnitTypeCode_4X } from "./4X-B5ePdMky.js";
-import { UnitTypeCode_5X } from "./5X-dhP6fyou.js";
-import { UnitTypeCode_6X } from "./6X-BHaY0TCf.js";
-import { UnitTypeCode_7X } from "./7X-C4eX_tAk.js";
-import { UnitTypeCode_8X } from "./8X-D6HTLShY.js";
-import { UnitTypeCode_9X } from "./9X-CHZKsIdD.js";
-import { UnitTypeCode_AX } from "./AX-C0w_r3PA.js";
-import { UnitTypeCode_BX } from "./BX-RadlZ-6m.js";
-import { UnitTypeCode_CX } from "./CX-CT1Zzb9D.js";
-import { UnitTypeCode_DX } from "./DX-CtUeTKMM.js";
-import { UnitTypeCode_EX } from "./EX-084Yu7Wt.js";
-import { UnitTypeCode_FX } from "./FX-BrbQM0CW.js";
-import { UnitTypeCode_GX } from "./GX-gKj8iAAh.js";
-import { UnitTypeCode_HX } from "./HX-9D-ZXTy5.js";
-import { UnitTypeCode_IX } from "./IX-DR4Fc92A.js";
-import { UnitTypeCode_JX } from "./JX-DIKa9ma-.js";
-import { UnitTypeCode_KX } from "./KX-DpsJ_unT.js";
-import { UnitTypeCode_LX } from "./LX-DeXPPWUX.js";
-import { UnitTypeCode_MX } from "./MX-CKMjg_zK.js";
-import { UnitTypeCode_NX } from "./NX-oYdb4NDo.js";
-import { UnitTypeCode_OX } from "./OX-Bid9es3D.js";
-import { UnitTypeCode_PX } from "./PX-D7jy9CFk.js";
-import { UnitTypeCode_QX } from "./QX-BFWOR4g3.js";
-import { UnitTypeCode_RX } from "./RX-XHgCyMV1.js";
-import { UnitTypeCode_SX } from "./SX-Cl8RN8oH.js";
-import { UnitTypeCode_TX } from "./TX-ZymoIbtr.js";
-import { UnitTypeCode_UX } from "./UX-D-Ndd1ov.js";
-import { UnitTypeCode_VX } from "./VX-B-1b34r7.js";
-import { UnitTypeCode_WX } from "./WX-0GuMjPNZ.js";
-import { UnitTypeCode_YX } from "./YX-B51BbNSg.js";
-import { UnitTypeCode_ZX } from "./ZX-BMJS1iAv.js";
-import { UnitTypeCode_XX } from "./XX-CF2NANsy.js";
-
-//#region src/types/unit-types.d.ts
-
-/**
- * Represents the allowed codes for Unit of Measurement types.
- * Based on UN/ECE Recommendation 20, Revision 17 (2021) as per the documentation:
- * https://sdk.myinvois.hasil.gov.my/codes/unit-types/
- */
-type UnitTypeCode = UnitTypeCode_1X | UnitTypeCode_2X | UnitTypeCode_3X | UnitTypeCode_4X | UnitTypeCode_5X | UnitTypeCode_6X | UnitTypeCode_7X | UnitTypeCode_8X | UnitTypeCode_9X | UnitTypeCode_AX | UnitTypeCode_BX | UnitTypeCode_CX | UnitTypeCode_DX | UnitTypeCode_EX | UnitTypeCode_FX | UnitTypeCode_GX | UnitTypeCode_HX | UnitTypeCode_IX | UnitTypeCode_JX | UnitTypeCode_KX | UnitTypeCode_LX | UnitTypeCode_MX | UnitTypeCode_NX | UnitTypeCode_OX | UnitTypeCode_PX | UnitTypeCode_QX | UnitTypeCode_RX | UnitTypeCode_SX | UnitTypeCode_TX | UnitTypeCode_UX | UnitTypeCode_VX | UnitTypeCode_WX | UnitTypeCode_YX | UnitTypeCode_ZX | UnitTypeCode_XX;
-
-/**
- * Interface representing a Unit of Measurement entry.
- * Contains the code and its corresponding name.
- */
-interface UnitType {
-  code: UnitTypeCode;
-  name: string;
-}
-//#endregion
-export { UnitType, UnitTypeCode };

package/dist/utils/helpers.d.ts

@@ -1,271 +0,0 @@
-import { AdditionalDocumentReference, AllowanceCharge, CurrencyExchangeRate, Delivery, InvoiceV1_1, PaymentMeans } from "../types/documents/index.js";
-
-//#region src/utils/helpers.d.ts
-
-/**
-* MyInvois Invoice Helper Functions
-*
-* Provides convenient utilities for common invoice scenarios and business patterns.
-* These helpers simplify the creation of compliant MyInvois documents.
-*/
-/**
-* Payment Method Helpers
-*/
-declare const PaymentHelpers: {
-  /**
-  * Creates cash payment means
-  */
-  cash(): PaymentMeans;
-  /**
-  * Creates cheque payment means
-  */
-  cheque(accountId?: string): PaymentMeans;
-  /**
-  * Creates bank transfer payment means
-  */
-  bankTransfer(accountId: string, dueDate?: string): PaymentMeans;
-  /**
-  * Creates credit card payment means
-  */
-  creditCard(): PaymentMeans;
-  /**
-  * Creates e-wallet payment means
-  */
-  eWallet(accountId?: string): PaymentMeans;
-  /**
-  * Creates custom payment terms with specific due date
-  */
-  net(days: number, accountId?: string): PaymentMeans;
-};
-/**
-* Currency and Exchange Rate Helpers
-*/
-declare const CurrencyHelpers: {
-  /**
-  * Creates domestic MYR transaction (no exchange rate needed)
-  */
-  domestic(): CurrencyExchangeRate;
-  /**
-  * Creates international transaction with exchange rate
-  */
-  international(fromCurrency: string, toCurrency: string | undefined, exchangeRate: number, rateDate?: string): CurrencyExchangeRate;
-  /**
-  * Common exchange rates (these should be updated with real-time rates)
-  */
-  commonRates: {
-    USD_MYR: number;
-    SGD_MYR: number;
-    EUR_MYR: number;
-    GBP_MYR: number;
-    JPY_MYR: number;
-    AUD_MYR: number;
-  };
-};
-/**
-* Tax Calculation Helpers
-*/
-declare const TaxHelpers: {
-  /**
-  * Calculates SST (6%) for goods
-  */
-  calculateSST(amount: number, rate?: number): {
-    taxAmount: number;
-    totalWithTax: number;
-  };
-  /**
-  * Calculates Service Tax for services
-  */
-  calculateServiceTax(amount: number, rate?: number): {
-    taxAmount: number;
-    totalWithTax: number;
-  };
-  /**
-  * Zero-rated calculation (0% tax)
-  */
-  zeroRated(amount: number): {
-    taxAmount: number;
-    totalWithTax: number;
-  };
-  /**
-  * Exempt calculation (no tax)
-  */
-  exempt(amount: number): {
-    taxAmount: number;
-    totalWithTax: number;
-  };
-};
-/**
-* Allowance and Charge Helpers
-*/
-declare const AllowanceChargeHelpers: {
-  /**
-  * Creates a discount allowance
-  */
-  discount(reason: string, amount: number, percentage?: number): AllowanceCharge;
-  /**
-  * Creates a shipping charge
-  */
-  shipping(amount: number, description?: string): AllowanceCharge;
-  /**
-  * Creates an early payment discount
-  */
-  earlyPaymentDiscount(percentage: number, baseAmount: number): AllowanceCharge;
-  /**
-  * Creates a handling fee charge
-  */
-  handlingFee(amount: number): AllowanceCharge;
-};
-/**
-* Delivery Helpers
-*/
-declare const DeliveryHelpers: {
-  /**
-  * Creates standard delivery information
-  */
-  standard(deliveryDate: string, address: {
-    addressLine0: string;
-    cityName: string;
-    postalZone?: string;
-    state: string;
-    country?: string;
-  }): Delivery;
-  /**
-  * Creates pickup delivery (customer pickup)
-  */
-  pickup(pickupDate: string): Delivery;
-  /**
-  * Creates delivery with freight charges
-  */
-  withFreight(deliveryDate: string, address: any, freightAmount: number, freightDescription?: string): Delivery;
-};
-/**
-* Document Reference Helpers
-*/
-declare const DocumentReferenceHelpers: {
-  /**
-  * Creates purchase order reference
-  */
-  purchaseOrder(poNumber: string): {
-    purchaseOrderReference: string;
-  };
-  /**
-  * Creates contract reference
-  */
-  contract(contractNumber: string): {
-    contractReference: string;
-  };
-  /**
-  * Creates project reference
-  */
-  project(projectNumber: string): {
-    projectReference: string;
-  };
-  /**
-  * Creates billing reference
-  */
-  billing(billingNumber: string): {
-    billingReference: string;
-  };
-  /**
-  * Creates customs reference
-  */
-  customs(customsFormNumber: string): AdditionalDocumentReference;
-  /**
-  * Creates free trade agreement reference
-  */
-  freeTradeAgreement(ftaNumber: string, country: string): AdditionalDocumentReference;
-};
-/**
-* Industry Classification Helpers
-*/
-declare const IndustryHelpers: {
-  /**
-  * Common industry classifications with proper codes and descriptions
-  */
-  trading: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  manufacturing: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  software: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  consulting: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  restaurant: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  construction: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  logistics: {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-  /**
-  * Creates custom industry classification
-  */
-  custom(code: string, description: string): {
-    industryClassificationCode: string;
-    industryClassificationDescription: string;
-  };
-};
-/**
-* Date and Time Helpers
-*/
-declare const DateTimeHelpers: {
-  /**
-  * Gets current date in MyInvois format (YYYY-MM-DD)
-  */
-  currentDate(): string;
-  /**
-  * Gets current time in MyInvois format (HH:mm:ssZ)
-  */
-  currentTime(): string;
-  /**
-  * Formats date to MyInvois format
-  */
-  formatDate(date: Date): string;
-  /**
-  * Formats time to MyInvois format
-  */
-  formatTime(date: Date): string;
-  /**
-  * Adds days to a date
-  */
-  addDays(date: Date, days: number): Date;
-  /**
-  * Gets billing period for monthly billing
-  */
-  monthlyPeriod(year: number, month: number): {
-    start: string;
-    end: string;
-  };
-};
-/**
-* Complete Invoice Builder Helper
-*/
-declare const InvoiceBuilder: {
-  /**
-  * Creates a basic cash invoice template
-  */
-  basicCash(invoiceNumber: string): Partial<InvoiceV1_1>;
-  /**
-  * Creates a business invoice template with bank transfer
-  */
-  businessInvoice(invoiceNumber: string, accountId: string, netDays?: number): Partial<InvoiceV1_1>;
-  /**
-  * Creates an international invoice template
-  */
-  international(invoiceNumber: string, currency: string, exchangeRate: number): Partial<InvoiceV1_1>;
-};
-//#endregion
-export { AllowanceChargeHelpers, CurrencyHelpers, DateTimeHelpers, DeliveryHelpers, DocumentReferenceHelpers, IndustryHelpers, InvoiceBuilder, PaymentHelpers, TaxHelpers };

package/dist/utils/helpers.js

@@ -1,330 +0,0 @@
-//#region src/utils/helpers.ts
-/**
-* MyInvois Invoice Helper Functions
-*
-* Provides convenient utilities for common invoice scenarios and business patterns.
-* These helpers simplify the creation of compliant MyInvois documents.
-*/
-/**
-* Payment Method Helpers
-*/
-const PaymentHelpers = {
-	cash() {
-		return {
-			paymentMeansCode: "01",
-			paymentTerms: "Cash payment"
-		};
-	},
-	cheque(accountId) {
-		return {
-			paymentMeansCode: "02",
-			payeeFinancialAccountID: accountId,
-			paymentTerms: "Cheque payment"
-		};
-	},
-	bankTransfer(accountId, dueDate) {
-		return {
-			paymentMeansCode: "03",
-			payeeFinancialAccountID: accountId,
-			paymentDueDate: dueDate,
-			paymentTerms: "Bank transfer"
-		};
-	},
-	creditCard() {
-		return {
-			paymentMeansCode: "04",
-			paymentTerms: "Credit card payment"
-		};
-	},
-	eWallet(accountId) {
-		return {
-			paymentMeansCode: "05",
-			payeeFinancialAccountID: accountId,
-			paymentTerms: "E-wallet payment"
-		};
-	},
-	net(days, accountId) {
-		const dueDate = /* @__PURE__ */ new Date();
-		dueDate.setDate(dueDate.getDate() + days);
-		return {
-			paymentMeansCode: "03",
-			payeeFinancialAccountID: accountId,
-			paymentDueDate: dueDate.toISOString().split("T")[0],
-			paymentTerms: `Net ${days} days`
-		};
-	}
-};
-/**
-* Currency and Exchange Rate Helpers
-*/
-const CurrencyHelpers = {
-	domestic() {
-		return {
-			sourceCurrencyCode: "MYR",
-			targetCurrencyCode: "MYR",
-			calculationRate: 1
-		};
-	},
-	international(fromCurrency, toCurrency = "MYR", exchangeRate, rateDate) {
-		return {
-			sourceCurrencyCode: fromCurrency,
-			targetCurrencyCode: toCurrency,
-			calculationRate: exchangeRate,
-			exchangeRateDate: rateDate || (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
-		};
-	},
-	commonRates: {
-		USD_MYR: 4.75,
-		SGD_MYR: 3.45,
-		EUR_MYR: 5.1,
-		GBP_MYR: 5.85,
-		JPY_MYR: .032,
-		AUD_MYR: 3.12
-	}
-};
-/**
-* Tax Calculation Helpers
-*/
-const TaxHelpers = {
-	calculateSST(amount, rate = 6) {
-		const taxAmount = amount * rate / 100;
-		return {
-			taxAmount: Math.round(taxAmount * 100) / 100,
-			totalWithTax: Math.round((amount + taxAmount) * 100) / 100
-		};
-	},
-	calculateServiceTax(amount, rate = 6) {
-		return TaxHelpers.calculateSST(amount, rate);
-	},
-	zeroRated(amount) {
-		return {
-			taxAmount: 0,
-			totalWithTax: amount
-		};
-	},
-	exempt(amount) {
-		return {
-			taxAmount: 0,
-			totalWithTax: amount
-		};
-	}
-};
-/**
-* Allowance and Charge Helpers
-*/
-const AllowanceChargeHelpers = {
-	discount(reason, amount, percentage) {
-		return {
-			chargeIndicator: false,
-			reason,
-			amount,
-			multiplierFactorNumeric: percentage ? percentage / 100 : void 0
-		};
-	},
-	shipping(amount, description = "Shipping and handling") {
-		return {
-			chargeIndicator: true,
-			reason: description,
-			amount
-		};
-	},
-	earlyPaymentDiscount(percentage, baseAmount) {
-		const discountAmount = baseAmount * percentage / 100;
-		return {
-			chargeIndicator: false,
-			reason: `Early payment discount ${percentage}%`,
-			amount: Math.round(discountAmount * 100) / 100,
-			multiplierFactorNumeric: percentage / 100,
-			baseAmount
-		};
-	},
-	handlingFee(amount) {
-		return {
-			chargeIndicator: true,
-			reason: "Handling fee",
-			amount
-		};
-	}
-};
-/**
-* Delivery Helpers
-*/
-const DeliveryHelpers = {
-	standard(deliveryDate, address) {
-		return {
-			actualDeliveryDate: deliveryDate,
-			deliveryLocation: {
-				...address,
-				country: address.country || "MYS"
-			}
-		};
-	},
-	pickup(pickupDate) {
-		return {
-			actualDeliveryDate: pickupDate,
-			deliveryLocation: {
-				addressLine0: "Customer pickup",
-				cityName: "N/A",
-				state: "N/A",
-				country: "MYS"
-			}
-		};
-	},
-	withFreight(deliveryDate, address, freightAmount, freightDescription = "Freight charges") {
-		return {
-			actualDeliveryDate: deliveryDate,
-			deliveryLocation: address,
-			shipment: {
-				id: `SHIP-${Date.now()}`,
-				freightAllowanceCharge: {
-					chargeIndicator: true,
-					reason: freightDescription,
-					amount: freightAmount
-				}
-			}
-		};
-	}
-};
-/**
-* Document Reference Helpers
-*/
-const DocumentReferenceHelpers = {
-	purchaseOrder(poNumber) {
-		return { purchaseOrderReference: poNumber };
-	},
-	contract(contractNumber) {
-		return { contractReference: contractNumber };
-	},
-	project(projectNumber) {
-		return { projectReference: projectNumber };
-	},
-	billing(billingNumber) {
-		return { billingReference: billingNumber };
-	},
-	customs(customsFormNumber) {
-		return {
-			id: customsFormNumber,
-			documentType: "CustomsImportForm",
-			documentDescription: "Customs import declaration"
-		};
-	},
-	freeTradeAgreement(ftaNumber, country) {
-		return {
-			id: ftaNumber,
-			documentType: "FreeTradeAgreement",
-			documentDescription: `Free trade agreement with ${country}`
-		};
-	}
-};
-/**
-* Industry Classification Helpers
-*/
-const IndustryHelpers = {
-	trading: {
-		industryClassificationCode: "47900",
-		industryClassificationDescription: "Retail sale via mail order houses or via Internet"
-	},
-	manufacturing: {
-		industryClassificationCode: "10131",
-		industryClassificationDescription: "Processing and preserving of meat"
-	},
-	software: {
-		industryClassificationCode: "62012",
-		industryClassificationDescription: "Business and domestic software development"
-	},
-	consulting: {
-		industryClassificationCode: "70200",
-		industryClassificationDescription: "Management consultancy activities"
-	},
-	restaurant: {
-		industryClassificationCode: "56101",
-		industryClassificationDescription: "Restaurants"
-	},
-	construction: {
-		industryClassificationCode: "41000",
-		industryClassificationDescription: "Development of building projects"
-	},
-	logistics: {
-		industryClassificationCode: "49301",
-		industryClassificationDescription: "Land freight transport"
-	},
-	custom(code, description) {
-		return {
-			industryClassificationCode: code,
-			industryClassificationDescription: description
-		};
-	}
-};
-/**
-* Date and Time Helpers
-*/
-const DateTimeHelpers = {
-	currentDate() {
-		return (/* @__PURE__ */ new Date()).toISOString().split("T")[0] || "";
-	},
-	currentTime() {
-		return (/* @__PURE__ */ new Date()).toISOString().split("T")[1]?.split(".")[0] + "Z" || "";
-	},
-	formatDate(date) {
-		return date.toISOString().split("T")[0] || "";
-	},
-	formatTime(date) {
-		return date.toISOString().split("T")[1]?.split(".")[0] + "Z" || "";
-	},
-	addDays(date, days) {
-		const result = new Date(date);
-		result.setDate(result.getDate() + days);
-		return result;
-	},
-	monthlyPeriod(year, month) {
-		const start = new Date(Date.UTC(year, month - 1, 1));
-		const end = new Date(Date.UTC(year, month, 0));
-		return {
-			start: DateTimeHelpers.formatDate(start),
-			end: DateTimeHelpers.formatDate(end)
-		};
-	}
-};
-/**
-* Complete Invoice Builder Helper
-*/
-const InvoiceBuilder = {
-	basicCash(invoiceNumber) {
-		return {
-			eInvoiceCodeOrNumber: invoiceNumber,
-			eInvoiceDate: DateTimeHelpers.currentDate(),
-			eInvoiceTime: DateTimeHelpers.currentTime(),
-			eInvoiceTypeCode: "01",
-			eInvoiceVersion: "1.1",
-			invoiceCurrencyCode: "MYR",
-			paymentMeans: [PaymentHelpers.cash()]
-		};
-	},
-	businessInvoice(invoiceNumber, accountId, netDays = 30) {
-		return {
-			eInvoiceCodeOrNumber: invoiceNumber,
-			eInvoiceDate: DateTimeHelpers.currentDate(),
-			eInvoiceTime: DateTimeHelpers.currentTime(),
-			eInvoiceTypeCode: "01",
-			eInvoiceVersion: "1.1",
-			invoiceCurrencyCode: "MYR",
-			paymentMeans: [PaymentHelpers.net(netDays, accountId)]
-		};
-	},
-	international(invoiceNumber, currency, exchangeRate) {
-		return {
-			eInvoiceCodeOrNumber: invoiceNumber,
-			eInvoiceDate: DateTimeHelpers.currentDate(),
-			eInvoiceTime: DateTimeHelpers.currentTime(),
-			eInvoiceTypeCode: "01",
-			eInvoiceVersion: "1.1",
-			invoiceCurrencyCode: currency,
-			currencyExchangeRate: exchangeRate,
-			taxExchangeRate: CurrencyHelpers.international(currency, "MYR", exchangeRate),
-			paymentMeans: [PaymentHelpers.bankTransfer("")]
-		};
-	}
-};
-
-//#endregion
-export { AllowanceChargeHelpers, CurrencyHelpers, DateTimeHelpers, DeliveryHelpers, DocumentReferenceHelpers, IndustryHelpers, InvoiceBuilder, PaymentHelpers, TaxHelpers };