@ripwords/myinvois-client 0.1.0 → 0.1.2

package/dist/index18.cjs

@@ -1,208 +1,340 @@
 
-//#region src/types/msic/0X.d.ts
-let MSIC_0X = /* @__PURE__ */ function(MSIC_0X$1) {
-	MSIC_0X$1["NOT_APPLICABLE"] = "00000";
-	MSIC_0X$1["GROWING_OF_MAIZE"] = "01111";
-	MSIC_0X$1["GROWING_OF_LEGUMINOUS_CROPS"] = "01112";
-	MSIC_0X$1["GROWING_OF_OIL_SEEDS"] = "01113";
-	MSIC_0X$1["GROWING_OF_OTHER_CEREALS"] = "01119";
-	MSIC_0X$1["GROWING_OF_PADDY"] = "01120";
-	MSIC_0X$1["GROWING_OF_LEAFY_OR_STEM_VEGETABLES"] = "01131";
-	MSIC_0X$1["GROWING_OF_FRUITS_BEARING_VEGETABLES"] = "01132";
-	MSIC_0X$1["GROWING_OF_MELONS"] = "01133";
-	MSIC_0X$1["GROWING_OF_MUSHROOMS_AND_TRUFFLES"] = "01134";
-	MSIC_0X$1["GROWING_OF_VEGETABLES_SEEDS"] = "01135";
-	MSIC_0X$1["GROWING_OF_OTHER_VEGETABLES"] = "01136";
-	MSIC_0X$1["GROWING_OF_SUGAR_BEET"] = "01137";
-	MSIC_0X$1["GROWING_OF_ROOTS_TUBERS"] = "01138";
-	MSIC_0X$1["GROWING_OF_SUGAR_CANE"] = "01140";
-	MSIC_0X$1["GROWING_OF_TOBACCO"] = "01150";
-	MSIC_0X$1["GROWING_OF_FIBRE_CROPS"] = "01160";
-	MSIC_0X$1["GROWING_OF_FLOWERS"] = "01191";
-	MSIC_0X$1["GROWING_OF_FLOWER_SEEDS"] = "01192";
-	MSIC_0X$1["GROWING_OF_SAGO"] = "01193";
-	MSIC_0X$1["GROWING_OF_OTHER_NON_PERENNIAL_CROPS"] = "01199";
-	MSIC_0X$1["GROWING_OF_GRAPES"] = "01210";
-	MSIC_0X$1["GROWING_OF_BANANA"] = "01221";
-	MSIC_0X$1["GROWING_OF_MANGO"] = "01222";
-	MSIC_0X$1["GROWING_OF_DURIAN"] = "01223";
-	MSIC_0X$1["GROWING_OF_RAMBUTAN"] = "01224";
-	MSIC_0X$1["GROWING_OF_STAR_FRUIT"] = "01225";
-	MSIC_0X$1["GROWING_OF_PAPAYA"] = "01226";
-	MSIC_0X$1["GROWING_OF_PINEAPPLE"] = "01227";
-	MSIC_0X$1["GROWING_OF_PITAYA"] = "01228";
-	MSIC_0X$1["GROWING_OF_OTHER_TROPICAL_FRUITS"] = "01229";
-	MSIC_0X$1["GROWING_OF_POMELO"] = "01231";
-	MSIC_0X$1["GROWING_OF_LEMON_AND_LIMES"] = "01232";
-	MSIC_0X$1["GROWING_OF_TANGERINES_AND_MANDARIN"] = "01233";
-	MSIC_0X$1["GROWING_OF_OTHER_CITRUS_FRUITS"] = "01239";
-	MSIC_0X$1["GROWING_OF_GUAVA"] = "01241";
-	MSIC_0X$1["GROWING_OF_OTHER_POME_FRUITS"] = "01249";
-	MSIC_0X$1["GROWING_OF_BERRIES"] = "01251";
-	MSIC_0X$1["GROWING_OF_FRUIT_SEEDS"] = "01252";
-	MSIC_0X$1["GROWING_OF_EDIBLE_NUTS"] = "01253";
-	MSIC_0X$1["GROWING_OF_OTHER_TREE_AND_BUSH_FRUITS"] = "01259";
-	MSIC_0X$1["GROWING_OF_OIL_PALM_ESTATE"] = "01261";
-	MSIC_0X$1["GROWING_OF_OIL_PALM_SMALLHOLDINGS"] = "01262";
-	MSIC_0X$1["GROWING_OF_COCONUT"] = "01263";
-	MSIC_0X$1["GROWING_OF_OTHER_OLEAGINOUS_FRUITS"] = "01269";
-	MSIC_0X$1["GROWING_OF_COFFEE"] = "01271";
-	MSIC_0X$1["GROWING_OF_TEA"] = "01272";
-	MSIC_0X$1["GROWING_OF_COCOA"] = "01273";
-	MSIC_0X$1["GROWING_OF_OTHER_BEVERAGE_CROPS"] = "01279";
-	MSIC_0X$1["GROWING_OF_PEPPER"] = "01281";
-	MSIC_0X$1["GROWING_OF_CHILIES"] = "01282";
-	MSIC_0X$1["GROWING_OF_NUTMEG"] = "01283";
-	MSIC_0X$1["GROWING_OF_GINGER"] = "01284";
-	MSIC_0X$1["GROWING_OF_PLANTS_FOR_PHARMACY"] = "01285";
-	MSIC_0X$1["GROWING_OF_OTHER_SPICES"] = "01289";
-	MSIC_0X$1["GROWING_OF_RUBBER_TREES_ESTATE"] = "01291";
-	MSIC_0X$1["GROWING_OF_RUBBER_TREES_SMALLHOLDINGS"] = "01292";
-	MSIC_0X$1["GROWING_OF_TREES_FOR_SAP"] = "01293";
-	MSIC_0X$1["GROWING_OF_NIPA_PALM"] = "01294";
-	MSIC_0X$1["GROWING_OF_ARECA"] = "01295";
-	MSIC_0X$1["GROWING_OF_ROSELLE"] = "01296";
-	MSIC_0X$1["GROWING_OF_OTHER_PERENNIAL_CROPS"] = "01299";
-	MSIC_0X$1["GROWING_OF_PLANTS_FOR_PLANTING"] = "01301";
-	MSIC_0X$1["GROWING_OF_PLANTS_FOR_ORNAMENTAL"] = "01302";
-	MSIC_0X$1["GROWING_OF_LIVE_PLANTS"] = "01303";
-	MSIC_0X$1["OPERATION_OF_TREE_NURSERIES"] = "01304";
-	MSIC_0X$1["RAISING_CATTLE_OR_BUFFALOES"] = "01411";
-	MSIC_0X$1["PRODUCTION_OF_RAW_MILK"] = "01412";
-	MSIC_0X$1["PRODUCTION_OF_BOVINE_SEMEN"] = "01413";
-	MSIC_0X$1["RAISING_OF_HORSES"] = "01420";
-	MSIC_0X$1["RAISING_OF_CAMELS"] = "01430";
-	MSIC_0X$1["RAISING_OF_SHEEP_AND_GOATS"] = "01441";
-	MSIC_0X$1["PRODUCTION_OF_SHEEP_MILK"] = "01442";
-	MSIC_0X$1["PRODUCTION_OF_RAW_WOOL"] = "01443";
-	MSIC_0X$1["RAISING_OF_SWINE"] = "01450";
-	MSIC_0X$1["RAISING_OF_CHICKEN"] = "01461";
-	MSIC_0X$1["RAISING_OF_DUCKS"] = "01462";
-	MSIC_0X$1["RAISING_OF_GEESE"] = "01463";
-	MSIC_0X$1["RAISING_OF_QUAILS"] = "01464";
-	MSIC_0X$1["RAISING_OF_OTHER_POULTRY"] = "01465";
-	MSIC_0X$1["PRODUCTION_OF_CHICKEN_EGGS"] = "01466";
-	MSIC_0X$1["PRODUCTION_OF_DUCK_EGGS"] = "01467";
-	MSIC_0X$1["PRODUCTION_OF_OTHER_POULTRY_EGGS"] = "01468";
-	MSIC_0X$1["OPERATION_OF_POULTRY_HATCHERIES"] = "01469";
-	MSIC_0X$1["RAISING_OF_SEMI_DOMESTICATED"] = "01491";
-	MSIC_0X$1["PRODUCTION_OF_FUR_SKINS"] = "01492";
-	MSIC_0X$1["OPERATION_OF_WORM_FARMS"] = "01493";
-	MSIC_0X$1["RAISING_OF_SILK_WORMS"] = "01494";
-	MSIC_0X$1["BEE_KEEPING"] = "01495";
-	MSIC_0X$1["RAISING_OF_PET_ANIMALS"] = "01496";
-	MSIC_0X$1["RAISING_OF_SWIFLET"] = "01497";
-	MSIC_0X$1["RAISING_OF_DIVERSE_ANIMALS"] = "01499";
-	MSIC_0X$1["MIXED_FARMING"] = "01500";
-	MSIC_0X$1["AGRICULTURAL_ACTIVITIES_FOR_CROPS"] = "01610";
-	MSIC_0X$1["AGRICULTURAL_ACTIVITIES_FOR_ANIMALS"] = "01620";
-	MSIC_0X$1["PREPARATION_OF_CROPS"] = "01631";
-	MSIC_0X$1["PREPARATION_OF_TOBACCO_LEAVES"] = "01632";
-	MSIC_0X$1["PREPARATION_OF_COCOA_BEANS"] = "01633";
-	MSIC_0X$1["SUN_DRYING_OF_FRUITS"] = "01634";
-	MSIC_0X$1["SEED_PROCESSING"] = "01640";
-	MSIC_0X$1["HUNTING_AND_TRAPPING"] = "01701";
-	MSIC_0X$1["TAKING_OF_ANIMALS"] = "01702";
-	MSIC_0X$1["PLANTING_OF_FORESTS"] = "02101";
-	MSIC_0X$1["GROWING_OF_COPPICE"] = "02102";
-	MSIC_0X$1["OPERATION_OF_FOREST_NURSERIES"] = "02103";
-	MSIC_0X$1["COLLECTION_OF_WILDINGS"] = "02104";
-	MSIC_0X$1["FOREST_PLANTATION"] = "02105";
-	MSIC_0X$1["PRODUCTION_OF_ROUND_WOOD"] = "02201";
-	MSIC_0X$1["PRODUCTION_OF_UNPROCESSED_WOOD"] = "02202";
-	MSIC_0X$1["PRODUCTION_OF_CHARCOAL"] = "02203";
-	MSIC_0X$1["RUBBER_WOOD_LOGGING"] = "02204";
-	MSIC_0X$1["COLLECTION_OF_RATTAN"] = "02301";
-	MSIC_0X$1["BIRDS_NEST_COLLECTION"] = "02302";
-	MSIC_0X$1["WILD_SAGO_PALM_COLLECTION"] = "02303";
-	MSIC_0X$1["GATHERING_OF_NON_WOOD_FOREST"] = "02309";
-	MSIC_0X$1["FORESTRY_SERVICE_ACTIVITIES"] = "02401";
-	MSIC_0X$1["LOGGING_SERVICE_ACTIVITIES"] = "02402";
-	MSIC_0X$1["COMMERCIAL_OCEAN_FISHING"] = "03111";
-	MSIC_0X$1["COLLECTION_OF_MARINE_CRUSTACEANS"] = "03112";
-	MSIC_0X$1["TAKING_OF_AQUATIC_ANIMALS"] = "03113";
-	MSIC_0X$1["VESSELS_FOR_FISHING"] = "03114";
-	MSIC_0X$1["GATHERING_OF_MARINE_ORGANISMS"] = "03115";
-	MSIC_0X$1["MARINE_FISHING"] = "03119";
-	MSIC_0X$1["COMMERCIAL_INLAND_FISHING"] = "03121";
-	MSIC_0X$1["TAKING_OF_FRESHWATER_CRUSTACEANS"] = "03122";
-	MSIC_0X$1["TAKING_OF_FRESHWATER_ANIMALS"] = "03123";
-	MSIC_0X$1["GATHERING_OF_FRESHWATER_FLORA"] = "03124";
-	MSIC_0X$1["FRESHWATER_FISHING"] = "03129";
-	MSIC_0X$1["FISH_FARMING_SEA_WATER"] = "03211";
-	MSIC_0X$1["PRODUCTION_OF_BIVALVE_SPAT"] = "03212";
-	MSIC_0X$1["GROWING_OF_SEAWEEDS"] = "03213";
-	MSIC_0X$1["CULTURE_OF_CRUSTACEANS"] = "03214";
-	MSIC_0X$1["AQUACULTURE_IN_BRACKISH"] = "03215";
-	MSIC_0X$1["AQUACULTURE_IN_SALT_WATER"] = "03216";
-	MSIC_0X$1["OPERATION_OF_MARINE_HATCHERIES"] = "03217";
-	MSIC_0X$1["OPERATION_OF_MARINE_WORM_FARMS"] = "03218";
-	MSIC_0X$1["MARINE_AQUACULTURE"] = "03219";
-	MSIC_0X$1["FISH_FARMING_FRESHWATER"] = "03221";
-	MSIC_0X$1["SHRIMP_FARMING_FRESHWATER"] = "03222";
-	MSIC_0X$1["CULTURE_OF_FRESHWATER_CRUSTACEANS"] = "03223";
-	MSIC_0X$1["OPERATION_OF_FRESHWATER_HATCHERIES"] = "03224";
-	MSIC_0X$1["FARMING_OF_FROGS"] = "03225";
-	MSIC_0X$1["FRESHWATER_AQUACULTURE"] = "03229";
-	MSIC_0X$1["MINING_OF_HARD_COAL"] = "05100";
-	MSIC_0X$1["MINING_OF_LIGNITE"] = "05200";
-	MSIC_0X$1["EXTRACTION_OF_CRUDE_PETROLEUM"] = "06101";
-	MSIC_0X$1["EXTRACTION_OF_BITUMINOUS"] = "06102";
-	MSIC_0X$1["PRODUCTION_OF_CRUDE_PETROLEUM"] = "06103";
-	MSIC_0X$1["PROCESSES_TO_OBTAIN_CRUDE_OILS"] = "06104";
-	MSIC_0X$1["PRODUCTION_OF_NATURAL_GAS"] = "06201";
-	MSIC_0X$1["EXTRACTION_OF_CONDENSATES"] = "06202";
-	MSIC_0X$1["DRAINING_OF_HYDROCARBON"] = "06203";
-	MSIC_0X$1["GAS_DESULPHURIZATION"] = "06204";
-	MSIC_0X$1["MINING_OF_HYDROCARBON_LIQUIDS"] = "06205";
-	MSIC_0X$1["MINING_OF_IRON_ORES"] = "07101";
-	MSIC_0X$1["BENEFICIATION_OF_IRON_ORES"] = "07102";
-	MSIC_0X$1["MINING_OF_URANIUM"] = "07210";
-	MSIC_0X$1["MINING_OF_TIN"] = "07291";
-	MSIC_0X$1["MINING_OF_COPPER"] = "07292";
-	MSIC_0X$1["MINING_OF_BAUXITE"] = "07293";
-	MSIC_0X$1["MINING_OF_ILMENITE"] = "07294";
-	MSIC_0X$1["MINING_OF_GOLD"] = "07295";
-	MSIC_0X$1["MINING_OF_SILVER"] = "07296";
-	MSIC_0X$1["MINING_OF_PLATINUM"] = "07297";
-	MSIC_0X$1["AMANG_RETREATMENT"] = "07298";
-	MSIC_0X$1["MINING_OF_OTHER_NON_FERROUS"] = "07299";
-	MSIC_0X$1["QUARRYING_OF_STONE"] = "08101";
-	MSIC_0X$1["QUARRYING_OF_LIMESTONE"] = "08102";
-	MSIC_0X$1["MINING_OF_GYPSUM"] = "08103";
-	MSIC_0X$1["MINING_OF_CHALK"] = "08104";
-	MSIC_0X$1["EXTRACTION_OF_SAND"] = "08105";
-	MSIC_0X$1["BREAKING_OF_STONE"] = "08106";
-	MSIC_0X$1["QUARRYING_OF_SAND"] = "08107";
-	MSIC_0X$1["MINING_OF_CLAYS"] = "08108";
-	MSIC_0X$1["QUARRYING_OF_GRANITE"] = "08109";
-	MSIC_0X$1["MINING_OF_PHOSPHATES"] = "08911";
-	MSIC_0X$1["MINING_OF_POTASSIUM"] = "08912";
-	MSIC_0X$1["MINING_OF_SULPHUR"] = "08913";
-	MSIC_0X$1["EXTRACTION_OF_PYRITES"] = "08914";
-	MSIC_0X$1["MINING_OF_BARIUM"] = "08915";
-	MSIC_0X$1["MINING_OF_BORATES"] = "08916";
-	MSIC_0X$1["MINING_OF_EARTH_COLOURS"] = "08917";
-	MSIC_0X$1["GUANO_MINING"] = "08918";
-	MSIC_0X$1["PEAT_DIGGING"] = "08921";
-	MSIC_0X$1["PEAT_AGGLOMERATION"] = "08922";
-	MSIC_0X$1["PREPARATION_OF_PEAT"] = "08923";
-	MSIC_0X$1["EXTRACTION_OF_UNDERGROUND_SALT"] = "08931";
-	MSIC_0X$1["SALT_PRODUCTION"] = "08932";
-	MSIC_0X$1["CRUSHING_OF_SALT"] = "08933";
-	MSIC_0X$1["MINING_OF_ABRASIVE_MATERIALS"] = "08991";
-	MSIC_0X$1["MINING_OF_ASBESTOS"] = "08992";
-	MSIC_0X$1["MINING_OF_SILICEOUS"] = "08993";
-	MSIC_0X$1["MINING_OF_GRAPHITE"] = "08994";
-	MSIC_0X$1["MINING_OF_STEATITE"] = "08995";
-	MSIC_0X$1["MINING_OF_GEMSTONES"] = "08996";
-	MSIC_0X$1["OTHER_MINING"] = "08999";
-	MSIC_0X$1["OIL_AND_GAS_EXTRACTION"] = "09101";
-	MSIC_0X$1["OIL_AND_GAS_FIREFIGHTING"] = "09102";
-	MSIC_0X$1["SUPPORT_FOR_MINING"] = "09900";
-	return MSIC_0X$1;
-}({});
+//#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
-exports.MSIC_0X = MSIC_0X;
+exports.AllowanceChargeHelpers = AllowanceChargeHelpers;
+exports.CurrencyHelpers = CurrencyHelpers;
+exports.DateTimeHelpers = DateTimeHelpers;
+exports.DeliveryHelpers = DeliveryHelpers;
+exports.DocumentReferenceHelpers = DocumentReferenceHelpers;
+exports.IndustryHelpers = IndustryHelpers;
+exports.InvoiceBuilder = InvoiceBuilder;
+exports.PaymentHelpers = PaymentHelpers;
+exports.TaxHelpers = TaxHelpers;
 //# sourceMappingURL=index18.cjs.map

package/dist/index18.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index18.cjs","names":[],"sources":["../src/types/msic/0X.d.ts"],"sourcesContent":["export type MSICCode = {\n  code: string\n  description: string\n  msicCategoryReference: string\n}\n\nexport type MSIC_0X_CODE =\n  | '00000'\n  | '01111'\n  | '01112'\n  | '01113'\n  | '01119'\n  | '01120'\n  | '01131'\n  | '01132'\n  | '01133'\n  | '01134'\n  | '01135'\n  | '01136'\n  | '01137'\n  | '01138'\n  | '01140'\n  | '01150'\n  | '01160'\n  | '01191'\n  | '01192'\n  | '01193'\n  | '01199'\n  | '01210'\n  | '01221'\n  | '01222'\n  | '01223'\n  | '01224'\n  | '01225'\n  | '01226'\n  | '01227'\n  | '01228'\n  | '01229'\n  | '01231'\n  | '01232'\n  | '01233'\n  | '01239'\n  | '01241'\n  | '01249'\n  | '01251'\n  | '01252'\n  | '01253'\n  | '01259'\n  | '01261'\n  | '01262'\n  | '01263'\n  | '01269'\n  | '01271'\n  | '01272'\n  | '01273'\n  | '01279'\n  | '01281'\n  | '01282'\n  | '01283'\n  | '01284'\n  | '01285'\n  | '01289'\n  | '01291'\n  | '01292'\n  | '01293'\n  | '01294'\n  | '01295'\n  | '01296'\n  | '01299'\n  | '01301'\n  | '01302'\n  | '01303'\n  | '01304'\n  | '01411'\n  | '01412'\n  | '01413'\n  | '01420'\n  | '01430'\n  | '01441'\n  | '01442'\n  | '01443'\n  | '01450'\n  | '01461'\n  | '01462'\n  | '01463'\n  | '01464'\n  | '01465'\n  | '01466'\n  | '01467'\n  | '01468'\n  | '01469'\n  | '01491'\n  | '01492'\n  | '01493'\n  | '01494'\n  | '01495'\n  | '01496'\n  | '01497'\n  | '01499'\n  | '01500'\n  | '01610'\n  | '01620'\n  | '01631'\n  | '01632'\n  | '01633'\n  | '01634'\n  | '01640'\n  | '01701'\n  | '01702'\n  | '02101'\n  | '02102'\n  | '02103'\n  | '02104'\n  | '02105'\n  | '02201'\n  | '02202'\n  | '02203'\n  | '02204'\n  | '02301'\n  | '02302'\n  | '02303'\n  | '02309'\n  | '02401'\n  | '02402'\n  | '03111'\n  | '03112'\n  | '03113'\n  | '03114'\n  | '03115'\n  | '03119'\n  | '03121'\n  | '03122'\n  | '03123'\n  | '03124'\n  | '03129'\n  | '03211'\n  | '03212'\n  | '03213'\n  | '03214'\n  | '03215'\n  | '03216'\n  | '03217'\n  | '03218'\n  | '03219'\n  | '03221'\n  | '03222'\n  | '03223'\n  | '03224'\n  | '03225'\n  | '03229'\n  | '05100'\n  | '05200'\n  | '06101'\n  | '06102'\n  | '06103'\n  | '06104'\n  | '06201'\n  | '06202'\n  | '06203'\n  | '06204'\n  | '06205'\n  | '07101'\n  | '07102'\n  | '07210'\n  | '07291'\n  | '07292'\n  | '07293'\n  | '07294'\n  | '07295'\n  | '07296'\n  | '07297'\n  | '07298'\n  | '07299'\n  | '08101'\n  | '08102'\n  | '08103'\n  | '08104'\n  | '08105'\n  | '08106'\n  | '08107'\n  | '08108'\n  | '08109'\n  | '08911'\n  | '08912'\n  | '08913'\n  | '08914'\n  | '08915'\n  | '08916'\n  | '08917'\n  | '08918'\n  | '08921'\n  | '08922'\n  | '08923'\n  | '08931'\n  | '08932'\n  | '08933'\n  | '08991'\n  | '08992'\n  | '08993'\n  | '08994'\n  | '08995'\n  | '08996'\n  | '08999'\n  | '09101'\n  | '09102'\n  | '09900'\n\nexport enum MSIC_0X {\n  NOT_APPLICABLE = '00000',\n  GROWING_OF_MAIZE = '01111',\n  GROWING_OF_LEGUMINOUS_CROPS = '01112',\n  GROWING_OF_OIL_SEEDS = '01113',\n  GROWING_OF_OTHER_CEREALS = '01119',\n  GROWING_OF_PADDY = '01120',\n  GROWING_OF_LEAFY_OR_STEM_VEGETABLES = '01131',\n  GROWING_OF_FRUITS_BEARING_VEGETABLES = '01132',\n  GROWING_OF_MELONS = '01133',\n  GROWING_OF_MUSHROOMS_AND_TRUFFLES = '01134',\n  GROWING_OF_VEGETABLES_SEEDS = '01135',\n  GROWING_OF_OTHER_VEGETABLES = '01136',\n  GROWING_OF_SUGAR_BEET = '01137',\n  GROWING_OF_ROOTS_TUBERS = '01138',\n  GROWING_OF_SUGAR_CANE = '01140',\n  GROWING_OF_TOBACCO = '01150',\n  GROWING_OF_FIBRE_CROPS = '01160',\n  GROWING_OF_FLOWERS = '01191',\n  GROWING_OF_FLOWER_SEEDS = '01192',\n  GROWING_OF_SAGO = '01193',\n  GROWING_OF_OTHER_NON_PERENNIAL_CROPS = '01199',\n  GROWING_OF_GRAPES = '01210',\n  GROWING_OF_BANANA = '01221',\n  GROWING_OF_MANGO = '01222',\n  GROWING_OF_DURIAN = '01223',\n  GROWING_OF_RAMBUTAN = '01224',\n  GROWING_OF_STAR_FRUIT = '01225',\n  GROWING_OF_PAPAYA = '01226',\n  GROWING_OF_PINEAPPLE = '01227',\n  GROWING_OF_PITAYA = '01228',\n  GROWING_OF_OTHER_TROPICAL_FRUITS = '01229',\n  GROWING_OF_POMELO = '01231',\n  GROWING_OF_LEMON_AND_LIMES = '01232',\n  GROWING_OF_TANGERINES_AND_MANDARIN = '01233',\n  GROWING_OF_OTHER_CITRUS_FRUITS = '01239',\n  GROWING_OF_GUAVA = '01241',\n  GROWING_OF_OTHER_POME_FRUITS = '01249',\n  GROWING_OF_BERRIES = '01251',\n  GROWING_OF_FRUIT_SEEDS = '01252',\n  GROWING_OF_EDIBLE_NUTS = '01253',\n  GROWING_OF_OTHER_TREE_AND_BUSH_FRUITS = '01259',\n  GROWING_OF_OIL_PALM_ESTATE = '01261',\n  GROWING_OF_OIL_PALM_SMALLHOLDINGS = '01262',\n  GROWING_OF_COCONUT = '01263',\n  GROWING_OF_OTHER_OLEAGINOUS_FRUITS = '01269',\n  GROWING_OF_COFFEE = '01271',\n  GROWING_OF_TEA = '01272',\n  GROWING_OF_COCOA = '01273',\n  GROWING_OF_OTHER_BEVERAGE_CROPS = '01279',\n  GROWING_OF_PEPPER = '01281',\n  GROWING_OF_CHILIES = '01282',\n  GROWING_OF_NUTMEG = '01283',\n  GROWING_OF_GINGER = '01284',\n  GROWING_OF_PLANTS_FOR_PHARMACY = '01285',\n  GROWING_OF_OTHER_SPICES = '01289',\n  GROWING_OF_RUBBER_TREES_ESTATE = '01291',\n  GROWING_OF_RUBBER_TREES_SMALLHOLDINGS = '01292',\n  GROWING_OF_TREES_FOR_SAP = '01293',\n  GROWING_OF_NIPA_PALM = '01294',\n  GROWING_OF_ARECA = '01295',\n  GROWING_OF_ROSELLE = '01296',\n  GROWING_OF_OTHER_PERENNIAL_CROPS = '01299',\n  GROWING_OF_PLANTS_FOR_PLANTING = '01301',\n  GROWING_OF_PLANTS_FOR_ORNAMENTAL = '01302',\n  GROWING_OF_LIVE_PLANTS = '01303',\n  OPERATION_OF_TREE_NURSERIES = '01304',\n  RAISING_CATTLE_OR_BUFFALOES = '01411',\n  PRODUCTION_OF_RAW_MILK = '01412',\n  PRODUCTION_OF_BOVINE_SEMEN = '01413',\n  RAISING_OF_HORSES = '01420',\n  RAISING_OF_CAMELS = '01430',\n  RAISING_OF_SHEEP_AND_GOATS = '01441',\n  PRODUCTION_OF_SHEEP_MILK = '01442',\n  PRODUCTION_OF_RAW_WOOL = '01443',\n  RAISING_OF_SWINE = '01450',\n  RAISING_OF_CHICKEN = '01461',\n  RAISING_OF_DUCKS = '01462',\n  RAISING_OF_GEESE = '01463',\n  RAISING_OF_QUAILS = '01464',\n  RAISING_OF_OTHER_POULTRY = '01465',\n  PRODUCTION_OF_CHICKEN_EGGS = '01466',\n  PRODUCTION_OF_DUCK_EGGS = '01467',\n  PRODUCTION_OF_OTHER_POULTRY_EGGS = '01468',\n  OPERATION_OF_POULTRY_HATCHERIES = '01469',\n  RAISING_OF_SEMI_DOMESTICATED = '01491',\n  PRODUCTION_OF_FUR_SKINS = '01492',\n  OPERATION_OF_WORM_FARMS = '01493',\n  RAISING_OF_SILK_WORMS = '01494',\n  BEE_KEEPING = '01495',\n  RAISING_OF_PET_ANIMALS = '01496',\n  RAISING_OF_SWIFLET = '01497',\n  RAISING_OF_DIVERSE_ANIMALS = '01499',\n  MIXED_FARMING = '01500',\n  AGRICULTURAL_ACTIVITIES_FOR_CROPS = '01610',\n  AGRICULTURAL_ACTIVITIES_FOR_ANIMALS = '01620',\n  PREPARATION_OF_CROPS = '01631',\n  PREPARATION_OF_TOBACCO_LEAVES = '01632',\n  PREPARATION_OF_COCOA_BEANS = '01633',\n  SUN_DRYING_OF_FRUITS = '01634',\n  SEED_PROCESSING = '01640',\n  HUNTING_AND_TRAPPING = '01701',\n  TAKING_OF_ANIMALS = '01702',\n  PLANTING_OF_FORESTS = '02101',\n  GROWING_OF_COPPICE = '02102',\n  OPERATION_OF_FOREST_NURSERIES = '02103',\n  COLLECTION_OF_WILDINGS = '02104',\n  FOREST_PLANTATION = '02105',\n  PRODUCTION_OF_ROUND_WOOD = '02201',\n  PRODUCTION_OF_UNPROCESSED_WOOD = '02202',\n  PRODUCTION_OF_CHARCOAL = '02203',\n  RUBBER_WOOD_LOGGING = '02204',\n  COLLECTION_OF_RATTAN = '02301',\n  BIRDS_NEST_COLLECTION = '02302',\n  WILD_SAGO_PALM_COLLECTION = '02303',\n  GATHERING_OF_NON_WOOD_FOREST = '02309',\n  FORESTRY_SERVICE_ACTIVITIES = '02401',\n  LOGGING_SERVICE_ACTIVITIES = '02402',\n  COMMERCIAL_OCEAN_FISHING = '03111',\n  COLLECTION_OF_MARINE_CRUSTACEANS = '03112',\n  TAKING_OF_AQUATIC_ANIMALS = '03113',\n  VESSELS_FOR_FISHING = '03114',\n  GATHERING_OF_MARINE_ORGANISMS = '03115',\n  MARINE_FISHING = '03119',\n  COMMERCIAL_INLAND_FISHING = '03121',\n  TAKING_OF_FRESHWATER_CRUSTACEANS = '03122',\n  TAKING_OF_FRESHWATER_ANIMALS = '03123',\n  GATHERING_OF_FRESHWATER_FLORA = '03124',\n  FRESHWATER_FISHING = '03129',\n  FISH_FARMING_SEA_WATER = '03211',\n  PRODUCTION_OF_BIVALVE_SPAT = '03212',\n  GROWING_OF_SEAWEEDS = '03213',\n  CULTURE_OF_CRUSTACEANS = '03214',\n  AQUACULTURE_IN_BRACKISH = '03215',\n  AQUACULTURE_IN_SALT_WATER = '03216',\n  OPERATION_OF_MARINE_HATCHERIES = '03217',\n  OPERATION_OF_MARINE_WORM_FARMS = '03218',\n  MARINE_AQUACULTURE = '03219',\n  FISH_FARMING_FRESHWATER = '03221',\n  SHRIMP_FARMING_FRESHWATER = '03222',\n  CULTURE_OF_FRESHWATER_CRUSTACEANS = '03223',\n  OPERATION_OF_FRESHWATER_HATCHERIES = '03224',\n  FARMING_OF_FROGS = '03225',\n  FRESHWATER_AQUACULTURE = '03229',\n  MINING_OF_HARD_COAL = '05100',\n  MINING_OF_LIGNITE = '05200',\n  EXTRACTION_OF_CRUDE_PETROLEUM = '06101',\n  EXTRACTION_OF_BITUMINOUS = '06102',\n  PRODUCTION_OF_CRUDE_PETROLEUM = '06103',\n  PROCESSES_TO_OBTAIN_CRUDE_OILS = '06104',\n  PRODUCTION_OF_NATURAL_GAS = '06201',\n  EXTRACTION_OF_CONDENSATES = '06202',\n  DRAINING_OF_HYDROCARBON = '06203',\n  GAS_DESULPHURIZATION = '06204',\n  MINING_OF_HYDROCARBON_LIQUIDS = '06205',\n  MINING_OF_IRON_ORES = '07101',\n  BENEFICIATION_OF_IRON_ORES = '07102',\n  MINING_OF_URANIUM = '07210',\n  MINING_OF_TIN = '07291',\n  MINING_OF_COPPER = '07292',\n  MINING_OF_BAUXITE = '07293',\n  MINING_OF_ILMENITE = '07294',\n  MINING_OF_GOLD = '07295',\n  MINING_OF_SILVER = '07296',\n  MINING_OF_PLATINUM = '07297',\n  AMANG_RETREATMENT = '07298',\n  MINING_OF_OTHER_NON_FERROUS = '07299',\n  QUARRYING_OF_STONE = '08101',\n  QUARRYING_OF_LIMESTONE = '08102',\n  MINING_OF_GYPSUM = '08103',\n  MINING_OF_CHALK = '08104',\n  EXTRACTION_OF_SAND = '08105',\n  BREAKING_OF_STONE = '08106',\n  QUARRYING_OF_SAND = '08107',\n  MINING_OF_CLAYS = '08108',\n  QUARRYING_OF_GRANITE = '08109',\n  MINING_OF_PHOSPHATES = '08911',\n  MINING_OF_POTASSIUM = '08912',\n  MINING_OF_SULPHUR = '08913',\n  EXTRACTION_OF_PYRITES = '08914',\n  MINING_OF_BARIUM = '08915',\n  MINING_OF_BORATES = '08916',\n  MINING_OF_EARTH_COLOURS = '08917',\n  GUANO_MINING = '08918',\n  PEAT_DIGGING = '08921',\n  PEAT_AGGLOMERATION = '08922',\n  PREPARATION_OF_PEAT = '08923',\n  EXTRACTION_OF_UNDERGROUND_SALT = '08931',\n  SALT_PRODUCTION = '08932',\n  CRUSHING_OF_SALT = '08933',\n  MINING_OF_ABRASIVE_MATERIALS = '08991',\n  MINING_OF_ASBESTOS = '08992',\n  MINING_OF_SILICEOUS = '08993',\n  MINING_OF_GRAPHITE = '08994',\n  MINING_OF_STEATITE = '08995',\n  MINING_OF_GEMSTONES = '08996',\n  OTHER_MINING = '08999',\n  OIL_AND_GAS_EXTRACTION = '09101',\n  OIL_AND_GAS_FIREFIGHTING = '09102',\n  SUPPORT_FOR_MINING = '09900',\n}\n"],"mappings":";;AA+MA,IAAY,8CAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACD"}
+{"version":3,"file":"index18.cjs","names":["accountId?: string","accountId: string","dueDate?: string","days: number","fromCurrency: string","toCurrency: string","exchangeRate: number","rateDate?: string","amount: number","rate: number","reason: string","percentage?: number","description: string","percentage: number","baseAmount: number","deliveryDate: string","address: {\n      addressLine0: string\n      cityName: string\n      postalZone?: string\n      state: string\n      country?: string\n    }","pickupDate: string","address: any","freightAmount: number","freightDescription: string","poNumber: string","contractNumber: string","projectNumber: string","billingNumber: string","customsFormNumber: string","ftaNumber: string","country: string","code: string","date: Date","year: number","month: number","invoiceNumber: string","netDays: number","currency: string"],"sources":["../src/utils/helpers.ts"],"sourcesContent":["import type {\n  InvoiceV1_1,\n  PaymentMeans,\n  AllowanceCharge,\n  CurrencyExchangeRate,\n  Delivery,\n  AdditionalDocumentReference,\n} from '../types/documents/index.js'\n\n/**\n * MyInvois Invoice Helper Functions\n *\n * Provides convenient utilities for common invoice scenarios and business patterns.\n * These helpers simplify the creation of compliant MyInvois documents.\n */\n\n/**\n * Payment Method Helpers\n */\nexport const PaymentHelpers = {\n  /**\n   * Creates cash payment means\n   */\n  cash(): PaymentMeans {\n    return {\n      paymentMeansCode: '01',\n      paymentTerms: 'Cash payment',\n    }\n  },\n\n  /**\n   * Creates cheque payment means\n   */\n  cheque(accountId?: string): PaymentMeans {\n    return {\n      paymentMeansCode: '02',\n      payeeFinancialAccountID: accountId,\n      paymentTerms: 'Cheque payment',\n    }\n  },\n\n  /**\n   * Creates bank transfer payment means\n   */\n  bankTransfer(accountId: string, dueDate?: string): PaymentMeans {\n    return {\n      paymentMeansCode: '03',\n      payeeFinancialAccountID: accountId,\n      paymentDueDate: dueDate,\n      paymentTerms: 'Bank transfer',\n    }\n  },\n\n  /**\n   * Creates credit card payment means\n   */\n  creditCard(): PaymentMeans {\n    return {\n      paymentMeansCode: '04',\n      paymentTerms: 'Credit card payment',\n    }\n  },\n\n  /**\n   * Creates e-wallet payment means\n   */\n  eWallet(accountId?: string): PaymentMeans {\n    return {\n      paymentMeansCode: '05',\n      payeeFinancialAccountID: accountId,\n      paymentTerms: 'E-wallet payment',\n    }\n  },\n\n  /**\n   * Creates custom payment terms with specific due date\n   */\n  net(days: number, accountId?: string): PaymentMeans {\n    const dueDate = new Date()\n    dueDate.setDate(dueDate.getDate() + days)\n\n    return {\n      paymentMeansCode: '03', // Bank transfer is most common for net terms\n      payeeFinancialAccountID: accountId,\n      paymentDueDate: dueDate.toISOString().split('T')[0],\n      paymentTerms: `Net ${days} days`,\n    }\n  },\n}\n\n/**\n * Currency and Exchange Rate Helpers\n */\nexport const CurrencyHelpers = {\n  /**\n   * Creates domestic MYR transaction (no exchange rate needed)\n   */\n  domestic(): CurrencyExchangeRate {\n    return {\n      sourceCurrencyCode: 'MYR',\n      targetCurrencyCode: 'MYR',\n      calculationRate: 1.0,\n    }\n  },\n\n  /**\n   * Creates international transaction with exchange rate\n   */\n  international(\n    fromCurrency: string,\n    toCurrency: string = 'MYR',\n    exchangeRate: number,\n    rateDate?: string,\n  ): CurrencyExchangeRate {\n    return {\n      sourceCurrencyCode: fromCurrency as any,\n      targetCurrencyCode: toCurrency as any,\n      calculationRate: exchangeRate,\n      exchangeRateDate: rateDate || new Date().toISOString().split('T')[0],\n    }\n  },\n\n  /**\n   * Common exchange rates (these should be updated with real-time rates)\n   */\n  commonRates: {\n    USD_MYR: 4.75,\n    SGD_MYR: 3.45,\n    EUR_MYR: 5.1,\n    GBP_MYR: 5.85,\n    JPY_MYR: 0.032,\n    AUD_MYR: 3.12,\n  },\n}\n\n/**\n * Tax Calculation Helpers\n */\nexport const TaxHelpers = {\n  /**\n   * Calculates SST (6%) for goods\n   */\n  calculateSST(\n    amount: number,\n    rate: number = 6.0,\n  ): { taxAmount: number; totalWithTax: number } {\n    const taxAmount = (amount * rate) / 100\n    return {\n      taxAmount: Math.round(taxAmount * 100) / 100,\n      totalWithTax: Math.round((amount + taxAmount) * 100) / 100,\n    }\n  },\n\n  /**\n   * Calculates Service Tax for services\n   */\n  calculateServiceTax(\n    amount: number,\n    rate: number = 6.0,\n  ): { taxAmount: number; totalWithTax: number } {\n    return TaxHelpers.calculateSST(amount, rate)\n  },\n\n  /**\n   * Zero-rated calculation (0% tax)\n   */\n  zeroRated(amount: number): { taxAmount: number; totalWithTax: number } {\n    return {\n      taxAmount: 0,\n      totalWithTax: amount,\n    }\n  },\n\n  /**\n   * Exempt calculation (no tax)\n   */\n  exempt(amount: number): { taxAmount: number; totalWithTax: number } {\n    return {\n      taxAmount: 0,\n      totalWithTax: amount,\n    }\n  },\n}\n\n/**\n * Allowance and Charge Helpers\n */\nexport const AllowanceChargeHelpers = {\n  /**\n   * Creates a discount allowance\n   */\n  discount(\n    reason: string,\n    amount: number,\n    percentage?: number,\n  ): AllowanceCharge {\n    return {\n      chargeIndicator: false,\n      reason,\n      amount,\n      multiplierFactorNumeric: percentage ? percentage / 100 : undefined,\n    }\n  },\n\n  /**\n   * Creates a shipping charge\n   */\n  shipping(\n    amount: number,\n    description: string = 'Shipping and handling',\n  ): AllowanceCharge {\n    return {\n      chargeIndicator: true,\n      reason: description,\n      amount,\n    }\n  },\n\n  /**\n   * Creates an early payment discount\n   */\n  earlyPaymentDiscount(\n    percentage: number,\n    baseAmount: number,\n  ): AllowanceCharge {\n    const discountAmount = (baseAmount * percentage) / 100\n    return {\n      chargeIndicator: false,\n      reason: `Early payment discount ${percentage}%`,\n      amount: Math.round(discountAmount * 100) / 100,\n      multiplierFactorNumeric: percentage / 100,\n      baseAmount,\n    }\n  },\n\n  /**\n   * Creates a handling fee charge\n   */\n  handlingFee(amount: number): AllowanceCharge {\n    return {\n      chargeIndicator: true,\n      reason: 'Handling fee',\n      amount,\n    }\n  },\n}\n\n/**\n * Delivery Helpers\n */\nexport const DeliveryHelpers = {\n  /**\n   * Creates standard delivery information\n   */\n  standard(\n    deliveryDate: string,\n    address: {\n      addressLine0: string\n      cityName: string\n      postalZone?: string\n      state: string\n      country?: string\n    },\n  ): Delivery {\n    return {\n      actualDeliveryDate: deliveryDate,\n      deliveryLocation: {\n        ...address,\n        country: address.country || 'MYS',\n      },\n    }\n  },\n\n  /**\n   * Creates pickup delivery (customer pickup)\n   */\n  pickup(pickupDate: string): Delivery {\n    return {\n      actualDeliveryDate: pickupDate,\n      deliveryLocation: {\n        addressLine0: 'Customer pickup',\n        cityName: 'N/A',\n        state: 'N/A',\n        country: 'MYS',\n      },\n    }\n  },\n\n  /**\n   * Creates delivery with freight charges\n   */\n  withFreight(\n    deliveryDate: string,\n    address: any,\n    freightAmount: number,\n    freightDescription: string = 'Freight charges',\n  ): Delivery {\n    return {\n      actualDeliveryDate: deliveryDate,\n      deliveryLocation: address,\n      shipment: {\n        id: `SHIP-${Date.now()}`,\n        freightAllowanceCharge: {\n          chargeIndicator: true,\n          reason: freightDescription,\n          amount: freightAmount,\n        },\n      },\n    }\n  },\n}\n\n/**\n * Document Reference Helpers\n */\nexport const DocumentReferenceHelpers = {\n  /**\n   * Creates purchase order reference\n   */\n  purchaseOrder(poNumber: string): { purchaseOrderReference: string } {\n    return { purchaseOrderReference: poNumber }\n  },\n\n  /**\n   * Creates contract reference\n   */\n  contract(contractNumber: string): { contractReference: string } {\n    return { contractReference: contractNumber }\n  },\n\n  /**\n   * Creates project reference\n   */\n  project(projectNumber: string): { projectReference: string } {\n    return { projectReference: projectNumber }\n  },\n\n  /**\n   * Creates billing reference\n   */\n  billing(billingNumber: string): { billingReference: string } {\n    return { billingReference: billingNumber }\n  },\n\n  /**\n   * Creates customs reference\n   */\n  customs(customsFormNumber: string): AdditionalDocumentReference {\n    return {\n      id: customsFormNumber,\n      documentType: 'CustomsImportForm',\n      documentDescription: 'Customs import declaration',\n    }\n  },\n\n  /**\n   * Creates free trade agreement reference\n   */\n  freeTradeAgreement(\n    ftaNumber: string,\n    country: string,\n  ): AdditionalDocumentReference {\n    return {\n      id: ftaNumber,\n      documentType: 'FreeTradeAgreement',\n      documentDescription: `Free trade agreement with ${country}`,\n    }\n  },\n}\n\n/**\n * Industry Classification Helpers\n */\nexport const IndustryHelpers = {\n  /**\n   * Common industry classifications with proper codes and descriptions\n   */\n  trading: {\n    industryClassificationCode: '47900',\n    industryClassificationDescription:\n      'Retail sale via mail order houses or via Internet',\n  },\n\n  manufacturing: {\n    industryClassificationCode: '10131',\n    industryClassificationDescription: 'Processing and preserving of meat',\n  },\n\n  software: {\n    industryClassificationCode: '62012',\n    industryClassificationDescription:\n      'Business and domestic software development',\n  },\n\n  consulting: {\n    industryClassificationCode: '70200',\n    industryClassificationDescription: 'Management consultancy activities',\n  },\n\n  restaurant: {\n    industryClassificationCode: '56101',\n    industryClassificationDescription: 'Restaurants',\n  },\n\n  construction: {\n    industryClassificationCode: '41000',\n    industryClassificationDescription: 'Development of building projects',\n  },\n\n  logistics: {\n    industryClassificationCode: '49301',\n    industryClassificationDescription: 'Land freight transport',\n  },\n\n  /**\n   * Creates custom industry classification\n   */\n  custom(\n    code: string,\n    description: string,\n  ): {\n    industryClassificationCode: string\n    industryClassificationDescription: string\n  } {\n    return {\n      industryClassificationCode: code,\n      industryClassificationDescription: description,\n    }\n  },\n}\n\n/**\n * Date and Time Helpers\n */\nexport const DateTimeHelpers = {\n  /**\n   * Gets current date in MyInvois format (YYYY-MM-DD)\n   */\n  currentDate(): string {\n    return new Date().toISOString().split('T')[0] || ''\n  },\n\n  /**\n   * Gets current time in MyInvois format (HH:mm:ssZ)\n   */\n  currentTime(): string {\n    return new Date().toISOString().split('T')[1]?.split('.')[0] + 'Z' || ''\n  },\n\n  /**\n   * Formats date to MyInvois format\n   */\n  formatDate(date: Date): string {\n    return date.toISOString().split('T')[0] || ''\n  },\n\n  /**\n   * Formats time to MyInvois format\n   */\n  formatTime(date: Date): string {\n    return date.toISOString().split('T')[1]?.split('.')[0] + 'Z' || ''\n  },\n\n  /**\n   * Adds days to a date\n   */\n  addDays(date: Date, days: number): Date {\n    const result = new Date(date)\n    result.setDate(result.getDate() + days)\n    return result\n  },\n\n  /**\n   * Gets billing period for monthly billing\n   */\n  monthlyPeriod(year: number, month: number): { start: string; end: string } {\n    // Use UTC to avoid timezone issues\n    // JavaScript Date uses 0-based months, so subtract 1 for the month\n    const start = new Date(Date.UTC(year, month - 1, 1))\n    // To get last day of the month, use day 0 of the NEXT month\n    const end = new Date(Date.UTC(year, month, 0))\n\n    return {\n      start: DateTimeHelpers.formatDate(start),\n      end: DateTimeHelpers.formatDate(end),\n    }\n  },\n}\n\n/**\n * Complete Invoice Builder Helper\n */\nexport const InvoiceBuilder = {\n  /**\n   * Creates a basic cash invoice template\n   */\n  basicCash(invoiceNumber: string): Partial<InvoiceV1_1> {\n    return {\n      eInvoiceCodeOrNumber: invoiceNumber,\n      eInvoiceDate: DateTimeHelpers.currentDate(),\n      eInvoiceTime: DateTimeHelpers.currentTime(),\n      eInvoiceTypeCode: '01',\n      eInvoiceVersion: '1.1',\n      invoiceCurrencyCode: 'MYR',\n      paymentMeans: [PaymentHelpers.cash()],\n    }\n  },\n\n  /**\n   * Creates a business invoice template with bank transfer\n   */\n  businessInvoice(\n    invoiceNumber: string,\n    accountId: string,\n    netDays: number = 30,\n  ): Partial<InvoiceV1_1> {\n    return {\n      eInvoiceCodeOrNumber: invoiceNumber,\n      eInvoiceDate: DateTimeHelpers.currentDate(),\n      eInvoiceTime: DateTimeHelpers.currentTime(),\n      eInvoiceTypeCode: '01',\n      eInvoiceVersion: '1.1',\n      invoiceCurrencyCode: 'MYR',\n      paymentMeans: [PaymentHelpers.net(netDays, accountId)],\n    }\n  },\n\n  /**\n   * Creates an international invoice template\n   */\n  international(\n    invoiceNumber: string,\n    currency: string,\n    exchangeRate: number,\n  ): Partial<InvoiceV1_1> {\n    return {\n      eInvoiceCodeOrNumber: invoiceNumber,\n      eInvoiceDate: DateTimeHelpers.currentDate(),\n      eInvoiceTime: DateTimeHelpers.currentTime(),\n      eInvoiceTypeCode: '01',\n      eInvoiceVersion: '1.1',\n      invoiceCurrencyCode: currency as any,\n      currencyExchangeRate: exchangeRate,\n      taxExchangeRate: CurrencyHelpers.international(\n        currency,\n        'MYR',\n        exchangeRate,\n      ),\n      paymentMeans: [PaymentHelpers.bankTransfer('')],\n    }\n  },\n}\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,iBAAiB;CAI5B,OAAqB;AACnB,SAAO;GACL,kBAAkB;GAClB,cAAc;EACf;CACF;CAKD,OAAOA,WAAkC;AACvC,SAAO;GACL,kBAAkB;GAClB,yBAAyB;GACzB,cAAc;EACf;CACF;CAKD,aAAaC,WAAmBC,SAAgC;AAC9D,SAAO;GACL,kBAAkB;GAClB,yBAAyB;GACzB,gBAAgB;GAChB,cAAc;EACf;CACF;CAKD,aAA2B;AACzB,SAAO;GACL,kBAAkB;GAClB,cAAc;EACf;CACF;CAKD,QAAQF,WAAkC;AACxC,SAAO;GACL,kBAAkB;GAClB,yBAAyB;GACzB,cAAc;EACf;CACF;CAKD,IAAIG,MAAcH,WAAkC;EAClD,MAAM,0BAAU,IAAI;AACpB,UAAQ,QAAQ,QAAQ,SAAS,GAAG,KAAK;AAEzC,SAAO;GACL,kBAAkB;GAClB,yBAAyB;GACzB,gBAAgB,QAAQ,aAAa,CAAC,MAAM,IAAI,CAAC;GACjD,eAAe,MAAM,KAAK;EAC3B;CACF;AACF;;;;AAKD,MAAa,kBAAkB;CAI7B,WAAiC;AAC/B,SAAO;GACL,oBAAoB;GACpB,oBAAoB;GACpB,iBAAiB;EAClB;CACF;CAKD,cACEI,cACAC,aAAqB,OACrBC,cACAC,UACsB;AACtB,SAAO;GACL,oBAAoB;GACpB,oBAAoB;GACpB,iBAAiB;GACjB,kBAAkB,YAAY,qBAAI,QAAO,aAAa,CAAC,MAAM,IAAI,CAAC;EACnE;CACF;CAKD,aAAa;EACX,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;EACT,SAAS;CACV;AACF;;;;AAKD,MAAa,aAAa;CAIxB,aACEC,QACAC,OAAe,GAC8B;EAC7C,MAAM,YAAa,SAAS,OAAQ;AACpC,SAAO;GACL,WAAW,KAAK,MAAM,YAAY,IAAI,GAAG;GACzC,cAAc,KAAK,OAAO,SAAS,aAAa,IAAI,GAAG;EACxD;CACF;CAKD,oBACED,QACAC,OAAe,GAC8B;AAC7C,SAAO,WAAW,aAAa,QAAQ,KAAK;CAC7C;CAKD,UAAUD,QAA6D;AACrE,SAAO;GACL,WAAW;GACX,cAAc;EACf;CACF;CAKD,OAAOA,QAA6D;AAClE,SAAO;GACL,WAAW;GACX,cAAc;EACf;CACF;AACF;;;;AAKD,MAAa,yBAAyB;CAIpC,SACEE,QACAF,QACAG,YACiB;AACjB,SAAO;GACL,iBAAiB;GACjB;GACA;GACA,yBAAyB,aAAa,aAAa;EACpD;CACF;CAKD,SACEH,QACAI,cAAsB,yBACL;AACjB,SAAO;GACL,iBAAiB;GACjB,QAAQ;GACR;EACD;CACF;CAKD,qBACEC,YACAC,YACiB;EACjB,MAAM,iBAAkB,aAAa,aAAc;AACnD,SAAO;GACL,iBAAiB;GACjB,SAAS,yBAAyB,WAAW;GAC7C,QAAQ,KAAK,MAAM,iBAAiB,IAAI,GAAG;GAC3C,yBAAyB,aAAa;GACtC;EACD;CACF;CAKD,YAAYN,QAAiC;AAC3C,SAAO;GACL,iBAAiB;GACjB,QAAQ;GACR;EACD;CACF;AACF;;;;AAKD,MAAa,kBAAkB;CAI7B,SACEO,cACAC,SAOU;AACV,SAAO;GACL,oBAAoB;GACpB,kBAAkB;IAChB,GAAG;IACH,SAAS,QAAQ,WAAW;GAC7B;EACF;CACF;CAKD,OAAOC,YAA8B;AACnC,SAAO;GACL,oBAAoB;GACpB,kBAAkB;IAChB,cAAc;IACd,UAAU;IACV,OAAO;IACP,SAAS;GACV;EACF;CACF;CAKD,YACEF,cACAG,SACAC,eACAC,qBAA6B,mBACnB;AACV,SAAO;GACL,oBAAoB;GACpB,kBAAkB;GAClB,UAAU;IACR,KAAK,OAAO,KAAK,KAAK,CAAC;IACvB,wBAAwB;KACtB,iBAAiB;KACjB,QAAQ;KACR,QAAQ;IACT;GACF;EACF;CACF;AACF;;;;AAKD,MAAa,2BAA2B;CAItC,cAAcC,UAAsD;AAClE,SAAO,EAAE,wBAAwB,SAAU;CAC5C;CAKD,SAASC,gBAAuD;AAC9D,SAAO,EAAE,mBAAmB,eAAgB;CAC7C;CAKD,QAAQC,eAAqD;AAC3D,SAAO,EAAE,kBAAkB,cAAe;CAC3C;CAKD,QAAQC,eAAqD;AAC3D,SAAO,EAAE,kBAAkB,cAAe;CAC3C;CAKD,QAAQC,mBAAwD;AAC9D,SAAO;GACL,IAAI;GACJ,cAAc;GACd,qBAAqB;EACtB;CACF;CAKD,mBACEC,WACAC,SAC6B;AAC7B,SAAO;GACL,IAAI;GACJ,cAAc;GACd,sBAAsB,4BAA4B,QAAQ;EAC3D;CACF;AACF;;;;AAKD,MAAa,kBAAkB;CAI7B,SAAS;EACP,4BAA4B;EAC5B,mCACE;CACH;CAED,eAAe;EACb,4BAA4B;EAC5B,mCAAmC;CACpC;CAED,UAAU;EACR,4BAA4B;EAC5B,mCACE;CACH;CAED,YAAY;EACV,4BAA4B;EAC5B,mCAAmC;CACpC;CAED,YAAY;EACV,4BAA4B;EAC5B,mCAAmC;CACpC;CAED,cAAc;EACZ,4BAA4B;EAC5B,mCAAmC;CACpC;CAED,WAAW;EACT,4BAA4B;EAC5B,mCAAmC;CACpC;CAKD,OACEC,MACAhB,aAIA;AACA,SAAO;GACL,4BAA4B;GAC5B,mCAAmC;EACpC;CACF;AACF;;;;AAKD,MAAa,kBAAkB;CAI7B,cAAsB;AACpB,SAAO,qBAAI,QAAO,aAAa,CAAC,MAAM,IAAI,CAAC,MAAM;CAClD;CAKD,cAAsB;AACpB,SAAO,qBAAI,QAAO,aAAa,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,OAAO;CACvE;CAKD,WAAWiB,MAAoB;AAC7B,SAAO,KAAK,aAAa,CAAC,MAAM,IAAI,CAAC,MAAM;CAC5C;CAKD,WAAWA,MAAoB;AAC7B,SAAO,KAAK,aAAa,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,OAAO;CACjE;CAKD,QAAQA,MAAY1B,MAAoB;EACtC,MAAM,SAAS,IAAI,KAAK;AACxB,SAAO,QAAQ,OAAO,SAAS,GAAG,KAAK;AACvC,SAAO;CACR;CAKD,cAAc2B,MAAcC,OAA+C;EAGzE,MAAM,QAAQ,IAAI,KAAK,KAAK,IAAI,MAAM,QAAQ,GAAG,EAAE;EAEnD,MAAM,MAAM,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,EAAE;AAE7C,SAAO;GACL,OAAO,gBAAgB,WAAW,MAAM;GACxC,KAAK,gBAAgB,WAAW,IAAI;EACrC;CACF;AACF;;;;AAKD,MAAa,iBAAiB;CAI5B,UAAUC,eAA6C;AACrD,SAAO;GACL,sBAAsB;GACtB,cAAc,gBAAgB,aAAa;GAC3C,cAAc,gBAAgB,aAAa;GAC3C,kBAAkB;GAClB,iBAAiB;GACjB,qBAAqB;GACrB,cAAc,CAAC,eAAe,MAAM,AAAC;EACtC;CACF;CAKD,gBACEA,eACA/B,WACAgC,UAAkB,IACI;AACtB,SAAO;GACL,sBAAsB;GACtB,cAAc,gBAAgB,aAAa;GAC3C,cAAc,gBAAgB,aAAa;GAC3C,kBAAkB;GAClB,iBAAiB;GACjB,qBAAqB;GACrB,cAAc,CAAC,eAAe,IAAI,SAAS,UAAU,AAAC;EACvD;CACF;CAKD,cACED,eACAE,UACA5B,cACsB;AACtB,SAAO;GACL,sBAAsB;GACtB,cAAc,gBAAgB,aAAa;GAC3C,cAAc,gBAAgB,aAAa;GAC3C,kBAAkB;GAClB,iBAAiB;GACjB,qBAAqB;GACrB,sBAAsB;GACtB,iBAAiB,gBAAgB,cAC/B,UACA,OACA,aACD;GACD,cAAc,CAAC,eAAe,aAAa,GAAG,AAAC;EAChD;CACF;AACF"}