@ripwords/myinvois-client 0.1.7 → 0.2.1

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 };