@ripwords/myinvois-client 0.1.4 → 0.1.5

package/dist/utils/helpers.js

@@ -0,0 +1,330 @@
+//#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 };

package/dist/utils/signature-diagnostics.d.ts

@@ -0,0 +1,93 @@
+import "../classification-codes-BKxV-rO9.js";
+import "../country-code-CQuaiQm2.js";
+import "../currencies-BYJK-m6v.js";
+import "../e-invoice-CmbLQkHw.js";
+import "../0X-CTIq3y3a.js";
+import "../1X-Bu4oiv8D.js";
+import "../2X-DnG3FY1f.js";
+import "../3X-CLdmoel1.js";
+import "../4X-BTG6o1Gn.js";
+import "../5X-CjSz1zxJ.js";
+import "../6X-B9KP_vEn.js";
+import "../7X-DtkQutx2.js";
+import "../8X-5n9seY3z.js";
+import "../9X-Cpb6V4JC.js";
+import "../msic-codes-C8PJVOaA.js";
+import "../signatures-W-_brwdb.js";
+import "../tax-types-CsQ76JMf.js";
+import { InvoiceV1_1 } from "../documents-i5EV868Y.js";
+import "../payment-modes-BOTSRC_X.js";
+import "../1X-BywXCqtn.js";
+import "../2X-3fSEGIuE.js";
+import "../3X-Ynjfgoll.js";
+import "../4X-B5ePdMky.js";
+import "../5X-dhP6fyou.js";
+import "../6X-BHaY0TCf.js";
+import "../7X-C4eX_tAk.js";
+import "../8X-D6HTLShY.js";
+import "../9X-CHZKsIdD.js";
+import "../AX-C0w_r3PA.js";
+import "../BX-RadlZ-6m.js";
+import "../CX-CT1Zzb9D.js";
+import "../DX-CtUeTKMM.js";
+import "../EX-084Yu7Wt.js";
+import "../FX-BrbQM0CW.js";
+import "../GX-gKj8iAAh.js";
+import "../HX-9D-ZXTy5.js";
+import "../IX-DR4Fc92A.js";
+import "../JX-DIKa9ma-.js";
+import "../KX-DpsJ_unT.js";
+import "../LX-DeXPPWUX.js";
+import "../MX-CKMjg_zK.js";
+import "../NX-oYdb4NDo.js";
+import "../OX-Bid9es3D.js";
+import "../PX-D7jy9CFk.js";
+import "../QX-BFWOR4g3.js";
+import "../RX-XHgCyMV1.js";
+import "../SX-Cl8RN8oH.js";
+import "../TX-ZymoIbtr.js";
+import "../UX-D-Ndd1ov.js";
+import "../VX-B-1b34r7.js";
+import "../WX-0GuMjPNZ.js";
+import "../YX-B51BbNSg.js";
+import "../ZX-BMJS1iAv.js";
+import "../XX-CF2NANsy.js";
+import "../unit-types-B41YFOLT.js";
+import "../state-codes-oeFKlwXZ.js";
+import "../index-0-EvC6Nv.js";
+
+//#region src/utils/signature-diagnostics.d.ts
+interface CertificateAnalysisResult {
+  organizationIdentifier?: string;
+  serialNumber?: string;
+  issuerName: string;
+  subjectName: string;
+  issues: string[];
+  recommendations: string[];
+}
+interface SignatureAnalysisResult {
+  documentDigest: string;
+  certificateDigest: string;
+  signedPropertiesDigest: string;
+  issues: string[];
+  recommendations: string[];
+}
+interface DiagnosticResult {
+  certificateAnalysis: CertificateAnalysisResult;
+  signatureAnalysis: SignatureAnalysisResult;
+  summary: {
+    totalIssues: number;
+    certificateIssues: number;
+    signatureIssues: number;
+  };
+}
+/**
+* Comprehensive signature diagnostics
+*/
+declare function diagnoseSignatureIssues(invoices: InvoiceV1_1[], certificatePem: string): DiagnosticResult;
+/**
+* Prints diagnostic results in a formatted way
+*/
+declare function printDiagnostics(result: DiagnosticResult): void;
+//#endregion
+export { CertificateAnalysisResult, DiagnosticResult, SignatureAnalysisResult, diagnoseSignatureIssues, printDiagnostics };